zzz233
A minimal python package.
- download locally
- clone repository:
git clone git@github.com:husisy/zzz233.git
- download zip:
wget xxx
- download released package: TODO
- clone repository:
- install
- install from pypi:
pip install zzz233
- install locally:
pip install .
- (for developer) install locally:
pip install ".[dev]"
- (for documentation developer) install locally:
pip install ".[doc]"
- install from github:
pip install git+https://github.com/husisy/zzz233.git
- install from pypi:
- uninstall
pip uninstall zzz233
- scrips
- run in command line:
zzz233
- run in command line:
- unittest: download locally
pytest
- (require developer install locally) coverage
pytest --cov=python/zzz233
- documentation
- build locally:
mkdocs serve
- website:
https://husisy.github.io/zzz233/
- build locally:
- github action (CI/CD)
- build documentation, enable github page (select deploy from actions)
- unittest
- reading material
- github/setuptools_scm (Source Code Management)
- setuptools/pyproject-config
- distribute package to pypi
TODO make a clear table
usage
# a dummy example
from zzz233 import from_pickle, to_pickle
a = 233
to_pickle(a=a)
assert from_pickle('a')==a
TODO
- semantic versioning link
development
new environment
micromamba create -n zzz233 python
micromamba activate zzz233
pip install .
# pip install -e ".[dev]"
mkdocs serve
publish to pypi
# cleanup the branch and tag the latest commit with a valid version
# otherwise the build will fail
rm -rf ./dist
pip install build
python -m build
# testpypi
# setup testpypi apikey $HOME/.pypirc (the username is "__token__")
twine upload --repository testpypi dist/*
# --repository-url https://test.pypi.org/legacy/
pip uninstall zzz233
pip install --upgrade -i https://test.pypi.org/simple/ zzz233
# pypi
# --repository-url https://upload.pypi.org/legacy/