tigrbl_engine_snowflake 0.4.1.dev3__tar.gz → 0.4.2.dev3__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.
Files changed (16) hide show
  1. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/PKG-INFO +43 -100
  2. tigrbl_engine_snowflake-0.4.2.dev3/README.md +69 -0
  3. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/pyproject.toml +1 -1
  4. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/src/tigrbl_engine_snowflake.egg-info/PKG-INFO +43 -100
  5. tigrbl_engine_snowflake-0.4.1.dev3/README.md +0 -126
  6. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/LICENSE +0 -0
  7. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/setup.cfg +0 -0
  8. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/src/tigrbl_engine_snowflake/__init__.py +0 -0
  9. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/src/tigrbl_engine_snowflake/engine.py +0 -0
  10. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/src/tigrbl_engine_snowflake/session.py +0 -0
  11. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/src/tigrbl_engine_snowflake.egg-info/SOURCES.txt +0 -0
  12. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/src/tigrbl_engine_snowflake.egg-info/dependency_links.txt +0 -0
  13. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/src/tigrbl_engine_snowflake.egg-info/entry_points.txt +0 -0
  14. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/src/tigrbl_engine_snowflake.egg-info/requires.txt +0 -0
  15. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/src/tigrbl_engine_snowflake.egg-info/top_level.txt +0 -0
  16. {tigrbl_engine_snowflake-0.4.1.dev3 → tigrbl_engine_snowflake-0.4.2.dev3}/tests/test_smoke.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: tigrbl_engine_snowflake
3
- Version: 0.4.1.dev3
3
+ Version: 0.4.2.dev3
4
4
  Summary: Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
5
5
  Author-email: Jacob Stewart <jacob@swarmauri.com>
6
6
  License: Apache License
@@ -236,113 +236,59 @@ Requires-Dist: snowflake-sqlalchemy<2.0,>=1.5
236
236
  Requires-Dist: snowflake-connector-python<4.0,>=3.0
237
237
  Dynamic: license-file
238
238
 
239
- ![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
239
+ <div align="center">
240
+ <h1>tigrbl_engine_snowflake</h1>
241
+ <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
242
+ <p><strong>Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.</strong></p>
243
+ <a href="https://pypi.org/project/tigrbl_engine_snowflake/"><img src="https://img.shields.io/pypi/v/tigrbl_engine_snowflake?label=PyPI" alt="PyPI version for tigrbl_engine_snowflake"/></a>
244
+ <a href="https://pypi.org/project/tigrbl_engine_snowflake/"><img src="https://static.pepy.tech/badge/tigrbl_engine_snowflake" alt="Downloads for tigrbl_engine_snowflake"/></a>
245
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_snowflake/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_snowflake/README.md.svg?label=hits" alt="Repository hits for tigrbl_engine_snowflake README"/></a>
246
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
247
+ <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl_engine_snowflake"/></a>
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_snowflake"/></a>
249
+ </div>
240
250
 
241
- <p align="center">
242
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
243
- <img src="https://img.shields.io/pypi/dm/tigrbl_engine_snowflake" alt="PyPI downloads for tigrbl_engine_snowflake"/></a>
244
- <a href="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake/">
245
- <img src="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake.svg" alt="Repository views for tigrbl_engine_snowflake"/></a>
246
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
247
- <img src="https://img.shields.io/pypi/pyversions/tigrbl_engine_snowflake" alt="Supported Python versions for tigrbl_engine_snowflake"/></a>
248
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
249
- <img src="https://img.shields.io/pypi/l/tigrbl_engine_snowflake" alt="PyPI license metadata for tigrbl_engine_snowflake"/></a>
250
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
251
- <img src="https://img.shields.io/pypi/v/tigrbl_engine_snowflake?label=tigrbl_engine_snowflake&color=green" alt="PyPI version for tigrbl_engine_snowflake"/></a>
252
- </p>
253
-
254
- ---
255
-
256
- <h1 align="center">Tigrbl engine-snowflake</h1>
257
-
258
- **Install and inspect `tigrbl_engine_snowflake`: [download `tigrbl_engine_snowflake` from PyPI](https://pypi.org/project/tigrbl_engine_snowflake/) or [open the package source](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake).**
259
-
260
- tigrbl_engine_snowflake is a Snowflake engine plugin for Snowflake warehouse sessions and analytics-oriented engine registration for Tigrbl.
261
-
262
- `tigrbl_engine_snowflake` is part of the Tigrbl package graph. It documents package-resident classes, concepts, extension points, and execution responsibilities while cross-linking to the facade, core specs, canonical mapping, runtime phases, concrete objects, operation packages, engine plugins, OpenAPI/OpenRPC documentation surfaces, and PyPI distributions that complete the system.
263
-
264
- ## Engine ownership and database guards
265
-
266
- - Snowflake warehouse sessions, analytical query behavior, credential/configuration boundaries, and warehouse execution guardrails.
267
- - Engine packages document backend-specific connection settings, session construction, transaction behavior, persistence boundaries, and operational guardrails. Transport routing and operation semantics remain in the facade/canon/runtime/ops packages.
268
- - Register this engine through the package entry point or the Tigrbl engine context so API code can select the backend without embedding backend-specific logic in model definitions.
251
+ ## Install
269
252
 
270
- ## Package ecosystem cross-links
253
+ ```bash
254
+ uv add tigrbl_engine_snowflake
255
+ ```
271
256
 
272
- Every Tigrbl Python package links to its sibling distributions on PyPI so package indexes, search engines, answer engines, dependency scanners, and human readers can move through the installable package graph without falling back to source-tree paths.
257
+ ```bash
258
+ pip install tigrbl_engine_snowflake
259
+ ```
273
260
 
274
- Core packages:
275
- - [`tigrbl`](https://pypi.org/project/tigrbl/) - Schema-first ASGI API framework for REST, JSON-RPC, OpenAPI, OpenRPC, SQLAlchemy models, typed validation, lifecycle hooks, and engine plugins.
276
- - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/) - Runtime atom utilities for Tigrbl planning, dispatch, transport ingress, egress, and high-throughput ASGI execution pipelines.
277
- - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/) - Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components.
278
- - [`tigrbl-canon`](https://pypi.org/project/tigrbl-canon/) - Canonical mapping, routing, symbol resolution, and naming utilities for Tigrbl framework packages and generated API surfaces.
279
- - [`tigrbl_client`](https://pypi.org/project/tigrbl_client/) - Typed Python client helpers for calling Tigrbl REST, JSON-RPC, OpenAPI, and generated schema-first API surfaces.
280
- - [`tigrbl-concrete`](https://pypi.org/project/tigrbl-concrete/) - Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.
281
- - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/) - Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs.
282
- - [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) - Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
283
- - [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/) - Analytical OLAP operation boundaries for Tigrbl workloads, query-oriented APIs, and engine integrations.
284
- - [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/) - Transactional OLTP operation handlers for Tigrbl CRUD, bulk, REST, JSON-RPC, and database-backed workloads.
285
- - [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/) - Realtime, streaming, datagram, websocket, and event operation handlers for Tigrbl ASGI runtimes.
286
- - [`tigrbl-orm`](https://pypi.org/project/tigrbl-orm/) - SQLAlchemy ORM tables, mixins, columns, model helpers, and persistence primitives for Tigrbl applications.
287
- - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) - Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
288
- - [`tigrbl_spec`](https://pypi.org/project/tigrbl_spec/) - Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.
289
- - [`tigrbl_tests`](https://pypi.org/project/tigrbl_tests/) - Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.
290
- - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/) - Typing protocols, aliases, generics, and shared type helpers for Tigrbl framework packages and extensions.
261
+ ## What It Owns
291
262
 
292
- Engine packages:
293
- - [`tigrbl_engine_bigquery`](https://pypi.org/project/tigrbl_engine_bigquery/) - BigQuery engine plugin for Google BigQuery warehouse sessions, analytics workloads, and Tigrbl engine registration.
294
- - [`tigrbl_engine_clickhouse`](https://pypi.org/project/tigrbl_engine_clickhouse/) - ClickHouse engine plugin for analytical database sessions, warehouse workloads, and Tigrbl engine registration.
295
- - [`tigrbl_engine_csv`](https://pypi.org/project/tigrbl_engine_csv/) - CSV engine plugin for file-backed tables, pandas DataFrames, and lightweight Tigrbl data workflows.
296
- - [`tigrbl_engine_dataframe`](https://pypi.org/project/tigrbl_engine_dataframe/) - DataFrame engine plugin for transactional pandas sessions and in-process Tigrbl analytics workloads.
297
- - [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/) - DuckDB engine plugin for embedded analytical database sessions, OLAP workloads, and Tigrbl engine registration.
298
- - [`tigrbl_engine_inmemcache`](https://pypi.org/project/tigrbl_engine_inmemcache/) - In-memory cache engine plugin for process-local TTL, LRU, and fast Tigrbl cache workflows.
299
- - [`tigrbl_engine_inmemory`](https://pypi.org/project/tigrbl_engine_inmemory/) - In-memory database engine plugin for process-local transactional storage, copy-on-write snapshots, and Tigrbl testing.
300
- - [`tigrbl_engine_membloom`](https://pypi.org/project/tigrbl_engine_membloom/) - In-memory Bloom filter engine plugin for membership checks, rotating TTL windows, and Tigrbl API workflows.
301
- - [`tigrbl_engine_memdedupe`](https://pypi.org/project/tigrbl_engine_memdedupe/) - In-memory dedupe engine plugin for idempotency tracking, duplicate suppression, and Tigrbl workflow coordination.
302
- - [`tigrbl_engine_memkv`](https://pypi.org/project/tigrbl_engine_memkv/) - In-memory key-value engine plugin for process-local KV storage, cache workflows, and lightweight Tigrbl services.
303
- - [`tigrbl_engine_memlru`](https://pypi.org/project/tigrbl_engine_memlru/) - In-memory LRU engine plugin for least-recently-used cache behavior and process-local Tigrbl data workflows.
304
- - [`tigrbl_engine_mempubsub`](https://pypi.org/project/tigrbl_engine_mempubsub/) - In-memory pub/sub engine plugin for process-local publish-subscribe channels, events, and Tigrbl realtime workflows.
305
- - [`tigrbl_engine_memqueue`](https://pypi.org/project/tigrbl_engine_memqueue/) - In-memory queue engine plugin for process-local tasks, message workflows, and Tigrbl runtime coordination.
306
- - [`tigrbl_engine_memrate`](https://pypi.org/project/tigrbl_engine_memrate/) - In-memory rate-limit engine plugin for API quotas, counters, windows, and Tigrbl governance workflows.
307
- - [`tigrbl_engine_numpy`](https://pypi.org/project/tigrbl_engine_numpy/) - NumPy engine plugin for array-to-table helpers, analytical workflows, and Tigrbl data integration.
308
- - [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/) - Pandas engine plugin for transactional DataFrame sessions, tabular workflows, and Tigrbl data integration.
309
- - [`tigrbl_engine_pgsqli_wal`](https://pypi.org/project/tigrbl_engine_pgsqli_wal/) - PostgreSQL and SQLite WAL engine plugin for transactional Tigrbl workflows and database-backed engine registration.
310
- - [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/) - PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.
311
- - [`tigrbl_engine_pyspark`](https://pypi.org/project/tigrbl_engine_pyspark/) - PySpark engine plugin for distributed DataFrame integration, analytics workloads, and Tigrbl data workflows.
312
- - [`tigrbl_engine_redis`](https://pypi.org/project/tigrbl_engine_redis/) - Redis engine plugin for cache, data structures, and Tigrbl engine workflows backed by Redis.
313
- - [`tigrbl_engine_rediscachethrough`](https://pypi.org/project/tigrbl_engine_rediscachethrough/) - Redis cache-through engine plugin for Redis, PostgreSQL, and Tigrbl data-access acceleration workflows.
314
- - [`tigrbl_engine_snowflake`](https://pypi.org/project/tigrbl_engine_snowflake/) (this package) - Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
315
- - [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/) - SQLite engine plugin for SQLAlchemy sessions, local transactional storage, and Tigrbl application persistence.
316
- - [`tigrbl_engine_xlsx`](https://pypi.org/project/tigrbl_engine_xlsx/) - XLSX engine plugin for Excel workbook-backed tables, worksheet data access, and Tigrbl tabular workflows.
263
+ `tigrbl_engine_snowflake` owns the engine snowflake backend boundary for Tigrbl, including engine registration, session adapters, and backend-specific helpers. Key implementation roots include `tigrbl_engine_snowflake` with `engine, session`.
317
264
 
318
- Application packages:
319
- - [`tigrbl_acme_ca`](https://pypi.org/project/tigrbl_acme_ca/) - ACME v2 certificate authority app for Tigrbl tables, certificate automation, TLS workflows, and API surfaces.
320
- - [`tigrbl_spiffe`](https://pypi.org/project/tigrbl_spiffe/) - SPIFFE and SPIRE identity app for Tigrbl with workload identity tables, UDS transport, and HTTP API surfaces.
265
+ ## Use It When
321
266
 
322
- Source-tree links remain available from each package identity section; this ecosystem section is intentionally PyPI-first for package discovery and installation routing.
267
+ Use `tigrbl_engine_snowflake` when you want the engine snowflake backend installed as an isolated dependency instead of pulling every engine into your environment.
323
268
 
324
- ## Install
269
+ ## Public Surface
325
270
 
326
- ```bash
327
- pip install tigrbl_engine_snowflake
328
- ```
271
+ - `tigrbl_engine_snowflake` exposes `snowflake_engine, snowflake_capabilities, SnowflakeSession, register`.
329
272
 
330
- ## Package discovery
273
+ ## Internal Layout
331
274
 
332
- `tigrbl_engine_snowflake` is described for package indexes, search engines, answer engines, and AI coding tools as: Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
275
+ - Workspace path: `pkgs/engines/tigrbl_engine_snowflake`.
276
+ - Package class: `engine plugin`.
277
+ - Python requirement: `>=3.10,<3.15`.
278
+ - `tigrbl_engine_snowflake` modules: `engine, session`.
333
279
 
334
- Use `tigrbl_engine_snowflake` when you need Tigrbl's schema-first ASGI package graph for REST APIs, JSON-RPC APIs, OpenAPI documentation, OpenRPC documentation, SQLAlchemy-backed models, Pydantic validation, typed operation specs, runtime dispatch, and installable engine or application extensions.
280
+ ## Dependency Surface
335
281
 
336
- Discovery terms: tigrbl, ASGI, schema-first API framework, REST API, JSON-RPC API, OpenAPI documentation, OpenRPC documentation, SQLAlchemy models, Pydantic validation, typed validation, operation dispatch, engine plugins, api, json-rpc, rest, sqlalchemy, pydantic, engine, plugin, database, snowflake, warehouse, analytics, openapi, openrpc, schema-first.
282
+ - Workspace package dependencies: none declared.
283
+ - External runtime dependencies: `SQLAlchemy>=2.0,<3.0`, `snowflake-sqlalchemy>=1.5,<2.0`, `snowflake-connector-python>=3.0,<4.0`.
284
+ - Optional extras: none declared.
337
285
 
338
- ## Package-local entry point
286
+ ## Related Packages
339
287
 
340
- This file is a package-local distribution entry point.
341
- It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
288
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
342
289
 
343
- ## Canonical repository docs
290
+ ## Canonical Repository Docs
344
291
 
345
- - `README.md`
346
292
  - `docs/README.md`
347
293
  - `docs/conformance/CURRENT_TARGET.md`
348
294
  - `docs/conformance/CURRENT_STATE.md`
@@ -351,14 +297,11 @@ It is not the authoritative location for repository governance, current target s
351
297
  - `docs/developer/PACKAGE_CATALOG.md`
352
298
  - `docs/developer/PACKAGE_LAYOUT.md`
353
299
 
354
- ## Package identity
300
+ ## Package-local Boundary
301
+
302
+ This file is a package-local distribution entry point.
303
+ Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
355
304
 
356
- - canonical repository: `https://github.com/tigrbl/tigrbl`
357
- - organization: `https://github.com/tigrbl`
358
- - social: `https://discord.gg/K4YTAPapjR`
359
- - package path: `https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake`
360
- - workspace path: `pkgs/engines/tigrbl_engine_snowflake`
361
- - workspace class: engine package
362
- - implementation layout: `src/tigrbl_engine_snowflake/`
305
+ ## License
363
306
 
364
- Long-form repository documentation is governed from `docs/`.
307
+ 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).
@@ -0,0 +1,69 @@
1
+ <div align="center">
2
+ <h1>tigrbl_engine_snowflake</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>Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.</strong></p>
5
+ <a href="https://pypi.org/project/tigrbl_engine_snowflake/"><img src="https://img.shields.io/pypi/v/tigrbl_engine_snowflake?label=PyPI" alt="PyPI version for tigrbl_engine_snowflake"/></a>
6
+ <a href="https://pypi.org/project/tigrbl_engine_snowflake/"><img src="https://static.pepy.tech/badge/tigrbl_engine_snowflake" alt="Downloads for tigrbl_engine_snowflake"/></a>
7
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_snowflake/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_snowflake/README.md.svg?label=hits" alt="Repository hits for tigrbl_engine_snowflake 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_snowflake"/></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_snowflake"/></a>
11
+ </div>
12
+
13
+ ## Install
14
+
15
+ ```bash
16
+ uv add tigrbl_engine_snowflake
17
+ ```
18
+
19
+ ```bash
20
+ pip install tigrbl_engine_snowflake
21
+ ```
22
+
23
+ ## What It Owns
24
+
25
+ `tigrbl_engine_snowflake` owns the engine snowflake backend boundary for Tigrbl, including engine registration, session adapters, and backend-specific helpers. Key implementation roots include `tigrbl_engine_snowflake` with `engine, session`.
26
+
27
+ ## Use It When
28
+
29
+ Use `tigrbl_engine_snowflake` when you want the engine snowflake backend installed as an isolated dependency instead of pulling every engine into your environment.
30
+
31
+ ## Public Surface
32
+
33
+ - `tigrbl_engine_snowflake` exposes `snowflake_engine, snowflake_capabilities, SnowflakeSession, register`.
34
+
35
+ ## Internal Layout
36
+
37
+ - Workspace path: `pkgs/engines/tigrbl_engine_snowflake`.
38
+ - Package class: `engine plugin`.
39
+ - Python requirement: `>=3.10,<3.15`.
40
+ - `tigrbl_engine_snowflake` modules: `engine, session`.
41
+
42
+ ## Dependency Surface
43
+
44
+ - Workspace package dependencies: none declared.
45
+ - External runtime dependencies: `SQLAlchemy>=2.0,<3.0`, `snowflake-sqlalchemy>=1.5,<2.0`, `snowflake-connector-python>=3.0,<4.0`.
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).
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "tigrbl_engine_snowflake"
7
- version = "0.4.1.dev3"
7
+ version = "0.4.2.dev3"
8
8
  description = "Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration."
9
9
  readme = "README.md"
10
10
  license = { file = "LICENSE" }
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: tigrbl_engine_snowflake
3
- Version: 0.4.1.dev3
3
+ Version: 0.4.2.dev3
4
4
  Summary: Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
5
5
  Author-email: Jacob Stewart <jacob@swarmauri.com>
6
6
  License: Apache License
@@ -236,113 +236,59 @@ Requires-Dist: snowflake-sqlalchemy<2.0,>=1.5
236
236
  Requires-Dist: snowflake-connector-python<4.0,>=3.0
237
237
  Dynamic: license-file
238
238
 
239
- ![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
239
+ <div align="center">
240
+ <h1>tigrbl_engine_snowflake</h1>
241
+ <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
242
+ <p><strong>Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.</strong></p>
243
+ <a href="https://pypi.org/project/tigrbl_engine_snowflake/"><img src="https://img.shields.io/pypi/v/tigrbl_engine_snowflake?label=PyPI" alt="PyPI version for tigrbl_engine_snowflake"/></a>
244
+ <a href="https://pypi.org/project/tigrbl_engine_snowflake/"><img src="https://static.pepy.tech/badge/tigrbl_engine_snowflake" alt="Downloads for tigrbl_engine_snowflake"/></a>
245
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_snowflake/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/engines/tigrbl_engine_snowflake/README.md.svg?label=hits" alt="Repository hits for tigrbl_engine_snowflake README"/></a>
246
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
247
+ <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl_engine_snowflake"/></a>
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_snowflake"/></a>
249
+ </div>
240
250
 
241
- <p align="center">
242
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
243
- <img src="https://img.shields.io/pypi/dm/tigrbl_engine_snowflake" alt="PyPI downloads for tigrbl_engine_snowflake"/></a>
244
- <a href="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake/">
245
- <img src="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake.svg" alt="Repository views for tigrbl_engine_snowflake"/></a>
246
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
247
- <img src="https://img.shields.io/pypi/pyversions/tigrbl_engine_snowflake" alt="Supported Python versions for tigrbl_engine_snowflake"/></a>
248
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
249
- <img src="https://img.shields.io/pypi/l/tigrbl_engine_snowflake" alt="PyPI license metadata for tigrbl_engine_snowflake"/></a>
250
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
251
- <img src="https://img.shields.io/pypi/v/tigrbl_engine_snowflake?label=tigrbl_engine_snowflake&color=green" alt="PyPI version for tigrbl_engine_snowflake"/></a>
252
- </p>
253
-
254
- ---
255
-
256
- <h1 align="center">Tigrbl engine-snowflake</h1>
257
-
258
- **Install and inspect `tigrbl_engine_snowflake`: [download `tigrbl_engine_snowflake` from PyPI](https://pypi.org/project/tigrbl_engine_snowflake/) or [open the package source](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake).**
259
-
260
- tigrbl_engine_snowflake is a Snowflake engine plugin for Snowflake warehouse sessions and analytics-oriented engine registration for Tigrbl.
261
-
262
- `tigrbl_engine_snowflake` is part of the Tigrbl package graph. It documents package-resident classes, concepts, extension points, and execution responsibilities while cross-linking to the facade, core specs, canonical mapping, runtime phases, concrete objects, operation packages, engine plugins, OpenAPI/OpenRPC documentation surfaces, and PyPI distributions that complete the system.
263
-
264
- ## Engine ownership and database guards
265
-
266
- - Snowflake warehouse sessions, analytical query behavior, credential/configuration boundaries, and warehouse execution guardrails.
267
- - Engine packages document backend-specific connection settings, session construction, transaction behavior, persistence boundaries, and operational guardrails. Transport routing and operation semantics remain in the facade/canon/runtime/ops packages.
268
- - Register this engine through the package entry point or the Tigrbl engine context so API code can select the backend without embedding backend-specific logic in model definitions.
251
+ ## Install
269
252
 
270
- ## Package ecosystem cross-links
253
+ ```bash
254
+ uv add tigrbl_engine_snowflake
255
+ ```
271
256
 
272
- Every Tigrbl Python package links to its sibling distributions on PyPI so package indexes, search engines, answer engines, dependency scanners, and human readers can move through the installable package graph without falling back to source-tree paths.
257
+ ```bash
258
+ pip install tigrbl_engine_snowflake
259
+ ```
273
260
 
274
- Core packages:
275
- - [`tigrbl`](https://pypi.org/project/tigrbl/) - Schema-first ASGI API framework for REST, JSON-RPC, OpenAPI, OpenRPC, SQLAlchemy models, typed validation, lifecycle hooks, and engine plugins.
276
- - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/) - Runtime atom utilities for Tigrbl planning, dispatch, transport ingress, egress, and high-throughput ASGI execution pipelines.
277
- - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/) - Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components.
278
- - [`tigrbl-canon`](https://pypi.org/project/tigrbl-canon/) - Canonical mapping, routing, symbol resolution, and naming utilities for Tigrbl framework packages and generated API surfaces.
279
- - [`tigrbl_client`](https://pypi.org/project/tigrbl_client/) - Typed Python client helpers for calling Tigrbl REST, JSON-RPC, OpenAPI, and generated schema-first API surfaces.
280
- - [`tigrbl-concrete`](https://pypi.org/project/tigrbl-concrete/) - Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.
281
- - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/) - Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs.
282
- - [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) - Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
283
- - [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/) - Analytical OLAP operation boundaries for Tigrbl workloads, query-oriented APIs, and engine integrations.
284
- - [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/) - Transactional OLTP operation handlers for Tigrbl CRUD, bulk, REST, JSON-RPC, and database-backed workloads.
285
- - [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/) - Realtime, streaming, datagram, websocket, and event operation handlers for Tigrbl ASGI runtimes.
286
- - [`tigrbl-orm`](https://pypi.org/project/tigrbl-orm/) - SQLAlchemy ORM tables, mixins, columns, model helpers, and persistence primitives for Tigrbl applications.
287
- - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) - Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
288
- - [`tigrbl_spec`](https://pypi.org/project/tigrbl_spec/) - Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.
289
- - [`tigrbl_tests`](https://pypi.org/project/tigrbl_tests/) - Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.
290
- - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/) - Typing protocols, aliases, generics, and shared type helpers for Tigrbl framework packages and extensions.
261
+ ## What It Owns
291
262
 
292
- Engine packages:
293
- - [`tigrbl_engine_bigquery`](https://pypi.org/project/tigrbl_engine_bigquery/) - BigQuery engine plugin for Google BigQuery warehouse sessions, analytics workloads, and Tigrbl engine registration.
294
- - [`tigrbl_engine_clickhouse`](https://pypi.org/project/tigrbl_engine_clickhouse/) - ClickHouse engine plugin for analytical database sessions, warehouse workloads, and Tigrbl engine registration.
295
- - [`tigrbl_engine_csv`](https://pypi.org/project/tigrbl_engine_csv/) - CSV engine plugin for file-backed tables, pandas DataFrames, and lightweight Tigrbl data workflows.
296
- - [`tigrbl_engine_dataframe`](https://pypi.org/project/tigrbl_engine_dataframe/) - DataFrame engine plugin for transactional pandas sessions and in-process Tigrbl analytics workloads.
297
- - [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/) - DuckDB engine plugin for embedded analytical database sessions, OLAP workloads, and Tigrbl engine registration.
298
- - [`tigrbl_engine_inmemcache`](https://pypi.org/project/tigrbl_engine_inmemcache/) - In-memory cache engine plugin for process-local TTL, LRU, and fast Tigrbl cache workflows.
299
- - [`tigrbl_engine_inmemory`](https://pypi.org/project/tigrbl_engine_inmemory/) - In-memory database engine plugin for process-local transactional storage, copy-on-write snapshots, and Tigrbl testing.
300
- - [`tigrbl_engine_membloom`](https://pypi.org/project/tigrbl_engine_membloom/) - In-memory Bloom filter engine plugin for membership checks, rotating TTL windows, and Tigrbl API workflows.
301
- - [`tigrbl_engine_memdedupe`](https://pypi.org/project/tigrbl_engine_memdedupe/) - In-memory dedupe engine plugin for idempotency tracking, duplicate suppression, and Tigrbl workflow coordination.
302
- - [`tigrbl_engine_memkv`](https://pypi.org/project/tigrbl_engine_memkv/) - In-memory key-value engine plugin for process-local KV storage, cache workflows, and lightweight Tigrbl services.
303
- - [`tigrbl_engine_memlru`](https://pypi.org/project/tigrbl_engine_memlru/) - In-memory LRU engine plugin for least-recently-used cache behavior and process-local Tigrbl data workflows.
304
- - [`tigrbl_engine_mempubsub`](https://pypi.org/project/tigrbl_engine_mempubsub/) - In-memory pub/sub engine plugin for process-local publish-subscribe channels, events, and Tigrbl realtime workflows.
305
- - [`tigrbl_engine_memqueue`](https://pypi.org/project/tigrbl_engine_memqueue/) - In-memory queue engine plugin for process-local tasks, message workflows, and Tigrbl runtime coordination.
306
- - [`tigrbl_engine_memrate`](https://pypi.org/project/tigrbl_engine_memrate/) - In-memory rate-limit engine plugin for API quotas, counters, windows, and Tigrbl governance workflows.
307
- - [`tigrbl_engine_numpy`](https://pypi.org/project/tigrbl_engine_numpy/) - NumPy engine plugin for array-to-table helpers, analytical workflows, and Tigrbl data integration.
308
- - [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/) - Pandas engine plugin for transactional DataFrame sessions, tabular workflows, and Tigrbl data integration.
309
- - [`tigrbl_engine_pgsqli_wal`](https://pypi.org/project/tigrbl_engine_pgsqli_wal/) - PostgreSQL and SQLite WAL engine plugin for transactional Tigrbl workflows and database-backed engine registration.
310
- - [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/) - PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.
311
- - [`tigrbl_engine_pyspark`](https://pypi.org/project/tigrbl_engine_pyspark/) - PySpark engine plugin for distributed DataFrame integration, analytics workloads, and Tigrbl data workflows.
312
- - [`tigrbl_engine_redis`](https://pypi.org/project/tigrbl_engine_redis/) - Redis engine plugin for cache, data structures, and Tigrbl engine workflows backed by Redis.
313
- - [`tigrbl_engine_rediscachethrough`](https://pypi.org/project/tigrbl_engine_rediscachethrough/) - Redis cache-through engine plugin for Redis, PostgreSQL, and Tigrbl data-access acceleration workflows.
314
- - [`tigrbl_engine_snowflake`](https://pypi.org/project/tigrbl_engine_snowflake/) (this package) - Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
315
- - [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/) - SQLite engine plugin for SQLAlchemy sessions, local transactional storage, and Tigrbl application persistence.
316
- - [`tigrbl_engine_xlsx`](https://pypi.org/project/tigrbl_engine_xlsx/) - XLSX engine plugin for Excel workbook-backed tables, worksheet data access, and Tigrbl tabular workflows.
263
+ `tigrbl_engine_snowflake` owns the engine snowflake backend boundary for Tigrbl, including engine registration, session adapters, and backend-specific helpers. Key implementation roots include `tigrbl_engine_snowflake` with `engine, session`.
317
264
 
318
- Application packages:
319
- - [`tigrbl_acme_ca`](https://pypi.org/project/tigrbl_acme_ca/) - ACME v2 certificate authority app for Tigrbl tables, certificate automation, TLS workflows, and API surfaces.
320
- - [`tigrbl_spiffe`](https://pypi.org/project/tigrbl_spiffe/) - SPIFFE and SPIRE identity app for Tigrbl with workload identity tables, UDS transport, and HTTP API surfaces.
265
+ ## Use It When
321
266
 
322
- Source-tree links remain available from each package identity section; this ecosystem section is intentionally PyPI-first for package discovery and installation routing.
267
+ Use `tigrbl_engine_snowflake` when you want the engine snowflake backend installed as an isolated dependency instead of pulling every engine into your environment.
323
268
 
324
- ## Install
269
+ ## Public Surface
325
270
 
326
- ```bash
327
- pip install tigrbl_engine_snowflake
328
- ```
271
+ - `tigrbl_engine_snowflake` exposes `snowflake_engine, snowflake_capabilities, SnowflakeSession, register`.
329
272
 
330
- ## Package discovery
273
+ ## Internal Layout
331
274
 
332
- `tigrbl_engine_snowflake` is described for package indexes, search engines, answer engines, and AI coding tools as: Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
275
+ - Workspace path: `pkgs/engines/tigrbl_engine_snowflake`.
276
+ - Package class: `engine plugin`.
277
+ - Python requirement: `>=3.10,<3.15`.
278
+ - `tigrbl_engine_snowflake` modules: `engine, session`.
333
279
 
334
- Use `tigrbl_engine_snowflake` when you need Tigrbl's schema-first ASGI package graph for REST APIs, JSON-RPC APIs, OpenAPI documentation, OpenRPC documentation, SQLAlchemy-backed models, Pydantic validation, typed operation specs, runtime dispatch, and installable engine or application extensions.
280
+ ## Dependency Surface
335
281
 
336
- Discovery terms: tigrbl, ASGI, schema-first API framework, REST API, JSON-RPC API, OpenAPI documentation, OpenRPC documentation, SQLAlchemy models, Pydantic validation, typed validation, operation dispatch, engine plugins, api, json-rpc, rest, sqlalchemy, pydantic, engine, plugin, database, snowflake, warehouse, analytics, openapi, openrpc, schema-first.
282
+ - Workspace package dependencies: none declared.
283
+ - External runtime dependencies: `SQLAlchemy>=2.0,<3.0`, `snowflake-sqlalchemy>=1.5,<2.0`, `snowflake-connector-python>=3.0,<4.0`.
284
+ - Optional extras: none declared.
337
285
 
338
- ## Package-local entry point
286
+ ## Related Packages
339
287
 
340
- This file is a package-local distribution entry point.
341
- It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
288
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
342
289
 
343
- ## Canonical repository docs
290
+ ## Canonical Repository Docs
344
291
 
345
- - `README.md`
346
292
  - `docs/README.md`
347
293
  - `docs/conformance/CURRENT_TARGET.md`
348
294
  - `docs/conformance/CURRENT_STATE.md`
@@ -351,14 +297,11 @@ It is not the authoritative location for repository governance, current target s
351
297
  - `docs/developer/PACKAGE_CATALOG.md`
352
298
  - `docs/developer/PACKAGE_LAYOUT.md`
353
299
 
354
- ## Package identity
300
+ ## Package-local Boundary
301
+
302
+ This file is a package-local distribution entry point.
303
+ Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
355
304
 
356
- - canonical repository: `https://github.com/tigrbl/tigrbl`
357
- - organization: `https://github.com/tigrbl`
358
- - social: `https://discord.gg/K4YTAPapjR`
359
- - package path: `https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake`
360
- - workspace path: `pkgs/engines/tigrbl_engine_snowflake`
361
- - workspace class: engine package
362
- - implementation layout: `src/tigrbl_engine_snowflake/`
305
+ ## License
363
306
 
364
- Long-form repository documentation is governed from `docs/`.
307
+ 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).
@@ -1,126 +0,0 @@
1
- ![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
2
-
3
- <p align="center">
4
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
5
- <img src="https://img.shields.io/pypi/dm/tigrbl_engine_snowflake" alt="PyPI downloads for tigrbl_engine_snowflake"/></a>
6
- <a href="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake/">
7
- <img src="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake.svg" alt="Repository views for tigrbl_engine_snowflake"/></a>
8
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
9
- <img src="https://img.shields.io/pypi/pyversions/tigrbl_engine_snowflake" alt="Supported Python versions for tigrbl_engine_snowflake"/></a>
10
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
11
- <img src="https://img.shields.io/pypi/l/tigrbl_engine_snowflake" alt="PyPI license metadata for tigrbl_engine_snowflake"/></a>
12
- <a href="https://pypi.org/project/tigrbl_engine_snowflake/">
13
- <img src="https://img.shields.io/pypi/v/tigrbl_engine_snowflake?label=tigrbl_engine_snowflake&color=green" alt="PyPI version for tigrbl_engine_snowflake"/></a>
14
- </p>
15
-
16
- ---
17
-
18
- <h1 align="center">Tigrbl engine-snowflake</h1>
19
-
20
- **Install and inspect `tigrbl_engine_snowflake`: [download `tigrbl_engine_snowflake` from PyPI](https://pypi.org/project/tigrbl_engine_snowflake/) or [open the package source](https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake).**
21
-
22
- tigrbl_engine_snowflake is a Snowflake engine plugin for Snowflake warehouse sessions and analytics-oriented engine registration for Tigrbl.
23
-
24
- `tigrbl_engine_snowflake` is part of the Tigrbl package graph. It documents package-resident classes, concepts, extension points, and execution responsibilities while cross-linking to the facade, core specs, canonical mapping, runtime phases, concrete objects, operation packages, engine plugins, OpenAPI/OpenRPC documentation surfaces, and PyPI distributions that complete the system.
25
-
26
- ## Engine ownership and database guards
27
-
28
- - Snowflake warehouse sessions, analytical query behavior, credential/configuration boundaries, and warehouse execution guardrails.
29
- - Engine packages document backend-specific connection settings, session construction, transaction behavior, persistence boundaries, and operational guardrails. Transport routing and operation semantics remain in the facade/canon/runtime/ops packages.
30
- - Register this engine through the package entry point or the Tigrbl engine context so API code can select the backend without embedding backend-specific logic in model definitions.
31
-
32
- ## Package ecosystem cross-links
33
-
34
- Every Tigrbl Python package links to its sibling distributions on PyPI so package indexes, search engines, answer engines, dependency scanners, and human readers can move through the installable package graph without falling back to source-tree paths.
35
-
36
- Core packages:
37
- - [`tigrbl`](https://pypi.org/project/tigrbl/) - Schema-first ASGI API framework for REST, JSON-RPC, OpenAPI, OpenRPC, SQLAlchemy models, typed validation, lifecycle hooks, and engine plugins.
38
- - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/) - Runtime atom utilities for Tigrbl planning, dispatch, transport ingress, egress, and high-throughput ASGI execution pipelines.
39
- - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/) - Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components.
40
- - [`tigrbl-canon`](https://pypi.org/project/tigrbl-canon/) - Canonical mapping, routing, symbol resolution, and naming utilities for Tigrbl framework packages and generated API surfaces.
41
- - [`tigrbl_client`](https://pypi.org/project/tigrbl_client/) - Typed Python client helpers for calling Tigrbl REST, JSON-RPC, OpenAPI, and generated schema-first API surfaces.
42
- - [`tigrbl-concrete`](https://pypi.org/project/tigrbl-concrete/) - Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.
43
- - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/) - Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs.
44
- - [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) - Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
45
- - [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/) - Analytical OLAP operation boundaries for Tigrbl workloads, query-oriented APIs, and engine integrations.
46
- - [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/) - Transactional OLTP operation handlers for Tigrbl CRUD, bulk, REST, JSON-RPC, and database-backed workloads.
47
- - [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/) - Realtime, streaming, datagram, websocket, and event operation handlers for Tigrbl ASGI runtimes.
48
- - [`tigrbl-orm`](https://pypi.org/project/tigrbl-orm/) - SQLAlchemy ORM tables, mixins, columns, model helpers, and persistence primitives for Tigrbl applications.
49
- - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) - Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
50
- - [`tigrbl_spec`](https://pypi.org/project/tigrbl_spec/) - Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.
51
- - [`tigrbl_tests`](https://pypi.org/project/tigrbl_tests/) - Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.
52
- - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/) - Typing protocols, aliases, generics, and shared type helpers for Tigrbl framework packages and extensions.
53
-
54
- Engine packages:
55
- - [`tigrbl_engine_bigquery`](https://pypi.org/project/tigrbl_engine_bigquery/) - BigQuery engine plugin for Google BigQuery warehouse sessions, analytics workloads, and Tigrbl engine registration.
56
- - [`tigrbl_engine_clickhouse`](https://pypi.org/project/tigrbl_engine_clickhouse/) - ClickHouse engine plugin for analytical database sessions, warehouse workloads, and Tigrbl engine registration.
57
- - [`tigrbl_engine_csv`](https://pypi.org/project/tigrbl_engine_csv/) - CSV engine plugin for file-backed tables, pandas DataFrames, and lightweight Tigrbl data workflows.
58
- - [`tigrbl_engine_dataframe`](https://pypi.org/project/tigrbl_engine_dataframe/) - DataFrame engine plugin for transactional pandas sessions and in-process Tigrbl analytics workloads.
59
- - [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/) - DuckDB engine plugin for embedded analytical database sessions, OLAP workloads, and Tigrbl engine registration.
60
- - [`tigrbl_engine_inmemcache`](https://pypi.org/project/tigrbl_engine_inmemcache/) - In-memory cache engine plugin for process-local TTL, LRU, and fast Tigrbl cache workflows.
61
- - [`tigrbl_engine_inmemory`](https://pypi.org/project/tigrbl_engine_inmemory/) - In-memory database engine plugin for process-local transactional storage, copy-on-write snapshots, and Tigrbl testing.
62
- - [`tigrbl_engine_membloom`](https://pypi.org/project/tigrbl_engine_membloom/) - In-memory Bloom filter engine plugin for membership checks, rotating TTL windows, and Tigrbl API workflows.
63
- - [`tigrbl_engine_memdedupe`](https://pypi.org/project/tigrbl_engine_memdedupe/) - In-memory dedupe engine plugin for idempotency tracking, duplicate suppression, and Tigrbl workflow coordination.
64
- - [`tigrbl_engine_memkv`](https://pypi.org/project/tigrbl_engine_memkv/) - In-memory key-value engine plugin for process-local KV storage, cache workflows, and lightweight Tigrbl services.
65
- - [`tigrbl_engine_memlru`](https://pypi.org/project/tigrbl_engine_memlru/) - In-memory LRU engine plugin for least-recently-used cache behavior and process-local Tigrbl data workflows.
66
- - [`tigrbl_engine_mempubsub`](https://pypi.org/project/tigrbl_engine_mempubsub/) - In-memory pub/sub engine plugin for process-local publish-subscribe channels, events, and Tigrbl realtime workflows.
67
- - [`tigrbl_engine_memqueue`](https://pypi.org/project/tigrbl_engine_memqueue/) - In-memory queue engine plugin for process-local tasks, message workflows, and Tigrbl runtime coordination.
68
- - [`tigrbl_engine_memrate`](https://pypi.org/project/tigrbl_engine_memrate/) - In-memory rate-limit engine plugin for API quotas, counters, windows, and Tigrbl governance workflows.
69
- - [`tigrbl_engine_numpy`](https://pypi.org/project/tigrbl_engine_numpy/) - NumPy engine plugin for array-to-table helpers, analytical workflows, and Tigrbl data integration.
70
- - [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/) - Pandas engine plugin for transactional DataFrame sessions, tabular workflows, and Tigrbl data integration.
71
- - [`tigrbl_engine_pgsqli_wal`](https://pypi.org/project/tigrbl_engine_pgsqli_wal/) - PostgreSQL and SQLite WAL engine plugin for transactional Tigrbl workflows and database-backed engine registration.
72
- - [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/) - PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.
73
- - [`tigrbl_engine_pyspark`](https://pypi.org/project/tigrbl_engine_pyspark/) - PySpark engine plugin for distributed DataFrame integration, analytics workloads, and Tigrbl data workflows.
74
- - [`tigrbl_engine_redis`](https://pypi.org/project/tigrbl_engine_redis/) - Redis engine plugin for cache, data structures, and Tigrbl engine workflows backed by Redis.
75
- - [`tigrbl_engine_rediscachethrough`](https://pypi.org/project/tigrbl_engine_rediscachethrough/) - Redis cache-through engine plugin for Redis, PostgreSQL, and Tigrbl data-access acceleration workflows.
76
- - [`tigrbl_engine_snowflake`](https://pypi.org/project/tigrbl_engine_snowflake/) (this package) - Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
77
- - [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/) - SQLite engine plugin for SQLAlchemy sessions, local transactional storage, and Tigrbl application persistence.
78
- - [`tigrbl_engine_xlsx`](https://pypi.org/project/tigrbl_engine_xlsx/) - XLSX engine plugin for Excel workbook-backed tables, worksheet data access, and Tigrbl tabular workflows.
79
-
80
- Application packages:
81
- - [`tigrbl_acme_ca`](https://pypi.org/project/tigrbl_acme_ca/) - ACME v2 certificate authority app for Tigrbl tables, certificate automation, TLS workflows, and API surfaces.
82
- - [`tigrbl_spiffe`](https://pypi.org/project/tigrbl_spiffe/) - SPIFFE and SPIRE identity app for Tigrbl with workload identity tables, UDS transport, and HTTP API surfaces.
83
-
84
- Source-tree links remain available from each package identity section; this ecosystem section is intentionally PyPI-first for package discovery and installation routing.
85
-
86
- ## Install
87
-
88
- ```bash
89
- pip install tigrbl_engine_snowflake
90
- ```
91
-
92
- ## Package discovery
93
-
94
- `tigrbl_engine_snowflake` is described for package indexes, search engines, answer engines, and AI coding tools as: Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
95
-
96
- Use `tigrbl_engine_snowflake` when you need Tigrbl's schema-first ASGI package graph for REST APIs, JSON-RPC APIs, OpenAPI documentation, OpenRPC documentation, SQLAlchemy-backed models, Pydantic validation, typed operation specs, runtime dispatch, and installable engine or application extensions.
97
-
98
- Discovery terms: tigrbl, ASGI, schema-first API framework, REST API, JSON-RPC API, OpenAPI documentation, OpenRPC documentation, SQLAlchemy models, Pydantic validation, typed validation, operation dispatch, engine plugins, api, json-rpc, rest, sqlalchemy, pydantic, engine, plugin, database, snowflake, warehouse, analytics, openapi, openrpc, schema-first.
99
-
100
- ## Package-local entry point
101
-
102
- This file is a package-local distribution entry point.
103
- It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
104
-
105
- ## Canonical repository docs
106
-
107
- - `README.md`
108
- - `docs/README.md`
109
- - `docs/conformance/CURRENT_TARGET.md`
110
- - `docs/conformance/CURRENT_STATE.md`
111
- - `docs/conformance/NEXT_STEPS.md`
112
- - `docs/governance/DOC_POINTERS.md`
113
- - `docs/developer/PACKAGE_CATALOG.md`
114
- - `docs/developer/PACKAGE_LAYOUT.md`
115
-
116
- ## Package identity
117
-
118
- - canonical repository: `https://github.com/tigrbl/tigrbl`
119
- - organization: `https://github.com/tigrbl`
120
- - social: `https://discord.gg/K4YTAPapjR`
121
- - package path: `https://github.com/tigrbl/tigrbl/tree/master/pkgs/engines/tigrbl_engine_snowflake`
122
- - workspace path: `pkgs/engines/tigrbl_engine_snowflake`
123
- - workspace class: engine package
124
- - implementation layout: `src/tigrbl_engine_snowflake/`
125
-
126
- Long-form repository documentation is governed from `docs/`.