flowquery 1.0.4__tar.gz

flowquery-1.0.4/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: flowquery
+Version: 1.0.4
+Summary: A declarative query language for data processing pipelines
+Author: FlowQuery Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/microsoft/FlowQuery/flowquery-py
+Project-URL: Repository, https://github.com/microsoft/FlowQuery/flowquery-py
+Project-URL: Documentation, https://github.com/microsoft/FlowQuery/flowquery-py#readme
+Project-URL: Issues, https://github.com/microsoft/FlowQuery/issues
+Keywords: query,data-processing,pipeline,declarative
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database :: Front-Ends
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+
+# FlowQuery
+
+A declarative query language for data processing pipelines.
+
+## Installation
+
+```bash
+pip install flowquery
+```
+
+## Quick Start
+
+### Command Line Interface
+
+Start the interactive REPL:
+
+```bash
+flowquery
+```
+
+### Programmatic Usage
+
+```python
+import asyncio
+from flowquery import Runner
+
+runner = Runner("WITH 1 as x RETURN x + 1 as result")
+asyncio.run(runner.run())
+print(runner.results)  # [{'result': 2}]
+```
+
+## Creating Custom Functions
+
+```python
+from flowquery.extensibility import Function, FunctionDef
+
+@FunctionDef({
+    "description": "Converts a string to uppercase",
+    "category": "string",
+    "parameters": [
+        {"name": "text", "description": "String to convert", "type": "string"}
+    ],
+    "output": {"description": "Uppercase string", "type": "string"}
+})
+class UpperCase(Function):
+    def __init__(self):
+        super().__init__("uppercase")
+        self._expected_parameter_count = 1
+
+    def value(self) -> str:
+        return str(self.get_children()[0].value()).upper()
+```
+
+## Documentation
+
+- [Full Documentation](https://github.com/microsoft/FlowQuery)
+- [Contributing Guide](https://github.com/microsoft/FlowQuery/blob/main/flowquery-py/CONTRIBUTING.md)
+
+## License
+
+MIT License - see [LICENSE](https://github.com/microsoft/FlowQuery/blob/main/LICENSE) for details.
+
+## Links
+
+- [Homepage](https://github.com/microsoft/FlowQuery)
+- [Repository](https://github.com/microsoft/FlowQuery)
+- [Issues](https://github.com/microsoft/FlowQuery/issues)

flowquery-1.0.4/README.md

@@ -0,0 +1,67 @@
+# FlowQuery
+
+A declarative query language for data processing pipelines.
+
+## Installation
+
+```bash
+pip install flowquery
+```
+
+## Quick Start
+
+### Command Line Interface
+
+Start the interactive REPL:
+
+```bash
+flowquery
+```
+
+### Programmatic Usage
+
+```python
+import asyncio
+from flowquery import Runner
+
+runner = Runner("WITH 1 as x RETURN x + 1 as result")
+asyncio.run(runner.run())
+print(runner.results)  # [{'result': 2}]
+```
+
+## Creating Custom Functions
+
+```python
+from flowquery.extensibility import Function, FunctionDef
+
+@FunctionDef({
+    "description": "Converts a string to uppercase",
+    "category": "string",
+    "parameters": [
+        {"name": "text", "description": "String to convert", "type": "string"}
+    ],
+    "output": {"description": "Uppercase string", "type": "string"}
+})
+class UpperCase(Function):
+    def __init__(self):
+        super().__init__("uppercase")
+        self._expected_parameter_count = 1
+
+    def value(self) -> str:
+        return str(self.get_children()[0].value()).upper()
+```
+
+## Documentation
+
+- [Full Documentation](https://github.com/microsoft/FlowQuery)
+- [Contributing Guide](https://github.com/microsoft/FlowQuery/blob/main/flowquery-py/CONTRIBUTING.md)
+
+## License
+
+MIT License - see [LICENSE](https://github.com/microsoft/FlowQuery/blob/main/LICENSE) for details.
+
+## Links
+
+- [Homepage](https://github.com/microsoft/FlowQuery)
+- [Repository](https://github.com/microsoft/FlowQuery)
+- [Issues](https://github.com/microsoft/FlowQuery/issues)

flowquery-1.0.4/flowquery.egg-info/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: flowquery
+Version: 1.0.4
+Summary: A declarative query language for data processing pipelines
+Author: FlowQuery Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/microsoft/FlowQuery/flowquery-py
+Project-URL: Repository, https://github.com/microsoft/FlowQuery/flowquery-py
+Project-URL: Documentation, https://github.com/microsoft/FlowQuery/flowquery-py#readme
+Project-URL: Issues, https://github.com/microsoft/FlowQuery/issues
+Keywords: query,data-processing,pipeline,declarative
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database :: Front-Ends
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+
+# FlowQuery
+
+A declarative query language for data processing pipelines.
+
+## Installation
+
+```bash
+pip install flowquery
+```
+
+## Quick Start
+
+### Command Line Interface
+
+Start the interactive REPL:
+
+```bash
+flowquery
+```
+
+### Programmatic Usage
+
+```python
+import asyncio
+from flowquery import Runner
+
+runner = Runner("WITH 1 as x RETURN x + 1 as result")
+asyncio.run(runner.run())
+print(runner.results)  # [{'result': 2}]
+```
+
+## Creating Custom Functions
+
+```python
+from flowquery.extensibility import Function, FunctionDef
+
+@FunctionDef({
+    "description": "Converts a string to uppercase",
+    "category": "string",
+    "parameters": [
+        {"name": "text", "description": "String to convert", "type": "string"}
+    ],
+    "output": {"description": "Uppercase string", "type": "string"}
+})
+class UpperCase(Function):
+    def __init__(self):
+        super().__init__("uppercase")
+        self._expected_parameter_count = 1
+
+    def value(self) -> str:
+        return str(self.get_children()[0].value()).upper()
+```
+
+## Documentation
+
+- [Full Documentation](https://github.com/microsoft/FlowQuery)
+- [Contributing Guide](https://github.com/microsoft/FlowQuery/blob/main/flowquery-py/CONTRIBUTING.md)
+
+## License
+
+MIT License - see [LICENSE](https://github.com/microsoft/FlowQuery/blob/main/LICENSE) for details.
+
+## Links
+
+- [Homepage](https://github.com/microsoft/FlowQuery)
+- [Repository](https://github.com/microsoft/FlowQuery)
+- [Issues](https://github.com/microsoft/FlowQuery/issues)

flowquery-1.0.4/flowquery.egg-info/SOURCES.txt

@@ -0,0 +1,124 @@
+README.md
+pyproject.toml
+flowquery.egg-info/PKG-INFO
+flowquery.egg-info/SOURCES.txt
+flowquery.egg-info/dependency_links.txt
+flowquery.egg-info/entry_points.txt
+flowquery.egg-info/requires.txt
+flowquery.egg-info/top_level.txt
+src/__init__.py
+src/__main__.py
+src/extensibility.py
+src/compute/__init__.py
+src/compute/runner.py
+src/graph/__init__.py
+src/graph/data.py
+src/graph/database.py
+src/graph/hops.py
+src/graph/node.py
+src/graph/node_data.py
+src/graph/node_reference.py
+src/graph/pattern.py
+src/graph/pattern_expression.py
+src/graph/patterns.py
+src/graph/physical_node.py
+src/graph/physical_relationship.py
+src/graph/relationship.py
+src/graph/relationship_data.py
+src/graph/relationship_match_collector.py
+src/graph/relationship_reference.py
+src/io/__init__.py
+src/io/command_line.py
+src/parsing/__init__.py
+src/parsing/alias.py
+src/parsing/alias_option.py
+src/parsing/ast_node.py
+src/parsing/base_parser.py
+src/parsing/context.py
+src/parsing/parser.py
+src/parsing/token_to_node.py
+src/parsing/components/__init__.py
+src/parsing/components/csv.py
+src/parsing/components/from_.py
+src/parsing/components/headers.py
+src/parsing/components/json.py
+src/parsing/components/null.py
+src/parsing/components/post.py
+src/parsing/components/text.py
+src/parsing/data_structures/__init__.py
+src/parsing/data_structures/associative_array.py
+src/parsing/data_structures/json_array.py
+src/parsing/data_structures/key_value_pair.py
+src/parsing/data_structures/lookup.py
+src/parsing/data_structures/range_lookup.py
+src/parsing/expressions/__init__.py
+src/parsing/expressions/boolean.py
+src/parsing/expressions/expression.py
+src/parsing/expressions/expression_map.py
+src/parsing/expressions/f_string.py
+src/parsing/expressions/identifier.py
+src/parsing/expressions/number.py
+src/parsing/expressions/operator.py
+src/parsing/expressions/reference.py
+src/parsing/expressions/string.py
+src/parsing/functions/__init__.py
+src/parsing/functions/aggregate_function.py
+src/parsing/functions/async_function.py
+src/parsing/functions/avg.py
+src/parsing/functions/collect.py
+src/parsing/functions/function.py
+src/parsing/functions/function_factory.py
+src/parsing/functions/function_metadata.py
+src/parsing/functions/functions.py
+src/parsing/functions/join.py
+src/parsing/functions/keys.py
+src/parsing/functions/predicate_function.py
+src/parsing/functions/predicate_sum.py
+src/parsing/functions/rand.py
+src/parsing/functions/range_.py
+src/parsing/functions/reducer_element.py
+src/parsing/functions/replace.py
+src/parsing/functions/round_.py
+src/parsing/functions/size.py
+src/parsing/functions/split.py
+src/parsing/functions/stringify.py
+src/parsing/functions/sum.py
+src/parsing/functions/to_json.py
+src/parsing/functions/type_.py
+src/parsing/functions/value_holder.py
+src/parsing/logic/__init__.py
+src/parsing/logic/case.py
+src/parsing/logic/else_.py
+src/parsing/logic/end.py
+src/parsing/logic/then.py
+src/parsing/logic/when.py
+src/parsing/operations/__init__.py
+src/parsing/operations/aggregated_return.py
+src/parsing/operations/aggregated_with.py
+src/parsing/operations/call.py
+src/parsing/operations/create_node.py
+src/parsing/operations/create_relationship.py
+src/parsing/operations/group_by.py
+src/parsing/operations/limit.py
+src/parsing/operations/load.py
+src/parsing/operations/match.py
+src/parsing/operations/operation.py
+src/parsing/operations/projection.py
+src/parsing/operations/return_op.py
+src/parsing/operations/unwind.py
+src/parsing/operations/where.py
+src/parsing/operations/with_op.py
+src/tokenization/__init__.py
+src/tokenization/keyword.py
+src/tokenization/operator.py
+src/tokenization/string_walker.py
+src/tokenization/symbol.py
+src/tokenization/token.py
+src/tokenization/token_mapper.py
+src/tokenization/token_type.py
+src/tokenization/tokenizer.py
+src/tokenization/trie.py
+src/utils/__init__.py
+src/utils/object_utils.py
+src/utils/string_utils.py
+tests/test_extensibility.py

flowquery-1.0.4/flowquery.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

flowquery-1.0.4/flowquery.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+flowquery = flowquery.io.command_line:main

flowquery-1.0.4/flowquery.egg-info/requires.txt

@@ -0,0 +1,5 @@
+aiohttp>=3.8.0
+
+[dev]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0

flowquery-1.0.4/flowquery.egg-info/top_level.txt

@@ -0,0 +1 @@
+flowquery

flowquery-1.0.4/pyproject.toml

@@ -0,0 +1,75 @@
+[project]
+name = "flowquery"
+version = "1.0.4"
+description = "A declarative query language for data processing pipelines"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+    {name = "FlowQuery Contributors"}
+]
+keywords = ["query", "data-processing", "pipeline", "declarative"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Database :: Front-Ends",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "aiohttp>=3.8.0",
+]
+
+[project.scripts]
+flowquery = "flowquery.io.command_line:main"
+
+[project.urls]
+Homepage = "https://github.com/microsoft/FlowQuery/flowquery-py"
+Repository = "https://github.com/microsoft/FlowQuery/flowquery-py"
+Documentation = "https://github.com/microsoft/FlowQuery/flowquery-py#readme"
+Issues = "https://github.com/microsoft/FlowQuery/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+]
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.package-dir]
+"flowquery" = "src"
+"flowquery.compute" = "src/compute"
+"flowquery.graph" = "src/graph"
+"flowquery.io" = "src/io"
+"flowquery.parsing" = "src/parsing"
+"flowquery.parsing.components" = "src/parsing/components"
+"flowquery.parsing.data_structures" = "src/parsing/data_structures"
+"flowquery.parsing.expressions" = "src/parsing/expressions"
+"flowquery.parsing.functions" = "src/parsing/functions"
+"flowquery.parsing.logic" = "src/parsing/logic"
+"flowquery.parsing.operations" = "src/parsing/operations"
+"flowquery.tokenization" = "src/tokenization"
+"flowquery.utils" = "src/utils"
+
+[tool.setuptools]
+packages = ["flowquery", "flowquery.compute", "flowquery.graph", "flowquery.io", "flowquery.parsing", "flowquery.parsing.components", "flowquery.parsing.data_structures", "flowquery.parsing.expressions", "flowquery.parsing.functions", "flowquery.parsing.logic", "flowquery.parsing.operations", "flowquery.tokenization", "flowquery.utils"]
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"
+
+[tool.pytest-asyncio]
+mode = "auto"

flowquery-1.0.4/setup.cfg

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

flowquery-1.0.4/src/__init__.py

@@ -0,0 +1,34 @@
+"""
+FlowQuery - A declarative query language for data processing pipelines.
+
+This is the Python implementation of FlowQuery.
+"""
+
+from .compute.runner import Runner
+from .io.command_line import CommandLine
+from .parsing.parser import Parser
+from .parsing.functions.function import Function
+from .parsing.functions.aggregate_function import AggregateFunction
+from .parsing.functions.async_function import AsyncFunction
+from .parsing.functions.predicate_function import PredicateFunction
+from .parsing.functions.reducer_element import ReducerElement
+from .parsing.functions.function_metadata import (
+    FunctionDef,
+    FunctionMetadata,
+    FunctionCategory,
+)
+
+__all__ = [
+    "Runner",
+    "CommandLine",
+    "Parser",
+    "Function",
+    "AggregateFunction",
+    "AsyncFunction",
+    "PredicateFunction",
+    "ReducerElement",
+    "FunctionDef",
+    "FunctionMetadata",
+    "FunctionCategory",
+]
+

flowquery-1.0.4/src/__main__.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python
+"""FlowQuery command-line entry point.
+
+Run with: python -m src
+"""
+
+from . import CommandLine
+
+if __name__ == "__main__":
+    CommandLine().loop()

flowquery-1.0.4/src/compute/__init__.py

@@ -0,0 +1,5 @@
+"""Compute module for FlowQuery."""
+
+from .runner import Runner
+
+__all__ = ["Runner"]

flowquery-1.0.4/src/compute/runner.py

@@ -0,0 +1,60 @@
+"""Executes a FlowQuery statement and retrieves the results."""
+
+from typing import Any, Dict, List, Optional
+
+from ..parsing.ast_node import ASTNode
+from ..parsing.operations.operation import Operation
+from ..parsing.parser import Parser
+
+
+class Runner:
+    """Executes a FlowQuery statement and retrieves the results.
+    
+    The Runner class parses a FlowQuery statement into an AST and executes it,
+    managing the execution flow from the first operation to the final return statement.
+    
+    Example:
+        runner = Runner("WITH 1 as x RETURN x")
+        await runner.run()
+        print(runner.results)  # [{ x: 1 }]
+    """
+
+    def __init__(
+        self,
+        statement: Optional[str] = None,
+        ast: Optional[ASTNode] = None
+    ):
+        """Creates a new Runner instance and parses the FlowQuery statement.
+        
+        Args:
+            statement: The FlowQuery statement to execute
+            ast: An already-parsed AST (optional)
+            
+        Raises:
+            ValueError: If neither statement nor AST is provided
+        """
+        if (statement is None or statement == "") and ast is None:
+            raise ValueError("Either statement or AST must be provided")
+        
+        _ast = ast if ast is not None else Parser().parse(statement)
+        self._first: Operation = _ast.first_child()
+        self._last: Operation = _ast.last_child()
+
+    async def run(self) -> None:
+        """Executes the parsed FlowQuery statement.
+        
+        Raises:
+            Exception: If an error occurs during execution
+        """
+        await self._first.initialize()
+        await self._first.run()
+        await self._first.finish()
+
+    @property
+    def results(self) -> List[Dict[str, Any]]:
+        """Gets the results from the executed statement.
+        
+        Returns:
+            The results from the last operation (typically a RETURN statement)
+        """
+        return self._last.results

flowquery-1.0.4/src/extensibility.py

@@ -0,0 +1,52 @@
+"""FlowQuery Extensibility API
+
+This module provides all the exports needed to create custom FlowQuery functions.
+
+Example:
+    from flowquery.extensibility import Function, FunctionDef
+    
+    @FunctionDef({
+        'description': "Converts a string to uppercase",
+        'category': "string",
+        'parameters': [{'name': "text", 'description': "String to convert", 'type': "string"}],
+        'output': {'description': "Uppercase string", 'type': "string"}
+    })
+    class UpperCase(Function):
+        def __init__(self):
+            super().__init__("uppercase")
+            self._expected_parameter_count = 1
+        
+        def value(self) -> str:
+            return str(self.get_children()[0].value()).upper()
+"""
+
+# Base function classes for creating custom functions
+from .parsing.functions.function import Function
+from .parsing.functions.aggregate_function import AggregateFunction
+from .parsing.functions.async_function import AsyncFunction
+from .parsing.functions.predicate_function import PredicateFunction
+from .parsing.functions.reducer_element import ReducerElement
+
+# Decorator and metadata types for function registration
+from .parsing.functions.function_metadata import (
+    FunctionDef,
+    FunctionMetadata,
+    FunctionDefOptions,
+    ParameterSchema,
+    OutputSchema,
+    FunctionCategory,
+)
+
+__all__ = [
+    "Function",
+    "AggregateFunction",
+    "AsyncFunction",
+    "PredicateFunction",
+    "ReducerElement",
+    "FunctionDef",
+    "FunctionMetadata",
+    "FunctionDefOptions",
+    "ParameterSchema",
+    "OutputSchema",
+    "FunctionCategory",
+]

flowquery-1.0.4/src/graph/__init__.py

@@ -0,0 +1,31 @@
+"""Graph module for FlowQuery."""
+
+from .node import Node
+from .relationship import Relationship
+from .pattern import Pattern
+from .patterns import Patterns
+from .pattern_expression import PatternExpression
+from .database import Database
+from .hops import Hops
+from .node_data import NodeData
+from .node_reference import NodeReference
+from .relationship_data import RelationshipData
+from .relationship_reference import RelationshipReference
+from .physical_node import PhysicalNode
+from .physical_relationship import PhysicalRelationship
+
+__all__ = [
+    "Node",
+    "Relationship",
+    "Pattern",
+    "Patterns",
+    "PatternExpression",
+    "Database",
+    "Hops",
+    "NodeData",
+    "NodeReference",
+    "RelationshipData",
+    "RelationshipReference",
+    "PhysicalNode",
+    "PhysicalRelationship",
+]