Skip to content

physiopy/physiopy-repository-template

Repository files navigation

repository

This is a template for physiopy's repositories (and other repositories based on the same settings).

Remember to change the licence as soon as you adopt the template.

Available Configurations

This repository is meant to be a template for python3 projects.

  • CircleCI medium docker running Linux (python 3.7, 3.10, style checks, and coverage)
  • Auto release based on Github versioning with Physiopy's labels.
  • .gitattributes for python
  • .gitignore for python and containers
  • Pre-commit (black, isort, flake8, pydocstyle, and RST documentation)
  • Read the Docs (based on sphinx)
  • Zenodo
  • Codecov (for master branch, 90%+)
  • Python setup with extra_require options
  • Versioneer
  • Issue templates (bugs, feature requests, generic)
  • PR template
  • Workflows (Auto release and PyPI upload)

Usage

  1. Find and replace the items between <>, for instance <reponame>
  2. Change licence
  3. Set up your default pushes to origin (git config remote.pushDefault origin)
  4. Finish setting up everything.

More explanation coming soon.

==========

Latest version Release date Auto Release

See the documentation at: https://<reponame>.readthedocs.io

Codecov Build Status Documentation Status

Latest version Supports python version

Auto Release Supports python version

All Contributors

<reponame> is a python3 library meant to do something.

If you use <reponame> in your work, please support it by citing the zenodo DOI of the version you used. You can find the latest version here

We also support gathering all relevant citations via DueCredit.

Read the latest documentation for more information on !

Tested OSs

We woudl love to do that, but for teh moment we cannot support Windows or MacOS testing. The reason is related to the cost of running such tests: for each non-Linux test, we can run up to 8 tests on Linux instead. Partial Windows and MacOS testing might be introduced in future releases.

Hence, while we cannot ensure that will run on Windows or MacOS, however we don't see any reason it shouldn't. Besides, it will run on Windows Linux Subsistems.

We apologise for the discomfort.

We're looking for code contributors, but any suggestion/bug report is welcome! Feel free to open issues!

This project follows the all-contributors specification. Contributions of any kind welcome!

Contributors ✨

Thanks goes to these wonderful people (emoji key):

License

This template is released under The Unlicense. Commented here below a copy of the Apache 2.0 Licence, adopted by Physiopy. Remember to change the licence of your repository as soon as you adopt the template.