rusty-graph 0.3.1__cp310-cp310-manylinux_2_34_x86_64.whl → 0.3.3__cp310-cp310-manylinux_2_34_x86_64.whl

{rusty_graph-0.3.1.dist-info → rusty_graph-0.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rusty_graph
-Version: 0.3.1
+Version: 0.3.3
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
@@ -17,31 +17,10 @@ Project-URL: Source Code, https://github.com/kkollsga/rusty_graph
 
 A high-performance graph database library with Python bindings written in Rust.
 
-Rusty Graph is a Rust-based project that aims to empower the generation of high-performance knowledge graphs within Python environments. Specifically designed for aggregating and merging data from SQL databases, Rusty Graph facilitates the seamless transition of relational database information into structured knowledge graphs. By leveraging Rust's efficiency and Python's flexibility, Rusty Graph offers an optimal solution for data scientists and developers looking to harness the power of knowledge graphs in their data-driven applications.
-
-## Key Features
-- **Efficient Data Integration:** Easily import and merge data from SQL databases to construct knowledge graphs, optimizing for performance and scalability.
-- **High-Performance Operations:** Utilize Rust's performance capabilities to handle graph operations, making Rusty Graph ideal for working with large-scale data.
-- **Python Compatibility:** Directly integrate Rusty Graph into Python projects, allowing for a smooth workflow within Python-based data analysis and machine learning pipelines.
-- **Flexible Graph Manipulation:** Create, modify, and query knowledge graphs with a rich set of features, catering to complex data structures and relationships.
-
-## Direct Download and Install
-Users can download the .whl file directly from the repository and install it using pip. 
-- *Note that the release is only compatible with Python 3.12 on win_amd64.*
-- *The library is still in alpha, so the functionality is very limited.*
-```sh
-pip install https://github.com/kkollsga/rusty_graph/blob/main/wheels/rusty_graph-0.2.13-cp312-cp312-win_amd64.whl?raw=true
-# or upgrade an already installed library
-pip install --upgrade https://github.com/kkollsga/rusty_graph/blob/main/wheels/rusty_graph-0.2.13-cp312-cp312-win_amd64.whl?raw=true
-```
-
-# Rusty Graph Python Library
-
-A high-performance graph database library with Python bindings written in Rust.
-
 ## Table of Contents
 
 - [Installation](#installation)
+- [Introduction](#introduction)
 - [Basic Usage](#basic-usage)
 - [Working with Nodes](#working-with-nodes)
 - [Creating Connections](#creating-connections)
@@ -57,6 +36,16 @@ A high-performance graph database library with Python bindings written in Rust.
 pip install rusty-graph
 ```
 
+## Introduction
+
+Rusty Graph is a Rust-based project that aims to empower the generation of high-performance knowledge graphs within Python environments. Specifically designed for aggregating and merging data from SQL databases, Rusty Graph facilitates the seamless transition of relational database information into structured knowledge graphs. By leveraging Rust's efficiency and Python's flexibility, Rusty Graph offers an optimal solution for data scientists and developers looking to harness the power of knowledge graphs in their data-driven applications.
+
+## Key Features
+- **Efficient Data Integration:** Easily import and merge data from SQL databases to construct knowledge graphs, optimizing for performance and scalability.
+- **High-Performance Operations:** Utilize Rust's performance capabilities to handle graph operations, making Rusty Graph ideal for working with large-scale data.
+- **Python Compatibility:** Directly integrate Rusty Graph into Python projects, allowing for a smooth workflow within Python-based data analysis and machine learning pipelines.
+- **Flexible Graph Manipulation:** Create, modify, and query knowledge graphs with a rich set of features, catering to complex data structures and relationships.
+
 ## Basic Usage
 
 ```python
@@ -184,6 +173,28 @@ selected_products = graph.type_filter('Product').filter({
 })
 ```
 
+### Filtering Orphan Nodes
+
+Orphan nodes are nodes that have no connections (no incoming or outgoing edges). You can filter to include or exclude orphan nodes:
+
+```python
+# Get only orphan nodes
+orphans = graph.filter_orphans(include_orphans=True)
+
+# Get only nodes that have at least one connection
+connected = graph.filter_orphans(include_orphans=False)
+
+# Filter orphans with sorting and limits
+recent_orphans = graph.filter_orphans(
+    include_orphans=True, 
+    sort_spec='created_date', 
+    max_nodes=100
+)
+
+# Chain with other operations
+product_orphans = graph.type_filter('Product').filter_orphans(include_orphans=True)
+```
+
 ### Sorting Results
 
 ```python
@@ -248,6 +259,17 @@ unique_categories = graph.type_filter('Product').unique_values(
     store_as='category_list',
     max_length=10
 )
+
+# Convert children properties to a comma-separated list in parent nodes
+users_with_products = graph.type_filter('User').traverse('PURCHASED').children_properties_to_list(
+    property='title',  # Default is 'title' if not specified
+    filter={'price': {'<': 500.0}},  # Optional filtering of children
+    sort_spec='price',  # Optional sorting of children
+    max_nodes=5,  # Optional limit of children per parent
+    store_as='purchased_products',  # Property name to store the list in parent
+    max_length=100,  # Optional maximum string length (adds "..." if truncated)
+    keep_selection=False  # Whether to keep the current selection
+)
 ```
 
 ### Custom Calculations

rusty_graph-0.3.3.dist-info/RECORD

@@ -0,0 +1,6 @@
+rusty_graph-0.3.3.dist-info/METADATA,sha256=Mw0MbC1NTH3MeR59NM8OfIQdfRngmfsngmcusuxTlm4,9739
+rusty_graph-0.3.3.dist-info/WHEEL,sha256=T5N8wV_FFFFqNMyMMjqvVZVA4nBXclX-pkxhEjZDV9w,108
+rusty_graph-0.3.3.dist-info/licenses/LICENSE,sha256=rpMbqF0kOM1XAviOJRrR8UYQsNx0QPAzbf5b4RE358g,932
+rusty_graph/__init__.py,sha256=_Fds04T5qV95XgyZm7qIPfLghgoCZi-_hDbw-e_18oA,127
+rusty_graph/rusty_graph.cpython-310-x86_64-linux-gnu.so,sha256=Uqzfmx20N9EUY5XH_8BRhYb4cBtQLfuW5yRYHIxgdbU,1447912
+rusty_graph-0.3.3.dist-info/RECORD,,

rusty_graph-0.3.1.dist-info/RECORD

@@ -1,6 +0,0 @@
-rusty_graph-0.3.1.dist-info/METADATA,sha256=NVxPJF4pu3IYDgIkzCMES55H7QBCH1qlXZ8PSIZTwwc,9100
-rusty_graph-0.3.1.dist-info/WHEEL,sha256=T5N8wV_FFFFqNMyMMjqvVZVA4nBXclX-pkxhEjZDV9w,108
-rusty_graph-0.3.1.dist-info/licenses/LICENSE,sha256=rpMbqF0kOM1XAviOJRrR8UYQsNx0QPAzbf5b4RE358g,932
-rusty_graph/__init__.py,sha256=_Fds04T5qV95XgyZm7qIPfLghgoCZi-_hDbw-e_18oA,127
-rusty_graph/rusty_graph.cpython-310-x86_64-linux-gnu.so,sha256=1B6WhStglwpeilIf2FzbY1u2pPTPYVE0FoPxcTIE9W8,1429056
-rusty_graph-0.3.1.dist-info/RECORD,,