taut-pg
Postgres support package for Taut.
This package is intentionally separate from the core taut-chat
distribution. It installs simplebroker-pg in the same environment as the
taut CLI so .taut.toml can select the public SimpleBroker Postgres
backend.
Requirements
- Python 3.11+
- PostgreSQL
- A dedicated schema for Taut and SimpleBroker tables
- Core distribution
taut-chatand extensiontaut-pginstalled in the same environment
The Postgres database must already exist. taut init initializes the configured
schema and tables inside that database; it does not create the database.
Installation
The core distribution is taut-chat; it still installs the taut command and
import package. taut-pg keeps its own distribution name and
taut_pg/vX.Y.Z tag stream. Once the first coordinated PyPI release is
published:
pipx install taut-chat
pipx inject taut-chat taut-pg
The tag gate reuses the exact wheel and sdist built by canonical Test. It
stages them in a draft GitHub Release, publishes them through the
taut-pg top-level PyPI Trusted Publisher, verifies filenames and SHA-256
digests, and only then publishes the GitHub Release as immutable.
Configuration
Create .taut.toml in the project root:
version = 1
backend = "postgres"
target = "postgresql://postgres:postgres@127.0.0.1:54329/taut_test"
[backend_options]
schema = "taut_project"
The credentials above are for a disposable local test database. A real target
DSN may contain a password and must be treated as a secret. If .taut.toml
contains one, add the file to your project's .gitignore, do not commit
production credentials, and restrict it to the owner on POSIX systems (for
example, chmod 600 .taut.toml). Taut does not interpolate environment
variables in this file.
Then initialize Taut normally:
taut init
taut join general
TAUT_DB, --db, and db_path= remain filesystem path selectors. Use
.taut.toml to select Postgres.
Testing
From the repository root:
uv run ./bin/pytest-pg
That helper starts a temporary Docker Postgres container, runs shared Taut tests
against Postgres, runs pg_only extension tests, and removes the container.
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 taut_pg-0.8.0.tar.gz.
File metadata
- Download URL: taut_pg-0.8.0.tar.gz
- Upload date:
- Size: 2.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b3ff2bad74da8e8496ceccb9f31bb9099d7d3f2a25bfa9e10d70eb65eac3f790
|
|
| MD5 |
77d28ead544b8d4e88fc4b5c1f875752
|
|
| BLAKE2b-256 |
0f4aa2e2010afb16ee9d375066888596aa59aec0be684c415888e5eee7a1a235
|
File details
Details for the file taut_pg-0.8.0-py3-none-any.whl.
File metadata
- Download URL: taut_pg-0.8.0-py3-none-any.whl
- Upload date:
- Size: 5.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0dba32c2527d0588bae51a1115198a46af14eed9f07a6cdae43ef39ce9e32378
|
|
| MD5 |
6f57af058abc96b8fdd8f0437ebabcee
|
|
| BLAKE2b-256 |
0602d2c3a92134087ed8ba99be288d5608b2e44c62a999f57e69f435b5cc6fcc
|
