Welcome to our_project.
Please note that this is a template repository, click use template (do not fork unless suggesting an improvement) to use in a new project and edit files as required. Also, see important notes at the end of this file.
pip install our_project our_project currently does the following:
-
Contains base class
HelloWorld -
HelloWorldhas theprint_textmethod that prints user supplied text. -
A github action to test project installation and run tests.
-
A github action to release on PyPI (requires adding
PYPI_USERNAMEandPYPI_PASSWORDto repository secrets.)
We intend to work on the following in the future:
- Make it less cumbersome to init docs with
sphinx.
Please edit docs/source/index.rst and docs/source/modules.rst as required then run:
./scripts/mkdocs.sh
The above assumes you are at the root of "our_project".
Also delete setup.rst, tests.rst, if they exist.
Otherwise, run and edit as necessary.
sphinx-quickstartThank you,
NelsonGon 22/10/2021
This repository holds templates that follow a typical workflow for new python projects.
A word of caution
These templates are mostly intended to save time. However, modern IDEs provide project templates that are more mature and less opinionated than the templates here.
This repository serves an additional purpose of allowing developers new to programming to study project structure using very simple examples.
For licenses, tests, and workflows, gitignore it is recommended that one generates these automatically either from their IDE of choice or for .gitignore files and licenses, via github or gitlab.
Happy to hear from you in case of any questions and/or feedback.
DISCLAIMER:
This project is not in anyway related to a similarly named package pytemplates that does something completely different ("Pytemplates is a lightweight HTML template engine written in Python, with support for template inheritance, blocks, macros, context, and Django.").
I only got to learn of this package upon adding badges to this file.