perceptic-core-client 0.5.0__tar.gz

perceptic_core_client-0.5.0/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include scripts *

perceptic_core_client-0.5.0/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: perceptic-core-client
+Version: 0.5.0
+Summary: Python client for Perceptic Core
+Author-email: Your Name <you@example.com>
+License: Proprietary
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: urllib3<3.0.0,>=2.1.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pydantic>=2
+Requires-Dist: typing-extensions>=4.7.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: requests; extra == "dev"
+
+# Perceptic Core Python Client
+
+This package provides a Python client for the Perceptic Core API.
+
+## Installation
+
+(Instructions will be added once packaging is set up)
+
+## Usage
+
+(Example usage will be added)
+
+## Building
+
+This package requires Java and `openapi-generator-cli` to be installed for the build process, as it generates the client code from the OpenAPI specification during the build.
+
+(Detailed build instructions will be added)

perceptic_core_client-0.5.0/README.md

@@ -0,0 +1,17 @@
+# Perceptic Core Python Client
+
+This package provides a Python client for the Perceptic Core API.
+
+## Installation
+
+(Instructions will be added once packaging is set up)
+
+## Usage
+
+(Example usage will be added)
+
+## Building
+
+This package requires Java and `openapi-generator-cli` to be installed for the build process, as it generates the client code from the OpenAPI specification during the build.
+
+(Detailed build instructions will be added)

perceptic_core_client-0.5.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires      = ["setuptools>=68", "wheel"]   # or hatchling / poetry-core / flit-core …
+build-backend = "setuptools.build_meta"
+
+[project]
+name             = "perceptic-core-client"
+version          = "0.5.0"
+description      = "Python client for Perceptic Core"
+authors          = [{name = "Your Name", email = "you@example.com"}]
+readme           = "README.md"
+requires-python  = ">=3.9"
+license          = {text = "Proprietary"}
+classifiers      = ["Programming Language :: Python :: 3"]
+
+# Runtime dependencies
+dependencies = [
+    "urllib3 >= 2.1.0, < 3.0.0",
+    "python-dateutil >= 2.8.2",
+    "pydantic >= 2",
+    "typing-extensions >= 4.7.1",
+]
+
+[project.optional-dependencies]
+# Development dependencies (install with 'pip install -e .[dev]')
+dev = [
+    "pytest",
+    "pytest-cov",
+    "ruff",
+    "mypy",
+    "build",
+    "requests", # Also needed by the generate script itself
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+# Let setup.py handle dynamic versioning via the VERSION file
+[tool.setuptools.dynamic]
+version = { file = "VERSION" }

perceptic_core_client-0.5.0/scripts/generate_client.py

@@ -0,0 +1,143 @@
+import argparse
+import subprocess
+import sys
+import os
+import shutil
+from pathlib import Path
+import json # For reading version from spec (optional)
+
+# --- Configuration ---
+PACKAGE_NAME = "perceptic_core_client"
+PROJECT_ROOT = Path(__file__).parent.parent.resolve()
+OUTPUT_DIR = PROJECT_ROOT / "src" / PACKAGE_NAME
+VERSION_FILE = PROJECT_ROOT / "VERSION"
+# ---
+
+def check_java():
+    """Checks if Java is installed and accessible."""
+    try:
+        subprocess.run(["java", "-version"], check=True, capture_output=True)
+        print("Java installation found.")
+        return True
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        print("Error: Java Runtime Environment (JRE) not found.", file=sys.stderr)
+        print("openapi-generator-cli requires Java to run.", file=sys.stderr)
+        print("Please install Java and ensure it's in your PATH.", file=sys.stderr)
+        return False
+
+def check_openapi_generator():
+    """Checks if openapi-generator-cli is installed and accessible."""
+    try:
+        subprocess.run(["openapi-generator-cli", "list"], check=True, capture_output=True)
+        print("openapi-generator-cli found.")
+        return True
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        print("Error: openapi-generator-cli not found.", file=sys.stderr)
+        print("Please install it, e.g., using 'npm install @openapitools/openapi-generator-cli -g' or ensure it's in your PATH.", file=sys.stderr)
+        return False
+
+def run_generator(spec_path: Path, output_dir: Path, package_name: str):
+    """Runs the openapi-generator-cli command."""
+    if not spec_path.is_file():
+        print(f"Error: OpenAPI spec file not found at: {spec_path}", file=sys.stderr)
+        return False
+
+    # Ensure output directory exists and is empty
+    if output_dir.exists():
+         print(f"Cleaning existing output directory: {output_dir}")
+         if str(output_dir).startswith(str(PROJECT_ROOT / "src")): # Basic safety check
+             shutil.rmtree(output_dir)
+         else:
+             print(f"Error: Output directory {output_dir} seems unsafe to remove.", file=sys.stderr)
+             return False
+    output_dir.mkdir(parents=True)
+    (output_dir / "__init__.py").touch() # Make it a package immediately
+
+    additional_props = f"projectName={package_name},useOneOfDiscriminatorLookup=true,generateSourceCodeOnly=true,packageName={package_name}"
+
+    command = [
+        "openapi-generator-cli", "generate",
+        "-g", "python",
+        "-i", str(spec_path),
+        "-o", str(output_dir),
+        # "--package-name", package_name, # Handled by additional props
+        "--skip-validate-spec",
+        "--additional-properties", additional_props
+    ]
+
+    print(f"Running generator command: {' '.join(command)}")
+    try:
+        process = subprocess.run(command, check=True, capture_output=True, text=True)
+        print("Generator output:")
+        print(process.stdout)
+        if process.stderr:
+             print("Generator errors/warnings:", file=sys.stderr)
+             print(process.stderr, file=sys.stderr)
+        print("Client generation successful.")
+        # Optionally read version from spec if --version wasn't provided
+        # spec_content = json.loads(spec_path.read_text())
+        # version_from_spec = spec_content.get("info", {}).get("version")
+        # print(f"Version found in spec: {version_from_spec}") # For info only
+        return True
+    except subprocess.CalledProcessError as e:
+        print(f"Error running openapi-generator-cli: {e}", file=sys.stderr)
+        print("Command output:", file=sys.stderr)
+        print(e.stdout, file=sys.stderr)
+        print(e.stderr, file=sys.stderr)
+        return False
+    except FileNotFoundError:
+         print("Error: 'openapi-generator-cli' command not found. Is it installed and in PATH?", file=sys.stderr)
+         return False
+    except Exception as e: # Catch other potential errors like JSON parsing
+         print(f"An unexpected error occurred during generation: {e}", file=sys.stderr)
+         return False
+
+def write_version_file(version: str, version_file_path: Path):
+    """Writes the version to the VERSION file."""
+    print(f"Writing version '{version}' to {version_file_path}")
+    try:
+        version_file_path.write_text(version.strip() + "\n", encoding='utf-8')
+        return True
+    except IOError as e:
+        print(f"Error writing VERSION file: {e}", file=sys.stderr)
+        return False
+
+def main():
+    parser = argparse.ArgumentParser(description="Generate Python client from a local Perceptic Core OpenAPI spec file.")
+    parser.add_argument(
+        "--spec-path",
+        type=Path,
+        required=True,
+        help="Path to the local OpenAPI specification file (e.g., ../specs/openapi.yaml)"
+    )
+    parser.add_argument(
+        "--version",
+        type=str,
+        required=True,
+        help="The version string to assign to the package (e.g., 0.5.0)"
+    )
+    args = parser.parse_args()
+    spec_path = args.spec_path.resolve() # Get absolute path
+    version = args.version
+
+    print(f"--- Starting client generation from spec: {spec_path} for version: {version} ---")
+
+    # --- Pre-checks ---
+    if not check_java() or not check_openapi_generator():
+        sys.exit(1)
+
+    # --- Generate Client ---
+    if not run_generator(spec_path, OUTPUT_DIR, PACKAGE_NAME):
+         print("Client generation failed.", file=sys.stderr)
+         sys.exit(1)
+
+    # --- Write Version ---
+    if not write_version_file(version, VERSION_FILE):
+         sys.exit(1)
+
+    print(f"--- Client generation completed successfully for version: {version} ---")
+    print(f"Generated client code is in: {OUTPUT_DIR}")
+    print(f"Version file created at: {VERSION_FILE}")
+
+if __name__ == "__main__":
+    main()

perceptic_core_client-0.5.0/setup.cfg

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

perceptic_core_client-0.5.0/setup.py

@@ -0,0 +1,102 @@
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+from setuptools import setup, find_packages
+from setuptools.command.build_py import build_py
+from setuptools.command.egg_info import egg_info
+from setuptools.command.sdist import sdist
+
+# --- Configuration ---
+PROJECT_ROOT = Path(__file__).parent.resolve()
+SCRIPT_PATH = PROJECT_ROOT / "scripts" / "generate_client.py"
+SPEC_ENV_VAR = "OPENAPI_SPEC_PATH"
+VERSION_ENV_VAR = "PACKAGE_VERSION"
+DEFAULT_SPEC_PATH = "specs/openapi.yaml"
+DEFAULT_VERSION = "0.0.0.dev0"
+# ---
+
+def run_generation_script():
+    """Runs the client generation script, getting config from env vars."""
+    spec_path = Path(os.environ.get(SPEC_ENV_VAR, DEFAULT_SPEC_PATH)).resolve()
+    version = os.environ.get(VERSION_ENV_VAR, DEFAULT_VERSION)
+
+    print("--- Running Pre-Build Client Generation ---", flush=True)
+    print(f"Using Spec Path: {spec_path} (Source: {'Env Var' if SPEC_ENV_VAR in os.environ else 'Default'})")
+    print(f"Using Version:   {version} (Source: {'Env Var' if VERSION_ENV_VAR in os.environ else 'Default'})")
+
+    if not SCRIPT_PATH.is_file():
+        print(f"Error: Generation script not found at {SCRIPT_PATH}", file=sys.stderr, flush=True)
+        sys.exit(1)
+
+    if not spec_path.is_file() and SPEC_ENV_VAR not in os.environ:
+         # Only error if the *default* path doesn't exist AND the env var wasn't set
+         # If env var *was* set but file doesn't exist, generate_client.py will error out
+        print(f"Warning: Default spec file '{DEFAULT_SPEC_PATH}' not found and '{SPEC_ENV_VAR}' env var not set.", file=sys.stderr, flush=True)
+        print("Attempting build without generation. This might fail or use stale code.", file=sys.stderr, flush=True)
+        # Decide if you want to fail hard here instead:
+        # sys.exit(1)
+        return # Allow build to proceed, potentially failing later or using old code
+
+    if not spec_path.is_file() and SPEC_ENV_VAR in os.environ:
+         print(f"Warning: Spec file specified via {SPEC_ENV_VAR} ('{spec_path}') not found.", file=sys.stderr, flush=True)
+         print("Attempting build without generation. This might fail or use stale code.", file=sys.stderr, flush=True)
+         # Decide if you want to fail hard here instead:
+         # sys.exit(1)
+         return # Allow build to proceed, potentially failing later or using old code
+
+
+    command = [
+        sys.executable, # Use the same python interpreter that's running setup.py
+        str(SCRIPT_PATH),
+        "--spec-path", str(spec_path),
+        "--version", version
+    ]
+
+    try:
+        print(f"Executing: {' '.join(command)}", flush=True)
+        # Use check=True to raise CalledProcessError on failure
+        subprocess.run(command, check=True, text=True) #, capture_output=True) # capture can hide useful interactive output/errors
+        print("--- Client Generation Script Finished Successfully ---", flush=True)
+    except subprocess.CalledProcessError as e:
+        print("\n--- Client Generation Script Failed ---", file=sys.stderr, flush=True)
+        print(f"Command failed with exit code {e.returncode}", file=sys.stderr, flush=True)
+        # print("STDOUT:", file=sys.stderr, flush=True)
+        # print(e.stdout, file=sys.stderr, flush=True) # Often empty if text=True not fully compatible or error happens early
+        # print("STDERR:", file=sys.stderr, flush=True)
+        # print(e.stderr, file=sys.stderr, flush=True) # stderr might have more info
+        sys.exit(1) # Exit the build process if generation fails
+    except FileNotFoundError:
+         print(f"Error: Could not execute Python interpreter at '{sys.executable}' or script at '{SCRIPT_PATH}'.", file=sys.stderr, flush=True)
+         sys.exit(1)
+
+
+# Custom command classes to ensure generation runs before standard commands
+class CustomBuildPy(build_py):
+    def run(self):
+        run_generation_script()
+        super().run()
+
+class CustomEggInfo(egg_info):
+    def run(self):
+        run_generation_script()
+        super().run()
+
+class CustomSdist(sdist):
+     def run(self):
+        run_generation_script()
+        super().run()
+
+# Run setup() with standard arguments and custom commands
+setup(
+    # Most metadata is now in pyproject.toml
+    packages=find_packages(where='src'),
+    package_dir={'': 'src'},
+    cmdclass={
+        'build_py': CustomBuildPy,
+        'egg_info': CustomEggInfo,
+        'sdist': CustomSdist,
+    },
+    include_package_data=True,
+)

perceptic_core_client-0.5.0/src/perceptic_core_client.egg-info/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: perceptic-core-client
+Version: 0.5.0
+Summary: Python client for Perceptic Core
+Author-email: Your Name <you@example.com>
+License: Proprietary
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: urllib3<3.0.0,>=2.1.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pydantic>=2
+Requires-Dist: typing-extensions>=4.7.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: requests; extra == "dev"
+
+# Perceptic Core Python Client
+
+This package provides a Python client for the Perceptic Core API.
+
+## Installation
+
+(Instructions will be added once packaging is set up)
+
+## Usage
+
+(Example usage will be added)
+
+## Building
+
+This package requires Java and `openapi-generator-cli` to be installed for the build process, as it generates the client code from the OpenAPI specification during the build.
+
+(Detailed build instructions will be added)

perceptic_core_client-0.5.0/src/perceptic_core_client.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+scripts/generate_client.py
+src/perceptic_core_client.egg-info/PKG-INFO
+src/perceptic_core_client.egg-info/SOURCES.txt
+src/perceptic_core_client.egg-info/dependency_links.txt
+src/perceptic_core_client.egg-info/requires.txt
+src/perceptic_core_client.egg-info/top_level.txt

perceptic_core_client-0.5.0/src/perceptic_core_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

perceptic_core_client-0.5.0/src/perceptic_core_client.egg-info/requires.txt

@@ -0,0 +1,12 @@
+urllib3<3.0.0,>=2.1.0
+python-dateutil>=2.8.2
+pydantic>=2
+typing-extensions>=4.7.1
+
+[dev]
+pytest
+pytest-cov
+ruff
+mypy
+build
+requests

perceptic_core_client-0.5.0/src/perceptic_core_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+