elsewindow 0.1.0__py3-none-any.whl

elsewindow-0.1.0.dist-info/METADATA

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: elsewindow
+Version: 0.1.0
+Summary: Run one remote Linux GUI application through Xpra over one owned OpenSSH master
+Author: kogeler
+Maintainer: kogeler
+License-Expression: MIT
+Project-URL: Homepage, https://kogeler.github.io/elsewindow/
+Project-URL: Documentation, https://kogeler.github.io/elsewindow/
+Project-URL: Repository, https://github.com/kogeler/elsewindow
+Project-URL: Issues, https://github.com/kogeler/elsewindow/issues
+Project-URL: Changelog, https://github.com/kogeler/elsewindow/blob/main/CHANGELOG.md
+Keywords: xpra,openssh,ssh,wayland,remote-desktop
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: System :: Networking
+Classifier: Typing :: Typed
+Requires-Python: <3.15,>=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ssh-wrapper==0.1.0
+Provides-Extra: quality
+Requires-Dist: bandit[toml]==1.9.4; extra == "quality"
+Requires-Dist: mypy==2.3.1; extra == "quality"
+Requires-Dist: pip-audit==2.10.1; extra == "quality"
+Requires-Dist: pip-licenses==5.5.5; extra == "quality"
+Requires-Dist: ruff==0.16.5; extra == "quality"
+Provides-Extra: test
+Requires-Dist: pytest==9.1.1; extra == "test"
+Requires-Dist: pytest-asyncio==1.4.0; extra == "test"
+Requires-Dist: pytest-cov==7.1.0; extra == "test"
+Requires-Dist: pytest-xdist==3.8.0; extra == "test"
+Provides-Extra: package
+Requires-Dist: build==1.6.0; extra == "package"
+Requires-Dist: setuptools==84.0.0; extra == "package"
+Requires-Dist: wheel==0.48.0; extra == "package"
+Provides-Extra: standalone
+Requires-Dist: pyinstaller==6.22.2; extra == "standalone"
+Provides-Extra: docs
+Requires-Dist: mkdocs-material==9.7.7; extra == "docs"
+Dynamic: license-file
+
+# Elsewindow
+
+`elsewindow` starts one GUI application on a remote Linux host and shows
+its windows through Xpra. One owned OpenSSH ControlMaster carries every Xpra
+control channel; the command opens no forwarding or Xpra TCP listener and
+cleans only the server, application process group, sockets, and runtime state
+created by that invocation.
+
+The application renders through the remote Wayland compositor and remote GPU.
+Only Xpra picture, input, and control traffic crosses SSH.
+
+## Install And Run
+
+The Python distribution requires Linux, CPython 3.13 or 3.14, OpenSSH,
+`false`, a local graphical session, and compatible Xpra packages on both
+systems. Install with pip or pipx after the first release:
+
+```bash
+python3.14 -m pip install "elsewindow==0.1.0"
+# or: pipx install "elsewindow==0.1.0"
+elsewindow --ssh-alias agents-a -- xterm
+```
+
+Check packaged versions, profile digests, Linux support, and local commands
+without opening a connection:
+
+```bash
+elsewindow --diagnose
+```
+
+The published distribution resolves the exact reviewed
+[`ssh-wrapper==0.1.0`](https://pypi.org/project/ssh-wrapper/0.1.0/) dependency.
+For a source checkout, prepare the hash-locked runtime and use the repository
+launcher from any working directory:
+
+```bash
+make runtime-venv
+./bin/elsewindow --help
+```
+
+Use a direct authority when an OpenSSH alias is not appropriate:
+
+```bash
+elsewindow \
+  --host host.example \
+  --user desktop-user \
+  --port 2222 \
+  -- /opt/application/bin/application
+```
+
+The default encoding and network profiles are `rgb` and `gigabit_lan`.
+Production arguments come exclusively from the reviewed YAML mirrors shipped
+inside the Python package. See [the Xpra guide](doc/xpra.md) for profile,
+hardware, application, and lifecycle details.
+
+## Installing The Maintained Xpra Build
+
+[`tools/install_xpra_release.py`](tools/install_xpra_release.py) is a standalone
+standard-library installer for Debian 13 and Ubuntu 26.04. It resolves the
+newest canonical package release from `kogeler/xpra:develop`, verifies archive
+and DEB contents before mutation, prints the exact installed Xpra inventory,
+and requires interactive confirmation before purging that inventory. It uses
+APT for the validated local packages and dependencies.
+
+Elsewindow deliberately uses this maintained fork rather than treating a
+generic upstream Xpra build as interchangeable. Project development uncovered
+dozens of blocking Xpra defects: some fixes were accepted as direct upstream
+contributions, some were implemented by the upstream maintainer after issue
+reports, and some were not accepted after technical disagreements. The last
+category requires continued maintenance of additional fork patches. The
+[Xpra guide](doc/xpra.md#why-the-maintained-xpra-fork-is-required) explains
+the resulting user compatibility boundary.
+
+Review the installer and the [security contract](doc/security.md). The streamed
+route below is pending until the first reviewed `main` push; it must not be
+treated as available before then:
+
+```bash
+( set -o pipefail; curl --proto '=https' --tlsv1.2 -fsSL 'https://raw.githubusercontent.com/kogeler/elsewindow/main/tools/install_xpra_release.py' | /usr/bin/python3 - )
+```
+
+Do not prefix the pipeline or Python process with `sudo`. When privilege is
+needed, the reviewed script reads purge confirmation from the controlling
+terminal and invokes `/usr/bin/sudo` itself only for its root-owned staging and
+APT transaction.
+
+## Standalone Linux Executables
+
+After the first release, GitHub Releases provide `elsewindow-linux-amd64` and
+`elsewindow-linux-arm64`. These native one-file ELF executables bundle
+Elsewindow, CPython, `ssh-wrapper`, version metadata, and the reviewed YAML
+profiles. They do not bundle OpenSSH, Xpra, Podman, GPU drivers, VA-API, or
+distribution packages. Verify the release's `SHA256SUMS.txt`, make the selected
+file executable, and run `./elsewindow-linux-amd64 --diagnose` (or the arm64
+equivalent) before starting a session.
+
+## Documentation
+
+- [Rendered documentation site](https://kogeler.github.io/elsewindow/)
+  (published by the first reviewed direct `main` push)
+- [Getting started](doc/getting-started.md)
+- [Complete Xpra behavior and options](doc/xpra.md)
+- [Security model](doc/security.md)
+- [Architecture](doc/architecture.md)
+- [Development and validation](doc/development.md)
+- [Contributing](doc/contributing.md)
+- [Maintainer CI contract](doc/maintenance/CI.md)
+- [Dependency maintenance](doc/maintenance/DEPENDENCIES.md)
+- [Release maintenance](doc/maintenance/RELEASES.md)
+
+The Pages workflow renders these same maintained Markdown files and validates
+every generated route, local link, anchor, canonical URL, sitemap, crawler
+file, and advertised `llms.txt` route without network access.
+
+## Automatic Live Validation
+
+`make live-test` resolves the newest fork release, builds checksum-bound Ubuntu
+target and Debian client images, and runs detach and abrupt-master-loss cases
+on a private rootless Podman network. The payload excludes `elsewindow/` source
+and clean-installs the already verified wheel. The harness generates a fresh
+Ed25519 key, performs exactly one authentication per case, verifies a visible
+window and picture updates through the production profile assembler, preserves
+an unrelated session, and removes only its labelled containers and network.
+All wheel, test, and key material enters through validated tar streams; the
+test uses no host bind, data volume, or copy channel.
+
+Released under the [MIT License](LICENSE).

elsewindow-0.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+elsewindow/__init__.py,sha256=ALFyD2F0T7NcXFxQ3PCjK7XP8L5o7bdxONADiyRe7Aw,908
+elsewindow/__main__.py,sha256=UH6MmUHIDl-EY2wq48YejD0aRP2whKfUSoA_O7bT6Wc,151
+elsewindow/cli.py,sha256=fQKACyWuX7x_2YQdIo5BU5awMq8pmSvwgxCCZ-8F2gY,6969
+elsewindow/config.py,sha256=uWlKrRQsABx1gJO1WZv-usV30M3Ouk0mTpUSKr5oDTA,5938
+elsewindow/live-cli.yml,sha256=7JkCFbztfx7VdyABONVhc19T3PbcKEVTNr4WPLLcu28,2513
+elsewindow/live_config.py,sha256=iUzxk_DjhNrOvQF4Bgqd-KFLIRFZ6xjE2TaKDUEFHqc,16460
+elsewindow/profiles.yml,sha256=GoP4CbK2Z4SqyG_Iz44fnB8hef7POLWQVkA2778rIjI,1072
+elsewindow/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+elsewindow/session.py,sha256=_zIBGL_mjszw6f6qlPxsodNstvNT0180x_cwjvywzJI,28225
+elsewindow-0.1.0.dist-info/licenses/LICENSE,sha256=E-AV8LBuBuC247TAAvpwmjjtYMEP06T5cmr-ke-C-bw,1064
+elsewindow-0.1.0.dist-info/METADATA,sha256=VQ9XKdu6mgDSS1kkvOSc07sliXsEiLRY7b1Rzl2RVxs,7621
+elsewindow-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+elsewindow-0.1.0.dist-info/entry_points.txt,sha256=qL3JOigCATPQYeO-_vqjL-EHju-j3BU5SJWovMxZASw,51
+elsewindow-0.1.0.dist-info/top_level.txt,sha256=uQKM1KqnKYGc5A1DGdyJ3PAFOAtZy_xLDVAAyvKWslw,11
+elsewindow-0.1.0.dist-info/RECORD,,

elsewindow-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

elsewindow-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+elsewindow = elsewindow.cli:main

elsewindow-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kogeler
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

elsewindow-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+elsewindow