tigrbl_engine_postgres 0.4.2.dev3__tar.gz → 0.4.2.dev4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,7 @@
1
+ Tigrbl
2
+ Copyright 2026 Swarmauri
3
+
4
+ This product includes software developed by Swarmauri.
5
+
6
+ Tigrbl is licensed under the Apache License, Version 2.0.
7
+ See the LICENSE file distributed with this work for the full license text.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: tigrbl_engine_postgres
3
- Version: 0.4.2.dev3
3
+ Version: 0.4.2.dev4
4
4
  Summary: PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.
5
5
  Project-URL: Organization, https://github.com/tigrbl
6
6
  Project-URL: Discord, https://discord.gg/K4YTAPapjR
@@ -210,6 +210,7 @@ License: Apache License
210
210
  See the License for the specific language governing permissions and
211
211
  limitations under the License.
212
212
  License-File: LICENSE
213
+ License-File: NOTICE
213
214
  Keywords: api,asgi,database,engine,json-rpc,openapi,openrpc,plugin,postgres,postgresql,psycopg,pydantic,rest,schema-first,sqlalchemy,tigrbl
214
215
  Classifier: Development Status :: 3 - Alpha
215
216
  Classifier: Framework :: AsyncIO
@@ -240,12 +241,45 @@ Description-Content-Type: text/markdown
240
241
  <p><strong>PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.</strong></p>
241
242
  <a href="https://pypi.org/project/tigrbl_engine_postgres/"><img src="https://img.shields.io/pypi/v/tigrbl_engine_postgres?label=PyPI" alt="PyPI version for tigrbl_engine_postgres"/></a>
242
243
  <a href="https://pypi.org/project/tigrbl_engine_postgres/"><img src="https://static.pepy.tech/badge/tigrbl_engine_postgres" alt="Downloads for tigrbl_engine_postgres"/></a>
244
+ <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl_engine_postgres"/></a>
243
245
  <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_postgres/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_postgres/README.md.svg?label=hits" alt="Repository hits for tigrbl_engine_postgres README"/></a>
244
246
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
245
- <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl_engine_postgres"/></a>
247
+ <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl_engine_postgres"/></a>
246
248
  <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-engines-1f6feb" alt="Workspace group for tigrbl_engine_postgres"/></a>
247
249
  </div>
248
250
 
251
+ ## What is tigrbl_engine_postgres?
252
+
253
+ PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.
254
+
255
+ ## Why use tigrbl_engine_postgres?
256
+
257
+ Use it when a Tigrbl application needs this backend without installing every engine package.
258
+
259
+ ## When should I install tigrbl_engine_postgres?
260
+
261
+ Install it when the storage, analytics, cache, or integration workload named by this package is the intended runtime backend.
262
+
263
+ ## Who is tigrbl_engine_postgres for?
264
+
265
+ Application developers, data platform engineers, and operators choosing concrete persistence or data-plane behavior.
266
+
267
+ ## Where does tigrbl_engine_postgres fit?
268
+
269
+ `tigrbl_engine_postgres` lives at `pkgs/engines/tigrbl_engine_postgres` and serves PostgreSQL-backed production persistence and SQLAlchemy workflows.
270
+
271
+ ## How does tigrbl_engine_postgres work?
272
+
273
+ It exposes a `tigrbl.engine` entry point and a package `register()` hook so Tigrbl can discover or load the backend at runtime.
274
+
275
+ ## Certification Status
276
+
277
+ - Package status: governed package in the `tigrbl/tigrbl` workspace.
278
+ - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
279
+ - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
280
+ - Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
281
+ - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
282
+
249
283
  ## Install
250
284
 
251
285
  ```bash
@@ -256,50 +290,104 @@ uv add tigrbl_engine_postgres
256
290
  pip install tigrbl_engine_postgres
257
291
  ```
258
292
 
293
+ ## Surface Coverage
294
+
295
+ | Surface | Value |
296
+ |---|---|
297
+ | PyPI package | [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/) |
298
+ | Repository path | [`pkgs/engines/tigrbl_engine_postgres`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_postgres) |
299
+ | Python import root | `tigrbl_engine_postgres` |
300
+ | Console scripts | none declared |
301
+ | Entry points | `tigrbl.engine` |
302
+ | Optional extras | none declared |
303
+ | Legal files | `LICENSE`, `NOTICE` |
304
+ | Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
305
+
259
306
  ## What It Owns
260
307
 
261
- `tigrbl_engine_postgres` owns the engine postgres backend boundary for Tigrbl, including engine registration, session adapters, and backend-specific helpers. Key implementation roots include `tigrbl_engine_postgres` with `engine, plugin, session`.
308
+ `tigrbl_engine_postgres` owns the `engine plugin` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
262
309
 
263
- ## Use It When
310
+ Implementation orientation:
311
+ - `tigrbl_engine_postgres`: engine, plugin, session
264
312
 
265
- Use `tigrbl_engine_postgres` when you want the engine postgres backend installed as an isolated dependency instead of pulling every engine into your environment.
313
+ ## Public API and Import Surface
266
314
 
267
- ## Public Surface
315
+ - Import roots: `tigrbl_engine_postgres`.
316
+ - Public symbols: `PostgresSession`, `postgres_capabilities`, `postgres_engine`, `register`.
317
+ - Workspace dependencies: [`tigrbl`](https://pypi.org/project/tigrbl/).
318
+ - External runtime dependencies: `SQLAlchemy>=2.0,<3.0`, `psycopg[binary]>=3.1,<4.0`.
268
319
 
269
- - `tigrbl_engine_postgres` exposes `postgres_capabilities, postgres_engine, register, PostgresSession`.
320
+ ## Usage Examples
270
321
 
271
- ## Internal Layout
322
+ ### Verify the installed package
272
323
 
273
- - Workspace path: `pkgs/engines/tigrbl_engine_postgres`.
274
- - Package class: `engine plugin`.
275
- - Python requirement: `>=3.10,<3.15`.
276
- - `tigrbl_engine_postgres` modules: `engine, plugin, session`.
324
+ ```bash
325
+ python -m pip show tigrbl_engine_postgres
326
+ python - <<'PY'
327
+ from importlib.metadata import version
328
+ print(version("tigrbl_engine_postgres"))
329
+ PY
330
+ ```
331
+
332
+ ### Register the engine plugin explicitly
333
+
334
+ ```python
335
+ from tigrbl_engine_postgres import register
336
+
337
+ register()
338
+ ```
339
+
340
+ ### Discover the engine through package metadata
341
+
342
+ ```python
343
+ from importlib.metadata import entry_points
277
344
 
278
- ## Dependency Surface
345
+ for entry_point in entry_points(group="tigrbl.engine"):
346
+ if entry_point.module.startswith("tigrbl_engine_postgres"):
347
+ plugin_register = entry_point.load()
348
+ plugin_register()
349
+ ```
350
+
351
+ ### Install alongside the facade
352
+
353
+ ```bash
354
+ uv add tigrbl tigrbl_engine_postgres
355
+ pip install tigrbl tigrbl_engine_postgres
356
+ ```
357
+
358
+ ## How To Choose This Package
279
359
 
280
- - Workspace package dependencies: none declared.
281
- - External runtime dependencies: `SQLAlchemy>=2.0,<3.0`, `psycopg[binary]>=3.1,<4.0`, `tigrbl>=0.3.0.dev4`.
282
- - Optional extras: none declared.
360
+ Choose `tigrbl_engine_postgres` when the quick-answer table matches your use case. Choose [`tigrbl`](https://pypi.org/project/tigrbl/) instead when you want the full public facade. Choose a lower-level package such as [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), or [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) when you are building framework extensions or testing a specific internal boundary.
283
361
 
284
362
  ## Related Packages
285
363
 
286
364
  - [`tigrbl`](https://pypi.org/project/tigrbl/)
365
+ - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
366
+ - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
367
+ - [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/)
368
+ - [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/)
369
+ - [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/)
370
+
371
+ ## Documentation Links
372
+
373
+ - [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
374
+ - [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
375
+ - [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
376
+ - [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
377
+ - [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
378
+ - [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
379
+ - [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
287
380
 
288
- ## Canonical Repository Docs
381
+ ## Support
289
382
 
290
- - `docs/README.md`
291
- - `docs/conformance/CURRENT_TARGET.md`
292
- - `docs/conformance/CURRENT_STATE.md`
293
- - `docs/conformance/NEXT_STEPS.md`
294
- - `docs/governance/DOC_POINTERS.md`
295
- - `docs/developer/PACKAGE_CATALOG.md`
296
- - `docs/developer/PACKAGE_LAYOUT.md`
383
+ - Community: [Discord](https://discord.gg/K4YTAPapjR).
384
+ - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
385
+ - Repository: [pkgs/engines/tigrbl_engine_postgres](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_postgres).
297
386
 
298
387
  ## Package-local Boundary
299
388
 
300
- This file is a package-local distribution entry point.
301
- Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
389
+ This README is the package-local distribution entry point for `tigrbl_engine_postgres`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
302
390
 
303
391
  ## License
304
392
 
305
- Licensed under the Apache License, Version 2.0. See `LICENSE` and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
393
+ Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
@@ -0,0 +1,156 @@
1
+ <div align="center">
2
+ <h1>tigrbl_engine_postgres</h1>
3
+ <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
4
+ <p><strong>PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.</strong></p>
5
+ <a href="https://pypi.org/project/tigrbl_engine_postgres/"><img src="https://img.shields.io/pypi/v/tigrbl_engine_postgres?label=PyPI" alt="PyPI version for tigrbl_engine_postgres"/></a>
6
+ <a href="https://pypi.org/project/tigrbl_engine_postgres/"><img src="https://static.pepy.tech/badge/tigrbl_engine_postgres" alt="Downloads for tigrbl_engine_postgres"/></a>
7
+ <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl_engine_postgres"/></a>
8
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_postgres/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_postgres/README.md.svg?label=hits" alt="Repository hits for tigrbl_engine_postgres README"/></a>
9
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
10
+ <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl_engine_postgres"/></a>
11
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-engines-1f6feb" alt="Workspace group for tigrbl_engine_postgres"/></a>
12
+ </div>
13
+
14
+ ## What is tigrbl_engine_postgres?
15
+
16
+ PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.
17
+
18
+ ## Why use tigrbl_engine_postgres?
19
+
20
+ Use it when a Tigrbl application needs this backend without installing every engine package.
21
+
22
+ ## When should I install tigrbl_engine_postgres?
23
+
24
+ Install it when the storage, analytics, cache, or integration workload named by this package is the intended runtime backend.
25
+
26
+ ## Who is tigrbl_engine_postgres for?
27
+
28
+ Application developers, data platform engineers, and operators choosing concrete persistence or data-plane behavior.
29
+
30
+ ## Where does tigrbl_engine_postgres fit?
31
+
32
+ `tigrbl_engine_postgres` lives at `pkgs/engines/tigrbl_engine_postgres` and serves PostgreSQL-backed production persistence and SQLAlchemy workflows.
33
+
34
+ ## How does tigrbl_engine_postgres work?
35
+
36
+ It exposes a `tigrbl.engine` entry point and a package `register()` hook so Tigrbl can discover or load the backend at runtime.
37
+
38
+ ## Certification Status
39
+
40
+ - Package status: governed package in the `tigrbl/tigrbl` workspace.
41
+ - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
42
+ - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
43
+ - Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
44
+ - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
45
+
46
+ ## Install
47
+
48
+ ```bash
49
+ uv add tigrbl_engine_postgres
50
+ ```
51
+
52
+ ```bash
53
+ pip install tigrbl_engine_postgres
54
+ ```
55
+
56
+ ## Surface Coverage
57
+
58
+ | Surface | Value |
59
+ |---|---|
60
+ | PyPI package | [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/) |
61
+ | Repository path | [`pkgs/engines/tigrbl_engine_postgres`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_postgres) |
62
+ | Python import root | `tigrbl_engine_postgres` |
63
+ | Console scripts | none declared |
64
+ | Entry points | `tigrbl.engine` |
65
+ | Optional extras | none declared |
66
+ | Legal files | `LICENSE`, `NOTICE` |
67
+ | Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
68
+
69
+ ## What It Owns
70
+
71
+ `tigrbl_engine_postgres` owns the `engine plugin` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
72
+
73
+ Implementation orientation:
74
+ - `tigrbl_engine_postgres`: engine, plugin, session
75
+
76
+ ## Public API and Import Surface
77
+
78
+ - Import roots: `tigrbl_engine_postgres`.
79
+ - Public symbols: `PostgresSession`, `postgres_capabilities`, `postgres_engine`, `register`.
80
+ - Workspace dependencies: [`tigrbl`](https://pypi.org/project/tigrbl/).
81
+ - External runtime dependencies: `SQLAlchemy>=2.0,<3.0`, `psycopg[binary]>=3.1,<4.0`.
82
+
83
+ ## Usage Examples
84
+
85
+ ### Verify the installed package
86
+
87
+ ```bash
88
+ python -m pip show tigrbl_engine_postgres
89
+ python - <<'PY'
90
+ from importlib.metadata import version
91
+ print(version("tigrbl_engine_postgres"))
92
+ PY
93
+ ```
94
+
95
+ ### Register the engine plugin explicitly
96
+
97
+ ```python
98
+ from tigrbl_engine_postgres import register
99
+
100
+ register()
101
+ ```
102
+
103
+ ### Discover the engine through package metadata
104
+
105
+ ```python
106
+ from importlib.metadata import entry_points
107
+
108
+ for entry_point in entry_points(group="tigrbl.engine"):
109
+ if entry_point.module.startswith("tigrbl_engine_postgres"):
110
+ plugin_register = entry_point.load()
111
+ plugin_register()
112
+ ```
113
+
114
+ ### Install alongside the facade
115
+
116
+ ```bash
117
+ uv add tigrbl tigrbl_engine_postgres
118
+ pip install tigrbl tigrbl_engine_postgres
119
+ ```
120
+
121
+ ## How To Choose This Package
122
+
123
+ Choose `tigrbl_engine_postgres` when the quick-answer table matches your use case. Choose [`tigrbl`](https://pypi.org/project/tigrbl/) instead when you want the full public facade. Choose a lower-level package such as [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), or [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) when you are building framework extensions or testing a specific internal boundary.
124
+
125
+ ## Related Packages
126
+
127
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
128
+ - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
129
+ - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
130
+ - [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/)
131
+ - [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/)
132
+ - [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/)
133
+
134
+ ## Documentation Links
135
+
136
+ - [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
137
+ - [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
138
+ - [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
139
+ - [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
140
+ - [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
141
+ - [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
142
+ - [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
143
+
144
+ ## Support
145
+
146
+ - Community: [Discord](https://discord.gg/K4YTAPapjR).
147
+ - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
148
+ - Repository: [pkgs/engines/tigrbl_engine_postgres](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_postgres).
149
+
150
+ ## Package-local Boundary
151
+
152
+ This README is the package-local distribution entry point for `tigrbl_engine_postgres`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
153
+
154
+ ## License
155
+
156
+ Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "tigrbl_engine_postgres"
7
- version = "0.4.2.dev3"
7
+ version = "0.4.2.dev4"
8
8
  description = "PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence."
9
9
  readme = "README.md"
10
10
  license = { file = "LICENSE" }
@@ -1,69 +0,0 @@
1
- <div align="center">
2
- <h1>tigrbl_engine_postgres</h1>
3
- <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
4
- <p><strong>PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.</strong></p>
5
- <a href="https://pypi.org/project/tigrbl_engine_postgres/"><img src="https://img.shields.io/pypi/v/tigrbl_engine_postgres?label=PyPI" alt="PyPI version for tigrbl_engine_postgres"/></a>
6
- <a href="https://pypi.org/project/tigrbl_engine_postgres/"><img src="https://static.pepy.tech/badge/tigrbl_engine_postgres" alt="Downloads for tigrbl_engine_postgres"/></a>
7
- <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_postgres/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_postgres/README.md.svg?label=hits" alt="Repository hits for tigrbl_engine_postgres README"/></a>
8
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
9
- <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl_engine_postgres"/></a>
10
- <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-engines-1f6feb" alt="Workspace group for tigrbl_engine_postgres"/></a>
11
- </div>
12
-
13
- ## Install
14
-
15
- ```bash
16
- uv add tigrbl_engine_postgres
17
- ```
18
-
19
- ```bash
20
- pip install tigrbl_engine_postgres
21
- ```
22
-
23
- ## What It Owns
24
-
25
- `tigrbl_engine_postgres` owns the engine postgres backend boundary for Tigrbl, including engine registration, session adapters, and backend-specific helpers. Key implementation roots include `tigrbl_engine_postgres` with `engine, plugin, session`.
26
-
27
- ## Use It When
28
-
29
- Use `tigrbl_engine_postgres` when you want the engine postgres backend installed as an isolated dependency instead of pulling every engine into your environment.
30
-
31
- ## Public Surface
32
-
33
- - `tigrbl_engine_postgres` exposes `postgres_capabilities, postgres_engine, register, PostgresSession`.
34
-
35
- ## Internal Layout
36
-
37
- - Workspace path: `pkgs/engines/tigrbl_engine_postgres`.
38
- - Package class: `engine plugin`.
39
- - Python requirement: `>=3.10,<3.15`.
40
- - `tigrbl_engine_postgres` modules: `engine, plugin, session`.
41
-
42
- ## Dependency Surface
43
-
44
- - Workspace package dependencies: none declared.
45
- - External runtime dependencies: `SQLAlchemy>=2.0,<3.0`, `psycopg[binary]>=3.1,<4.0`, `tigrbl>=0.3.0.dev4`.
46
- - Optional extras: none declared.
47
-
48
- ## Related Packages
49
-
50
- - [`tigrbl`](https://pypi.org/project/tigrbl/)
51
-
52
- ## Canonical Repository Docs
53
-
54
- - `docs/README.md`
55
- - `docs/conformance/CURRENT_TARGET.md`
56
- - `docs/conformance/CURRENT_STATE.md`
57
- - `docs/conformance/NEXT_STEPS.md`
58
- - `docs/governance/DOC_POINTERS.md`
59
- - `docs/developer/PACKAGE_CATALOG.md`
60
- - `docs/developer/PACKAGE_LAYOUT.md`
61
-
62
- ## Package-local Boundary
63
-
64
- This file is a package-local distribution entry point.
65
- Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
66
-
67
- ## License
68
-
69
- Licensed under the Apache License, Version 2.0. See `LICENSE` and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).