grctl-sdk-python 0.1.0__tar.gz

grctl_sdk_python-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: grctl-sdk-python
+Version: 0.1.0
+Summary: The Python SDK for the grctl platform
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: nats-py>=2.7.0
+Requires-Dist: msgspec>=0.18.0
+Requires-Dist: python-ulid>=2.0.0
+Requires-Dist: pydantic-settings>=2.11.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: pydantic>=2.12.5
+
+# Ground Control Python SDK
+
+The official Python SDK for [Ground Control](https://github.com/cemevren/grctl) — a lightweight workflow orchestration engine built for fail-safe execution.
+
+**[Documentation](https://cemevren.github.io/grctl/)**
+
+> [!WARNING]
+> **Status: Pre-alpha**
+> The API is currently unstable and subject to change.
+
+## Installation
+
+```bash
+pip install grctl-sdk-python
+```
+
+## Requirements
+
+- Python 3.13 or later
+- A running Ground Control server (`grctld`)
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](https://github.com/cemevren/grctl/blob/main/CONTRIBUTING.md) for more information.
+
+## Security
+
+Please see our [Security Policy](https://github.com/cemevren/grctl/blob/main/SECURITY.md) for reporting vulnerabilities.
+
+## License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/cemevren/grctl/blob/main/LICENSE) file for details.

grctl_sdk_python-0.1.0/README.md

@@ -0,0 +1,32 @@
+# Ground Control Python SDK
+
+The official Python SDK for [Ground Control](https://github.com/cemevren/grctl) — a lightweight workflow orchestration engine built for fail-safe execution.
+
+**[Documentation](https://cemevren.github.io/grctl/)**
+
+> [!WARNING]
+> **Status: Pre-alpha**
+> The API is currently unstable and subject to change.
+
+## Installation
+
+```bash
+pip install grctl-sdk-python
+```
+
+## Requirements
+
+- Python 3.13 or later
+- A running Ground Control server (`grctld`)
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](https://github.com/cemevren/grctl/blob/main/CONTRIBUTING.md) for more information.
+
+## Security
+
+Please see our [Security Policy](https://github.com/cemevren/grctl/blob/main/SECURITY.md) for reporting vulnerabilities.
+
+## License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/cemevren/grctl/blob/main/LICENSE) file for details.

grctl_sdk_python-0.1.0/grctl/__init__.py

@@ -0,0 +1 @@
+"""Ground Control Python SDK package."""

grctl_sdk_python-0.1.0/grctl/logging_config.py

@@ -0,0 +1,50 @@
+"""Custom logging configuration for Ground Control."""
+
+import logging
+import sys
+
+
+class CustomFormatter(logging.Formatter):
+    def format(self, record: logging.LogRecord) -> str:
+        # Format: LEVEL TIME METHOD:LINE_NUM MESSAGE
+        timestamp = self.formatTime(record, "%H:%M:%S")
+
+        level = record.levelname
+
+        # Get class/function context
+        context = f"{record.module}"
+        if record.funcName != "<module>":
+            context = f"{context}.{record.funcName}:{record.lineno}"
+
+        # Format the message
+        msg = f"{level} {timestamp} [{context}] {record.getMessage()}"
+
+        # Add exception info if present
+        if record.exc_info:
+            msg += "\n" + self.formatException(record.exc_info)
+
+        return msg
+
+
+def setup_logging(level: int = logging.INFO) -> None:
+    """Configure root logger with custom formatter."""
+    handler = logging.StreamHandler(sys.stdout)
+    handler.setLevel(level)
+
+    formatter = CustomFormatter()
+    handler.setFormatter(formatter)
+
+    root_logger = logging.getLogger()
+    root_logger.setLevel(level)
+    root_logger.addHandler(handler)
+
+
+def get_logger(name: str) -> logging.Logger:
+    """Get a logger instance with the custom formatter already configured."""
+    logger = logging.getLogger(name)
+
+    # Set logger level to DEBUG to allow all messages through
+    # Actual filtering happens at handler level
+    logger.setLevel(logging.DEBUG)
+
+    return logger

grctl_sdk_python-0.1.0/grctl/settings.py

@@ -0,0 +1,22 @@
+from functools import lru_cache
+
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class EngineSettings(BaseSettings):
+    nats_servers: list[str] = ["nats://localhost:4225"]
+    nats_connect_timeout: float = 2.0
+    nats_request_timeout: float = 5.0
+    nats_max_reconnect_attempts: int = 10
+    nats_reconnect_time_wait: float = 2.0
+    nats_worker_ack_wait: float = 5.0
+
+    model_config = SettingsConfigDict(
+        env_prefix="ENGINE_",
+    )
+
+
+@lru_cache
+def get_settings() -> EngineSettings:
+    """Get engine settings from environment variables."""
+    return EngineSettings()

grctl_sdk_python-0.1.0/grctl_sdk_python.egg-info/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: grctl-sdk-python
+Version: 0.1.0
+Summary: The Python SDK for the grctl platform
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: nats-py>=2.7.0
+Requires-Dist: msgspec>=0.18.0
+Requires-Dist: python-ulid>=2.0.0
+Requires-Dist: pydantic-settings>=2.11.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: pydantic>=2.12.5
+
+# Ground Control Python SDK
+
+The official Python SDK for [Ground Control](https://github.com/cemevren/grctl) — a lightweight workflow orchestration engine built for fail-safe execution.
+
+**[Documentation](https://cemevren.github.io/grctl/)**
+
+> [!WARNING]
+> **Status: Pre-alpha**
+> The API is currently unstable and subject to change.
+
+## Installation
+
+```bash
+pip install grctl-sdk-python
+```
+
+## Requirements
+
+- Python 3.13 or later
+- A running Ground Control server (`grctld`)
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](https://github.com/cemevren/grctl/blob/main/CONTRIBUTING.md) for more information.
+
+## Security
+
+Please see our [Security Policy](https://github.com/cemevren/grctl/blob/main/SECURITY.md) for reporting vulnerabilities.
+
+## License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/cemevren/grctl/blob/main/LICENSE) file for details.

grctl_sdk_python-0.1.0/grctl_sdk_python.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+grctl/__init__.py
+grctl/logging_config.py
+grctl/settings.py
+grctl_sdk_python.egg-info/PKG-INFO
+grctl_sdk_python.egg-info/SOURCES.txt
+grctl_sdk_python.egg-info/dependency_links.txt
+grctl_sdk_python.egg-info/requires.txt
+grctl_sdk_python.egg-info/top_level.txt

grctl_sdk_python-0.1.0/grctl_sdk_python.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

grctl_sdk_python-0.1.0/grctl_sdk_python.egg-info/requires.txt

@@ -0,0 +1,6 @@
+nats-py>=2.7.0
+msgspec>=0.18.0
+python-ulid>=2.0.0
+pydantic-settings>=2.11.0
+pyyaml>=6.0.3
+pydantic>=2.12.5

grctl_sdk_python-0.1.0/grctl_sdk_python.egg-info/top_level.txt

@@ -0,0 +1 @@
+grctl

grctl_sdk_python-0.1.0/pyproject.toml

@@ -0,0 +1,93 @@
+[project]
+name = "grctl-sdk-python"
+version = "0.1.0"
+description = "The Python SDK for the grctl platform"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "nats-py>=2.7.0",
+    "msgspec>=0.18.0",
+    "python-ulid>=2.0.0",
+    "pydantic-settings>=2.11.0",
+    "pyyaml>=6.0.3",
+    "pydantic>=2.12.5",
+]
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.407",
+    "pytest>=9.0.2",
+    "pytest-asyncio>=1.2.0",
+    "ruff>=0.15.9",
+]
+
+
+[tool.uv]
+package = true
+
+[tool.setuptools]
+packages = ["grctl"]
+
+[tool.pytest.ini_options]
+addopts = "--ignore=tests/examples --ignore=tests/e2e"
+testpaths = ["tests"]
+log_cli = true
+log_cli_level = "DEBUG"
+pythonpath = "."
+asyncio_mode = "auto"
+markers = [
+    "integration: marks tests as integration tests",
+]
+
+
+[tool.ruff]
+line-length = 120
+
+lint.select = ["ALL"] # Include all the rules, including new ones
+lint.ignore = [
+    "BLE001",
+    "ANN401", # Dynamically typed expressions (typing.Any) are disallowed
+    "COM812",
+    "D100",
+    "D101",
+    "D102",
+    "D103",
+    "D105",
+    "D107",
+    "D203",
+    "D211",
+    "D213",
+    "EM101",
+    "EM102",
+    "G004",
+    "TRY003",
+    "TC001",
+    "TC003",
+    "S324",
+
+]
+[tool.ruff.lint.extend-per-file-ignores]
+# Specific rules to ignore for tests
+"tests/**/*.py" = [
+    "S101",   # Allow assert in tests
+    "ANN001", # Allow missing type annotations in tests
+    "ANN201", # Allow missing type annotations in tests
+    "ANN202", # Allow missing return type annotations in tests
+    "ANN204", # Allow missing type annotations for self and cls in tests
+    "ARG",    # Unused function args for fixtures
+    "COM812",
+    "FBT",    # Don't care about booleans as positional arguments in tests for @pytest.mark.parametrize
+    "INP001", # Ignore that its not in a real python module. Doesn't matter for tests
+    # The below are debateable
+    "PLR2004", # Magic value used in comparison, ...
+    "S311",    # Standard pseudo-random generators are not suitable for cryptographic purposes
+    "ERA001",  # Commented out code
+    "F841",    # Unused variable
+    "PGH003",
+    "SLF001", # Private member accessed outside of class
+    "TRY002", # Create your own exception classes
+]
+
+"grctl/models/**/*.py" = [
+    "ERA001", # Commented out code
+]

grctl_sdk_python-0.1.0/setup.cfg

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