tigrbl_engine_numpy 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_numpy
3
- Version: 0.4.2.dev3
3
+ Version: 0.4.2.dev4
4
4
  Summary: NumPy engine plugin for array-to-table helpers, analytical workflows, and Tigrbl data integration.
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: analytics,api,arrays,asgi,database,engine,json-rpc,numpy,openapi,openrpc,plugin,pydantic,rest,schema-first,sqlalchemy,tigrbl
214
215
  Classifier: Development Status :: 3 - Alpha
215
216
  Classifier: Framework :: AsyncIO
@@ -239,12 +240,45 @@ Description-Content-Type: text/markdown
239
240
  <p><strong>NumPy engine plugin for array-to-table helpers, analytical workflows, and Tigrbl data integration.</strong></p>
240
241
  <a href="https://pypi.org/project/tigrbl_engine_numpy/"><img src="https://img.shields.io/pypi/v/tigrbl_engine_numpy?label=PyPI" alt="PyPI version for tigrbl_engine_numpy"/></a>
241
242
  <a href="https://pypi.org/project/tigrbl_engine_numpy/"><img src="https://static.pepy.tech/badge/tigrbl_engine_numpy" alt="Downloads for tigrbl_engine_numpy"/></a>
243
+ <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_numpy"/></a>
242
244
  <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_numpy/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_numpy/README.md.svg?label=hits" alt="Repository hits for tigrbl_engine_numpy README"/></a>
243
245
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
244
- <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl_engine_numpy"/></a>
246
+ <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_numpy"/></a>
245
247
  <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_numpy"/></a>
246
248
  </div>
247
249
 
250
+ ## What is tigrbl_engine_numpy?
251
+
252
+ NumPy engine plugin for array-to-table helpers, analytical workflows, and Tigrbl data integration.
253
+
254
+ ## Why use tigrbl_engine_numpy?
255
+
256
+ Use it when a Tigrbl application needs this backend without installing every engine package.
257
+
258
+ ## When should I install tigrbl_engine_numpy?
259
+
260
+ Install it when the storage, analytics, cache, or integration workload named by this package is the intended runtime backend.
261
+
262
+ ## Who is tigrbl_engine_numpy for?
263
+
264
+ Application developers, data platform engineers, and operators choosing concrete persistence or data-plane behavior.
265
+
266
+ ## Where does tigrbl_engine_numpy fit?
267
+
268
+ `tigrbl_engine_numpy` lives at `pkgs/engines/tigrbl_engine_numpy` and serves a focused Tigrbl backend integration.
269
+
270
+ ## How does tigrbl_engine_numpy work?
271
+
272
+ It exposes a `tigrbl.engine` entry point and a package `register()` hook so Tigrbl can discover or load the backend at runtime.
273
+
274
+ ## Certification Status
275
+
276
+ - Package status: governed package in the `tigrbl/tigrbl` workspace.
277
+ - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
278
+ - 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.
279
+ - 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`.
280
+ - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
281
+
248
282
  ## Install
249
283
 
250
284
  ```bash
@@ -255,50 +289,105 @@ uv add tigrbl_engine_numpy
255
289
  pip install tigrbl_engine_numpy
256
290
  ```
257
291
 
292
+ ## Surface Coverage
293
+
294
+ | Surface | Value |
295
+ |---|---|
296
+ | PyPI package | [`tigrbl_engine_numpy`](https://pypi.org/project/tigrbl_engine_numpy/) |
297
+ | Repository path | [`pkgs/engines/tigrbl_engine_numpy`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_numpy) |
298
+ | Python import root | `tigrbl_engine_numpy` |
299
+ | Console scripts | none declared |
300
+ | Entry points | `tigrbl.engine` |
301
+ | Optional extras | none declared |
302
+ | Legal files | `LICENSE`, `NOTICE` |
303
+ | Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
304
+
258
305
  ## What It Owns
259
306
 
260
- `tigrbl_engine_numpy` owns the engine numpy backend boundary for Tigrbl, including engine registration, session adapters, and backend-specific helpers. Key implementation roots include `tigrbl_engine_numpy` with `engine, session`.
307
+ `tigrbl_engine_numpy` 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.
261
308
 
262
- ## Use It When
309
+ Implementation orientation:
310
+ - `tigrbl_engine_numpy`: engine, session
263
311
 
264
- Use `tigrbl_engine_numpy` when you want the engine numpy backend installed as an isolated dependency instead of pulling every engine into your environment.
312
+ ## Public API and Import Surface
265
313
 
266
- ## Public Surface
314
+ - Import roots: `tigrbl_engine_numpy`.
315
+ - Public symbols: `NumpyEngine`, `NumpySession`, `numpy_capabilities`, `numpy_engine`, `register`.
316
+ - Workspace dependencies: [`tigrbl`](https://pypi.org/project/tigrbl/).
317
+ - External runtime dependencies: `numpy>=1.26`.
267
318
 
268
- - `tigrbl_engine_numpy` exposes `NumpyEngine, numpy_capabilities, numpy_engine, NumpySession, register`.
319
+ ## Usage Examples
269
320
 
270
- ## Internal Layout
321
+ ### Verify the installed package
271
322
 
272
- - Workspace path: `pkgs/engines/tigrbl_engine_numpy`.
273
- - Package class: `engine plugin`.
274
- - Python requirement: `>=3.10,<3.15`.
275
- - `tigrbl_engine_numpy` modules: `engine, session`.
323
+ ```bash
324
+ python -m pip show tigrbl_engine_numpy
325
+ python - <<'PY'
326
+ from importlib.metadata import version
327
+ print(version("tigrbl_engine_numpy"))
328
+ PY
329
+ ```
330
+
331
+ ### Register the engine plugin explicitly
332
+
333
+ ```python
334
+ from tigrbl_engine_numpy import register
335
+
336
+ register()
337
+ ```
338
+
339
+ ### Discover the engine through package metadata
340
+
341
+ ```python
342
+ from importlib.metadata import entry_points
276
343
 
277
- ## Dependency Surface
344
+ for entry_point in entry_points(group="tigrbl.engine"):
345
+ if entry_point.module.startswith("tigrbl_engine_numpy"):
346
+ plugin_register = entry_point.load()
347
+ plugin_register()
348
+ ```
349
+
350
+ ### Install alongside the facade
351
+
352
+ ```bash
353
+ uv add tigrbl tigrbl_engine_numpy
354
+ pip install tigrbl tigrbl_engine_numpy
355
+ ```
356
+
357
+ ## How To Choose This Package
278
358
 
279
- - Workspace package dependencies: none declared.
280
- - External runtime dependencies: `numpy>=1.26`, `tigrbl>=0.3.0.dev4`.
281
- - Optional extras: none declared.
359
+ Choose `tigrbl_engine_numpy` 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.
282
360
 
283
361
  ## Related Packages
284
362
 
285
363
  - [`tigrbl`](https://pypi.org/project/tigrbl/)
364
+ - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
365
+ - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
366
+ - [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/)
367
+ - [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/)
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)
286
380
 
287
- ## Canonical Repository Docs
381
+ ## Support
288
382
 
289
- - `docs/README.md`
290
- - `docs/conformance/CURRENT_TARGET.md`
291
- - `docs/conformance/CURRENT_STATE.md`
292
- - `docs/conformance/NEXT_STEPS.md`
293
- - `docs/governance/DOC_POINTERS.md`
294
- - `docs/developer/PACKAGE_CATALOG.md`
295
- - `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_numpy](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_numpy).
296
386
 
297
387
  ## Package-local Boundary
298
388
 
299
- This file is a package-local distribution entry point.
300
- 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_numpy`. 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.
301
390
 
302
391
  ## License
303
392
 
304
- 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,9 @@
1
+ tigrbl_engine_numpy/__init__.py,sha256=AwC9E7-M6JejPcB-kOh247YvfpgfPkmRuogWJToIwSc,635
2
+ tigrbl_engine_numpy/engine.py,sha256=UA1CzqX6DLo8Mto7rtUffUuIwPoxYs0e1nE9EQpl_SI,5038
3
+ tigrbl_engine_numpy/session.py,sha256=-WcfVc87AtfIegCa9kw-0sWu9fAx5rUvJolO6VBpdyA,20080
4
+ tigrbl_engine_numpy-0.4.2.dev4.dist-info/METADATA,sha256=5fB9zXmSwubtQxYbu_9aXcokLMDbnSbZ69mvaK1BTCs,22426
5
+ tigrbl_engine_numpy-0.4.2.dev4.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
6
+ tigrbl_engine_numpy-0.4.2.dev4.dist-info/entry_points.txt,sha256=F2yEiEf3u5fb5rzg1epqAM_GBi80I5V5umgd8KiO6CA,53
7
+ tigrbl_engine_numpy-0.4.2.dev4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
8
+ tigrbl_engine_numpy-0.4.2.dev4.dist-info/licenses/NOTICE,sha256=EvJMTshzsWz43LiK-DeN2ZuLtrP49cxvlrFlJ8F_buc,221
9
+ tigrbl_engine_numpy-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.
@@ -1,8 +0,0 @@
1
- tigrbl_engine_numpy/__init__.py,sha256=AwC9E7-M6JejPcB-kOh247YvfpgfPkmRuogWJToIwSc,635
2
- tigrbl_engine_numpy/engine.py,sha256=UA1CzqX6DLo8Mto7rtUffUuIwPoxYs0e1nE9EQpl_SI,5038
3
- tigrbl_engine_numpy/session.py,sha256=-WcfVc87AtfIegCa9kw-0sWu9fAx5rUvJolO6VBpdyA,20080
4
- tigrbl_engine_numpy-0.4.2.dev3.dist-info/METADATA,sha256=xMZZEhTt-NDC709pRpOUbCk2ByMXmJjPbiEoK7JMOCo,17844
5
- tigrbl_engine_numpy-0.4.2.dev3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
6
- tigrbl_engine_numpy-0.4.2.dev3.dist-info/entry_points.txt,sha256=F2yEiEf3u5fb5rzg1epqAM_GBi80I5V5umgd8KiO6CA,53
7
- tigrbl_engine_numpy-0.4.2.dev3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
8
- tigrbl_engine_numpy-0.4.2.dev3.dist-info/RECORD,,