- To use this template, click the green
Use this template
button andCreate new repository
. - After github initially creates the new repository, please wait an extra minute for the initialization scripts to finish organizing the repo.
- To enable the automatic semantic version increments: in the repository go to
Settings
andCollaborators and teams
. Click the greenAdd people
button. Addsvc-aindscicomp
as an admin. Modify the file in.github/workflows/tag_and_publish.yml
and remove the if statement in line 65. The semantic version will now be incremented every time a code is committed into the main branch. - To publish to PyPI, enable semantic versioning and uncomment the publish block in
.github/workflows/tag_and_publish.yml
. The code will now be published to PyPI every time the code is committed into the main branch. - The
.github/workflows/test_and_lint.yml
file will run automated tests and style checks every time a Pull Request is opened. If the checks are undesired, thetest_and_lint.yml
can be deleted. The strictness of the code coverage level, etc., can be modified by altering the configurations in thepyproject.toml
file and the.flake8
file. - Please make any necessary updates to the README.md and CITATION.cff files
Please indicate a level of support:
- Supported: We are releasing this code to the public as a tool we expect others to use. Issues are welcomed, and we expect to address them promptly; pull requests will be vetted by our staff before inclusion.
- Occasional updates: We are planning on occasional updating this tool with no fixed schedule. Community involvement is encouraged through both issues and pull requests.
- Unsupported: We are not currently supporting this code, but simply releasing it to the community AS IS but are not able to provide any guarantees of support. The community is welcome to submit issues, but you should not expect an active response.
GitHub's tags and Release features can be used to indicate a Release status.
- Stable: v1.0.0 and above. Ready for production.
- Beta: v0.x.x or indicated in the tag. Ready for beta testers and early adopters.
- Alpha: v0.x.x or indicated in the tag. Still in early development.
To use the software, in the root directory, run
pip install -e .
To develop the code, run
pip install -e .[dev]