Description:

spookyai 0.1.28

python-package-template
This is a template repository for Python package projects.
In this README :point_down:

Features
Usage

Initial setup
Creating releases


Projects using this template
FAQ
Contributing

Features
This template repository comes with all of the boilerplate needed for:
⚙️ Robust (and free) CI with GitHub Actions:

Unit tests ran with PyTest against multiple Python versions and operating systems.
Type checking with mypy.
Linting with ruff.
Formatting with isort and black.

🤖 Dependabot configuration to keep your dependencies up-to-date.
📄 Great looking API documentation built using Sphinx (run make docs to preview).
🚀 Automatic GitHub and PyPI releases. Just follow the steps in RELEASE_PROCESS.md to trigger a new release.
Usage
Initial setup


Create a new repository from this template with the desired name of your project.
Your project name (i.e. the name of the repository) and the name of the corresponding Python package don't necessarily need to match, but you might want to check on PyPI first to see if the package name you want is already taken.


Create a Python 3.8 or newer virtual environment.
If you're not sure how to create a suitable Python environment, the easiest way is using Miniconda. On a Mac, for example, you can install Miniconda using Homebrew:
brew install miniconda

Then you can create and activate a new Python environment by running:
conda create -n my-package python=3.9
conda activate my-package



Now that you have a suitable Python environment, you're ready to personalize this repository. Just run:
pip install -r setup-requirements.txt
python scripts/personalize.py

And then follow the prompts.
:pencil: NOTE: This script will overwrite the README in your repository.


Commit and push your changes, then make sure all GitHub Actions jobs pass.


(Optional) If you plan on publishing your package to PyPI, add repository secrets for PYPI_USERNAME and PYPI_PASSWORD. To add these, go to "Settings" > "Secrets" > "Actions", and then click "New repository secret".
If you don't have PyPI account yet, you can create one for free.


(Optional) If you want to deploy your API docs to readthedocs.org, go to the readthedocs dashboard and import your new project.
Then click on the "Admin" button, navigate to "Automation Rules" in the sidebar, click "Add Rule", and then enter the following fields:

Description: Publish new versions from tags
Match: Custom Match
Custom match: v[vV]
Version: Tag
Action: Activate version

Then hit "Save".
After your first release, the docs will automatically be published to your-project-name.readthedocs.io.


Creating releases
Creating new GitHub and PyPI releases is easy. The GitHub Actions workflow that comes with this repository will handle all of that for you.
All you need to do is follow the instructions in RELEASE_PROCESS.md.
Projects using this template
Here is an incomplete list of some projects that started off with this template:

ai2-tango
cached-path
beaker-py
gantry
ip-bot

☝️ Want your work featured here? Just open a pull request that adds the link.
FAQ
Should I use this template even if I don't want to publish my package?
Absolutely! If you don't want to publish your package, just delete the docs/ directory and the release job in .github/workflows/main.yml.
Contributing
If you find a bug :bug:, please open a bug report.
If you have an idea for an improvement or new feature :rocket:, please open a feature request.
https://packaging.python.org/en/latest/tutorials/packaging-projects/
https://medium.com/analytics-vidhya/how-to-create-a-python-library-7d5aea80cc3f
Build

Increment Version in pyproject.toml
Run 'python3 -m build'
Run 'python3 -m twine upload dist/*'

License

For personal and professional use. You cannot resell or redistribute these repositories in their original state.

Share

• Share on Facebook
• Share on Twitter