szpont
Install-and-run for Diplomat (Szpont Yon) - the menu-bar / system-tray applet that reviews your pull requests, fixes your own, resolves conflicts, and keeps one device per agent.
pip install szpont && szpont # or: npx szpont
That is the whole install. macOS and Linux.
What it actually does
Diplomat is built out of the checkout it runs from - a SwiftUI bundle on macOS, a
PySide6 package plus the diplomat-core Swift binary on Linux - and it keeps
being that checkout: the Update button, the daily 06:00 timer and the commit the
panel reports are all git operations on it. A wheel holding a copy would be a
second Diplomat that no update could reach.
So this distribution is the steps in between, and every one of them runs a script that is already in the repository:
| macOS | Linux | |
|---|---|---|
| get it | git clone into ~/.diplomat/checkout, or fast-forward it |
same |
| build it | install/build-app.sh → Diplomat.app |
install/build-core.sh when the prompt binary is missing |
| set it up | - | a venv at ~/.diplomat/venv with requirements.txt in it |
| start it | open Diplomat.app |
the package's own ./diplomat, on the venv's interpreter |
Nothing is rebuilt that does not need to be: a venv is left alone until
requirements.txt changes, and the Swift prompt binary is only built when the
applet would not find one. git is needed to fetch Diplomat, and a Swift
toolchain to build it - if one is missing you are told which and where to get it,
before anything is downloaded.
szpont --plan # print what would be run, as JSON, and do none of it
szpont --no-update # launch the checkout as it stands
szpont -- --dump # everything after -- goes to the applet
DIPLOMAT_SELF_REPO points at a checkout of your own - the same variable the
running applet reads, and one this launcher never updates, because a working copy
may have work in it. DIPLOMAT_REPO_URL clones from a fork.
The same name on both indexes
npx szpont runs the same launcher, and that is all either name installs: one
file of standard library on each side, no dependency on either index. What keeps
them one command is packages/szpont-npm/test/parity-with-python.mjs - every
machine shape in test/scenarios.mjs goes through both planners, and the two
answers have to be identical.
The protocol Diplomat's machines find each other over is
SzpontNet,
published separately as szpontnet; nothing here imports it, and installing this
does not install it.
Its own tests
pip install pytest
pytest packages/szpont/tests -q
Note on the name
szpont names three things, and they share the namespace rather than compete for
it: this command, its npm twin, and the
conformance tester,
run as python -m szpont from its own directory.
Only the tester is precarious. It is never installed, and the working directory
precedes site-packages on sys.path, so it wins from where it is run - but
publishing it under this name is what the three could not share. The console
script cannot collide with it at all: an entry point is a file in bin/, not a
name on the import path, and the module this one lives in is szpont_launcher.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file szpont-0.26.0.tar.gz.
File metadata
- Download URL: szpont-0.26.0.tar.gz
- Upload date:
- Size: 14.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7247014a99f3aba0e3fd1414d691a5a31cb14fedbb3f27eef209a086596753f6
|
|
| MD5 |
8a4e0d2af247ca187df576f50e3e7027
|
|
| BLAKE2b-256 |
062959475e6d31a4873f591295b3a8b44802de3b403987fd543c8a9071c39665
|
Provenance
The following attestation bundles were made for szpont-0.26.0.tar.gz:
Publisher:
release-szpont.yml on latekvo/Diplomat
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
szpont-0.26.0.tar.gz -
Subject digest:
7247014a99f3aba0e3fd1414d691a5a31cb14fedbb3f27eef209a086596753f6 - Sigstore transparency entry: 2580499273
- Sigstore integration time:
-
Permalink:
latekvo/Diplomat@8e7c618e66f310ca9405b69aa34a0fbe4adc97e3 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/latekvo
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-szpont.yml@8e7c618e66f310ca9405b69aa34a0fbe4adc97e3 -
Trigger Event:
push
-
Statement type:
File details
Details for the file szpont-0.26.0-py3-none-any.whl.
File metadata
- Download URL: szpont-0.26.0-py3-none-any.whl
- Upload date:
- Size: 9.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
76a352421f58f222ab8d9b69dfeeeda8bc2ecd259585b45d0670226dc5999efc
|
|
| MD5 |
a2ac42c343d623ac271407ea306c76a2
|
|
| BLAKE2b-256 |
6a8a57fc1c5f92e9d353bdda5d39af9e5197b43f1ae8eeb7bb157847183c3be1
|
Provenance
The following attestation bundles were made for szpont-0.26.0-py3-none-any.whl:
Publisher:
release-szpont.yml on latekvo/Diplomat
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
szpont-0.26.0-py3-none-any.whl -
Subject digest:
76a352421f58f222ab8d9b69dfeeeda8bc2ecd259585b45d0670226dc5999efc - Sigstore transparency entry: 2580499314
- Sigstore integration time:
-
Permalink:
latekvo/Diplomat@8e7c618e66f310ca9405b69aa34a0fbe4adc97e3 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/latekvo
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-szpont.yml@8e7c618e66f310ca9405b69aa34a0fbe4adc97e3 -
Trigger Event:
push
-
Statement type:
