diff --git a/README.md b/README.md index 9c82393..1155a15 100644 --- a/README.md +++ b/README.md @@ -102,16 +102,19 @@ history), or clone the repository for development. Both bundle the same PWA. Everything is on the [latest release](https://github.com/anttro/simtrace-analyser/releases/latest). -**Wheel** (recommended — an isolated install, the PWA is inside the package): +**Wheel** (the PWA is inside the package): ```sh -pipx install ./simtrace_analyser-2.7.11-py3-none-any.whl -# or: pip install ./simtrace_analyser-2.7.11-py3-none-any.whl +pip install ./simtrace_analyser-2.7.11-py3-none-any.whl # then run (the UI is served at http://127.0.0.1:8081/): simtrace-analyser-server --capture gsmtap ``` +If your system Python is externally managed (PEP 668 — common on Arch and +Fedora), install into a virtual environment first: +`python3 -m venv .venv && . .venv/bin/activate`. + `pip` can also fetch the wheel straight from the release page (use the version shown there): @@ -123,7 +126,7 @@ With the GitHub CLI, download the latest wheel without knowing the version: ```sh gh release download --pattern '*.whl' -pipx install ./simtrace_analyser-*.whl +pip install ./simtrace_analyser-*.whl ``` **Source archive** — the *Source code (zip / tar.gz)* assets are the full tree diff --git a/README_RUS.md b/README_RUS.md index dddb63f..67e384a 100644 --- a/README_RUS.md +++ b/README_RUS.md @@ -108,16 +108,19 @@ git) или склонировать репозиторий для разраб Всё находится на странице [последнего релиза](https://github.com/anttro/simtrace-analyser/releases/latest). -**Wheel** (рекомендуется — изолированная установка, PWA внутри пакета): +**Wheel** (PWA внутри пакета): ```sh -pipx install ./simtrace_analyser-2.7.11-py3-none-any.whl -# или: pip install ./simtrace_analyser-2.7.11-py3-none-any.whl +pip install ./simtrace_analyser-2.7.11-py3-none-any.whl # затем запуск (интерфейс отдаётся на http://127.0.0.1:8081/): simtrace-analyser-server --capture gsmtap ``` +Если системный Python управляется извне (PEP 668 — обычное дело в Arch и +Fedora), сначала создайте виртуальное окружение: +`python3 -m venv .venv && . .venv/bin/activate`. + `pip` также может скачать wheel прямо со страницы релиза (подставьте версию, указанную там): @@ -129,7 +132,7 @@ pip install https://github.com/anttro/simtrace-analyser/releases/download/v2.7.1 ```sh gh release download --pattern '*.whl' -pipx install ./simtrace_analyser-*.whl +pip install ./simtrace_analyser-*.whl ``` **Архив исходников** — ассеты *Source code (zip / tar.gz)* содержат полное