Release / release (push) Waiting to run
The releases carried the wheel and the sdist; the only zip was GitHub's source archive of the whole repository (tests, CI, tools). A Windows user just wants to extract a folder and double-click start.bat. - scripts/build_release_zip.py builds simtrace-analyser-<version>.zip with a single top-level directory: the two Python packages, the PWA runtime files (frontend/tests and package.json stay out), the four launchers, the udev rule, the READMEs and the screenshot. The .bat entries are written with CRLF line endings (cmd.exe mishandles bare-LF labels/goto), the .sh files keep their executable bit; LICENSE is included automatically once the repo has one. - tests/test_release_zip.py pins the archive shape, the exclusions, the sw.js PRECACHE drift (every precached asset must travel), the CRLF/LF line endings and start.sh's mode. - the release workflow builds the zip, checks it carries start.bat and the PWA, uploads it with the run and attaches it to the release. - READMEs (EN/RU) and the release-notes template offer the zip as the Windows-friendly option; version 2.7.12, PWA cache v94. Verified: the built zip (34 entries, 658 KB compressed) extracted and started on Linux serves the same index.html; 553 Python + 80 Node tests.
21 lines
946 B
Markdown
21 lines
946 B
Markdown
Install the wheel below — the PWA is bundled inside it:
|
|
|
|
```
|
|
pip install ./simtrace_analyser-*.whl
|
|
simtrace-analyser-server --capture gsmtap
|
|
```
|
|
|
|
The UI is then served at http://127.0.0.1:8081/. 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`).
|
|
|
|
The source archive is the same tree a clone would have: unzip it and run
|
|
`./start.sh` (Linux/macOS) or `start.bat` (Windows). Direct SIMtrace2 capture
|
|
on Linux additionally needs the attached `70-simtrace2-pysniff.rules` udev rule.
|
|
|
|
**Runtime zip (Windows-friendly, no installer)** — `simtrace-analyser-*.zip`
|
|
is the runtime tree only (packages, PWA, launchers, docs — no tests, no git):
|
|
extract it anywhere and run `start.bat` (Windows) or `./start.sh`
|
|
(Linux/macOS). Python 3 has to be on `PATH`; `pip install pyusb` is only
|
|
needed for direct SIMtrace2 capture.
|