graphitedb 0.1.1__tar.gz → 0.1.3__tar.gz

{graphitedb-0.1.1 → graphitedb-0.1.3}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Mahan Khalili
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Mahan Khalili
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

graphitedb-0.1.3/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: graphitedb
+Version: 0.1.3
+Summary: A clean, embedded graph database engine for Python.
+Author-email: Mahan Khalili <khalili1388mahan@gmail.com>
+Maintainer-email: Mahan Khalili <khalili1388mahan@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mkh-user/graphite
+Project-URL: Issues, https://github.com/mkh-user/graphite/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Graphite
+
+A clean, embedded graph database engine for Python.
+
+---
+
+**Graphite** is a lightweight yet flexible **graph database engine** implemented in pure Python.  
+It is designed to model graph-like data inside large Python codebases **without introducing the complexity of an external database**.
+
+---
+
+## Features
+
+### 🧩 Embedded by Design
+Graphite is not a separate service or infrastructure dependency.  
+It lives inside your project, evolves with it, and collaborates naturally with your existing code.
+
+No servers. No ports. No deployment headaches.
+
+---
+
+### 🛠 Ready-made, Customizable Module
+Graphite is intentionally simple and hackable.  
+You can fork it, modify it, or deeply integrate it into your project without fighting rigid abstractions.
+
+The database adapts to your project — not the other way around.
+
+---
+
+### 🐍 Native Python API
+Everything is done through Python APIs.
+No query strings.
+DSL parsing is just an optional layer.
+No context switching.
+
+Your editor already knows how to autocomplete and document your queries.
+
+---
+
+### 🔍 Query? It’s Code.
+Queries are built by chaining Python methods on the `QueryResult` object.
+
+- Zero parsing cost
+- Full IDE support
+- Refactor-safe
+- Debuggable
+
+---
+
+### 🔄 Runtime Evolution
+Change structures, data, or even engine behavior **at runtime**.
+No shutdowns.
+No migrations.
+No waiting.
+
+---
+
+### 🧱 Structure-Oriented Modeling
+Define:
+- node types
+- relation types
+- fields
+- base types
+- valid forms
+
+Model your domain explicitly and safely.
+
+---
+
+### 🧬 Node Inheritance
+Create base node types and extend them with shared properties and advanced relationships.
+
+---
+
+### ✨ Simple, Predictable Syntax
+From defining structures to querying data, every step favors clarity and minimal syntax.
+
+---
+
+### 💾 Serializable
+Persist the entire database into a single file.
+
+---
+
+## Installation
+
+Install from **PyPI**:
+
+```bash
+pip install graphitedb
+````
+
+---
+
+## Why Graphite?
+
+Graphite was extracted from a **large production codebase** where Neo4j introduced more complexity than value.
+
+Neo4j is a powerful tool — but in large projects, adding a separate graph database often increases:
+
+* infrastructure complexity
+* deployment cost
+* maintenance burden
+* cognitive load on developers
+
+Graphite exists for cases where this cost is **not justified**.
+
+It provides graph modeling **without adding another system to operate**.
+
+---
+
+## Example Usage
+
+```python
+import graphite
+
+def example_complete_dsl_loading():
+    engine = graphite.engine()
+
+    complete_dsl = """
+    # Define node types
+    node Person
+        name: string
+        age: int
+
+    node User from Person
+        id: string
+        email: string
+
+    node Object
+    node Book from Object
+        title: string
+        n_pages: int
+
+    node Car from Object
+        model: string
+        year: int
+
+    # Define relation types
+    relation FRIEND both
+        Person - Person
+        since: date
+
+    relation OWNER reverse OWNED_BY
+        Person -> Object
+        since: date
+        purchased_at: date
+
+    relation AUTHOR reverse AUTHORED_BY
+        Person -> Book
+        year: int
+
+    # Create nodes
+    User, user_1, "Joe Doe", 32, "joe4030", "joe@email.com"
+    User, user_2, "Jane Smith", 28, "jane28", "jane@email.com"
+    User, user_3, "Bob Wilson", 45, "bob45", "bob@email.com"
+    User, user_4, "Alice Brown", 22, "alice22", "alice@email.com"
+
+    Book, book_1, "The Great Gatsby", 180
+    Book, book_2, "Python Programming", 450
+    Book, book_3, "Graph Databases", 320
+
+    Car, car_1, "Toyota Camry", 2020
+    Car, car_2, "Honda Civic", 2018
+
+    # Create relations
+    user_1 -[FRIEND, 2020-05-15]- user_2
+    user_1 -[FRIEND, 2019-08-22]- user_3
+    user_2 -[FRIEND, 2021-01-10]- user_4
+
+    user_1 -[OWNER, 2021-03-01, 2021-02-15]-> car_1
+    user_2 -[OWNER, 2019-06-20, 2019-05-10]-> book_1
+    user_3 -[OWNER, 2022-11-05, 2022-10-20]-> book_2
+
+    user_1 -[AUTHOR, 2020]-> book_3
+    user_2 -[AUTHOR, 2021]-> book_2
+    """
+
+    engine.load_dsl(complete_dsl)
+
+    users = engine.query.User.get()
+    print([u["name"] for u in users])
+
+    return engine
+```
+
+More examples are available in `example.py` in the GitHub repository.

graphitedb-0.1.3/README.md

@@ -0,0 +1,187 @@
+# Graphite
+
+A clean, embedded graph database engine for Python.
+
+---
+
+**Graphite** is a lightweight yet flexible **graph database engine** implemented in pure Python.  
+It is designed to model graph-like data inside large Python codebases **without introducing the complexity of an external database**.
+
+---
+
+## Features
+
+### 🧩 Embedded by Design
+Graphite is not a separate service or infrastructure dependency.  
+It lives inside your project, evolves with it, and collaborates naturally with your existing code.
+
+No servers. No ports. No deployment headaches.
+
+---
+
+### 🛠 Ready-made, Customizable Module
+Graphite is intentionally simple and hackable.  
+You can fork it, modify it, or deeply integrate it into your project without fighting rigid abstractions.
+
+The database adapts to your project — not the other way around.
+
+---
+
+### 🐍 Native Python API
+Everything is done through Python APIs.
+No query strings.
+DSL parsing is just an optional layer.
+No context switching.
+
+Your editor already knows how to autocomplete and document your queries.
+
+---
+
+### 🔍 Query? It’s Code.
+Queries are built by chaining Python methods on the `QueryResult` object.
+
+- Zero parsing cost
+- Full IDE support
+- Refactor-safe
+- Debuggable
+
+---
+
+### 🔄 Runtime Evolution
+Change structures, data, or even engine behavior **at runtime**.
+No shutdowns.
+No migrations.
+No waiting.
+
+---
+
+### 🧱 Structure-Oriented Modeling
+Define:
+- node types
+- relation types
+- fields
+- base types
+- valid forms
+
+Model your domain explicitly and safely.
+
+---
+
+### 🧬 Node Inheritance
+Create base node types and extend them with shared properties and advanced relationships.
+
+---
+
+### ✨ Simple, Predictable Syntax
+From defining structures to querying data, every step favors clarity and minimal syntax.
+
+---
+
+### 💾 Serializable
+Persist the entire database into a single file.
+
+---
+
+## Installation
+
+Install from **PyPI**:
+
+```bash
+pip install graphitedb
+````
+
+---
+
+## Why Graphite?
+
+Graphite was extracted from a **large production codebase** where Neo4j introduced more complexity than value.
+
+Neo4j is a powerful tool — but in large projects, adding a separate graph database often increases:
+
+* infrastructure complexity
+* deployment cost
+* maintenance burden
+* cognitive load on developers
+
+Graphite exists for cases where this cost is **not justified**.
+
+It provides graph modeling **without adding another system to operate**.
+
+---
+
+## Example Usage
+
+```python
+import graphite
+
+def example_complete_dsl_loading():
+    engine = graphite.engine()
+
+    complete_dsl = """
+    # Define node types
+    node Person
+        name: string
+        age: int
+
+    node User from Person
+        id: string
+        email: string
+
+    node Object
+    node Book from Object
+        title: string
+        n_pages: int
+
+    node Car from Object
+        model: string
+        year: int
+
+    # Define relation types
+    relation FRIEND both
+        Person - Person
+        since: date
+
+    relation OWNER reverse OWNED_BY
+        Person -> Object
+        since: date
+        purchased_at: date
+
+    relation AUTHOR reverse AUTHORED_BY
+        Person -> Book
+        year: int
+
+    # Create nodes
+    User, user_1, "Joe Doe", 32, "joe4030", "joe@email.com"
+    User, user_2, "Jane Smith", 28, "jane28", "jane@email.com"
+    User, user_3, "Bob Wilson", 45, "bob45", "bob@email.com"
+    User, user_4, "Alice Brown", 22, "alice22", "alice@email.com"
+
+    Book, book_1, "The Great Gatsby", 180
+    Book, book_2, "Python Programming", 450
+    Book, book_3, "Graph Databases", 320
+
+    Car, car_1, "Toyota Camry", 2020
+    Car, car_2, "Honda Civic", 2018
+
+    # Create relations
+    user_1 -[FRIEND, 2020-05-15]- user_2
+    user_1 -[FRIEND, 2019-08-22]- user_3
+    user_2 -[FRIEND, 2021-01-10]- user_4
+
+    user_1 -[OWNER, 2021-03-01, 2021-02-15]-> car_1
+    user_2 -[OWNER, 2019-06-20, 2019-05-10]-> book_1
+    user_3 -[OWNER, 2022-11-05, 2022-10-20]-> book_2
+
+    user_1 -[AUTHOR, 2020]-> book_3
+    user_2 -[AUTHOR, 2021]-> book_2
+    """
+
+    engine.load_dsl(complete_dsl)
+
+    users = engine.query.User.get()
+    print([u["name"] for u in users])
+
+    return engine
+```
+
+More examples are available in `example.py` in the GitHub repository.

{graphitedb-0.1.1 → graphitedb-0.1.3}/pyproject.toml

@@ -1,26 +1,26 @@
-[build-system]
-requires = ["setuptools >= 77.0.3"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "graphitedb"
-version = "0.1.1"
-authors = [
-    { name="Mahan Khalili", email="khalili1388mahan@gmail.com" },
-]
-maintainers = [
-    { name="Mahan Khalili", email="khalili1388mahan@gmail.com" },
-]
-description = "A clean graph database engine"
-readme = "README.md"
-requires-python = ">=3.9"
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "Operating System :: OS Independent",
-]
-license = "MIT"
-license-files = ["LICEN[CS]E*"]
-
-[project.urls]
-Homepage = "https://github.com/mkh-user/graphite"
+[build-system]
+requires = ["setuptools >= 77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "graphitedb"
+version = "0.1.3"
+authors = [
+    { name="Mahan Khalili", email="khalili1388mahan@gmail.com" },
+]
+maintainers = [
+    { name="Mahan Khalili", email="khalili1388mahan@gmail.com" },
+]
+description = "A clean, embedded graph database engine for Python."
+readme = "README.md"
+requires-python = ">=3.9"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+
+[project.urls]
+Homepage = "https://github.com/mkh-user/graphite"
 Issues = "https://github.com/mkh-user/graphite/issues"

{graphitedb-0.1.1 → graphitedb-0.1.3}/setup.cfg

@@ -1,4 +1,4 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-
+[egg_info]
+tag_build = 
+tag_date = 0
+