Skip to content

Changes Submission Guide

  1. Prior to making any changes, please inform our team to discuss your proposed updates using a github issue. This ensures everyone is informed about ongoing work and allows for constructive feedback. You can submit feature requests, bug reports, and other issues on our Issues page. For general ideas and queries, please use our Discussions page.

  2. Ensure your fork is up-to-date with our main code at jacksund/simmate. This is essential if it's been a while since your last update.

  3. Open the file you wish to edit in Spyder and make your changes.

  4. Don't forget to save all file changes in Spyder.

  5. Simmate enforces clean, readable code. We utilize the black formatter and isort for managing imports. Execute these commands in the ~/Documents/github/simmate directory once you are done making changes:

    isort .
    black .

  6. Simmate uses pytest to ensure new changes don't interfere with existing features. Run these tests to validate your changes. Execute this command in the ~/Documents/github/simmate directory:

    # you can optionally run tests in parallel 
    # with a command such as "pytest -n 4"

  7. If all tests are successful, your changes are ready for submission to Simmate!

  8. Use GitKraken to review your changes. If the changes are satisfactory, stage and commit them to the new branch of your repo (yourname/simmate).

  9. Open a pull-request to merge your changes into our main code (jacksund/simmate). We'll review your changes and merge them if they meet our standards. You can add an emoji to your pull request title to show you've read the tutorial.


You can also format files while coding with Spyder. Go to Tools -> Preferences -> Completion and Linting -> Code Style and Formatting > select black from the code formatting dropdown. To format an open file in Spyder, use the Ctrl+Shift+I shortcut.


Currently, Spyder does not have a plugin for pytest. For now they only support a Unittest plugin.