[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL 06/15] python: Add no-install usage instructions
From: |
John Snow |
Subject: |
[PULL 06/15] python: Add no-install usage instructions |
Date: |
Wed, 30 Jun 2021 22:09:12 -0400 |
It's not encouraged, but it's legitimate to want to know how to do.
Signed-off-by: John Snow <jsnow@redhat.com>
Reviewed-by: Willian Rampazzo <willianr@redhat.com>
Reviewed-by: Wainer dos Santos Moschetta <wainersm@redhat.com>
Message-id: 20210629214323.1329806-7-jsnow@redhat.com
Signed-off-by: John Snow <jsnow@redhat.com>
---
python/README.rst | 28 ++++++++++++++++++++++++++++
1 file changed, 28 insertions(+)
diff --git a/python/README.rst b/python/README.rst
index 107786ffdc..d4502fdb60 100644
--- a/python/README.rst
+++ b/python/README.rst
@@ -37,6 +37,34 @@ See `Installing packages using pip and virtual environments
for more information.
+Using these packages without installing them
+--------------------------------------------
+
+These packages may be used without installing them first, by using one
+of two tricks:
+
+1. Set your PYTHONPATH environment variable to include this source
+ directory, e.g. ``~/src/qemu/python``. See
+ https://docs.python.org/3/using/cmdline.html#envvar-PYTHONPATH
+
+2. Inside a Python script, use ``sys.path`` to forcibly include a search
+ path prior to importing the ``qemu`` namespace. See
+ https://docs.python.org/3/library/sys.html#sys.path
+
+A strong downside to both approaches is that they generally interfere
+with static analysis tools being able to locate and analyze the code
+being imported.
+
+Package installation also normally provides executable console scripts,
+so that tools like ``qmp-shell`` are always available via $PATH. To
+invoke them without installation, you can invoke e.g.:
+
+``> PYTHONPATH=~/src/qemu/python python3 -m qemu.qmp.qmp_shell``
+
+The mappings between console script name and python module path can be
+found in ``setup.cfg``.
+
+
Files in this directory
-----------------------
--
2.31.1
- [PULL 00/15] Python patches, John Snow, 2021/06/30
- [PULL 01/15] python/qom: Do not use 'err' name at module scope, John Snow, 2021/06/30
- [PULL 03/15] python: Remove global pylint suppressions, John Snow, 2021/06/30
- [PULL 02/15] python: expose typing information via PEP 561, John Snow, 2021/06/30
- [PULL 05/15] python: README.rst touchups, John Snow, 2021/06/30
- [PULL 08/15] python: update help text for check-tox, John Snow, 2021/06/30
- [PULL 04/15] python: Re-lock pipenv at *oldest* supported versions, John Snow, 2021/06/30
- [PULL 06/15] python: Add no-install usage instructions,
John Snow <=
- [PULL 07/15] python: rename 'venv-check' target to 'check-pipenv', John Snow, 2021/06/30
- [PULL 09/15] python: Fix .PHONY Make specifiers, John Snow, 2021/06/30
- [PULL 12/15] python: Update help text on 'make check', 'make develop', John Snow, 2021/06/30
- [PULL 11/15] python: add 'make check-dev' invocation, John Snow, 2021/06/30
- [PULL 13/15] python: Update help text on 'make clean', 'make distclean', John Snow, 2021/06/30
- [PULL 10/15] python: only check qemu/ subdir with flake8, John Snow, 2021/06/30
- [PULL 14/15] python: remove auto-generated pyproject.toml file, John Snow, 2021/06/30
- [PULL 15/15] python: Fix broken ReST docstrings, John Snow, 2021/06/30