lora-python 0.2.0__cp38-abi3-win_amd64.whl

lora_python-0.2.0.dist-info/METADATA

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: lora-python
+Version: 0.2.0
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Typing :: Typed
+Classifier: Development Status :: 3 - Alpha
+Requires-Dist: pytest>=8.0 ; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.23 ; extra == 'test'
+Provides-Extra: test
+License-File: LICENSE
+Summary: Python bindings for the Lora in-memory graph database
+Author: LoraDB, Inc.
+License: BUSL-1.1
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/lora-db/lora
+Project-URL: Issues, https://github.com/lora-db/lora/issues
+Project-URL: Repository, https://github.com/lora-db/lora
+
+# lora-python
+
+Python bindings for the [Lora](../../README.md) in-memory graph
+engine. Ships both a synchronous PyO3 `Database` class and an
+asyncio-compatible `AsyncDatabase` wrapper that never blocks the event loop.
+
+> **Status:** prototype / feasibility check. Not published to PyPI.
+
+## Install (local dev)
+
+```bash
+cd crates/lora-python
+python3 -m venv .venv && source .venv/bin/activate
+pip install -U pip maturin pytest pytest-asyncio
+maturin develop         # builds the Rust extension into the venv
+pytest                  # runs the sync + async smoke tests
+```
+
+`maturin develop` produces a `lora_python/_native.<platform>.so` inside the
+package and makes `import lora_python` work immediately.
+
+## Sync usage
+
+```python
+from lora_python import Database, is_node
+
+db = Database.create()
+db.execute("CREATE (:Person {name: $n, age: $a})", {"n": "Alice", "a": 30})
+
+res = db.execute("MATCH (n:Person) RETURN n")
+for row in res["rows"]:
+    n = row["n"]
+    if is_node(n):
+        print(n["properties"]["name"])
+```
+
+## Async usage (non-blocking)
+
+```python
+import asyncio
+from lora_python import AsyncDatabase
+
+async def main():
+    db = await AsyncDatabase.create()
+    await db.execute("CREATE (:Person {name: 'Alice'})")
+    r = await db.execute("MATCH (n:Person) RETURN n.name AS name")
+    print(r["rows"])
+
+asyncio.run(main())
+```
+
+`AsyncDatabase.execute` dispatches the query onto the default asyncio
+thread pool via `asyncio.to_thread`. The PyO3 `Database.execute` releases
+the Python GIL for the duration of engine work, so other coroutines on the
+event loop can progress while a query runs. A dedicated test proves the
+event loop continues ticking during a 2 000-node `MATCH`.
+
+## Typed value model
+
+Same conceptual contract as `lora-node` / `lora-wasm`:
+
+| Python shape                                               | Lora value         |
+|------------------------------------------------------------|----------------------|
+| `None`, `bool`, `int`, `float`, `str`                      | scalars              |
+| `list`, `dict`                                             | collections          |
+| `{"kind": "node", "id", "labels", "properties"}`           | node                 |
+| `{"kind": "relationship", "id", …}`                        | relationship         |
+| `{"kind": "path", "nodes": [...], "rels": [...]}`          | path                 |
+| `{"kind": "date", "iso": "YYYY-MM-DD"}` (and `time`, …)    | temporal             |
+| point dicts — see below                                    | point                |
+
+Points are returned as dicts keyed on their CRS:
+
+| SRID | Dict                                                                                               |
+|------|----------------------------------------------------------------------------------------------------|
+| 7203 | `{"kind": "point", "srid": 7203, "crs": "cartesian", "x", "y"}`                                    |
+| 9157 | `{"kind": "point", "srid": 9157, "crs": "cartesian-3D", "x", "y", "z"}`                            |
+| 4326 | `{"kind": "point", "srid": 4326, "crs": "WGS-84-2D", "x", "y", "longitude", "latitude"}`           |
+| 4979 | `{"kind": "point", "srid": 4979, "crs": "WGS-84-3D", "x", "y", "z", "longitude", "latitude", "height"}` |
+
+Constructors and guards are exported from `lora_python.types`:
+`date`, `time`, `localtime`, `datetime`, `localdatetime`, `duration`,
+`cartesian`, `cartesian_3d`, `wgs84`, `wgs84_3d`, `is_node`,
+`is_relationship`, `is_path`, `is_point`, `is_temporal`.
+
+> `distance()` on WGS-84-3D points ignores `height` — see
+> [functions reference](../../apps/loradb.com/docs/functions/overview.md) for the full spatial
+> reference and known limitations.
+
+## Errors
+
+- `LoraError` — base class
+- `LoraQueryError` — parse / analyze / execute failure
+- `InvalidParamsError` — a parameter value couldn't be mapped
+
+All three are available as `lora_python.LoraError`, etc.
+
+## Architecture
+
+```
+lora-database (Rust)
+   └── lora-python (crate, cdylib)             <- PyO3 bindings
+          ├── Database (sync, releases the GIL)
+          └── python/lora_python/
+                 ├── _async.py  AsyncDatabase via asyncio.to_thread
+                 └── types.py   typed dicts + constructors + guards
+```
+

lora_python-0.2.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+lora_python/__init__.py,sha256=GTlTTfo-PWuREXxF9TNd7yDb_aIWTmJMz-FNvhySGdI,2930
+lora_python/_async.py,sha256=eZO9UhSZJs86jFTfraHN2SW_9AVtM689cETL-FAwZB4,3980
+lora_python/_native.pyd,sha256=X4BFPqGH3qPDNvhDuE4s1DZPUcaUKCejA2SHeQQ1uqg,2658304
+lora_python/_native.pyi,sha256=PRHdklmHdhVP0B_63E4okYYB-9qG1ke809hWeJK5NkU,1022
+lora_python/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lora_python/types.py,sha256=8CdNJfiY9qwPLea2AjU9J3UH2clMhq7qow1K3PBVJ38,8099
+lora_python-0.2.0.dist-info/METADATA,sha256=-JQkUhynTR_1OMg-0YdOf8B2HtE5rxNWOKtpuQ8DZ5Q,5528
+lora_python-0.2.0.dist-info/WHEEL,sha256=X8vvqavrCCzME4tEQB46rFZlEGXF4kNwLeRqgaDmIw4,95
+lora_python-0.2.0.dist-info/licenses/LICENSE,sha256=DeqCzu641BanViME_ETS6_mmFsr4Nv4lI3zisnLqxyU,4333
+lora_python-0.2.0.dist-info/sboms/lora-python.cyclonedx.json,sha256=faV3_2elOJJJY7EHOogZkpKun6XIoCHXDFM36-F4g44,85348
+lora_python-0.2.0.dist-info/RECORD,,

lora_python-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.13.1)
+Root-Is-Purelib: false
+Tag: cp38-abi3-win_amd64

lora_python-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,87 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             LoraDB, Inc.
+Licensed Work:        LoraDB
+Change Date:          2029-04-19
+Change License:       Apache License, Version 2.0
+
+Additional Use Grant: You may use, copy, modify, create derivative works of,
+                      distribute, and make production use of the Licensed Work
+                      for internal business purposes and non-production
+                      purposes, provided that you do not use the Licensed Work
+                      to offer, operate, or make available a database-as-a-
+                      service, hosted API, managed database platform, or any
+                      substantially similar hosted service for third parties.
+
+                      The Additional Use Grant does not permit using the
+                      Licensed Work to provide a commercial or non-commercial
+                      hosted service that allows third parties to access LoraDB
+                      functionality, including as part of a competing managed
+                      database platform, backend-as-a-service, application
+                      platform, developer platform, or resale offering.
+
+Business Source License
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production
+use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or modified
+form from a third party, the terms and conditions set forth in this License
+apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor
+or its affiliates.
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+3. To specify a Change Date.
+4. Not to modify this License in any other way.