envs-xmpp
Shared technical infrastructure for the envs.net XMPP bots envsbot and
muc_banbot.
One distribution intentionally ships two stable Python packages:
envs_xmpp_core: bot-neutral runtime, XMPP, config, storage and release primitives.envs_xmpp_ops: deployment and operations primitives.
Keeping both in one distribution gives runtime and deployment infrastructure one version, one repository and one release pipeline while preserving the existing import APIs used by both bots.
The package contains no bot commands, permissions, database schemas, moderation logic, plugin systems or bot-specific lifecycle policy.
Compatibility
- Python 3.12 and 3.13
- GPL-3.0-only
- no mandatory third-party runtime dependencies
The bots themselves remain responsible for dependencies such as Slixmpp.
Shared storage primitives include SQLite integrity checking and safe ZIP member validation/streaming. Pagination provides a neutral page-slice model while bot frontends retain their existing command-specific return formats.
Development install
Install the checkout into each bot virtual environment:
python -m pip install -e /path/to/envs-xmpp
Existing imports remain valid:
from envs_xmpp_core.runtime.tasks import TaskSupervisor
from envs_xmpp_ops.profile import DeploymentProfile
Package layout
src/
├── envs_xmpp_core/
│ ├── config/
│ ├── pagination.py
│ ├── release/
│ ├── runtime/
│ ├── storage/
│ │ ├── archive.py
│ │ ├── files.py
│ │ └── sqlite.py
│ └── xmpp/
└── envs_xmpp_ops/
├── accounts.py
├── deploy.py
├── git.py
├── interaction.py
├── paths.py
├── profile.py
├── service.py
├── systemd.py
└── venv.py
envs_xmpp_ops is designed for thin bot-specific deployment frontends. The
frontends keep bot policy such as config migration, database backup/restore and
service hardening local, while shared Git release selection, systemd inspection,
operator confirmation, account/path checks and virtualenv creation live here.
Fresh installs do not assume that this package is already present. Each bot
ships a tiny stdlib-only bootstrap shim. When the exact required envs-xmpp
version is unavailable, that shim creates a versioned cached deployment virtualenv
below $XDG_CACHE_HOME/envs-xmpp/deploy/ (or ~/.cache/envs-xmpp/deploy/),
installs the pinned version from PyPI, and re-executes the deployment frontend.
ENVS_XMPP_DEPLOY_SOURCE can point at a local checkout or wheel for development
and pre-release testing.
CI and PyPI releases
GitHub Actions tests Python 3.12 and 3.13. A vX.Y.Z tag is accepted only when
it exactly matches project.version in pyproject.toml. Release distributions
are published through PyPI Trusted Publishing/OIDC, without a long-lived PyPI
token.
PyPI publishing is configured through the pypi GitHub environment and the
Trusted Publisher for envs-net/envs-xmpp using .github/workflows/release.yml.
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 envs_xmpp-0.3.1.tar.gz.
File metadata
- Download URL: envs_xmpp-0.3.1.tar.gz
- Upload date:
- Size: 42.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
deb4123a4924c3781670eea12925d1fe1236846a27fd0f0dabebdcdc0b4e5b41
|
|
| MD5 |
9a640f51e6ca29054b2e2299555c083a
|
|
| BLAKE2b-256 |
a264dd83089979dc36d1c47588fa078c09981db64d712fcc4deb977094923981
|
Provenance
The following attestation bundles were made for envs_xmpp-0.3.1.tar.gz:
Publisher:
release.yml on envs-net/envs-xmpp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
envs_xmpp-0.3.1.tar.gz -
Subject digest:
deb4123a4924c3781670eea12925d1fe1236846a27fd0f0dabebdcdc0b4e5b41 - Sigstore transparency entry: 2723642165
- Sigstore integration time:
-
Permalink:
envs-net/envs-xmpp@e7a31ca7e482321b9a0933e8469827ea0a040877 -
Branch / Tag:
refs/tags/v0.3.1 - Owner: https://github.com/envs-net
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@e7a31ca7e482321b9a0933e8469827ea0a040877 -
Trigger Event:
push
-
Statement type:
File details
Details for the file envs_xmpp-0.3.1-py3-none-any.whl.
File metadata
- Download URL: envs_xmpp-0.3.1-py3-none-any.whl
- Upload date:
- Size: 45.1 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 |
83f7f748c159a1a2b26f31b1bca6f41777b63479190d4f837a5644637d0a80b7
|
|
| MD5 |
6dce255e33584db6c286b67ee26faf99
|
|
| BLAKE2b-256 |
c0189ee083ac9997e66badeefc3169dd696df050c74946967cfaa5a5de62a0c5
|
Provenance
The following attestation bundles were made for envs_xmpp-0.3.1-py3-none-any.whl:
Publisher:
release.yml on envs-net/envs-xmpp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
envs_xmpp-0.3.1-py3-none-any.whl -
Subject digest:
83f7f748c159a1a2b26f31b1bca6f41777b63479190d4f837a5644637d0a80b7 - Sigstore transparency entry: 2723642362
- Sigstore integration time:
-
Permalink:
envs-net/envs-xmpp@e7a31ca7e482321b9a0933e8469827ea0a040877 -
Branch / Tag:
refs/tags/v0.3.1 - Owner: https://github.com/envs-net
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@e7a31ca7e482321b9a0933e8469827ea0a040877 -
Trigger Event:
push
-
Statement type:
