codex-python 0.1.0__tar.gz

codex_python-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+permissions:
+  contents: read
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: latest
+
+      - name: Lint
+        run: make lint
+
+      - name: Test
+        run: make test
+

codex_python-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: latest
+
+      - name: Build distribution
+        run: uv build
+
+      - name: Publish to PyPI
+        env:
+          PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: uv publish --token "$PYPI_API_TOKEN"

codex_python-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+.python-version
+
+# Tooling
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+.tox/
+.nox/
+.DS_Store
+
+# uv
+.uv/
+uv.lock

codex_python-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,19 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.5.6
+    hooks:
+      - id: ruff
+        args: ["--fix"]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.10.0
+    hooks:
+      - id: mypy
+        additional_dependencies: []
+

codex_python-0.1.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+% Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
+
+## [0.1.0] - 2025-09-10
+### Added
+- Initial project scaffold with Python 3.13+
+- Packaging with Hatchling and uv build/publish
+- CI workflow (lint + test)
+- Publishing workflow on `v*` tags
+- Dev tooling: ruff, pytest, mypy, Makefile
+- Typing marker (`py.typed`)
+- MIT License
+
+[0.1.0]: https://github.com/gersmann/codex-python/releases/tag/v0.1.0

codex_python-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,34 @@
+% Code of Conduct
+
+We follow the Contributor Covenant Code of Conduct. By participating, you are expected to uphold this code.
+
+## Our Pledge
+In the interest of fostering an open and welcoming environment, we pledge to make participation in our project and community a harassment-free experience for everyone.
+
+## Our Standards
+Examples of behavior that contributes to creating a positive environment include:
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior include:
+- The use of sexualized language or imagery and unwelcome sexual attention or advances
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others’ private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+## Scope
+This Code of Conduct applies within project spaces and in public spaces when an individual is representing the project or its community.
+
+## Enforcement
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported via GitHub issues. All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances.
+
+## Attribution
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org) version 2.1.
+

codex_python-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,54 @@
+% Contributing to codex-python
+
+Thanks for considering a contribution! This guide helps you get set up and make changes smoothly.
+
+## Prerequisites
+- Python 3.13+
+- [uv](https://docs.astral.sh/uv/) installed
+- `make` available (optional but recommended)
+
+## Quick Start
+```
+# Create an isolated environment (optional)
+uv venv --python 3.13
+. .venv/bin/activate  # Windows: .venv\Scripts\activate
+
+# Install dev tools when running via uv
+make lint   # ruff + mypy (installs on first run)
+make test   # pytest
+```
+
+## Project Tasks
+- Lint: `make lint`
+- Format: `make fmt`
+- Tests: `make test`
+- Build: `uv build`
+
+## Type Hints
+This project is typed and ships a `py.typed` marker. Please keep public APIs typed.
+
+## Commit Style
+- Keep commits focused.
+- Reference issues where applicable, e.g., `Fixes #123`.
+
+## Release Process
+1. Update the version in `codex/__init__.py` (SemVer).
+2. Update `CHANGELOG.md`.
+3. Merge to `main`.
+4. Tag the release: `git tag -a vX.Y.Z -m "vX.Y.Z" && git push --tags`.
+5. GitHub Actions (publish workflow) will build and publish to PyPI on `v*` tags.
+
+## Pre-commit (optional but recommended)
+```
+uvx pre-commit install
+uvx pre-commit run --all-files
+```
+
+If you prefer, you can install pre-commit globally via `pipx` or `pip`.
+
+## Reporting Issues
+Please open an issue with reproduction steps, expected vs actual behavior, and environment info.
+
+## Code of Conduct
+By participating, you agree to abide by our [Code of Conduct](CODE_OF_CONDUCT.md).
+

codex_python-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 gersmann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

codex_python-0.1.0/Makefile

@@ -0,0 +1,37 @@
+.PHONY: help venv fmt lint test build publish clean
+
+help:
+	@echo "Common targets:"
+	@echo "  make lint     - Run ruff and mypy"
+	@echo "  make test     - Run pytest"
+	@echo "  make build    - Build sdist and wheel with uv"
+	@echo "  make publish  - Publish to PyPI via uv (uses PYPI_API_TOKEN)"
+	@echo "  make clean    - Remove build artifacts"
+
+venv:
+	uv venv --python 3.13
+	@echo "Run: . .venv/bin/activate"
+
+fmt:
+	uv run --group dev ruff format .
+
+lint:
+	uv run --group dev ruff format --check .
+	uv run --group dev ruff check .
+	uv run --group dev mypy codex
+
+test:
+	uv run --group dev pytest
+
+build:
+	uv build
+
+publish: build
+	@if [ -z "$${PYPI_API_TOKEN}" ]; then \
+		echo "PYPI_API_TOKEN is not set"; \
+		exit 1; \
+	fi
+	uv publish --token "$$PYPI_API_TOKEN"
+
+clean:
+	rm -rf build dist *.egg-info .pytest_cache .mypy_cache .ruff_cache

codex_python-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: codex-python
+Version: 0.1.0
+Summary: A minimal Python library scaffold for codex-python
+Project-URL: Homepage, https://github.com/gersmann/codex-python
+Project-URL: Repository, https://github.com/gersmann/codex-python
+Project-URL: Issues, https://github.com/gersmann/codex-python/issues
+License: MIT License
+        
+        Copyright (c) 2025 gersmann
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+License-File: LICENSE
+Keywords: codex,library,scaffold
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# codex-python
+
+A minimal Python library scaffold using `uv` with Python 3.13+.
+
+## Quickstart
+
+- Requires Python 3.13+.
+- Package import name: `codex`.
+- Distribution name (PyPI): `codex-python`.
+
+### Repo
+
+- Git: `git@github.com:gersmann/codex-python.git`
+- URL: https://github.com/gersmann/codex-python
+
+## Usage
+
+Basic non-interactive execution via Codex CLI:
+
+```
+from codex import run_exec
+
+out = run_exec("explain this repo")
+print(out)
+```
+
+Options:
+
+- Choose model: `run_exec("...", model="gpt-4.1")`
+- Full auto: `run_exec("scaffold a cli", full_auto=True)`
+- Run in another dir: `run_exec("...", cd="/path/to/project")`
+
+Using a client with defaults:
+
+```
+from codex import CodexClient
+
+client = CodexClient(model="gpt-4.1", full_auto=True)
+print(client.run("explain this repo"))
+```
+
+### Install uv
+
+- macOS (Homebrew): `brew install uv`
+- Or via install script:
+  - Unix/macOS: `curl -LsSf https://astral.sh/uv/install.sh | sh`
+  - Windows (PowerShell): `iwr https://astral.sh/uv/install.ps1 -UseBasicParsing | iex`
+
+See: https://docs.astral.sh/uv/
+
+### Create a virtual env (optional)
+
+```
+uv python install 3.13
+uv venv --python 3.13
+. .venv/bin/activate  # or .venv\Scripts\activate on Windows
+```
+
+### Build
+
+```
+uv build
+```
+
+Artifacts appear in `dist/` (`.whl` and `.tar.gz`).
+
+### Publish to PyPI
+
+- Manual:
+
+```
+export PYPI_API_TOKEN="pypi-XXXX"  # create at https://pypi.org/manage/account/token/
+uv publish --token "$PYPI_API_TOKEN"
+```
+
+- GitHub Actions: add a repository secret `PYPI_API_TOKEN` and push a tag like `v0.1.0`.
+  The workflow at `.github/workflows/publish.yml` builds and publishes with `uv` on `v*` tags.
+
+### Dev tooling
+
+- Lint: `make lint` (ruff + mypy)
+- Tests: `make test` (pytest)
+- Format: `make fmt` (ruff formatter)
+ - Pre-commit: `uvx pre-commit install && uvx pre-commit run --all-files`
+
+## Project Layout
+
+```
+.
+├── codex/              # package root (import name: codex)
+│   └── __init__.py     # version lives here
+├── pyproject.toml      # PEP 621 metadata, hatchling build backend
+├── README.md
+└── .gitignore
+```
+
+## Versioning
+
+Version is managed via `codex/__init__.py` and exposed as `__version__`. The build uses Hatch’s version source.
+
+## Python Compatibility
+
+- Requires Python `>=3.13`.

codex_python-0.1.0/README.md

@@ -0,0 +1,103 @@
+# codex-python
+
+A minimal Python library scaffold using `uv` with Python 3.13+.
+
+## Quickstart
+
+- Requires Python 3.13+.
+- Package import name: `codex`.
+- Distribution name (PyPI): `codex-python`.
+
+### Repo
+
+- Git: `git@github.com:gersmann/codex-python.git`
+- URL: https://github.com/gersmann/codex-python
+
+## Usage
+
+Basic non-interactive execution via Codex CLI:
+
+```
+from codex import run_exec
+
+out = run_exec("explain this repo")
+print(out)
+```
+
+Options:
+
+- Choose model: `run_exec("...", model="gpt-4.1")`
+- Full auto: `run_exec("scaffold a cli", full_auto=True)`
+- Run in another dir: `run_exec("...", cd="/path/to/project")`
+
+Using a client with defaults:
+
+```
+from codex import CodexClient
+
+client = CodexClient(model="gpt-4.1", full_auto=True)
+print(client.run("explain this repo"))
+```
+
+### Install uv
+
+- macOS (Homebrew): `brew install uv`
+- Or via install script:
+  - Unix/macOS: `curl -LsSf https://astral.sh/uv/install.sh | sh`
+  - Windows (PowerShell): `iwr https://astral.sh/uv/install.ps1 -UseBasicParsing | iex`
+
+See: https://docs.astral.sh/uv/
+
+### Create a virtual env (optional)
+
+```
+uv python install 3.13
+uv venv --python 3.13
+. .venv/bin/activate  # or .venv\Scripts\activate on Windows
+```
+
+### Build
+
+```
+uv build
+```
+
+Artifacts appear in `dist/` (`.whl` and `.tar.gz`).
+
+### Publish to PyPI
+
+- Manual:
+
+```
+export PYPI_API_TOKEN="pypi-XXXX"  # create at https://pypi.org/manage/account/token/
+uv publish --token "$PYPI_API_TOKEN"
+```
+
+- GitHub Actions: add a repository secret `PYPI_API_TOKEN` and push a tag like `v0.1.0`.
+  The workflow at `.github/workflows/publish.yml` builds and publishes with `uv` on `v*` tags.
+
+### Dev tooling
+
+- Lint: `make lint` (ruff + mypy)
+- Tests: `make test` (pytest)
+- Format: `make fmt` (ruff formatter)
+ - Pre-commit: `uvx pre-commit install && uvx pre-commit run --all-files`
+
+## Project Layout
+
+```
+.
+├── codex/              # package root (import name: codex)
+│   └── __init__.py     # version lives here
+├── pyproject.toml      # PEP 621 metadata, hatchling build backend
+├── README.md
+└── .gitignore
+```
+
+## Versioning
+
+Version is managed via `codex/__init__.py` and exposed as `__version__`. The build uses Hatch’s version source.
+
+## Python Compatibility
+
+- Requires Python `>=3.13`.

codex_python-0.1.0/codex/__init__.py

@@ -0,0 +1,30 @@
+"""codex
+
+Python interface for the Codex CLI.
+
+Usage:
+    from codex import run_exec
+    output = run_exec("explain this codebase to me")
+"""
+
+from .api import (
+    CodexClient,
+    CodexError,
+    CodexNotFoundError,
+    CodexProcessError,
+    find_binary,
+    run_exec,
+)
+
+__all__ = [
+    "__version__",
+    "CodexError",
+    "CodexNotFoundError",
+    "CodexProcessError",
+    "CodexClient",
+    "find_binary",
+    "run_exec",
+]
+
+# Managed by Hatch via pyproject.toml [tool.hatch.version]
+__version__ = "0.1.0"

codex_python-0.1.0/codex/api.py

@@ -0,0 +1,165 @@
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+from collections.abc import Iterable, Mapping, Sequence
+from dataclasses import dataclass
+
+
+class CodexError(Exception):
+    """Base exception for codex-python."""
+
+
+class CodexNotFoundError(CodexError):
+    """Raised when the 'codex' binary cannot be found or executed."""
+
+    def __init__(self, executable: str = "codex") -> None:
+        super().__init__(
+            f"Codex CLI not found: '{executable}'.\n"
+            "Install from https://github.com/openai/codex or ensure it is on PATH."
+        )
+        self.executable = executable
+
+
+@dataclass(slots=True)
+class CodexProcessError(CodexError):
+    """Raised when the codex process exits with a non‑zero status."""
+
+    returncode: int
+    cmd: Sequence[str]
+    stdout: str
+    stderr: str
+
+    def __str__(self) -> str:  # pragma: no cover - repr is sufficient
+        return (
+            f"Codex process failed with exit code {self.returncode}.\n"
+            f"Command: {' '.join(self.cmd)}\n"
+            f"stderr:\n{self.stderr.strip()}"
+        )
+
+
+def find_binary(executable: str = "codex") -> str:
+    """Return the absolute path to the Codex CLI binary or raise if not found."""
+    path = shutil.which(executable)
+    if not path:
+        raise CodexNotFoundError(executable)
+    return path
+
+
+def run_exec(
+    prompt: str,
+    *,
+    model: str | None = None,
+    full_auto: bool = False,
+    cd: str | None = None,
+    timeout: float | None = None,
+    env: Mapping[str, str] | None = None,
+    executable: str = "codex",
+    extra_args: Iterable[str] | None = None,
+) -> str:
+    """
+    Run `codex exec` with the given prompt and return stdout as text.
+
+    - Raises CodexNotFoundError if the binary is unavailable.
+    - Raises CodexProcessError on non‑zero exit with captured stdout/stderr.
+    """
+    bin_path = find_binary(executable)
+
+    cmd: list[str] = [bin_path]
+
+    if cd:
+        cmd.extend(["--cd", cd])
+    if model:
+        cmd.extend(["-m", model])
+    if full_auto:
+        cmd.append("--full-auto")
+    if extra_args:
+        cmd.extend(list(extra_args))
+
+    cmd.extend(["exec", prompt])
+
+    completed = subprocess.run(
+        cmd,
+        capture_output=True,
+        text=True,
+        timeout=timeout,
+        env={**os.environ, **(dict(env) if env else {})},
+        check=False,
+    )
+
+    stdout = completed.stdout or ""
+    stderr = completed.stderr or ""
+    if completed.returncode != 0:
+        raise CodexProcessError(
+            returncode=completed.returncode,
+            cmd=tuple(cmd),
+            stdout=stdout,
+            stderr=stderr,
+        )
+    return stdout
+
+
+@dataclass(slots=True)
+class CodexClient:
+    """Lightweight, synchronous client for the Codex CLI.
+
+    Provides defaults for repeated invocations and convenience helpers.
+    """
+
+    executable: str = "codex"
+    model: str | None = None
+    full_auto: bool = False
+    cd: str | None = None
+    env: Mapping[str, str] | None = None
+    extra_args: Sequence[str] | None = None
+
+    def ensure_available(self) -> str:
+        """Return the resolved binary path or raise CodexNotFoundError."""
+        return find_binary(self.executable)
+
+    def run(
+        self,
+        prompt: str,
+        *,
+        model: str | None = None,
+        full_auto: bool | None = None,
+        cd: str | None = None,
+        timeout: float | None = None,
+        env: Mapping[str, str] | None = None,
+        extra_args: Iterable[str] | None = None,
+    ) -> str:
+        """Execute `codex exec` and return stdout.
+
+        Explicit arguments override the client's defaults.
+        """
+        eff_model = model if model is not None else self.model
+        eff_full_auto = full_auto if full_auto is not None else self.full_auto
+        eff_cd = cd if cd is not None else self.cd
+
+        # Merge environment overlays; run_exec will merge with os.environ
+        merged_env: Mapping[str, str] | None
+        if self.env and env:
+            tmp = dict(self.env)
+            tmp.update(env)
+            merged_env = tmp
+        else:
+            merged_env = env or self.env
+
+        # Compose extra args
+        eff_extra: list[str] = []
+        if self.extra_args:
+            eff_extra.extend(self.extra_args)
+        if extra_args:
+            eff_extra.extend(list(extra_args))
+
+        return run_exec(
+            prompt,
+            model=eff_model,
+            full_auto=eff_full_auto,
+            cd=eff_cd,
+            timeout=timeout,
+            env=merged_env,
+            executable=self.executable,
+            extra_args=eff_extra,
+        )

codex_python-0.1.0/codex/py.typed

@@ -0,0 +1 @@
+

codex_python-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "codex-python"
+description = "A minimal Python library scaffold for codex-python"
+readme = "README.md"
+requires-python = ">=3.13"
+keywords = ["codex", "library", "scaffold"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.13",
+  "License :: OSI Approved :: MIT License",
+  "Typing :: Typed",
+  "Operating System :: OS Independent",
+]
+dynamic = ["version"]
+license = { file = "LICENSE" }
+
+[project.urls]
+Homepage = "https://github.com/gersmann/codex-python"
+Repository = "https://github.com/gersmann/codex-python"
+Issues = "https://github.com/gersmann/codex-python/issues"
+
+[tool.hatch.version]
+path = "codex/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["codex"]
+force-include = { "codex/py.typed" = "codex/py.typed" }
+
+# Development dependency groups (used by uv)
+[dependency-groups]
+dev = [
+  "ruff>=0.5",
+  "pytest>=8",
+  "mypy>=1.10",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py313"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]
+ignore = []
+
+[tool.pytest.ini_options]
+addopts = "-q"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+
+[tool.mypy]
+python_version = "3.13"
+warn_return_any = true
+warn_unused_ignores = true
+disallow_untyped_defs = true
+no_implicit_optional = true
+check_untyped_defs = true

codex_python-0.1.0/tests/test_api.py

@@ -0,0 +1,27 @@
+import os
+import stat
+from pathlib import Path
+
+import pytest
+
+from codex.api import CodexNotFoundError, run_exec
+
+
+def test_missing_binary_raises():
+    with pytest.raises(CodexNotFoundError):
+        run_exec("hello", executable="codex-does-not-exist-xyz")
+
+
+def test_runs_with_dummy_binary(tmp_path: Path, monkeypatch: pytest.MonkeyPatch):
+    # Create a dummy 'codex' executable that echoes args and succeeds
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir()
+    codex_path = bin_dir / "codex"
+    codex_path.write_text("""#!/bin/sh\necho \"[dummy] $@\"\n""")
+    codex_path.chmod(codex_path.stat().st_mode | stat.S_IXUSR)
+
+    # Prepend our dummy bin to PATH
+    monkeypatch.setenv("PATH", f"{bin_dir}{os.pathsep}" + os.environ.get("PATH", ""))
+
+    out = run_exec("hello world", executable="codex")
+    assert "[dummy] exec hello world" in out

codex_python-0.1.0/tests/test_client.py

@@ -0,0 +1,37 @@
+import os
+import stat
+from pathlib import Path
+
+import pytest
+
+from codex import CodexClient, CodexNotFoundError
+
+
+def test_client_missing_binary():
+    client = CodexClient(executable="codex-does-not-exist-xyz")
+    with pytest.raises(CodexNotFoundError):
+        client.ensure_available()
+    with pytest.raises(CodexNotFoundError):
+        client.run("hello")
+
+
+def test_client_runs_with_defaults(tmp_path: Path, monkeypatch: pytest.MonkeyPatch):
+    # Dummy codex that echoes args and succeeds
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir()
+    codex_path = bin_dir / "codex"
+    codex_path.write_text("""#!/bin/sh\necho \"[dummy] $@\"\n""")
+    codex_path.chmod(codex_path.stat().st_mode | stat.S_IXUSR)
+
+    monkeypatch.setenv("PATH", f"{bin_dir}{os.pathsep}" + os.environ.get("PATH", ""))
+
+    client = CodexClient(model="test-model", full_auto=True, extra_args=["--ask-for-approval"])
+    out = client.run("hello world")
+
+    # Ensure key flags and prompt are passed along; order-insensitive
+    assert "[dummy]" in out
+    assert "exec" in out
+    assert "hello world" in out
+    assert "--full-auto" in out
+    assert "-m test-model" in out
+    assert "--ask-for-approval" in out

codex_python-0.1.0/tests/test_version.py

@@ -0,0 +1,7 @@
+import re
+
+
+def test_version_semver():
+    from codex import __version__
+
+    assert re.match(r"^\d+\.\d+\.\d+(?:[.-][A-Za-z0-9.]+)?$", __version__), __version__