graphitedb 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

graphitedb-0.1.3.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,6 @@
+graphite/__init__.py,sha256=PDUUAyHqLUImV2yjyblCqjchwBIYHch7MbwCvPrgOGY,22498
+graphitedb-0.1.3.dist-info/licenses/LICENSE,sha256=3n5Zi5QXqsnus7yX3xKY7wKtX7Ios_ofbTxdhSUz0dA,1070
+graphitedb-0.1.3.dist-info/METADATA,sha256=JZBBCG5L6-JwcWNd_HjMTS6872KhITSP23H-CMf6xUQ,4799
+graphitedb-0.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+graphitedb-0.1.3.dist-info/top_level.txt,sha256=QPrpQuMV9WIM20kS6NN7OWkIzypVFiSTICJLsYYkJ1w,9
+graphitedb-0.1.3.dist-info/RECORD,,

{graphitedb-0.1.1.dist-info → graphitedb-0.1.3.dist-info}/licenses/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.1.dist-info → graphitedb-0.1.3.dist-info}/top_level.txt

@@ -1,2 +1 @@
-__init__
 graphite

graphitedb-0.1.1.dist-info/METADATA

@@ -1,149 +0,0 @@
-Metadata-Version: 2.4
-Name: graphitedb
-Version: 0.1.1
-Summary: A clean graph database engine
-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 graph database engine!
-
----
-
-Graphite is a simple yet flexible **Graph Database Engine** that is implemented in Python. This engine uses basic structures (similar to classes in programming languages) for nodes and connections (equivalent to Edges in other engines).
-
-## Features
-
-- **Structure-oriented:** Define node types and relation types in structure, define fields, base type, and valid forms.
-- **Base Node Type:** Create base type for node types to add base properties and advanced relations.
-- **First-class Nodes:** Create nodes from node types and fill data fields.
-- **Relations with Properties:** Like nodes, relations can have properties too.
-- **Simple Syntax:** The most simple syntaxes in all steps.
-- **Serializable:** Save whole database into one file.
-- And much more...
-
-## Installation
-Install package from **Python Package Index**:
-```text
-pip install graphitedb
-```
-
-## 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 node instances
-    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 relation instances
-    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
-
-    # Alternative syntax (reverse relation)
-    book_1 -[OWNED_BY, 2019-06-20, 2019-05-10]-> user_2
-    car_2 -[OWNED_BY, 2018-12-01, 2018-11-15]-> user_4
-    """
-
-	# Load all with one call
-	engine.load_dsl(complete_dsl)
-
-	print("=== Database Stats ===")
-	stats = engine.stats()
-	print(f"Node Types: {stats['node_types']}")
-	print(f"Relation Types: {stats['relation_types']}")
-	print(f"Nodes: {stats['nodes']}")
-	print(f"Relations: {stats['relations']}")
-
-	print("\n=== Query Examples ===")
-
-	# All users
-	users = engine.query.User.get()
-	print(f"All Users ({len(users)}): {[u['name'] for u in users]}")
-
-	# Users with more than 30 years age
-	older_users = engine.query.User.where("age > 30").get()
-	print(f"\nUsers over 30: {[u['name'] for u in older_users]}")
-
-	# Joe Doe books
-	joe_books = (engine.query.User
-	              .where(lambda u: u['name'] == "Joe Doe")
-	              .outgoing("AUTHOR")
-	              .get())
-	print(f"\nBooks authored by Joe Doe: {[b['title'] for b in joe_books]}")
-
-	# Two steps traverse
-	friends_of_friends = (engine.query.User
-	                      .where(lambda u: u['name'] == "Joe Doe")
-	                      .outgoing("FRIEND")
-	                      .outgoing("FRIEND")
-	                      .distinct()
-	                      .get())
-	print(f"\nFriends of friends of Joe Doe: {[f['name'] for f in friends_of_friends]}")
-
-	return engine
-```
-You can see more examples in `example.py` in GitHub repo.

graphitedb-0.1.1.dist-info/RECORD

@@ -1,7 +0,0 @@
-__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-graphite/__init__.py,sha256=7yoRf4SWB3tAqd7AyaWIZj3qXktmXpHSwe5To7gZKgE,20976
-graphitedb-0.1.1.dist-info/licenses/LICENSE,sha256=0vynlOYOP8-cAnXfGAMabNOAfaQ2HarY3ctdboen79g,1091
-graphitedb-0.1.1.dist-info/METADATA,sha256=61o1noWOU6PiCwgC_DnXg-79EDS-IJVVOm25sM4jxeQ,4593
-graphitedb-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-graphitedb-0.1.1.dist-info/top_level.txt,sha256=3a6k71PT31c_EyE1n54UPWzTLUKEUx8PmMNA4uyTByM,18
-graphitedb-0.1.1.dist-info/RECORD,,