tigrbl_engine_inmemory 0.4.2.dev3__py3-none-any.whl → 0.4.3.dev4__py3-none-any.whl

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.
@@ -1,14 +1,14 @@
1
1
  from __future__ import annotations
2
2
 
3
3
  from typing import Any
4
-
5
- try:
6
- from tigrbl_runtime.rust import register_python_engine
7
- except Exception: # pragma: no cover - additive optional integration
8
- register_python_engine = None
4
+ import warnings
9
5
 
10
6
 
11
7
  def register_rust_engine(kind: str = "inmemory", callback: Any | None = None) -> str:
12
- if register_python_engine is None:
13
- return f"python-engine:{kind}"
14
- return register_python_engine(kind, callback)
8
+ del callback
9
+ warnings.warn(
10
+ "tigrbl_engine_inmemory Rust registration is deprecated; engines are Python-only.",
11
+ DeprecationWarning,
12
+ stacklevel=2,
13
+ )
14
+ raise RuntimeError(f"register_rust_engine({kind!r}) is unavailable.")
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: tigrbl_engine_inmemory
3
- Version: 0.4.2.dev3
3
+ Version: 0.4.3.dev4
4
4
  Summary: In-memory database engine plugin for process-local transactional storage, copy-on-write snapshots, and Tigrbl testing.
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,crud,database,engine,inmemory,json-rpc,openapi,openrpc,plugin,pydantic,rest,schema-first,snapshot,sqlalchemy,tigrbl,transactions
214
215
  Classifier: Development Status :: 3 - Alpha
215
216
  Classifier: Framework :: AsyncIO
@@ -238,12 +239,45 @@ Description-Content-Type: text/markdown
238
239
  <p><strong>In-memory database engine plugin for process-local transactional storage, copy-on-write snapshots, and Tigrbl testing.</strong></p>
239
240
  <a href="https://pypi.org/project/tigrbl_engine_inmemory/"><img src="https://img.shields.io/pypi/v/tigrbl_engine_inmemory?label=PyPI" alt="PyPI version for tigrbl_engine_inmemory"/></a>
240
241
  <a href="https://pypi.org/project/tigrbl_engine_inmemory/"><img src="https://static.pepy.tech/badge/tigrbl_engine_inmemory" alt="Downloads for tigrbl_engine_inmemory"/></a>
242
+ <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_inmemory"/></a>
241
243
  <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_inmemory/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_inmemory/README.md.svg?label=hits" alt="Repository hits for tigrbl_engine_inmemory README"/></a>
242
244
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
243
- <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl_engine_inmemory"/></a>
245
+ <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_inmemory"/></a>
244
246
  <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_inmemory"/></a>
245
247
  </div>
246
248
 
249
+ ## What is tigrbl_engine_inmemory?
250
+
251
+ In-memory database engine plugin for process-local transactional storage, copy-on-write snapshots, and Tigrbl testing.
252
+
253
+ ## Why use tigrbl_engine_inmemory?
254
+
255
+ Use it when a Tigrbl application needs this backend without installing every engine package.
256
+
257
+ ## When should I install tigrbl_engine_inmemory?
258
+
259
+ Install it when the storage, analytics, cache, or integration workload named by this package is the intended runtime backend.
260
+
261
+ ## Who is tigrbl_engine_inmemory for?
262
+
263
+ Application developers, data platform engineers, and operators choosing concrete persistence or data-plane behavior.
264
+
265
+ ## Where does tigrbl_engine_inmemory fit?
266
+
267
+ `tigrbl_engine_inmemory` lives at `pkgs/engines/tigrbl_engine_inmemory` and serves process-local in-memory runtime behavior.
268
+
269
+ ## How does tigrbl_engine_inmemory work?
270
+
271
+ It exposes a `tigrbl.engine` entry point and a package `register()` hook so Tigrbl can discover or load the backend at runtime.
272
+
273
+ ## Certification Status
274
+
275
+ - Package status: governed package in the `tigrbl/tigrbl` workspace.
276
+ - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
277
+ - 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.
278
+ - 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`.
279
+ - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
280
+
247
281
  ## Install
248
282
 
249
283
  ```bash
@@ -254,50 +288,107 @@ uv add tigrbl_engine_inmemory
254
288
  pip install tigrbl_engine_inmemory
255
289
  ```
256
290
 
291
+ ## Surface Coverage
292
+
293
+ | Surface | Value |
294
+ |---|---|
295
+ | PyPI package | [`tigrbl_engine_inmemory`](https://pypi.org/project/tigrbl_engine_inmemory/) |
296
+ | Repository path | [`pkgs/engines/tigrbl_engine_inmemory`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_inmemory) |
297
+ | Python import root | `tigrbl_engine_inmemory` |
298
+ | Console scripts | none declared |
299
+ | Entry points | `tigrbl.engine` |
300
+ | Optional extras | none declared |
301
+ | Legal files | `LICENSE`, `NOTICE` |
302
+ | Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
303
+
257
304
  ## What It Owns
258
305
 
259
- `tigrbl_engine_inmemory` owns the engine inmemory backend boundary for Tigrbl, including engine registration, session adapters, and backend-specific helpers. Key implementation roots include `tigrbl_engine_inmemory` with `engine, plugin, rust, session`.
306
+ `tigrbl_engine_inmemory` 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.
260
307
 
261
- ## Use It When
308
+ Implementation orientation:
309
+ - `tigrbl_engine_inmemory`: engine, plugin, session
310
+ - `tigrbl_engine_inmemory.rust` is a deprecated compatibility shim; engine registration is Python-only.
262
311
 
263
- Use `tigrbl_engine_inmemory` when you want the engine inmemory backend installed as an isolated dependency instead of pulling every engine into your environment.
312
+ ## Public API and Import Surface
264
313
 
265
- ## Public Surface
314
+ - Import roots: `tigrbl_engine_inmemory`.
315
+ - Public symbols: `__version__`, `register`.
316
+ - `register_rust_engine` is deprecated and raises when called.
317
+ - Workspace dependencies: [`tigrbl`](https://pypi.org/project/tigrbl/).
318
+ - External runtime dependencies: none declared.
266
319
 
267
- - `tigrbl_engine_inmemory` exposes `register_rust_engine, register, __version__`.
320
+ ## Usage Examples
268
321
 
269
- ## Internal Layout
322
+ ### Verify the installed package
270
323
 
271
- - Workspace path: `pkgs/engines/tigrbl_engine_inmemory`.
272
- - Package class: `engine plugin`.
273
- - Python requirement: `>=3.10,<3.15`.
274
- - `tigrbl_engine_inmemory` modules: `engine, plugin, rust, session`.
324
+ ```bash
325
+ python -m pip show tigrbl_engine_inmemory
326
+ python - <<'PY'
327
+ from importlib.metadata import version
328
+ print(version("tigrbl_engine_inmemory"))
329
+ PY
330
+ ```
331
+
332
+ ### Register the engine plugin explicitly
333
+
334
+ ```python
335
+ from tigrbl_engine_inmemory import register
336
+
337
+ register()
338
+ ```
339
+
340
+ ### Discover the engine through package metadata
341
+
342
+ ```python
343
+ from importlib.metadata import entry_points
275
344
 
276
- ## Dependency Surface
345
+ for entry_point in entry_points(group="tigrbl.engine"):
346
+ if entry_point.module.startswith("tigrbl_engine_inmemory"):
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_inmemory
355
+ pip install tigrbl tigrbl_engine_inmemory
356
+ ```
357
+
358
+ ## How To Choose This Package
277
359
 
278
- - Workspace package dependencies: none declared.
279
- - External runtime dependencies: `tigrbl>=0.3.0.dev4`.
280
- - Optional extras: none declared.
360
+ Choose `tigrbl_engine_inmemory` 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.
281
361
 
282
362
  ## Related Packages
283
363
 
284
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_postgres`](https://pypi.org/project/tigrbl_engine_postgres/)
369
+ - [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/)
370
+ - [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/)
371
+
372
+ ## Documentation Links
373
+
374
+ - [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
375
+ - [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
376
+ - [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
377
+ - [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
378
+ - [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
379
+ - [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
380
+ - [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
285
381
 
286
- ## Canonical Repository Docs
382
+ ## Support
287
383
 
288
- - `docs/README.md`
289
- - `docs/conformance/CURRENT_TARGET.md`
290
- - `docs/conformance/CURRENT_STATE.md`
291
- - `docs/conformance/NEXT_STEPS.md`
292
- - `docs/governance/DOC_POINTERS.md`
293
- - `docs/developer/PACKAGE_CATALOG.md`
294
- - `docs/developer/PACKAGE_LAYOUT.md`
384
+ - Community: [Discord](https://discord.gg/K4YTAPapjR).
385
+ - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
386
+ - Repository: [pkgs/engines/tigrbl_engine_inmemory](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_inmemory).
295
387
 
296
388
  ## Package-local Boundary
297
389
 
298
- This file is a package-local distribution entry point.
299
- Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
390
+ This README is the package-local distribution entry point for `tigrbl_engine_inmemory`. 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.
300
391
 
301
392
  ## License
302
393
 
303
- 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).
394
+ 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,11 @@
1
+ tigrbl_engine_inmemory/__init__.py,sha256=uVfXdFtTNqQqO6cepRMRH4Ho63UCyHJYDndimt8W1QY,197
2
+ tigrbl_engine_inmemory/engine.py,sha256=Qew4gLzzZRxQN5YfNjNceIFZ0vQW9hN9RwPe2kpT0T0,886
3
+ tigrbl_engine_inmemory/plugin.py,sha256=FhsJICN4uiqE2tkg2VWX0qkdAVDPxBKgEbwwMfGHP_A,1121
4
+ tigrbl_engine_inmemory/rust.py,sha256=WojWAg0hZtPEBDL9-AvqAN_zKgOmilJRgEW-8OV0gfo,421
5
+ tigrbl_engine_inmemory/session.py,sha256=mC2oKoGzX5gMhX90OIPQc9iEe4PYqyQSWFSQ6nvWHYM,4503
6
+ tigrbl_engine_inmemory-0.4.3.dev4.dist-info/METADATA,sha256=7FjMXTe7Gd5YMNPmsa5O-2gLW9p3PLMWSZZtHTuSaJ4,22726
7
+ tigrbl_engine_inmemory-0.4.3.dev4.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
8
+ tigrbl_engine_inmemory-0.4.3.dev4.dist-info/entry_points.txt,sha256=GwirPkpUQjnAdofQ9cbSTMlimr4QQXCKHIlPI1OfIvs,66
9
+ tigrbl_engine_inmemory-0.4.3.dev4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
10
+ tigrbl_engine_inmemory-0.4.3.dev4.dist-info/licenses/NOTICE,sha256=EvJMTshzsWz43LiK-DeN2ZuLtrP49cxvlrFlJ8F_buc,221
11
+ tigrbl_engine_inmemory-0.4.3.dev4.dist-info/RECORD,,
@@ -1,4 +1,4 @@
1
1
  Wheel-Version: 1.0
2
- Generator: hatchling 1.29.0
2
+ Generator: hatchling 1.30.1
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
@@ -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,10 +0,0 @@
1
- tigrbl_engine_inmemory/__init__.py,sha256=uVfXdFtTNqQqO6cepRMRH4Ho63UCyHJYDndimt8W1QY,197
2
- tigrbl_engine_inmemory/engine.py,sha256=Qew4gLzzZRxQN5YfNjNceIFZ0vQW9hN9RwPe2kpT0T0,886
3
- tigrbl_engine_inmemory/plugin.py,sha256=FhsJICN4uiqE2tkg2VWX0qkdAVDPxBKgEbwwMfGHP_A,1121
4
- tigrbl_engine_inmemory/rust.py,sha256=0g5VcMKD05n3dWbpzaOF2QX1zA6Bh2rYVVhrc9m1G2Q,444
5
- tigrbl_engine_inmemory/session.py,sha256=mC2oKoGzX5gMhX90OIPQc9iEe4PYqyQSWFSQ6nvWHYM,4503
6
- tigrbl_engine_inmemory-0.4.2.dev3.dist-info/METADATA,sha256=VDZITj-C224Eh6_Ht672bgZsEsJGBpxDZdE4FgRMZnQ,17929
7
- tigrbl_engine_inmemory-0.4.2.dev3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
8
- tigrbl_engine_inmemory-0.4.2.dev3.dist-info/entry_points.txt,sha256=GwirPkpUQjnAdofQ9cbSTMlimr4QQXCKHIlPI1OfIvs,66
9
- tigrbl_engine_inmemory-0.4.2.dev3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
10
- tigrbl_engine_inmemory-0.4.2.dev3.dist-info/RECORD,,