From 8e05bbbf7eba1421f2001aa2270910909a45b760 Mon Sep 17 00:00:00 2001 From: Zixian Cai <2891235+caizixian@users.noreply.github.com> Date: Mon, 22 Jul 2024 23:37:36 +1000 Subject: [PATCH] Clarify devleopment setup in README --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 1e56beb..a11406d 100644 --- a/README.md +++ b/README.md @@ -4,22 +4,22 @@ ## Installation `pip3 install running-ng` +There are two [extras](https://peps.python.org/pep-0508/#extras) available. +- `zulip`: dependencies for the `Zulip` `runbms` plugin, useful for users. +- `tests`: dependencies for running tests, useful for package developers. + ## Development setup -```console +```bash virtualenv env source env/bin/activate -pip install -U pip setuptools build[virtualenv] twine +pip install -e .[zulip,tests] +pip install -U pip setuptools build[virtualenv] twine # extra packages for building releases ``` - To make a distribution archives, run `python -m build` within the virtual environment. -- To run an editable build in the virtual environment, run `pip install -e .`. - To install to user `site-packages`, run `pip install dist/running_ng--py3-none-any.whl` outside the virtual environment. - To update to PyPI, run `twine upload --repository running-ng dist/**`. -There are two [extras](https://peps.python.org/pep-0508/#extras) available. -- `zulip`: dependencies for the `Zulip` `runbms` plugin. -- `tests`: dependencies for running tests. - ## Documentation Please refer to [this site](https://anupli.github.io/running-ng/) for up-to-date documentations.