opencloudtool 0.4.1__cp312-abi3-macosx_11_0_arm64.whl

oct/__init__.py

@@ -0,0 +1,3 @@
+from .py_api import deploy, destroy
+
+__all__ = ["deploy", "destroy"]

oct/py_api.py

@@ -0,0 +1,66 @@
+import os
+
+import logging
+from ._internal import deploy as _rust_deploy
+from ._internal import destroy as _rust_destroy
+from ._internal import init_logging as _rust_init_logging
+
+# A flag to ensure we only initialize the logger once per session.
+_logging_initialized = False
+
+logger = logging.getLogger(name=__name__)
+
+
+def init_logging():
+    """
+    Initializes the Rust logging system to show logs in the console.
+
+    This is called automatically by other functions like `deploy`,
+    so you don't typically need to call it yourself.
+    """
+    global _logging_initialized
+    if not _logging_initialized:
+        _rust_init_logging()
+        _logging_initialized = True
+
+
+def deploy(path: str = "."):
+    """
+    Deploys the application using the Rust core orchestrator.
+
+    Args:
+        path (str): The path to the project directory containing the
+                    `oct.toml` file. Defaults to the current directory.
+    """
+
+    init_logging()
+    project_path = os.path.abspath(path)
+    logger.info("[Python] Triggering deployment")
+
+    try:
+        _rust_deploy(project_path)
+        logger.info("[Python] Deployment call completed successfully.")
+    except (RuntimeError, IOError) as e:
+        logger.exception(f"[Python] An error occurred during deployment: {e}")
+        raise
+
+
+def destroy(path: str = "."):
+    """
+    Destroys the application using the Rust core orchestrator.
+
+    Args:
+        path (str): The path to the project directory containing the
+                    `oct.toml` file. Defaults to the current directory.
+    """
+
+    init_logging()
+    project_path = os.path.abspath(path)
+    logger.info("[Python] Triggering destroy")
+
+    try:
+        _rust_destroy(project_path)
+        logger.info("[Python] Destroy call completed successfully.")
+    except (RuntimeError, IOError) as e:
+        logger.exception(f"[Python] An error occurred during destroy process: {e}")
+        raise

opencloudtool-0.4.1.dist-info/METADATA

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: opencloudtool
+Version: 0.4.1
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# Deploy as Python library
+
+This guide explains how to set up the environment and use the `oct` Python library.
+
+## How it works: Python-Rust binding
+
+### The connection between Python and Rust is managed by `maturin` and `PyO3`
+
+1. `maturin` compiles the Rust code in the `oct-py` crate into a native Python module.
+2. We configure the name of this compiled module in `pyproject.toml` to be `oct._internal`.
+3. The leading underscore (`_`) is a standard Python convention that signals that `_internal` is a low-level module not meant for direct use.
+4. Our user-facing Python code in `oct/py_api.py` imports functions from `_internal` and presents them as a clean, stable API.
+
+### 1. Navigate to the Python Directory
+
+```bash
+cd crates/oct-py
+```
+
+### 2. Create and activate the Virtual environment
+
+```bash
+uv venv
+
+source .venv/bin/activate # Windows: .venv\Scripts\activate
+```
+
+### 3. Install dependencies
+
+```bash
+uv sync --group dev
+```
+
+### 4. Build the Library
+
+```bash
+maturin develop
+```
+
+### 5. Run the example
+
+```bash
+cd ../../examples/projects/single-host-python-lib
+```
+
+### Deploy
+
+```bash
+python deploy.py
+```
+
+### Destroy
+
+```bash
+python destroy.py
+```
+

opencloudtool-0.4.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+oct/__init__.py,sha256=cVgWz8MCSsEMOTM-ux2RJfaoajdMWJ3xi0gC0PmjoSM,69
+oct/__pycache__/__init__.cpython-310.pyc,sha256=ADfK-61LEgkv-N5Q7FJe6eOajUMi-W-siUJmLfqeI_U,259
+oct/__pycache__/__init__.cpython-312.pyc,sha256=z-OusomA0T5gb6RlmK9XXZaPNSkegINDKd3mLD6fJ0Q,281
+oct/__pycache__/py_api.cpython-310.pyc,sha256=pTgRDeHXYAZQH_MHVxpl86W-X6Wyfs_WDoEsz06Mlhc,1949
+oct/__pycache__/py_api.cpython-312.pyc,sha256=CqXj9UrQSA6LELP8_18MjmIvmgwSKr14uThmtipDEY4,2753
+oct/_internal.abi3.so,sha256=5NYEINUCB2re2vRE0zsqv0yOfYqZU7M39D6n7lrX0NU,35502944
+oct/py_api.py,sha256=F1_LxrmlfRMMjLqUTdyN3oLH4gngA_Pr6v00TLp7_WM,1924
+opencloudtool-0.4.1.dist-info/METADATA,sha256=SdKoYeLkPu7IRM3tNbCc0e_WzZBDc_PLtVWAaGZbQu8,1323
+opencloudtool-0.4.1.dist-info/WHEEL,sha256=pwIk_YVe3uDmt-QV5nznwGvt6Ys6jyf64oBs53DU5Sk,103
+opencloudtool-0.4.1.dist-info/RECORD,,

opencloudtool-0.4.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.9.3)
+Root-Is-Purelib: false
+Tag: cp312-abi3-macosx_11_0_arm64