poetry is a required package to develop.
git clone https://github.com/vcs-python/libvcs.git
poetry install -E "docs test coverage lint format"
Makefile commands prefixed with
watch_ will watch files and rerun.
poetry run py.test
Rerun tests on file change:
make watch_test (requires entr(1))
Default preview server: http://localhost:8068
cd docs/ and
make html to build.
make serve to start http server.
Rebuild docs on file change:
make watch_docs (requires entr(1))
Rebuild docs and run server via one terminal:
make dev_docs (requires above, and a
-J support, e.g. GNU Make)
Formatting / Linting¶
make black isort: Run
black first, then
isort to handle import nuances
make flake8, to watch (requires
As of 0.10, poetry handles virtualenv creation, package requirements, versioning, building, and publishing. Therefore there is no setup.py or requirements files.
git commit -m 'build(libvcs): Tag v0.1.1' git tag v0.1.1 git push git push --tags poetry build poetry publish