reprobate 0.1.0__tar.gz

reprobate-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adam Ashenfelter
+
+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.

reprobate-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: reprobate
+Version: 0.1.0
+Summary: Budget-controlled repr for Python objects.
+Author: ashenfad
+License-Expression: MIT
+Keywords: repr,pretty-print,budget,truncation,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-timeout; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-timeout; extra == "test"
+Requires-Dist: numpy; extra == "test"
+Requires-Dist: pandas; extra == "test"
+Requires-Dist: Pillow; extra == "test"
+Requires-Dist: polars; extra == "test"
+Requires-Dist: pyarrow; extra == "test"
+Requires-Dist: pydantic; extra == "test"
+Dynamic: license-file
+
+# reprobate 🖨️
+
+Budget-controlled repr for Python objects.
+
+Renders any Python object into a string that fits within a character budget. Nested structures degrade gracefully: full values, then type stubs, then counts. Zero dependencies. Pluggable via a type registry and a `__budget_repr__` protocol.
+
+## Features
+
+- **Hard budget guarantee** -- output is always `<= budget` characters
+- **Three-phase degradation** -- full render, then `name=<type(len)>` stubs, then `...N more` counts
+- **Greedy and even policies** -- prioritize depth (first fields in detail) or breadth (all fields equally)
+- **Cycle detection** -- circular references render as `<...>` instead of stack overflows
+- **Type registry** -- `@register(MyType)` for custom budget-aware renderers
+- **Protocol method** -- `__budget_repr__(self, budget)` on any class
+- **Optional extensions** -- arrow, numpy, pandas, pil, polars, pydantic renderers (guarded imports, zero cost if absent)
+
+## Install
+
+```bash
+pip install reprobate
+```
+
+Zero dependencies. Optional renderers activate automatically when their libraries are already installed (numpy, pandas, polars, pyarrow, Pillow, pydantic).
+
+## Quick example
+
+```python
+import reprobate
+
+reprobate.render({"name": "alice", "scores": [98, 87, 95, 72, 88]}, 60)
+# "{'name': 'alice', 'scores': [98, 87, 95, 72, 88]}"
+
+reprobate.render({"name": "alice", "scores": [98, 87, 95, 72, 88]}, 30)
+# "{'name': 'alice', ...1 more}"
+
+reprobate.render(list(range(1000)), 40)
+# "[0, 1, 2, 3, ...996 more]"
+```
+
+## Policies
+
+```python
+from dataclasses import dataclass
+
+@dataclass
+class Agent:
+    desc: str = "A very long description that eats the budget"
+    important_note: str = "critical info here"
+    status: str = "running"
+    config: dict = None
+    history: list = None
+
+# Greedy: first fields get full detail
+reprobate.render(agent, 100, policy="greedy")
+# "Agent(desc='A very long description that eats the budget', important_note=<str(18)>, ...3 more)"
+
+# Even: all fields get comparable detail
+reprobate.render(agent, 100, policy="even")
+# "Agent(desc='A very long...', important_note='critical info...', status='running', ...2 more)"
+```
+
+## Custom renderers
+
+Register a renderer for any type:
+
+```python
+@reprobate.register(MyType)
+def render_my_type(obj: MyType, budget: int) -> str:
+    return f"MyType({obj.key})"[:budget]
+```
+
+Or implement the protocol directly:
+
+```python
+class MyType:
+    def __budget_repr__(self, budget: int) -> str:
+        return f"MyType({self.key})"[:budget]
+```
+
+For renderers that recurse into child objects, use `render_child` (inherits policy and cycle detection) and `render_attrs` (standard `TypeName(key=val, ...)` pattern):
+
+```python
+from reprobate import register, render_child, render_attrs
+
+@register(MyContainer)
+def render_my_container(obj: MyContainer, budget: int) -> str:
+    # render_child for recursive rendering
+    inner = render_child(obj.value, budget - 10)
+    return f"MyContainer({inner})"
+
+@register(MyModel)
+def render_my_model(obj: MyModel, budget: int) -> str:
+    # render_attrs for the standard object pattern
+    attrs = {"name": obj.name, "data": obj.data}
+    return render_attrs(attrs, "MyModel", budget)
+```
+
+## Supported types
+
+| Category | Types | Behavior |
+|----------|-------|----------|
+| Primitives | `None`, `bool`, `int`, `float` | `repr()`, truncated with `...` if needed |
+| Strings | `str`, `bytes` | Quoted, truncated with `...` preserving quotes |
+| Containers | `list`, `tuple`, `set`, `frozenset` | Head items + `...N more`, tail peek when budget allows |
+| Dicts | `dict` | Key-value pairs + `...N more` |
+| Collections | `deque`, `defaultdict`, `Counter` | Type-aware wrappers (factory name, most-common order) |
+| Structured | `dataclass`, `namedtuple` | Field-aware decomposition, respects `repr=False` |
+| Objects | anything with `__dict__` | Attribute decomposition, public attrs only |
+| Optional | numpy, pandas, polars, pyarrow, Pillow, pydantic | Shape/dtype/columns summary (auto-activates when lib is installed) |
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run pytest
+```

reprobate-0.1.0/README.md

@@ -0,0 +1,116 @@
+# reprobate 🖨️
+
+Budget-controlled repr for Python objects.
+
+Renders any Python object into a string that fits within a character budget. Nested structures degrade gracefully: full values, then type stubs, then counts. Zero dependencies. Pluggable via a type registry and a `__budget_repr__` protocol.
+
+## Features
+
+- **Hard budget guarantee** -- output is always `<= budget` characters
+- **Three-phase degradation** -- full render, then `name=<type(len)>` stubs, then `...N more` counts
+- **Greedy and even policies** -- prioritize depth (first fields in detail) or breadth (all fields equally)
+- **Cycle detection** -- circular references render as `<...>` instead of stack overflows
+- **Type registry** -- `@register(MyType)` for custom budget-aware renderers
+- **Protocol method** -- `__budget_repr__(self, budget)` on any class
+- **Optional extensions** -- arrow, numpy, pandas, pil, polars, pydantic renderers (guarded imports, zero cost if absent)
+
+## Install
+
+```bash
+pip install reprobate
+```
+
+Zero dependencies. Optional renderers activate automatically when their libraries are already installed (numpy, pandas, polars, pyarrow, Pillow, pydantic).
+
+## Quick example
+
+```python
+import reprobate
+
+reprobate.render({"name": "alice", "scores": [98, 87, 95, 72, 88]}, 60)
+# "{'name': 'alice', 'scores': [98, 87, 95, 72, 88]}"
+
+reprobate.render({"name": "alice", "scores": [98, 87, 95, 72, 88]}, 30)
+# "{'name': 'alice', ...1 more}"
+
+reprobate.render(list(range(1000)), 40)
+# "[0, 1, 2, 3, ...996 more]"
+```
+
+## Policies
+
+```python
+from dataclasses import dataclass
+
+@dataclass
+class Agent:
+    desc: str = "A very long description that eats the budget"
+    important_note: str = "critical info here"
+    status: str = "running"
+    config: dict = None
+    history: list = None
+
+# Greedy: first fields get full detail
+reprobate.render(agent, 100, policy="greedy")
+# "Agent(desc='A very long description that eats the budget', important_note=<str(18)>, ...3 more)"
+
+# Even: all fields get comparable detail
+reprobate.render(agent, 100, policy="even")
+# "Agent(desc='A very long...', important_note='critical info...', status='running', ...2 more)"
+```
+
+## Custom renderers
+
+Register a renderer for any type:
+
+```python
+@reprobate.register(MyType)
+def render_my_type(obj: MyType, budget: int) -> str:
+    return f"MyType({obj.key})"[:budget]
+```
+
+Or implement the protocol directly:
+
+```python
+class MyType:
+    def __budget_repr__(self, budget: int) -> str:
+        return f"MyType({self.key})"[:budget]
+```
+
+For renderers that recurse into child objects, use `render_child` (inherits policy and cycle detection) and `render_attrs` (standard `TypeName(key=val, ...)` pattern):
+
+```python
+from reprobate import register, render_child, render_attrs
+
+@register(MyContainer)
+def render_my_container(obj: MyContainer, budget: int) -> str:
+    # render_child for recursive rendering
+    inner = render_child(obj.value, budget - 10)
+    return f"MyContainer({inner})"
+
+@register(MyModel)
+def render_my_model(obj: MyModel, budget: int) -> str:
+    # render_attrs for the standard object pattern
+    attrs = {"name": obj.name, "data": obj.data}
+    return render_attrs(attrs, "MyModel", budget)
+```
+
+## Supported types
+
+| Category | Types | Behavior |
+|----------|-------|----------|
+| Primitives | `None`, `bool`, `int`, `float` | `repr()`, truncated with `...` if needed |
+| Strings | `str`, `bytes` | Quoted, truncated with `...` preserving quotes |
+| Containers | `list`, `tuple`, `set`, `frozenset` | Head items + `...N more`, tail peek when budget allows |
+| Dicts | `dict` | Key-value pairs + `...N more` |
+| Collections | `deque`, `defaultdict`, `Counter` | Type-aware wrappers (factory name, most-common order) |
+| Structured | `dataclass`, `namedtuple` | Field-aware decomposition, respects `repr=False` |
+| Objects | anything with `__dict__` | Attribute decomposition, public attrs only |
+| Optional | numpy, pandas, polars, pyarrow, Pillow, pydantic | Shape/dtype/columns summary (auto-activates when lib is installed) |
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run pytest
+```

reprobate-0.1.0/pyproject.toml

@@ -0,0 +1,63 @@
+[project]
+name = "reprobate"
+version = "0.1.0"
+description = "Budget-controlled repr for Python objects."
+readme = "README.md"
+license = "MIT"
+authors = [
+    {name = "ashenfad"},
+]
+keywords = ["repr", "pretty-print", "budget", "truncation", "llm"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.10"
+
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "ruff",
+    "pre-commit",
+    "pytest",
+    "pytest-timeout",
+]
+test = [
+    "pytest",
+    "pytest-timeout",
+    "numpy",
+    "pandas",
+    "Pillow",
+    "polars",
+    "pyarrow",
+    "pydantic",
+]
+
+[tool.ruff]
+line-length = 88
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "I"]
+ignore = ["E731"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = {find = {where = ["./"], exclude = ["tests*"]}}
+
+[tool.setuptools.package-data]
+reprobate = ["py.typed"]

reprobate-0.1.0/reprobate/__init__.py

@@ -0,0 +1,22 @@
+"""reprobate: Budget-controlled repr for Python objects."""
+
+from .core import Policy, render, render_attrs, render_child
+from .registry import register
+
+__all__ = [
+    "Policy",
+    "register",
+    "render",
+    "render_attrs",
+    "render_child",
+]
+
+# Auto-register optional type renderers when their deps are available.
+from . import (
+    ext_arrow,  # noqa: F401
+    ext_numpy,  # noqa: F401
+    ext_pandas,  # noqa: F401
+    ext_pil,  # noqa: F401
+    ext_polars,  # noqa: F401
+    ext_pydantic,  # noqa: F401
+)