Here is the template for Level 4 of sharing code in scikit-package. Please visit the latest developments and the official documentation here.
Notes for future contributors:
The goal of Level 4 is to ensure the package is easily installable locally and to share the code with colleagues.
- A goal could be setting up a private GitHub repository with CI passing.
- Users learn to use
pyproject.toml. - Users learn to use GitHub CI (No news check, no Codecov)
Other notes from the very first PR in this link:
- We assume that the latest Python version supported by
skpkgis used in Level 4. If the user needs to specify the Python version, we encourage them to use Level 5. - We have decided not to support the namespace package structure in Level 4.
- We would like users to configure
test-on-prCI without Codecov. Ideally, Level 4 should focus on hosting the project on GitHub. - We want the
README.rstto contain quick installation instructions. - We would like to have
LICENSE.rstto encourage the good habit of taking care of this legal file. - We do not provide documentation since users are focused on writing the actual code.
- We are not using
isortorCodespellbecause we want users to enjoy usingpre-commitwithout it becoming a source of problems. - We still include
flake8inpre-commitbecause it facilitates a smoother migration process from Level 4 to Level 5. - We do not provide complicated examples for docstrings in the current
calculator.pydemo code. - We do not provide
AUTHORS.rst,CODE_OF_CONDUCT.rst,MANIFEST.rst, orCHANGELOG.rst, which are provided in Level 5.
Are there any things that we need to maintain when we have new updates?
- We currently use
np.dotinsrc/calculator.py. We doubt this API will change anytime soon. - We don't need to worry about the latest Python version support since when users create a new conda environment, it will create the highest Python version compatible with
scikit-package.