kirun-py 3.3.0__tar.gz

kirun_py-3.3.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: kirun-py
+Version: 3.3.0
+Summary: Python Runtime for Kinetic Instructions
+Author: Kiran Kumar Grandhi
+License: MIT
+Requires-Python: >=3.9
+Requires-Dist: python-dateutil>=2.8
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"

kirun_py-3.3.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kirun-py"
+version = "3.3.0"
+description = "Python Runtime for Kinetic Instructions"
+authors = [{ name = "Kiran Kumar Grandhi" }]
+license = { text = "MIT" }
+requires-python = ">=3.9"
+dependencies = ["python-dateutil>=2.8"]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+    "pytest-cov>=4.0",
+    "ruff>=0.1",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 120

kirun_py-3.3.0/setup.cfg

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

kirun_py-3.3.0/src/kirun_py/__init__.py

@@ -0,0 +1,96 @@
+# kirun-py: Python Runtime for Kinetic Instructions
+
+# Core repositories
+from kirun_py.repository.ki_run_function_repository import KIRunFunctionRepository
+from kirun_py.repository.ki_run_schema_repository import KIRunSchemaRepository
+from kirun_py.repository import Repository
+from kirun_py.hybrid_repository import HybridRepository
+
+# Runtime
+from kirun_py.runtime.ki_runtime import KIRuntime
+from kirun_py.runtime.function_execution_parameters import FunctionExecutionParameters
+from kirun_py.runtime.context_element import ContextElement
+from kirun_py.runtime.statement_execution import StatementExecution
+from kirun_py.runtime.statement_message import StatementMessage
+from kirun_py.runtime.statement_message_type import StatementMessageType
+from kirun_py.runtime.graph.execution_graph import ExecutionGraph
+from kirun_py.runtime.graph.graph_vertex import GraphVertex
+from kirun_py.runtime.graph.graph_vertex_type import GraphVertexType
+from kirun_py.runtime.expression.expression import Expression
+from kirun_py.runtime.expression.expression_evaluator import ExpressionEvaluator
+from kirun_py.runtime.expression.operation import Operation
+from kirun_py.runtime.expression.expression_token import ExpressionToken
+from kirun_py.runtime.expression.expression_token_value import ExpressionTokenValue
+from kirun_py.runtime.expression.exception.expression_evaluation_exception import ExpressionEvaluationException
+from kirun_py.runtime.expression.tokenextractor.token_value_extractor import TokenValueExtractor
+from kirun_py.runtime.expression.tokenextractor.literal_token_value_extractor import LiteralTokenValueExtractor
+from kirun_py.runtime.tokenextractor.context_token_value_extractor import ContextTokenValueExtractor
+from kirun_py.runtime.tokenextractor.output_map_token_value_extractor import OutputMapTokenValueExtractor
+from kirun_py.runtime.tokenextractor.arguments_token_value_extractor import ArgumentsTokenValueExtractor
+
+# Function abstractions
+from kirun_py.function.function_ import Function
+from kirun_py.function.abstract_function import AbstractFunction
+
+# Model
+from kirun_py.model.parameter import Parameter
+from kirun_py.model.parameter_reference import ParameterReference
+from kirun_py.model.parameter_reference_type import ParameterReferenceType
+from kirun_py.model.parameter_type import ParameterType
+from kirun_py.model.event import Event
+from kirun_py.model.event_result import EventResult
+from kirun_py.model.function_definition import FunctionDefinition
+from kirun_py.model.function_signature import FunctionSignature
+from kirun_py.model.function_output import FunctionOutput
+from kirun_py.model.function_output_generator import FunctionOutputGenerator
+from kirun_py.model.statement import Statement
+from kirun_py.model.statement_group import StatementGroup
+from kirun_py.model.abstract_statement import AbstractStatement
+from kirun_py.model.argument import Argument
+from kirun_py.model.position import Position
+
+# JSON/Schema
+from kirun_py.json.schema.schema import Schema, AdditionalType
+from kirun_py.json.schema.schema_util import SchemaUtil
+from kirun_py.json.schema.type.schema_type import SchemaType
+from kirun_py.json.schema.type.type_util import TypeUtil
+from kirun_py.json.schema.validator.schema_validator import SchemaValidator
+from kirun_py.json.schema.validator.exception.schema_validation_exception import SchemaValidationException
+
+# Namespaces
+from kirun_py.namespaces.namespaces import Namespaces
+
+# Exceptions
+from kirun_py.exception.ki_runtime_exception import KIRuntimeException
+from kirun_py.exception.execution_exception import ExecutionException
+
+# Utilities
+from kirun_py.util.null_check import is_null_value
+from kirun_py.util.deep_equal import deep_equal
+from kirun_py.util.linked_list import LinkedList
+from kirun_py.util.tuples import Tuple2, Tuple3, Tuple4
+from kirun_py.util.string.string_formatter import StringFormatter
+from kirun_py.util.string.string_util import StringUtil
+from kirun_py.util.string.string_builder import StringBuilder
+
+__all__ = [
+    'KIRunFunctionRepository', 'KIRunSchemaRepository', 'Repository', 'HybridRepository',
+    'KIRuntime', 'FunctionExecutionParameters', 'ContextElement',
+    'StatementExecution', 'StatementMessage', 'StatementMessageType',
+    'ExecutionGraph', 'GraphVertex', 'GraphVertexType',
+    'Expression', 'ExpressionEvaluator', 'Operation', 'ExpressionToken',
+    'ExpressionTokenValue', 'ExpressionEvaluationException',
+    'TokenValueExtractor', 'LiteralTokenValueExtractor',
+    'ContextTokenValueExtractor', 'OutputMapTokenValueExtractor', 'ArgumentsTokenValueExtractor',
+    'Function', 'AbstractFunction',
+    'Parameter', 'ParameterReference', 'ParameterReferenceType', 'ParameterType',
+    'Event', 'EventResult', 'FunctionDefinition', 'FunctionSignature', 'FunctionOutput',
+    'FunctionOutputGenerator', 'Statement', 'StatementGroup', 'AbstractStatement',
+    'Argument', 'Position',
+    'Schema', 'AdditionalType', 'SchemaUtil', 'SchemaType', 'TypeUtil',
+    'SchemaValidator', 'SchemaValidationException',
+    'Namespaces',
+    'KIRuntimeException', 'ExecutionException',
+    'is_null_value', 'deep_equal', 'LinkedList', 'Tuple2', 'Tuple3', 'Tuple4',
+    'StringFormatter', 'StringUtil', 'StringBuilder',
+]

kirun_py-3.3.0/src/kirun_py/constant/__init__.py

@@ -0,0 +1 @@
+from .ki_run_constants import KIRunConstants

kirun_py-3.3.0/src/kirun_py/constant/ki_run_constants.py

@@ -0,0 +1,4 @@
+class KIRunConstants:
+    NAMESPACE: str = 'namespace'
+    NAME: str = 'name'
+    ID: str = 'id'

kirun_py-3.3.0/src/kirun_py/dsl/__init__.py

@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+from kirun_py.dsl.dsl_compiler import DSLCompiler, ValidationResult, FormattedError
+
+__all__ = ['DSLCompiler', 'ValidationResult', 'FormattedError']

kirun_py-3.3.0/src/kirun_py/dsl/dsl_compiler.py

@@ -0,0 +1,130 @@
+from __future__ import annotations
+
+from typing import Any, List, Optional
+
+from kirun_py.dsl.lexer.dsl_lexer import DSLLexer
+from kirun_py.dsl.parser.dsl_parser import DSLParser
+from kirun_py.dsl.transformer.ast_to_json import ASTToJSONTransformer
+from kirun_py.dsl.transformer.json_to_text import JSONToTextTransformer
+
+
+class FormattedError:
+    """Formatted error for user-friendly display."""
+
+    def __init__(
+        self,
+        message: str,
+        line: Optional[int] = None,
+        column: Optional[int] = None,
+        snippet: Optional[str] = None,
+    ) -> None:
+        self.message = message
+        self.line = line
+        self.column = column
+        self.snippet = snippet
+
+
+class ValidationResult:
+    """Validation result with errors if any."""
+
+    def __init__(self, valid: bool, errors: Optional[List[FormattedError]] = None) -> None:
+        self.valid = valid
+        self.errors: List[FormattedError] = errors if errors is not None else []
+
+
+class DSLCompiler:
+    """
+    DSL Compiler - High-level API.
+    Main entry point for DSL compilation and decompilation.
+    """
+
+    @staticmethod
+    def compile(text: str) -> Any:
+        """
+        Compile DSL text to FunctionDefinition JSON.
+
+        Args:
+            text: DSL source text.
+
+        Returns:
+            FunctionDefinition JSON (dict).
+        """
+        # 1. Lex
+        lexer = DSLLexer(text)
+        tokens = lexer.tokenize()
+
+        # 2. Parse (pass original input for exact expression extraction)
+        parser = DSLParser(tokens, text)
+        ast = parser.parse()
+
+        # 3. Transform
+        transformer = ASTToJSONTransformer()
+
+        # Flatten nested blocks before transformation
+        transformer.flatten_nested_blocks(ast)
+
+        json_obj = transformer.transform(ast)
+
+        return json_obj
+
+    @staticmethod
+    async def decompile(json_obj: Any) -> str:
+        """
+        Decompile FunctionDefinition JSON to DSL text.
+
+        Args:
+            json_obj: FunctionDefinition JSON (dict).
+
+        Returns:
+            DSL source text.
+        """
+        transformer = JSONToTextTransformer()
+        return await transformer.transform(json_obj)
+
+    @staticmethod
+    def validate(text: str) -> ValidationResult:
+        """
+        Validate DSL syntax without full compilation.
+
+        Args:
+            text: DSL source text.
+
+        Returns:
+            ValidationResult with errors if any.
+        """
+        try:
+            DSLCompiler.compile(text)
+            return ValidationResult(valid=True)
+        except Exception as error:
+            return ValidationResult(
+                valid=False,
+                errors=[DSLCompiler._format_error(error)],
+            )
+
+    @staticmethod
+    async def format(text: str) -> str:
+        """
+        Format DSL text (parse and regenerate with consistent formatting).
+
+        Args:
+            text: DSL source text.
+
+        Returns:
+            Formatted DSL text.
+        """
+        json_obj = DSLCompiler.compile(text)
+        return await DSLCompiler.decompile(json_obj)
+
+    @staticmethod
+    def _format_error(error: Exception) -> FormattedError:
+        """Format error for user-friendly display."""
+        formatted = FormattedError(
+            message=str(error) or 'Unknown error',
+        )
+
+        location = getattr(error, 'location', None)
+        if location is not None:
+            formatted.line = getattr(location, 'line', None)
+            formatted.column = getattr(location, 'column', None)
+
+        return formatted

kirun_py-3.3.0/src/kirun_py/dsl/lexer/__init__.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from kirun_py.dsl.lexer.dsl_token import DSLTokenType, SourceLocation, DSLToken
+from kirun_py.dsl.lexer.keywords import KEYWORDS, BLOCK_NAMES, PRIMITIVE_TYPES, is_keyword, is_block_name, is_primitive_type
+from kirun_py.dsl.lexer.lexer_error import LexerError
+from kirun_py.dsl.lexer.dsl_lexer import DSLLexer
+
+__all__ = [
+    'DSLTokenType', 'SourceLocation', 'DSLToken',
+    'KEYWORDS', 'BLOCK_NAMES', 'PRIMITIVE_TYPES',
+    'is_keyword', 'is_block_name', 'is_primitive_type',
+    'LexerError',
+    'DSLLexer',
+]