codexed 0.0.1__tar.gz

codexed-0.0.1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024, Philipp Temminghoff
+
+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.
+

codexed-0.0.1/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: codexed
+Version: 0.0.1
+Summary: Alternative codex app-server client
+Keywords: 
+Author: Philipp Temminghoff
+Author-email: Philipp Temminghoff <philipptemminghoff@googlemail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Pydantic
+Classifier: Framework :: Pydantic :: 2
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Dist: anyenv>=2.0.15
+Requires-Dist: pydantic
+Requires-Dist: schemez
+Requires-Python: >=3.13
+Project-URL: Code coverage, https://app.codecov.io/gh/phil65/codexed
+Project-URL: Discussions, https://github.com/phil65/codexed/discussions
+Project-URL: Documentation, https://phil65.github.io/codexed/
+Project-URL: Issues, https://github.com/phil65/codexed/issues
+Project-URL: Source, https://github.com/phil65/codexed
+Description-Content-Type: text/markdown
+
+# Codexed
+
+[![PyPI License](https://img.shields.io/pypi/l/codexed.svg)](https://pypi.org/project/codexed/)
+[![Package status](https://img.shields.io/pypi/status/codexed.svg)](https://pypi.org/project/codexed/)
+[![Monthly downloads](https://img.shields.io/pypi/dm/codexed.svg)](https://pypi.org/project/codexed/)
+[![Distribution format](https://img.shields.io/pypi/format/codexed.svg)](https://pypi.org/project/codexed/)
+[![Wheel availability](https://img.shields.io/pypi/wheel/codexed.svg)](https://pypi.org/project/codexed/)
+[![Python version](https://img.shields.io/pypi/pyversions/codexed.svg)](https://pypi.org/project/codexed/)
+[![Implementation](https://img.shields.io/pypi/implementation/codexed.svg)](https://pypi.org/project/codexed/)
+[![Releases](https://img.shields.io/github/downloads/phil65/codexed/total.svg)](https://github.com/phil65/codexed/releases)
+[![Github Contributors](https://img.shields.io/github/contributors/phil65/codexed)](https://github.com/phil65/codexed/graphs/contributors)
+[![Github Discussions](https://img.shields.io/github/discussions/phil65/codexed)](https://github.com/phil65/codexed/discussions)
+[![Github Forks](https://img.shields.io/github/forks/phil65/codexed)](https://github.com/phil65/codexed/forks)
+[![Github Issues](https://img.shields.io/github/issues/phil65/codexed)](https://github.com/phil65/codexed/issues)
+[![Github Issues](https://img.shields.io/github/issues-pr/phil65/codexed)](https://github.com/phil65/codexed/pulls)
+[![Github Watchers](https://img.shields.io/github/watchers/phil65/codexed)](https://github.com/phil65/codexed/watchers)
+[![Github Stars](https://img.shields.io/github/stars/phil65/codexed)](https://github.com/phil65/codexed/stars)
+[![Github Repository size](https://img.shields.io/github/repo-size/phil65/codexed)](https://github.com/phil65/codexed)
+[![Github last commit](https://img.shields.io/github/last-commit/phil65/codexed)](https://github.com/phil65/codexed/commits)
+[![Github release date](https://img.shields.io/github/release-date/phil65/codexed)](https://github.com/phil65/codexed/releases)
+[![Github language count](https://img.shields.io/github/languages/count/phil65/codexed)](https://github.com/phil65/codexed)
+[![Github commits this month](https://img.shields.io/github/commit-activity/m/phil65/codexed)](https://github.com/phil65/codexed)
+[![Package status](https://codecov.io/gh/phil65/codexed/branch/main/graph/badge.svg)](https://codecov.io/gh/phil65/codexed/)
+[![PyUp](https://pyup.io/repos/github/phil65/codexed/shield.svg)](https://pyup.io/repos/github/phil65/codexed/)
+
+[Read the documentation!](https://phil65.github.io/codexed/)

codexed-0.0.1/README.md

@@ -0,0 +1,26 @@
+# Codexed
+
+[![PyPI License](https://img.shields.io/pypi/l/codexed.svg)](https://pypi.org/project/codexed/)
+[![Package status](https://img.shields.io/pypi/status/codexed.svg)](https://pypi.org/project/codexed/)
+[![Monthly downloads](https://img.shields.io/pypi/dm/codexed.svg)](https://pypi.org/project/codexed/)
+[![Distribution format](https://img.shields.io/pypi/format/codexed.svg)](https://pypi.org/project/codexed/)
+[![Wheel availability](https://img.shields.io/pypi/wheel/codexed.svg)](https://pypi.org/project/codexed/)
+[![Python version](https://img.shields.io/pypi/pyversions/codexed.svg)](https://pypi.org/project/codexed/)
+[![Implementation](https://img.shields.io/pypi/implementation/codexed.svg)](https://pypi.org/project/codexed/)
+[![Releases](https://img.shields.io/github/downloads/phil65/codexed/total.svg)](https://github.com/phil65/codexed/releases)
+[![Github Contributors](https://img.shields.io/github/contributors/phil65/codexed)](https://github.com/phil65/codexed/graphs/contributors)
+[![Github Discussions](https://img.shields.io/github/discussions/phil65/codexed)](https://github.com/phil65/codexed/discussions)
+[![Github Forks](https://img.shields.io/github/forks/phil65/codexed)](https://github.com/phil65/codexed/forks)
+[![Github Issues](https://img.shields.io/github/issues/phil65/codexed)](https://github.com/phil65/codexed/issues)
+[![Github Issues](https://img.shields.io/github/issues-pr/phil65/codexed)](https://github.com/phil65/codexed/pulls)
+[![Github Watchers](https://img.shields.io/github/watchers/phil65/codexed)](https://github.com/phil65/codexed/watchers)
+[![Github Stars](https://img.shields.io/github/stars/phil65/codexed)](https://github.com/phil65/codexed/stars)
+[![Github Repository size](https://img.shields.io/github/repo-size/phil65/codexed)](https://github.com/phil65/codexed)
+[![Github last commit](https://img.shields.io/github/last-commit/phil65/codexed)](https://github.com/phil65/codexed/commits)
+[![Github release date](https://img.shields.io/github/release-date/phil65/codexed)](https://github.com/phil65/codexed/releases)
+[![Github language count](https://img.shields.io/github/languages/count/phil65/codexed)](https://github.com/phil65/codexed)
+[![Github commits this month](https://img.shields.io/github/commit-activity/m/phil65/codexed)](https://github.com/phil65/codexed)
+[![Package status](https://codecov.io/gh/phil65/codexed/branch/main/graph/badge.svg)](https://codecov.io/gh/phil65/codexed/)
+[![PyUp](https://pyup.io/repos/github/phil65/codexed/shield.svg)](https://pyup.io/repos/github/phil65/codexed/)
+
+[Read the documentation!](https://phil65.github.io/codexed/)

codexed-0.0.1/pyproject.toml

@@ -0,0 +1,295 @@
+#:tombi schema.strict = false
+
+[project]
+name = "codexed"
+version = "0.0.1"
+description = "Alternative codex app-server client"
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "Philipp Temminghoff", email = "philipptemminghoff@googlemail.com" },
+]
+keywords = []
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Framework :: Pydantic",
+  "Framework :: Pydantic :: 2",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Documentation",
+  "Topic :: Software Development",
+  "Topic :: Utilities",
+  "Typing :: Typed",
+]
+dependencies = [
+  "anyenv>=2.0.15",
+  "pydantic",
+  "schemez",
+  # Only add below (Copier)
+]
+
+[project.urls]
+"Code coverage" = "https://app.codecov.io/gh/phil65/codexed"
+Discussions = "https://github.com/phil65/codexed/discussions"
+Documentation = "https://phil65.github.io/codexed/"
+Issues = "https://github.com/phil65/codexed/issues"
+Source = "https://github.com/phil65/codexed"
+
+[dependency-groups]
+dev = [
+  "devtools",
+  "pyreadline3",
+  "pytest",
+  "pytest-cov",
+  # Only add below (Copier)
+]
+benchmark = ["pyinstrument"]
+docs = [
+  "mkdocs-material",
+  "mkdocs-mknodes",
+  # Only add below (Copier)
+]
+lint = [
+  "mypy; python_version >= '3.14'",
+  "mypy[faster-cache]; python_version < '3.14'",
+  "ruff",
+  # Only add below (Copier)
+]
+
+[build-system]
+requires = ["uv_build>=0.8.22"]
+build-backend = "uv_build"
+
+[tool.coverage.report]
+exclude_lines = [
+  "pragma: no cover",
+  "if TYPE_CHECKING:",
+  "@overload",
+  "except ImportError",
+  'if __name__ == "__main__":',
+]
+
+[tool.mknodes]
+allowed-commit-types = [
+  "fix",
+  "feat",
+  "refactor",
+  "docs",
+  "test",
+  "build",
+  "chore",
+]
+docstring-style = "google"
+
+[tool.mypy]
+python_version = "3.13"
+disable_error_code = ["misc", "import"]
+pretty = true
+check_untyped_defs = true
+exclude = ["venv/", ".venv/", "reference/"]
+plugins = ["pydantic.mypy"]
+
+[tool.pyright]
+venvPath = "."
+venv = ".venv"
+pythonVersion = "3.13"
+pythonPlatform = "All"
+typeCheckingMode = "basic"
+deprecateTypingAliases = true
+reportMissingTypeStubs = false
+reportUnusedCallResult = false
+reportUnknownVariableType = false
+reportAny = false
+reportImplicitOverride = false
+reportUnusedFunction = false
+reportImplicitStringConcatenation = false
+reportIgnoreCommentWithoutRule = false
+reportUnannotatedClassAttribute = false
+reportSelfClsParameterName = false
+reportPrivateImportUsage = false
+
+[tool.pytest]
+log_cli = true
+log_date_format = "%Y-%m-%d %H:%M:%S"
+log_format = "%(asctime)s %(levelname)s %(message)s"
+minversion = "9.0"
+testpaths = ["tests/"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+extend-exclude = ["docs", "reference"]
+target-version = "py313"
+
+[tool.ruff.lint]
+future-annotations = true
+select = [
+  "A",  # Flake8-builtins
+  # "ANN",  # Flake8-Annotations
+  # "ASYNC",  # Flake8-Async
+  # "ARG",  # # Flake8-Unused-Arguments
+  "B",  # flake8-bugbear
+  "BLE",  # Flake8-blind-except
+  "C",
+  "C4",  # flake8-comprehensions
+  # "C90",  # MCCabe
+  "COM",  # Flake8-commas
+  # "CPY",  #  Copyright-related rules
+  "D",  # PyDocStyle
+  # "DTZ",  # Flake8- Datetimez
+  "E",  # PyCodeStyle Error
+  "EM",  # flake8-errmsg
+  # "ERA",  #  Eradicate
+  "EXE",  # flake8-executable
+  "F",  # PyFlakes
+  "FA",  # flake8-future-annotations
+  # "FBT",  # flake8-boolean-trap
+  # "FIX",  # flake8-fixme
+  "FLY",  # flynt
+  "G",  # flake8-logging-format
+  "I",  # ISort
+  "ICN",  # Flake8-import-conventions
+  "INP",  # flake8-no-pep420
+  "INT",  # flake8-gettext
+  "ISC",  # flake8-implicit-str-concat
+  "N",  # pep8-naming
+  # "NPY",  # numpy-specific rules
+  # "PD",   # pandas-vet
+  "PERF",  # perflint
+  # "PGH",  # pygrep-hooks
+  "PIE",  # flake8-pie
+  "PLE",  # PyLint Error
+  "PLC",  # PyLint convention
+  # "PLW",  # PyLint Warning
+  "PLR",  # PyLint refactor
+  "PT",  # flake8-pytest-style
+  "PTH",  # flake8-use-pathlib
+  "PYI",  # flake8-pyi
+  "Q",  # flake8-quotes
+  "RET",  # flake8-return
+  "RSE",  # flake8-raise
+  "RUF",  # ruff-specific rules
+  # "S",    # flake8-bandit
+  "SIM",  # flake8-simplify
+  "SLF",  # flake8-self
+  "SLOT",  # flake8-slots
+  # "T",
+  # "TD",   # flake8-todos
+  "T10",  # flake8-debugger
+  # "T20",  # flake8-print
+  "TC",  # flake8-type-checking
+  "TID",  # flake8-tidy-imports
+  "TRY",  # tryceratops
+  "UP",  # PyUpgrade
+  "W",  # PyCodeStyle warning
+  "YTT",  # flake8-2020
+]
+ignore = [
+  "C408",  # Unnecessary {obj_type} call (rewrite as a literal)
+  "B905",  # zip() without an explicit strict= parameter
+  "C901",  # {name} is too complex ({complexity} > {max_complexity})
+  "COM812",
+  # "CPY001", # Missing copyright notice at top of file
+  "D100",  # Missing docstring in public module
+  "D101",  # Missing docstring in public class
+  "D102",  # Missing docstring in public method
+  "D103",  # Missing docstring in public function
+  "D104",  # Missing docstring in public package
+  "D105",  # Missing docstring in magic method
+  "D106",  # Missing docstring in public nested class
+  "D107",  # Missing docstring in __init__
+  "D203",  # 1 blank line required before class docstring
+  "D204",  # 1 blank line required after class docstring
+  "D213",  # Multi-line docstring summary should start at the second line
+  "D215",  # Section underline is over-indented ("{name}")
+  "D400",  # First line should end with a period
+  "D401",  # First line of docstring should be in imperative mood: "{first_line}"
+  "D404",  # First word of the docstring should not be "This"
+  "D406",  # Section name should end with a newline ("{name}")
+  "D407",  # Missing dashed underline after section ("{name}")
+  "D408",  # Section underline should be in the line following the section's name ("{name}")
+  "D409",  # Section underline should match the length of its name ("{name}")
+  "D413",  # Missing blank line after last section ("{name}")
+  "EM101",  # Exception must not use a string literal, assign to variable first
+  "EM102",  # Exception must not use an f-string literal, assign to variable first
+  "ISC001",
+  "PLC0415",
+  "PLR0912",  # Too many branches
+  "PLR0913",  # Too many arguments to function call
+  "PLR0915",  # Too many statements
+  # "PLR2004", # Magic values instead of named consts
+  "SLF001",  # Private member accessed
+  "TRY003",  # Avoid specifying long messages outside the exception class
+  "TC006",  # runtime-cast-value
+]
+
+[tool.ruff.lint.flake8-quotes]
+docstring-quotes = "double"
+
+[tool.ruff.lint.flake8-type-checking]
+runtime-evaluated-base-classes = [
+  "pydantic.BaseModel",
+  "sqlalchemy.orm.DeclarativeBase",
+  "schemez.Schema",
+  "sqlmodel.SQLModel",
+]
+runtime-evaluated-decorators = [
+  "pydantic.validate_call",
+  "fastapi.FastAPI.get",
+  "fastapi.FastAPI.post",
+  "fastmcp.FastMCP.tool",
+  "typer.Typer.command",
+]
+
+[tool.ruff.lint.isort]
+lines-after-imports = 2
+# lines-between-types = 1
+# atomic = true
+force-sort-within-sections = true
+combine-as-imports = true
+
+[tool.ruff.lint.mccabe]
+max-complexity = 15
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["E402", "I001"]
+"scripts/*" = ["INP001"]
+"*tests/*" = ["D100"]
+
+[tool.ruff.format]
+preview = true
+
+[tool.ty.src]
+exclude = ["reference"]
+
+[tool.ty.environment]
+python-version = "3.13"
+python-platform = "all"
+
+[tool.uv]
+default-groups = ["dev", "lint", "docs"]
+
+[tool.uv.build-backend]
+wheel-exclude = [
+  ".mypy_cache/**",
+  "__pycache__/**",
+  "*.pyc",
+  "*.pyo",
+  ".pytest_cache/**",
+  ".ruff_cache/**",
+]
+source-exclude = [
+  ".mypy_cache/**",
+  "__pycache__/**",
+  "*.pyc",
+  "*.pyo",
+  ".pytest_cache/**",
+  ".ruff_cache/**",
+]

codexed-0.0.1/src/codexed/README.md

@@ -0,0 +1,70 @@
+# Codex Adapter
+
+Python adapter for the [Codex](https://github.com/openai/codex) app-server JSON-RPC protocol.
+
+## Quick Start
+
+```python
+import asyncio
+from codexed import CodexClient
+from codexed.models.events import AgentMessageDeltaEvent, TurnCompletedEvent, get_text_delta
+
+async def main():
+    async with CodexClient() as client:
+        session = await client.thread_start(cwd="/path/to/project")
+        
+        async for event in session.turn_stream("Help me refactor this code"):
+            match event:
+                case AgentMessageDeltaEvent():
+                    print(get_text_delta(event), end="", flush=True)
+                case TurnCompletedEvent():
+                    break
+
+asyncio.run(main())
+```
+
+## Structured Responses
+
+```python
+from pydantic import BaseModel
+
+class FileList(BaseModel):
+    files: list[str]
+    total: int
+
+async with CodexClient() as client:
+    session = await client.thread_start(cwd=".")
+    result = await session.turn_stream_structured(
+        "List Python files",
+        FileList,
+    )
+    print(result.files)  # Typed result
+```
+
+## Events
+
+Events are a discriminated union. Use pattern matching or helper functions:
+
+```python
+from codexed.models.events import (
+    AgentMessageDeltaEvent,
+    CommandExecutionOutputDeltaEvent,
+    TurnCompletedEvent,
+    TurnErrorEvent,
+    get_text_delta,
+    is_delta_event,
+)
+
+async for event in client.turn_stream(thread_id, message):
+    match event:
+        case AgentMessageDeltaEvent() | CommandExecutionOutputDeltaEvent():
+            print(get_text_delta(event), end="")
+        case TurnCompletedEvent():
+            break
+        case TurnErrorEvent(data=data):
+            print(f"Error: {data.error}")
+```
+
+## See Also
+
+- [Codex app-server docs](https://github.com/openai/codex/blob/main/codex-rs/app-server/README.md)