From b13e4a2a96c2d88890157fdd0b116619436761c4 Mon Sep 17 00:00:00 2001 From: alvyjudy Date: Mon, 25 May 2020 21:32:01 -0400 Subject: docs: add dev mode section in quickstart --- docs/userguide/quickstart.txt | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) (limited to 'docs/userguide') diff --git a/docs/userguide/quickstart.txt b/docs/userguide/quickstart.txt index 224be368..52829751 100644 --- a/docs/userguide/quickstart.txt +++ b/docs/userguide/quickstart.txt @@ -167,6 +167,26 @@ The data files must be specified via the distutils' ``MANIFEST.in`` file. For more details, see :ref:`datafiles` +Development mode +================ +``setuptools`` allows you to install a package without copying any files +to your interpretor directory (e.g. the ``site-packages`` directory). This +allows you to modify your source code and have the changes take effect without +you having to rebuild and reinstall. This is currently incompatible with +PEP 517 and therefore it requires a ``setup.py`` script with the following +content:: + + import setuptools + setuptools.setup() + +Then:: + + pip install --editable . + +This creates a link file in your interpretor site package directory which +associate with your source code. For more information, see: (WIP) + + Uploading your package to PyPI ============================== After generating the distribution files, next step would be to upload your -- cgit v1.2.1