ptymini
ptymini fills the gap between ptyprocess (a raw pty fd), pexpect (sync expect loops), and terminado (a pty server welded to tornado): asyncio-native pty sessions. A PtySession is one spawned pty that any number of clients can attach to as independent byte streams, each primed from a byte-bounded replay buffer — so a reconnecting client resumes with recent scrollback instead of a blank screen. The ring and the pty process live in a compiled Rust core; the asyncio surface is pure Python.
A PtyRegistry adds named get-or-create sessions, injected shell setup (rc), and inactivity culling. It carries no server, no framework, and no session persistence beyond the process. Web exposure belongs to the embedding app (e.g. jupygate), and durable session management belongs to tmux.
ptymini.bg is the sync surface, for callers outside an event loop: kernel tools, plain scripts, an LLM deciding between actions. It is the bgterm API, folded in, with sid-named sessions and blocking calls. The wait parameters are fastmux.bg’s. wait_ms bounds the wait for new output. until= returns as soon as the accumulated text matches that regex. settle_ms keeps collecting until output has stopped for that long.
Installation
$ pip install ptymini
Release files for ptymini 0.0.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ptymini-0.0.5.tar.gz | 19.8 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| ptymini-0.0.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.17+ x86-64 | Details |
| ptymini-0.0.5-cp313-cp313-macosx_11_0_arm64.whl | CPython 3.13 | CPython 3.13 | macOS 11.0+ ARM64 | Details |
| ptymini-0.0.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.17+ x86-64 | Details |
| ptymini-0.0.5-cp312-cp312-macosx_11_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 11.0+ ARM64 | Details |
| ptymini-0.0.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.11 | CPython 3.11 | Linux glibc 2.17+ x86-64 | Details |
| ptymini-0.0.5-cp311-cp311-macosx_11_0_arm64.whl | CPython 3.11 | CPython 3.11 | macOS 11.0+ ARM64 | Details |
| ptymini-0.0.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.10 | CPython 3.10 | Linux glibc 2.17+ x86-64 | Details |
| ptymini-0.0.5-cp310-cp310-macosx_11_0_arm64.whl | CPython 3.10 | CPython 3.10 | macOS 11.0+ ARM64 | Details |
Total release size: 2.3 MB
Release files / ptymini-0.0.5.tar.gz
| Download URL | ptymini-0.0.5.tar.gz |
|---|---|
| Size | 19.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6bf05faab7a5c4049028d41f4d8f141455756a1f09fd5a907f11283f73f94a3a
|
|
BLAKE2b-256 checksum How to use checksums |
18ef809175e4878b79a4853d0050002c1b7a6db1fb6558ebf663a23b99787a3e
|
| 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 Aug 29, 2026.
Transparency logRelease files / ptymini-0.0.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | ptymini-0.0.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 303.3 kB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
7b27f0c8e03089989878062aa4546e8f763ac465b7584e84e2539c88f2b42045
|
|
BLAKE2b-256 checksum How to use checksums |
f37e082a6409fff8803393de6cfa096af77b0d611835cf83eb719049e71fc6d1
|
| 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 Aug 29, 2026.
Transparency logRelease files / ptymini-0.0.5-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | ptymini-0.0.5-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 268.4 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ade1786bee7e206aa8f23102444242c1781474a3c594807340deba4b9ccfc1cd
|
|
BLAKE2b-256 checksum How to use checksums |
2a7a4c4b87b75d76681ab31b08ba3ce9d257004744c9d45e3f3d5a25a2acb35d
|
| 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 Aug 29, 2026.
Transparency logRelease files / ptymini-0.0.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | ptymini-0.0.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 303.5 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
bdf2a2c56aaca027e46be4482deb5dbc9e946ceed5383b4b6c3df5c5a0853005
|
|
BLAKE2b-256 checksum How to use checksums |
cd8631b16164e503f664917945fa2334f0399d5b2244adf94a9811d9ba72b8c1
|
| 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 Aug 29, 2026.
Transparency logRelease files / ptymini-0.0.5-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | ptymini-0.0.5-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 268.5 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
88cac933ce83b76983db4dcd8294981b044f0fd3421b8177efcd7ddb59131352
|
|
BLAKE2b-256 checksum How to use checksums |
7e1e4a728c8240d1f2f495eeff02460f223e6329a50bf12d4a057708c970c731
|
| 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 Aug 29, 2026.
Transparency logRelease files / ptymini-0.0.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | ptymini-0.0.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 306.7 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
e1babc84eb55fb3501209ce68e3e451c23dafcbca2d9ebf803fe8109bc30ee12
|
|
BLAKE2b-256 checksum How to use checksums |
c9f7acac767decd367f8a3e43b7e84adcd64a1ee125103c4ab7a203fed954b23
|
| 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 Aug 29, 2026.
Transparency logRelease files / ptymini-0.0.5-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | ptymini-0.0.5-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 273.4 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6bbcc13d3b72d35e89ca752130000bbfc3d850927bc697da1ee7afa5a918f35a
|
|
BLAKE2b-256 checksum How to use checksums |
024d0ef63854e1aa6ec5071df9b9b88c7f238eaf4a8b0b83fec6d8be3d5c2686
|
| 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 Aug 29, 2026.
Transparency logRelease files / ptymini-0.0.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | ptymini-0.0.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 306.1 kB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
5a1d3867724b9ad188dfe1a3407b973c10728d013d8190eca490b13cf99e912b
|
|
BLAKE2b-256 checksum How to use checksums |
b1e654d6b7aadbcd3a11747ae577caa6f8854b3ea164afaac4cf522b4592fcc4
|
| 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 Aug 29, 2026.
Transparency logRelease files / ptymini-0.0.5-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | ptymini-0.0.5-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 273.2 kB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
12d22d7701ccb00e7c23a4c6c956845673c6dd87daf3b16589f48247accb1f8d
|
|
BLAKE2b-256 checksum How to use checksums |
1ff2333729fbfd75456e2c96b65a65c9474bfba6ee4f7ef1af19b2519dce265c
|
| 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 Aug 29, 2026.
Transparency log
