anyvalue 0.1.0__tar.gz

anyvalue-0.1.0/.editorconfig

@@ -0,0 +1,11 @@
+# http://editorconfig.org
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+insert_final_newline = true
+charset = utf-8
+end_of_line = lf

anyvalue-0.1.0/.github/workflows/build.yml

@@ -0,0 +1,73 @@
+name: Build
+
+on: [push, pull_request]
+
+jobs:
+    test:
+        runs-on: ubuntu-latest
+        permissions:
+            contents: read
+        strategy:
+            matrix:
+                python_version: ["3.11", "3.12", "3.13", "3.14", "3.14t"]
+
+        steps:
+            - uses: actions/checkout@v5
+            - name: Set up Python
+              uses: actions/setup-python@v6
+              with:
+                  python-version: ${{ matrix.python_version }}
+            - name: Setup Just
+              uses: extractions/setup-just@v3
+            - name: Install uv and set the Python version
+              uses: astral-sh/setup-uv@v7
+              with:
+                  python-version: ${{ matrix.python_version }}
+            - name: Install the project
+              run: uv sync --all-extras --dev
+            - name: Lint and typecheck
+              run: |
+                  just lint-check
+            - name: Test
+              run: |
+                  just test-cov-xml
+            - uses: codecov/codecov-action@v5
+              with:
+                  token: ${{ secrets.CODECOV_TOKEN }}
+                  fail_ci_if_error: true
+                  verbose: true
+
+    release:
+        runs-on: ubuntu-latest
+        environment: release
+        needs: test
+        if: startsWith(github.ref, 'refs/tags/')
+        permissions:
+            contents: write
+            id-token: write
+
+        steps:
+            - uses: actions/checkout@v5
+            - name: Set up Python
+              uses: actions/setup-python@v6
+              with:
+                  python-version: "3.11"
+            - name: Setup Just
+              uses: extractions/setup-just@v3
+            - name: Install uv and set the Python version
+              uses: astral-sh/setup-uv@v7
+              with:
+                  python-version: "3.11"
+            - name: Install the project
+              run: uv sync --all-extras --dev
+            - name: Build and publish on PyPI
+              run: |
+                  uv build
+                  uv publish
+            - name: Create release
+              uses: ncipollo/release-action@v1
+              with:
+                  draft: true
+                  body: ${{ github.event.head_commit.message }}
+                  artifacts: dist/*.whl,dist/*.tar.gz
+                  token: ${{ secrets.GITHUB_TOKEN }}

anyvalue-0.1.0/.github/workflows/copilot-setup-steps.yml

@@ -0,0 +1,33 @@
+name: "Copilot Setup Steps"
+
+# Automatically run the setup steps when they are changed to allow for easy validation, and
+# allow manual testing through the repository's "Actions" tab
+on:
+    workflow_dispatch:
+    push:
+        paths:
+            - .github/workflows/copilot-setup-steps.yml
+    pull_request:
+        paths:
+            - .github/workflows/copilot-setup-steps.yml
+
+jobs:
+    # The job MUST be called `copilot-setup-steps` or it will not be picked up by Copilot.
+    copilot-setup-steps:
+        runs-on: ubuntu-latest
+        permissions:
+            contents: read
+        steps:
+            - uses: actions/checkout@v5
+            - name: Set up Python
+              uses: actions/setup-python@v6
+              with:
+                  python-version: "3.11"
+            - name: Setup Just
+              uses: extractions/setup-just@v3
+            - name: Install uv and set the Python version
+              uses: astral-sh/setup-uv@v7
+              with:
+                  python-version: "3.11"
+            - name: Install the project
+              run: uv sync --all-extras --dev

anyvalue-0.1.0/.github/workflows/documentation.yml

@@ -0,0 +1,58 @@
+name: Build documentation
+
+on:
+    push:
+        branches:
+            - main
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+    contents: read
+    pages: write
+    id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+    group: "pages"
+    cancel-in-progress: true
+
+# Default to bash
+defaults:
+    run:
+        shell: bash
+
+jobs:
+    build:
+        runs-on: ubuntu-latest
+
+        steps:
+            - uses: actions/checkout@v5
+            - name: Set up Python
+              uses: actions/setup-python@v6
+              with:
+                  python-version: '3.11'
+            - name: Setup Just
+              uses: extractions/setup-just@v3
+            - name: Install uv and set the Python version
+              uses: astral-sh/setup-uv@v7
+              with:
+                  python-version: '3.11'
+            - name: Install the project
+              run: uv sync --all-extras --dev
+            - name: Build
+              run: just docs-build
+            - name: Upload artifact
+              uses: actions/upload-pages-artifact@v4
+              with:
+                  path: ./site
+
+    deploy:
+        environment:
+            name: github-pages
+            url: ${{ steps.deployment.outputs.page_url }}
+        runs-on: ubuntu-latest
+        needs: build
+        steps:
+            - name: Deploy to GitHub Pages
+              id: deployment
+              uses: actions/deploy-pages@v4

anyvalue-0.1.0/.gitignore

@@ -0,0 +1,111 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+junit/
+junit.xml
+test.db
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# ruff
+.ruff_cache/
+
+# OS files
+.DS_Store

anyvalue-0.1.0/.zed/settings.json

@@ -0,0 +1,27 @@
+{
+    "languages": {
+        "Python": {
+            "language_servers": ["pyright", "ruff", "!basedpyright", "!pylsp"],
+            "format_on_save": "on",
+            "wrap_guides": [88],
+            "formatter": [
+                { "code_action": "source.organizeImports.ruff" },
+                { "code_action": "source.fixAll.ruff" },
+                {
+                    "language_server": {
+                        "name": "ruff",
+                    },
+                },
+            ],
+        },
+    },
+    "lsp": {
+        "pyright": {
+            "settings": {
+                "python": {
+                    "pythonPath": ".venv/bin/python",
+                },
+            },
+        },
+    },
+}

anyvalue-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026, François Voron
+
+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.
+

anyvalue-0.1.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: anyvalue
+Version: 0.1.0
+Summary: A better ANY helper for Python testing
+Project-URL: Documentation, https://frankie567.github.io/anyvalue/
+Project-URL: Source, https://github.com/frankie567/anyvalue
+Author-email: anyvalue <hello@fvoron.com>
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.11
+Requires-Dist: annotated-types>=0.7.0
+Description-Content-Type: text/markdown
+
+# AnyValue
+
+<p align="center">
+    <em>A better ANY helper for Python testing</em>
+</p>
+
+[![build](https://github.com/frankie567/anyvalue/workflows/Build/badge.svg)](https://github.com/frankie567/anyvalue/actions)
+[![codecov](https://codecov.io/gh/frankie567/anyvalue/branch/master/graph/badge.svg)](https://codecov.io/gh/frankie567/anyvalue)
+[![PyPI version](https://badge.fury.io/py/anyvalue.svg)](https://badge.fury.io/py/anyvalue)
+
+---
+
+**Documentation**: <a href="https://frankie567.github.io/anyvalue/" target="_blank">https://frankie567.github.io/anyvalue/</a>
+
+**Source Code**: <a href="https://github.com/frankie567/anyvalue" target="_blank">https://github.com/frankie567/anyvalue</a>
+
+---
+
+## QuickStart
+
+A smarter alternative to `unittest.mock.ANY` that allows type checking and validation constraints.
+
+### Installation
+
+```bash
+pip install anyvalue
+```
+
+```bash
+uv add anyvalue
+```
+
+### Basic Usage
+
+```python
+from anyvalue import AnyValue
+from annotated_types import Ge, Le, Len, Predicate
+from datetime import datetime
+from unittest.mock import Mock
+
+# Basic type matching
+assert 42 == AnyValue(int)
+assert "hello" == AnyValue(str)
+assert datetime.now() == AnyValue(datetime)
+
+# Multiple types with union operator
+assert 42 == AnyValue(int | float)
+assert "test" == AnyValue(str | bytes)
+
+# None support
+assert None == AnyValue(None)
+assert None == AnyValue(str | None)
+assert 42 == AnyValue(int | None)
+
+# Validation constraints
+assert 42 == AnyValue(int, Ge(0))  # Non-negative integer
+assert "hello" == AnyValue(str, Len(5, 5))  # String of length 5
+assert 99 == AnyValue(int, Ge(0), Le(100))  # Integer between 0 and 100
+
+# Predicate validators
+is_even = Predicate(lambda x: x % 2 == 0)
+assert 42 == AnyValue(int, is_even)
+
+# Custom callable validators
+def is_palindrome(s: str) -> bool:
+    return s == s[::-1]
+
+assert "racecar" == AnyValue(str, is_palindrome)
+
+# Integration with unittest.mock
+mock_func = Mock()
+mock_func(42, "test", datetime.now())
+
+# Verify calls with flexible matching
+mock_func.assert_called_once_with(
+    AnyValue(int, Ge(0)),
+    AnyValue(str, Len(4, 10)),
+    AnyValue(datetime)
+)
+```
+
+### Key Features
+
+- **Type checking**: Accept specific types or union of types
+- **None support**: Explicitly allow or disallow None values
+- **Validation constraints**: Use `annotated-types` for advanced validation (length, ranges, patterns, etc.)
+- **Mock integration**: Works seamlessly with `unittest.mock` for validating call arguments
+
+---
+
+## Development
+
+### Setup environment
+
+We use [uv](https://docs.astral.sh/uv/) to manage the development environment and production build, and [just](https://github.com/casey/just) to manage command shortcuts. Ensure they are installed on your system.
+
+### Run unit tests
+
+You can run all the tests with:
+
+```bash
+just test
+```
+
+### Format the code
+
+Execute the following command to apply linting and check typing:
+
+```bash
+just lint
+```
+
+### Publish a new version
+
+You can bump the version, create a commit and associated tag with one command:
+
+```bash
+just version patch
+```
+
+```bash
+just version minor
+```
+
+```bash
+just version major
+```
+
+Your default Git text editor will open so you can add information about the release.
+
+When you push the tag on GitHub, the workflow will automatically publish it on PyPi and a GitHub release will be created as draft.
+
+## Serve the documentation
+
+You can serve the Mkdocs documentation with:
+
+```bash
+just docs-serve
+```
+
+It'll automatically watch for changes in your code.
+
+## License
+
+This project is licensed under the terms of the MIT license.

anyvalue-0.1.0/README.md

@@ -0,0 +1,145 @@
+# AnyValue
+
+<p align="center">
+    <em>A better ANY helper for Python testing</em>
+</p>
+
+[![build](https://github.com/frankie567/anyvalue/workflows/Build/badge.svg)](https://github.com/frankie567/anyvalue/actions)
+[![codecov](https://codecov.io/gh/frankie567/anyvalue/branch/master/graph/badge.svg)](https://codecov.io/gh/frankie567/anyvalue)
+[![PyPI version](https://badge.fury.io/py/anyvalue.svg)](https://badge.fury.io/py/anyvalue)
+
+---
+
+**Documentation**: <a href="https://frankie567.github.io/anyvalue/" target="_blank">https://frankie567.github.io/anyvalue/</a>
+
+**Source Code**: <a href="https://github.com/frankie567/anyvalue" target="_blank">https://github.com/frankie567/anyvalue</a>
+
+---
+
+## QuickStart
+
+A smarter alternative to `unittest.mock.ANY` that allows type checking and validation constraints.
+
+### Installation
+
+```bash
+pip install anyvalue
+```
+
+```bash
+uv add anyvalue
+```
+
+### Basic Usage
+
+```python
+from anyvalue import AnyValue
+from annotated_types import Ge, Le, Len, Predicate
+from datetime import datetime
+from unittest.mock import Mock
+
+# Basic type matching
+assert 42 == AnyValue(int)
+assert "hello" == AnyValue(str)
+assert datetime.now() == AnyValue(datetime)
+
+# Multiple types with union operator
+assert 42 == AnyValue(int | float)
+assert "test" == AnyValue(str | bytes)
+
+# None support
+assert None == AnyValue(None)
+assert None == AnyValue(str | None)
+assert 42 == AnyValue(int | None)
+
+# Validation constraints
+assert 42 == AnyValue(int, Ge(0))  # Non-negative integer
+assert "hello" == AnyValue(str, Len(5, 5))  # String of length 5
+assert 99 == AnyValue(int, Ge(0), Le(100))  # Integer between 0 and 100
+
+# Predicate validators
+is_even = Predicate(lambda x: x % 2 == 0)
+assert 42 == AnyValue(int, is_even)
+
+# Custom callable validators
+def is_palindrome(s: str) -> bool:
+    return s == s[::-1]
+
+assert "racecar" == AnyValue(str, is_palindrome)
+
+# Integration with unittest.mock
+mock_func = Mock()
+mock_func(42, "test", datetime.now())
+
+# Verify calls with flexible matching
+mock_func.assert_called_once_with(
+    AnyValue(int, Ge(0)),
+    AnyValue(str, Len(4, 10)),
+    AnyValue(datetime)
+)
+```
+
+### Key Features
+
+- **Type checking**: Accept specific types or union of types
+- **None support**: Explicitly allow or disallow None values
+- **Validation constraints**: Use `annotated-types` for advanced validation (length, ranges, patterns, etc.)
+- **Mock integration**: Works seamlessly with `unittest.mock` for validating call arguments
+
+---
+
+## Development
+
+### Setup environment
+
+We use [uv](https://docs.astral.sh/uv/) to manage the development environment and production build, and [just](https://github.com/casey/just) to manage command shortcuts. Ensure they are installed on your system.
+
+### Run unit tests
+
+You can run all the tests with:
+
+```bash
+just test
+```
+
+### Format the code
+
+Execute the following command to apply linting and check typing:
+
+```bash
+just lint
+```
+
+### Publish a new version
+
+You can bump the version, create a commit and associated tag with one command:
+
+```bash
+just version patch
+```
+
+```bash
+just version minor
+```
+
+```bash
+just version major
+```
+
+Your default Git text editor will open so you can add information about the release.
+
+When you push the tag on GitHub, the workflow will automatically publish it on PyPi and a GitHub release will be created as draft.
+
+## Serve the documentation
+
+You can serve the Mkdocs documentation with:
+
+```bash
+just docs-serve
+```
+
+It'll automatically watch for changes in your code.
+
+## License
+
+This project is licensed under the terms of the MIT license.