taut-pg
Postgres support package for Taut.
This package is intentionally separate from taut. 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
tautandtaut-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
Taut releases are GitHub-only until package-name clearance changes. Install the
core package first, then inject a compatible extension wheel from the extension
GitHub Release into the same environment. taut-pg uses its own
taut_pg/vX.Y.Z tag stream, so its version can differ from the core package
version:
pipx install "git+https://github.com/VanL/taut.git@v0.7.0"
pipx inject taut ./taut_pg-0.7.0-py3-none-any.whl
Do not use a PyPI install command for taut-pg until the project documents
PyPI publication.
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.7.0.tar.gz.
File metadata
- Download URL: taut_pg-0.7.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 |
ba42fd7c17f445065bd5796aeb18175c85748a126b41bd83585d76a08768bd8c
|
|
| MD5 |
3bd9f505202f7e98018c7d02795b0822
|
|
| BLAKE2b-256 |
527a2a0779a25070ce03da1e4ced5f4816065add6212d90df0e48925937019b8
|
File details
Details for the file taut_pg-0.7.0-py3-none-any.whl.
File metadata
- Download URL: taut_pg-0.7.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 |
bf2c9027495fa9dcb8e08bf366a63b8c835635505a2f1645a64e7781e27ef354
|
|
| MD5 |
817d84a7bbfbe26f3cab44a07852c215
|
|
| BLAKE2b-256 |
5646e93e6c8694db60492e4a0ab8da4f85687dd8390038fa52891ddd80a704a0
|
