pverbs 0.1.0__tar.gz

pverbs-0.1.0/LICENSE

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

pverbs-0.1.0/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: pverbs
+Version: 0.1.0
+Summary: Explicit, named constraints for more verifiable agent-written code
+Author: Patrick Beam
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/antimemeai/verbs
+Project-URL: Repository, https://github.com/antimemeai/verbs
+Project-URL: Issues, https://github.com/antimemeai/verbs/issues
+Keywords: constraints,validation,agents,contracts
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Verbs for Python
+
+```python
+from pverbs import check
+retries = check("bounded retries", 3, lambda n: 1 <= n <= 5)
+```
+
+`check` evaluates a synchronous predicate once and returns the original value
+only for the boolean `True`; otherwise it raises `Violation` with a `constraint`
+attribute. Predicate exceptions propagate. Later mutation can invalidate a check.
+No runtime dependencies. Python 3.10 or newer.
+
+Distribution and import name: `pverbs`, selected by the operator. `pyverbs` is
+an unrelated published package. The initial API is experimental and MIT licensed.
+
+Install with `pip install pverbs` after publication. From this directory,
+`python -m unittest -v test_verbs` checks the source. From the repository root,
+`uv build packages/python --out-dir packages/python/dist` builds the source
+distribution and wheel, using setuptools as a build-only dependency.
+There are no runtime or test dependencies beyond the Python standard library.
+
+`python scripts/publish.py pypi` publishes the prepared files using the pypi
+credential from ~/projects/.env. The utility passes the credential through the
+child environment and does not persist it in this repository. Use --dry-run
+to check the upload preparation without publishing.

pverbs-0.1.0/README.md

@@ -0,0 +1,25 @@
+# Verbs for Python
+
+```python
+from pverbs import check
+retries = check("bounded retries", 3, lambda n: 1 <= n <= 5)
+```
+
+`check` evaluates a synchronous predicate once and returns the original value
+only for the boolean `True`; otherwise it raises `Violation` with a `constraint`
+attribute. Predicate exceptions propagate. Later mutation can invalidate a check.
+No runtime dependencies. Python 3.10 or newer.
+
+Distribution and import name: `pverbs`, selected by the operator. `pyverbs` is
+an unrelated published package. The initial API is experimental and MIT licensed.
+
+Install with `pip install pverbs` after publication. From this directory,
+`python -m unittest -v test_verbs` checks the source. From the repository root,
+`uv build packages/python --out-dir packages/python/dist` builds the source
+distribution and wheel, using setuptools as a build-only dependency.
+There are no runtime or test dependencies beyond the Python standard library.
+
+`python scripts/publish.py pypi` publishes the prepared files using the pypi
+credential from ~/projects/.env. The utility passes the credential through the
+child environment and does not persist it in this repository. Use --dry-run
+to check the upload preparation without publishing.

pverbs-0.1.0/pverbs/__init__.py

@@ -0,0 +1,25 @@
+"""Explicit, named synchronous constraints; checked at the time of the call."""
+
+from collections.abc import Callable
+from typing import TypeVar
+
+__all__ = ["Violation", "check"]
+T = TypeVar("T")
+
+
+class Violation(ValueError):
+    """A predicate rejected a value, identified only by its constraint name."""
+
+    def __init__(self, constraint: str) -> None:
+        self.constraint = constraint
+        super().__init__(f"constraint violated: {constraint}")
+
+
+def check(name: str, value: T, predicate: Callable[[T], bool]) -> T:
+    """Evaluate once; return the original value only for the boolean True.
+
+    Predicate exceptions propagate. Later mutation can invalidate the constraint.
+    """
+    if predicate(value) is not True:
+        raise Violation(name)
+    return value

pverbs-0.1.0/pverbs.egg-info/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: pverbs
+Version: 0.1.0
+Summary: Explicit, named constraints for more verifiable agent-written code
+Author: Patrick Beam
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/antimemeai/verbs
+Project-URL: Repository, https://github.com/antimemeai/verbs
+Project-URL: Issues, https://github.com/antimemeai/verbs/issues
+Keywords: constraints,validation,agents,contracts
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Verbs for Python
+
+```python
+from pverbs import check
+retries = check("bounded retries", 3, lambda n: 1 <= n <= 5)
+```
+
+`check` evaluates a synchronous predicate once and returns the original value
+only for the boolean `True`; otherwise it raises `Violation` with a `constraint`
+attribute. Predicate exceptions propagate. Later mutation can invalidate a check.
+No runtime dependencies. Python 3.10 or newer.
+
+Distribution and import name: `pverbs`, selected by the operator. `pyverbs` is
+an unrelated published package. The initial API is experimental and MIT licensed.
+
+Install with `pip install pverbs` after publication. From this directory,
+`python -m unittest -v test_verbs` checks the source. From the repository root,
+`uv build packages/python --out-dir packages/python/dist` builds the source
+distribution and wheel, using setuptools as a build-only dependency.
+There are no runtime or test dependencies beyond the Python standard library.
+
+`python scripts/publish.py pypi` publishes the prepared files using the pypi
+credential from ~/projects/.env. The utility passes the credential through the
+child environment and does not persist it in this repository. Use --dry-run
+to check the upload preparation without publishing.

pverbs-0.1.0/pverbs.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+pverbs/__init__.py
+pverbs/py.typed
+pverbs.egg-info/PKG-INFO
+pverbs.egg-info/SOURCES.txt
+pverbs.egg-info/dependency_links.txt
+pverbs.egg-info/top_level.txt

pverbs-0.1.0/pverbs.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pverbs-0.1.0/pverbs.egg-info/top_level.txt

@@ -0,0 +1 @@
+pverbs

pverbs-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pverbs"
+version = "0.1.0"
+description = "Explicit, named constraints for more verifiable agent-written code"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "Patrick Beam"}]
+keywords = ["constraints", "validation", "agents", "contracts"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/antimemeai/verbs"
+Repository = "https://github.com/antimemeai/verbs"
+Issues = "https://github.com/antimemeai/verbs/issues"
+
+[tool.setuptools]
+packages = ["pverbs"]
+
+[tool.setuptools.package-data]
+pverbs = ["py.typed"]

pverbs-0.1.0/setup.cfg

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