GWAY
GWAY is a lightweight project manager and command dispatcher for the Arthexis/GWAY ecosystem.
The 1.x generation discovers and manages projects from GitHub and exposes each project's commands through a common gway <project> <command> interface. Framework-specific command discovery is provided by adapters, including Python function introspection and Django management commands.
Install the released package with:
python -m pip install gway
GWAY also keeps a first-class Python API. The intended stable import is:
from gway import gway as gw
# Mirrors the CLI namespace once the relevant managed projects are installed.
gw.wireguard.status()
gw.arthexis.check()
from gway import gw remains available as a compatibility alias. The Python facade uses the same registry, adapter, dispatcher, and runner as the CLI rather than bypassing managed project isolation.
Sigils on the CLI
gway-sigils is GWAY's single runtime dependency and provides the sigils Python package used as part of the command-value language. Project names and command paths stay literal for predictable routing; argument values are interpolated before adapter parsing.
Because Sigils is a required GWAY runtime component, installing GWAY already installs it into the same Python environment. The short GWAY-facing name remains sigils, so this is an idempotent runtime install/verification command rather than a second managed-project checkout:
gway install sigils
# installed sigils gway-sigils@0.4.3
The PyPI distribution name gway-sigils is therefore an implementation/distribution detail; users do not need to type the gway- prefix through GWAY. The command refers to the environment that owns the gway executable: a global GWAY installation gives Sigils the same global scope, while virtualenv or pipx installations remain scoped to that environment.
gway web build --output "[project.path]/dist"
gway ocpp connect --label "%[cwd]-[project.name]"
%[...] expressions are captured eagerly before the project-aware lazy context is built. [...] expressions resolve immediately before the selected adapter parses the command arguments.
The built-in GWAY context includes:
[cwd]and[home][gway.config_dir]and[gway.data_dir][project.name],[project.path],[project.adapter],[project.aliases],[project.repository],[project.revision], and[project.environment][command.name]and[command.path]
All regular Sigils built-ins remain available, including the environment tool and eager/lazy recursive semantics supplied by the sigils library itself.
The pre-1.0 implementation has been preserved in arthexis/gway-legacy. Legacy bundled projects, recipes, shared mutable context, and application-specific dependencies are intentionally not part of this codebase.
See PLAN.md for the architecture and implementation sequence. gway-epaper is now explicitly scheduled immediately after the Django/Arthexis end-to-end milestone; see PLAN-EPAPER.md for that roadmap extension.
System / appliance installation
GWAY 1.x can be installed or upgraded as a system command without changing the operating system's default python3:
curl -fsSL https://raw.githubusercontent.com/arthexis/gway/main/install.sh | sudo bash
The bootstrap installer:
- selects an available Python 3.11 or newer interpreter;
- installs GWAY into
/opt/gway/venv; - creates system state under
/etc/gwayand/var/lib/gway; - installs
/usr/local/bin/gwayas the system dispatcher; - automatically archives an existing unmanaged
/usr/local/bin/gwayas/usr/local/bin/gway-legacybefore replacement; - preserves additional differing legacy commands with collision-safe timestamped archive names;
- can be rerun safely to upgrade an existing managed GWAY installation.
Validate prerequisites without changing the machine:
curl -fsSL https://raw.githubusercontent.com/arthexis/gway/main/install.sh -o /tmp/gway-install.sh
bash /tmp/gway-install.sh --check
After installation, managed projects can be installed directly, for example:
sudo gway install wireguard
sudo gway wireguard --help
Development
python -m pip install -e '.[dev]'
python -m gway --help
gway --help
pytest
The package and executable remain named gway; the stable 1.x line starts at version 1.0.0.
1 maintainer
Metadata
1 maintainer
Release files for gway 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gway-1.0.0.tar.gz | 24.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gway-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 47.3 kB
Release files / gway-1.0.0.tar.gz
| Download URL | gway-1.0.0.tar.gz |
|---|---|
| Size | 24.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6cd57b074e3ea7535fb53d8e318a6182636692f9d7ab7c98ccc17da1c2931535
|
|
BLAKE2b-256 checksum How to use checksums |
54c84c39094588bc3940ba1e712a7fab40181fef7cbfc14151899045124ccc2a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.
Transparency logRelease files / gway-1.0.0-py3-none-any.whl
| Download URL | gway-1.0.0-py3-none-any.whl |
|---|---|
| Size | 22.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
84ffcdf08754b091ee40b6ce2233f778527e1da5a348cd86416b46d2acb8369e
|
|
BLAKE2b-256 checksum How to use checksums |
2ea1b68719f0789d47af3eb85ca554d3c65e1ad1cd6a611aef59a5b09f8ca205
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.
Transparency log
