Use this repository to create an SSCCE for your issue! It will greatly help us figure out what is going wrong and your issue will be much easier to investigate.
Start by Forking this repository, then clone it on your machine.
Run npm install
to install the necessary dependencies.
Run npm test
to make sure everything is ok before testing your code.
You now need to create a failing test that accurately represents the issue you're experiencing.
Modify test.js to show the failure. Modify setup.sql to describe tables and data.
Remember the SSCCE rules. It should be:
- Short (Small) - It should not include anything that is not relevant to your issue.
- Self Contained - Ensure everything is included, ready to go.
- Correct - It should demonstrate the problem you're encountering (i.e. the sscce should fail, but with the right error).
- Example - Displays the problem we are trying to solve.
Use one of our npm scripts to run your SSCCE.
Running with a dialect other than sqlite will require installing an extra package & having a database running.
Run the following command to create a sqlite db file
cat setup.sql | sqlite3 setup.db
npm test
You'll need to install the pg
package and have a postgres database running.
# Do this only once.
npm install pg
# or
npm install pg-native
Configure knex connection https://knexjs.org/guide/#configuration-options in test.js
npm test
# Do this only once.
npm install mysql2
Configure knex connection https://knexjs.org/guide/#configuration-options in test.js
npm test
Open an issue on the main join-monster repo describing your problem and include a link to your SSCCE in it.
You can also open a PR of your fork to this repository, this way your SSCCE will be run on our CI and will continue existing even if you delete your fork.
Just add more commits on top of it, in your fork, and your PR will be updated automatically, and the SSCCE will be executed again.
You don't have to! You can just add a link to your forked repository in your issue.
However, opening a pull request will ensure the SSCCE continues to exist even if you delete your fork. Less clutter in your repository list!
This repository was inspired by the work done by the sequelize team