tigrbl_engine_inmemory 0.4.2.dev3__py3-none-any.whl → 0.4.2.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,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.2.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,105 @@ 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, rust, session
262
310
 
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.
311
+ ## Public API and Import Surface
264
312
 
265
- ## Public Surface
313
+ - Import roots: `tigrbl_engine_inmemory`.
314
+ - Public symbols: `__version__`, `register`, `register_rust_engine`.
315
+ - Workspace dependencies: [`tigrbl`](https://pypi.org/project/tigrbl/).
316
+ - External runtime dependencies: none declared.
266
317
 
267
- - `tigrbl_engine_inmemory` exposes `register_rust_engine, register, __version__`.
318
+ ## Usage Examples
268
319
 
269
- ## Internal Layout
320
+ ### Verify the installed package
270
321
 
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`.
322
+ ```bash
323
+ python -m pip show tigrbl_engine_inmemory
324
+ python - <<'PY'
325
+ from importlib.metadata import version
326
+ print(version("tigrbl_engine_inmemory"))
327
+ PY
328
+ ```
329
+
330
+ ### Register the engine plugin explicitly
331
+
332
+ ```python
333
+ from tigrbl_engine_inmemory import register
334
+
335
+ register()
336
+ ```
337
+
338
+ ### Discover the engine through package metadata
339
+
340
+ ```python
341
+ from importlib.metadata import entry_points
275
342
 
276
- ## Dependency Surface
343
+ for entry_point in entry_points(group="tigrbl.engine"):
344
+ if entry_point.module.startswith("tigrbl_engine_inmemory"):
345
+ plugin_register = entry_point.load()
346
+ plugin_register()
347
+ ```
348
+
349
+ ### Install alongside the facade
350
+
351
+ ```bash
352
+ uv add tigrbl tigrbl_engine_inmemory
353
+ pip install tigrbl tigrbl_engine_inmemory
354
+ ```
355
+
356
+ ## How To Choose This Package
277
357
 
278
- - Workspace package dependencies: none declared.
279
- - External runtime dependencies: `tigrbl>=0.3.0.dev4`.
280
- - Optional extras: none declared.
358
+ 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
359
 
282
360
  ## Related Packages
283
361
 
284
362
  - [`tigrbl`](https://pypi.org/project/tigrbl/)
363
+ - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
364
+ - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
365
+ - [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/)
366
+ - [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/)
367
+ - [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/)
368
+ - [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/)
369
+
370
+ ## Documentation Links
371
+
372
+ - [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
373
+ - [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
374
+ - [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
375
+ - [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
376
+ - [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
377
+ - [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
378
+ - [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
285
379
 
286
- ## Canonical Repository Docs
380
+ ## Support
287
381
 
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`
382
+ - Community: [Discord](https://discord.gg/K4YTAPapjR).
383
+ - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
384
+ - Repository: [pkgs/engines/tigrbl_engine_inmemory](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_inmemory).
295
385
 
296
386
  ## Package-local Boundary
297
387
 
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/`.
388
+ 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
389
 
301
390
  ## License
302
391
 
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).
392
+ 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).
@@ -3,8 +3,9 @@ tigrbl_engine_inmemory/engine.py,sha256=Qew4gLzzZRxQN5YfNjNceIFZ0vQW9hN9RwPe2kpT
3
3
  tigrbl_engine_inmemory/plugin.py,sha256=FhsJICN4uiqE2tkg2VWX0qkdAVDPxBKgEbwwMfGHP_A,1121
4
4
  tigrbl_engine_inmemory/rust.py,sha256=0g5VcMKD05n3dWbpzaOF2QX1zA6Bh2rYVVhrc9m1G2Q,444
5
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,,
6
+ tigrbl_engine_inmemory-0.4.2.dev4.dist-info/METADATA,sha256=OulDhvQYj608eptDUJLGwdSKT3VlSD6PeHkAr72gTa8,22589
7
+ tigrbl_engine_inmemory-0.4.2.dev4.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
8
+ tigrbl_engine_inmemory-0.4.2.dev4.dist-info/entry_points.txt,sha256=GwirPkpUQjnAdofQ9cbSTMlimr4QQXCKHIlPI1OfIvs,66
9
+ tigrbl_engine_inmemory-0.4.2.dev4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
10
+ tigrbl_engine_inmemory-0.4.2.dev4.dist-info/licenses/NOTICE,sha256=EvJMTshzsWz43LiK-DeN2ZuLtrP49cxvlrFlJ8F_buc,221
11
+ tigrbl_engine_inmemory-0.4.2.dev4.dist-info/RECORD,,
@@ -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.