pax_global_header 0000666 0000000 0000000 00000000064 15130526717 0014521 g ustar 00root root 0000000 0000000 52 comment=ce958b4e6f305d6666a3c8025bb3dee20d6edd23
flexmock-0.13.0/ 0000775 0000000 0000000 00000000000 15130526717 0013412 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/.fmf/ 0000775 0000000 0000000 00000000000 15130526717 0014240 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/.fmf/version 0000664 0000000 0000000 00000000002 15130526717 0015640 0 ustar 00root root 0000000 0000000 1
flexmock-0.13.0/.github/ 0000775 0000000 0000000 00000000000 15130526717 0014752 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/.github/workflows/ 0000775 0000000 0000000 00000000000 15130526717 0017007 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/.github/workflows/ci.yml 0000664 0000000 0000000 00000004274 15130526717 0020134 0 ustar 00root root 0000000 0000000 name: Test and lint
on:
workflow_dispatch:
push:
branches: [master]
pull_request:
branches:
- "**"
env:
PYTHON_VERSION: "3.10"
jobs:
test:
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
python-version:
[
"pypy-3.10",
"pypy-3.11",
"3.10",
"3.11",
"3.12",
"3.13",
"3.14",
]
steps:
- uses: actions/checkout@v6
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v6
with:
python-version: ${{ matrix.python-version }}
cache: "pip"
- name: Install needed dependencies
run: |
pip install tox tox-gh-actions
- name: Run tests with tox
run: tox
lint:
runs-on: ubuntu-latest
env:
TARGETS: src tests
steps:
- uses: actions/checkout@v6
- name: Install Poetry
run: pipx install poetry
- name: Set up Python
uses: actions/setup-python@v6
with:
python-version: ${{ env.PYTHON_VERSION }}
cache: "poetry"
- name: Install dependencies
run: |
poetry config virtualenvs.in-project true
poetry install
- name: Run isort
run: poetry run isort --check-only ${TARGETS}
- name: Run black
run: poetry run black --check ${TARGETS}
- name: Run mypy
run: poetry run mypy ${TARGETS}
- name: Run pylint
run: poetry run pylint ${TARGETS}
test-docs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- name: Install Poetry
run: pipx install poetry
- name: Set up Python
uses: actions/setup-python@v6
with:
python-version: ${{ env.PYTHON_VERSION }}
cache: "poetry"
- name: Install dependencies
run: |
poetry config virtualenvs.in-project true
poetry install
- name: Generate man pages with Sphinx
run: poetry run python setup.py build_sphinx -W --keep-going -n -b man --build-dir build/sphinx
- name: Build docs with Mkdocs
run: poetry run make docs
flexmock-0.13.0/.github/workflows/publish.yml 0000664 0000000 0000000 00000002324 15130526717 0021201 0 ustar 00root root 0000000 0000000 name: Publish the release to PyPI
on:
release:
types: [created]
permissions:
id-token: write
env:
PYTHON_VERSION: "3.10"
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Set release name as environment variable
run: echo "RELEASE_NAME=${{ github.event.release.tag_name }}" >> $GITHUB_ENV
- name: Checkout code
uses: actions/checkout@v6
- name: Install Poetry
run: pipx install poetry
- name: Verify version matches tag
run: |
POETRY_VERSION=$(poetry version -s)
RELEASE_TAG=${{ github.event.release.tag_name }}
# Strip 'v' prefix if exists
CLEAN_TAG=${RELEASE_TAG#v}
if [ "$POETRY_VERSION" != "$CLEAN_TAG" ]; then
echo "Version mismatch!"
echo "Poetry version: $POETRY_VERSION"
echo "Release tag: $RELEASE_TAG"
exit 1
fi
- name: Set up Python
uses: actions/setup-python@v6
with:
python-version: ${{ env.PYTHON_VERSION }}
cache: "poetry"
- name: Build the release package
run: poetry build
- name: Publish the release to PyPI
uses: pypa/gh-action-pypi-publish@release/v1
flexmock-0.13.0/.gitignore 0000664 0000000 0000000 00000000211 15130526717 0015374 0 ustar 00root root 0000000 0000000 __pycache__/
*.py[cod]
.coverage
docs/_build
build/
dist/
*.egg-info
.venv
.pytest_cache
.mypy_cache
poetry.toml
.tox
_trial_temp
site
flexmock-0.13.0/.packit.yml 0000664 0000000 0000000 00000000671 15130526717 0015472 0 ustar 00root root 0000000 0000000 actions:
post-upstream-clone:
- wget -O fedora/python-flexmock.spec https://src.fedoraproject.org/rpms/python-flexmock/raw/rawhide/f/python-flexmock.spec
srpm_build_deps:
- wget
upstream_package_name: flexmock
downstream_package_name: python-flexmock
specfile_path: fedora/python-flexmock.spec
jobs:
- job: copr_build
trigger: pull_request
targets:
- fedora-all
- job: tests
trigger: pull_request
targets:
- fedora-all
flexmock-0.13.0/.readthedocs.yml 0000664 0000000 0000000 00000000450 15130526717 0016477 0 ustar 00root root 0000000 0000000 version: 2
mkdocs:
configuration: mkdocs.yml
build:
os: ubuntu-24.04
tools:
python: "3.10"
jobs:
post_create_environment:
- pip install poetry
post_install:
- poetry config virtualenvs.create false
- VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH poetry install
flexmock-0.13.0/CHANGELOG.md 0000664 0000000 0000000 00000011303 15130526717 0015221 0 ustar 00root root 0000000 0000000 # Changelog
This project follows semantic versioning.
Types of changes:
- **Added**: New features.
- **Changed**: Changes in existing functionality.
- **Deprecated**: Soon-to-be removed features.
- **Removed**: Removed features.
- **Fixed**: Bug fixes.
- **Infrastructure**: Changes in build or deployment infrastructure.
- **Documentation**: Changes in documentation.
## Unreleased
-
## Release 0.13.0
### Added
- Add Python 3.14 support.
### Removed
- Drop Python 3.8 and Python 3.9 support.
### Infrastructure
- Add Pytest 9.0 to tox test run.
## Release 0.12.2
### Fixed
- Fix typing of `and_raise` (exception instances are allowed).
- Fix teardown for spying on derived class methods.
### Documentation
- Remove python 3.6 mentions and add py-version config to pylint.
## Release 0.12.1
### Fixed
- Flexmock Pytest plugin entrypoint missing from `setup.py`.
## Release 0.12.0
### Added
- Add Python 3.12 and 3.13 support.
### Changed
- Add tox.ini to sdist to make the downstream testing easier.
### Removed
- Drop Python 3.6 and 3.7 support.
- Drop Pytest 5.x support.
## Fixed
- Fixed the pytest integration by switching from wrapping of the test runner to
the pytest plugin system.
## Release 0.11.3
### Added
- Add PEP 561 `py.typed` marker file.
### Changed
- Remove documentation and test files from wheels build.
- Re-organize unit tests.
### Documentation
- Add a warning about the usage of `.new_instances()` method in the documentation.
## Release 0.11.2
### Fixed
- Fix subunit testrunner integration is broken.
- Fix: TeamCity (PyCharm) testrunner integration is broken.
### Infrastructure
- Run tests with testtools, subunit, TeamCity, and doctest testrunners using tox.
### Documentation
- Test flexmock API examples using doctest.
- Re-add Sphinx support for generating man pages.
- Fix 404 page not loading CSS and Javascript resources in documentation.
- Small fixes to documentation.
## Release 0.11.1
### Fixed
- Fix Zope testrunner integration is broken.
### Infrastructure
- Run tests with Zope testrunner using tox.
## Release 0.11.0
### Added
- Add Python 3.8, 3.9, 3.10, and 3.11 support.
- Add type annotations.
### Changed
- **BREAKING CHANGE**: Flexmock needs to be imported explicitly using `from flexmock import flexmock`.
The hack that allowed flexmock to be imported directly using `import flexmock` did not work well with static analysis tools.
- Many error messages have been improved.
- Undocumented methods `Expectation.reset`, `Expectation.verify`, and `Expectation.match_args` that were unintentionally left public are now private methods.
- Undocumented attributes in `Mock` and `Expectation` are now private. These attributes were never meant to be accessed directly.
### Removed
- Drop Python 2.7, 3.4, 3.5 support.
- Drop Pytest 4.x support.
- Remove unittest2 and nose integrations. unittest2 and nose are not maintained anymore.
- **BREAKING CHANGE**: Removed support for calling `once`, `twice`, `never`, and `mock` methods
without parentheses. This allows code completion and static analysis to work with these methods.
### Fixed
- Fix `should_call` is broken if called on a fake object.
- Fix `and_raise` allows invalid arguments for an exception.
### Infrastructure
- Run linters and tests using Github Actions.
- Add coverage reporting using Codecov.
### Documentation
- Add contribution documentation.
- Use Mkdocs instead of Sphinx to build the documentation.
## Release 0.10.10
### Fixed
- Fix AttributeError raised when mocking a proxied object.
## Release 0.10.9
### Fixed
- Fix flexmock not mocking methods properly on derived classes.
## Release 0.10.8
### Fixed
- Fix `with_args` not working built-in functions.
## Release 0.10.7
### Fixed
- Fix `with_args` not working built-in functions and methods.
- Fix previous pytest `--durations` fix not working.
## Release 0.10.6
### Fixed
- Fix flexmock broken with Pytest 4 & 5.
- Fix new_instances method not working with Python 2.7.
- Fix multiple expectations for the same classmethod are not matched.
## Release 0.10.5
### Added
- Improve error message on unmatched method signature expectation.
### Fixed
- Fix using `should_call` passes wrong `runtime_self`.
- Fix pytest `--durations` flag when flexmock is installed.
## Release 0.10.4
### Added
- Add Python 3.6 and 3.7 support.
### Removed
- Drop Python 2.6, 3.3, and Jython support.
### Fixed
- Don't hide exception when flexmock is used as context manager.
- Fix expectation reset for static methods on PyPy 2.
- Ensure original exception is not suppressed in pytest hook.
Looking for older changelog entries? See [CHANGELOG](https://github.com/flexmock/flexmock/blob/884ed669e36140c514e362d2dee71433db1394f9/CHANGELOG) file in git history.
flexmock-0.13.0/CONTRIBUTING.md 0000664 0000000 0000000 00000004762 15130526717 0015654 0 ustar 00root root 0000000 0000000 # Contributing
## Setting up the development environment
The easiest way to setup your development environment and install the needed dependendecies is to use Poetry. For instructions, see [Poetry Docs - Installation](https://python-poetry.org/docs/#installation).
After installing Poetry you can use the following command to install all the needed dependencies:
```
poetry install
```
After installing the dependencies, you can enter the Python virtual environment that Poetry created with the following command:
```
poetry shell
```
## Running tests and linters
Tests and code linters are executed in CI pipeline when you open a new pull request, but you can also execute them locally. This project contains a Makefile that allows you to easily run all tests and linters with one command:
```sh
# Run tests and linters
make
# Run only tests
make test
# Run only linters
make lint
```
## Running tests with multiple Python versions using Tox
CI pipeline also runs tests using all the supported Python versions. You can use Tox if you want to run these tests yourself, but first you need to have all different Python versions available in your local system.
One option is to use [Pyenv](https://github.com/pyenv/pyenv) to manage different Python versions. For example, if you would want to run the test suite using Python versions 3.12 and 3.13, you can install the needed Python versions with the following commands:
```
pyenv install 3.12
pyenv install 3.13
```
After the installation, you can make the installed Python versions available globally:
```
pyenv global 3.12 3.13
```
Finally, you can run Tox and it should discover the installed Python version automatically:
```
tox -e py312,py313
```
You can omit the `-e` argument if you want to run the tests against all supported Python versions. If everything works, the output should be something similar to this:
```
...
__________ summary __________
py312: commands succeeded
py313: commands succeeded
congratulations :)
```
## Updating documentation
The documentation is built using [Mkdocs](https://www.mkdocs.org/). After
installing the development dependencies, you can simply run the following
command to serve the documentation on your local machine:
```
mkdocs serve
```
For more details, see [Mkdocs - User guide](https://www.mkdocs.org/user-guide/)
and [Mkdocs Material theme documentation](https://squidfunk.github.io/mkdocs-material/).
The documentation is automatically deployed to Read the Docs service on every
new commit to the default branch.
flexmock-0.13.0/LICENSE 0000664 0000000 0000000 00000002776 15130526717 0014433 0 ustar 00root root 0000000 0000000 Copyright 2011-2015 Herman Sheremetyev, Slavek Kabrda.
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
The views and conclusions contained in the software and documentation are those
of the authors and should not be interpreted as representing official policies,
either expressed or implied, of the FreeBSD Project.
flexmock-0.13.0/MANIFEST.in 0000664 0000000 0000000 00000000272 15130526717 0015151 0 ustar 00root root 0000000 0000000 include *.py
include CHANGELOG.md
include LICENSE
include README.md
include tox.ini
recursive-include tests *py
recursive-include docs *.md
include docs/conf.py
include docs/toctree.rst
flexmock-0.13.0/Makefile 0000664 0000000 0000000 00000003352 15130526717 0015055 0 ustar 00root root 0000000 0000000
color := $(shell tput setaf 2)
off := $(shell tput sgr0)
PYTHON := $(if $(shell command -v python3),python3,python)
TARGETS = src tests
.PHONY: all
all: lint test
.PHONY: lint
lint: isort black mypy pylint
.PHONY: test
test: install unittest doctest pytest
.PHONY: install
install:
@printf '\n\n*****************\n'
@printf '$(color)Install flexmock$(off)\n'
@printf '*****************\n'
ifeq (${VIRTUAL_ENV},)
@printf 'Skipping install. VIRTUAL_ENV is not set.\n'
else
pip install .
endif
.PHONY: pytest
pytest:
@printf '\n\n*****************\n'
@printf '$(color)Running pytest$(off)\n'
@printf '*****************\n'
pytest
.PHONY: unittest
unittest:
@printf '\n\n*****************\n'
@printf '$(color)Running unittest$(off)\n'
@printf '*****************\n'
PYTHONPATH=$(shell pwd) $(PYTHON) tests/test_unittest.py
.PHONY: doctest
doctest:
@printf '\n\n*****************\n'
@printf '$(color)Running doctest$(off)\n'
@printf '*****************\n'
$(PYTHON) tests/test_doctest.py
.PHONY: mypy
mypy:
@printf '\n\n*****************\n'
@printf '$(color)Running mypy$(off)\n'
@printf '*****************\n'
mypy ${TARGETS}
.PHONY: isort
isort:
@printf '\n\n*****************\n'
@printf '$(color)Running isort$(off)\n'
@printf '*****************\n'
isort --check-only ${TARGETS}
.PHONY: black
black:
@printf '\n\n*****************\n'
@printf '$(color)Running black$(off)\n'
@printf '*****************\n'
black --check ${TARGETS}
.PHONY: pylint
pylint:
@printf '\n\n*****************\n'
@printf '$(color)Running pylint$(off)\n'
@printf '*****************\n'
pylint ${TARGETS}
.PHONY: docs
docs:
@printf '\n\n*****************\n'
@printf '$(color)Test building docs$(off)\n'
@printf '*****************\n'
mkdocs build --strict
flexmock-0.13.0/README.md 0000664 0000000 0000000 00000007663 15130526717 0014705 0 ustar 00root root 0000000 0000000
flexmock - Mock, stub, and spy library for Python.
---
Flexmock is a testing library for Python that makes it easy to create mocks, stubs, and fakes.
## Features
- **Mock**: Easily create mock objects and make assertions about which methods or attributes were used and arguments they were called with.
- **Spy**: Proxy calls to object's original methods or attributes and make assertions based on return values or call count.
- **Fake**: Generate a fake objects to be used in your tests with ease.
- **Stub**: Create stub objects which replace parts of existing objects and classes with just one call.
- **No external dependencies**: Flexmock is lightweight and only uses Python standard library. There are no external dependencies.
- **Simple and intuitive**: Declarations are structured to read more like English sentences than API calls, so they are easy to learn and use.
- **Fully type annotated**: External API is fully type annotated so it works great with static analysis tools and editor auto-completion.
- **Integrations with test runners**: Integrates seamlessly with all major test runners like unittest, doctest, and pytest.
- **Python 3.10+ and PyPy3**: Extensively tested to work with latest Python versions.
## Installation
Install with pip:
```
pip install flexmock
```
## Examples
Flexmock features smooth integration with pretty much every popular test runner, so no special setup is necessary. Simply importing flexmock into your test module is sufficient to get started with any of the following examples:
```python
from flexmock import flexmock
```
### Mocks
Assertions take many flavors and flexmock has many different facilities to generate them:
```python
# Simplest is ensuring that a certain method is called
flexmock(Train).should_receive("get_tickets").once()
# Of course, it is also possible to provide a default return value
flexmock(Train).should_receive("get_destination").and_return("Paris").once()
# Or check that a method is called with specific arguments
flexmock(Train).should_receive("set_destination").with_args("Seoul").at_least().twice()
```
### Spies
Instead of mocking, there are also times when you want to execute the actual method and simply find out how many times it was called. Flexmock uses `should_call` to generate this sort of assertions instead of `should_receive`:
```python
# Verify that a method is called at most three times
flexmock(Train).should_call("get_tickets").at_most().times(3)
# Make sure that a method is never called with specific arguments
flexmock(Train).should_call("set_destination").with_args("Helsinki").never()
# More complex example with features like argument type and exception matching
flexmock(Train).should_call("crash").with_args(str, int).and_raise(AttributeError).once()
```
See more examples in the documentation.
## Documentation
User guide, examples, and a full API reference is available at: https://flexmock.readthedocs.io
## Contributing
Contributions are absolutely welcome and encouraged! See [CONTRIBUTING.md](https://github.com/flexmock/flexmock/blob/master/CONTRIBUTING.md) to get started.
flexmock-0.13.0/docs/ 0000775 0000000 0000000 00000000000 15130526717 0014342 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/docs/advanced/ 0000775 0000000 0000000 00000000000 15130526717 0016107 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/docs/advanced/builtin_functions.md 0000664 0000000 0000000 00000001311 15130526717 0022163 0 ustar 00root root 0000000 0000000 # Mocking builtins
Mocking or stubbing out builtin functions, such as `open()`, can be slightly
tricky. It is not always obvious when the builtin function you are trying to
mock might be internally called by the test runner and cause unexpected behavior
in the test. As a result, the recommended way to mock out builtin functions is
to always specify a fall-through with `should_call()` first and use `with_args()`
to limit the scope of your mock or stub to just the specific invocation you are
trying to replace:
```python
mock = flexmock(__builtins__)
mock.should_call("open") # set the fall-through
mock.should_receive("open").with_args("file_name").and_return(
flexmock(read=lambda: "some data")
)
```
flexmock-0.13.0/docs/advanced/call_order.md 0000664 0000000 0000000 00000001173 15130526717 0020541 0 ustar 00root root 0000000 0000000 # Asserting call order
Flexmock does not enforce call order by default, but it's easy to do if you need
to:
```python
flexmock(plane).should_receive("fly").with_args("left").and_return(
"ok"
).ordered()
flexmock(plane).should_receive("fly").with_args("right").and_return(
"ok"
).ordered()
```
The order of the flexmock calls is the order in which these methods will need to
be called by the code under test.
If method `fly()` above is called with the right arguments in the declared order
things will be fine and both will return `"ok"`. But trying to call `fly("right")`
before `fly("left")` will result in an exception.
flexmock-0.13.0/docs/advanced/chained_methods.md 0000664 0000000 0000000 00000003466 15130526717 0021560 0 ustar 00root root 0000000 0000000 # Chained methods
Let's say you have some code that looks something like the following:
```python
http = HTTP()
results = http.get_url("http://www.google.com").parse().display_results()
```
You could use flexmock to mock each of these method calls individually:
```python
mock = flexmock(
get_url=lambda: flexmock(parse=lambda: flexmock(display_results="ok"))
)
flexmock(HTTP).new_instances(mock)
```
But that looks really error prone and quite difficult to read. Here is a better
way:
```python
mock = flexmock()
flexmock(HTTP).new_instances(mock)
mock.should_receive("get_url.parse.display_results").and_return("ok")
```
When using this short-hand, flexmock will create intermediate objects and
expectations, returning the final one in the chain. As a result, any further
modifications, such as `with_args()` or `times()` modifiers, will only be
applied to the final method in the chain. If you need finer grained control,
such as specifying specific arguments to an intermediate method, you can always
fall back to the above long version.
Word of caution: because flexmock generates temporary intermediate mock objects
for each step along the chain, trying to mock two method call chains with the
same prefix will not work. That is, doing the following will fail to set up
the stub for `display_results()` because the one for `save_results()` overrides
it:
```python
flexmock(HTTP).should_receive("get_url.parse.display_results").and_return("ok")
flexmock(HTTP).should_receive("get_url.parse.save_results").and_return("ok")
```
In this situation, you should identify the point where the chain starts to
diverge and return a flexmock object that handles all the "tail" methods using
the same object:
```python
flexmock(HTTP).should_receive("get_url.parse").and_return(
flexmock(display_results="ok", save_results="ok")
)
```
flexmock-0.13.0/docs/advanced/generators.md 0000664 0000000 0000000 00000001174 15130526717 0020605 0 ustar 00root root 0000000 0000000 # Generators
In addition to returning values and raising exceptions, flexmock can also turn
the mocked method into a generator that yields successive values:
```python
>>> flexmock(plane).should_receive("flight_log").and_yield(
"take off", "flight", "landing")
>>> for i in plane.flight_log():
>>> print(i)
"take off"
"flight"
"landing"
```
You can also use Python's builtin `iter()` function to generate an iterable
return value:
```python
flexmock(plane, flight_log=iter(["take off", "flight", "landing"]))
```
In fact, the `and_yield()` modifier is just shorthand for
`should_receive().and_return(iter)` under the hood.
flexmock-0.13.0/docs/advanced/multiple_return.md 0000664 0000000 0000000 00000001224 15130526717 0021662 0 ustar 00root root 0000000 0000000 # Multiple return values
It is possible for the mocked method to return different values on successive
calls:
```python
>>> flexmock(group).should_receive("get_member").and_return("user1").and_return(
"user2"
).and_return("user3")
>>> group.get_member()
"user1"
>>> group.get_member()
"user2"
>>> group.get_member()
"user3"
```
Or use the short-hand form
```python
flexmock(group).should_receive("get_member").and_return(
"user1", "user2", "user3"
).one_by_one()
```
You can also mix return values with exception raises
```python
flexmock(group).should_receive("get_member").and_return("user1").and_raise(
Exception
).and_return("user2")
```
flexmock-0.13.0/docs/advanced/new_instances.md 0000664 0000000 0000000 00000003333 15130526717 0021273 0 ustar 00root root 0000000 0000000 # Fake new instances
Occasionally you will want a class to create fake objects when it is being
instantiated. Flexmock makes it easy and painless.
Your first option is to simply replace the class with a function:
```python
flexmock(some_module).should_receive("NameOfClass").and_return(fake_instance)
# fake_instance can be created with flexmock as well
```
The downside if this is that you may run into subtle issues since the class has
now been replaced by a function.
Flexmock offers another alternative using the `.new_instances()` method:
!!!warning
Usage of `.new_instances()` method is discouraged due to a bug in CPython
which prevents proper teardown of the mock. Due to this bug, the mock leaks
into other tests and can prevent creating new instances of the class. More
information in [issue #16](https://github.com/flexmock/flexmock/issues/16).
```python
>>> class Group: pass
>>> fake_group = flexmock(name="fake")
>>> flexmock(Group).new_instances(fake_group)
>>> Group().name == "fake"
True
```
It is also possible to return different fake objects in a sequence:
```python
>>> class Group: pass
>>> fake_group1 = flexmock(name="fake")
>>> fake_group2 = flexmock(name="real")
>>> flexmock(Group).new_instances(fake_group1, fake_group2)
>>> Group().name == "fake"
True
>>> Group().name == "real"
True
```
Another approach, if you're familiar with how instance instatiation is done in
Python, is to stub the `__new__` method directly:
```python
>>> flexmock(Group).should_receive("__new__").and_return(fake_group)
>>> # or, if you want to be even slicker
>>> flexmock(Group, __new__=fake_group)
```
In fact, the new_instances command is simply shorthand for
`should_receive("__new__").and_return()` under the hood.
flexmock-0.13.0/docs/advanced/replacing_functions.md 0000664 0000000 0000000 00000001311 15130526717 0022461 0 ustar 00root root 0000000 0000000 # Replacing methods
There are times when it is useful to replace a method with a custom lambda or
function, rather than simply stubbing it out, in order to return custom values
based on provided arguments or a global value that changes between method calls.
```python
flexmock(plane).should_receive("set_speed").replace_with(lambda x: x == 5)
```
There is also shorthand for this, similar to the shorthand for
`should_receive`/`and_return`:
```python
flexmock(plane, set_speed=lambda x: x == 5)
```
!!!note
Whenever the return value provided to the key=value shorthand is a callable (such as lambda), flexmock expands it to `should_receive().replace_with()` rather than `should_receive().and_return().`
flexmock-0.13.0/docs/advanced/state.md 0000664 0000000 0000000 00000002404 15130526717 0017551 0 ustar 00root root 0000000 0000000 # Conditional assertions
Flexmock supports conditional assertions based on external state. Consider
the rather contrived `Radio` class with the following methods:
```python
class Radio:
is_on = False
def __init__(self):
self.volume = 0
def switch_on(self):
self.is_on = True
def switch_off(self):
self.is_on = False
def select_channel(self):
return None
def adjust_volume(self, num):
self.volume = num
radio = Radio()
```
Now we can define some method call expectations dependent on the state of the
radio:
```python
flexmock(radio)
radio.should_receive("select_channel").when(lambda: radio.is_on).once()
radio.should_call("adjust_volume").with_args(5).when(lambda: radio.is_on).once()
```
Calling these while the radio is off will result in an error:
```python
radio.select_channel()
# Traceback (most recent call last):
# flexmock.StateError: select_channel expected to be called
# when condition is True
```
```python
radio.adjust_volume(5)
# Traceback (most recent call last):
# flexmock.StateError: adjust_volume expected to be called
# when condition is True
```
Turning the radio on will make things work as expected:
```python
radio.is_on = True
radio.select_channel()
radio.adjust_volume(5)
```
flexmock-0.13.0/docs/api.md 0000664 0000000 0000000 00000000124 15130526717 0015432 0 ustar 00root root 0000000 0000000 # API reference
::: flexmock.flexmock
::: flexmock.Mock
::: flexmock.Expectation
flexmock-0.13.0/docs/assets/ 0000775 0000000 0000000 00000000000 15130526717 0015644 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/docs/assets/extra.css 0000664 0000000 0000000 00000000267 15130526717 0017506 0 ustar 00root root 0000000 0000000 /* mkdocstrings */
div.doc-contents:not(.first) {
padding-left: 25px;
border-left: 4px solid rgba(230, 230, 230);
margin-bottom: 80px;
}
.md-typeset h2 {
font-weight: 400;
}
flexmock-0.13.0/docs/assets/icon_black.png 0000664 0000000 0000000 00000006431 15130526717 0020442 0 ustar 00root root 0000000 0000000 PNG
IHDR >a sBIT|d IDATx^wuG{ Db{aW +E!V?AP"+[bEEb]~ݻgٝ} 7h8~ս ?n ` XVa VwXk` ` `Xy XVa 5%ћ+Iuy^'t۞/\*մhn}B~:)E\-u+
TW +
USC7ԵψPZϫS>p]?K|<#=]K>'fZȥ-]B6 xkS_}D1sE > 9dENIk
| xz٢g zB LLL doVXZ~ `?+ ^z.).<7RaRz W{{R*,-4 ! $~k% Mb @ LL UXz} 07 ? 8{]\-&֯AGbb]?#X, djtc 8A
33ȓ ; 7Q]Keő(@ E) /. to S>ɐ4 ?W=wR8f Tw]}y9ݦv?&ƒ
] e#Y
H[ ,"4ڈa*e] p/#v] B b svI|Z|1,.5BO&CGJ@0}O[ zqG =|a\b"1 ;:+n998qy ![t xc#` $YľNZvw
wV Z
}85e& Ȝ=#z~ |a#/ˠ3`c5x1wx;o_e N/:ؖ&̹z>A
b. r 5diq xc
46 K3 k cx{^fbd$6O+ZuF'YT)bo}\ GSnJX^k@uX 8ld5kIC cD)ʜUS٫6yɛbFr!5tB r7)TOA9LT8;/.e ;66j̎b]}nMq5cR .عôKg/3PT\}]Ql KI yw6(
pzR-S#C2UlROUvⷍ ,Y~N@< };$nZK~juxS:ĐڶUڗWJ9OI i㆚ "/yCOS#O=24sgy*"
:ι 40wFtym /RO~n! DjxYxĹ
?AUڅp>J rvg*-P5ǿpmpY!#;U "&>P kE*nN5 F ShSk2ejd`=I5WbtRzZsB?E2쌖 D\,lnfg
JؗN
vc
nȀ\Xy5R12X jBEy{=}ޓ kduШUBߒ6>P] N%{>oZj
1C 56% N=,+ BHh;[ ~ ~AU5k!$X'E< ,fuk]В-Q]o
Cn A(2}ukQE r蘹5>i!3s0SLld3b @xsZ!')U͞:i8=spr َyyvlY +2WH0ՔhSȀcV 0ui o6 * ]ۑ/0 ?g94>l+Ȁl C6Pn
Rʉf=C NDqFL R,6 0 8Q F / * Vy ЏTc*Gq O p{A҄Ґ0&!xcg%S%!a(ZǾޛ3p!1SlAy=Z 'vOld*'$ 7JATe{ ս8^2e8
? "g`:֚?2ÖMcQ 3^?59S]E|hDPПn tԷ5uE Zt) P?_+O| X 8uEOջ X V y+6қ V SO$NG_r>L? r;O-_mlz<w9*4 ' - \ucS'~*`6&csh& wt6U:& eL9
7I= HRW Ӥ
$ iR _4G I @cԣ$uWx 1M @+?|aIC.& IENDB` flexmock-0.13.0/docs/assets/icon_white.png 0000664 0000000 0000000 00000016546 15130526717 0020516 0 ustar 00root root 0000000 0000000 PNG
IHDR >a zTXtRaw profile type exif xm! s 00HA棛쮴UO ^! #CRHjKO*pEԕSL+_Մp70LR8jgPҩOB|2W4*@@=sq{m?~ď7,}7x+]H"r> u6 g1t$eȣ\[C>S|L''({љ.?>O\ffiv{'wa]M.禮:npa*RAm@cRB JԩҠ}xg aP@TI f&E85X^ y˚cN1f S1fE}u B,c9z+t9J* ͎
ָ [3dtTY# \!)>BΒxRUrɀ<3,P #"ņ䈡IUYrʚs-5mYJt=wK;=v^BmHCG 6|QojשEnjjvIмNt21N6 y2N)q&XB $i'A7? _D D >My SSeI_/x ^B/K%?y iCCPICC profile x}=H@ _SR* ꐡ: *U(BP+`rФ!Iqq\ ~,V \uup77'E)IExwqeY]cf:1 Ѓ0b2YIJwqܟO[ 30muMO a%Y%>'tAG+ q.,̈IGb+mJF
_ bKGD pHYs tIME
#x IDATxQ uh"B]@iJ@"(ݦ@!I7Ї<Hl1d6)]4Abi!-M$Q}/psf|3wf˲s=|993p q q q q q q HD 7 "r.c[ + K3ye҆IޙPɑC#6}#\ Nr0$9 ?@='ئ m ߹. @X \P.W#{䮤@SE?Dc@Bc)I19u
^nI [ |fT*V
lk-8c Dc3 AMZDЮzèI/u`x@W v aV |Sj o("8B $ZLTu/&z2L qI1>oſDmRNaG%z c%&4aM+tJw,[T Ji-CXAYhKC=]b7h𗢺 jbXt(|d * YgSַ/,F=8ȳ)G Q ;Ep q qB\fK5+|vYDBp;_-, 瘺+ u庿I\ۆӨÁ:9qa K6H."9e@ $g9+8U-$O| uT"(" p`:ǁT≜,{/nmU (wu T 8$\ó&j%Qr;j75? 1^gK"4a +rTx3x'OFKx1to ^eE לws8oG#gK5:ȇ_ ތeWDo~&&[4Q25d-!5q"}`:X)cwT͡"r DmR]-{$"rF %ϟA͑ĶQwHޔl
ykƌ3k4Jf@tv4[ʈMJ:' ~QAOȥwi>]EOHrŔOvoDuk+g6_ut eX-(rYx_e]:yUN Sg.B2V6Z"XKRז0t?mΓ : hTi"Hw`-kg*xY9x0Ý=_>pR8F~ȉ'.7tqpDd N# g]W`g3~lqY?%2)5&v,ai 3%gFt>(K<] n&KZ<nq唋0_@Y6@7,z_3- |T:M~ ƍ,tL="XAyp7K c D'"WYD. ){rEop\ q8. 뛝L[ n IT`
p/\] d}{ o SzE $ _p$? Li`Q-\$=4"A"r?Ü' i IENDB` flexmock-0.13.0/docs/changelog.md 0000664 0000000 0000000 00000000176 15130526717 0016617 0 ustar 00root root 0000000 0000000
{!../CHANGELOG.md!}
flexmock-0.13.0/docs/compare.md 0000664 0000000 0000000 00000011411 15130526717 0016310 0 ustar 00root root 0000000 0000000 # Mock library comparison
This document shows a side-by-side comparison of how to accomplish some
basic tasks with flexmock compared to Python unittest Mock.
!!!note
Note that in comparison to standard library unittest, flexmock also does
automatic cleanup. This avoids leaking mocks to other tests in your
test suite.
## Simple fake object (attributes only):
```python
# flexmock
my_mock = flexmock(some_attribute="value", some_other_attribute="value2")
assert my_mock.some_attribute == "value"
assert my_mock.some_other_attribute == "value2"
# Mock
my_mock = mock.Mock()
my_mock.some_attribute = "value"
my_mock.some_other_attribute = "value2"
assert my_mock.some_attribute == "value"
assert my_mock.some_other_attribute == "value2"
```
## Simple fake object (with methods)
```python
# flexmock
my_mock = flexmock(some_method=lambda: "calculated value")
assert my_mock.some_method() == "calculated value"
# Mock
my_mock = mock.Mock()
my_mock.some_method.return_value = "calculated value"
assert my_mock.some_method() == "calculated value"
```
## Simple mock
```python
# flexmock
my_mock = flexmock()
my_mock.should_receive("some_method").and_return("value").once()
assert my_mock.some_method() == "value"
# Mock
my_mock = mock.Mock()
my_mock.some_method.return_value = "value"
assert my_mock.some_method() == "value"
my_mock.some_method.assert_called_once_with()
```
## Creating partial mocks
```python
# flexmock
flexmock(SomeClass).should_receive("some_method").and_return("value")
assert SomeClass.some_method() == "value"
# Mock
with mock.patch("SomeClass") as my_mock:
my_mock.some_method.return_value = "value"
assert SomeClass.some_method() == "value"
```
## Ensure calls are made in specific order
```python
# flexmock
my_mock = flexmock(SomeClass)
my_mock.should_receive("method1").ordered().and_return("first thing").once()
my_mock.should_receive("method2").ordered().and_return("second thing").once()
# execute the code
# Mock
my_mock = mock.Mock(spec=SomeClass)
my_mock.method1.return_value = "first thing"
my_mock.method2.return_value = "second thing"
# execute the code
assert my_mock.method_calls == [("method1",), ("method2",)]
```
## Raising exceptions
```python
# flexmock
my_mock = flexmock()
my_mock.should_receive("some_method").and_raise(SomeException, "message")
assertRaises(SomeException, my_mock.some_method)
# Mock
my_mock = mock.Mock()
my_mock.some_method.side_effect = SomeException("message")
assertRaises(SomeException, my_mock.some_method)
```
## Override new instances of a class
```python
# flexmock
flexmock(some_module.SomeClass).new_instances(some_other_object)
assert some_other_object == some_module.SomeClass()
# Mock
with mock.patch("somemodule.SomeClass") as MockClass:
MockClass.return_value = some_other_object
assert some_other_object == some_module.SomeClass()
```
## Verify a method was called multiple times
```python
# flexmock (verifies that the method gets called at least twice)
flexmock(some_object).should_receive("some_method").at_least().twice()
# execute the code
# Mock
my_mock = mock.Mock(spec=SomeClass)
# execute the code
assert my_mock.some_method.call_count >= 2
```
## Mock chained methods
```python
# flexmock
# (intermediate method calls are automatically assigned to temporary fake
# objects and can be called with any arguments)
flexmock(some_object).should_receive("method1.method2.method3").with_args(
arg1, arg2
).and_return("some value")
assert some_object.method1().method2().method3(arg1, arg2) == "some_value"
# Mock
my_mock = mock.Mock()
my_mock.method1.return_value.method2.return_value.method3.return_value = (
"some value"
)
method3 = my_mock.method1.return_value.method2.return_value.method3
method3.assert_called_once_with(arg1, arg2)
assert my_mock.method1().method2().method3(arg1, arg2) == "some_value"
```
## Mock context manager
```python
# flexmock
my_mock = flexmock()
with my_mock:
pass
# Mock
my_mock = mock.MagicMock()
with my_mock:
pass
```
## Mocking the builtin open used as a context manager
The following examples work in an interactive Python session but may not work
quite the same way in a script. See examples in the
[Mocking builtins](advanced/builtin_functions.md) section for more specific
flexmock instructions on mocking builtins.
```python
# flexmock
flexmock(__builtins__).should_receive("open").with_args("file_name").and_return(
flexmock(read=lambda: "some data")
).once()
with open("file_name") as file:
assert file.read() == "some data"
# Mock
with mock.patch("builtins.open") as my_mock:
my_mock.return_value.__enter__ = lambda s: s
my_mock.return_value.__exit__ = mock.Mock()
my_mock.return_value.read.return_value = "some data"
with open("file_name") as file:
assert file.read() == "some data"
my_mock.assert_called_once_with("file_name")
```
flexmock-0.13.0/docs/conf.py 0000664 0000000 0000000 00000002366 15130526717 0015650 0 ustar 00root root 0000000 0000000 """Flexmock Sphinx documentation configuration file.
This file adds Sphinx support for documentation so that man pages can be
generated using Sphinx.
"""
import os
import sys
# -- Path setup --------------------------------------------------------------
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
sys.path.insert(0, os.path.abspath(".."))
# -- Project information -----------------------------------------------------
project = "flexmock"
copyright = "2021, Slavek Kabrda, Herman Sheremetyev"
# -- General configuration ---------------------------------------------------
extensions = ["myst_parser"]
source_suffix = {
".rst": "restructuredtext",
".md": "markdown",
}
master_doc = "toctree"
exclude_patterns = ["api.md", "changelog.md", "contributing.md"]
# -- Options for manual page output ------------------------------------------
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
("toctree", "flexmock", "flexmock Documentation", ["Slavek Kabrda, Herman Sheremetyev"], 1)
]
flexmock-0.13.0/docs/contributing.md 0000664 0000000 0000000 00000000027 15130526717 0017372 0 ustar 00root root 0000000 0000000 {!../CONTRIBUTING.md!}
flexmock-0.13.0/docs/index.md 0000664 0000000 0000000 00000005021 15130526717 0015771 0 ustar 00root root 0000000 0000000 # Overview
flexmock - Mock, stub, and spy library for Python.
---
Contribute: https://github.com/flexmock/flexmock
Download: https://pypi.python.org/pypi/flexmock
---
Flexmock is a testing library for Python.
Its API is inspired by a Ruby library of the same name. However, it is not a goal of Python flexmock to be a clone of the Ruby version. Instead, the focus is on providing full support for testing Python programs and making the creation of fake objects as unobtrusive as possible.
As a result, Python flexmock removes a number of redundancies in the Ruby flexmock API, alters some defaults, and introduces several Python-only features.
Flexmock's design focuses on simplicity and intuitiveness. This means that the API is as lean as possible, though a few convenient short-hand methods are provided to aid brevity and readability.
Flexmock declarations are structured to read more like English sentences than API calls, and it is possible to chain them together in any order to achieve a high degree of expressiveness in a single line of code.
## Installation
Install with pip:
```
pip install flexmock
```
## Compatibility
Tested to work with:
- Python 3.10
- Python 3.11
- Python 3.12
- Python 3.13
- Python 3.14
- PyPy3
Automatically integrates with all major test runners, including:
- unittest
- pytest
- django
- twisted / trial
- doctest
- zope.testrunner
- subunit
- testtools
flexmock-0.13.0/docs/start.md 0000664 0000000 0000000 00000011144 15130526717 0016022 0 ustar 00root root 0000000 0000000 # Getting started
So what does flexmock actually help you do?
## Setup
Flexmock features smooth integration with pretty much every popular test runner,
so no special setup is necessary. Simply importing flexmock into your test
module is sufficient to get started with any of the following examples.
```python
from flexmock import flexmock
```
This will include flexmock in your test and make the necessary runner
modifications so no further setup or cleanup is necessary.
## Creating fake objects
Making a new object in Python requires defining a new class with all the fake
methods and attributes you are interested in emulating and then instantiating
it. For example, to create a FakePlane object to use in a test in place of a
real Plane object, we would need to do something like this:
```python
class FakePlane:
operational = True
model = "MIG-21"
def fly(self):
pass
plane = FakePlane() # this is tedious!
```
In other words, we must first create a class, make sure it contains all required
attributes and methods, and finally instantiate it to create the object.
Flexmock provides an easier way to generate a fake object on the fly using the
`flexmock()` function:
```python
plane = flexmock(operational=True, model="MIG-21")
```
It is also possible to add methods to this object using the same notation and
Python's handy lambda keyword to turn an attribute into a method:
```python
plane = flexmock(operational=True, model="MIG-21", fly=lambda: None)
```
## Stubs
While creating fake objects from scratch is often sufficient, many times it is
easier to take an existing object and simply stub out certain methods or replace
them with fake ones. Flexmock makes this easy as well:
```python
flexmock(
Train, # this can be an instance, a class, or a module
get_destination="Tokyo",
get_speed=200,
)
```
By passing a real object (or class or module) into the `flexmock()` function as
the first argument it is possible to modify that object in place and provide
default return values for any of its existing methods.
In addition to simply stubbing out return values, it can be useful to be able to
call an entirely different method and substitute return values based on
test-specific conditions:
```python
flexmock(Train).should_receive("get_route").replace_with(
lambda x: custom_get_route()
)
```
## Mocks
Expectations take many flavors, and flexmock has many different facilities and
modes to generate them. The first and simplest is ensuring that a certain method
is called:
```python
flexmock(Train).should_receive("get_destination").once()
```
The `.once()` modifier ensures that `Train.get_destination()` is called at some
point during the test and will raise an exception if this does not happen.
Of course, it is also possible to provide a default return value:
```python
flexmock(Train).should_receive("get_destination").and_return("Tokyo").once()
```
Or check that a method is called with specific arguments:
```python
flexmock(Train).should_receive("set_destination").with_args(
"Tokyo"
).at_least().times(1)
```
In this example we used `.times(1)` instead of `.once()` and added the
`.at_least()` modifier to demonstate that it is easy to match any number of
calls, including 0 calls or a variable amount of calls. As you've probably
guessed there is also an `at_most()` modifier.
## Spies
While replacing method calls with canned return values or checking that they are
called with specific arguments is quite useful, there are also times when you
want to execute the actual method and simply find out how many times it was
called. Flexmock uses `should_call()` to generate this sort of expectations
instead of `should_receive()`:
```python
flexmock(Train).should_call("get_destination").once()
```
In the above case the real `get_destination()` method will be executed, but
flexmock will raise an exception unless it is executed exactly once. All the
modifiers allowed with `should_receive()` can also be used with `should_call()`
so it is possible to tweak the allowed arguments, return values, and call
counts.
```python
flexmock(Train).should_call("set_destination").with_args(
object, str, int
).and_raise(Exception, re.compile("^No such dest.*")).once()
```
The above example introduces a handful of new capabilities -- matching
exceptions, matching argument types (object naturally matches any argument type)
and regex matching on string return values and arguments.
## Summary
Flexmock has many other features and capabilities, but hopefully the above
overview has given you enough of the flavor for the kind of things that it makes
possible. For more details see the [User Guide](usage/intro.md).
flexmock-0.13.0/docs/toctree.rst 0000664 0000000 0000000 00000000555 15130526717 0016546 0 ustar 00root root 0000000 0000000 Overview
========
.. toctree::
index
start
usage/intro
usage/mocking
usage/spying
usage/call_count
usage/argument_matching
advanced/builtin_functions
advanced/call_order
advanced/chained_methods
advanced/generators
advanced/multiple_return
advanced/new_instances
advanced/replacing_functions
advanced/state
compare
flexmock-0.13.0/docs/usage/ 0000775 0000000 0000000 00000000000 15130526717 0015446 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/docs/usage/argument_matching.md 0000664 0000000 0000000 00000006115 15130526717 0021467 0 ustar 00root root 0000000 0000000 # Argument matching
Creating an expectation with no arguments will by default match all arguments,
including no arguments.
```python
flexmock(plane).should_receive("fly").and_return("ok")
```
Above will be matched by any of the following:
```python
>>> plane.fly()
"ok"
>>> plane.fly("up")
"ok"
>>> plane.fly("up", "down")
"ok"
```
You can also match exactly no arguments:
```python
flexmock(plane).should_receive("fly").with_args()
```
Or match any single argument:
```python
flexmock(plane).should_receive("fly").with_args("left")
```
## Matching argument types
In addition to exact values, you can match against the type or class of the
argument:
```python
flexmock(plane).should_receive("fly").with_args(object)
```
Match any single string argument
```python
flexmock(plane).should_receive("fly").with_args(str)
```
Match the empty string using a compiled regular expression:
```python
regex = re.compile("^(up|down)$")
flexmock(plane).should_receive("fly").with_args(regex)
```
Match any set of three arguments where the first one is an integer, second one
is anything, and third is string 'notes' (matching against user defined classes
is also supported in the same fashion):
```python
flexmock(plane).should_receive("repair").with_args(int, object, "notes")
```
If the default argument matching based on types is not flexible enough, flexmock
will respect matcher objects that provide a custom `__eq__` method.
For example, when trying to match against contents of numpy arrays, equality is
undefined by the library so comparing two of them directly is meaningless unless
you use `all()` or `any()` on the return value of the comparison.
What you can do in this case is create a custom matcher object and flexmock will
use its `__eq__` method when comparing the arguments at runtime.
```python
class NumpyArrayMatcher:
def __init__(self, array):
self.array = array
def __eq__(self, other):
return all(other == self.array)
flexmock(obj).should_receive("function").with_args(NumpyArrayMatcher(array1))
```
The above approach will work for any objects that choose not to return proper
boolean comparison values, or if you simply find the default equality and
type-based matching not sufficiently specific.
## Multiple argument expectations
It is also possible to create multiple expectations for the same
method differentiated by arguments.
```python
flexmock(plane).should_receive("fly").and_return("ok")
flexmock(plane).should_receive("fly").with_args("up").and_return("bad")
```
Try to execute `plane.fly()` with any, or no, arguments as defined by the first
flexmock call will return the first value.
```python
>>> plane.fly()
"ok"
>>> plane.fly("forward", "down")
"ok"
```
But! If argument values match the more specific flexmock call the function
will return the other return value:
```python
>>> plane.fly("up")
"bad"
```
The order of the expectations being defined is significant, with later
expectations having higher precedence than previous ones. Which means
that if you reversed the order of the example expectations above the
more specific expectation would never be matched.
flexmock-0.13.0/docs/usage/call_count.md 0000664 0000000 0000000 00000001640 15130526717 0020114 0 ustar 00root root 0000000 0000000 # Asserting call counts
Using the `times(N)` modifier, or its aliases (`once`, `twice`, or `never`)
allows you to create call count expectations that will be automatically checked
by the test runner.
!!! note
If you do not provide `times` modifier. The mock is expected to be called
zero or any number of times. In other words, the call count is not asserted.
Ensure `fly("forward")` gets called exactly three times
```python
flexmock(plane).should_receive("fly").with_args("forward").times(3)
```
Ensure `turn("east")` gets called at least twice:
```python
flexmock(plane).should_receive("turn").with_args("east").at_least().twice()
```
Ensure `land("airfield")` gets called at most once:
```python
flexmock(plane).should_receive("land").with_args("airfield").at_most().once()
```
Ensure that `crash("boom!")` is never called:
```python
flexmock(plane).should_receive("crash").with_args("boom!").never()
```
flexmock-0.13.0/docs/usage/intro.md 0000664 0000000 0000000 00000003076 15130526717 0017131 0 ustar 00root root 0000000 0000000 # Introduction
In order to discuss flexmock usage it is important to define the following
terms:
- **Stub**: fake object that returns a canned value.
- **Mock**: fake object that returns a canned value and has an expectation, i.e.
it includes a built-in assertion.
- **Spy**: watches method calls and records/verifies if the method is called
with required parameters and/or returns expected values/exceptions.
## Overview
Flexmock declarations follow a consistent style of the following three forms:
1. `flexmock ( OBJECT ).COMMAND( ATTRIBUTE ).MODIFIER[.MODIFIER, ...]`
2. `flexmock ( OBJECT [, ATTRIBUTE=VALUE, ...] )`
3. `flexmock ( ATTRIBUTE=VALUE [, ATTRIBUTE=VALUE,...] )`
`OBJECT`: Either a module, a class, or an instance of a class.
`COMMAND`: One of **should_receive**, **should_call**, or **new_instances**.
These create the initial expectation object.
`ATTRIBUTE`: String name of an attribute.
`MODIFIER`: One of several Expectation modifiers, such as **with_args**,
**and_return**, **and_raise**, or **times**.
`VALUE`: Anything
## Style
While the order of modifiers is unimportant to flexmock, there is a preferred
convention that will make your tests more readable.
If using `with_args()`, place it before `should_return()`, `and_raise()`, and
`and_yield()` modifiers:
```python
flexmock(plane).should_receive("fly").with_args("up", "down").and_return("ok")
```
If using the `times()` modifier (or its aliases: `once`, `twice`, `never`),
place them at the end of the flexmock statement:
```python
flexmock(plane).should_receive("fly").and_return("ok").once()
```
flexmock-0.13.0/docs/usage/mocking.md 0000664 0000000 0000000 00000010041 15130526717 0017413 0 ustar 00root root 0000000 0000000 # Mocking
## Fake objects
Create a fake object with no attributes:
```python
fake = flexmock()
```
Specify attribute/return value pairs:
```python
fake_plane = flexmock(model="MIG-16", condition="used")
```
Specify methods/return value pairs:
```python
fake_plane = flexmock(fly=lambda: "voooosh!", land=lambda: "landed!")
```
You can mix method and non-method attributes by making the return value a lambda
for callable attributes.
Flexmock fake objects support the full range of flexmock commands but differ
from partial mocks (described below) in that
`should_receive()` can assign them new methods rather than being limited to
acting on methods they already possess.
```python
fake_plane = flexmock(fly=lambda: "vooosh!")
fake_plane.should_receive("land").and_return("landed!")
```
## Partial mocks
Flexmock provides three syntactic ways to hook into an existing object and
override its methods.
Mark the object as partially mocked, allowing it to be used to create new
expectations:
```python
flexmock(plane)
plane.should_receive("fly").and_return("vooosh!").once()
plane.should_receive("land").and_return("landed!").once()
```
!!! note
If you do not provide a return value then None is returned by default. Thus,
`and_return()` is equivalent to `and_return(None)` is equivalent to simply
leaving off `and_return`.
Equivalent syntax assigns the partially mocked object to a variable:
```python
plane = flexmock(plane)
plane.should_receive("fly").and_return("vooosh!").once()
plane.should_receive("land").and_return("landed!").once()
```
Or you can combine everything into one line if there is only one method to
override:
```python
flexmock(plane).should_receive("fly").and_return("vooosh!").once()
```
You can also return the mock object after setting the expectations:
```python
plane = flexmock(plane).should_receive("fly").and_return("vooosh!").mock()
```
Note the `mock` modifier above -- the expectation chain returns an Expectation
otherwise:
```python
plane.should_receive("land").with_args().and_return("foo", "bar")
```
!!! note
If you do not provide a `with_args()` modifier then any set of arguments,
including none, will be matched. However, if you specify `with_args()` the
expectation will only match exactly zero arguments.
## Attributes and properties
Just as you are able to stub return values for functions and methods, flexmock
also allows to stub out non-callable attributes and even (getter) properties.
Syntax for this is exactly the same as for methods and functions.
### Shorthand
Instead of writing out the lengthy `should_receive`/`and_return` statements, you
can also use the handy shorthand approach of passing them in as key=value pairs
to the `flexmock()` function. For example, we can stub out two methods of the
plane object in the same call:
```python
flexmock(plane, fly="voooosh!", land=("foo", "bar"))
```
This approach is handy and quick but only limited to stubs, i.e. it is not
possible to further modify these kind of calls with any of the usual modifiers
described below.
## Class level mocks
If the object you partially mock is a class, flexmock effectively replaces the
method for all instances of that class.
```python
class User:
def get_name(self):
return "George Bush"
flexmock(User)
User.should_receive("get_name").and_return("Bill Clinton")
bubba = User()
bubba.get_name() # returns "Bill Clinton"
```
## Raising exceptions
You can make the mocked method raise an exception instead of returning a value:
```python
flexmock(plane).should_receive("fly").and_raise(BadWeatherException)
```
You can also add a message to the exception being raised:
```python
flexmock(plane).should_receive("fly").and_raise(
BadWeatherException, "Oh noes, rain!"
)
```
## Private methods
One of the small pains of writing unit tests is that it can be difficult to get
at the private methods since Python "conveniently" renames them when you try to
access them from outside the object. With flexmock there is nothing special you
need to do to -- mocking private methods is exactly the same as any other
methods.
flexmock-0.13.0/docs/usage/spying.md 0000664 0000000 0000000 00000003056 15130526717 0017305 0 ustar 00root root 0000000 0000000 # Spying
In addition to stubbing out a given method and returning fake values, flexmock
also allows you to call the original method and make expectations based on its
return values/exceptions and the number of times the method is called with the
given arguments.
!!! note
`should_call()` changes the behavior of `and_return()` and `and_raise()`
to specify expectations rather than generate given values or exceptions.
Matching specific arguments:
```python
flexmock(plane).should_call("repair").with_args("wing", "cockpit").once()
```
Matching any arguments:
```python
flexmock(plane).should_call("turn").twice()
```
Matching specific return values:
```python
flexmock(plane).should_call("land").and_return("landed!")
```
Matching a regular expression:
```python
flexmock(plane).should_call("land").and_return(re.compile("^la"))
```
Match return values by class/type:
```python
flexmock(plane).should_call("fly").and_return(str, object, None)
```
Ensure that an appropriate exception is raised:
```python
flexmock(plane).should_call("fly").and_raise(BadWeatherException)
```
Check that the exception message matches your expectations:
```python
flexmock(plane).should_call("fly").and_raise(
BadWeatherException, "Oh noes, rain!"
)
```
Check that the exception message matches a regular expression:
```python
flexmock(plane).should_call("fly").and_raise(
BadWeatherException, re.compile("rain")
)
```
If either `and_return()` or `and_raise()` is provided, flexmock will verify that
the return value matches the expected return value or exception.
flexmock-0.13.0/fedora/ 0000775 0000000 0000000 00000000000 15130526717 0014652 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/fedora/README 0000664 0000000 0000000 00000000400 15130526717 0015524 0 ustar 00root root 0000000 0000000 # These files are used to build RPM packages out of flexmock and run tests using the package on Fedora Linux
RPM packaging: https://rpm-packaging-guide.github.io/
Testing framework: http://tmt.readthedocs.io/
CI system: https://packit.dev/testing-farm/
flexmock-0.13.0/fedora/main.fmf 0000664 0000000 0000000 00000001125 15130526717 0016267 0 ustar 00root root 0000000 0000000 # CI configuration to run upstream tests in Fedora ecosystem
# More info:
# Testing framework: http://tmt.readthedocs.io/
# CI system docs: https://packit.dev/testing-farm/
summary: Run tests on Fedora Linux
discover:
how: shell
tests:
- name: Upstream test suite
test: make test
# this is overridden in CI, but we want to run locally via CLI
provision:
how: local
prepare:
- name: packages
how: install
package:
- python3-pytest
- python3-twisted
- make
# make sure the tests are actually executed, the default way
execute:
how: tmt
flexmock-0.13.0/mkdocs.yml 0000664 0000000 0000000 00000003365 15130526717 0015424 0 ustar 00root root 0000000 0000000 site_name: flexmock - Documentation
site_description: flexmock - Mock, stub, and spy library for Python.
site_url: https://flexmock.readthedocs.io/en/latest/
theme:
name: material
logo: assets/icon_white.png
favicon: assets/icon_black.png
features:
- content.code.annotate
- navigation.expand
palette:
- media: "(prefers-color-scheme: light)"
scheme: default
toggle:
icon: material/lightbulb
name: Switch to dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
toggle:
icon: material/lightbulb-outline
name: Switch to light mode
icon:
repo: fontawesome/brands/github
extra_css:
- assets/extra.css
repo_name: flexmock
repo_url: https://github.com/flexmock/flexmock
edit_uri: ""
nav:
- Overview: index.md
- Getting started: start.md
- User Guide:
- usage/intro.md
- usage/mocking.md
- usage/spying.md
- usage/call_count.md
- usage/argument_matching.md
- Advanced Usage:
- advanced/builtin_functions.md
- advanced/call_order.md
- advanced/chained_methods.md
- advanced/generators.md
- advanced/multiple_return.md
- advanced/new_instances.md
- advanced/replacing_functions.md
- advanced/state.md
- Compare: compare.md
- Changelog: changelog.md
- Contributing: contributing.md
- API reference: api.md
plugins:
- search
- mkdocstrings:
handlers:
python:
options:
filters:
- "!^_" # exlude all members starting with _
show_source: false
show_root_heading: true
show_root_full_path: false
markdown_extensions:
- admonition
- pymdownx.details
- pymdownx.highlight
- pymdownx.inlinehilite
- pymdownx.superfences
- pymdownx.snippets
- markdown_include.include:
base_path: docs
flexmock-0.13.0/poetry.lock 0000664 0000000 0000000 00000464405 15130526717 0015623 0 ustar 00root root 0000000 0000000 # This file is automatically @generated by Poetry 2.2.1 and should not be changed by hand.
[[package]]
name = "alabaster"
version = "0.7.16"
description = "A light, configurable Sphinx theme"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "alabaster-0.7.16-py3-none-any.whl", hash = "sha256:b46733c07dce03ae4e150330b975c75737fa60f0a7c591b6c8bf4928a28e2c92"},
{file = "alabaster-0.7.16.tar.gz", hash = "sha256:75a8b99c28a5dad50dd7f8ccdd447a121ddb3892da9e53d1ca5cca3106d58d65"},
]
[[package]]
name = "astroid"
version = "4.0.3"
description = "An abstract syntax tree for Python with inference support."
optional = false
python-versions = ">=3.10.0"
groups = ["dev"]
files = [
{file = "astroid-4.0.3-py3-none-any.whl", hash = "sha256:864a0a34af1bd70e1049ba1e61cee843a7252c826d97825fcee9b2fcbd9e1b14"},
{file = "astroid-4.0.3.tar.gz", hash = "sha256:08d1de40d251cc3dc4a7a12726721d475ac189e4e583d596ece7422bc176bda3"},
]
[package.dependencies]
typing-extensions = {version = ">=4", markers = "python_version < \"3.11\""}
[[package]]
name = "attrs"
version = "25.4.0"
description = "Classes Without Boilerplate"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "attrs-25.4.0-py3-none-any.whl", hash = "sha256:adcf7e2a1fb3b36ac48d97835bb6d8ade15b8dcce26aba8bf1d14847b57a3373"},
{file = "attrs-25.4.0.tar.gz", hash = "sha256:16d5969b87f0859ef33a48b35d55ac1be6e42ae49d5e853b597db70c35c57e11"},
]
[[package]]
name = "automat"
version = "25.4.16"
description = "Self-service finite-state machines for the programmer on the go."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "automat-25.4.16-py3-none-any.whl", hash = "sha256:04e9bce696a8d5671ee698005af6e5a9fa15354140a87f4870744604dcdd3ba1"},
{file = "automat-25.4.16.tar.gz", hash = "sha256:0017591a5477066e90d26b0e696ddc143baafd87b588cfac8100bc6be9634de0"},
]
[package.extras]
visualize = ["Twisted (>=16.1.1)", "graphviz (>0.5.1)"]
[[package]]
name = "babel"
version = "2.17.0"
description = "Internationalization utilities"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "babel-2.17.0-py3-none-any.whl", hash = "sha256:4d0b53093fdfb4b21c92b5213dba5a1b23885afa8383709427046b21c366e5f2"},
{file = "babel-2.17.0.tar.gz", hash = "sha256:0c54cffb19f690cdcc52a3b50bcbf71e07a808d1c80d549f2459b9d2cf0afb9d"},
]
[package.extras]
dev = ["backports.zoneinfo ; python_version < \"3.9\"", "freezegun (>=1.0,<2.0)", "jinja2 (>=3.0)", "pytest (>=6.0)", "pytest-cov", "pytz", "setuptools", "tzdata ; sys_platform == \"win32\""]
[[package]]
name = "backrefs"
version = "6.1"
description = "A wrapper around re and regex that adds additional back references."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "backrefs-6.1-py310-none-any.whl", hash = "sha256:2a2ccb96302337ce61ee4717ceacfbf26ba4efb1d55af86564b8bbaeda39cac1"},
{file = "backrefs-6.1-py311-none-any.whl", hash = "sha256:e82bba3875ee4430f4de4b6db19429a27275d95a5f3773c57e9e18abc23fd2b7"},
{file = "backrefs-6.1-py312-none-any.whl", hash = "sha256:c64698c8d2269343d88947c0735cb4b78745bd3ba590e10313fbf3f78c34da5a"},
{file = "backrefs-6.1-py313-none-any.whl", hash = "sha256:4c9d3dc1e2e558965202c012304f33d4e0e477e1c103663fd2c3cc9bb18b0d05"},
{file = "backrefs-6.1-py314-none-any.whl", hash = "sha256:13eafbc9ccd5222e9c1f0bec563e6d2a6d21514962f11e7fc79872fd56cbc853"},
{file = "backrefs-6.1-py39-none-any.whl", hash = "sha256:a9e99b8a4867852cad177a6430e31b0f6e495d65f8c6c134b68c14c3c95bf4b0"},
{file = "backrefs-6.1.tar.gz", hash = "sha256:3bba1749aafe1db9b915f00e0dd166cba613b6f788ffd63060ac3485dc9be231"},
]
[package.extras]
extras = ["regex"]
[[package]]
name = "black"
version = "25.12.0"
description = "The uncompromising code formatter."
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "black-25.12.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f85ba1ad15d446756b4ab5f3044731bf68b777f8f9ac9cdabd2425b97cd9c4e8"},
{file = "black-25.12.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:546eecfe9a3a6b46f9d69d8a642585a6eaf348bcbbc4d87a19635570e02d9f4a"},
{file = "black-25.12.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:17dcc893da8d73d8f74a596f64b7c98ef5239c2cd2b053c0f25912c4494bf9ea"},
{file = "black-25.12.0-cp310-cp310-win_amd64.whl", hash = "sha256:09524b0e6af8ba7a3ffabdfc7a9922fb9adef60fed008c7cd2fc01f3048e6e6f"},
{file = "black-25.12.0-cp310-cp310-win_arm64.whl", hash = "sha256:b162653ed89eb942758efeb29d5e333ca5bb90e5130216f8369857db5955a7da"},
{file = "black-25.12.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:d0cfa263e85caea2cff57d8f917f9f51adae8e20b610e2b23de35b5b11ce691a"},
{file = "black-25.12.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1a2f578ae20c19c50a382286ba78bfbeafdf788579b053d8e4980afb079ab9be"},
{file = "black-25.12.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d3e1b65634b0e471d07ff86ec338819e2ef860689859ef4501ab7ac290431f9b"},
{file = "black-25.12.0-cp311-cp311-win_amd64.whl", hash = "sha256:a3fa71e3b8dd9f7c6ac4d818345237dfb4175ed3bf37cd5a581dbc4c034f1ec5"},
{file = "black-25.12.0-cp311-cp311-win_arm64.whl", hash = "sha256:51e267458f7e650afed8445dc7edb3187143003d52a1b710c7321aef22aa9655"},
{file = "black-25.12.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:31f96b7c98c1ddaeb07dc0f56c652e25bdedaac76d5b68a059d998b57c55594a"},
{file = "black-25.12.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:05dd459a19e218078a1f98178c13f861fe6a9a5f88fc969ca4d9b49eb1809783"},
{file = "black-25.12.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c1f68c5eff61f226934be6b5b80296cf6939e5d2f0c2f7d543ea08b204bfaf59"},
{file = "black-25.12.0-cp312-cp312-win_amd64.whl", hash = "sha256:274f940c147ddab4442d316b27f9e332ca586d39c85ecf59ebdea82cc9ee8892"},
{file = "black-25.12.0-cp312-cp312-win_arm64.whl", hash = "sha256:169506ba91ef21e2e0591563deda7f00030cb466e747c4b09cb0a9dae5db2f43"},
{file = "black-25.12.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:a05ddeb656534c3e27a05a29196c962877c83fa5503db89e68857d1161ad08a5"},
{file = "black-25.12.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:9ec77439ef3e34896995503865a85732c94396edcc739f302c5673a2315e1e7f"},
{file = "black-25.12.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0e509c858adf63aa61d908061b52e580c40eae0dfa72415fa47ac01b12e29baf"},
{file = "black-25.12.0-cp313-cp313-win_amd64.whl", hash = "sha256:252678f07f5bac4ff0d0e9b261fbb029fa530cfa206d0a636a34ab445ef8ca9d"},
{file = "black-25.12.0-cp313-cp313-win_arm64.whl", hash = "sha256:bc5b1c09fe3c931ddd20ee548511c64ebf964ada7e6f0763d443947fd1c603ce"},
{file = "black-25.12.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:0a0953b134f9335c2434864a643c842c44fba562155c738a2a37a4d61f00cad5"},
{file = "black-25.12.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:2355bbb6c3b76062870942d8cc450d4f8ac71f9c93c40122762c8784df49543f"},
{file = "black-25.12.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9678bd991cc793e81d19aeeae57966ee02909877cb65838ccffef24c3ebac08f"},
{file = "black-25.12.0-cp314-cp314-win_amd64.whl", hash = "sha256:97596189949a8aad13ad12fcbb4ae89330039b96ad6742e6f6b45e75ad5cfd83"},
{file = "black-25.12.0-cp314-cp314-win_arm64.whl", hash = "sha256:778285d9ea197f34704e3791ea9404cd6d07595745907dd2ce3da7a13627b29b"},
{file = "black-25.12.0-py3-none-any.whl", hash = "sha256:48ceb36c16dbc84062740049eef990bb2ce07598272e673c17d1a7720c71c828"},
{file = "black-25.12.0.tar.gz", hash = "sha256:8d3dd9cea14bff7ddc0eb243c811cdb1a011ebb4800a5f0335a01a68654796a7"},
]
[package.dependencies]
click = ">=8.0.0"
mypy-extensions = ">=0.4.3"
packaging = ">=22.0"
pathspec = ">=0.9.0"
platformdirs = ">=2"
pytokens = ">=0.3.0"
tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""}
typing-extensions = {version = ">=4.0.1", markers = "python_version < \"3.11\""}
[package.extras]
colorama = ["colorama (>=0.4.3)"]
d = ["aiohttp (>=3.10)"]
jupyter = ["ipython (>=7.8.0)", "tokenize-rt (>=3.2.0)"]
uvloop = ["uvloop (>=0.15.2)"]
[[package]]
name = "cachetools"
version = "6.2.4"
description = "Extensible memoizing collections and decorators"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "cachetools-6.2.4-py3-none-any.whl", hash = "sha256:69a7a52634fed8b8bf6e24a050fb60bff1c9bd8f6d24572b99c32d4e71e62a51"},
{file = "cachetools-6.2.4.tar.gz", hash = "sha256:82c5c05585e70b6ba2d3ae09ea60b79548872185d2f24ae1f2709d37299fd607"},
]
[[package]]
name = "certifi"
version = "2026.1.4"
description = "Python package for providing Mozilla's CA Bundle."
optional = false
python-versions = ">=3.7"
groups = ["dev"]
files = [
{file = "certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c"},
{file = "certifi-2026.1.4.tar.gz", hash = "sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120"},
]
[[package]]
name = "chardet"
version = "5.2.0"
description = "Universal encoding detector for Python 3"
optional = false
python-versions = ">=3.7"
groups = ["dev"]
files = [
{file = "chardet-5.2.0-py3-none-any.whl", hash = "sha256:e1cf59446890a00105fe7b7912492ea04b6e6f06d4b742b2c788469e34c82970"},
{file = "chardet-5.2.0.tar.gz", hash = "sha256:1b3b6ff479a8c414bc3fa2c0852995695c4a026dcd6d0633b2dd092ca39c1cf7"},
]
[[package]]
name = "charset-normalizer"
version = "3.4.4"
description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
optional = false
python-versions = ">=3.7"
groups = ["dev"]
files = [
{file = "charset_normalizer-3.4.4-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e824f1492727fa856dd6eda4f7cee25f8518a12f3c4a56a74e8095695089cf6d"},
{file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4bd5d4137d500351a30687c2d3971758aac9a19208fc110ccb9d7188fbe709e8"},
{file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:027f6de494925c0ab2a55eab46ae5129951638a49a34d87f4c3eda90f696b4ad"},
{file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f820802628d2694cb7e56db99213f930856014862f3fd943d290ea8438d07ca8"},
{file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:798d75d81754988d2565bff1b97ba5a44411867c0cf32b77a7e8f8d84796b10d"},
{file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d1bb833febdff5c8927f922386db610b49db6e0d4f4ee29601d71e7c2694313"},
{file = "charset_normalizer-3.4.4-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:9cd98cdc06614a2f768d2b7286d66805f94c48cde050acdbbb7db2600ab3197e"},
{file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:077fbb858e903c73f6c9db43374fd213b0b6a778106bc7032446a8e8b5b38b93"},
{file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:244bfb999c71b35de57821b8ea746b24e863398194a4014e4c76adc2bbdfeff0"},
{file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:64b55f9dce520635f018f907ff1b0df1fdc31f2795a922fb49dd14fbcdf48c84"},
{file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:faa3a41b2b66b6e50f84ae4a68c64fcd0c44355741c6374813a800cd6695db9e"},
{file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:6515f3182dbe4ea06ced2d9e8666d97b46ef4c75e326b79bb624110f122551db"},
{file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:cc00f04ed596e9dc0da42ed17ac5e596c6ccba999ba6bd92b0e0aef2f170f2d6"},
{file = "charset_normalizer-3.4.4-cp310-cp310-win32.whl", hash = "sha256:f34be2938726fc13801220747472850852fe6b1ea75869a048d6f896838c896f"},
{file = "charset_normalizer-3.4.4-cp310-cp310-win_amd64.whl", hash = "sha256:a61900df84c667873b292c3de315a786dd8dac506704dea57bc957bd31e22c7d"},
{file = "charset_normalizer-3.4.4-cp310-cp310-win_arm64.whl", hash = "sha256:cead0978fc57397645f12578bfd2d5ea9138ea0fac82b2f63f7f7c6877986a69"},
{file = "charset_normalizer-3.4.4-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:6e1fcf0720908f200cd21aa4e6750a48ff6ce4afe7ff5a79a90d5ed8a08296f8"},
{file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5f819d5fe9234f9f82d75bdfa9aef3a3d72c4d24a6e57aeaebba32a704553aa0"},
{file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a59cb51917aa591b1c4e6a43c132f0cdc3c76dbad6155df4e28ee626cc77a0a3"},
{file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8ef3c867360f88ac904fd3f5e1f902f13307af9052646963ee08ff4f131adafc"},
{file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d9e45d7faa48ee908174d8fe84854479ef838fc6a705c9315372eacbc2f02897"},
{file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:840c25fb618a231545cbab0564a799f101b63b9901f2569faecd6b222ac72381"},
{file = "charset_normalizer-3.4.4-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ca5862d5b3928c4940729dacc329aa9102900382fea192fc5e52eb69d6093815"},
{file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d9c7f57c3d666a53421049053eaacdd14bbd0a528e2186fcb2e672effd053bb0"},
{file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:277e970e750505ed74c832b4bf75dac7476262ee2a013f5574dd49075879e161"},
{file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:31fd66405eaf47bb62e8cd575dc621c56c668f27d46a61d975a249930dd5e2a4"},
{file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:0d3d8f15c07f86e9ff82319b3d9ef6f4bf907608f53fe9d92b28ea9ae3d1fd89"},
{file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:9f7fcd74d410a36883701fafa2482a6af2ff5ba96b9a620e9e0721e28ead5569"},
{file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ebf3e58c7ec8a8bed6d66a75d7fb37b55e5015b03ceae72a8e7c74495551e224"},
{file = "charset_normalizer-3.4.4-cp311-cp311-win32.whl", hash = "sha256:eecbc200c7fd5ddb9a7f16c7decb07b566c29fa2161a16cf67b8d068bd21690a"},
{file = "charset_normalizer-3.4.4-cp311-cp311-win_amd64.whl", hash = "sha256:5ae497466c7901d54b639cf42d5b8c1b6a4fead55215500d2f486d34db48d016"},
{file = "charset_normalizer-3.4.4-cp311-cp311-win_arm64.whl", hash = "sha256:65e2befcd84bc6f37095f5961e68a6f077bf44946771354a28ad434c2cce0ae1"},
{file = "charset_normalizer-3.4.4-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:0a98e6759f854bd25a58a73fa88833fba3b7c491169f86ce1180c948ab3fd394"},
{file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b5b290ccc2a263e8d185130284f8501e3e36c5e02750fc6b6bdeb2e9e96f1e25"},
{file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74bb723680f9f7a6234dcf67aea57e708ec1fbdf5699fb91dfd6f511b0a320ef"},
{file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f1e34719c6ed0b92f418c7c780480b26b5d9c50349e9a9af7d76bf757530350d"},
{file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2437418e20515acec67d86e12bf70056a33abdacb5cb1655042f6538d6b085a8"},
{file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:11d694519d7f29d6cd09f6ac70028dba10f92f6cdd059096db198c283794ac86"},
{file = "charset_normalizer-3.4.4-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ac1c4a689edcc530fc9d9aa11f5774b9e2f33f9a0c6a57864e90908f5208d30a"},
{file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:21d142cc6c0ec30d2efee5068ca36c128a30b0f2c53c1c07bd78cb6bc1d3be5f"},
{file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:5dbe56a36425d26d6cfb40ce79c314a2e4dd6211d51d6d2191c00bed34f354cc"},
{file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:5bfbb1b9acf3334612667b61bd3002196fe2a1eb4dd74d247e0f2a4d50ec9bbf"},
{file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:d055ec1e26e441f6187acf818b73564e6e6282709e9bcb5b63f5b23068356a15"},
{file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:af2d8c67d8e573d6de5bc30cdb27e9b95e49115cd9baad5ddbd1a6207aaa82a9"},
{file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:780236ac706e66881f3b7f2f32dfe90507a09e67d1d454c762cf642e6e1586e0"},
{file = "charset_normalizer-3.4.4-cp312-cp312-win32.whl", hash = "sha256:5833d2c39d8896e4e19b689ffc198f08ea58116bee26dea51e362ecc7cd3ed26"},
{file = "charset_normalizer-3.4.4-cp312-cp312-win_amd64.whl", hash = "sha256:a79cfe37875f822425b89a82333404539ae63dbdddf97f84dcbc3d339aae9525"},
{file = "charset_normalizer-3.4.4-cp312-cp312-win_arm64.whl", hash = "sha256:376bec83a63b8021bb5c8ea75e21c4ccb86e7e45ca4eb81146091b56599b80c3"},
{file = "charset_normalizer-3.4.4-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:e1f185f86a6f3403aa2420e815904c67b2f9ebc443f045edd0de921108345794"},
{file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b39f987ae8ccdf0d2642338faf2abb1862340facc796048b604ef14919e55ed"},
{file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3162d5d8ce1bb98dd51af660f2121c55d0fa541b46dff7bb9b9f86ea1d87de72"},
{file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:81d5eb2a312700f4ecaa977a8235b634ce853200e828fbadf3a9c50bab278328"},
{file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5bd2293095d766545ec1a8f612559f6b40abc0eb18bb2f5d1171872d34036ede"},
{file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a8a8b89589086a25749f471e6a900d3f662d1d3b6e2e59dcecf787b1cc3a1894"},
{file = "charset_normalizer-3.4.4-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc7637e2f80d8530ee4a78e878bce464f70087ce73cf7c1caf142416923b98f1"},
{file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f8bf04158c6b607d747e93949aa60618b61312fe647a6369f88ce2ff16043490"},
{file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:554af85e960429cf30784dd47447d5125aaa3b99a6f0683589dbd27e2f45da44"},
{file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:74018750915ee7ad843a774364e13a3db91682f26142baddf775342c3f5b1133"},
{file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c0463276121fdee9c49b98908b3a89c39be45d86d1dbaa22957e38f6321d4ce3"},
{file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:362d61fd13843997c1c446760ef36f240cf81d3ebf74ac62652aebaf7838561e"},
{file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9a26f18905b8dd5d685d6d07b0cdf98a79f3c7a918906af7cc143ea2e164c8bc"},
{file = "charset_normalizer-3.4.4-cp313-cp313-win32.whl", hash = "sha256:9b35f4c90079ff2e2edc5b26c0c77925e5d2d255c42c74fdb70fb49b172726ac"},
{file = "charset_normalizer-3.4.4-cp313-cp313-win_amd64.whl", hash = "sha256:b435cba5f4f750aa6c0a0d92c541fb79f69a387c91e61f1795227e4ed9cece14"},
{file = "charset_normalizer-3.4.4-cp313-cp313-win_arm64.whl", hash = "sha256:542d2cee80be6f80247095cc36c418f7bddd14f4a6de45af91dfad36d817bba2"},
{file = "charset_normalizer-3.4.4-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:da3326d9e65ef63a817ecbcc0df6e94463713b754fe293eaa03da99befb9a5bd"},
{file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8af65f14dc14a79b924524b1e7fffe304517b2bff5a58bf64f30b98bbc5079eb"},
{file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74664978bb272435107de04e36db5a9735e78232b85b77d45cfb38f758efd33e"},
{file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:752944c7ffbfdd10c074dc58ec2d5a8a4cd9493b314d367c14d24c17684ddd14"},
{file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d1f13550535ad8cff21b8d757a3257963e951d96e20ec82ab44bc64aeb62a191"},
{file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ecaae4149d99b1c9e7b88bb03e3221956f68fd6d50be2ef061b2381b61d20838"},
{file = "charset_normalizer-3.4.4-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:cb6254dc36b47a990e59e1068afacdcd02958bdcce30bb50cc1700a8b9d624a6"},
{file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c8ae8a0f02f57a6e61203a31428fa1d677cbe50c93622b4149d5c0f319c1d19e"},
{file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:47cc91b2f4dd2833fddaedd2893006b0106129d4b94fdb6af1f4ce5a9965577c"},
{file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:82004af6c302b5d3ab2cfc4cc5f29db16123b1a8417f2e25f9066f91d4411090"},
{file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:2b7d8f6c26245217bd2ad053761201e9f9680f8ce52f0fcd8d0755aeae5b2152"},
{file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:799a7a5e4fb2d5898c60b640fd4981d6a25f1c11790935a44ce38c54e985f828"},
{file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:99ae2cffebb06e6c22bdc25801d7b30f503cc87dbd283479e7b606f70aff57ec"},
{file = "charset_normalizer-3.4.4-cp314-cp314-win32.whl", hash = "sha256:f9d332f8c2a2fcbffe1378594431458ddbef721c1769d78e2cbc06280d8155f9"},
{file = "charset_normalizer-3.4.4-cp314-cp314-win_amd64.whl", hash = "sha256:8a6562c3700cce886c5be75ade4a5db4214fda19fede41d9792d100288d8f94c"},
{file = "charset_normalizer-3.4.4-cp314-cp314-win_arm64.whl", hash = "sha256:de00632ca48df9daf77a2c65a484531649261ec9f25489917f09e455cb09ddb2"},
{file = "charset_normalizer-3.4.4-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:ce8a0633f41a967713a59c4139d29110c07e826d131a316b50ce11b1d79b4f84"},
{file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:eaabd426fe94daf8fd157c32e571c85cb12e66692f15516a83a03264b08d06c3"},
{file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:c4ef880e27901b6cc782f1b95f82da9313c0eb95c3af699103088fa0ac3ce9ac"},
{file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:2aaba3b0819274cc41757a1da876f810a3e4d7b6eb25699253a4effef9e8e4af"},
{file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:778d2e08eda00f4256d7f672ca9fef386071c9202f5e4607920b86d7803387f2"},
{file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f155a433c2ec037d4e8df17d18922c3a0d9b3232a396690f17175d2946f0218d"},
{file = "charset_normalizer-3.4.4-cp38-cp38-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a8bf8d0f749c5757af2142fe7903a9df1d2e8aa3841559b2bad34b08d0e2bcf3"},
{file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:194f08cbb32dc406d6e1aea671a68be0823673db2832b38405deba2fb0d88f63"},
{file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_armv7l.whl", hash = "sha256:6aee717dcfead04c6eb1ce3bd29ac1e22663cdea57f943c87d1eab9a025438d7"},
{file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:cd4b7ca9984e5e7985c12bc60a6f173f3c958eae74f3ef6624bb6b26e2abbae4"},
{file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_riscv64.whl", hash = "sha256:b7cf1017d601aa35e6bb650b6ad28652c9cd78ee6caff19f3c28d03e1c80acbf"},
{file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:e912091979546adf63357d7e2ccff9b44f026c075aeaf25a52d0e95ad2281074"},
{file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:5cb4d72eea50c8868f5288b7f7f33ed276118325c1dfd3957089f6b519e1382a"},
{file = "charset_normalizer-3.4.4-cp38-cp38-win32.whl", hash = "sha256:837c2ce8c5a65a2035be9b3569c684358dfbf109fd3b6969630a87535495ceaa"},
{file = "charset_normalizer-3.4.4-cp38-cp38-win_amd64.whl", hash = "sha256:44c2a8734b333e0578090c4cd6b16f275e07aa6614ca8715e6c038e865e70576"},
{file = "charset_normalizer-3.4.4-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:a9768c477b9d7bd54bc0c86dbaebdec6f03306675526c9927c0e8a04e8f94af9"},
{file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1bee1e43c28aa63cb16e5c14e582580546b08e535299b8b6158a7c9c768a1f3d"},
{file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:fd44c878ea55ba351104cb93cc85e74916eb8fa440ca7903e57575e97394f608"},
{file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:0f04b14ffe5fdc8c4933862d8306109a2c51e0704acfa35d51598eb45a1e89fc"},
{file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:cd09d08005f958f370f539f186d10aec3377d55b9eeb0d796025d4886119d76e"},
{file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4fe7859a4e3e8457458e2ff592f15ccb02f3da787fcd31e0183879c3ad4692a1"},
{file = "charset_normalizer-3.4.4-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:fa09f53c465e532f4d3db095e0c55b615f010ad81803d383195b6b5ca6cbf5f3"},
{file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:7fa17817dc5625de8a027cb8b26d9fefa3ea28c8253929b8d6649e705d2835b6"},
{file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:5947809c8a2417be3267efc979c47d76a079758166f7d43ef5ae8e9f92751f88"},
{file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:4902828217069c3c5c71094537a8e623f5d097858ac6ca8252f7b4d10b7560f1"},
{file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:7c308f7e26e4363d79df40ca5b2be1c6ba9f02bdbccfed5abddb7859a6ce72cf"},
{file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:2c9d3c380143a1fedbff95a312aa798578371eb29da42106a29019368a475318"},
{file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:cb01158d8b88ee68f15949894ccc6712278243d95f344770fa7593fa2d94410c"},
{file = "charset_normalizer-3.4.4-cp39-cp39-win32.whl", hash = "sha256:2677acec1a2f8ef614c6888b5b4ae4060cc184174a938ed4e8ef690e15d3e505"},
{file = "charset_normalizer-3.4.4-cp39-cp39-win_amd64.whl", hash = "sha256:f8e160feb2aed042cd657a72acc0b481212ed28b1b9a95c0cee1621b524e1966"},
{file = "charset_normalizer-3.4.4-cp39-cp39-win_arm64.whl", hash = "sha256:b5d84d37db046c5ca74ee7bb47dd6cbc13f80665fdde3e8040bdd3fb015ecb50"},
{file = "charset_normalizer-3.4.4-py3-none-any.whl", hash = "sha256:7a32c560861a02ff789ad905a2fe94e3f840803362c84fecf1851cb4cf3dc37f"},
{file = "charset_normalizer-3.4.4.tar.gz", hash = "sha256:94537985111c35f28720e43603b8e7b43a6ecfb2ce1d3058bbe955b73404e21a"},
]
[[package]]
name = "click"
version = "8.3.1"
description = "Composable command line interface toolkit"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6"},
{file = "click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a"},
]
[package.dependencies]
colorama = {version = "*", markers = "platform_system == \"Windows\""}
[[package]]
name = "colorama"
version = "0.4.6"
description = "Cross-platform colored terminal text."
optional = false
python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7"
groups = ["dev"]
files = [
{file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"},
{file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"},
]
[[package]]
name = "constantly"
version = "23.10.4"
description = "Symbolic constants in Python"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "constantly-23.10.4-py3-none-any.whl", hash = "sha256:3fd9b4d1c3dc1ec9757f3c52aef7e53ad9323dbe39f51dfd4c43853b68dfa3f9"},
{file = "constantly-23.10.4.tar.gz", hash = "sha256:aa92b70a33e2ac0bb33cd745eb61776594dc48764b06c35e0efd050b7f1c7cbd"},
]
[[package]]
name = "coverage"
version = "7.13.1"
description = "Code coverage measurement for Python"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "coverage-7.13.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:e1fa280b3ad78eea5be86f94f461c04943d942697e0dac889fa18fff8f5f9147"},
{file = "coverage-7.13.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:c3d8c679607220979434f494b139dfb00131ebf70bb406553d69c1ff01a5c33d"},
{file = "coverage-7.13.1-cp310-cp310-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:339dc63b3eba969067b00f41f15ad161bf2946613156fb131266d8debc8e44d0"},
{file = "coverage-7.13.1-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:db622b999ffe49cb891f2fff3b340cdc2f9797d01a0a202a0973ba2562501d90"},
{file = "coverage-7.13.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d1443ba9acbb593fa7c1c29e011d7c9761545fe35e7652e85ce7f51a16f7e08d"},
{file = "coverage-7.13.1-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c832ec92c4499ac463186af72f9ed4d8daec15499b16f0a879b0d1c8e5cf4a3b"},
{file = "coverage-7.13.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:562ec27dfa3f311e0db1ba243ec6e5f6ab96b1edfcfc6cf86f28038bc4961ce6"},
{file = "coverage-7.13.1-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:4de84e71173d4dada2897e5a0e1b7877e5eefbfe0d6a44edee6ce31d9b8ec09e"},
{file = "coverage-7.13.1-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:a5a68357f686f8c4d527a2dc04f52e669c2fc1cbde38f6f7eb6a0e58cbd17cae"},
{file = "coverage-7.13.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:77cc258aeb29a3417062758975521eae60af6f79e930d6993555eeac6a8eac29"},
{file = "coverage-7.13.1-cp310-cp310-win32.whl", hash = "sha256:bb4f8c3c9a9f34423dba193f241f617b08ffc63e27f67159f60ae6baf2dcfe0f"},
{file = "coverage-7.13.1-cp310-cp310-win_amd64.whl", hash = "sha256:c8e2706ceb622bc63bac98ebb10ef5da80ed70fbd8a7999a5076de3afaef0fb1"},
{file = "coverage-7.13.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1a55d509a1dc5a5b708b5dad3b5334e07a16ad4c2185e27b40e4dba796ab7f88"},
{file = "coverage-7.13.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4d010d080c4888371033baab27e47c9df7d6fb28d0b7b7adf85a4a49be9298b3"},
{file = "coverage-7.13.1-cp311-cp311-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:d938b4a840fb1523b9dfbbb454f652967f18e197569c32266d4d13f37244c3d9"},
{file = "coverage-7.13.1-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:bf100a3288f9bb7f919b87eb84f87101e197535b9bd0e2c2b5b3179633324fee"},
{file = "coverage-7.13.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ef6688db9bf91ba111ae734ba6ef1a063304a881749726e0d3575f5c10a9facf"},
{file = "coverage-7.13.1-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0b609fc9cdbd1f02e51f67f51e5aee60a841ef58a68d00d5ee2c0faf357481a3"},
{file = "coverage-7.13.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:c43257717611ff5e9a1d79dce8e47566235ebda63328718d9b65dd640bc832ef"},
{file = "coverage-7.13.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:e09fbecc007f7b6afdfb3b07ce5bd9f8494b6856dd4f577d26c66c391b829851"},
{file = "coverage-7.13.1-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:a03a4f3a19a189919c7055098790285cc5c5b0b3976f8d227aea39dbf9f8bfdb"},
{file = "coverage-7.13.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3820778ea1387c2b6a818caec01c63adc5b3750211af6447e8dcfb9b6f08dbba"},
{file = "coverage-7.13.1-cp311-cp311-win32.whl", hash = "sha256:ff10896fa55167371960c5908150b434b71c876dfab97b69478f22c8b445ea19"},
{file = "coverage-7.13.1-cp311-cp311-win_amd64.whl", hash = "sha256:a998cc0aeeea4c6d5622a3754da5a493055d2d95186bad877b0a34ea6e6dbe0a"},
{file = "coverage-7.13.1-cp311-cp311-win_arm64.whl", hash = "sha256:fea07c1a39a22614acb762e3fbbb4011f65eedafcb2948feeef641ac78b4ee5c"},
{file = "coverage-7.13.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6f34591000f06e62085b1865c9bc5f7858df748834662a51edadfd2c3bfe0dd3"},
{file = "coverage-7.13.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:b67e47c5595b9224599016e333f5ec25392597a89d5744658f837d204e16c63e"},
{file = "coverage-7.13.1-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:3e7b8bd70c48ffb28461ebe092c2345536fb18bbbf19d287c8913699735f505c"},
{file = "coverage-7.13.1-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:c223d078112e90dc0e5c4e35b98b9584164bea9fbbd221c0b21c5241f6d51b62"},
{file = "coverage-7.13.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:794f7c05af0763b1bbd1b9e6eff0e52ad068be3b12cd96c87de037b01390c968"},
{file = "coverage-7.13.1-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0642eae483cc8c2902e4af7298bf886d605e80f26382124cddc3967c2a3df09e"},
{file = "coverage-7.13.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:9f5e772ed5fef25b3de9f2008fe67b92d46831bd2bc5bdc5dd6bfd06b83b316f"},
{file = "coverage-7.13.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:45980ea19277dc0a579e432aef6a504fe098ef3a9032ead15e446eb0f1191aee"},
{file = "coverage-7.13.1-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:e4f18eca6028ffa62adbd185a8f1e1dd242f2e68164dba5c2b74a5204850b4cf"},
{file = "coverage-7.13.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:f8dca5590fec7a89ed6826fce625595279e586ead52e9e958d3237821fbc750c"},
{file = "coverage-7.13.1-cp312-cp312-win32.whl", hash = "sha256:ff86d4e85188bba72cfb876df3e11fa243439882c55957184af44a35bd5880b7"},
{file = "coverage-7.13.1-cp312-cp312-win_amd64.whl", hash = "sha256:16cc1da46c04fb0fb128b4dc430b78fa2aba8a6c0c9f8eb391fd5103409a6ac6"},
{file = "coverage-7.13.1-cp312-cp312-win_arm64.whl", hash = "sha256:8d9bc218650022a768f3775dd7fdac1886437325d8d295d923ebcfef4892ad5c"},
{file = "coverage-7.13.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:cb237bfd0ef4d5eb6a19e29f9e528ac67ac3be932ea6b44fb6cc09b9f3ecff78"},
{file = "coverage-7.13.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:1dcb645d7e34dcbcc96cd7c132b1fc55c39263ca62eb961c064eb3928997363b"},
{file = "coverage-7.13.1-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:3d42df8201e00384736f0df9be2ced39324c3907607d17d50d50116c989d84cd"},
{file = "coverage-7.13.1-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:fa3edde1aa8807de1d05934982416cb3ec46d1d4d91e280bcce7cca01c507992"},
{file = "coverage-7.13.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9edd0e01a343766add6817bc448408858ba6b489039eaaa2018474e4001651a4"},
{file = "coverage-7.13.1-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:985b7836931d033570b94c94713c6dba5f9d3ff26045f72c3e5dbc5fe3361e5a"},
{file = "coverage-7.13.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ffed1e4980889765c84a5d1a566159e363b71d6b6fbaf0bebc9d3c30bc016766"},
{file = "coverage-7.13.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:8842af7f175078456b8b17f1b73a0d16a65dcbdc653ecefeb00a56b3c8c298c4"},
{file = "coverage-7.13.1-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:ccd7a6fca48ca9c131d9b0a2972a581e28b13416fc313fb98b6d24a03ce9a398"},
{file = "coverage-7.13.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:0403f647055de2609be776965108447deb8e384fe4a553c119e3ff6bfbab4784"},
{file = "coverage-7.13.1-cp313-cp313-win32.whl", hash = "sha256:549d195116a1ba1e1ae2f5ca143f9777800f6636eab917d4f02b5310d6d73461"},
{file = "coverage-7.13.1-cp313-cp313-win_amd64.whl", hash = "sha256:5899d28b5276f536fcf840b18b61a9fce23cc3aec1d114c44c07fe94ebeaa500"},
{file = "coverage-7.13.1-cp313-cp313-win_arm64.whl", hash = "sha256:868a2fae76dfb06e87291bcbd4dcbcc778a8500510b618d50496e520bd94d9b9"},
{file = "coverage-7.13.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:67170979de0dacac3f3097d02b0ad188d8edcea44ccc44aaa0550af49150c7dc"},
{file = "coverage-7.13.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:f80e2bb21bfab56ed7405c2d79d34b5dc0bc96c2c1d2a067b643a09fb756c43a"},
{file = "coverage-7.13.1-cp313-cp313t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:f83351e0f7dcdb14d7326c3d8d8c4e915fa685cbfdc6281f9470d97a04e9dfe4"},
{file = "coverage-7.13.1-cp313-cp313t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:bb3f6562e89bad0110afbe64e485aac2462efdce6232cdec7862a095dc3412f6"},
{file = "coverage-7.13.1-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:77545b5dcda13b70f872c3b5974ac64c21d05e65b1590b441c8560115dc3a0d1"},
{file = "coverage-7.13.1-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a4d240d260a1aed814790bbe1f10a5ff31ce6c21bc78f0da4a1e8268d6c80dbd"},
{file = "coverage-7.13.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:d2287ac9360dec3837bfdad969963a5d073a09a85d898bd86bea82aa8876ef3c"},
{file = "coverage-7.13.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:0d2c11f3ea4db66b5cbded23b20185c35066892c67d80ec4be4bab257b9ad1e0"},
{file = "coverage-7.13.1-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:3fc6a169517ca0d7ca6846c3c5392ef2b9e38896f61d615cb75b9e7134d4ee1e"},
{file = "coverage-7.13.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:d10a2ed46386e850bb3de503a54f9fe8192e5917fcbb143bfef653a9355e9a53"},
{file = "coverage-7.13.1-cp313-cp313t-win32.whl", hash = "sha256:75a6f4aa904301dab8022397a22c0039edc1f51e90b83dbd4464b8a38dc87842"},
{file = "coverage-7.13.1-cp313-cp313t-win_amd64.whl", hash = "sha256:309ef5706e95e62578cda256b97f5e097916a2c26247c287bbe74794e7150df2"},
{file = "coverage-7.13.1-cp313-cp313t-win_arm64.whl", hash = "sha256:92f980729e79b5d16d221038dbf2e8f9a9136afa072f9d5d6ed4cb984b126a09"},
{file = "coverage-7.13.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:97ab3647280d458a1f9adb85244e81587505a43c0c7cff851f5116cd2814b894"},
{file = "coverage-7.13.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:8f572d989142e0908e6acf57ad1b9b86989ff057c006d13b76c146ec6a20216a"},
{file = "coverage-7.13.1-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:d72140ccf8a147e94274024ff6fd8fb7811354cf7ef88b1f0a988ebaa5bc774f"},
{file = "coverage-7.13.1-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:d3c9f051b028810f5a87c88e5d6e9af3c0ff32ef62763bf15d29f740453ca909"},
{file = "coverage-7.13.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f398ba4df52d30b1763f62eed9de5620dcde96e6f491f4c62686736b155aa6e4"},
{file = "coverage-7.13.1-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:132718176cc723026d201e347f800cd1a9e4b62ccd3f82476950834dad501c75"},
{file = "coverage-7.13.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:9e549d642426e3579b3f4b92d0431543b012dcb6e825c91619d4e93b7363c3f9"},
{file = "coverage-7.13.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:90480b2134999301eea795b3a9dbf606c6fbab1b489150c501da84a959442465"},
{file = "coverage-7.13.1-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:e825dbb7f84dfa24663dd75835e7257f8882629fc11f03ecf77d84a75134b864"},
{file = "coverage-7.13.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:623dcc6d7a7ba450bbdbeedbaa0c42b329bdae16491af2282f12a7e809be7eb9"},
{file = "coverage-7.13.1-cp314-cp314-win32.whl", hash = "sha256:6e73ebb44dca5f708dc871fe0b90cf4cff1a13f9956f747cc87b535a840386f5"},
{file = "coverage-7.13.1-cp314-cp314-win_amd64.whl", hash = "sha256:be753b225d159feb397bd0bf91ae86f689bad0da09d3b301478cd39b878ab31a"},
{file = "coverage-7.13.1-cp314-cp314-win_arm64.whl", hash = "sha256:228b90f613b25ba0019361e4ab81520b343b622fc657daf7e501c4ed6a2366c0"},
{file = "coverage-7.13.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:60cfb538fe9ef86e5b2ab0ca8fc8d62524777f6c611dcaf76dc16fbe9b8e698a"},
{file = "coverage-7.13.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:57dfc8048c72ba48a8c45e188d811e5efd7e49b387effc8fb17e97936dde5bf6"},
{file = "coverage-7.13.1-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:3f2f725aa3e909b3c5fdb8192490bdd8e1495e85906af74fe6e34a2a77ba0673"},
{file = "coverage-7.13.1-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:9ee68b21909686eeb21dfcba2c3b81fee70dcf38b140dcd5aa70680995fa3aa5"},
{file = "coverage-7.13.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:724b1b270cb13ea2e6503476e34541a0b1f62280bc997eab443f87790202033d"},
{file = "coverage-7.13.1-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:916abf1ac5cf7eb16bc540a5bf75c71c43a676f5c52fcb9fe75a2bd75fb944e8"},
{file = "coverage-7.13.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:776483fd35b58d8afe3acbd9988d5de592ab6da2d2a865edfdbc9fdb43e7c486"},
{file = "coverage-7.13.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:b6f3b96617e9852703f5b633ea01315ca45c77e879584f283c44127f0f1ec564"},
{file = "coverage-7.13.1-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:bd63e7b74661fed317212fab774e2a648bc4bb09b35f25474f8e3325d2945cd7"},
{file = "coverage-7.13.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:933082f161bbb3e9f90d00990dc956120f608cdbcaeea15c4d897f56ef4fe416"},
{file = "coverage-7.13.1-cp314-cp314t-win32.whl", hash = "sha256:18be793c4c87de2965e1c0f060f03d9e5aff66cfeae8e1dbe6e5b88056ec153f"},
{file = "coverage-7.13.1-cp314-cp314t-win_amd64.whl", hash = "sha256:0e42e0ec0cd3e0d851cb3c91f770c9301f48647cb2877cb78f74bdaa07639a79"},
{file = "coverage-7.13.1-cp314-cp314t-win_arm64.whl", hash = "sha256:eaecf47ef10c72ece9a2a92118257da87e460e113b83cc0d2905cbbe931792b4"},
{file = "coverage-7.13.1-py3-none-any.whl", hash = "sha256:2016745cb3ba554469d02819d78958b571792bb68e31302610e898f80dd3a573"},
{file = "coverage-7.13.1.tar.gz", hash = "sha256:b7593fe7eb5feaa3fbb461ac79aac9f9fc0387a5ca8080b0c6fe2ca27b091afd"},
]
[package.dependencies]
tomli = {version = "*", optional = true, markers = "python_full_version <= \"3.11.0a6\" and extra == \"toml\""}
[package.extras]
toml = ["tomli ; python_full_version <= \"3.11.0a6\""]
[[package]]
name = "dill"
version = "0.4.0"
description = "serialize all of Python"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "dill-0.4.0-py3-none-any.whl", hash = "sha256:44f54bf6412c2c8464c14e8243eb163690a9800dbe2c367330883b19c7561049"},
{file = "dill-0.4.0.tar.gz", hash = "sha256:0633f1d2df477324f53a895b02c901fb961bdbf65a17122586ea7019292cbcf0"},
]
[package.extras]
graph = ["objgraph (>=1.7.2)"]
profile = ["gprof2dot (>=2022.7.29)"]
[[package]]
name = "distlib"
version = "0.4.0"
description = "Distribution utilities"
optional = false
python-versions = "*"
groups = ["dev"]
files = [
{file = "distlib-0.4.0-py2.py3-none-any.whl", hash = "sha256:9659f7d87e46584a30b5780e43ac7a2143098441670ff0a49d5f9034c54a6c16"},
{file = "distlib-0.4.0.tar.gz", hash = "sha256:feec40075be03a04501a973d81f633735b4b69f98b05450592310c0f401a4e0d"},
]
[[package]]
name = "docutils"
version = "0.19"
description = "Docutils -- Python Documentation Utilities"
optional = false
python-versions = ">=3.7"
groups = ["dev"]
files = [
{file = "docutils-0.19-py3-none-any.whl", hash = "sha256:5e1de4d849fee02c63b040a4a3fd567f4ab104defd8a5511fbbc24a8a017efbc"},
{file = "docutils-0.19.tar.gz", hash = "sha256:33995a6753c30b7f577febfc2c50411fec6aac7f7ffeb7c4cfe5991072dcf9e6"},
]
[[package]]
name = "exceptiongroup"
version = "1.3.1"
description = "Backport of PEP 654 (exception groups)"
optional = false
python-versions = ">=3.7"
groups = ["dev"]
markers = "python_version < \"3.11\""
files = [
{file = "exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598"},
{file = "exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219"},
]
[package.dependencies]
typing-extensions = {version = ">=4.6.0", markers = "python_version < \"3.13\""}
[package.extras]
test = ["pytest (>=6)"]
[[package]]
name = "filelock"
version = "3.20.2"
description = "A platform independent file lock."
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "filelock-3.20.2-py3-none-any.whl", hash = "sha256:fbba7237d6ea277175a32c54bb71ef814a8546d8601269e1bfc388de333974e8"},
{file = "filelock-3.20.2.tar.gz", hash = "sha256:a2241ff4ddde2a7cebddf78e39832509cb045d18ec1a09d7248d6bfc6bfbbe64"},
]
[[package]]
name = "ghp-import"
version = "2.1.0"
description = "Copy your docs directly to the gh-pages branch."
optional = false
python-versions = "*"
groups = ["dev"]
files = [
{file = "ghp-import-2.1.0.tar.gz", hash = "sha256:9c535c4c61193c2df8871222567d7fd7e5014d835f97dc7b7439069e2413d343"},
{file = "ghp_import-2.1.0-py3-none-any.whl", hash = "sha256:8337dd7b50877f163d4c0289bc1f1c7f127550241988d568c1db512c4324a619"},
]
[package.dependencies]
python-dateutil = ">=2.8.1"
[package.extras]
dev = ["flake8", "markdown", "twine", "wheel"]
[[package]]
name = "hyperlink"
version = "21.0.0"
description = "A featureful, immutable, and correct URL for Python."
optional = false
python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
groups = ["dev"]
files = [
{file = "hyperlink-21.0.0-py2.py3-none-any.whl", hash = "sha256:e6b14c37ecb73e89c77d78cdb4c2cc8f3fb59a885c5b3f819ff4ed80f25af1b4"},
{file = "hyperlink-21.0.0.tar.gz", hash = "sha256:427af957daa58bc909471c6c40f74c5450fa123dd093fc53efd2e91d2705a56b"},
]
[package.dependencies]
idna = ">=2.5"
[[package]]
name = "idna"
version = "3.11"
description = "Internationalized Domain Names in Applications (IDNA)"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea"},
{file = "idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902"},
]
[package.extras]
all = ["flake8 (>=7.1.1)", "mypy (>=1.11.2)", "pytest (>=8.3.2)", "ruff (>=0.6.2)"]
[[package]]
name = "imagesize"
version = "1.4.1"
description = "Getting image size from png/jpeg/jpeg2000/gif file"
optional = false
python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
groups = ["dev"]
files = [
{file = "imagesize-1.4.1-py2.py3-none-any.whl", hash = "sha256:0d8d18d08f840c19d0ee7ca1fd82490fdc3729b7ac93f49870406ddde8ef8d8b"},
{file = "imagesize-1.4.1.tar.gz", hash = "sha256:69150444affb9cb0d5cc5a92b3676f0b2fb7cd9ae39e947a5e11a36b4497cd4a"},
]
[[package]]
name = "incremental"
version = "24.11.0"
description = "A CalVer version manager that supports the future."
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "incremental-24.11.0-py3-none-any.whl", hash = "sha256:a34450716b1c4341fe6676a0598e88a39e04189f4dce5dc96f656e040baa10b3"},
{file = "incremental-24.11.0.tar.gz", hash = "sha256:87d3480dbb083c1d736222511a8cf380012a8176c2456d01ef483242abbbcf8c"},
]
[package.dependencies]
packaging = ">=17.0"
tomli = {version = "*", markers = "python_version < \"3.11\""}
[[package]]
name = "iniconfig"
version = "2.3.0"
description = "brain-dead simple config-ini parsing"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12"},
{file = "iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730"},
]
[[package]]
name = "iso8601"
version = "2.1.0"
description = "Simple module to parse ISO 8601 dates"
optional = false
python-versions = ">=3.7,<4.0"
groups = ["dev"]
files = [
{file = "iso8601-2.1.0-py3-none-any.whl", hash = "sha256:aac4145c4dcb66ad8b648a02830f5e2ff6c24af20f4f482689be402db2429242"},
{file = "iso8601-2.1.0.tar.gz", hash = "sha256:6b1d3829ee8921c4301998c909f7829fa9ed3cbdac0d3b16af2d743aed1ba8df"},
]
[[package]]
name = "isort"
version = "7.0.0"
description = "A Python utility / library to sort Python imports."
optional = false
python-versions = ">=3.10.0"
groups = ["dev"]
files = [
{file = "isort-7.0.0-py3-none-any.whl", hash = "sha256:1bcabac8bc3c36c7fb7b98a76c8abb18e0f841a3ba81decac7691008592499c1"},
{file = "isort-7.0.0.tar.gz", hash = "sha256:5513527951aadb3ac4292a41a16cbc50dd1642432f5e8c20057d414bdafb4187"},
]
[package.extras]
colors = ["colorama"]
plugins = ["setuptools"]
[[package]]
name = "jinja2"
version = "3.1.6"
description = "A very fast and expressive template engine."
optional = false
python-versions = ">=3.7"
groups = ["dev"]
files = [
{file = "jinja2-3.1.6-py3-none-any.whl", hash = "sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67"},
{file = "jinja2-3.1.6.tar.gz", hash = "sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d"},
]
[package.dependencies]
MarkupSafe = ">=2.0"
[package.extras]
i18n = ["Babel (>=2.7)"]
[[package]]
name = "librt"
version = "0.7.7"
description = "Mypyc runtime library"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
markers = "platform_python_implementation != \"PyPy\""
files = [
{file = "librt-0.7.7-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:e4836c5645f40fbdc275e5670819bde5ab5f2e882290d304e3c6ddab1576a6d0"},
{file = "librt-0.7.7-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:6ae8aec43117a645a31e5f60e9e3a0797492e747823b9bda6972d521b436b4e8"},
{file = "librt-0.7.7-cp310-cp310-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:aea05f701ccd2a76b34f0daf47ca5068176ff553510b614770c90d76ac88df06"},
{file = "librt-0.7.7-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7b16ccaeff0ed4355dfb76fe1ea7a5d6d03b5ad27f295f77ee0557bc20a72495"},
{file = "librt-0.7.7-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c48c7e150c095d5e3cea7452347ba26094be905d6099d24f9319a8b475fcd3e0"},
{file = "librt-0.7.7-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:4dcee2f921a8632636d1c37f1bbdb8841d15666d119aa61e5399c5268e7ce02e"},
{file = "librt-0.7.7-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:14ef0f4ac3728ffd85bfc58e2f2f48fb4ef4fa871876f13a73a7381d10a9f77c"},
{file = "librt-0.7.7-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:e4ab69fa37f8090f2d971a5d2bc606c7401170dbdae083c393d6cbf439cb45b8"},
{file = "librt-0.7.7-cp310-cp310-win32.whl", hash = "sha256:4bf3cc46d553693382d2abf5f5bd493d71bb0f50a7c0beab18aa13a5545c8900"},
{file = "librt-0.7.7-cp310-cp310-win_amd64.whl", hash = "sha256:f0c8fe5aeadd8a0e5b0598f8a6ee3533135ca50fd3f20f130f9d72baf5c6ac58"},
{file = "librt-0.7.7-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:a487b71fbf8a9edb72a8c7a456dda0184642d99cd007bc819c0b7ab93676a8ee"},
{file = "librt-0.7.7-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:f4d4efb218264ecf0f8516196c9e2d1a0679d9fb3bb15df1155a35220062eba8"},
{file = "librt-0.7.7-cp311-cp311-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:b8bb331aad734b059c4b450cd0a225652f16889e286b2345af5e2c3c625c3d85"},
{file = "librt-0.7.7-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:467dbd7443bda08338fc8ad701ed38cef48194017554f4c798b0a237904b3f99"},
{file = "librt-0.7.7-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:50d1d1ee813d2d1a3baf2873634ba506b263032418d16287c92ec1cc9c1a00cb"},
{file = "librt-0.7.7-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:c7e5070cf3ec92d98f57574da0224f8c73faf1ddd6d8afa0b8c9f6e86997bc74"},
{file = "librt-0.7.7-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:bdb9f3d865b2dafe7f9ad7f30ef563c80d0ddd2fdc8cc9b8e4f242f475e34d75"},
{file = "librt-0.7.7-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:8185c8497d45164e256376f9da5aed2bb26ff636c798c9dabe313b90e9f25b28"},
{file = "librt-0.7.7-cp311-cp311-win32.whl", hash = "sha256:44d63ce643f34a903f09ff7ca355aae019a3730c7afd6a3c037d569beeb5d151"},
{file = "librt-0.7.7-cp311-cp311-win_amd64.whl", hash = "sha256:7d13cc340b3b82134f8038a2bfe7137093693dcad8ba5773da18f95ad6b77a8a"},
{file = "librt-0.7.7-cp311-cp311-win_arm64.whl", hash = "sha256:983de36b5a83fe9222f4f7dcd071f9b1ac6f3f17c0af0238dadfb8229588f890"},
{file = "librt-0.7.7-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:2a85a1fc4ed11ea0eb0a632459ce004a2d14afc085a50ae3463cd3dfe1ce43fc"},
{file = "librt-0.7.7-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:c87654e29a35938baead1c4559858f346f4a2a7588574a14d784f300ffba0efd"},
{file = "librt-0.7.7-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:c9faaebb1c6212c20afd8043cd6ed9de0a47d77f91a6b5b48f4e46ed470703fe"},
{file = "librt-0.7.7-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1908c3e5a5ef86b23391448b47759298f87f997c3bd153a770828f58c2bb4630"},
{file = "librt-0.7.7-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:dbc4900e95a98fc0729523be9d93a8fedebb026f32ed9ffc08acd82e3e181503"},
{file = "librt-0.7.7-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a7ea4e1fbd253e5c68ea0fe63d08577f9d288a73f17d82f652ebc61fa48d878d"},
{file = "librt-0.7.7-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:ef7699b7a5a244b1119f85c5bbc13f152cd38240cbb2baa19b769433bae98e50"},
{file = "librt-0.7.7-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:955c62571de0b181d9e9e0a0303c8bc90d47670a5eff54cf71bf5da61d1899cf"},
{file = "librt-0.7.7-cp312-cp312-win32.whl", hash = "sha256:1bcd79be209313b270b0e1a51c67ae1af28adad0e0c7e84c3ad4b5cb57aaa75b"},
{file = "librt-0.7.7-cp312-cp312-win_amd64.whl", hash = "sha256:4353ee891a1834567e0302d4bd5e60f531912179578c36f3d0430f8c5e16b456"},
{file = "librt-0.7.7-cp312-cp312-win_arm64.whl", hash = "sha256:a76f1d679beccccdf8c1958e732a1dfcd6e749f8821ee59d7bec009ac308c029"},
{file = "librt-0.7.7-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8f4a0b0a3c86ba9193a8e23bb18f100d647bf192390ae195d84dfa0a10fb6244"},
{file = "librt-0.7.7-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5335890fea9f9e6c4fdf8683061b9ccdcbe47c6dc03ab8e9b68c10acf78be78d"},
{file = "librt-0.7.7-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:9b4346b1225be26def3ccc6c965751c74868f0578cbcba293c8ae9168483d811"},
{file = "librt-0.7.7-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a10b8eebdaca6e9fdbaf88b5aefc0e324b763a5f40b1266532590d5afb268a4c"},
{file = "librt-0.7.7-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:067be973d90d9e319e6eb4ee2a9b9307f0ecd648b8a9002fa237289a4a07a9e7"},
{file = "librt-0.7.7-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:23d2299ed007812cccc1ecef018db7d922733382561230de1f3954db28433977"},
{file = "librt-0.7.7-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:6b6f8ea465524aa4c7420c7cc4ca7d46fe00981de8debc67b1cc2e9957bb5b9d"},
{file = "librt-0.7.7-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:f8df32a99cc46eb0ee90afd9ada113ae2cafe7e8d673686cf03ec53e49635439"},
{file = "librt-0.7.7-cp313-cp313-win32.whl", hash = "sha256:86f86b3b785487c7760247bcdac0b11aa8bf13245a13ed05206286135877564b"},
{file = "librt-0.7.7-cp313-cp313-win_amd64.whl", hash = "sha256:4862cb2c702b1f905c0503b72d9d4daf65a7fdf5a9e84560e563471e57a56949"},
{file = "librt-0.7.7-cp313-cp313-win_arm64.whl", hash = "sha256:0996c83b1cb43c00e8c87835a284f9057bc647abd42b5871e5f941d30010c832"},
{file = "librt-0.7.7-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:23daa1ab0512bafdd677eb1bfc9611d8ffbe2e328895671e64cb34166bc1b8c8"},
{file = "librt-0.7.7-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:558a9e5a6f3cc1e20b3168fb1dc802d0d8fa40731f6e9932dcc52bbcfbd37111"},
{file = "librt-0.7.7-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:2567cb48dc03e5b246927ab35cbb343376e24501260a9b5e30b8e255dca0d1d2"},
{file = "librt-0.7.7-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6066c638cdf85ff92fc6f932d2d73c93a0e03492cdfa8778e6d58c489a3d7259"},
{file = "librt-0.7.7-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a609849aca463074c17de9cda173c276eb8fee9e441053529e7b9e249dc8b8ee"},
{file = "librt-0.7.7-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:add4e0a000858fe9bb39ed55f31085506a5c38363e6eb4a1e5943a10c2bfc3d1"},
{file = "librt-0.7.7-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:a3bfe73a32bd0bdb9a87d586b05a23c0a1729205d79df66dee65bb2e40d671ba"},
{file = "librt-0.7.7-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:0ecce0544d3db91a40f8b57ae26928c02130a997b540f908cefd4d279d6c5848"},
{file = "librt-0.7.7-cp314-cp314-win32.whl", hash = "sha256:8f7a74cf3a80f0c3b0ec75b0c650b2f0a894a2cec57ef75f6f72c1e82cdac61d"},
{file = "librt-0.7.7-cp314-cp314-win_amd64.whl", hash = "sha256:3d1fe2e8df3268dd6734dba33ededae72ad5c3a859b9577bc00b715759c5aaab"},
{file = "librt-0.7.7-cp314-cp314-win_arm64.whl", hash = "sha256:2987cf827011907d3dfd109f1be0d61e173d68b1270107bb0e89f2fca7f2ed6b"},
{file = "librt-0.7.7-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:8e92c8de62b40bfce91d5e12c6e8b15434da268979b1af1a6589463549d491e6"},
{file = "librt-0.7.7-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:f683dcd49e2494a7535e30f779aa1ad6e3732a019d80abe1309ea91ccd3230e3"},
{file = "librt-0.7.7-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:9b15e5d17812d4d629ff576699954f74e2cc24a02a4fc401882dd94f81daba45"},
{file = "librt-0.7.7-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c084841b879c4d9b9fa34e5d5263994f21aea7fd9c6add29194dbb41a6210536"},
{file = "librt-0.7.7-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:10c8fb9966f84737115513fecbaf257f9553d067a7dd45a69c2c7e5339e6a8dc"},
{file = "librt-0.7.7-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:9b5fb1ecb2c35362eab2dbd354fd1efa5a8440d3e73a68be11921042a0edc0ff"},
{file = "librt-0.7.7-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:d1454899909d63cc9199a89fcc4f81bdd9004aef577d4ffc022e600c412d57f3"},
{file = "librt-0.7.7-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:7ef28f2e7a016b29792fe0a2dd04dec75725b32a1264e390c366103f834a9c3a"},
{file = "librt-0.7.7-cp314-cp314t-win32.whl", hash = "sha256:5e419e0db70991b6ba037b70c1d5bbe92b20ddf82f31ad01d77a347ed9781398"},
{file = "librt-0.7.7-cp314-cp314t-win_amd64.whl", hash = "sha256:d6b7d93657332c817b8d674ef6bf1ab7796b4f7ce05e420fd45bd258a72ac804"},
{file = "librt-0.7.7-cp314-cp314t-win_arm64.whl", hash = "sha256:142c2cd91794b79fd0ce113bd658993b7ede0fe93057668c2f98a45ca00b7e91"},
{file = "librt-0.7.7-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:c8ffe3431d98cc043a14e88b21288b5ec7ee12cb01260e94385887f285ef9389"},
{file = "librt-0.7.7-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:e40d20ae1722d6b8ea6acf4597e789604649dcd9c295eb7361a28225bc2e9e12"},
{file = "librt-0.7.7-cp39-cp39-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:f2cb63c49bc96847c3bb8dca350970e4dcd19936f391cfdfd057dcb37c4fa97e"},
{file = "librt-0.7.7-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8f2f8dcf5ab9f80fb970c6fd780b398efb2f50c1962485eb8d3ab07788595a48"},
{file = "librt-0.7.7-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a1f5cc41a570269d1be7a676655875e3a53de4992a9fa38efb7983e97cf73d7c"},
{file = "librt-0.7.7-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:ff1fb2dfef035549565a4124998fadcb7a3d4957131ddf004a56edeb029626b3"},
{file = "librt-0.7.7-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:ab2a2a9cd7d044e1a11ca64a86ad3361d318176924bbe5152fbc69f99be20b8c"},
{file = "librt-0.7.7-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:ad3fc2d859a709baf9dd9607bb72f599b1cfb8a39eafd41307d0c3c4766763cb"},
{file = "librt-0.7.7-cp39-cp39-win32.whl", hash = "sha256:f83c971eb9d2358b6a18da51dc0ae00556ac7c73104dde16e9e14c15aaf685ca"},
{file = "librt-0.7.7-cp39-cp39-win_amd64.whl", hash = "sha256:264720fc288c86039c091a4ad63419a5d7cabbf1c1c9933336a957ed2483e570"},
{file = "librt-0.7.7.tar.gz", hash = "sha256:81d957b069fed1890953c3b9c3895c7689960f233eea9a1d9607f71ce7f00b2c"},
]
[[package]]
name = "markdown"
version = "3.10"
description = "Python implementation of John Gruber's Markdown."
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "markdown-3.10-py3-none-any.whl", hash = "sha256:b5b99d6951e2e4948d939255596523444c0e677c669700b1d17aa4a8a464cb7c"},
{file = "markdown-3.10.tar.gz", hash = "sha256:37062d4f2aa4b2b6b32aefb80faa300f82cc790cb949a35b8caede34f2b68c0e"},
]
[package.extras]
docs = ["mdx_gh_links (>=0.2)", "mkdocs (>=1.6)", "mkdocs-gen-files", "mkdocs-literate-nav", "mkdocs-nature (>=0.6)", "mkdocs-section-index", "mkdocstrings[python]"]
testing = ["coverage", "pyyaml"]
[[package]]
name = "markdown-include"
version = "0.8.1"
description = "A Python-Markdown extension which provides an 'include' function"
optional = false
python-versions = ">=3.7"
groups = ["dev"]
files = [
{file = "markdown-include-0.8.1.tar.gz", hash = "sha256:1d0623e0fc2757c38d35df53752768356162284259d259c486b4ab6285cdbbe3"},
{file = "markdown_include-0.8.1-py3-none-any.whl", hash = "sha256:32f0635b9cfef46997b307e2430022852529f7a5b87c0075c504283e7cc7db53"},
]
[package.dependencies]
markdown = ">=3.0"
[package.extras]
tests = ["pytest"]
[[package]]
name = "markdown-it-py"
version = "3.0.0"
description = "Python port of markdown-it. Markdown parsing, done right!"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "markdown-it-py-3.0.0.tar.gz", hash = "sha256:e3f60a94fa066dc52ec76661e37c851cb232d92f9886b15cb560aaada2df8feb"},
{file = "markdown_it_py-3.0.0-py3-none-any.whl", hash = "sha256:355216845c60bd96232cd8d8c40e8f9765cc86f46880e43a8fd22dc1a1a8cab1"},
]
[package.dependencies]
mdurl = ">=0.1,<1.0"
[package.extras]
benchmarking = ["psutil", "pytest", "pytest-benchmark"]
code-style = ["pre-commit (>=3.0,<4.0)"]
compare = ["commonmark (>=0.9,<1.0)", "markdown (>=3.4,<4.0)", "mistletoe (>=1.0,<2.0)", "mistune (>=2.0,<3.0)", "panflute (>=2.3,<3.0)"]
linkify = ["linkify-it-py (>=1,<3)"]
plugins = ["mdit-py-plugins"]
profiling = ["gprof2dot"]
rtd = ["jupyter_sphinx", "mdit-py-plugins", "myst-parser", "pyyaml", "sphinx", "sphinx-copybutton", "sphinx-design", "sphinx_book_theme"]
testing = ["coverage", "pytest", "pytest-cov", "pytest-regressions"]
[[package]]
name = "markupsafe"
version = "3.0.3"
description = "Safely add untrusted strings to HTML/XML markup."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "markupsafe-3.0.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:2f981d352f04553a7171b8e44369f2af4055f888dfb147d55e42d29e29e74559"},
{file = "markupsafe-3.0.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:e1c1493fb6e50ab01d20a22826e57520f1284df32f2d8601fdd90b6304601419"},
{file = "markupsafe-3.0.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1ba88449deb3de88bd40044603fafffb7bc2b055d626a330323a9ed736661695"},
{file = "markupsafe-3.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f42d0984e947b8adf7dd6dde396e720934d12c506ce84eea8476409563607591"},
{file = "markupsafe-3.0.3-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c0c0b3ade1c0b13b936d7970b1d37a57acde9199dc2aecc4c336773e1d86049c"},
{file = "markupsafe-3.0.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:0303439a41979d9e74d18ff5e2dd8c43ed6c6001fd40e5bf2e43f7bd9bbc523f"},
{file = "markupsafe-3.0.3-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:d2ee202e79d8ed691ceebae8e0486bd9a2cd4794cec4824e1c99b6f5009502f6"},
{file = "markupsafe-3.0.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:177b5253b2834fe3678cb4a5f0059808258584c559193998be2601324fdeafb1"},
{file = "markupsafe-3.0.3-cp310-cp310-win32.whl", hash = "sha256:2a15a08b17dd94c53a1da0438822d70ebcd13f8c3a95abe3a9ef9f11a94830aa"},
{file = "markupsafe-3.0.3-cp310-cp310-win_amd64.whl", hash = "sha256:c4ffb7ebf07cfe8931028e3e4c85f0357459a3f9f9490886198848f4fa002ec8"},
{file = "markupsafe-3.0.3-cp310-cp310-win_arm64.whl", hash = "sha256:e2103a929dfa2fcaf9bb4e7c091983a49c9ac3b19c9061b6d5427dd7d14d81a1"},
{file = "markupsafe-3.0.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1cc7ea17a6824959616c525620e387f6dd30fec8cb44f649e31712db02123dad"},
{file = "markupsafe-3.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4bd4cd07944443f5a265608cc6aab442e4f74dff8088b0dfc8238647b8f6ae9a"},
{file = "markupsafe-3.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b5420a1d9450023228968e7e6a9ce57f65d148ab56d2313fcd589eee96a7a50"},
{file = "markupsafe-3.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0bf2a864d67e76e5c9a34dc26ec616a66b9888e25e7b9460e1c76d3293bd9dbf"},
{file = "markupsafe-3.0.3-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc51efed119bc9cfdf792cdeaa4d67e8f6fcccab66ed4bfdd6bde3e59bfcbb2f"},
{file = "markupsafe-3.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:068f375c472b3e7acbe2d5318dea141359e6900156b5b2ba06a30b169086b91a"},
{file = "markupsafe-3.0.3-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:7be7b61bb172e1ed687f1754f8e7484f1c8019780f6f6b0786e76bb01c2ae115"},
{file = "markupsafe-3.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f9e130248f4462aaa8e2552d547f36ddadbeaa573879158d721bbd33dfe4743a"},
{file = "markupsafe-3.0.3-cp311-cp311-win32.whl", hash = "sha256:0db14f5dafddbb6d9208827849fad01f1a2609380add406671a26386cdf15a19"},
{file = "markupsafe-3.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:de8a88e63464af587c950061a5e6a67d3632e36df62b986892331d4620a35c01"},
{file = "markupsafe-3.0.3-cp311-cp311-win_arm64.whl", hash = "sha256:3b562dd9e9ea93f13d53989d23a7e775fdfd1066c33494ff43f5418bc8c58a5c"},
{file = "markupsafe-3.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d53197da72cc091b024dd97249dfc7794d6a56530370992a5e1a08983ad9230e"},
{file = "markupsafe-3.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1872df69a4de6aead3491198eaf13810b565bdbeec3ae2dc8780f14458ec73ce"},
{file = "markupsafe-3.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3a7e8ae81ae39e62a41ec302f972ba6ae23a5c5396c8e60113e9066ef893da0d"},
{file = "markupsafe-3.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d6dd0be5b5b189d31db7cda48b91d7e0a9795f31430b7f271219ab30f1d3ac9d"},
{file = "markupsafe-3.0.3-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:94c6f0bb423f739146aec64595853541634bde58b2135f27f61c1ffd1cd4d16a"},
{file = "markupsafe-3.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:be8813b57049a7dc738189df53d69395eba14fb99345e0a5994914a3864c8a4b"},
{file = "markupsafe-3.0.3-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:83891d0e9fb81a825d9a6d61e3f07550ca70a076484292a70fde82c4b807286f"},
{file = "markupsafe-3.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:77f0643abe7495da77fb436f50f8dab76dbc6e5fd25d39589a0f1fe6548bfa2b"},
{file = "markupsafe-3.0.3-cp312-cp312-win32.whl", hash = "sha256:d88b440e37a16e651bda4c7c2b930eb586fd15ca7406cb39e211fcff3bf3017d"},
{file = "markupsafe-3.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:26a5784ded40c9e318cfc2bdb30fe164bdb8665ded9cd64d500a34fb42067b1c"},
{file = "markupsafe-3.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:35add3b638a5d900e807944a078b51922212fb3dedb01633a8defc4b01a3c85f"},
{file = "markupsafe-3.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795"},
{file = "markupsafe-3.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219"},
{file = "markupsafe-3.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6"},
{file = "markupsafe-3.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676"},
{file = "markupsafe-3.0.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9"},
{file = "markupsafe-3.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1"},
{file = "markupsafe-3.0.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc"},
{file = "markupsafe-3.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12"},
{file = "markupsafe-3.0.3-cp313-cp313-win32.whl", hash = "sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed"},
{file = "markupsafe-3.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5"},
{file = "markupsafe-3.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485"},
{file = "markupsafe-3.0.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73"},
{file = "markupsafe-3.0.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37"},
{file = "markupsafe-3.0.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19"},
{file = "markupsafe-3.0.3-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025"},
{file = "markupsafe-3.0.3-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6"},
{file = "markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f"},
{file = "markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb"},
{file = "markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009"},
{file = "markupsafe-3.0.3-cp313-cp313t-win32.whl", hash = "sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354"},
{file = "markupsafe-3.0.3-cp313-cp313t-win_amd64.whl", hash = "sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218"},
{file = "markupsafe-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287"},
{file = "markupsafe-3.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:eaa9599de571d72e2daf60164784109f19978b327a3910d3e9de8c97b5b70cfe"},
{file = "markupsafe-3.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c47a551199eb8eb2121d4f0f15ae0f923d31350ab9280078d1e5f12b249e0026"},
{file = "markupsafe-3.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f34c41761022dd093b4b6896d4810782ffbabe30f2d443ff5f083e0cbbb8c737"},
{file = "markupsafe-3.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:457a69a9577064c05a97c41f4e65148652db078a3a509039e64d3467b9e7ef97"},
{file = "markupsafe-3.0.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e8afc3f2ccfa24215f8cb28dcf43f0113ac3c37c2f0f0806d8c70e4228c5cf4d"},
{file = "markupsafe-3.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:ec15a59cf5af7be74194f7ab02d0f59a62bdcf1a537677ce67a2537c9b87fcda"},
{file = "markupsafe-3.0.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:0eb9ff8191e8498cca014656ae6b8d61f39da5f95b488805da4bb029cccbfbaf"},
{file = "markupsafe-3.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2713baf880df847f2bece4230d4d094280f4e67b1e813eec43b4c0e144a34ffe"},
{file = "markupsafe-3.0.3-cp314-cp314-win32.whl", hash = "sha256:729586769a26dbceff69f7a7dbbf59ab6572b99d94576a5592625d5b411576b9"},
{file = "markupsafe-3.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:bdc919ead48f234740ad807933cdf545180bfbe9342c2bb451556db2ed958581"},
{file = "markupsafe-3.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:5a7d5dc5140555cf21a6fefbdbf8723f06fcd2f63ef108f2854de715e4422cb4"},
{file = "markupsafe-3.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:1353ef0c1b138e1907ae78e2f6c63ff67501122006b0f9abad68fda5f4ffc6ab"},
{file = "markupsafe-3.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1085e7fbddd3be5f89cc898938f42c0b3c711fdcb37d75221de2666af647c175"},
{file = "markupsafe-3.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b52b4fb9df4eb9ae465f8d0c228a00624de2334f216f178a995ccdcf82c4634"},
{file = "markupsafe-3.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fed51ac40f757d41b7c48425901843666a6677e3e8eb0abcff09e4ba6e664f50"},
{file = "markupsafe-3.0.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f190daf01f13c72eac4efd5c430a8de82489d9cff23c364c3ea822545032993e"},
{file = "markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e56b7d45a839a697b5eb268c82a71bd8c7f6c94d6fd50c3d577fa39a9f1409f5"},
{file = "markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:f3e98bb3798ead92273dc0e5fd0f31ade220f59a266ffd8a4f6065e0a3ce0523"},
{file = "markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5678211cb9333a6468fb8d8be0305520aa073f50d17f089b5b4b477ea6e67fdc"},
{file = "markupsafe-3.0.3-cp314-cp314t-win32.whl", hash = "sha256:915c04ba3851909ce68ccc2b8e2cd691618c4dc4c4232fb7982bca3f41fd8c3d"},
{file = "markupsafe-3.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4faffd047e07c38848ce017e8725090413cd80cbc23d86e55c587bf979e579c9"},
{file = "markupsafe-3.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:32001d6a8fc98c8cb5c947787c5d08b0a50663d139f1305bac5885d98d9b40fa"},
{file = "markupsafe-3.0.3-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:15d939a21d546304880945ca1ecb8a039db6b4dc49b2c5a400387cdae6a62e26"},
{file = "markupsafe-3.0.3-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:f71a396b3bf33ecaa1626c255855702aca4d3d9fea5e051b41ac59a9c1c41edc"},
{file = "markupsafe-3.0.3-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0f4b68347f8c5eab4a13419215bdfd7f8c9b19f2b25520968adfad23eb0ce60c"},
{file = "markupsafe-3.0.3-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e8fc20152abba6b83724d7ff268c249fa196d8259ff481f3b1476383f8f24e42"},
{file = "markupsafe-3.0.3-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:949b8d66bc381ee8b007cd945914c721d9aba8e27f71959d750a46f7c282b20b"},
{file = "markupsafe-3.0.3-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:3537e01efc9d4dccdf77221fb1cb3b8e1a38d5428920e0657ce299b20324d758"},
{file = "markupsafe-3.0.3-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:591ae9f2a647529ca990bc681daebdd52c8791ff06c2bfa05b65163e28102ef2"},
{file = "markupsafe-3.0.3-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:a320721ab5a1aba0a233739394eb907f8c8da5c98c9181d1161e77a0c8e36f2d"},
{file = "markupsafe-3.0.3-cp39-cp39-win32.whl", hash = "sha256:df2449253ef108a379b8b5d6b43f4b1a8e81a061d6537becd5582fba5f9196d7"},
{file = "markupsafe-3.0.3-cp39-cp39-win_amd64.whl", hash = "sha256:7c3fb7d25180895632e5d3148dbdc29ea38ccb7fd210aa27acbd1201a1902c6e"},
{file = "markupsafe-3.0.3-cp39-cp39-win_arm64.whl", hash = "sha256:38664109c14ffc9e7437e86b4dceb442b0096dfe3541d7864d9cbe1da4cf36c8"},
{file = "markupsafe-3.0.3.tar.gz", hash = "sha256:722695808f4b6457b320fdc131280796bdceb04ab50fe1795cd540799ebe1698"},
]
[[package]]
name = "mccabe"
version = "0.7.0"
description = "McCabe checker, plugin for flake8"
optional = false
python-versions = ">=3.6"
groups = ["dev"]
files = [
{file = "mccabe-0.7.0-py2.py3-none-any.whl", hash = "sha256:6c2d30ab6be0e4a46919781807b4f0d834ebdd6c6e3dca0bda5a15f863427b6e"},
{file = "mccabe-0.7.0.tar.gz", hash = "sha256:348e0240c33b60bbdf4e523192ef919f28cb2c3d7d5c7794f74009290f236325"},
]
[[package]]
name = "mdit-py-plugins"
version = "0.5.0"
description = "Collection of plugins for markdown-it-py"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "mdit_py_plugins-0.5.0-py3-none-any.whl", hash = "sha256:07a08422fc1936a5d26d146759e9155ea466e842f5ab2f7d2266dd084c8dab1f"},
{file = "mdit_py_plugins-0.5.0.tar.gz", hash = "sha256:f4918cb50119f50446560513a8e311d574ff6aaed72606ddae6d35716fe809c6"},
]
[package.dependencies]
markdown-it-py = ">=2.0.0,<5.0.0"
[package.extras]
code-style = ["pre-commit"]
rtd = ["myst-parser", "sphinx-book-theme"]
testing = ["coverage", "pytest", "pytest-cov", "pytest-regressions"]
[[package]]
name = "mdurl"
version = "0.1.2"
description = "Markdown URL utilities"
optional = false
python-versions = ">=3.7"
groups = ["dev"]
files = [
{file = "mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8"},
{file = "mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba"},
]
[[package]]
name = "mergedeep"
version = "1.3.4"
description = "A deep merge function for 🐍."
optional = false
python-versions = ">=3.6"
groups = ["dev"]
files = [
{file = "mergedeep-1.3.4-py3-none-any.whl", hash = "sha256:70775750742b25c0d8f36c55aed03d24c3384d17c951b3175d898bd778ef0307"},
{file = "mergedeep-1.3.4.tar.gz", hash = "sha256:0096d52e9dad9939c3d975a774666af186eda617e6ca84df4c94dec30004f2a8"},
]
[[package]]
name = "mkdocs"
version = "1.6.1"
description = "Project documentation with Markdown."
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "mkdocs-1.6.1-py3-none-any.whl", hash = "sha256:db91759624d1647f3f34aa0c3f327dd2601beae39a366d6e064c03468d35c20e"},
{file = "mkdocs-1.6.1.tar.gz", hash = "sha256:7b432f01d928c084353ab39c57282f29f92136665bdd6abf7c1ec8d822ef86f2"},
]
[package.dependencies]
click = ">=7.0"
colorama = {version = ">=0.4", markers = "platform_system == \"Windows\""}
ghp-import = ">=1.0"
jinja2 = ">=2.11.1"
markdown = ">=3.3.6"
markupsafe = ">=2.0.1"
mergedeep = ">=1.3.4"
mkdocs-get-deps = ">=0.2.0"
packaging = ">=20.5"
pathspec = ">=0.11.1"
pyyaml = ">=5.1"
pyyaml-env-tag = ">=0.1"
watchdog = ">=2.0"
[package.extras]
i18n = ["babel (>=2.9.0)"]
min-versions = ["babel (==2.9.0)", "click (==7.0)", "colorama (==0.4) ; platform_system == \"Windows\"", "ghp-import (==1.0)", "importlib-metadata (==4.4) ; python_version < \"3.10\"", "jinja2 (==2.11.1)", "markdown (==3.3.6)", "markupsafe (==2.0.1)", "mergedeep (==1.3.4)", "mkdocs-get-deps (==0.2.0)", "packaging (==20.5)", "pathspec (==0.11.1)", "pyyaml (==5.1)", "pyyaml-env-tag (==0.1)", "watchdog (==2.0)"]
[[package]]
name = "mkdocs-autorefs"
version = "1.4.3"
description = "Automatically link across pages in MkDocs."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "mkdocs_autorefs-1.4.3-py3-none-any.whl", hash = "sha256:469d85eb3114801d08e9cc55d102b3ba65917a869b893403b8987b601cf55dc9"},
{file = "mkdocs_autorefs-1.4.3.tar.gz", hash = "sha256:beee715b254455c4aa93b6ef3c67579c399ca092259cc41b7d9342573ff1fc75"},
]
[package.dependencies]
Markdown = ">=3.3"
markupsafe = ">=2.0.1"
mkdocs = ">=1.1"
[[package]]
name = "mkdocs-get-deps"
version = "0.2.0"
description = "MkDocs extension that lists all dependencies according to a mkdocs.yml file"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "mkdocs_get_deps-0.2.0-py3-none-any.whl", hash = "sha256:2bf11d0b133e77a0dd036abeeb06dec8775e46efa526dc70667d8863eefc6134"},
{file = "mkdocs_get_deps-0.2.0.tar.gz", hash = "sha256:162b3d129c7fad9b19abfdcb9c1458a651628e4b1dea628ac68790fb3061c60c"},
]
[package.dependencies]
mergedeep = ">=1.3.4"
platformdirs = ">=2.2.0"
pyyaml = ">=5.1"
[[package]]
name = "mkdocs-material"
version = "9.7.1"
description = "Documentation that simply works"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "mkdocs_material-9.7.1-py3-none-any.whl", hash = "sha256:3f6100937d7d731f87f1e3e3b021c97f7239666b9ba1151ab476cabb96c60d5c"},
{file = "mkdocs_material-9.7.1.tar.gz", hash = "sha256:89601b8f2c3e6c6ee0a918cc3566cb201d40bf37c3cd3c2067e26fadb8cce2b8"},
]
[package.dependencies]
babel = ">=2.10"
backrefs = ">=5.7.post1"
colorama = ">=0.4"
jinja2 = ">=3.1"
markdown = ">=3.2"
mkdocs = ">=1.6"
mkdocs-material-extensions = ">=1.3"
paginate = ">=0.5"
pygments = ">=2.16"
pymdown-extensions = ">=10.2"
requests = ">=2.30"
[package.extras]
git = ["mkdocs-git-committers-plugin-2 (>=1.1,<3)", "mkdocs-git-revision-date-localized-plugin (>=1.2.4,<2.0)"]
imaging = ["cairosvg (>=2.6,<3.0)", "pillow (>=10.2,<12.0)"]
recommended = ["mkdocs-minify-plugin (>=0.7,<1.0)", "mkdocs-redirects (>=1.2,<2.0)", "mkdocs-rss-plugin (>=1.6,<2.0)"]
[[package]]
name = "mkdocs-material-extensions"
version = "1.3.1"
description = "Extension pack for Python Markdown and MkDocs Material."
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "mkdocs_material_extensions-1.3.1-py3-none-any.whl", hash = "sha256:adff8b62700b25cb77b53358dad940f3ef973dd6db797907c49e3c2ef3ab4e31"},
{file = "mkdocs_material_extensions-1.3.1.tar.gz", hash = "sha256:10c9511cea88f568257f960358a467d12b970e1f7b2c0e5fb2bb48cab1928443"},
]
[[package]]
name = "mkdocstrings"
version = "1.0.0"
description = "Automatic documentation from sources, for MkDocs."
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "mkdocstrings-1.0.0-py3-none-any.whl", hash = "sha256:4c50eb960bff6e05dfc631f6bc00dfabffbcb29c5ff25f676d64daae05ed82fa"},
{file = "mkdocstrings-1.0.0.tar.gz", hash = "sha256:351a006dbb27aefce241ade110d3cd040c1145b7a3eb5fd5ac23f03ed67f401a"},
]
[package.dependencies]
Jinja2 = ">=3.1"
Markdown = ">=3.6"
MarkupSafe = ">=1.1"
mkdocs = ">=1.6"
mkdocs-autorefs = ">=1.4"
mkdocstrings-python-legacy = {version = ">=0.2.1", optional = true, markers = "extra == \"python-legacy\""}
pymdown-extensions = ">=6.3"
[package.extras]
crystal = ["mkdocstrings-crystal (>=0.3.4)"]
python = ["mkdocstrings-python (>=1.16.2)"]
python-legacy = ["mkdocstrings-python-legacy (>=0.2.1)"]
[[package]]
name = "mkdocstrings-python-legacy"
version = "0.2.7"
description = "A legacy Python handler for mkdocstrings."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "mkdocstrings_python_legacy-0.2.7-py3-none-any.whl", hash = "sha256:c24a0a5867749fd826dfa190e10afcbd4c415cbcb2f805fc4791472b4bf221e9"},
{file = "mkdocstrings_python_legacy-0.2.7.tar.gz", hash = "sha256:1aa8a277a332fb0d49be3786de3fa18af7d8792e8d611f6ba8d550dc3a1ff8a1"},
]
[package.dependencies]
mkdocs-autorefs = ">=1.1"
mkdocstrings = ">=0.28.3"
pytkdocs = ">=0.14"
[[package]]
name = "mypy"
version = "1.19.1"
description = "Optional static typing for Python"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "mypy-1.19.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:5f05aa3d375b385734388e844bc01733bd33c644ab48e9684faa54e5389775ec"},
{file = "mypy-1.19.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:022ea7279374af1a5d78dfcab853fe6a536eebfda4b59deab53cd21f6cd9f00b"},
{file = "mypy-1.19.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee4c11e460685c3e0c64a4c5de82ae143622410950d6be863303a1c4ba0e36d6"},
{file = "mypy-1.19.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:de759aafbae8763283b2ee5869c7255391fbc4de3ff171f8f030b5ec48381b74"},
{file = "mypy-1.19.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:ab43590f9cd5108f41aacf9fca31841142c786827a74ab7cc8a2eacb634e09a1"},
{file = "mypy-1.19.1-cp310-cp310-win_amd64.whl", hash = "sha256:2899753e2f61e571b3971747e302d5f420c3fd09650e1951e99f823bc3089dac"},
{file = "mypy-1.19.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:d8dfc6ab58ca7dda47d9237349157500468e404b17213d44fc1cb77bce532288"},
{file = "mypy-1.19.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:e3f276d8493c3c97930e354b2595a44a21348b320d859fb4a2b9f66da9ed27ab"},
{file = "mypy-1.19.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2abb24cf3f17864770d18d673c85235ba52456b36a06b6afc1e07c1fdcd3d0e6"},
{file = "mypy-1.19.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a009ffa5a621762d0c926a078c2d639104becab69e79538a494bcccb62cc0331"},
{file = "mypy-1.19.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f7cee03c9a2e2ee26ec07479f38ea9c884e301d42c6d43a19d20fb014e3ba925"},
{file = "mypy-1.19.1-cp311-cp311-win_amd64.whl", hash = "sha256:4b84a7a18f41e167f7995200a1d07a4a6810e89d29859df936f1c3923d263042"},
{file = "mypy-1.19.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:a8174a03289288c1f6c46d55cef02379b478bfbc8e358e02047487cad44c6ca1"},
{file = "mypy-1.19.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ffcebe56eb09ff0c0885e750036a095e23793ba6c2e894e7e63f6d89ad51f22e"},
{file = "mypy-1.19.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b64d987153888790bcdb03a6473d321820597ab8dd9243b27a92153c4fa50fd2"},
{file = "mypy-1.19.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c35d298c2c4bba75feb2195655dfea8124d855dfd7343bf8b8c055421eaf0cf8"},
{file = "mypy-1.19.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:34c81968774648ab5ac09c29a375fdede03ba253f8f8287847bd480782f73a6a"},
{file = "mypy-1.19.1-cp312-cp312-win_amd64.whl", hash = "sha256:b10e7c2cd7870ba4ad9b2d8a6102eb5ffc1f16ca35e3de6bfa390c1113029d13"},
{file = "mypy-1.19.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e3157c7594ff2ef1634ee058aafc56a82db665c9438fd41b390f3bde1ab12250"},
{file = "mypy-1.19.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:bdb12f69bcc02700c2b47e070238f42cb87f18c0bc1fc4cdb4fb2bc5fd7a3b8b"},
{file = "mypy-1.19.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f859fb09d9583a985be9a493d5cfc5515b56b08f7447759a0c5deaf68d80506e"},
{file = "mypy-1.19.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c9a6538e0415310aad77cb94004ca6482330fece18036b5f360b62c45814c4ef"},
{file = "mypy-1.19.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:da4869fc5e7f62a88f3fe0b5c919d1d9f7ea3cef92d3689de2823fd27e40aa75"},
{file = "mypy-1.19.1-cp313-cp313-win_amd64.whl", hash = "sha256:016f2246209095e8eda7538944daa1d60e1e8134d98983b9fc1e92c1fc0cb8dd"},
{file = "mypy-1.19.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:06e6170bd5836770e8104c8fdd58e5e725cfeb309f0a6c681a811f557e97eac1"},
{file = "mypy-1.19.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:804bd67b8054a85447c8954215a906d6eff9cabeabe493fb6334b24f4bfff718"},
{file = "mypy-1.19.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:21761006a7f497cb0d4de3d8ef4ca70532256688b0523eee02baf9eec895e27b"},
{file = "mypy-1.19.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:28902ee51f12e0f19e1e16fbe2f8f06b6637f482c459dd393efddd0ec7f82045"},
{file = "mypy-1.19.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:481daf36a4c443332e2ae9c137dfee878fcea781a2e3f895d54bd3002a900957"},
{file = "mypy-1.19.1-cp314-cp314-win_amd64.whl", hash = "sha256:8bb5c6f6d043655e055be9b542aa5f3bdd30e4f3589163e85f93f3640060509f"},
{file = "mypy-1.19.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:7bcfc336a03a1aaa26dfce9fff3e287a3ba99872a157561cbfcebe67c13308e3"},
{file = "mypy-1.19.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:b7951a701c07ea584c4fe327834b92a30825514c868b1f69c30445093fdd9d5a"},
{file = "mypy-1.19.1-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b13cfdd6c87fc3efb69ea4ec18ef79c74c3f98b4e5498ca9b85ab3b2c2329a67"},
{file = "mypy-1.19.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4f28f99c824ecebcdaa2e55d82953e38ff60ee5ec938476796636b86afa3956e"},
{file = "mypy-1.19.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:c608937067d2fc5a4dd1a5ce92fd9e1398691b8c5d012d66e1ddd430e9244376"},
{file = "mypy-1.19.1-cp39-cp39-win_amd64.whl", hash = "sha256:409088884802d511ee52ca067707b90c883426bd95514e8cfda8281dc2effe24"},
{file = "mypy-1.19.1-py3-none-any.whl", hash = "sha256:f1235f5ea01b7db5468d53ece6aaddf1ad0b88d9e7462b86ef96fe04995d7247"},
{file = "mypy-1.19.1.tar.gz", hash = "sha256:19d88bb05303fe63f71dd2c6270daca27cb9401c4ca8255fe50d1d920e0eb9ba"},
]
[package.dependencies]
librt = {version = ">=0.6.2", markers = "platform_python_implementation != \"PyPy\""}
mypy_extensions = ">=1.0.0"
pathspec = ">=0.9.0"
tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""}
typing_extensions = ">=4.6.0"
[package.extras]
dmypy = ["psutil (>=4.0)"]
faster-cache = ["orjson"]
install-types = ["pip"]
mypyc = ["setuptools (>=50)"]
reports = ["lxml"]
[[package]]
name = "mypy-extensions"
version = "1.1.0"
description = "Type system extensions for programs checked with the mypy type checker."
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505"},
{file = "mypy_extensions-1.1.0.tar.gz", hash = "sha256:52e68efc3284861e772bbcd66823fde5ae21fd2fdb51c62a211403730b916558"},
]
[[package]]
name = "myst-parser"
version = "3.0.1"
description = "An extended [CommonMark](https://spec.commonmark.org/) compliant parser,"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "myst_parser-3.0.1-py3-none-any.whl", hash = "sha256:6457aaa33a5d474aca678b8ead9b3dc298e89c68e67012e73146ea6fd54babf1"},
{file = "myst_parser-3.0.1.tar.gz", hash = "sha256:88f0cb406cb363b077d176b51c476f62d60604d68a8dcdf4832e080441301a87"},
]
[package.dependencies]
docutils = ">=0.18,<0.22"
jinja2 = "*"
markdown-it-py = ">=3.0,<4.0"
mdit-py-plugins = ">=0.4,<1.0"
pyyaml = "*"
sphinx = ">=6,<8"
[package.extras]
code-style = ["pre-commit (>=3.0,<4.0)"]
linkify = ["linkify-it-py (>=2.0,<3.0)"]
rtd = ["ipython", "sphinx (>=7)", "sphinx-autodoc2 (>=0.5.0,<0.6.0)", "sphinx-book-theme (>=1.1,<2.0)", "sphinx-copybutton", "sphinx-design", "sphinx-pyscript", "sphinx-tippy (>=0.4.3)", "sphinx-togglebutton", "sphinxext-opengraph (>=0.9.0,<0.10.0)", "sphinxext-rediraffe (>=0.2.7,<0.3.0)"]
testing = ["beautifulsoup4", "coverage[toml]", "defusedxml", "pytest (>=8,<9)", "pytest-cov", "pytest-param-files (>=0.6.0,<0.7.0)", "pytest-regressions", "sphinx-pytest"]
testing-docutils = ["pygments", "pytest (>=8,<9)", "pytest-param-files (>=0.6.0,<0.7.0)"]
[[package]]
name = "packaging"
version = "25.0"
description = "Core utilities for Python packages"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484"},
{file = "packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f"},
]
[[package]]
name = "paginate"
version = "0.5.7"
description = "Divides large result sets into pages for easier browsing"
optional = false
python-versions = "*"
groups = ["dev"]
files = [
{file = "paginate-0.5.7-py2.py3-none-any.whl", hash = "sha256:b885e2af73abcf01d9559fd5216b57ef722f8c42affbb63942377668e35c7591"},
{file = "paginate-0.5.7.tar.gz", hash = "sha256:22bd083ab41e1a8b4f3690544afb2c60c25e5c9a63a30fa2f483f6c60c8e5945"},
]
[package.extras]
dev = ["pytest", "tox"]
lint = ["black"]
[[package]]
name = "pathspec"
version = "1.0.1"
description = "Utility library for gitignore style pattern matching of file paths."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "pathspec-1.0.1-py3-none-any.whl", hash = "sha256:8870061f22c58e6d83463cfce9a7dd6eca0512c772c1001fb09ac64091816721"},
{file = "pathspec-1.0.1.tar.gz", hash = "sha256:e2769b508d0dd47b09af6ee2c75b2744a2cb1f474ae4b1494fd6a1b7a841613c"},
]
[package.extras]
hyperscan = ["hyperscan (>=0.7)"]
optional = ["typing-extensions (>=4)"]
re2 = ["google-re2 (>=1.1)"]
tests = ["pytest (>=9)", "typing-extensions (>=4.15)"]
[[package]]
name = "platformdirs"
version = "4.5.1"
description = "A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`."
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "platformdirs-4.5.1-py3-none-any.whl", hash = "sha256:d03afa3963c806a9bed9d5125c8f4cb2fdaf74a55ab60e5d59b3fde758104d31"},
{file = "platformdirs-4.5.1.tar.gz", hash = "sha256:61d5cdcc6065745cdd94f0f878977f8de9437be93de97c1c12f853c9c0cdcbda"},
]
[package.extras]
docs = ["furo (>=2025.9.25)", "proselint (>=0.14)", "sphinx (>=8.2.3)", "sphinx-autodoc-typehints (>=3.2)"]
test = ["appdirs (==1.4.4)", "covdefaults (>=2.3)", "pytest (>=8.4.2)", "pytest-cov (>=7)", "pytest-mock (>=3.15.1)"]
type = ["mypy (>=1.18.2)"]
[[package]]
name = "pluggy"
version = "1.6.0"
description = "plugin and hook calling mechanisms for python"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746"},
{file = "pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3"},
]
[package.extras]
dev = ["pre-commit", "tox"]
testing = ["coverage", "pytest", "pytest-benchmark"]
[[package]]
name = "pygments"
version = "2.19.2"
description = "Pygments is a syntax highlighting package written in Python."
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b"},
{file = "pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887"},
]
[package.extras]
windows-terminal = ["colorama (>=0.4.6)"]
[[package]]
name = "pylint"
version = "4.0.4"
description = "python code static checker"
optional = false
python-versions = ">=3.10.0"
groups = ["dev"]
files = [
{file = "pylint-4.0.4-py3-none-any.whl", hash = "sha256:63e06a37d5922555ee2c20963eb42559918c20bd2b21244e4ef426e7c43b92e0"},
{file = "pylint-4.0.4.tar.gz", hash = "sha256:d9b71674e19b1c36d79265b5887bf8e55278cbe236c9e95d22dc82cf044fdbd2"},
]
[package.dependencies]
astroid = ">=4.0.2,<=4.1.dev0"
colorama = {version = ">=0.4.5", markers = "sys_platform == \"win32\""}
dill = [
{version = ">=0.2", markers = "python_version < \"3.11\""},
{version = ">=0.3.7", markers = "python_version >= \"3.12\""},
{version = ">=0.3.6", markers = "python_version == \"3.11\""},
]
isort = ">=5,<5.13 || >5.13,<8"
mccabe = ">=0.6,<0.8"
platformdirs = ">=2.2"
tomli = {version = ">=1.1", markers = "python_version < \"3.11\""}
tomlkit = ">=0.10.1"
[package.extras]
spelling = ["pyenchant (>=3.2,<4.0)"]
testutils = ["gitpython (>3)"]
[[package]]
name = "pymdown-extensions"
version = "10.20"
description = "Extension pack for Python Markdown."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "pymdown_extensions-10.20-py3-none-any.whl", hash = "sha256:ea9e62add865da80a271d00bfa1c0fa085b20d133fb3fc97afdc88e682f60b2f"},
{file = "pymdown_extensions-10.20.tar.gz", hash = "sha256:5c73566ab0cf38c6ba084cb7c5ea64a119ae0500cce754ccb682761dfea13a52"},
]
[package.dependencies]
markdown = ">=3.6"
pyyaml = "*"
[package.extras]
extra = ["pygments (>=2.19.1)"]
[[package]]
name = "pyproject-api"
version = "1.10.0"
description = "API to interact with the python pyproject.toml based projects"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "pyproject_api-1.10.0-py3-none-any.whl", hash = "sha256:8757c41a79c0f4ab71b99abed52b97ecf66bd20b04fa59da43b5840bac105a09"},
{file = "pyproject_api-1.10.0.tar.gz", hash = "sha256:40c6f2d82eebdc4afee61c773ed208c04c19db4c4a60d97f8d7be3ebc0bbb330"},
]
[package.dependencies]
packaging = ">=25"
tomli = {version = ">=2.3", markers = "python_version < \"3.11\""}
[package.extras]
docs = ["furo (>=2025.9.25)", "sphinx-autodoc-typehints (>=3.5.1)"]
testing = ["covdefaults (>=2.3)", "pytest (>=8.4.2)", "pytest-cov (>=7)", "pytest-mock (>=3.15.1)", "setuptools (>=80.9)"]
[[package]]
name = "pytest"
version = "9.0.2"
description = "pytest: simple powerful testing with Python"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b"},
{file = "pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11"},
]
[package.dependencies]
colorama = {version = ">=0.4", markers = "sys_platform == \"win32\""}
exceptiongroup = {version = ">=1", markers = "python_version < \"3.11\""}
iniconfig = ">=1.0.1"
packaging = ">=22"
pluggy = ">=1.5,<2"
pygments = ">=2.7.2"
tomli = {version = ">=1", markers = "python_version < \"3.11\""}
[package.extras]
dev = ["argcomplete", "attrs (>=19.2)", "hypothesis (>=3.56)", "mock", "requests", "setuptools", "xmlschema"]
[[package]]
name = "pytest-cov"
version = "7.0.0"
description = "Pytest plugin for measuring coverage."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "pytest_cov-7.0.0-py3-none-any.whl", hash = "sha256:3b8e9558b16cc1479da72058bdecf8073661c7f57f7d3c5f22a1c23507f2d861"},
{file = "pytest_cov-7.0.0.tar.gz", hash = "sha256:33c97eda2e049a0c5298e91f519302a1334c26ac65c1a483d6206fd458361af1"},
]
[package.dependencies]
coverage = {version = ">=7.10.6", extras = ["toml"]}
pluggy = ">=1.2"
pytest = ">=7"
[package.extras]
testing = ["process-tests", "pytest-xdist", "virtualenv"]
[[package]]
name = "python-dateutil"
version = "2.9.0.post0"
description = "Extensions to the standard Python datetime module"
optional = false
python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7"
groups = ["dev"]
files = [
{file = "python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3"},
{file = "python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427"},
]
[package.dependencies]
six = ">=1.5"
[[package]]
name = "python-subunit"
version = "1.4.5"
description = "Python implementation of subunit test streaming protocol"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "python_subunit-1.4.5-py3-none-any.whl", hash = "sha256:254f85a144d8c4e62bf02cc53c834d2f36177056353fcd90a60a2745e229cf17"},
{file = "python_subunit-1.4.5.tar.gz", hash = "sha256:a57d61f0ba2c0a8657c61329301ada6ad8e30b26fb47ca3bb37481463e75aabf"},
]
[package.dependencies]
iso8601 = "*"
testtools = ">=2.7"
[package.extras]
docs = ["docutils"]
test = ["fixtures", "hypothesis", "testscenarios"]
[[package]]
name = "pytkdocs"
version = "0.16.5"
description = "Load Python objects documentation."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "pytkdocs-0.16.5-py3-none-any.whl", hash = "sha256:7feb2535a8582d891fa5353cf2f4ecc7840915e631d322dbcbc1c8cc605da23a"},
{file = "pytkdocs-0.16.5.tar.gz", hash = "sha256:103cdb3f0298c392bc340ae9aa7cd8685b163ae2aec65660dd0018978ddf4fa7"},
]
[package.extras]
numpy-style = ["docstring_parser (>=0.7)"]
[[package]]
name = "pytokens"
version = "0.3.0"
description = "A Fast, spec compliant Python 3.14+ tokenizer that runs on older Pythons."
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "pytokens-0.3.0-py3-none-any.whl", hash = "sha256:95b2b5eaf832e469d141a378872480ede3f251a5a5041b8ec6e581d3ac71bbf3"},
{file = "pytokens-0.3.0.tar.gz", hash = "sha256:2f932b14ed08de5fcf0b391ace2642f858f1394c0857202959000b68ed7a458a"},
]
[package.extras]
dev = ["black", "build", "mypy", "pytest", "pytest-cov", "setuptools", "tox", "twine", "wheel"]
[[package]]
name = "pyyaml"
version = "6.0.3"
description = "YAML parser and emitter for Python"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "PyYAML-6.0.3-cp38-cp38-macosx_10_13_x86_64.whl", hash = "sha256:c2514fceb77bc5e7a2f7adfaa1feb2fb311607c9cb518dbc378688ec73d8292f"},
{file = "PyYAML-6.0.3-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9c57bb8c96f6d1808c030b1687b9b5fb476abaa47f0db9c0101f5e9f394e97f4"},
{file = "PyYAML-6.0.3-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:efd7b85f94a6f21e4932043973a7ba2613b059c4a000551892ac9f1d11f5baf3"},
{file = "PyYAML-6.0.3-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:22ba7cfcad58ef3ecddc7ed1db3409af68d023b7f940da23c6c2a1890976eda6"},
{file = "PyYAML-6.0.3-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:6344df0d5755a2c9a276d4473ae6b90647e216ab4757f8426893b5dd2ac3f369"},
{file = "PyYAML-6.0.3-cp38-cp38-win32.whl", hash = "sha256:3ff07ec89bae51176c0549bc4c63aa6202991da2d9a6129d7aef7f1407d3f295"},
{file = "PyYAML-6.0.3-cp38-cp38-win_amd64.whl", hash = "sha256:5cf4e27da7e3fbed4d6c3d8e797387aaad68102272f8f9752883bc32d61cb87b"},
{file = "pyyaml-6.0.3-cp310-cp310-macosx_10_13_x86_64.whl", hash = "sha256:214ed4befebe12df36bcc8bc2b64b396ca31be9304b8f59e25c11cf94a4c033b"},
{file = "pyyaml-6.0.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:02ea2dfa234451bbb8772601d7b8e426c2bfa197136796224e50e35a78777956"},
{file = "pyyaml-6.0.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b30236e45cf30d2b8e7b3e85881719e98507abed1011bf463a8fa23e9c3e98a8"},
{file = "pyyaml-6.0.3-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:66291b10affd76d76f54fad28e22e51719ef9ba22b29e1d7d03d6777a9174198"},
{file = "pyyaml-6.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9c7708761fccb9397fe64bbc0395abcae8c4bf7b0eac081e12b809bf47700d0b"},
{file = "pyyaml-6.0.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:418cf3f2111bc80e0933b2cd8cd04f286338bb88bdc7bc8e6dd775ebde60b5e0"},
{file = "pyyaml-6.0.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:5e0b74767e5f8c593e8c9b5912019159ed0533c70051e9cce3e8b6aa699fcd69"},
{file = "pyyaml-6.0.3-cp310-cp310-win32.whl", hash = "sha256:28c8d926f98f432f88adc23edf2e6d4921ac26fb084b028c733d01868d19007e"},
{file = "pyyaml-6.0.3-cp310-cp310-win_amd64.whl", hash = "sha256:bdb2c67c6c1390b63c6ff89f210c8fd09d9a1217a465701eac7316313c915e4c"},
{file = "pyyaml-6.0.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e"},
{file = "pyyaml-6.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824"},
{file = "pyyaml-6.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c"},
{file = "pyyaml-6.0.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00"},
{file = "pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d"},
{file = "pyyaml-6.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a"},
{file = "pyyaml-6.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4"},
{file = "pyyaml-6.0.3-cp311-cp311-win32.whl", hash = "sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b"},
{file = "pyyaml-6.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf"},
{file = "pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196"},
{file = "pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0"},
{file = "pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28"},
{file = "pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c"},
{file = "pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc"},
{file = "pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e"},
{file = "pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea"},
{file = "pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5"},
{file = "pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b"},
{file = "pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd"},
{file = "pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8"},
{file = "pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1"},
{file = "pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c"},
{file = "pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5"},
{file = "pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6"},
{file = "pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6"},
{file = "pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be"},
{file = "pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26"},
{file = "pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c"},
{file = "pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb"},
{file = "pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac"},
{file = "pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310"},
{file = "pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7"},
{file = "pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788"},
{file = "pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5"},
{file = "pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764"},
{file = "pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35"},
{file = "pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac"},
{file = "pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3"},
{file = "pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3"},
{file = "pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba"},
{file = "pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c"},
{file = "pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702"},
{file = "pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c"},
{file = "pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065"},
{file = "pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65"},
{file = "pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9"},
{file = "pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b"},
{file = "pyyaml-6.0.3-cp39-cp39-macosx_10_13_x86_64.whl", hash = "sha256:b865addae83924361678b652338317d1bd7e79b1f4596f96b96c77a5a34b34da"},
{file = "pyyaml-6.0.3-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:c3355370a2c156cffb25e876646f149d5d68f5e0a3ce86a5084dd0b64a994917"},
{file = "pyyaml-6.0.3-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3c5677e12444c15717b902a5798264fa7909e41153cdf9ef7ad571b704a63dd9"},
{file = "pyyaml-6.0.3-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5ed875a24292240029e4483f9d4a4b8a1ae08843b9c54f43fcc11e404532a8a5"},
{file = "pyyaml-6.0.3-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0150219816b6a1fa26fb4699fb7daa9caf09eb1999f3b70fb6e786805e80375a"},
{file = "pyyaml-6.0.3-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:fa160448684b4e94d80416c0fa4aac48967a969efe22931448d853ada8baf926"},
{file = "pyyaml-6.0.3-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:27c0abcb4a5dac13684a37f76e701e054692a9b2d3064b70f5e4eb54810553d7"},
{file = "pyyaml-6.0.3-cp39-cp39-win32.whl", hash = "sha256:1ebe39cb5fc479422b83de611d14e2c0d3bb2a18bbcb01f229ab3cfbd8fee7a0"},
{file = "pyyaml-6.0.3-cp39-cp39-win_amd64.whl", hash = "sha256:2e71d11abed7344e42a8849600193d15b6def118602c4c176f748e4583246007"},
{file = "pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f"},
]
[[package]]
name = "pyyaml-env-tag"
version = "1.1"
description = "A custom YAML tag for referencing environment variables in YAML files."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "pyyaml_env_tag-1.1-py3-none-any.whl", hash = "sha256:17109e1a528561e32f026364712fee1264bc2ea6715120891174ed1b980d2e04"},
{file = "pyyaml_env_tag-1.1.tar.gz", hash = "sha256:2eb38b75a2d21ee0475d6d97ec19c63287a7e140231e4214969d0eac923cd7ff"},
]
[package.dependencies]
pyyaml = "*"
[[package]]
name = "requests"
version = "2.32.5"
description = "Python HTTP for Humans."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6"},
{file = "requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf"},
]
[package.dependencies]
certifi = ">=2017.4.17"
charset_normalizer = ">=2,<4"
idna = ">=2.5,<4"
urllib3 = ">=1.21.1,<3"
[package.extras]
socks = ["PySocks (>=1.5.6,!=1.5.7)"]
use-chardet-on-py3 = ["chardet (>=3.0.2,<6)"]
[[package]]
name = "setuptools"
version = "80.9.0"
description = "Easily download, build, install, upgrade, and uninstall Python packages"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "setuptools-80.9.0-py3-none-any.whl", hash = "sha256:062d34222ad13e0cc312a4c02d73f059e86a4acbfbdea8f8f76b28c99f306922"},
{file = "setuptools-80.9.0.tar.gz", hash = "sha256:f36b47402ecde768dbfafc46e8e4207b4360c654f1f3bb84475f0a28628fb19c"},
]
[package.extras]
check = ["pytest-checkdocs (>=2.4)", "pytest-ruff (>=0.2.1) ; sys_platform != \"cygwin\"", "ruff (>=0.8.0) ; sys_platform != \"cygwin\""]
core = ["importlib_metadata (>=6) ; python_version < \"3.10\"", "jaraco.functools (>=4)", "jaraco.text (>=3.7)", "more_itertools", "more_itertools (>=8.8)", "packaging (>=24.2)", "platformdirs (>=4.2.2)", "tomli (>=2.0.1) ; python_version < \"3.11\"", "wheel (>=0.43.0)"]
cover = ["pytest-cov"]
doc = ["furo", "jaraco.packaging (>=9.3)", "jaraco.tidelift (>=1.4)", "pygments-github-lexers (==0.0.5)", "pyproject-hooks (!=1.1)", "rst.linker (>=1.9)", "sphinx (>=3.5)", "sphinx-favicon", "sphinx-inline-tabs", "sphinx-lint", "sphinx-notfound-page (>=1,<2)", "sphinx-reredirects", "sphinxcontrib-towncrier", "towncrier (<24.7)"]
enabler = ["pytest-enabler (>=2.2)"]
test = ["build[virtualenv] (>=1.0.3)", "filelock (>=3.4.0)", "ini2toml[lite] (>=0.14)", "jaraco.develop (>=7.21) ; python_version >= \"3.9\" and sys_platform != \"cygwin\"", "jaraco.envs (>=2.2)", "jaraco.path (>=3.7.2)", "jaraco.test (>=5.5)", "packaging (>=24.2)", "pip (>=19.1)", "pyproject-hooks (!=1.1)", "pytest (>=6,!=8.1.*)", "pytest-home (>=0.5)", "pytest-perf ; sys_platform != \"cygwin\"", "pytest-subprocess", "pytest-timeout", "pytest-xdist (>=3)", "tomli-w (>=1.0.0)", "virtualenv (>=13.0.0)", "wheel (>=0.44.0)"]
type = ["importlib_metadata (>=7.0.2) ; python_version < \"3.10\"", "jaraco.develop (>=7.21) ; sys_platform != \"cygwin\"", "mypy (==1.14.*)", "pytest-mypy"]
[[package]]
name = "six"
version = "1.17.0"
description = "Python 2 and 3 compatibility utilities"
optional = false
python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7"
groups = ["dev"]
files = [
{file = "six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274"},
{file = "six-1.17.0.tar.gz", hash = "sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81"},
]
[[package]]
name = "snowballstemmer"
version = "3.0.1"
description = "This package provides 32 stemmers for 30 languages generated from Snowball algorithms."
optional = false
python-versions = "!=3.0.*,!=3.1.*,!=3.2.*"
groups = ["dev"]
files = [
{file = "snowballstemmer-3.0.1-py3-none-any.whl", hash = "sha256:6cd7b3897da8d6c9ffb968a6781fa6532dce9c3618a4b127d920dab764a19064"},
{file = "snowballstemmer-3.0.1.tar.gz", hash = "sha256:6d5eeeec8e9f84d4d56b847692bacf79bc2c8e90c7f80ca4444ff8b6f2e52895"},
]
[[package]]
name = "sphinx"
version = "6.2.1"
description = "Python documentation generator"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "Sphinx-6.2.1.tar.gz", hash = "sha256:6d56a34697bb749ffa0152feafc4b19836c755d90a7c59b72bc7dfd371b9cc6b"},
{file = "sphinx-6.2.1-py3-none-any.whl", hash = "sha256:97787ff1fa3256a3eef9eda523a63dbf299f7b47e053cfcf684a1c2a8380c912"},
]
[package.dependencies]
alabaster = ">=0.7,<0.8"
babel = ">=2.9"
colorama = {version = ">=0.4.5", markers = "sys_platform == \"win32\""}
docutils = ">=0.18.1,<0.20"
imagesize = ">=1.3"
Jinja2 = ">=3.0"
packaging = ">=21.0"
Pygments = ">=2.13"
requests = ">=2.25.0"
snowballstemmer = ">=2.0"
sphinxcontrib-applehelp = "*"
sphinxcontrib-devhelp = "*"
sphinxcontrib-htmlhelp = ">=2.0.0"
sphinxcontrib-jsmath = "*"
sphinxcontrib-qthelp = "*"
sphinxcontrib-serializinghtml = ">=1.1.5"
[package.extras]
docs = ["sphinxcontrib-websupport"]
lint = ["docutils-stubs", "flake8 (>=3.5.0)", "flake8-simplify", "isort", "mypy (>=0.990)", "ruff", "sphinx-lint", "types-requests"]
test = ["cython", "filelock", "html5lib", "pytest (>=4.6)"]
[[package]]
name = "sphinxcontrib-applehelp"
version = "2.0.0"
description = "sphinxcontrib-applehelp is a Sphinx extension which outputs Apple help books"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "sphinxcontrib_applehelp-2.0.0-py3-none-any.whl", hash = "sha256:4cd3f0ec4ac5dd9c17ec65e9ab272c9b867ea77425228e68ecf08d6b28ddbdb5"},
{file = "sphinxcontrib_applehelp-2.0.0.tar.gz", hash = "sha256:2f29ef331735ce958efa4734873f084941970894c6090408b079c61b2e1c06d1"},
]
[package.extras]
lint = ["mypy", "ruff (==0.5.5)", "types-docutils"]
standalone = ["Sphinx (>=5)"]
test = ["pytest"]
[[package]]
name = "sphinxcontrib-devhelp"
version = "2.0.0"
description = "sphinxcontrib-devhelp is a sphinx extension which outputs Devhelp documents"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "sphinxcontrib_devhelp-2.0.0-py3-none-any.whl", hash = "sha256:aefb8b83854e4b0998877524d1029fd3e6879210422ee3780459e28a1f03a8a2"},
{file = "sphinxcontrib_devhelp-2.0.0.tar.gz", hash = "sha256:411f5d96d445d1d73bb5d52133377b4248ec79db5c793ce7dbe59e074b4dd1ad"},
]
[package.extras]
lint = ["mypy", "ruff (==0.5.5)", "types-docutils"]
standalone = ["Sphinx (>=5)"]
test = ["pytest"]
[[package]]
name = "sphinxcontrib-htmlhelp"
version = "2.1.0"
description = "sphinxcontrib-htmlhelp is a sphinx extension which renders HTML help files"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "sphinxcontrib_htmlhelp-2.1.0-py3-none-any.whl", hash = "sha256:166759820b47002d22914d64a075ce08f4c46818e17cfc9470a9786b759b19f8"},
{file = "sphinxcontrib_htmlhelp-2.1.0.tar.gz", hash = "sha256:c9e2916ace8aad64cc13a0d233ee22317f2b9025b9cf3295249fa985cc7082e9"},
]
[package.extras]
lint = ["mypy", "ruff (==0.5.5)", "types-docutils"]
standalone = ["Sphinx (>=5)"]
test = ["html5lib", "pytest"]
[[package]]
name = "sphinxcontrib-jsmath"
version = "1.0.1"
description = "A sphinx extension which renders display math in HTML via JavaScript"
optional = false
python-versions = ">=3.5"
groups = ["dev"]
files = [
{file = "sphinxcontrib-jsmath-1.0.1.tar.gz", hash = "sha256:a9925e4a4587247ed2191a22df5f6970656cb8ca2bd6284309578f2153e0c4b8"},
{file = "sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl", hash = "sha256:2ec2eaebfb78f3f2078e73666b1415417a116cc848b72e5172e596c871103178"},
]
[package.extras]
test = ["flake8", "mypy", "pytest"]
[[package]]
name = "sphinxcontrib-qthelp"
version = "2.0.0"
description = "sphinxcontrib-qthelp is a sphinx extension which outputs QtHelp documents"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "sphinxcontrib_qthelp-2.0.0-py3-none-any.whl", hash = "sha256:b18a828cdba941ccd6ee8445dbe72ffa3ef8cbe7505d8cd1fa0d42d3f2d5f3eb"},
{file = "sphinxcontrib_qthelp-2.0.0.tar.gz", hash = "sha256:4fe7d0ac8fc171045be623aba3e2a8f613f8682731f9153bb2e40ece16b9bbab"},
]
[package.extras]
lint = ["mypy", "ruff (==0.5.5)", "types-docutils"]
standalone = ["Sphinx (>=5)"]
test = ["defusedxml (>=0.7.1)", "pytest"]
[[package]]
name = "sphinxcontrib-serializinghtml"
version = "2.0.0"
description = "sphinxcontrib-serializinghtml is a sphinx extension which outputs \"serialized\" HTML files (json and pickle)"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "sphinxcontrib_serializinghtml-2.0.0-py3-none-any.whl", hash = "sha256:6e2cb0eef194e10c27ec0023bfeb25badbbb5868244cf5bc5bdc04e4464bf331"},
{file = "sphinxcontrib_serializinghtml-2.0.0.tar.gz", hash = "sha256:e9d912827f872c029017a53f0ef2180b327c3f7fd23c87229f7a8e8b70031d4d"},
]
[package.extras]
lint = ["mypy", "ruff (==0.5.5)", "types-docutils"]
standalone = ["Sphinx (>=5)"]
test = ["pytest"]
[[package]]
name = "teamcity-messages"
version = "1.33"
description = "Send test results to TeamCity continuous integration server from unittest, nose, py.test, twisted trial, behave (Python 2.6+)"
optional = false
python-versions = "*"
groups = ["dev"]
files = [
{file = "teamcity_messages-1.33-py3-none-any.whl", hash = "sha256:74ab9cdf8f86acd42b15fae7f8eaf6c8d7b65f694c232ca209943c288fe5daad"},
{file = "teamcity_messages-1.33.tar.gz", hash = "sha256:ceb5a80105f0fb2f3b1c7840d40b3570052e6ebe921f9463a3b0a4f91631f731"},
]
[[package]]
name = "testtools"
version = "2.8.2"
description = "Extensions to the Python standard library unit testing framework"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "testtools-2.8.2-py3-none-any.whl", hash = "sha256:5d963003d3d46fde12d02f9447e1b756718f3c777477904fdd279487f7623fbb"},
{file = "testtools-2.8.2.tar.gz", hash = "sha256:b5c73332456ff54152062d47a58bc4f15f8e23514afec4e84775af124fb7db43"},
]
[package.extras]
dev = ["mypy (>=1.0.0)", "ruff (==0.14.9)"]
test = ["testresources", "testscenarios"]
twisted = ["fixtures", "twisted"]
[[package]]
name = "tomli"
version = "2.3.0"
description = "A lil' TOML parser"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
markers = "python_version < \"3.11\""
files = [
{file = "tomli-2.3.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:88bd15eb972f3664f5ed4b57c1634a97153b4bac4479dcb6a495f41921eb7f45"},
{file = "tomli-2.3.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:883b1c0d6398a6a9d29b508c331fa56adbcdff647f6ace4dfca0f50e90dfd0ba"},
{file = "tomli-2.3.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d1381caf13ab9f300e30dd8feadb3de072aeb86f1d34a8569453ff32a7dea4bf"},
{file = "tomli-2.3.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a0e285d2649b78c0d9027570d4da3425bdb49830a6156121360b3f8511ea3441"},
{file = "tomli-2.3.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:0a154a9ae14bfcf5d8917a59b51ffd5a3ac1fd149b71b47a3a104ca4edcfa845"},
{file = "tomli-2.3.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:74bf8464ff93e413514fefd2be591c3b0b23231a77f901db1eb30d6f712fc42c"},
{file = "tomli-2.3.0-cp311-cp311-win32.whl", hash = "sha256:00b5f5d95bbfc7d12f91ad8c593a1659b6387b43f054104cda404be6bda62456"},
{file = "tomli-2.3.0-cp311-cp311-win_amd64.whl", hash = "sha256:4dc4ce8483a5d429ab602f111a93a6ab1ed425eae3122032db7e9acf449451be"},
{file = "tomli-2.3.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d7d86942e56ded512a594786a5ba0a5e521d02529b3826e7761a05138341a2ac"},
{file = "tomli-2.3.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:73ee0b47d4dad1c5e996e3cd33b8a76a50167ae5f96a2607cbe8cc773506ab22"},
{file = "tomli-2.3.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:792262b94d5d0a466afb5bc63c7daa9d75520110971ee269152083270998316f"},
{file = "tomli-2.3.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4f195fe57ecceac95a66a75ac24d9d5fbc98ef0962e09b2eddec5d39375aae52"},
{file = "tomli-2.3.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:e31d432427dcbf4d86958c184b9bfd1e96b5b71f8eb17e6d02531f434fd335b8"},
{file = "tomli-2.3.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:7b0882799624980785240ab732537fcfc372601015c00f7fc367c55308c186f6"},
{file = "tomli-2.3.0-cp312-cp312-win32.whl", hash = "sha256:ff72b71b5d10d22ecb084d345fc26f42b5143c5533db5e2eaba7d2d335358876"},
{file = "tomli-2.3.0-cp312-cp312-win_amd64.whl", hash = "sha256:1cb4ed918939151a03f33d4242ccd0aa5f11b3547d0cf30f7c74a408a5b99878"},
{file = "tomli-2.3.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:5192f562738228945d7b13d4930baffda67b69425a7f0da96d360b0a3888136b"},
{file = "tomli-2.3.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:be71c93a63d738597996be9528f4abe628d1adf5e6eb11607bc8fe1a510b5dae"},
{file = "tomli-2.3.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c4665508bcbac83a31ff8ab08f424b665200c0e1e645d2bd9ab3d3e557b6185b"},
{file = "tomli-2.3.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4021923f97266babc6ccab9f5068642a0095faa0a51a246a6a02fccbb3514eaf"},
{file = "tomli-2.3.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4ea38c40145a357d513bffad0ed869f13c1773716cf71ccaa83b0fa0cc4e42f"},
{file = "tomli-2.3.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:ad805ea85eda330dbad64c7ea7a4556259665bdf9d2672f5dccc740eb9d3ca05"},
{file = "tomli-2.3.0-cp313-cp313-win32.whl", hash = "sha256:97d5eec30149fd3294270e889b4234023f2c69747e555a27bd708828353ab606"},
{file = "tomli-2.3.0-cp313-cp313-win_amd64.whl", hash = "sha256:0c95ca56fbe89e065c6ead5b593ee64b84a26fca063b5d71a1122bf26e533999"},
{file = "tomli-2.3.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:cebc6fe843e0733ee827a282aca4999b596241195f43b4cc371d64fc6639da9e"},
{file = "tomli-2.3.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:4c2ef0244c75aba9355561272009d934953817c49f47d768070c3c94355c2aa3"},
{file = "tomli-2.3.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c22a8bf253bacc0cf11f35ad9808b6cb75ada2631c2d97c971122583b129afbc"},
{file = "tomli-2.3.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0eea8cc5c5e9f89c9b90c4896a8deefc74f518db5927d0e0e8d4a80953d774d0"},
{file = "tomli-2.3.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b74a0e59ec5d15127acdabd75ea17726ac4c5178ae51b85bfe39c4f8a278e879"},
{file = "tomli-2.3.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:b5870b50c9db823c595983571d1296a6ff3e1b88f734a4c8f6fc6188397de005"},
{file = "tomli-2.3.0-cp314-cp314-win32.whl", hash = "sha256:feb0dacc61170ed7ab602d3d972a58f14ee3ee60494292d384649a3dc38ef463"},
{file = "tomli-2.3.0-cp314-cp314-win_amd64.whl", hash = "sha256:b273fcbd7fc64dc3600c098e39136522650c49bca95df2d11cf3b626422392c8"},
{file = "tomli-2.3.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:940d56ee0410fa17ee1f12b817b37a4d4e4dc4d27340863cc67236c74f582e77"},
{file = "tomli-2.3.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:f85209946d1fe94416debbb88d00eb92ce9cd5266775424ff81bc959e001acaf"},
{file = "tomli-2.3.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a56212bdcce682e56b0aaf79e869ba5d15a6163f88d5451cbde388d48b13f530"},
{file = "tomli-2.3.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c5f3ffd1e098dfc032d4d3af5c0ac64f6d286d98bc148698356847b80fa4de1b"},
{file = "tomli-2.3.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5e01decd096b1530d97d5d85cb4dff4af2d8347bd35686654a004f8dea20fc67"},
{file = "tomli-2.3.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:8a35dd0e643bb2610f156cca8db95d213a90015c11fee76c946aa62b7ae7e02f"},
{file = "tomli-2.3.0-cp314-cp314t-win32.whl", hash = "sha256:a1f7f282fe248311650081faafa5f4732bdbfef5d45fe3f2e702fbc6f2d496e0"},
{file = "tomli-2.3.0-cp314-cp314t-win_amd64.whl", hash = "sha256:70a251f8d4ba2d9ac2542eecf008b3c8a9fc5c3f9f02c56a9d7952612be2fdba"},
{file = "tomli-2.3.0-py3-none-any.whl", hash = "sha256:e95b1af3c5b07d9e643909b5abbec77cd9f1217e6d0bca72b0234736b9fb1f1b"},
{file = "tomli-2.3.0.tar.gz", hash = "sha256:64be704a875d2a59753d80ee8a533c3fe183e3f06807ff7dc2232938ccb01549"},
]
[[package]]
name = "tomlkit"
version = "0.13.3"
description = "Style preserving TOML library"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "tomlkit-0.13.3-py3-none-any.whl", hash = "sha256:c89c649d79ee40629a9fda55f8ace8c6a1b42deb912b2a8fd8d942ddadb606b0"},
{file = "tomlkit-0.13.3.tar.gz", hash = "sha256:430cf247ee57df2b94ee3fbe588e71d362a941ebb545dec29b53961d61add2a1"},
]
[[package]]
name = "tox"
version = "4.33.0"
description = "tox is a generic virtualenv management and test command line tool"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "tox-4.33.0-py3-none-any.whl", hash = "sha256:8582ac5c3ca97095ce88ae6bcd310d22614350ea9751b0e4ad39acad7874e270"},
{file = "tox-4.33.0.tar.gz", hash = "sha256:a29244bce3f514f94043e173366aa191c8cf0106ec8ddd18ba53f985acd73cc4"},
]
[package.dependencies]
cachetools = ">=6.2.4"
chardet = ">=5.2"
colorama = ">=0.4.6"
filelock = ">=3.20.2"
packaging = ">=25"
platformdirs = ">=4.5.1"
pluggy = ">=1.6"
pyproject-api = ">=1.10"
tomli = {version = ">=2.3", markers = "python_version < \"3.11\""}
typing-extensions = {version = ">=4.15", markers = "python_version < \"3.11\""}
virtualenv = ">=20.35.4"
[[package]]
name = "twisted"
version = "25.5.0"
description = "An asynchronous networking framework written in Python"
optional = false
python-versions = ">=3.8.0"
groups = ["dev"]
files = [
{file = "twisted-25.5.0-py3-none-any.whl", hash = "sha256:8559f654d01a54a8c3efe66d533d43f383531ebf8d81d9f9ab4769d91ca15df7"},
{file = "twisted-25.5.0.tar.gz", hash = "sha256:1deb272358cb6be1e3e8fc6f9c8b36f78eb0fa7c2233d2dbe11ec6fee04ea316"},
]
[package.dependencies]
attrs = ">=22.2.0"
automat = ">=24.8.0"
constantly = ">=15.1"
hyperlink = ">=17.1.1"
incremental = ">=24.7.0"
typing-extensions = ">=4.2.0"
zope-interface = ">=5"
[package.extras]
all-non-platform = ["appdirs (>=1.4.0)", "appdirs (>=1.4.0)", "bcrypt (>=3.1.3)", "bcrypt (>=3.1.3)", "cryptography (>=3.3)", "cryptography (>=3.3)", "cython-test-exception-raiser (>=1.0.2,<2)", "cython-test-exception-raiser (>=1.0.2,<2)", "h2 (>=3.2,<5.0)", "h2 (>=3.2,<5.0)", "httpx[http2] (>=0.27)", "httpx[http2] (>=0.27)", "hypothesis (>=6.56)", "hypothesis (>=6.56)", "idna (>=2.4)", "idna (>=2.4)", "priority (>=1.1.0,<2.0)", "priority (>=1.1.0,<2.0)", "pyhamcrest (>=2)", "pyhamcrest (>=2)", "pyopenssl (>=21.0.0)", "pyopenssl (>=21.0.0)", "pyserial (>=3.0)", "pyserial (>=3.0)", "pywin32 (!=226) ; platform_system == \"Windows\"", "pywin32 (!=226) ; platform_system == \"Windows\"", "service-identity (>=18.1.0)", "service-identity (>=18.1.0)", "wsproto", "wsproto"]
conch = ["appdirs (>=1.4.0)", "bcrypt (>=3.1.3)", "cryptography (>=3.3)"]
dev = ["coverage (>=7.5,<8.0)", "cython-test-exception-raiser (>=1.0.2,<2)", "httpx[http2] (>=0.27)", "hypothesis (>=6.56)", "pydoctor (>=24.11.1,<24.12.0)", "pyflakes (>=2.2,<3.0)", "pyhamcrest (>=2)", "python-subunit (>=1.4,<2.0)", "sphinx (>=6,<7)", "sphinx-rtd-theme (>=1.3,<2.0)", "towncrier (>=23.6,<24.0)", "twistedchecker (>=0.7,<1.0)"]
dev-release = ["pydoctor (>=24.11.1,<24.12.0)", "pydoctor (>=24.11.1,<24.12.0)", "sphinx (>=6,<7)", "sphinx (>=6,<7)", "sphinx-rtd-theme (>=1.3,<2.0)", "sphinx-rtd-theme (>=1.3,<2.0)", "towncrier (>=23.6,<24.0)", "towncrier (>=23.6,<24.0)"]
gtk-platform = ["appdirs (>=1.4.0)", "appdirs (>=1.4.0)", "bcrypt (>=3.1.3)", "bcrypt (>=3.1.3)", "cryptography (>=3.3)", "cryptography (>=3.3)", "cython-test-exception-raiser (>=1.0.2,<2)", "cython-test-exception-raiser (>=1.0.2,<2)", "h2 (>=3.2,<5.0)", "h2 (>=3.2,<5.0)", "httpx[http2] (>=0.27)", "httpx[http2] (>=0.27)", "hypothesis (>=6.56)", "hypothesis (>=6.56)", "idna (>=2.4)", "idna (>=2.4)", "priority (>=1.1.0,<2.0)", "priority (>=1.1.0,<2.0)", "pygobject", "pygobject", "pyhamcrest (>=2)", "pyhamcrest (>=2)", "pyopenssl (>=21.0.0)", "pyopenssl (>=21.0.0)", "pyserial (>=3.0)", "pyserial (>=3.0)", "pywin32 (!=226) ; platform_system == \"Windows\"", "pywin32 (!=226) ; platform_system == \"Windows\"", "service-identity (>=18.1.0)", "service-identity (>=18.1.0)", "wsproto", "wsproto"]
http2 = ["h2 (>=3.2,<5.0)", "priority (>=1.1.0,<2.0)"]
macos-platform = ["appdirs (>=1.4.0)", "appdirs (>=1.4.0)", "bcrypt (>=3.1.3)", "bcrypt (>=3.1.3)", "cryptography (>=3.3)", "cryptography (>=3.3)", "cython-test-exception-raiser (>=1.0.2,<2)", "cython-test-exception-raiser (>=1.0.2,<2)", "h2 (>=3.2,<5.0)", "h2 (>=3.2,<5.0)", "httpx[http2] (>=0.27)", "httpx[http2] (>=0.27)", "hypothesis (>=6.56)", "hypothesis (>=6.56)", "idna (>=2.4)", "idna (>=2.4)", "priority (>=1.1.0,<2.0)", "priority (>=1.1.0,<2.0)", "pyhamcrest (>=2)", "pyhamcrest (>=2)", "pyobjc-core (<11) ; python_version < \"3.9\"", "pyobjc-core (<11) ; python_version < \"3.9\"", "pyobjc-core ; python_version >= \"3.9\"", "pyobjc-core ; python_version >= \"3.9\"", "pyobjc-framework-cfnetwork (<11) ; python_version < \"3.9\"", "pyobjc-framework-cfnetwork (<11) ; python_version < \"3.9\"", "pyobjc-framework-cfnetwork ; python_version >= \"3.9\"", "pyobjc-framework-cfnetwork ; python_version >= \"3.9\"", "pyobjc-framework-cocoa (<11) ; python_version < \"3.9\"", "pyobjc-framework-cocoa (<11) ; python_version < \"3.9\"", "pyobjc-framework-cocoa ; python_version >= \"3.9\"", "pyobjc-framework-cocoa ; python_version >= \"3.9\"", "pyopenssl (>=21.0.0)", "pyopenssl (>=21.0.0)", "pyserial (>=3.0)", "pyserial (>=3.0)", "pywin32 (!=226) ; platform_system == \"Windows\"", "pywin32 (!=226) ; platform_system == \"Windows\"", "service-identity (>=18.1.0)", "service-identity (>=18.1.0)", "wsproto", "wsproto"]
mypy = ["appdirs (>=1.4.0)", "bcrypt (>=3.1.3)", "coverage (>=7.5,<8.0)", "cryptography (>=3.3)", "cython-test-exception-raiser (>=1.0.2,<2)", "h2 (>=3.2,<5.0)", "httpx[http2] (>=0.27)", "hypothesis (>=6.56)", "idna (>=2.4)", "mypy (==1.10.1)", "mypy-zope (==1.0.6)", "priority (>=1.1.0,<2.0)", "pydoctor (>=24.11.1,<24.12.0)", "pyflakes (>=2.2,<3.0)", "pyhamcrest (>=2)", "pyopenssl (>=21.0.0)", "pyserial (>=3.0)", "python-subunit (>=1.4,<2.0)", "pywin32 (!=226) ; platform_system == \"Windows\"", "service-identity (>=18.1.0)", "sphinx (>=6,<7)", "sphinx-rtd-theme (>=1.3,<2.0)", "towncrier (>=23.6,<24.0)", "twistedchecker (>=0.7,<1.0)", "types-pyopenssl", "types-setuptools", "wsproto"]
osx-platform = ["appdirs (>=1.4.0)", "appdirs (>=1.4.0)", "bcrypt (>=3.1.3)", "bcrypt (>=3.1.3)", "cryptography (>=3.3)", "cryptography (>=3.3)", "cython-test-exception-raiser (>=1.0.2,<2)", "cython-test-exception-raiser (>=1.0.2,<2)", "h2 (>=3.2,<5.0)", "h2 (>=3.2,<5.0)", "httpx[http2] (>=0.27)", "httpx[http2] (>=0.27)", "hypothesis (>=6.56)", "hypothesis (>=6.56)", "idna (>=2.4)", "idna (>=2.4)", "priority (>=1.1.0,<2.0)", "priority (>=1.1.0,<2.0)", "pyhamcrest (>=2)", "pyhamcrest (>=2)", "pyobjc-core (<11) ; python_version < \"3.9\"", "pyobjc-core (<11) ; python_version < \"3.9\"", "pyobjc-core ; python_version >= \"3.9\"", "pyobjc-core ; python_version >= \"3.9\"", "pyobjc-framework-cfnetwork (<11) ; python_version < \"3.9\"", "pyobjc-framework-cfnetwork (<11) ; python_version < \"3.9\"", "pyobjc-framework-cfnetwork ; python_version >= \"3.9\"", "pyobjc-framework-cfnetwork ; python_version >= \"3.9\"", "pyobjc-framework-cocoa (<11) ; python_version < \"3.9\"", "pyobjc-framework-cocoa (<11) ; python_version < \"3.9\"", "pyobjc-framework-cocoa ; python_version >= \"3.9\"", "pyobjc-framework-cocoa ; python_version >= \"3.9\"", "pyopenssl (>=21.0.0)", "pyopenssl (>=21.0.0)", "pyserial (>=3.0)", "pyserial (>=3.0)", "pywin32 (!=226) ; platform_system == \"Windows\"", "pywin32 (!=226) ; platform_system == \"Windows\"", "service-identity (>=18.1.0)", "service-identity (>=18.1.0)", "wsproto", "wsproto"]
serial = ["pyserial (>=3.0)", "pywin32 (!=226) ; platform_system == \"Windows\""]
test = ["cython-test-exception-raiser (>=1.0.2,<2)", "httpx[http2] (>=0.27)", "hypothesis (>=6.56)", "pyhamcrest (>=2)"]
tls = ["idna (>=2.4)", "pyopenssl (>=21.0.0)", "service-identity (>=18.1.0)"]
websocket = ["wsproto"]
windows-platform = ["appdirs (>=1.4.0)", "appdirs (>=1.4.0)", "bcrypt (>=3.1.3)", "bcrypt (>=3.1.3)", "cryptography (>=3.3)", "cryptography (>=3.3)", "cython-test-exception-raiser (>=1.0.2,<2)", "cython-test-exception-raiser (>=1.0.2,<2)", "h2 (>=3.2,<5.0)", "h2 (>=3.2,<5.0)", "httpx[http2] (>=0.27)", "httpx[http2] (>=0.27)", "hypothesis (>=6.56)", "hypothesis (>=6.56)", "idna (>=2.4)", "idna (>=2.4)", "priority (>=1.1.0,<2.0)", "priority (>=1.1.0,<2.0)", "pyhamcrest (>=2)", "pyhamcrest (>=2)", "pyopenssl (>=21.0.0)", "pyopenssl (>=21.0.0)", "pyserial (>=3.0)", "pyserial (>=3.0)", "pywin32 (!=226)", "pywin32 (!=226)", "pywin32 (!=226) ; platform_system == \"Windows\"", "pywin32 (!=226) ; platform_system == \"Windows\"", "service-identity (>=18.1.0)", "service-identity (>=18.1.0)", "twisted-iocpsupport (>=1.0.2)", "twisted-iocpsupport (>=1.0.2)", "wsproto", "wsproto"]
[[package]]
name = "typing-extensions"
version = "4.15.0"
description = "Backported and Experimental Type Hints for Python 3.9+"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548"},
{file = "typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466"},
]
[[package]]
name = "urllib3"
version = "2.6.2"
description = "HTTP library with thread-safe connection pooling, file post, and more."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "urllib3-2.6.2-py3-none-any.whl", hash = "sha256:ec21cddfe7724fc7cb4ba4bea7aa8e2ef36f607a4bab81aa6ce42a13dc3f03dd"},
{file = "urllib3-2.6.2.tar.gz", hash = "sha256:016f9c98bb7e98085cb2b4b17b87d2c702975664e4f060c6532e64d1c1a5e797"},
]
[package.extras]
brotli = ["brotli (>=1.2.0) ; platform_python_implementation == \"CPython\"", "brotlicffi (>=1.2.0.0) ; platform_python_implementation != \"CPython\""]
h2 = ["h2 (>=4,<5)"]
socks = ["pysocks (>=1.5.6,!=1.5.7,<2.0)"]
zstd = ["backports-zstd (>=1.0.0) ; python_version < \"3.14\""]
[[package]]
name = "virtualenv"
version = "20.35.4"
description = "Virtual Python Environment builder"
optional = false
python-versions = ">=3.8"
groups = ["dev"]
files = [
{file = "virtualenv-20.35.4-py3-none-any.whl", hash = "sha256:c21c9cede36c9753eeade68ba7d523529f228a403463376cf821eaae2b650f1b"},
{file = "virtualenv-20.35.4.tar.gz", hash = "sha256:643d3914d73d3eeb0c552cbb12d7e82adf0e504dbf86a3182f8771a153a1971c"},
]
[package.dependencies]
distlib = ">=0.3.7,<1"
filelock = ">=3.12.2,<4"
platformdirs = ">=3.9.1,<5"
typing-extensions = {version = ">=4.13.2", markers = "python_version < \"3.11\""}
[package.extras]
docs = ["furo (>=2023.7.26)", "proselint (>=0.13)", "sphinx (>=7.1.2,!=7.3)", "sphinx-argparse (>=0.4)", "sphinxcontrib-towncrier (>=0.2.1a0)", "towncrier (>=23.6)"]
test = ["covdefaults (>=2.3)", "coverage (>=7.2.7)", "coverage-enable-subprocess (>=1)", "flaky (>=3.7)", "packaging (>=23.1)", "pytest (>=7.4)", "pytest-env (>=0.8.2)", "pytest-freezer (>=0.4.8) ; platform_python_implementation == \"PyPy\" or platform_python_implementation == \"GraalVM\" or platform_python_implementation == \"CPython\" and sys_platform == \"win32\" and python_version >= \"3.13\"", "pytest-mock (>=3.11.1)", "pytest-randomly (>=3.12)", "pytest-timeout (>=2.1)", "setuptools (>=68)", "time-machine (>=2.10) ; platform_python_implementation == \"CPython\""]
[[package]]
name = "watchdog"
version = "6.0.0"
description = "Filesystem events monitoring"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "watchdog-6.0.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:d1cdb490583ebd691c012b3d6dae011000fe42edb7a82ece80965b42abd61f26"},
{file = "watchdog-6.0.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:bc64ab3bdb6a04d69d4023b29422170b74681784ffb9463ed4870cf2f3e66112"},
{file = "watchdog-6.0.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:c897ac1b55c5a1461e16dae288d22bb2e412ba9807df8397a635d88f671d36c3"},
{file = "watchdog-6.0.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:6eb11feb5a0d452ee41f824e271ca311a09e250441c262ca2fd7ebcf2461a06c"},
{file = "watchdog-6.0.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:ef810fbf7b781a5a593894e4f439773830bdecb885e6880d957d5b9382a960d2"},
{file = "watchdog-6.0.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:afd0fe1b2270917c5e23c2a65ce50c2a4abb63daafb0d419fde368e272a76b7c"},
{file = "watchdog-6.0.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:bdd4e6f14b8b18c334febb9c4425a878a2ac20efd1e0b231978e7b150f92a948"},
{file = "watchdog-6.0.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:c7c15dda13c4eb00d6fb6fc508b3c0ed88b9d5d374056b239c4ad1611125c860"},
{file = "watchdog-6.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6f10cb2d5902447c7d0da897e2c6768bca89174d0c6e1e30abec5421af97a5b0"},
{file = "watchdog-6.0.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:490ab2ef84f11129844c23fb14ecf30ef3d8a6abafd3754a6f75ca1e6654136c"},
{file = "watchdog-6.0.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:76aae96b00ae814b181bb25b1b98076d5fc84e8a53cd8885a318b42b6d3a5134"},
{file = "watchdog-6.0.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:a175f755fc2279e0b7312c0035d52e27211a5bc39719dd529625b1930917345b"},
{file = "watchdog-6.0.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:e6f0e77c9417e7cd62af82529b10563db3423625c5fce018430b249bf977f9e8"},
{file = "watchdog-6.0.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:90c8e78f3b94014f7aaae121e6b909674df5b46ec24d6bebc45c44c56729af2a"},
{file = "watchdog-6.0.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:e7631a77ffb1f7d2eefa4445ebbee491c720a5661ddf6df3498ebecae5ed375c"},
{file = "watchdog-6.0.0-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:c7ac31a19f4545dd92fc25d200694098f42c9a8e391bc00bdd362c5736dbf881"},
{file = "watchdog-6.0.0-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:9513f27a1a582d9808cf21a07dae516f0fab1cf2d7683a742c498b93eedabb11"},
{file = "watchdog-6.0.0-pp39-pypy39_pp73-macosx_10_15_x86_64.whl", hash = "sha256:7a0e56874cfbc4b9b05c60c8a1926fedf56324bb08cfbc188969777940aef3aa"},
{file = "watchdog-6.0.0-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:e6439e374fc012255b4ec786ae3c4bc838cd7309a540e5fe0952d03687d8804e"},
{file = "watchdog-6.0.0-py3-none-manylinux2014_aarch64.whl", hash = "sha256:7607498efa04a3542ae3e05e64da8202e58159aa1fa4acddf7678d34a35d4f13"},
{file = "watchdog-6.0.0-py3-none-manylinux2014_armv7l.whl", hash = "sha256:9041567ee8953024c83343288ccc458fd0a2d811d6a0fd68c4c22609e3490379"},
{file = "watchdog-6.0.0-py3-none-manylinux2014_i686.whl", hash = "sha256:82dc3e3143c7e38ec49d61af98d6558288c415eac98486a5c581726e0737c00e"},
{file = "watchdog-6.0.0-py3-none-manylinux2014_ppc64.whl", hash = "sha256:212ac9b8bf1161dc91bd09c048048a95ca3a4c4f5e5d4a7d1b1a7d5752a7f96f"},
{file = "watchdog-6.0.0-py3-none-manylinux2014_ppc64le.whl", hash = "sha256:e3df4cbb9a450c6d49318f6d14f4bbc80d763fa587ba46ec86f99f9e6876bb26"},
{file = "watchdog-6.0.0-py3-none-manylinux2014_s390x.whl", hash = "sha256:2cce7cfc2008eb51feb6aab51251fd79b85d9894e98ba847408f662b3395ca3c"},
{file = "watchdog-6.0.0-py3-none-manylinux2014_x86_64.whl", hash = "sha256:20ffe5b202af80ab4266dcd3e91aae72bf2da48c0d33bdb15c66658e685e94e2"},
{file = "watchdog-6.0.0-py3-none-win32.whl", hash = "sha256:07df1fdd701c5d4c8e55ef6cf55b8f0120fe1aef7ef39a1c6fc6bc2e606d517a"},
{file = "watchdog-6.0.0-py3-none-win_amd64.whl", hash = "sha256:cbafb470cf848d93b5d013e2ecb245d4aa1c8fd0504e863ccefa32445359d680"},
{file = "watchdog-6.0.0-py3-none-win_ia64.whl", hash = "sha256:a1914259fa9e1454315171103c6a30961236f508b9b623eae470268bbcc6a22f"},
{file = "watchdog-6.0.0.tar.gz", hash = "sha256:9ddf7c82fda3ae8e24decda1338ede66e1c99883db93711d8fb941eaa2d8c282"},
]
[package.extras]
watchmedo = ["PyYAML (>=3.10)"]
[[package]]
name = "zope-exceptions"
version = "6.0"
description = "Zope Exceptions"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "zope_exceptions-6.0-py3-none-any.whl", hash = "sha256:bc31943c9f849d86d258564f36c6601dcc05ba665abd04d4c5c5dabed72708e5"},
{file = "zope_exceptions-6.0.tar.gz", hash = "sha256:0ac0e078ecdd8acb5da231c39fc6454bdf3249216fd1c06d0578bf8ea6bf3299"},
]
[package.dependencies]
setuptools = "*"
"zope.interface" = "*"
[package.extras]
docs = ["Sphinx", "repoze.sphinx.autointerface"]
test = ["zope.testrunner (>=6.4)"]
[[package]]
name = "zope-interface"
version = "8.1.1"
description = "Interfaces for Python"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
{file = "zope_interface-8.1.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:5c6b12b656c7d7e3d79cad8e2afc4a37eae6b6076e2c209a33345143148e435e"},
{file = "zope_interface-8.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:557c0f1363c300db406e9eeaae8ab6d1ba429d4fed60d8ab7dadab5ca66ccd35"},
{file = "zope_interface-8.1.1-cp310-cp310-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:127b0e4c873752b777721543cf8525b3db5e76b88bd33bab807f03c568e9003f"},
{file = "zope_interface-8.1.1-cp310-cp310-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:e0892c9d2dd47b45f62d1861bcae8b427fcc49b4a04fff67f12c5c55e56654d7"},
{file = "zope_interface-8.1.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:ff8a92dc8c8a2c605074e464984e25b9b5a8ac9b2a0238dd73a0f374df59a77e"},
{file = "zope_interface-8.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:54627ddf6034aab1f506ba750dd093f67d353be6249467d720e9f278a578efe5"},
{file = "zope_interface-8.1.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:e8a0fdd5048c1bb733e4693eae9bc4145a19419ea6a1c95299318a93fe9f3d72"},
{file = "zope_interface-8.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:a4cb0ea75a26b606f5bc8524fbce7b7d8628161b6da002c80e6417ce5ec757c0"},
{file = "zope_interface-8.1.1-cp311-cp311-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:c267b00b5a49a12743f5e1d3b4beef45479d696dab090f11fe3faded078a5133"},
{file = "zope_interface-8.1.1-cp311-cp311-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:e25d3e2b9299e7ec54b626573673bdf0d740cf628c22aef0a3afef85b438aa54"},
{file = "zope_interface-8.1.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:63db1241804417aff95ac229c13376c8c12752b83cc06964d62581b493e6551b"},
{file = "zope_interface-8.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:9639bf4ed07b5277fb231e54109117c30d608254685e48a7104a34618bcbfc83"},
{file = "zope_interface-8.1.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:a16715808408db7252b8c1597ed9008bdad7bf378ed48eb9b0595fad4170e49d"},
{file = "zope_interface-8.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ce6b58752acc3352c4aa0b55bbeae2a941d61537e6afdad2467a624219025aae"},
{file = "zope_interface-8.1.1-cp312-cp312-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:807778883d07177713136479de7fd566f9056a13aef63b686f0ab4807c6be259"},
{file = "zope_interface-8.1.1-cp312-cp312-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:50e5eb3b504a7d63dc25211b9298071d5b10a3eb754d6bf2f8ef06cb49f807ab"},
{file = "zope_interface-8.1.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:eee6f93b2512ec9466cf30c37548fd3ed7bc4436ab29cd5943d7a0b561f14f0f"},
{file = "zope_interface-8.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:80edee6116d569883c58ff8efcecac3b737733d646802036dc337aa839a5f06b"},
{file = "zope_interface-8.1.1-cp313-cp313-macosx_10_9_x86_64.whl", hash = "sha256:84f9be6d959640de9da5d14ac1f6a89148b16da766e88db37ed17e936160b0b1"},
{file = "zope_interface-8.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:531fba91dcb97538f70cf4642a19d6574269460274e3f6004bba6fe684449c51"},
{file = "zope_interface-8.1.1-cp313-cp313-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:fc65f5633d5a9583ee8d88d1f5de6b46cd42c62e47757cfe86be36fb7c8c4c9b"},
{file = "zope_interface-8.1.1-cp313-cp313-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:efef80ddec4d7d99618ef71bc93b88859248075ca2e1ae1c78636654d3d55533"},
{file = "zope_interface-8.1.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:49aad83525eca3b4747ef51117d302e891f0042b06f32aa1c7023c62642f962b"},
{file = "zope_interface-8.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:71cf329a21f98cb2bd9077340a589e316ac8a415cac900575a32544b3dffcb98"},
{file = "zope_interface-8.1.1-cp314-cp314-macosx_10_9_x86_64.whl", hash = "sha256:da311e9d253991ca327601f47c4644d72359bac6950fbb22f971b24cd7850f8c"},
{file = "zope_interface-8.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:3fb25fca0442c7fb93c4ee40b42e3e033fef2f648730c4b7ae6d43222a3e8946"},
{file = "zope_interface-8.1.1-cp314-cp314-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:bac588d0742b4e35efb7c7df1dacc0397b51ed37a17d4169a38019a1cebacf0a"},
{file = "zope_interface-8.1.1-cp314-cp314-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:3d1f053d2d5e2b393e619bce1e55954885c2e63969159aa521839e719442db49"},
{file = "zope_interface-8.1.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:64a1ad7f4cb17d948c6bdc525a1d60c0e567b2526feb4fa38b38f249961306b8"},
{file = "zope_interface-8.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:169214da1b82b7695d1a36f92d70b11166d66b6b09d03df35d150cc62ac52276"},
{file = "zope_interface-8.1.1.tar.gz", hash = "sha256:51b10e6e8e238d719636a401f44f1e366146912407b58453936b781a19be19ec"},
]
[package.extras]
docs = ["Sphinx", "furo", "repoze.sphinx.autointerface"]
test = ["coverage[toml]", "zope.event", "zope.testing"]
testing = ["coverage[toml]", "zope.event", "zope.testing"]
[[package]]
name = "zope-testrunner"
version = "8.1"
description = "Zope testrunner script."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
{file = "zope_testrunner-8.1-py3-none-any.whl", hash = "sha256:34fd7c9960f82ab8f3b67ff63f8a466080c0d0a9739e6e789ffa95bec60bbeea"},
{file = "zope_testrunner-8.1.tar.gz", hash = "sha256:65389bb17634291cab3590bb9addc6ff010e6907440e772a04dcb2b8029acfde"},
]
[package.dependencies]
"zope.exceptions" = "*"
"zope.interface" = "*"
[package.extras]
docs = ["Sphinx", "sphinxcontrib-programoutput"]
subunit = ["python-subunit (>=1.4.3)", "testtools (>=0.9.30)"]
test = ["zope.testing"]
[metadata]
lock-version = "2.1"
python-versions = "^3.10.0"
content-hash = "666aa9911919b31d5773cc1709abe7c55ddd6619b602107bc60a4c4209f308fb"
flexmock-0.13.0/pyproject.toml 0000664 0000000 0000000 00000007116 15130526717 0016333 0 ustar 00root root 0000000 0000000 [tool.poetry]
name = "flexmock"
version = "0.13.0"
description = "flexmock is a testing library for Python that makes it easy to create mocks, stubs and fakes."
authors = ["Slavek Kabrda", "Herman Sheremetyev"]
maintainers = [
"Adarsh Krishnan ",
"Christophe Riolo Uusivaara ",
"Olli Paakkunainen ",
]
license = "BSD-2-Clause"
repository = "https://github.com/flexmock/flexmock"
documentation = "https://flexmock.readthedocs.io"
readme = "README.md"
keywords = ["mock", "testing", "test", "unittest", "pytest"]
classifiers = [
"License :: OSI Approved :: BSD License",
"Intended Audience :: Developers",
"Development Status :: 5 - Production/Stable",
"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",
"Programming Language :: Python :: 3 :: Only",
"Programming Language :: Python :: Implementation :: PyPy",
"Topic :: Software Development :: Testing",
"Topic :: Software Development :: Testing :: Mocking",
"Topic :: Software Development :: Testing :: Unit",
"Typing :: Typed",
]
include = [
{ path = "CHANGELOG.md", format = "sdist" },
{ path = "docs/**/*.md", format = "sdist" },
{ path = "LICENSE", format = "sdist" },
{ path = "README.md", format = "sdist" },
{ path = "tox.ini", format = "sdist" },
{ path = "tests/**/*.py", format = "sdist" },
{ path = "docs/conf.py", format = "sdist" },
{ path = "docs/toctree.rst", format = "sdist" },
]
packages = [{ include = "flexmock", from = "src" }]
[tool.poetry.urls]
"Changes" = "https://flexmock.readthedocs.io/en/latest/changelog/"
"Source Code" = "https://github.com/flexmock/flexmock"
"Issue Tracker" = "https://github.com/flexmock/flexmock/issues"
[tool.poetry.plugins.pytest11]
flexmock = "flexmock._pytest_plugin"
[tool.poetry.dependencies]
python = "^3.10.0"
[tool.poetry.group.dev.dependencies]
pytest = "*"
mypy = "*"
pylint = "*"
black = "*"
isort = "*"
tox = "*"
Twisted = "*"
pytest-cov = "*"
mkdocs-material = "*"
markdown-include = "*"
mkdocstrings = { extras = ["python-legacy"], version = "*" }
testtools = "*"
myst-parser = "*"
"zope.testrunner" = "*"
python-subunit = "*"
teamcity-messages = "*"
# Sphinx v7 drops setuptools support.
sphinx = "<7.0.0"
[build-system]
requires = ["poetry-core>=1.0.0"]
build-backend = "poetry.core.masonry.api"
[tool.pylint.MASTER]
load-plugins = ["pylint.extensions.docstyle", "pylint.extensions.typing"]
[tool.pylint.main]
py-version = "3.10.0"
[tool.pylint.messages_control]
disable = [
"too-many-instance-attributes",
"too-few-public-methods",
"too-many-function-args",
"too-many-arguments",
"too-many-locals",
"too-many-branches",
"too-many-statements",
"too-many-public-methods",
"protected-access",
"broad-except",
"fixme",
"too-many-ancestors",
]
[tool.pylint.format]
max-line-length = "100"
[tool.isort]
line_length = 100
profile = "black"
[tool.black]
line-length = 100
[tool.mypy]
warn_redundant_casts = true
warn_unused_ignores = true
ignore_missing_imports = true
disallow_untyped_calls = true
disallow_untyped_defs = true
disallow_incomplete_defs = true
check_untyped_defs = true
disallow_untyped_decorators = true
warn_return_any = true
no_implicit_optional = true
[[tool.mypy.overrides]]
module = "tests.*"
ignore_errors = true
[tool.pytest.ini_options]
python_files = ["test_pytest.py"]
xfail_strict = true
flexmock-0.13.0/setup.py 0000664 0000000 0000000 00000004102 15130526717 0015121 0 ustar 00root root 0000000 0000000 """Flexmock setup.py."""
from setuptools import setup
with open("README.md", encoding="utf-8") as file:
long_description = file.read()
VERSION = "0.13.0"
setup(
name="flexmock",
version=VERSION,
author="Slavek Kabrda, Herman Sheremetyev",
author_email="slavek@redhat.com",
url="https://flexmock.readthedocs.io/",
project_urls={
"Documentation": "https://flexmock.readthedocs.io/",
"Changes": "https://flexmock.readthedocs.io/en/latest/changelog/",
"Source Code": "https://github.com/flexmock/flexmock",
"Issue Tracker": "https://github.com/flexmock/flexmock/issues",
},
license="BSD-2-Clause",
description="flexmock is a testing library for Python that makes it easy to create mocks,"
"stubs and fakes.",
long_description=long_description,
long_description_content_type="text/markdown",
keywords="mock testing test unittest pytest",
classifiers=[
"License :: OSI Approved :: BSD License",
"Intended Audience :: Developers",
"Development Status :: 5 - Production/Stable",
"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",
"Programming Language :: Python :: 3 :: Only",
"Programming Language :: Python :: Implementation :: PyPy",
"Topic :: Software Development :: Testing",
"Topic :: Software Development :: Testing :: Mocking",
"Topic :: Software Development :: Testing :: Unit",
"Typing :: Typed",
],
python_requires=">=3.10.0,<4.0.0",
packages=["flexmock"],
package_dir={"": "src"},
include_package_data=True,
command_options={
"build_sphinx": {
"version": ("setup.py", VERSION),
"release": ("setup.py", VERSION),
}
},
entry_points={
"pytest11": [
"flexmock = flexmock._pytest_plugin",
],
},
)
flexmock-0.13.0/src/ 0000775 0000000 0000000 00000000000 15130526717 0014201 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/src/flexmock/ 0000775 0000000 0000000 00000000000 15130526717 0016011 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/src/flexmock/__init__.py 0000664 0000000 0000000 00000000344 15130526717 0020123 0 ustar 00root root 0000000 0000000 """Flexmock testing library for Python."""
from flexmock import _integrations # pylint: disable=unused-import
from flexmock._api import Expectation, Mock, flexmock
__all__ = [
"Expectation",
"Mock",
"flexmock",
]
flexmock-0.13.0/src/flexmock/_api.py 0000664 0000000 0000000 00000167005 15130526717 0017304 0 ustar 00root root 0000000 0000000 """Flexmock public API."""
# pylint: disable=too-many-lines
import inspect
import re
import sys
import types
from collections.abc import Callable, Iterator
from types import BuiltinMethodType, TracebackType
from typing import Any, NoReturn
from flexmock.exceptions import (
CallOrderError,
ExceptionClassError,
ExceptionMessageError,
FlexmockError,
MethodCallError,
MethodSignatureError,
MockBuiltinError,
StateError,
)
AT_LEAST = "at least"
AT_MOST = "at most"
EXACTLY = "exactly"
SPECIAL_METHODS = (classmethod, staticmethod)
UPDATED_ATTRS = ["should_receive", "should_call", "new_instances"]
DEFAULT_CLASS_ATTRIBUTES = [attr for attr in dir(type) if attr not in dir(type("", (object,), {}))]
class ReturnValue:
"""ReturnValue"""
def __init__(
self,
value: Any | None = None,
raises: type[BaseException] | BaseException | None = None,
) -> None:
self.value = value
self.raises = raises
def __str__(self) -> str:
if self.raises:
return f"{self.raises}({_arg_to_str(self.value)})"
if not isinstance(self.value, tuple):
return str(_arg_to_str(self.value))
if len(self.value) == 1:
return str(_arg_to_str(self.value[0]))
values = ", ".join([_arg_to_str(x) for x in self.value])
return f"({values})"
class Mock:
"""Fake object class returned by the `flexmock()` function."""
def __init__(self, **kwargs: Any) -> None:
"""Mock constructor.
Args:
**kwargs: dict of attribute/value pairs used to initialize the mock
object.
"""
self._object: Any = self
for attr, value in kwargs.items():
if isinstance(value, property):
setattr(self.__class__, attr, value)
else:
setattr(self, attr, value)
def __enter__(self) -> Any:
return self._object
def __exit__(
self,
exc_type: type[BaseException] | None,
exc_value: BaseException | None,
traceback: TracebackType | None,
) -> None:
pass
def __call__(self, *args: Any, **kwargs: Any) -> "Mock":
"""Make mocks callable with and without parentheses.
If `Mock` is not callable, it is difficult to mock attributes that
should work with and without parentheses.
"""
return self
def __iter__(self) -> Iterator[Any]:
"""Makes the mock object iterable.
Call the instance's version of __iter__ if available, otherwise yield self.
"""
if (
hasattr(self, "__dict__")
and isinstance(self.__dict__, dict)
and "__iter__" in self.__dict__
):
yield from self.__dict__["__iter__"](self)
else:
yield self
def should_receive(self, name: str) -> "Expectation":
"""Replaces the specified attribute with a fake.
Args:
name: Name of the attribute to replace.
Returns:
Expectation object which can be used to modify the expectations
on the fake attribute.
Examples:
>>> flexmock(plane).should_receive("fly").and_return("vooosh!").once()
>>> plane.fly()
'vooosh!'
"""
if name in UPDATED_ATTRS:
raise FlexmockError("unable to replace flexmock methods")
chained_methods = None
if "." in name:
name, chained_methods = name.split(".", 1)
name = self._update_name_if_mangled(name)
self._ensure_object_has_named_attribute(name)
if chained_methods:
if not isinstance(self._object, Mock) and not hasattr(
getattr(self._object, name), "__call__"
):
# Create a partial mock if the given name is callable
# this allows chaining attributes
return_value = _create_partial_mock(getattr(self._object, name))
else:
return_value = Mock()
self._create_expectation(name, return_value)
return return_value.should_receive(chained_methods)
return self._create_expectation(name)
def _update_name_if_mangled(self, name: str) -> str:
"""This allows flexmock to mock methods with name mangling."""
if name.startswith("__") and not name.endswith("__") and not inspect.ismodule(self._object):
class_name: str
if inspect.isclass(self._object):
class_name = self._object.__name__
else:
class_name = self._object.__class__.__name__
name = f"_{class_name.lstrip('_')}__{name.lstrip('_')}"
return name
def _ensure_object_has_named_attribute(self, name: str) -> None:
if not isinstance(self._object, Mock) and not self._hasattr(self._object, name):
if hasattr(self._object, "__name__"):
obj_name = self._object.__name__
else:
obj_name = str(self._object)
raise FlexmockError(f"{obj_name} does not have attribute '{name}'")
def _hasattr(self, obj: Any, name: str) -> bool:
"""Ensure hasattr checks don't create side-effects for properties."""
if not inspect.isclass(obj) and hasattr(obj, "__dict__") and name not in obj.__dict__:
if name in DEFAULT_CLASS_ATTRIBUTES:
return False # avoid false positives for things like __call__
return hasattr(obj.__class__, name)
return hasattr(obj, name)
def should_call(self, name: str) -> "Expectation":
"""Creates a spy.
This means that the original method will be called rather than the fake
version. However, we can still keep track of how many times it is called
and with what arguments, and apply expectations accordingly.
`should_call` is meaningless/not allowed for non-callable attributes.
Args:
name: Name of the method to spy.
Returns:
Expectation object.
Examples:
>>> flexmock(plane).should_call("repair").once()
>>> plane.repair("wing")
"""
if isinstance(self._object, Mock) and not hasattr(self._object, name):
raise FlexmockError(
f"Mock object does not have attribute '{name}'. "
f'Did you mean to call should_receive("{name}") instead?'
)
expectation = self.should_receive(name)
return expectation.replace_with(expectation.__dict__["_original"])
def new_instances(self, *args: Any) -> "Expectation":
"""Overrides `__new__` method on a class to return custom objects.
Alias for `should_receive('__new__').and_return(args).one_by_one()`.
Args:
*args: Objects to return on each successive call to `__new__`.
Returns:
Expectation object.
Examples:
>>> fake_plane = flexmock(model="fake")
>>> flexmock(Plane).new_instances(fake_plane)
>>> Plane().model
'fake'
It is also possible to return different fake objects in a sequence:
>>> fake_plane1 = flexmock(model="fake1")
>>> fake_plane2 = flexmock(model="fake2")
>>> flexmock(Plane).new_instances(fake_plane1, fake_plane2)
>>> Plane().model
'fake1'
>>> Plane().model
'fake2'
"""
if inspect.isclass(self._object):
return self.should_receive("__new__").and_return(args).one_by_one()
raise FlexmockError("new_instances can only be called on a class mock")
def _create_expectation(self, name: str, return_value: Any | None = None) -> "Expectation":
expectation = self._get_or_create_expectation(name, return_value)
FlexmockContainer.add_expectation(self, expectation)
if _isproperty(self._object, name):
self._update_property(expectation, name)
elif (
isinstance(self._object, Mock)
or hasattr(getattr(self._object, name), "__call__")
or inspect.isclass(getattr(self._object, name))
):
self._update_method(expectation, name)
else:
self._update_attribute(expectation, name, return_value)
return expectation
def _get_or_create_expectation(
self, name: str, return_value: Any | None = None
) -> "Expectation":
saved_expectations = FlexmockContainer.get_expectations_with_name(self, name)
if saved_expectations:
# If there is already an expectation for the same name, get the
# original object from the FIRST saved expectation.
return Expectation(
self._object,
name=name,
return_value=return_value,
original=saved_expectations[0].__dict__.get("_original"),
method_type=saved_expectations[0].__dict__.get("_method_type"),
)
return Expectation(self._object, name=name, return_value=return_value)
def _create_placeholder_mock_for_proper_teardown(
self, obj: Any, name: str, original: Any
) -> None:
"""Ensures that the given function is replaced on teardown."""
mock = Mock()
mock._object = obj
expectation = Expectation(obj, name=name, original=original)
FlexmockContainer.add_expectation(mock, expectation)
def _update_method(self, expectation: "Expectation", name: str) -> None:
method_instance = self._create_mock_method(name)
if self._hasattr(self._object, name) and not hasattr(expectation, "_original"):
expectation._update_original(name, self._object)
expectation._method_type = self._get_method_type(name, expectation._original)
if expectation._method_type in SPECIAL_METHODS:
expectation._original_function = getattr(self._object, name)
if not inspect.isclass(self._object) or expectation._method_type in SPECIAL_METHODS:
method_instance = types.MethodType(method_instance, self._object)
expectation._local_override = _setattr(self._object, name, method_instance)
if (
expectation._local_override
and not inspect.isclass(self._object)
and not isinstance(self._object, Mock)
and hasattr(self._object.__class__, name)
):
self._update_class_for_magic_builtins(name)
def _get_method_type(self, name: str, method: Callable[..., Any]) -> Any:
"""Get method type of the original method.
Method type is saved because after mocking the base class, it is difficult to determine
the original method type.
"""
method_type = self._get_saved_method_type(name, method)
if method_type is not None:
return method_type
if _is_class_method(method, name):
method_type = classmethod
elif _is_static_method(self._object, name):
method_type = staticmethod
else:
method_type = type(method)
setattr(self._object, f"{name}__flexmock__method_type", method_type)
return method_type
def _get_saved_method_type(self, name: str, method: Callable[..., Any]) -> Any | None:
"""Check method type of the original method if it was saved to the class or base class."""
bound_to = getattr(method, "__self__", None)
if bound_to is not None and inspect.isclass(bound_to):
# Check if the method type was saved in a base class
for cls in inspect.getmro(bound_to):
method_type = vars(cls).get(f"{name}__flexmock__method_type")
if method_type:
return method_type
return None
def _update_class_for_magic_builtins(self, name: str) -> None:
"""Fixes method resolution order for built-in methods.
Replacing magic builtins on instances has no effect as the one attached
to the class takes precedence. To work around it, we update the class'
method to check if the instance in question has one in its own __dict__
and call that instead.
"""
if not (name.startswith("__") and name.endswith("__") and len(name) > 4):
return
original = getattr(self._object.__class__, name)
def updated(self: Any, *kargs: Any, **kwargs: Any) -> Any:
if (
hasattr(self, "__dict__")
and isinstance(self.__dict__, dict)
and name in self.__dict__
):
return self.__dict__[name](*kargs, **kwargs)
return original(self, *kargs, **kwargs)
setattr(self._object.__class__, name, updated)
if updated.__code__ != original.__code__:
self._create_placeholder_mock_for_proper_teardown(
self._object.__class__, name, original
)
def _update_attribute(
self, expectation: "Expectation", name: str, return_value: Any | None = None
) -> None:
expectation._callable = False
if self._hasattr(self._object, name) and not hasattr(expectation, "_original"):
expectation._update_original(name, self._object)
expectation._local_override = _setattr(self._object, name, return_value)
def _update_property(self, expectation: "Expectation", name: str) -> None:
new_name = f"_flexmock__{name}"
obj = self._object
if not inspect.isclass(obj):
obj = obj.__class__
expectation._callable = False
original = getattr(obj, name)
@property # type: ignore
def updated(self: Any) -> Any:
if (
hasattr(self, "__dict__")
and isinstance(self.__dict__, dict)
and name in self.__dict__
):
return self.__dict__[name]
# Return original for instances that are not mocked
return getattr(self, new_name)
setattr(obj, name, updated)
if not hasattr(obj, new_name):
# don't try to double update
FlexmockContainer.add_teardown_property(obj, new_name)
setattr(obj, new_name, original)
self._create_placeholder_mock_for_proper_teardown(obj, name, original)
def _create_mock_method(self, name: str) -> Callable[..., Any]:
def _handle_exception_matching(expectation: Expectation) -> None:
# pylint: disable=misplaced-bare-raise
return_values = expectation._return_values
if return_values:
raised, instance = sys.exc_info()[:2]
assert raised, "no exception was raised"
message = str(instance)
expected = return_values[0].raises
if not expected:
raise
args = return_values[0].value
if inspect.isclass(expected):
assert isinstance(args, dict)
expected_instance = expected(*args["kargs"], **args["kwargs"])
expected_message = str(expected_instance)
if expected is not raised and expected not in raised.__bases__:
raise ExceptionClassError(
f"Raised exception for call {expectation._name} "
"did not match expectation:\n"
f" Expected:\t{expected}\n"
f" Raised:\t{raised}"
)
if args["kargs"] and isinstance(args["kargs"][0], re.Pattern):
if not args["kargs"][0].search(message):
raise ExceptionMessageError(
f"Error message mismatch with raised {expected.__name__}:\n"
f" Expected pattern:\n\t/{args['kargs'][0].pattern}/\n"
f" Received message:\n\t'{message}'"
)
elif expected_message and expected_message != message:
raise (
ExceptionMessageError(
f"Error message mismatch with raised {expected.__name__}:\n"
f" Expected message:\n\t'{message}'\n"
f" Received message:\n\t'{expected_message}'"
)
)
elif expected is not raised:
raise ExceptionClassError(
f"Raised exception for call {expectation._name} "
f"did not match expectation:\n"
f" Expected:\t{repr(expected)}\n"
f" Raised:\t{raised}\n\n"
"Did you try to call and_raise with an instance?\n"
'Instead of and_raise(Exception("arg")), try and_raise(Exception, "arg")'
)
else:
raise
def match_return_values(expected: Any, received: Any) -> bool:
if not isinstance(expected, tuple):
expected = (expected,)
if not isinstance(received, tuple):
received = (received,)
if len(received) != len(expected):
return False
for i, val in enumerate(received):
if not _arguments_match(val, expected[i]):
return False
return True
def pass_thru(
expectation: Expectation, runtime_self: Any, *kargs: Any, **kwargs: Any
) -> Any:
return_values = None
try:
original = expectation._original
_mock = expectation._mock
if inspect.isclass(_mock):
if expectation._method_type in SPECIAL_METHODS:
original = expectation._original_function
return_values = original(*kargs, **kwargs)
else:
return_values = original(runtime_self, *kargs, **kwargs)
else:
return_values = original(*kargs, **kwargs)
except Exception:
return _handle_exception_matching(expectation)
expected_values = expectation._return_values
if expected_values and not match_return_values(expected_values[0].value, return_values):
expected_value = expected_values[0].value
# Display strings with quotes in the error message
if isinstance(return_values, str):
return_values = repr(return_values)
if isinstance(expected_value, str):
expected_value = repr(expected_value)
raise (
MethodSignatureError(
f"Returned values for call {expectation._name} did not match expectation:\n"
f" Expected:\t{expected_value}\n"
f" Returned:\t{return_values}"
)
)
return return_values
def _handle_matched_expectation(
expectation: Expectation, runtime_self: Any, *kargs: Any, **kwargs: Any
) -> Any:
if not expectation._runnable():
raise StateError(
f"{name} expected to be called when {expectation._get_runnable()} is True"
)
expectation._times_called += 1
expectation._verify(final=False)
_pass_thru = expectation._pass_thru
_replace_with = expectation._replace_with
if _pass_thru:
return pass_thru(expectation, runtime_self, *kargs, **kwargs)
if _replace_with:
return _replace_with(*kargs, **kwargs)
return_values = expectation._return_values
if return_values:
return_value = return_values[0]
del return_values[0]
return_values.append(return_value)
else:
return_value = ReturnValue()
if return_value.raises:
if inspect.isclass(return_value.raises):
args = return_value.value
assert isinstance(args, dict)
raise return_value.raises(*args["kargs"], **args["kwargs"])
raise return_value.raises
return return_value.value
def mock_method(runtime_self: Any, *kargs: Any, **kwargs: Any) -> Any:
arguments = {"kargs": kargs, "kwargs": kwargs}
expectation = FlexmockContainer.get_flexmock_expectation(self, name, arguments)
if expectation:
return _handle_matched_expectation(expectation, runtime_self, *kargs, **kwargs)
# inform the user which expectation(s) for the method were _not_ matched
saved_expectations = reversed(FlexmockContainer.get_expectations_with_name(self, name))
error_msg = (
f"Arguments for call {name} did not match expectations:\n"
f" Received call:\t{_format_args(name, arguments)}\n"
)
if saved_expectations:
error_msg += "\n".join(
f" Expected call[{index}]:\t{_format_args(name, expectation._args)}"
for index, expectation in enumerate(saved_expectations, 1)
)
raise MethodSignatureError(error_msg)
return mock_method
def flexmock_teardown() -> None:
"""Performs flexmock-specific teardown tasks."""
saved = {}
instances = []
classes = []
for mock_object, expectations in FlexmockContainer.flexmock_objects.items():
saved[mock_object] = expectations[:]
# Reset the expectations in reversed order to ensure everything is restored to
# its original form even if setting consequent expectations on the same object
# operates on top of previous expectation and not on original object.
for expectation in reversed(expectations):
expectation._reset()
for expectation in expectations:
# Remove method type attributes set by flexmock. This needs to be done after
# resetting all the expectations because method type is needed in expectation teardown.
if inspect.isclass(mock_object) or hasattr(mock_object, "__class__"):
try:
delattr(mock_object._object, f"{expectation._name}__flexmock__method_type")
except (AttributeError, TypeError):
pass
for mock in saved:
obj = mock._object
if not isinstance(obj, Mock) and not inspect.isclass(obj):
instances.append(obj)
if inspect.isclass(obj):
classes.append(obj)
for obj in instances + classes:
for attr in UPDATED_ATTRS:
try:
obj_dict = obj.__dict__
if obj_dict[attr].__code__ is Mock.__dict__[attr].__code__:
del obj_dict[attr]
except Exception:
try:
if getattr(obj, attr).__code__ is Mock.__dict__[attr].__code__:
delattr(obj, attr)
except AttributeError:
pass
FlexmockContainer.teardown_properties()
FlexmockContainer.reset()
# make sure this is done last to keep exceptions here from breaking
# any of the previous steps that cleanup all the changes
for mock_object, expectations in saved.items():
for expectation in expectations:
expectation._verify()
class Expectation:
"""Holds expectations about methods.
The information contained in the Expectation object includes method name,
its argument list, return values, and any exceptions that the method might
raise.
"""
def __init__( # pylint: disable=too-many-positional-arguments
self,
mock: Mock,
name: str | None = None,
return_value: Any | None = None,
original: Any | None = None,
method_type: Any | None = None,
) -> None:
if original is not None:
self._original = original
self._name = name
self._times_called: int = 0
self._modifier: str = EXACTLY
self._args: dict[str, Any] | None = None
self._method_type = method_type
self._argspec: inspect.FullArgSpec | None = None
self._return_values = [ReturnValue(return_value)] if return_value is not None else []
self._replace_with: Callable[..., Any] | None = None
self._original_function: Callable[..., Any] | None = None
self._expected_calls: dict[str, int | None] = {
EXACTLY: None,
AT_LEAST: None,
AT_MOST: None,
}
self._runnable: Callable[..., bool] = lambda: True
self._mock = mock
self._pass_thru = False
self._ordered = False
self._one_by_one = False
self._verified = False
self._callable = True
self._local_override = False
# Remove in 1.0. Issue #96
self._called_deprecated_property = False
def __str__(self) -> str:
args = _format_args(str(self._name), self._args)
return_values = ", ".join(str(x) for x in self._return_values)
return f"{args} -> ({return_values})"
def __getattribute__(self, name: str) -> Any:
# Workaround to raise an error if once, twice, or never are called
# without parenthesis.
if name in ("once", "twice", "never", "mock"):
self._called_deprecated_property = True
return object.__getattribute__(self, name)
def _get_runnable(self) -> str:
"""Ugly hack to get the name of when() condition from the source code."""
name = "condition"
try:
source = inspect.getsource(self._runnable)
if "when(" in source:
name = source.split("when(")[1].split(")")[0]
elif "def " in source:
name = source.split("def ")[1].split("(")[0]
except Exception:
# couldn't get the source, oh well
pass
return name
def _verify_signature_match(self, *kargs: Any, **kwargs: Any) -> None:
if isinstance(self._mock, Mock):
return # no sense in enforcing this for fake objects
allowed = self._argspec
args_len = len(allowed.args)
# self is the first expected argument
has_self = allowed.args and allowed.args[0] == "self"
# Builtin methods take `self` as the first argument but `inspect.ismethod` returns False
# so we need to check for them explicitly
is_builtin_method = isinstance(self._original, BuiltinMethodType) and has_self
# Methods take `self` if not a staticmethod
is_method = inspect.ismethod(self._original) and self._method_type is not staticmethod
# Class init takes `self`
is_class = inspect.isclass(self._original)
# When calling class methods or instance methods on a class method takes `cls`
is_class_method = (
inspect.isfunction(self._original)
and inspect.isclass(self._mock)
and self._method_type is not staticmethod
)
if is_builtin_method or is_method or is_class or is_class_method:
# Do not count `self` or `cls`.
args_len -= 1
minimum = args_len - (allowed.defaults and len(allowed.defaults) or 0)
maximum = None
if allowed.varargs is None and allowed.varkw is None:
maximum = args_len
total_positional = len(kargs + tuple(a for a in kwargs if a in allowed.args))
named_optionals = [
a
for a in kwargs
if allowed.defaults
if a in allowed.args[len(allowed.args) - len(allowed.defaults) :]
]
if allowed.defaults and total_positional == minimum and named_optionals:
minimum += len(named_optionals)
if total_positional < minimum:
arguments = "argument" if minimum == 1 else "arguments"
raise MethodSignatureError(
f"{self._name} requires at least {minimum} {arguments}, "
f"expectation provided {total_positional}"
)
if maximum is not None and total_positional > maximum:
arguments = "argument" if maximum == 1 else "arguments"
raise MethodSignatureError(
f"{self._name} requires at most {maximum} {arguments}, "
f"expectation provided {total_positional}"
)
if args_len == len(kargs) and any(a for a in kwargs if a in allowed.args):
given_args = [a for a in kwargs if a in allowed.args]
arguments = "argument" if len(given_args) == 1 else "arguments"
raise MethodSignatureError(
f"{given_args} already given as positional {arguments} to {self._name}"
)
if not allowed.varkw and any(
a for a in kwargs if a not in allowed.args + allowed.kwonlyargs
):
invalid_arg = [a for a in kwargs if a not in allowed.args + allowed.kwonlyargs][0]
raise MethodSignatureError(
f"{invalid_arg} is not a valid keyword argument to {self._name}"
)
# check that kwonlyargs that don't have default value specified are provided
required_kwonlyargs = [
a for a in allowed.kwonlyargs if a not in (allowed.kwonlydefaults or {})
]
missing_kwonlyargs = [a for a in required_kwonlyargs if a not in kwargs]
if missing_kwonlyargs:
arguments = "argument" if len(missing_kwonlyargs) == 1 else "arguments"
missing_args = '", "'.join(missing_kwonlyargs)
raise MethodSignatureError(
f'{self._name} requires keyword-only {arguments} "{missing_args}"'
)
def _update_original(self, name: str, obj: Any) -> None:
if hasattr(obj, "__dict__") and name in obj.__dict__:
self._original = obj.__dict__[name]
else:
self._original = getattr(obj, name)
self._update_argspec()
def _update_argspec(self) -> None:
original = self.__dict__.get("_original")
if original:
try:
self._argspec = inspect.getfullargspec(original)
except TypeError:
# built-in function: fall back to stupid processing and hope the
# builtins don't change signature
pass
def _normalize_named_args(self, *kargs: Any, **kwargs: Any) -> dict[str, Any]:
argspec = self._argspec
default = {"kargs": kargs, "kwargs": kwargs}
if not argspec:
return default
ret: dict[str, Any] = {"kargs": (), "kwargs": kwargs}
if inspect.ismethod(self._original):
args = argspec.args[1:]
else:
args = argspec.args
for i, arg in enumerate(kargs):
if len(args) <= i:
return default
ret["kwargs"][args[i]] = arg
return ret
def __raise(self, exception: type[BaseException], message: str) -> NoReturn:
"""Safe internal raise implementation.
In case we're patching builtins, it's important to reset the
expectation before raising any exceptions or else things like
open() might be stubbed out and the resulting runner errors are very
difficult to diagnose.
"""
self._reset()
raise exception(message)
def _match_args(self, given_args: Any) -> bool:
"""Check if the set of given arguments matches this expectation."""
expected_args = self._args
given_args = self._normalize_named_args(*given_args["kargs"], **given_args["kwargs"])
if expected_args == given_args or expected_args is None:
return True
if (
len(given_args["kargs"]) != len(expected_args["kargs"])
or len(given_args["kwargs"]) != len(expected_args["kwargs"])
or (sorted(given_args["kwargs"].keys()) != sorted(expected_args["kwargs"].keys()))
):
return False
for i, arg in enumerate(given_args["kargs"]):
if not _arguments_match(arg, expected_args["kargs"][i]):
return False
for key, value in given_args["kwargs"].items():
if not _arguments_match(value, expected_args["kwargs"][key]):
return False
return True
def mock(self) -> Mock:
"""Return the mock associated with this expectation.
Returns:
Mock associated with this expectation.
Examples:
>>> plane = flexmock(plane).should_receive("fly").mock()
"""
self._called_deprecated_property = False
return self._mock
def with_args(self, *args: Any, **kwargs: Any) -> "Expectation":
"""Override the arguments used to match this expectation's method.
Args:
*args: Positional arguments.
**kwargs: Keyword arguments.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
Match calls with no arguments:
>>> flexmock(plane).should_receive("fly").with_args()
Match a single argument:
>>> flexmock(plane).should_receive("fly").with_args("east")
Match keyword arguments:
>>> flexmock(plane).should_receive("fly").with_args("up", destination="Oslo")
Match argument type:
>>> flexmock(plane).should_receive("fly").with_args(str)
Match a string using a compiled regular expression:
>>> regex = re.compile("^(up|down)$")
>>> flexmock(plane).should_receive("fly").with_args(regex)
"""
if not self._callable:
self.__raise(FlexmockError, "can't use with_args() with attribute stubs")
self._update_argspec()
if self._argspec:
# do this outside try block as TypeError is way too general and catches
# unrelated errors in the verify signature code
self._verify_signature_match(*args, **kwargs)
self._args = self._normalize_named_args(*args, **kwargs)
else:
self._args = {"kargs": args, "kwargs": kwargs}
return self
def and_return(self, *values: Any) -> "Expectation":
"""Override the return value of this expectation's method.
When `and_return` is given multiple times, each value provided is returned
on successive invocations of the method. It is also possible to mix
`and_return` with `and_raise` in the same manner to alternate between returning
a value and raising and exception on different method invocations.
When combined with the `one_by_one` modifier, value is treated as a list of
values to be returned in the order specified by successive calls to this
method rather than a single list to be returned each time.
Args:
*values: Optional list of return values, defaults to `None` if not given.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
Provide return values for mocks:
>>> flexmock(plane).should_receive("land").and_return("landed!").once()
>>> plane.land()
'landed!'
Match specific return values with spies:
>>> flexmock(plane).should_call("passenger_count").and_return(3)
>>> plane.passenger_count()
3
"""
if not values:
value = None
elif len(values) == 1:
value = values[0]
else:
value = values
if not self._callable:
_setattr(self._mock, str(self._name), value)
return self
return_values = self._return_values
if not self._one_by_one:
value = ReturnValue(value)
return_values.append(value)
else:
try:
return_values.extend([ReturnValue(v) for v in value]) # type: ignore
except TypeError:
return_values.append(ReturnValue(value))
return self
def times(self, number: int) -> "Expectation":
"""Number of times this expectation's method is expected to be called.
There are also 3 aliases for the `times()` method:
- `once()` -> `times(1)`
- `twice()` -> `times(2)`
- `never()` -> `times(0)`
Args:
number: Expected call count.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("fly").times(1)
>>> plane.fly()
>>> flexmock(plane).should_call("land").times(2)
>>> plane.land()
>>> plane.land()
"""
if not self._callable:
self.__raise(FlexmockError, "can't use times() with attribute stubs")
expected_calls = self._expected_calls
modifier = self._modifier
expected_calls[modifier] = number
return self
def once(self) -> "Expectation":
"""Expect expectation's method to be called once.
Alias for `times(1)`.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("land").once()
>>> plane.land()
"""
self._called_deprecated_property = False
return self.times(1)
def twice(self) -> "Expectation":
"""Expect expectation's method to be called twice.
Alias for `times(2)`.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("fly").twice()
>>> plane.fly()
>>> plane.fly()
"""
self._called_deprecated_property = False
return self.times(2)
def never(self) -> "Expectation":
"""Expect expectation's method to never be called.
Alias for `times(0)`.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("crash").never()
>>> plane.crash()
Traceback (most recent call last):
...
flexmock.exceptions.MethodCallError: crash() expected to be called...
"""
self._called_deprecated_property = False
return self.times(0)
def one_by_one(self) -> "Expectation":
"""Modifies the return value to be treated as a list of return values.
Each value in the list is returned on successive invocations of the method.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("pilot").and_return("pilot1", "pilot2").one_by_one()
>>> plane.pilot()
'pilot1'
>>> plane.pilot()
'pilot2'
"""
if not self._callable:
self.__raise(FlexmockError, "can't use one_by_one() with attribute stubs")
if not self._one_by_one:
self._one_by_one = True
return_values = self._return_values
saved_values = return_values[:]
self._return_values = return_values = []
for value in saved_values:
try:
for val in value.value: # type: ignore
return_values.append(ReturnValue(val))
except TypeError:
return_values.append(value)
return self
def at_least(self) -> "Expectation":
"""Modifies the associated `times()` expectation.
When given, an exception will only be raised if the method is called less
than `times()` specified. Does nothing if `times()` is not given.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("fly").at_least().once()
>>> plane.fly("east")
"""
if not self._callable:
self.__raise(FlexmockError, "can't use at_least() with attribute stubs")
expected_calls = self._expected_calls
modifier = self._modifier
if expected_calls[AT_LEAST] is not None or modifier == AT_LEAST:
self.__raise(FlexmockError, "cannot use at_least modifier twice")
if modifier == AT_MOST and expected_calls[AT_MOST] is None:
self.__raise(FlexmockError, "cannot use at_least with at_most unset")
self._modifier = AT_LEAST
return self
def at_most(self) -> "Expectation":
"""Modifies the associated `times()` expectation.
When given, an exception will only be raised if the method is called more
than `times()` specified. Does nothing if `times()` is not given.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("land").at_most().once()
>>> plane.land()
>>> plane.land()
Traceback (most recent call last):
...
flexmock.exceptions.MethodCallError: land() expected to be called at most...
"""
if not self._callable:
self.__raise(FlexmockError, "can't use at_most() with attribute stubs")
expected_calls = self._expected_calls
modifier = self._modifier
if expected_calls[AT_MOST] is not None or modifier == AT_MOST:
self.__raise(FlexmockError, "cannot use at_most modifier twice")
if modifier == AT_LEAST and expected_calls[AT_LEAST] is None:
self.__raise(FlexmockError, "cannot use at_most with at_least unset")
self._modifier = AT_MOST
return self
def ordered(self) -> "Expectation":
"""Makes the expectation respect the order of `should_receive` statements.
An exception will be raised if methods are called out of order, determined
by order of `should_receive` calls in the test.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("fly").with_args("east").ordered()
>>> flexmock(plane).should_receive("fly").with_args("west").ordered()
>>> plane.fly("west")
Traceback (most recent call last):
...
flexmock.exceptions.CallOrderError: fly("west") called before...
"""
if not self._callable:
self.__raise(FlexmockError, "can't use ordered() with attribute stubs")
self._ordered = True
FlexmockContainer.ordered.append(self)
return self
def when(self, func: Callable[..., Any]) -> "Expectation":
"""Sets an outside resource to be checked when asserting if a method
should be called.
Args:
func: Function that indicates if the mocked or spied method should
have been called.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("land").when(lambda: plane.is_flying)
>>> plane.is_flying
True
>>> plane.land()
>>> plane.is_flying = False
>>> plane.land()
Traceback (most recent call last):
...
flexmock.exceptions.StateError: land expected to be called when...
"""
if not self._callable:
self.__raise(FlexmockError, "can't use when() with attribute stubs")
if not hasattr(func, "__call__"):
self.__raise(FlexmockError, "when() parameter must be callable")
self._runnable = func
return self
def and_raise(
self, exception: type[BaseException] | BaseException, *args: Any, **kwargs: Any
) -> "Expectation":
"""Specifies the exception to be raised when this expectation is met.
Args:
exception: Exception class.
*args: Positional arguments to pass to the exception.
**kwargs: Keyword arguments to pass to the exception.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
Make a mocked method raise an exception instead of returning a value:
>>> flexmock(plane).should_receive("fly").and_raise(BadWeatherException)
>>> plane.fly()
Traceback (most recent call last):
...
BadWeatherException
Make a spy to verify that a specific exception is raised:
>>> flexmock(plane).should_call("repair").and_raise(RuntimeError, "err msg")
"""
if not self._callable:
self.__raise(FlexmockError, "can't use and_raise() with attribute stubs")
if inspect.isclass(exception):
try:
exception(*args, **kwargs)
except TypeError:
self.__raise(
FlexmockError, f"can't initialize {exception} with the given arguments"
)
kargs = {"kargs": args, "kwargs": kwargs}
return_values = self._return_values
return_values.append(ReturnValue(raises=exception, value=kargs))
return self
def replace_with(self, function: Callable[..., Any]) -> "Expectation":
"""Gives a function to run instead of the mocked out one.
Args:
function: A callable that is used to replace the original function.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("set_speed").replace_with(lambda x: x == 5)
>>> plane.set_speed(5)
True
>>> plane.set_speed(4)
False
"""
if not self._callable:
self.__raise(FlexmockError, "can't use replace_with() with attribute/property stubs")
replace_with = self._replace_with
original = self.__dict__.get("_original")
if replace_with:
self.__raise(FlexmockError, "replace_with cannot be specified twice")
if function == original:
self._pass_thru = True
self._replace_with = function
return self
def and_yield(self, *args: Any) -> "Expectation":
"""Specifies the list of items to be yielded on successive method calls.
In effect, the mocked object becomes a generator.
Args:
*args: Items to be yielded on successive method calls.
Returns:
Self, i.e. can be chained with other Expectation methods.
Examples:
>>> flexmock(plane).should_receive("flight_log").and_yield("fly", "land")
>>> log = plane.flight_log()
>>> next(log)
'fly'
>>> next(log)
'land'
"""
if not self._callable:
self.__raise(FlexmockError, "can't use and_yield() with attribute stubs")
return self.and_return(iter(args))
def _verify(self, final: bool = True) -> None:
"""Verify that this expectation has been met.
Args:
final: True if no further calls to this method expected
(skip checking at_least expectations when False).
Raises:
MethodCallError Exception
"""
failed, message = self._verify_number_of_calls(final)
if failed and not self._verified:
self._verified = True
self.__raise(
MethodCallError,
(
f"{_format_args(str(self._name), self._args)} expected to be called "
f"{message}, called {self._times_called} "
f"{'time' if self._times_called == 1 else 'times'}"
),
)
def _verify_number_of_calls(self, final: bool) -> tuple[bool, str]:
if self._called_deprecated_property:
raise FlexmockError(
"Calling once, twice, never, or mock without parentheses has been deprecated"
)
failed = False
message = ""
called_exactly = self._expected_calls[EXACTLY]
called_at_least = self._expected_calls[AT_LEAST]
called_at_most = self._expected_calls[AT_MOST]
times_called = self._times_called
if called_exactly is not None:
message = f"exactly {called_exactly}"
if final:
if times_called != called_exactly:
failed = True
else:
if times_called > called_exactly:
failed = True
message += " time" if called_exactly == 1 else " times"
else:
if final and called_at_least is not None:
message = f"at least {called_at_least}"
if times_called < called_at_least:
failed = True
message += " time" if called_at_least == 1 else " times"
if called_at_most is not None:
if message:
message += " and "
message += f"at most {called_at_most}"
if times_called > called_at_most:
failed = True
message += " time" if called_at_most == 1 else " times"
return failed, message
def _reset(self) -> None:
"""Returns the methods overridden by this expectation to their originals."""
_mock = self._mock
if not isinstance(_mock, Mock):
original = self.__dict__.get("_original")
if original:
# name may be unicode but pypy demands dict keys to be str
name = str(self._name)
if hasattr(_mock, "__dict__") and name in _mock.__dict__ and self._local_override:
delattr(_mock, name)
elif (
hasattr(_mock, "__dict__")
and name in _mock.__dict__
and isinstance(_mock.__dict__, dict)
):
_mock.__dict__[name] = original
else:
setattr(_mock, name, original)
del self
class FlexmockContainer:
"""Holds global hash of object/expectation mappings."""
flexmock_objects: dict[Mock, list[Expectation]] = {}
properties: dict[Any, list[str]] = {}
ordered: list[Expectation] = []
last: Expectation | None = None
@classmethod
def reset(cls) -> None:
"""Reset flexmock state."""
cls.ordered = []
cls.last = None
cls.flexmock_objects = {}
cls.properties = {}
@classmethod
def get_flexmock_expectation(
cls, obj: Mock, name: str, args: Any | None = None
) -> Expectation | None:
"""Retrieves an existing matching expectation."""
if args is None:
args = {"kargs": (), "kwargs": {}}
if not isinstance(args, dict):
args = {"kargs": args, "kwargs": {}}
if not isinstance(args["kargs"], tuple):
args["kargs"] = (args["kargs"],)
found = None
for expectation in reversed(cls.flexmock_objects[obj]):
if expectation._name == name and expectation._match_args(args):
if expectation in cls.ordered or not expectation._ordered and not found:
found = expectation
if found and found._ordered:
cls._verify_call_order(found, args)
return found
@classmethod
def _verify_call_order(cls, expectation: Expectation, args: dict[str, Any]) -> None:
next_method = cls.ordered.pop(0)
cls.last = next_method
if expectation is not next_method:
raise CallOrderError(
f"{_format_args(str(expectation._name), args)} called before "
f"{_format_args(str(next_method._name), next_method._args)}"
)
@classmethod
def add_expectation(cls, obj: Mock, expectation: Expectation) -> None:
"""Add expectation."""
if obj in cls.flexmock_objects:
cls.flexmock_objects[obj].append(expectation)
else:
cls.flexmock_objects[obj] = [expectation]
@classmethod
def get_expectations_with_name(cls, obj: Mock, name: str) -> list[Expectation]:
"""Get all expectations for given name."""
return [x for x in FlexmockContainer.flexmock_objects.get(obj, []) if x._name == name]
@classmethod
def add_teardown_property(cls, obj: Any, name: str) -> None:
"""Add teardown property."""
if obj in cls.properties:
cls.properties[obj].append(name)
else:
cls.properties[obj] = [name]
@classmethod
def teardown_properties(cls) -> None:
"""Teardown properties."""
for obj, names in cls.properties.items():
for name in names:
delattr(obj, name)
def flexmock(spec: Any | None = None, **kwargs: Any) -> Mock:
"""Main entry point into the flexmock API.
This function is used to either generate a new fake object or take
an existing object (or class or module) and use it as a basis for
a partial mock. In case of a partial mock, the passed in object
is modified to support basic Mock class functionality making
it unnecessary to make successive `flexmock()` calls on the same
objects to generate new expectations.
It is safe to call `flexmock()` on the same object again, flexmock will
detect when an object has already been partially mocked and return it each
time.
Args:
spec: Object, class, or module to mock.
**kwargs: Method or return value pairs to attach to the object.
Returns:
Mock object if no spec is provided. Otherwise return the spec object.
Examples:
>>> mock = flexmock(Plane)
>>> mock.should_receive("fly")
"""
if spec is not None:
return _create_partial_mock(spec, **kwargs)
# use this intermediate class to attach properties
klass = type("MockClass", (Mock,), {})
return klass(**kwargs) # type: ignore
def _arg_to_str(arg: Any) -> str:
if isinstance(arg, re.Pattern):
return f"/{arg.pattern}/"
if isinstance(arg, str):
return f'"{arg}"'
return f"{arg}"
def _format_args(name: str, arguments: dict[str, Any] | None) -> str:
if arguments is None:
arguments = {"kargs": (), "kwargs": {}}
kargs = ", ".join(_arg_to_str(arg) for arg in arguments["kargs"])
kwargs = ", ".join(f"{k}={_arg_to_str(v)}" for k, v in arguments["kwargs"].items())
if kargs and kwargs:
args = f"{kargs}, {kwargs}"
else:
args = f"{kargs}{kwargs}"
return f"{name}({args})"
def _create_partial_mock(obj_or_class: Any, **kwargs: Any) -> Mock:
"""Create partial mock."""
matches = [x for x in FlexmockContainer.flexmock_objects if x._object is obj_or_class]
if matches:
mock = matches[0]
else:
mock = Mock()
mock._object = obj_or_class
for name, return_value in kwargs.items():
if hasattr(return_value, "__call__"):
mock.should_receive(name).replace_with(return_value)
else:
mock.should_receive(name).and_return(return_value)
if not matches:
FlexmockContainer.add_expectation(mock, Expectation(obj_or_class))
if _attach_flexmock_methods(mock, Mock, obj_or_class) and not inspect.isclass(mock._object):
mock = mock._object
return mock
def _attach_flexmock_methods(mock: Mock, flexmock_class: type[Mock], obj: Any) -> bool:
try:
for attr in UPDATED_ATTRS:
if hasattr(obj, attr):
if getattr(obj, attr).__code__ is not getattr(flexmock_class, attr).__code__:
return False
for attr in UPDATED_ATTRS:
_setattr(obj, attr, getattr(mock, attr))
except TypeError as exc:
raise MockBuiltinError(
"Python does not allow you to mock builtin objects or modules. "
"Consider wrapping it in a class you can mock instead"
) from exc
except AttributeError as exc:
raise MockBuiltinError(
"Python does not allow you to mock instances of builtin objects. "
"Consider wrapping it in a class you can mock instead"
) from exc
return True
def _arguments_match(arg: Any, expected_arg: Any) -> bool:
if expected_arg == arg:
return True
if inspect.isclass(expected_arg) and isinstance(arg, expected_arg):
return True
if isinstance(expected_arg, re.Pattern) and expected_arg.search(arg):
return True
return False
def _setattr(obj: Any, name: str, value: Any) -> bool:
"""Ensure we use local __dict__ where possible."""
local_override = False
if hasattr(obj, "__dict__") and isinstance(obj.__dict__, dict):
if name not in obj.__dict__:
# Overriding attribute locally on an instance.
local_override = True
obj.__dict__[name] = value
else:
if inspect.isclass(obj) and not vars(obj).get(name):
# Overriding derived attribute locally on a child class.
local_override = True
setattr(obj, name, value)
return local_override
def _isproperty(obj: Any, name: str) -> bool:
if isinstance(obj, Mock):
return False
if not inspect.isclass(obj) and hasattr(obj, "__dict__") and name not in obj.__dict__:
attr = getattr(obj.__class__, name)
if isinstance(attr, property):
return True
elif inspect.isclass(obj):
attr = getattr(obj, name)
if isinstance(attr, property):
return True
return False
def _is_class_method(method: Callable[..., Any], name: str) -> bool:
"""Check if a method is a classmethod.
This function checks all the classes in the class method resolution in order
to get the correct result for derived methods as well.
"""
bound_to = getattr(method, "__self__", None)
if not inspect.isclass(bound_to):
return False
for cls in inspect.getmro(bound_to):
descriptor = vars(cls).get(name)
if descriptor is not None:
return isinstance(descriptor, classmethod)
return False
def _is_static_method(obj: Any, name: str) -> bool:
try:
return isinstance(inspect.getattr_static(obj, name), staticmethod)
except AttributeError:
# AttributeError is raised when mocking a proxied object
if hasattr(obj, "__mro__"):
for cls in inspect.getmro(obj):
descriptor = vars(cls).get(name)
if descriptor is not None:
return isinstance(descriptor, staticmethod)
return False
flexmock-0.13.0/src/flexmock/_integrations.py 0000664 0000000 0000000 00000013561 15130526717 0021236 0 ustar 00root root 0000000 0000000 """Flexmock test runner integrations."""
# pylint: disable=import-outside-toplevel, import-error
import sys
import unittest
from contextlib import suppress
from functools import wraps
from typing import Any
from flexmock._api import flexmock_teardown
def _patch_test_result(klass: type[Any]) -> None:
"""Patches flexmock into any class that inherits unittest.TestResult.
This seems to work well for majority of test runners. In the case of nose
it's not even necessary as it doesn't override unittest.TestResults's
addSuccess and addFailure methods so simply patching unittest works
out of the box for nose.
For those that do inherit from unittest.TestResult and override its
stopTest and addSuccess methods, patching is pretty straightforward
(numerous examples below).
The reason we don't simply patch unittest's parent TestResult class
is stopTest and addSuccess in the child classes tend to add messages
into the output that we want to override in case flexmock generates
its own failures.
Args:
klass: the class whose stopTest method needs to be decorated.
"""
# pylint: disable=invalid-name
_patch_stop_test(klass)
_patch_add_success(klass)
def _patch_stop_test(klass: type[unittest.TextTestResult]) -> None:
"""Patch TextTestResult class stopTest method and add call to flexmock
teardown.
If the test failed already before flexmock teardown, nothing is done.
However if the test was successful before flexmock teardown and flexmock
assertions fail, flexmock updates the test result to failed by calling
addFailure method.
Args:
klass: the class whose stopTest method needs to be decorated.
"""
saved_add_success = klass.addSuccess
saved_stop_test = klass.stopTest
@wraps(saved_stop_test)
def decorated(self: unittest.TextTestResult, test: unittest.TestCase) -> None:
if saved_stop_test.__code__ is not decorated.__code__: # type: ignore [attr-defined]
# if parent class was for some reason patched, avoid calling
# flexmock_teardown() twice and delegate up the class hierarchy
# this doesn't help if there is a gap and only the parent's
# parent class was patched, but should cover most screw-ups
try:
flexmock_teardown()
saved_add_success(self, test)
except Exception:
if hasattr(self, "_pre_flexmock_success"):
self.addFailure(test, sys.exc_info())
if hasattr(self, "_pre_flexmock_success"):
del self._pre_flexmock_success
return saved_stop_test(self, test)
if klass.stopTest is not decorated:
klass.stopTest = decorated # type: ignore
def _patch_add_success(klass: type[unittest.TextTestResult]) -> None:
"""Patch the addSuccess method of the TextTestResult class.
TextTestResult addSuccess method is replaced and the original addSuccess
method is called after flexmock teardown patched stopTest method.
An attribute is set in the replaced addSuccess method to indicate if the
test was successful before flexmock teardown was called.
Args:
klass: the class whose addSuccess method needs to be decorated.
"""
@wraps(klass.addSuccess)
def decorated(self: unittest.TextTestResult, _test: unittest.TestCase, **_kwargs: Any) -> None:
self._pre_flexmock_success = True # type: ignore
if klass.addSuccess is not decorated:
klass.addSuccess = decorated # type: ignore
# Hook flexmock into doctest.
with suppress(ImportError):
from doctest import DocTestRunner, TestResults
saved_doctest = DocTestRunner.run
@wraps(saved_doctest)
def run(
*args: Any,
**kwargs: Any,
) -> TestResults:
"""Call the teardown at the end of the tests.
Args:
args: the arguments passed to the runner
kwargs: the keyword arguments passed to the runner
Returns:
The test results
"""
try:
return saved_doctest(*args, **kwargs)
finally:
flexmock_teardown()
DocTestRunner.run = run # type: ignore
# Hook flexmock into unittest.
# only valid TestResult class for unittest is TextTestResult
_patch_test_result(unittest.TextTestResult)
# Hook into Teamcity unittests.
# This allows flexmock to be used within PyCharm.
with suppress(ImportError):
from teamcity.unittestpy import TeamcityTestResult
_patch_test_result(TeamcityTestResult)
# Hook into teststools.
# testtools is a set of extensions to the Python standard library's unit testing framework:
# https://github.com/testing-cabal/testtools
with suppress(ImportError):
from testtools import testresult
_patch_test_result(testresult.TestResult)
# Hook into Zope testrunner.
# Zope is an open-source web application server:
# https://github.com/zopefoundation/Zope
with suppress(ImportError):
from zope import testrunner # pylint: disable=no-name-in-module
try:
_patch_test_result(testrunner.runner.TestResult)
except AttributeError:
# testrunner.runner is only available when tests are executed with zope.testrunner
pass
# Hook into subunit.
# Subunit is a test reporting and controlling protocol.
# https://github.com/testing-cabal/subunit
with suppress(ImportError):
import subunit
_patch_test_result(subunit.TestProtocolClient)
with suppress(AttributeError):
_patch_test_result(subunit.test_results.TestResultDecorator)
# Hook into twisted.
# Twisted is an event-based framework for internet applications:
# https://github.com/twisted/twisted
with suppress(ImportError):
from twisted.trial import reporter
_patch_test_result(reporter.MinimalReporter)
_patch_test_result(reporter.TextReporter)
_patch_test_result(reporter.VerboseTextReporter)
_patch_test_result(reporter.TreeReporter)
flexmock-0.13.0/src/flexmock/_pytest_plugin.py 0000664 0000000 0000000 00000001766 15130526717 0021442 0 ustar 00root root 0000000 0000000 """Hook flexmock into Pytest.
Pytest is a Python test framework:
https://github.com/pytest-dev/pytest
"""
from collections.abc import Generator
import pytest
from _pytest.runner import CallInfo, ExceptionInfo, Item, TestReport
from flexmock._api import flexmock_teardown
@pytest.hookimpl(hookwrapper=True)
def pytest_runtest_makereport(
item: Item, # pylint: disable=unused-argument
call: CallInfo[None],
) -> Generator[None]:
"""Called to verify and tear down the mocks set up by flexmock.
Args:
item: Test item for which the hook is being called.
call: Information about the current call phase.
Yields:
Control back to the pytest runner.
"""
if call.when == "call":
try:
flexmock_teardown()
except BaseException: # pylint: disable=broad-except
call.excinfo = call.excinfo or ExceptionInfo.from_current()
elif call.when == "teardown":
flexmock_teardown()
_test_report: TestReport | None = yield
flexmock-0.13.0/src/flexmock/exceptions.py 0000664 0000000 0000000 00000001063 15130526717 0020544 0 ustar 00root root 0000000 0000000 """Flexmock exceptions."""
class FlexmockError(Exception):
"""FlexmockError"""
class MockBuiltinError(Exception):
"""MockBuiltinError"""
class MethodSignatureError(FlexmockError):
"""MethodSignatureError"""
class ExceptionClassError(FlexmockError):
"""ExceptionClassError"""
class ExceptionMessageError(FlexmockError):
"""ExceptionMessageError"""
class StateError(FlexmockError):
"""StateError"""
class MethodCallError(FlexmockError):
"""MethodCallError"""
class CallOrderError(FlexmockError):
"""CallOrderError"""
flexmock-0.13.0/src/flexmock/py.typed 0000664 0000000 0000000 00000000000 15130526717 0017476 0 ustar 00root root 0000000 0000000 flexmock-0.13.0/tests/ 0000775 0000000 0000000 00000000000 15130526717 0014554 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/tests/__init__.py 0000664 0000000 0000000 00000000000 15130526717 0016653 0 ustar 00root root 0000000 0000000 flexmock-0.13.0/tests/features/ 0000775 0000000 0000000 00000000000 15130526717 0016372 5 ustar 00root root 0000000 0000000 flexmock-0.13.0/tests/features/__init__.py 0000664 0000000 0000000 00000001634 15130526717 0020507 0 ustar 00root root 0000000 0000000 """Tests for flexmock.
Tests under this module should not depend on any test runner.
"""
from .arg_matching import ArgumentMatchingTestCase
from .call_count import CallCountTestCase
from .common import CommonTestCase
from .conditional import ConditionalAssertionsTestCase
from .derived import DerivedTestCase
from .mocking import MockingTestCase
from .ordered import OrderedTestCase
from .proxied import ProxiedTestCase
from .spying import SpyingTestCase
from .stubbing import StubbingTestCase
from .teardown import TeardownTestCase
class FlexmockTestCase(
ArgumentMatchingTestCase,
CallCountTestCase,
CommonTestCase,
ConditionalAssertionsTestCase,
DerivedTestCase,
MockingTestCase,
OrderedTestCase,
ProxiedTestCase,
SpyingTestCase,
StubbingTestCase,
TeardownTestCase,
):
"""This class should be imported by other test modules to run full flexmock
test suite.
"""
flexmock-0.13.0/tests/features/arg_matching.py 0000664 0000000 0000000 00000025235 15130526717 0021376 0 ustar 00root root 0000000 0000000 """Tests for argument matching."""
# pylint: disable=missing-docstring,no-member
import re
from flexmock import exceptions, flexmock
from flexmock._api import flexmock_teardown
from tests import some_module
from tests.some_module import SomeClass
from tests.utils import assert_raises
class ArgumentMatchingTestCase:
def test_arg_matching_works_with_regexp(self):
class Foo:
def method(self, arg1, arg2):
pass
instance = Foo()
flexmock(instance).should_receive("method").with_args(
re.compile("^arg1.*asdf$"), arg2=re.compile("f")
).and_return("mocked")
assert instance.method("arg1somejunkasdf", arg2="aadsfdas") == "mocked"
def test_arg_matching_with_regexp_fails_when_regexp_doesnt_match_karg(self):
class Foo:
def method(self, arg1, arg2):
pass
instance = Foo()
flexmock(instance).should_receive("method").with_args(
re.compile("^arg1.*asdf$"), arg2=re.compile("a")
).and_return("mocked")
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method did not match expectations:\n"
' Received call:\tmethod("arg1somejunkasdfa", arg2="a")\n'
" Expected call[1]:\tmethod(arg2=/a/, arg1=/^arg1.*asdf$/)"
),
):
instance.method("arg1somejunkasdfa", arg2="a")
def test_arg_matching_with_regexp_fails_when_regexp_doesnt_match_kwarg(self):
class Foo:
def method(self, arg1, arg2):
pass
instance = Foo()
flexmock(instance).should_receive("method").with_args(
re.compile("^arg1.*asdf$"), arg2=re.compile("a")
).and_return("mocked")
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method did not match expectations:\n"
' Received call:\tmethod("arg1somejunkasdf", arg2="b")\n'
" Expected call[1]:\tmethod(arg2=/a/, arg1=/^arg1.*asdf$/)"
),
):
instance.method("arg1somejunkasdf", arg2="b")
def test_module_level_function_with_kwargs(self):
flexmock(some_module).should_receive("module_function").with_args(1, y="expected")
with assert_raises(
exceptions.FlexmockError,
(
"Arguments for call module_function did not match expectations:\n"
' Received call:\tmodule_function(1, y="not expected")\n'
' Expected call[1]:\tmodule_function(y="expected", x=1)'
),
):
some_module.module_function(1, y="not expected")
def test_flexmock_should_match_types_on_multiple_arguments(self):
class Foo:
def method(self, arg1, arg2):
pass
instance = Foo()
flexmock(instance).should_receive("method").with_args(str, int).and_return("ok")
assert instance.method("some string", 12) == "ok"
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method did not match expectations:\n"
" Received call:\tmethod(12, 32)\n"
" Expected call[1]:\tmethod(arg1=, arg2=)"
),
):
instance.method(12, 32)
flexmock(instance).should_receive("method").with_args(str, int).and_return("ok")
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method did not match expectations:\n"
' Received call:\tmethod(12, "some string")\n'
" Expected call[1]:\tmethod(arg1=, arg2=)\n"
" Expected call[2]:\tmethod(arg1=, arg2=)"
),
):
instance.method(12, "some string")
flexmock(instance).should_receive("method").with_args(str, int).and_return("ok")
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method did not match expectations:\n"
' Received call:\tmethod("string", 12, 14)\n'
" Expected call[1]:\tmethod(arg1=, arg2=)\n"
" Expected call[2]:\tmethod(arg1=, arg2=)\n"
" Expected call[3]:\tmethod(arg1=, arg2=)"
),
):
instance.method("string", 12, 14)
def test_flexmock_should_match_types_on_multiple_arguments_generic(self):
class Foo:
def method(self, a, b, c): # pylint: disable=invalid-name
pass
instance = Foo()
flexmock(instance).should_receive("method").with_args(object, object, object).and_return(
"ok"
)
assert instance.method("some string", None, 12) == "ok"
assert instance.method((1,), None, 12) == "ok"
assert instance.method(12, 14, []) == "ok"
assert instance.method("some string", "another one", False) == "ok"
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method did not match expectations:\n"
' Received call:\tmethod("string", 12)\n'
" Expected call[1]:\tmethod(a=, "
"b=, c=)"
),
):
instance.method("string", 12) # pylint: disable=no-value-for-parameter
flexmock_teardown()
flexmock(instance).should_receive("method").with_args(object, object, object).and_return(
"ok"
)
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method did not match expectations:\n"
' Received call:\tmethod("string", 12, 13, 14)\n'
" Expected call[1]:\tmethod(a=, "
"b=, c=)"
),
):
instance.method("string", 12, 13, 14)
def test_flexmock_should_match_types_on_multiple_arguments_classes(self):
class Foo:
def method(self, a, b): # pylint: disable=invalid-name
pass
class Bar:
pass
foo_instance = Foo()
bar_instance = Bar()
flexmock(foo_instance).should_receive("method").with_args(object, Bar).and_return("ok")
assert foo_instance.method("some string", bar_instance) == "ok"
with assert_raises(
exceptions.MethodSignatureError,
re.compile(
"Arguments for call method did not match expectations:\n"
r' Received call:\tmethod\(.+\.\.Bar object at 0x.+>, "some string"\)\n'
r" Expected call\[1\]:\tmethod\(a=, b=\.Bar'>\)"
),
):
foo_instance.method(bar_instance, "some string")
flexmock_teardown()
flexmock(foo_instance).should_receive("method").with_args(object, Bar).and_return("ok")
with assert_raises(
exceptions.MethodSignatureError,
re.compile(
"Arguments for call method did not match expectations:\n"
r' Received call:\tmethod\(12, "some string"\)\n'
r" Expected call\[1\]:\tmethod\(a=, b=\.Bar'>\)"
),
):
foo_instance.method(12, "some string")
def test_flexmock_should_match_keyword_arguments(self):
class Foo:
def method(self, arg1, **kwargs):
pass
instance = Foo()
flexmock(instance).should_receive("method").with_args(1, arg3=3, arg2=2).twice()
instance.method(1, arg2=2, arg3=3)
instance.method(1, arg3=3, arg2=2)
flexmock_teardown()
flexmock(instance).should_receive("method").with_args(1, arg3=3, arg2=2)
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method did not match expectations:\n"
" Received call:\tmethod(arg2=2, arg3=3)\n"
" Expected call[1]:\tmethod(arg3=3, arg2=2, arg1=1)"
),
):
instance.method(arg2=2, arg3=3) # pylint: disable=no-value-for-parameter
flexmock_teardown()
flexmock(instance).should_receive("method").with_args(1, arg3=3, arg2=2)
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method did not match expectations:\n"
" Received call:\tmethod(1, arg2=2, arg3=4)\n"
" Expected call[1]:\tmethod(arg3=3, arg2=2, arg1=1)"
),
):
instance.method(1, arg2=2, arg3=4)
flexmock_teardown()
flexmock(instance).should_receive("method").with_args(1, arg3=3, arg2=2)
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method did not match expectations:\n"
" Received call:\tmethod(1)\n"
" Expected call[1]:\tmethod(arg3=3, arg2=2, arg1=1)"
),
):
instance.method(1)
def test_flexmock_should_call_should_match_keyword_arguments(self):
class Foo:
def method(self, arg1, arg2=None, arg3=None):
return f"{arg1}{arg2}{arg3}"
instance = Foo()
flexmock(instance).should_call("method").with_args(1, arg3=3, arg2=2).once()
assert instance.method(1, arg2=2, arg3=3) == "123"
def test_with_args_with_instance_method(self):
flexmock(SomeClass).should_receive("instance_method_with_args").with_args("red").once()
flexmock(SomeClass).should_receive("instance_method_with_args").with_args("blue").once()
instance = SomeClass()
instance.instance_method_with_args("red")
instance.instance_method_with_args("blue")
def test_with_args_with_class_method(self):
flexmock(SomeClass).should_receive("class_method_with_args").with_args("red").once()
flexmock(SomeClass).should_receive("class_method_with_args").with_args("blue").once()
SomeClass.class_method_with_args("red")
SomeClass.class_method_with_args("blue")
def test_with_args_with_static_method(self):
flexmock(SomeClass).should_receive("static_method_with_args").with_args("red").once()
flexmock(SomeClass).should_receive("static_method_with_args").with_args("blue").once()
SomeClass.static_method_with_args("red")
SomeClass.static_method_with_args("blue")
flexmock-0.13.0/tests/features/call_count.py 0000664 0000000 0000000 00000005122 15130526717 0021067 0 ustar 00root root 0000000 0000000 """Tests for call count modifiers."""
# pylint: disable=missing-docstring,no-member
from flexmock import exceptions, flexmock
from flexmock._api import flexmock_teardown
from tests.utils import assert_raises
class CallCountTestCase:
def test_support_at_least_and_at_most_together(self):
class Foo:
def method(self):
pass
instance = Foo()
flexmock(instance).should_call("method").at_least().once().at_most().twice()
with assert_raises(
exceptions.MethodCallError,
"method() expected to be called at least 1 time and at most 2 times, called 0 times",
):
flexmock_teardown()
flexmock(instance).should_call("method").at_least().once().at_most().twice()
instance.method()
instance.method()
with assert_raises(
exceptions.MethodCallError,
"method() expected to be called at most 2 times, called 3 times",
):
instance.method()
flexmock(instance).should_call("method").at_least().once().at_most().twice()
instance.method()
flexmock_teardown()
flexmock(instance).should_call("method").at_least().once().at_most().twice()
instance.method()
instance.method()
flexmock_teardown()
def test_at_least_cannot_be_used_twice(self):
class Foo:
def method(self):
pass
expectation = flexmock(Foo).should_receive("method")
with assert_raises(exceptions.FlexmockError, "cannot use at_least modifier twice"):
expectation.at_least().at_least()
def test_at_most_cannot_be_used_twice(self):
class Foo:
def method(self):
pass
expectation = flexmock(Foo).should_receive("method")
with assert_raises(exceptions.FlexmockError, "cannot use at_most modifier twice"):
expectation.at_most().at_most()
def test_at_least_cannot_be_specified_until_at_most_is_set(self):
class Foo:
def method(self):
pass
expectation = flexmock(Foo).should_receive("method")
with assert_raises(exceptions.FlexmockError, "cannot use at_most with at_least unset"):
expectation.at_least().at_most()
def test_at_most_cannot_be_specified_until_at_least_is_set(self):
class Foo:
def method(self):
pass
expectation = flexmock(Foo).should_receive("method")
with assert_raises(exceptions.FlexmockError, "cannot use at_least with at_most unset"):
expectation.at_most().at_least()
flexmock-0.13.0/tests/features/common.py 0000664 0000000 0000000 00000016005 15130526717 0020236 0 ustar 00root root 0000000 0000000 """Flexmock tests that are not related to any particular feature."""
# pylint: disable=missing-docstring
from flexmock import Mock, flexmock
from flexmock._api import (
ReturnValue,
_format_args,
_is_class_method,
_is_static_method,
_isproperty,
)
from tests.proxy import Proxy
from tests.some_module import DerivedClass, SomeClass
class CommonTestCase:
def test_return_value_to_str(self):
r_val = ReturnValue(value=1)
assert str(r_val) == "1"
r_val = ReturnValue(value=(1,))
assert str(r_val) == "1"
r_val = ReturnValue(value=(1, 2))
assert str(r_val) == "(1, 2)"
r_val = ReturnValue(value=1, raises=RuntimeError)
assert str(r_val) == "(1)"
def test_is_class_method(self):
assert _is_class_method(SomeClass.class_method, "class_method") is True
assert _is_class_method(SomeClass.static_method, "static_method") is False
assert _is_class_method(SomeClass.instance_method, "instance_method") is False
# Method names do no match
assert _is_class_method(SomeClass.class_method, "other_method") is False
some_class = SomeClass()
assert _is_class_method(some_class.class_method, "class_method") is True
assert _is_class_method(some_class.static_method, "static_method") is False
assert _is_class_method(some_class.instance_method, "instance_method") is False
assert _is_class_method(DerivedClass.class_method, "class_method") is True
assert _is_class_method(DerivedClass.static_method, "static_method") is False
assert _is_class_method(DerivedClass.instance_method, "instance_method") is False
derived_class = DerivedClass()
assert _is_class_method(derived_class.class_method, "class_method") is True
assert _is_class_method(derived_class.static_method, "static_method") is False
assert _is_class_method(derived_class.instance_method, "instance_method") is False
def test_is_class_method_proxied(self):
# pylint: disable=not-callable,invalid-name
SomeClassProxy = Proxy(SomeClass)
assert _is_class_method(SomeClassProxy.class_method, "class_method") is True
assert _is_class_method(SomeClassProxy.static_method, "static_method") is False
assert _is_class_method(SomeClassProxy.instance_method, "instance_method") is False
some_class = SomeClassProxy()
assert _is_class_method(some_class.class_method, "class_method") is True
assert _is_class_method(some_class.static_method, "static_method") is False
assert _is_class_method(some_class.instance_method, "instance_method") is False
DerivedClassProxy = Proxy(DerivedClass)
assert _is_class_method(DerivedClassProxy.class_method, "class_method") is True
assert _is_class_method(DerivedClassProxy.static_method, "static_method") is False
assert _is_class_method(DerivedClassProxy.instance_method, "instance_method") is False
derived_class = DerivedClassProxy()
assert _is_class_method(derived_class.class_method, "class_method") is True
assert _is_class_method(derived_class.static_method, "static_method") is False
assert _is_class_method(derived_class.instance_method, "instance_method") is False
def test_is_static_method(self):
assert _is_static_method(SomeClass, "class_method") is False
assert _is_static_method(SomeClass, "static_method") is True
assert _is_static_method(SomeClass, "instance_method") is False
some_class = SomeClass()
assert _is_static_method(some_class, "class_method") is False
assert _is_static_method(some_class, "static_method") is True
assert _is_static_method(some_class, "instance_method") is False
assert _is_static_method(DerivedClass, "class_method") is False
assert _is_static_method(DerivedClass, "static_method") is True
assert _is_static_method(DerivedClass, "instance_method") is False
derived_class = DerivedClass()
assert _is_static_method(derived_class, "class_method") is False
assert _is_static_method(derived_class, "static_method") is True
assert _is_static_method(derived_class, "instance_method") is False
def test_is_static_method_proxied(self):
# pylint: disable=not-callable,invalid-name
SomeClassProxy = Proxy(SomeClass)
assert _is_static_method(SomeClassProxy, "class_method") is False
assert _is_static_method(SomeClassProxy, "static_method") is True
assert _is_static_method(SomeClassProxy, "instance_method") is False
some_class = SomeClassProxy()
assert _is_static_method(some_class, "class_method") is False
assert _is_static_method(some_class, "static_method") is True
assert _is_static_method(some_class, "instance_method") is False
DerivedClassProxy = Proxy(DerivedClass)
assert _is_static_method(DerivedClassProxy, "class_method") is False
assert _is_static_method(DerivedClassProxy, "static_method") is True
assert _is_static_method(DerivedClassProxy, "instance_method") is False
derived_class = DerivedClassProxy()
assert _is_static_method(derived_class, "class_method") is False
assert _is_static_method(derived_class, "static_method") is True
assert _is_static_method(derived_class, "instance_method") is False
def test_isproperty(self):
class BaseClass:
@property
def method1(self):
pass
def method2(self):
pass
class ChildClass(BaseClass):
pass
base_instance = BaseClass()
child_instance = ChildClass()
assert _isproperty(base_instance, "method1") is True
assert _isproperty(base_instance, "method2") is False
assert _isproperty(BaseClass, "method1") is True
assert _isproperty(BaseClass, "method2") is False
assert _isproperty(child_instance, "method1") is True
assert _isproperty(child_instance, "method2") is False
assert _isproperty(ChildClass, "method1") is True
assert _isproperty(ChildClass, "method2") is False
assert _isproperty(Mock(), "method2") is False
def test_format_args_supports_tuples(self):
formatted = _format_args("method", {"kargs": ((1, 2),), "kwargs": {}})
assert formatted == "method((1, 2))"
def test_flexmock_should_not_explode_on_unicode_formatting(self):
formatted = _format_args("method", {"kargs": (chr(0x86C7),), "kwargs": {}})
assert formatted == 'method("蛇")'
def test_return_value_should_not_explode_on_unicode_values(self):
return_value = ReturnValue(chr(0x86C7))
assert f"{return_value}" == '"蛇"'
return_value = ReturnValue((chr(0x86C7), chr(0x86C7)))
assert f"{return_value}" == '("蛇", "蛇")'
def test_flexmock_should_yield_self_when_iterated(self):
class ClassNoIter:
pass
instance = flexmock(ClassNoIter)
assert instance is list(instance)[0]
flexmock-0.13.0/tests/features/conditional.py 0000664 0000000 0000000 00000004033 15130526717 0021247 0 ustar 00root root 0000000 0000000 """Tests for conditional assertions."""
# pylint: disable=missing-docstring,no-member
import functools
from flexmock import exceptions, flexmock
from tests.utils import assert_raises
class ConditionalAssertionsTestCase:
def test_state_machine(self):
class Radio:
def __init__(self):
self.is_on = False
self.volume = 0
def switch_on(self):
self.is_on = True
def switch_off(self):
self.is_on = False
def select_channel(self):
return None
def adjust_volume(self, num):
self.volume = num
radio = Radio()
flexmock(radio)
def radio_is_on():
return radio.is_on
radio.should_receive("select_channel").once().when(lambda: radio.is_on)
radio.should_call("adjust_volume").once().with_args(5).when(radio_is_on)
with assert_raises(
exceptions.StateError,
"select_channel expected to be called when lambda: radio.is_on is True",
):
radio.select_channel()
with assert_raises(
exceptions.StateError, "adjust_volume expected to be called when radio_is_on is True"
):
radio.adjust_volume(5)
radio.is_on = True
radio.select_channel()
radio.adjust_volume(5)
def test_when_parameter_should_be_callable(self):
with assert_raises(exceptions.FlexmockError, "when() parameter must be callable"):
flexmock().should_receive("something").when(1)
def test_flexmock_should_not_blow_up_with_builtin_in_when(self):
# It is not possible to get source for builtins. Flexmock should handle
# this gracefully.
mock = flexmock()
mock.should_receive("something").when(functools.partial(lambda: False))
with assert_raises(
exceptions.StateError, "something expected to be called when condition is True"
):
# Should not raise TypeError
mock.something()
flexmock-0.13.0/tests/features/derived.py 0000664 0000000 0000000 00000016303 15130526717 0020371 0 ustar 00root root 0000000 0000000 """Tests for mocking and spying derived classes."""
# pylint: disable=missing-docstring,no-member
from flexmock import exceptions, flexmock
from flexmock._api import flexmock_teardown
from tests.some_module import DerivedClass, SomeClass
from tests.utils import assert_raises
class DerivedTestCase:
def test_mock_class_method_on_derived_class(self):
flexmock(DerivedClass).should_receive("class_method").and_return(2).twice()
assert DerivedClass().class_method() == 2
assert DerivedClass.class_method() == 2
def test_mock_class_method_on_derived_class_after_mocking_base_class(self):
flexmock(SomeClass).should_receive("class_method").and_return(1).once()
assert SomeClass.class_method() == 1
flexmock(DerivedClass).should_receive("class_method").and_return(2).twice()
assert DerivedClass().class_method() == 2
assert DerivedClass.class_method() == 2
def test_mock_static_method_on_derived_class(self):
flexmock(DerivedClass).should_receive("static_method").and_return(4).twice()
assert DerivedClass().static_method() == 4
assert DerivedClass.static_method() == 4
def test_mock_static_method_on_derived_class_after_mocking_base_class(self):
flexmock(SomeClass).should_receive("static_method").and_return(3).once()
assert SomeClass.static_method() == 3
flexmock(DerivedClass).should_receive("static_method").and_return(4).twice()
assert DerivedClass().static_method() == 4
assert DerivedClass.static_method() == 4
def test_mock_class_method_with_args_on_derived_class(self):
flexmock(DerivedClass).should_receive("class_method_with_args").with_args(2).and_return(
3
).twice()
assert DerivedClass().class_method_with_args(2) == 3
assert DerivedClass.class_method_with_args(2) == 3
def test_mock_class_method_with_args_on_derived_class_after_mocking_base_class(self):
flexmock(SomeClass).should_receive("class_method_with_args").with_args(1).and_return(
2
).once()
assert SomeClass.class_method_with_args(1) == 2
flexmock(DerivedClass).should_receive("class_method_with_args").with_args(2).and_return(
3
).twice()
assert DerivedClass().class_method_with_args(2) == 3
assert DerivedClass.class_method_with_args(2) == 3
def test_mock_static_method_with_args_on_derived_class(self):
flexmock(DerivedClass).should_receive("static_method_with_args").with_args(4).and_return(
5
).twice()
assert DerivedClass().static_method_with_args(4) == 5
assert DerivedClass.static_method_with_args(4) == 5
def test_mock_static_method_with_args_on_derived_class_after_mocking_base_class(self):
flexmock(SomeClass).should_receive("static_method_with_args").with_args(2).and_return(
3
).once()
assert SomeClass.static_method_with_args(2) == 3
flexmock(DerivedClass).should_receive("static_method_with_args").with_args(4).and_return(
5
).twice()
assert DerivedClass().static_method_with_args(4) == 5
assert DerivedClass.static_method_with_args(4) == 5
def test_spy_class_method_on_derived_class(self):
flexmock(DerivedClass).should_call("class_method").and_return("class_method").twice()
assert DerivedClass().class_method() == "class_method"
assert DerivedClass.class_method() == "class_method"
def test_spy_class_method_on_derived_class_after_spying_base_class(self):
flexmock(SomeClass).should_call("class_method").and_return("class_method").times(
3
) # TODO: Should be once #80
assert SomeClass.class_method() == "class_method"
flexmock(DerivedClass).should_call("class_method").and_return("class_method").twice()
assert DerivedClass().class_method() == "class_method"
assert DerivedClass.class_method() == "class_method"
def test_spy_static_method_on_derived_class(self):
flexmock(DerivedClass).should_call("static_method").and_return("static_method").twice()
assert DerivedClass().static_method() == "static_method"
assert DerivedClass.static_method() == "static_method"
def test_spy_static_method_on_derived_class_after_spying_base_class(self):
flexmock(SomeClass).should_call("static_method").and_return("static_method").times(
3
) # TODO: Should be once #80
assert SomeClass.static_method() == "static_method"
flexmock(DerivedClass).should_call("static_method").and_return("static_method").twice()
assert DerivedClass().static_method() == "static_method"
assert DerivedClass.static_method() == "static_method"
def test_spy_class_method_with_args_on_derived_class(self):
flexmock(DerivedClass).should_call("class_method_with_args").with_args(2).and_return(2)
assert DerivedClass().class_method_with_args(2) == 2
assert DerivedClass.class_method_with_args(2) == 2
@assert_raises(
exceptions.MethodSignatureError, match=None
) # TODO: Should not raise exception #79
def test_spy_class_method_with_args_on_derived_class_after_spying_base_class(self):
flexmock(SomeClass).should_call("class_method_with_args").with_args(1).and_return(1)
assert SomeClass.class_method_with_args(1) == 1
flexmock(DerivedClass).should_call("class_method_with_args").with_args(2).and_return(2)
assert DerivedClass().class_method_with_args(2) == 2
assert DerivedClass.class_method_with_args(2) == 2
def test_spy_static_method_with_args_on_derived_class(self):
flexmock(DerivedClass).should_call("static_method_with_args").with_args(4).and_return(
4
).twice()
assert DerivedClass().static_method_with_args(4) == 4
assert DerivedClass.static_method_with_args(4) == 4
@assert_raises(
exceptions.MethodSignatureError, match=None
) # TODO: Should not raise exception #79
def test_spy_static_method_with_args_on_derived_class_after_spying_base_class(self):
flexmock(SomeClass).should_call("static_method_with_args").with_args(2).and_return(2).once()
assert SomeClass.static_method_with_args(2) == 2
flexmock(DerivedClass).should_call("static_method_with_args").with_args(4).and_return(
4
).once() # should be twice
assert DerivedClass().static_method_with_args(4) == 4
assert DerivedClass.static_method_with_args(4) == 4
def test_multi_mock_class_method_on_derived_class_is_properly_torn_down(self):
flexmock(DerivedClass).should_receive("class_method_with_args").with_args(1).once()
DerivedClass.class_method_with_args(1)
flexmock(DerivedClass).should_receive("class_method_with_args").with_args(2).once()
DerivedClass.class_method_with_args(2)
flexmock(DerivedClass).should_receive("class_method_with_args").with_args(3).once()
DerivedClass.class_method_with_args(3)
# Run teardown manually to allow this test case to be contained in single test
flexmock_teardown()
flexmock(DerivedClass).should_receive("class_method_with_args").with_args(4).once()
DerivedClass.class_method_with_args(4)
flexmock-0.13.0/tests/features/mocking.py 0000664 0000000 0000000 00000143435 15130526717 0020405 0 ustar 00root root 0000000 0000000 """Tests for flexmock mocking feature."""
# pylint: disable=missing-docstring,no-member,too-many-lines,duplicate-code
import os
import random
import re
import sys
from flexmock import exceptions, flexmock
from flexmock._api import AT_LEAST, AT_MOST, EXACTLY, FlexmockContainer, Mock, flexmock_teardown
from tests import some_module
from tests.utils import assert_raises
class MockingTestCase:
def test_print_expectation(self):
mock = flexmock()
expectation = mock.should_receive("foo")
assert str(expectation) == "foo() -> ()"
def test_flexmock_should_create_mock_object(self):
mock = flexmock()
assert isinstance(mock, Mock)
def test_flexmock_should_create_mock_object_from_dict(self):
mock = flexmock(foo="foo", bar="bar")
assert mock.foo == "foo"
assert mock.bar == "bar"
def test_flexmock_should_add_expectations(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo")
assert "method_foo" in [x._name for x in FlexmockContainer.flexmock_objects[mock]]
def test_flexmock_should_return_value(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("value_bar")
mock.should_receive("method_bar").and_return("value_baz")
assert mock.method_foo() == "value_bar"
assert mock.method_bar() == "value_baz"
def test_calling_deprecated_properties_should_raise_exception(self):
error_msg = "Calling once, twice, never, or mock without parentheses has been deprecated"
mock = flexmock()
mock.should_receive("foo").once # pylint: disable=expression-not-assigned
with assert_raises(exceptions.FlexmockError, error_msg):
flexmock_teardown()
mock.should_receive("foo").twice # pylint: disable=expression-not-assigned
with assert_raises(exceptions.FlexmockError, error_msg):
flexmock_teardown()
mock.should_receive("foo").never # pylint: disable=expression-not-assigned
with assert_raises(exceptions.FlexmockError, error_msg):
flexmock_teardown()
mock.should_receive("foo").mock # pylint: disable=expression-not-assigned
with assert_raises(exceptions.FlexmockError, error_msg):
flexmock_teardown()
def test_type_flexmock_with_unicode_string_in_should_receive(self):
class Foo:
def method(self):
return "bar"
flexmock(Foo).should_receive("method").and_return("mocked_bar")
instance = Foo()
assert instance.method() == "mocked_bar"
def test_flexmock_should_accept_shortcuts_for_creating_mock_object(self):
mock = flexmock(attr1="value 1", attr2=lambda: "returning 2")
assert mock.attr1 == "value 1"
assert mock.attr2() == "returning 2"
def test_flexmock_should_accept_shortcuts_for_creating_expectations(self):
class Foo:
def method1(self):
pass
def method2(self):
pass
instance = Foo()
flexmock(instance, method1="returning 1", method2="returning 2")
assert instance.method1() == "returning 1"
assert instance.method2() == "returning 2"
assert instance.method2() == "returning 2"
def test_flexmock_expectations_returns_all(self):
mock = flexmock(name="temp")
assert mock not in FlexmockContainer.flexmock_objects
mock.should_receive("method_foo")
mock.should_receive("method_bar")
assert len(FlexmockContainer.flexmock_objects[mock]) == 2
def test_flexmock_expectations_returns_named_expectation(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo")
assert FlexmockContainer.get_flexmock_expectation(mock, "method_foo")._name == "method_foo"
def test_flexmock_expectations_returns_none_if_not_found(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo")
assert FlexmockContainer.get_flexmock_expectation(mock, "method_bar") is None
def test_flexmock_should_check_parameters(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").with_args("bar").and_return(1)
mock.should_receive("method_foo").with_args("baz").and_return(2)
assert mock.method_foo("bar") == 1
assert mock.method_foo("baz") == 2
def test_flexmock_should_keep_track_of_calls(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").with_args("foo").and_return(0)
mock.should_receive("method_foo").with_args("bar").and_return(1)
mock.should_receive("method_foo").with_args("baz").and_return(2)
mock.method_foo("bar")
mock.method_foo("bar")
mock.method_foo("baz")
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo", ("foo",))
assert expectation._times_called == 0
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo", ("bar",))
assert expectation._times_called == 2
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo", ("baz",))
assert expectation._times_called == 1
def test_flexmock_should_set_expectation_call_numbers(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").times(1)
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo")
with assert_raises(
exceptions.MethodCallError,
"method_foo() expected to be called exactly 1 time, called 0 times",
):
expectation._verify()
mock.method_foo()
expectation._verify()
def test_flexmock_should_check_raised_exceptions(self):
mock = flexmock(name="temp")
class FakeException(Exception):
pass
mock.should_receive("method_foo").and_raise(FakeException)
with assert_raises(FakeException, ""):
mock.method_foo()
assert FlexmockContainer.get_flexmock_expectation(mock, "method_foo")._times_called == 1
def test_flexmock_should_check_raised_exceptions_instance_with_args(self):
mock = flexmock(name="temp")
class FakeException(Exception):
def __init__(self, arg, arg2):
# pylint: disable=super-init-not-called
pass
mock.should_receive("method_foo").and_raise(FakeException(1, arg2=2))
with assert_raises(FakeException, "1"):
mock.method_foo()
assert FlexmockContainer.get_flexmock_expectation(mock, "method_foo")._times_called == 1
def test_flexmock_should_check_raised_exceptions_class_with_args(self):
mock = flexmock(name="temp")
class FakeException(Exception):
def __init__(self, arg, arg2):
# pylint: disable=super-init-not-called
pass
mock.should_receive("method_foo").and_raise(FakeException, 1, arg2=2)
with assert_raises(FakeException, "1"):
mock.method_foo()
assert FlexmockContainer.get_flexmock_expectation(mock, "method_foo")._times_called == 1
def test_flexmock_should_match_any_args_by_default(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("bar")
mock.should_receive("method_foo").with_args("baz").and_return("baz")
assert mock.method_foo() == "bar"
assert mock.method_foo(1) == "bar"
assert mock.method_foo("foo", "bar") == "bar"
assert mock.method_foo("baz") == "baz"
def test_flexmock_should_fail_to_match_exactly_no_args_when_calling_with_args(self):
mock = flexmock()
mock.should_receive("method_foo").with_args()
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method_foo did not match expectations:\n"
' Received call:\tmethod_foo("baz")\n'
" Expected call[1]:\tmethod_foo()"
),
):
mock.method_foo("baz")
def test_flexmock_should_match_exactly_no_args(self):
class Foo:
def method(self):
pass
instance = Foo()
flexmock(instance).should_receive("method").with_args().and_return("baz")
assert instance.method() == "baz"
def test_expectation_dot_mock_should_return_mock(self):
mock = flexmock(name="temp")
assert mock.should_receive("method_foo").mock() == mock
def test_flexmock_should_create_partial_new_style_object_mock(self):
class User:
def __init__(self, name=None):
self.name = name
def get_name(self):
return self.name
def set_name(self, name):
self.name = name
user = User()
flexmock(user)
user.should_receive("get_name").and_return("john")
user.set_name("mike")
assert user.get_name() == "john"
def test_flexmock_should_create_partial_old_style_object_mock(self):
class User:
def __init__(self, name=None):
self.name = name
def get_name(self):
return self.name
def set_name(self, name):
self.name = name
user = User()
flexmock(user)
user.should_receive("get_name").and_return("john")
user.set_name("mike")
assert user.get_name() == "john"
def test_flexmock_should_create_partial_new_style_class_mock(self):
class User:
def __init__(self):
pass
def get_name(self):
pass
flexmock(User)
User.should_receive("get_name").and_return("mike")
user = User()
assert user.get_name() == "mike"
def test_flexmock_should_create_partial_old_style_class_mock(self):
class User:
def __init__(self):
pass
def get_name(self):
pass
flexmock(User)
User.should_receive("get_name").and_return("mike")
user = User()
assert user.get_name() == "mike"
def test_flexmock_should_match_expectations_against_builtin_classes(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").with_args(str).and_return("got a string")
mock.should_receive("method_foo").with_args(int).and_return("got an int")
assert mock.method_foo("string!") == "got a string"
assert mock.method_foo(23) == "got an int"
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method_foo did not match expectations:\n"
" Received call:\tmethod_foo(2.0)\n"
" Expected call[1]:\tmethod_foo()\n"
" Expected call[2]:\tmethod_foo()"
),
):
mock.method_foo(2.0)
def test_with_args_should_work_with_builtin_c_methods(self):
flexmock(sys.stdout).should_call("write") # set fall-through
flexmock(sys.stdout).should_receive("write").with_args("flexmock_builtin_test")
sys.stdout.write("flexmock_builtin_test")
def test_with_args_should_work_with_builtin_c_functions(self):
mocked = flexmock(sys)
mocked.should_receive("exit").with_args(1).once()
mocked.exit(1)
flexmock_teardown()
flexmock(os).should_receive("remove").with_args("path").once()
os.remove("path")
def test_with_args_should_work_with_builtin_python_methods(self):
flexmock(random).should_receive("randint").with_args(1, 10).once()
random.randint(1, 10)
def test_flexmock_should_match_expectations_against_user_defined_classes(self):
mock = flexmock(name="temp")
class Foo:
pass
mock.should_receive("method_foo").with_args(Foo).and_return("got a Foo")
assert mock.method_foo(Foo()) == "got a Foo"
with assert_raises(
exceptions.MethodSignatureError,
(
"Arguments for call method_foo did not match expectations:\n"
" Received call:\tmethod_foo(1)\n"
" Expected call[1]:\tmethod_foo(.Foo'>)"
),
):
mock.method_foo(1)
def test_flexmock_configures_global_mocks_dict(self):
mock = flexmock(name="temp")
assert mock not in FlexmockContainer.flexmock_objects
mock.should_receive("method_foo")
assert mock in FlexmockContainer.flexmock_objects
assert len(FlexmockContainer.flexmock_objects[mock]) == 1
def test_flexmock_teardown_verifies_mocks(self):
mock = flexmock(name="temp")
mock.should_receive("verify_expectations").times(1)
with assert_raises(
exceptions.MethodCallError,
"verify_expectations() expected to be called exactly 1 time, called 0 times",
):
flexmock_teardown()
def test_flexmock_teardown_does_not_verify_stubs(self):
mock = flexmock(name="temp")
mock.should_receive("verify_expectations")
flexmock_teardown()
def test_flexmock_preserves_stubbed_object_methods_between_tests(self):
class User:
def get_name(self):
return "mike"
user = User()
flexmock(user).should_receive("get_name").and_return("john")
assert user.get_name() == "john"
flexmock_teardown()
assert user.get_name() == "mike"
def test_flexmock_preserves_stubbed_class_methods_between_tests(self):
class User:
def get_name(self):
return "mike"
user = User()
flexmock(User).should_receive("get_name").and_return("john")
assert user.get_name() == "john"
flexmock_teardown()
assert user.get_name() == "mike"
def test_flexmock_removes_new_stubs_from_objects_after_tests(self):
class User:
def get_name(self):
pass
user = User()
saved = user.get_name
flexmock(user).should_receive("get_name").and_return("john")
assert saved != user.get_name
assert user.get_name() == "john"
flexmock_teardown()
assert user.get_name == saved
def test_flexmock_removes_new_stubs_from_classes_after_tests(self):
class User:
def get_name(self):
pass
user = User()
saved = user.get_name
flexmock(User).should_receive("get_name").and_return("john")
assert saved != user.get_name
assert user.get_name() == "john"
flexmock_teardown()
assert user.get_name == saved
def test_flexmock_removes_stubs_from_multiple_objects_on_teardown(self):
class User:
def get_name(self):
pass
class Group:
def get_name(self):
pass
user = User()
group = Group()
saved1 = user.get_name
saved2 = group.get_name
flexmock(user).should_receive("get_name").and_return("john").once()
flexmock(group).should_receive("get_name").and_return("john").once()
assert saved1 != user.get_name
assert saved2 != group.get_name
assert user.get_name() == "john"
assert group.get_name() == "john"
flexmock_teardown()
assert user.get_name == saved1
assert group.get_name == saved2
def test_flexmock_removes_stubs_from_multiple_classes_on_teardown(self):
class User:
def get_name(self):
pass
class Group:
def get_name(self):
pass
user = User()
group = User()
saved1 = user.get_name
saved2 = group.get_name
flexmock(User).should_receive("get_name").and_return("john")
flexmock(Group).should_receive("get_name").and_return("john")
assert saved1 != user.get_name
assert saved2 != group.get_name
assert user.get_name() == "john"
assert group.get_name() == "john"
flexmock_teardown()
assert user.get_name == saved1
assert group.get_name == saved2
def test_flexmock_stubs_are_callable(self):
stub = flexmock()
mocked = flexmock()
mocked.should_receive("create").twice()
stub.tickets = mocked
# stub.tickets should work with and without parentheses
stub.tickets().create()
stub.tickets.create()
flexmock_teardown()
def test_flexmock_respects_at_least_when_called_less_than_requested(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("bar").at_least().twice()
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo")
assert expectation._modifier == AT_LEAST
mock.method_foo()
with assert_raises(
exceptions.MethodCallError,
"method_foo() expected to be called at least 2 times, called 1 time",
):
flexmock_teardown()
def test_flexmock_respects_at_least_when_called_requested_number(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("value_bar").at_least().once()
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo")
assert expectation._modifier == AT_LEAST
mock.method_foo()
flexmock_teardown()
def test_flexmock_respects_at_least_when_called_more_than_requested(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("value_bar").at_least().once()
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo")
assert expectation._modifier == AT_LEAST
mock.method_foo()
mock.method_foo()
flexmock_teardown()
def test_flexmock_respects_at_most_when_called_less_than_requested(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("bar").at_most().twice()
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo")
assert expectation._modifier == AT_MOST
mock.method_foo()
flexmock_teardown()
def test_flexmock_respects_at_most_when_called_requested_number(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("value_bar").at_most().once()
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo")
assert expectation._modifier == AT_MOST
mock.method_foo()
flexmock_teardown()
def test_flexmock_respects_at_most_when_called_more_than_requested(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("value_bar").at_most().once()
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo")
assert expectation._modifier == AT_MOST
mock.method_foo()
with assert_raises(
exceptions.MethodCallError,
"method_foo() expected to be called at most 1 time, called 2 times",
):
mock.method_foo()
def test_flexmock_treats_once_as_times_one(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("value_bar").once()
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo")
assert expectation._expected_calls[EXACTLY] == 1
with assert_raises(
exceptions.MethodCallError,
"method_foo() expected to be called exactly 1 time, called 0 times",
):
flexmock_teardown()
def test_flexmock_treats_twice_as_times_two(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").twice().and_return("value_bar")
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo")
assert expectation._expected_calls[EXACTLY] == 2
with assert_raises(
exceptions.MethodCallError,
"method_foo() expected to be called exactly 2 times, called 0 times",
):
flexmock_teardown()
def test_flexmock_works_with_never_when_true(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("value_bar").never()
expectation = FlexmockContainer.get_flexmock_expectation(mock, "method_foo")
assert expectation._expected_calls[EXACTLY] == 0
flexmock_teardown()
def test_flexmock_works_with_never_when_false(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").and_return("value_bar").never()
with assert_raises(
exceptions.MethodCallError,
"method_foo() expected to be called exactly 0 times, called 1 time",
):
mock.method_foo()
def test_flexmock_get_flexmock_expectation_should_work_with_args(self):
mock = flexmock(name="temp")
mock.should_receive("method_foo").with_args("value_bar")
assert FlexmockContainer.get_flexmock_expectation(mock, "method_foo", "value_bar")
def test_mock_kwargs_only_func_mock_all(self):
flexmock(some_module).should_receive("kwargs_only_func1").with_args(
1, bar=2, baz=3
).and_return(123)
assert some_module.kwargs_only_func1(1, bar=2, baz=3) == 123
def test_mock_kwargs_only_func_mock_required(self):
flexmock(some_module).should_receive("kwargs_only_func1").with_args(1, bar=2).and_return(
123
)
assert some_module.kwargs_only_func1(1, bar=2) == 123
def test_mock_kwargs_only_func_fails_if_required_not_provided(self):
with assert_raises(
exceptions.MethodSignatureError,
'kwargs_only_func1 requires keyword-only argument "bar"',
):
flexmock(some_module).should_receive("kwargs_only_func1").with_args(1)
with assert_raises(
exceptions.MethodSignatureError,
'kwargs_only_func2 requires keyword-only arguments "bar", "baz"',
):
flexmock(some_module).should_receive("kwargs_only_func2").with_args(2)
def test_context_manager_on_instance(self):
class CM:
def __enter__(self):
pass
def __exit__(self, *_):
pass
instance = CM()
flexmock(instance).should_call("__enter__").once()
flexmock(instance).should_call("__exit__").once()
with instance:
pass
flexmock_teardown()
def test_context_manager_on_class(self):
class CM:
def __enter__(self):
pass
def __exit__(self, *_):
pass
instance = CM()
flexmock(CM).should_receive("__enter__").once()
flexmock(CM).should_receive("__exit__").once()
with instance:
pass
flexmock_teardown()
def test_flexmock_should_support_with(self):
mocked = flexmock()
with mocked as mock:
mock.should_receive("bar").and_return("baz")
assert mocked.bar() == "baz"
def test_builtin_open(self):
mock = flexmock(sys.modules["builtins"])
fake_fd = flexmock(read=lambda: "some data")
mock.should_receive("open").once().with_args("file_name").and_return(fake_fd)
with open("file_name") as file: # pylint: disable=unspecified-encoding
data = file.read()
assert data == "some data"
def test_mock_multiple_properties(self):
class Foo:
@property
def prop1(self):
return "prop1"
@property
def prop2(self):
return "prop2"
mocked = Foo()
flexmock(mocked, prop1="mocked1", prop2="mocked2")
assert mocked.prop1 == "mocked1"
assert mocked.prop2 == "mocked2"
def test_mock_property_with_attribute_on_instance(self):
class Foo:
@property
def method(self):
return "bar"
foo1 = Foo()
foo2 = Foo()
foo3 = Foo()
flexmock(foo1, method="baz")
flexmock(foo2, method="baz2")
assert foo1.method == "baz"
assert foo2.method == "baz2"
assert foo3.method == "bar"
flexmock_teardown()
assert hasattr(Foo, "_flexmock__method") is False, "Property method not cleaned up"
assert foo1.method == "bar"
assert foo2.method == "bar"
assert foo3.method == "bar"
def test_mock_property_with_attribute_on_class(self):
class Foo:
@property
def method(self):
return "bar"
foo1 = Foo()
foo2 = Foo()
flexmock(Foo, method="baz")
assert foo1.method == "baz"
assert foo2.method == "baz"
flexmock_teardown()
assert hasattr(Foo, "_flexmock__method") is False, "Property method not cleaned up"
assert foo1.method == "bar"
assert foo2.method == "bar"
def test_verifying_methods_when_mocking_module(self):
# previously, we had problems with recognizing methods vs functions if the mocked
# object was an imported module
flexmock(some_module).should_receive("ModuleClass").with_args(1, 2)
flexmock(some_module).should_receive("module_function").with_args(1, 2)
def test_fake_object_supporting_iteration(self):
mocked = flexmock()
mocked.should_receive("__iter__").and_yield(1, 2, 3)
assert list(mocked) == [1, 2, 3]
def test_with_args_for_single_named_arg_with_optional_args(self):
class FooClass:
def method(self, one, two="optional"):
pass
flexmock(FooClass).should_receive("method").with_args(one=1)
def test_with_args_doesnt_set_max_when_using_varargs(self):
class FooClass:
def method(self, *args):
pass
flexmock(FooClass).should_receive("method").with_args(1, 2, 3)
def test_with_args_doesnt_set_max_when_using_kwargs(self):
class FooClass:
def method(self, **kwargs):
pass
flexmock(FooClass).should_receive("method").with_args(1, 2, 3)
def test_with_args_blows_up_on_too_few_args(self):
class FooClass:
def method1(self, arg1):
pass
def method2(self, arg1, arg2, arg3=1):
pass
mock = flexmock(FooClass)
expectation1 = mock.should_receive("method1")
expectation2 = mock.should_receive("method2")
with assert_raises(
exceptions.MethodSignatureError,
"method1 requires at least 1 argument, expectation provided 0",
):
expectation1.with_args()
with assert_raises(
exceptions.MethodSignatureError,
"method2 requires at least 2 arguments, expectation provided 1",
):
expectation2.with_args(1)
def test_with_args_blows_up_on_too_few_args_with_kwargs(self):
class FooClass:
def method(self, arg1, arg2, arg3=1):
pass
expectation = flexmock(FooClass).should_receive("method")
with assert_raises(
exceptions.MethodSignatureError,
"method requires at least 3 arguments, expectation provided 2",
):
expectation.with_args(1, arg3=2)
def test_with_args_blows_up_on_too_many_args(self):
class FooClass:
def method(self, arg1, arg2, arg3=1):
pass
expectation = flexmock(FooClass).should_receive("method")
with assert_raises(
exceptions.MethodSignatureError,
"method requires at most 3 arguments, expectation provided 4",
):
expectation.with_args(1, 2, 3, 4)
def test_with_args_blows_up_on_kwarg_overlapping_positional(self):
class FooClass:
def method(self, arg1, arg2, arg3=1, **kwargs):
pass
expectation = flexmock(FooClass).should_receive("method")
with assert_raises(
exceptions.MethodSignatureError,
"['arg3'] already given as positional argument to method",
):
expectation.with_args(1, 2, 3, arg3=2)
with assert_raises(
exceptions.MethodSignatureError,
"['arg3', 'arg2'] already given as positional arguments to method",
):
expectation.with_args(1, 2, 3, arg3=2, arg2=3)
def test_with_args_blows_up_on_invalid_kwarg(self):
class FooClass:
def method(self, arg1, arg2, arg3=1):
pass
with assert_raises(
exceptions.MethodSignatureError, "d is not a valid keyword argument to method"
):
flexmock(FooClass).should_receive("method").with_args(1, 2, d=2)
def test_with_args_ignores_invalid_args_on_flexmock_instances(self):
instance = flexmock(bar=lambda x: x)
instance.should_receive("bar").with_args("stuff")
instance.bar("stuff")
def test_with_args_does_not_compensate_for_self_on_static_instance_methods(self):
class FooClass:
@staticmethod
def method(arg):
pass
instance = FooClass()
flexmock(instance).should_receive("method").with_args("stuff")
instance.method("stuff")
def test_with_args_does_not_compensate_for_self_on_static_class_methods(self):
class FooClass:
@staticmethod
def method(arg):
pass
flexmock(FooClass).should_receive("method").with_args("stuff")
FooClass.method("stuff")
def test_with_args_does_compensate_for_cls_on_class_methods(self):
class FooClass:
@classmethod
def method(cls, arg):
pass
instance = FooClass()
flexmock(instance).should_receive("method").with_args("stuff")
instance.method("stuff")
def test_calling_with_keyword_args_matches_mock_with_positional_args(self):
class FooClass:
def method(self, arg1, arg2, arg3):
pass
instance = FooClass()
flexmock(instance).should_receive("method").with_args(1, 2, 3).once()
instance.method(arg1=1, arg2=2, arg3=3)
def test_calling_with_positional_args_matches_mock_with_kwargs(self):
class FooClass:
def method(self, arg1, arg2, arg3):
pass
instance = FooClass()
flexmock(instance).should_receive("method").with_args(arg1=1, arg2=2, arg3=3).once()
instance.method(1, 2, arg3=3)
def test_and_return_defaults_to_none_with_no_arguments(self):
mocked = flexmock()
mocked.should_receive("bar").and_return()
assert mocked.bar() is None
def test_non_callable_attributes_fail_to_set_expectations(self):
class FooClass:
attribute = 1
instance = FooClass()
expectation = flexmock(instance).should_receive("attribute").and_return(2)
with assert_raises(exceptions.FlexmockError, "can't use times() with attribute stubs"):
expectation.times(1)
with assert_raises(exceptions.FlexmockError, "can't use with_args() with attribute stubs"):
expectation.with_args(())
with assert_raises(
exceptions.FlexmockError, "can't use replace_with() with attribute/property stubs"
):
expectation.replace_with(lambda x: x)
with assert_raises(exceptions.FlexmockError, "can't use and_raise() with attribute stubs"):
expectation.and_raise(Exception)
with assert_raises(exceptions.FlexmockError, "can't use when() with attribute stubs"):
expectation.when(lambda x: x)
with assert_raises(exceptions.FlexmockError, "can't use and_yield() with attribute stubs"):
expectation.and_yield(1)
with assert_raises(exceptions.FlexmockError, "can't use ordered() with attribute stubs"):
object.__getattribute__(expectation, "ordered")()
with assert_raises(exceptions.FlexmockError, "can't use at_least() with attribute stubs"):
object.__getattribute__(expectation, "at_least")()
with assert_raises(exceptions.FlexmockError, "can't use at_most() with attribute stubs"):
object.__getattribute__(expectation, "at_most")()
with assert_raises(exceptions.FlexmockError, "can't use one_by_one() with attribute stubs"):
object.__getattribute__(expectation, "one_by_one")()
def test_should_chain_attributes(self):
class Class1:
x = 1
class Class2:
class1 = Class1()
class Class3:
class2 = Class2()
class3 = Class3()
mocked = flexmock(class3)
mocked.should_receive("class2.class1.x").and_return(2)
assert mocked.class2.class1.x == 2
flexmock_teardown()
assert mocked.class2.class1.x == 1
def test_mocking_subclass_of_str(self):
class String(str):
pass
string = String()
flexmock(string, endswith="fake")
assert string.endswith("stuff") == "fake"
flexmock_teardown()
assert string.endswith("stuff") is False
def test_proper_reset_of_subclass_methods(self):
class ClassA:
def method(self):
return "a"
class ClassB(ClassA):
def method(self):
return "b"
flexmock(ClassB).should_receive("method").and_return("1")
flexmock_teardown()
assert ClassB().method() == "b"
def test_flexmock_class_returns_same_object_on_repeated_calls(self):
class Foo:
pass
first = flexmock(Foo)
second = flexmock(Foo)
assert first is second
def test_flexmock_object_returns_same_object_on_repeated_calls(self):
class Foo:
pass
instance = Foo()
first = flexmock(instance)
second = flexmock(instance)
assert first is second
def test_mocking_down_the_inheritance_chain_class_to_class(self):
class Parent:
def method1(self):
pass
class Child(Parent):
def method2(self):
pass
flexmock(Parent).should_receive("method1").and_return("outer")
flexmock(Child).should_receive("method2").and_return("inner")
assert Parent().method1() == "outer"
assert Child().method2() == "inner"
def test_flexmock_should_mock_the_same_method_multiple_times(self):
class Foo:
def method(self):
pass
instance = Foo()
flexmock(instance).should_receive("method").and_return(1)
assert instance.method() == 1
flexmock(instance).should_receive("method").and_return(2)
assert instance.method() == 2
flexmock(instance).should_receive("method").and_return(3)
assert instance.method() == 3
flexmock(instance).should_receive("method").and_return(4)
assert instance.method() == 4
def test_new_instances_should_be_a_method(self):
class Foo:
pass
flexmock(Foo).new_instances("bar")
assert Foo() == "bar"
flexmock_teardown()
assert Foo() != "bar"
def test_new_instances_raises_error_when_not_a_class(self):
class Foo:
pass
instance = Foo()
flexmock(instance)
with assert_raises(
exceptions.FlexmockError, "new_instances can only be called on a class mock"
):
instance.new_instances("bar")
def test_new_instances_works_with_multiple_return_values(self):
class Foo:
pass
flexmock(Foo).new_instances("foo", "bar")
assert Foo() == "foo"
assert Foo() == "bar"
def test_should_receive_should_not_replace_flexmock_methods(self):
class Foo:
pass
instance = Foo()
flexmock(instance)
for method_name in ["should_receive", "should_call", "new_instances"]:
with assert_raises(exceptions.FlexmockError, "unable to replace flexmock methods"):
instance.should_receive(method_name)
def test_flexmock_should_not_add_methods_if_they_already_exist(self):
class Foo:
def should_receive(self):
return "real"
def method(self):
pass
instance = Foo()
mock = flexmock(instance)
assert instance.should_receive() == "real"
assert "should_call" not in dir(instance)
assert "new_instances" not in dir(instance)
mock.should_receive("method").and_return("baz")
assert instance.method() == "baz"
flexmock_teardown()
assert instance.should_receive() == "real"
def test_flexmock_should_not_add_class_methods_if_they_already_exist(self):
class Foo:
def should_receive(self):
return "real"
def method(self):
pass
instance = Foo()
mock = flexmock(Foo)
assert instance.should_receive() == "real"
assert "should_call" not in dir(Foo)
assert "new_instances" not in dir(Foo)
mock.should_receive("method").and_return("baz")
assert instance.method() == "baz"
flexmock_teardown()
assert instance.should_receive() == "real"
def test_flexmock_should_replace_method(self):
class Foo:
def method(self, arg):
return arg
instance = Foo()
flexmock(instance).should_receive("method").replace_with(lambda x: x == 5)
assert instance.method(5) is True
assert instance.method(4) is False
def test_flexmock_should_replace_cannot_be_specified_twice(self):
class Foo:
def method(self, arg):
return arg
instance = Foo()
expectation = flexmock(instance).should_receive("method").replace_with(lambda x: x == 5)
with assert_raises(exceptions.FlexmockError, "replace_with cannot be specified twice"):
expectation.replace_with(lambda x: x == 3)
def test_should_give_reasonable_error_for_builtins(self):
with assert_raises(
exceptions.MockBuiltinError,
(
"Python does not allow you to mock builtin objects or modules. "
"Consider wrapping it in a class you can mock instead"
),
):
flexmock(object)
def test_should_give_reasonable_error_for_instances_of_builtins(self):
with assert_raises(
exceptions.MockBuiltinError,
(
"Python does not allow you to mock instances of builtin objects. "
"Consider wrapping it in a class you can mock instead"
),
):
flexmock(object())
def test_mock_chained_method_calls_works_with_one_level(self):
class Foo:
def method2(self):
return "foo"
class Bar:
def method1(self):
return Foo()
instance = Bar()
assert instance.method1().method2() == "foo"
flexmock(instance).should_receive("method1.method2").and_return("bar")
assert instance.method1().method2() == "bar"
def test_mock_chained_method_supports_args_and_mocks(self):
class Foo:
def method2(self, arg):
return arg
class Bar:
def method1(self):
return Foo()
instance = Bar()
assert instance.method1().method2("foo") == "foo"
flexmock(instance).should_receive("method1.method2").with_args("foo").and_return(
"bar"
).once()
assert instance.method1().method2("foo") == "bar"
flexmock_teardown()
flexmock(instance).should_receive("method1.method2").with_args("foo").and_return(
"bar"
).once()
with assert_raises(
exceptions.MethodCallError,
'method2("foo") expected to be called exactly 1 time, called 0 times',
):
flexmock_teardown()
def test_mock_chained_method_calls_works_with_more_than_one_level(self):
class Baz:
def method3(self):
return "foo"
class Foo:
def method2(self):
return Baz()
class Bar:
def method1(self):
return Foo()
instance = Bar()
assert instance.method1().method2().method3() == "foo"
flexmock(instance).should_receive("method1.method2.method3").and_return("bar")
assert instance.method1().method2().method3() == "bar"
def test_flexmock_should_fail_mocking_nonexistent_methods(self):
class User:
pass
user = User()
with assert_raises(
exceptions.FlexmockError,
re.compile(
r"<.+\.\.User object at 0x.+> does not have attribute 'nonexistent'"
),
):
flexmock(user).should_receive("nonexistent")
def test_new_instances_should_blow_up_on_should_receive(self):
class User:
pass
mock = flexmock(User).new_instances(None).mock()
with assert_raises(exceptions.FlexmockError, "User does not have attribute 'foo'"):
mock.should_receive("foo")
def test_flexmock_should_support_mocking_classes_as_functions(self):
flexmock(some_module).should_receive("SomeClass").and_return("yay")
assert some_module.SomeClass() == "yay"
def test_flexmock_should_properly_restore_class_methods(self):
class User:
@classmethod
def get_stuff(cls):
return cls.__name__
assert isinstance(User.__dict__["get_stuff"], classmethod)
assert User.get_stuff() == "User"
flexmock(User).should_receive("get_stuff").and_return("foo")
assert User.get_stuff() == "foo"
flexmock_teardown()
assert User.get_stuff() == "User"
assert isinstance(User.__dict__["get_stuff"], classmethod)
def test_flexmock_should_mock_same_class_twice(self):
class Foo:
pass
flexmock(Foo)
flexmock(Foo)
def test_and_raise_with_invalid_arguments(self):
with assert_raises(
exceptions.FlexmockError,
"can't initialize with the given arguments",
):
flexmock().should_receive("foo").and_raise(Exception, 1, bar=2)
def test_flexmock_should_mock_iter_on_new_style_instances(self):
class Foo:
def __iter__(self):
yield None
old = Foo.__iter__
foo1 = Foo()
foo2 = Foo()
foo3 = Foo()
flexmock(foo1, __iter__=iter([1, 2, 3]))
flexmock(foo2, __iter__=iter([3, 4, 5]))
assert list(foo1) == [1, 2, 3]
assert list(foo2) == [3, 4, 5]
assert list(foo3) == [None]
assert foo1.__iter__ is not old
assert foo2.__iter__ is not old
assert foo3.__iter__ is not old
flexmock_teardown()
assert list(foo1) == [None]
assert list(foo2) == [None]
assert list(foo3) == [None]
assert Foo.__iter__ is old, f"{Foo.__iter__} != {old}"
def test_flexmock_should_mock_private_methods_with_leading_underscores(self):
class ClassWithPrivateMethods:
def __private_instance_method(self):
pass
@classmethod
def __private_class_method(cls):
pass
def instance_method(self):
return self.__private_instance_method()
@classmethod
def class_method(cls):
return cls.__private_class_method()
# Instance
instance = ClassWithPrivateMethods()
flexmock(instance).should_receive("__private_instance_method").and_return("bar")
assert instance.instance_method() == "bar"
# Class
flexmock(ClassWithPrivateMethods).should_receive("__private_class_method").and_return("baz")
assert ClassWithPrivateMethods.class_method() == "baz"
def test_flexmock_should_mock_generators(self):
class Gen:
def method(self):
pass
gen = Gen()
flexmock(gen).should_receive("method").and_yield(*range(1, 10))
output = list(gen.method())
assert list(range(1, 10)) == output
def test_flexmock_should_mock_private_methods(self):
class Foo:
def __private_method(self):
return "foo"
def public_method(self):
return self.__private_method()
instance = Foo()
flexmock(instance).should_receive("__private_method").and_return("bar")
assert instance.public_method() == "bar"
def test_flexmock_should_mock_special_methods(self):
class Foo:
def __special_method__(self):
return "foo"
def public_method(self):
return self.__special_method__()
instance = Foo()
flexmock(instance).should_receive("__special_method__").and_return("bar")
assert instance.public_method() == "bar"
def test_flexmock_should_mock_double_underscore_method(self):
class Foo:
def __(self):
return "foo"
def public_method(self):
return self.__()
instance = Foo()
flexmock(instance).should_receive("__").and_return("bar")
assert instance.public_method() == "bar"
def test_flexmock_should_mock_private_class_methods(self):
class Foo:
def __iter__(self):
pass
flexmock(Foo).should_receive("__iter__").and_yield(1, 2, 3)
assert list(Foo()) == [1, 2, 3]
def test_flexmock_doesnt_error_on_properly_ordered_expectations(self):
class Foo:
def method1(self):
pass
def method2(self, arg1):
pass
def method3(self):
pass
def method4(self):
pass
instance = Foo()
flexmock(instance).should_receive("method1")
flexmock(instance).should_receive("method2").with_args("a").ordered()
flexmock(instance).should_receive("method3")
flexmock(instance).should_receive("method2").with_args("b").ordered()
flexmock(instance).should_receive("method4")
instance.method3()
instance.method2("a")
instance.method2("b")
instance.method4()
instance.method1()
def test_flexmock_errors_on_improperly_ordered_expectations(self):
class Foo:
def method1(self, arg1):
pass
instance = Foo()
flexmock(instance)
instance.should_receive("method1").with_args("a").ordered()
instance.should_receive("method1").with_args("b").ordered()
with assert_raises(
exceptions.CallOrderError, 'method1("b") called before method1(arg1="a")'
):
instance.method1("b")
def test_flexmock_should_accept_multiple_return_values(self):
class Foo:
def method1(self):
pass
instance = Foo()
flexmock(instance).should_receive("method1").and_return(1, 5).and_return(2)
assert instance.method1() == (1, 5)
assert instance.method1() == 2
assert instance.method1() == (1, 5)
assert instance.method1() == 2
def test_flexmock_should_accept_multiple_return_values_with_shortcut(self):
class Foo:
def method1(self):
pass
instance = Foo()
flexmock(instance).should_receive("method1").and_return(1, 2).one_by_one()
assert instance.method1() == 1
assert instance.method1() == 2
assert instance.method1() == 1
assert instance.method1() == 2
def test_flexmock_should_accept_multiple_return_values_with_one_by_one(self):
mocked = flexmock()
flexmock(mocked).should_receive("method1").and_return(2).and_return(3).one_by_one()
assert mocked.method1() == 2
assert mocked.method1() == 3
assert mocked.method1() == 2
assert mocked.method1() == 3
def test_one_by_one_called_before_and_return_multiple_values(self):
mocked = flexmock()
mocked.should_receive("method1").one_by_one().and_return(3, 4)
assert mocked.method1() == 3
assert mocked.method1() == 4
assert mocked.method1() == 3
assert mocked.method1() == 4
def test_one_by_one_called_before_and_return_one_value(self):
mocked = flexmock()
mocked.should_receive("method1").one_by_one().and_return(4).and_return(5)
assert mocked.method1() == 4
assert mocked.method1() == 5
assert mocked.method1() == 4
assert mocked.method1() == 5
def test_flexmock_should_mix_multiple_return_values_with_exceptions(self):
class Foo:
def method1(self):
pass
instance = Foo()
flexmock(instance).should_receive("method1").and_return(1).and_raise(Exception)
assert instance.method1() == 1
with assert_raises(Exception, ""):
instance.method1()
assert instance.method1() == 1
with assert_raises(Exception, ""):
instance.method1()
def test_flexmock_should_mock_new_instances_with_multiple_params(self):
class User:
pass
class Group:
def __init__(self, arg, arg2):
pass
user = User()
flexmock(Group).new_instances(user)
assert user is Group(1, 2)
def test_flexmock_function_should_return_previously_mocked_object(self):
class User:
pass
user = User()
instance = flexmock(user)
assert instance == user
assert instance == flexmock(user)
def test_flexmock_should_not_return_class_object_if_mocking_instance(self):
class User:
def method(self):
pass
user = User()
user2 = User()
class_mock = flexmock(User).should_receive("method").and_return("class").mock()
user_mock = flexmock(user).should_receive("method").and_return("instance").mock()
assert class_mock is not user_mock
assert user.method() == "instance"
assert user2.method() == "class"
flexmock-0.13.0/tests/features/ordered.py 0000664 0000000 0000000 00000003446 15130526717 0020377 0 ustar 00root root 0000000 0000000 """Tests for flexmock ordered feature."""
# pylint: disable=missing-docstring,no-member
import re
from flexmock import exceptions, flexmock
from tests.utils import assert_raises
class OrderedTestCase:
def test_ordered_on_different_methods(self):
class String(str):
pass
string = String("abc")
flexmock(string)
string.should_call("startswith").with_args("asdf", 0, 4).ordered()
string.should_call("endswith").ordered()
with assert_raises(
exceptions.CallOrderError,
re.compile(
r'endswith\("c"\) called before startswith'
# Argument names are displayed in PyPy
r'\((prefix=)?"asdf", (start=)?0, (end=)?4\)'
),
):
string.endswith("c")
def test_flexmock_ordered_worked_after_default_stub(self):
mocked = flexmock()
mocked.should_receive("bar")
mocked.should_receive("bar").with_args("a").ordered()
mocked.should_receive("bar").with_args("b").ordered()
with assert_raises(exceptions.CallOrderError, 'bar("b") called before bar("a")'):
mocked.bar("b")
def test_flexmock_ordered_works_with_same_args(self):
mocked = flexmock()
mocked.should_receive("bar").ordered().and_return(1)
mocked.should_receive("bar").ordered().and_return(2)
assert mocked.bar() == 1
assert mocked.bar() == 2
def test_flexmock_ordered_works_with_same_args_after_default_stub(self):
mocked = flexmock()
mocked.should_receive("bar").and_return(9)
mocked.should_receive("bar").ordered().and_return(1)
mocked.should_receive("bar").ordered().and_return(2)
assert mocked.bar() == 1
assert mocked.bar() == 2
assert mocked.bar() == 9
flexmock-0.13.0/tests/features/proxied.py 0000664 0000000 0000000 00000016472 15130526717 0020430 0 ustar 00root root 0000000 0000000 """Tests for mocking and spying proxied objects."""
# pylint: disable=missing-docstring,no-member
from flexmock import flexmock
from tests import some_module
from tests.proxy import Proxy
from tests.some_module import DerivedClass, SomeClass
class ProxiedTestCase:
def test_mock_proxied_derived_class_with_args(self):
# pylint: disable=not-callable,invalid-name
DerivedClassProxy = Proxy(DerivedClass)
flexmock(DerivedClassProxy).should_receive("class_method_with_args").with_args(
"a"
).and_return(2).twice()
assert DerivedClassProxy().class_method_with_args("a") == 2
assert DerivedClassProxy.class_method_with_args("a") == 2
flexmock(DerivedClassProxy).should_receive("static_method_with_args").with_args(
"b"
).and_return(3).twice()
assert DerivedClassProxy().static_method_with_args("b") == 3
assert DerivedClassProxy.static_method_with_args("b") == 3
instance = DerivedClassProxy()
flexmock(instance).should_receive("instance_method_with_args").with_args("c").and_return(
4
).once()
assert instance.instance_method_with_args("c") == 4
def test_mock_proxied_module_function(self):
# pylint: disable=not-callable
some_module_proxy = Proxy(some_module)
flexmock(some_module_proxy).should_receive("module_function").and_return(3).once()
assert some_module_proxy.module_function() == 3
def test_mock_proxied_derived_class(self):
# pylint: disable=not-callable,invalid-name
DerivedClassProxy = Proxy(DerivedClass)
flexmock(DerivedClassProxy).should_receive("class_method").and_return(2).twice()
assert DerivedClassProxy().class_method() == 2
assert DerivedClassProxy.class_method() == 2
flexmock(DerivedClassProxy).should_receive("static_method").and_return(3).twice()
assert DerivedClassProxy().static_method() == 3
assert DerivedClassProxy.static_method() == 3
instance = DerivedClassProxy()
flexmock(instance).should_receive("instance_method").and_return(4).once()
assert instance.instance_method() == 4
def test_mock_proxied_class_with_args(self):
# pylint: disable=not-callable,invalid-name
SomeClassProxy = Proxy(SomeClass)
flexmock(SomeClassProxy).should_receive("class_method_with_args").with_args("a").and_return(
2
).twice()
assert SomeClassProxy().class_method_with_args("a") == 2
assert SomeClassProxy.class_method_with_args("a") == 2
flexmock(SomeClassProxy).should_receive("static_method_with_args").with_args(
"b"
).and_return(3).twice()
assert SomeClassProxy().static_method_with_args("b") == 3
assert SomeClassProxy.static_method_with_args("b") == 3
instance = SomeClassProxy()
flexmock(instance).should_receive("instance_method_with_args").with_args("c").and_return(
4
).once()
assert instance.instance_method_with_args("c") == 4
def test_mock_proxied_class(self):
# pylint: disable=not-callable,invalid-name
SomeClassProxy = Proxy(SomeClass)
flexmock(SomeClassProxy).should_receive("class_method").and_return(2).twice()
assert SomeClassProxy().class_method() == 2
assert SomeClassProxy.class_method() == 2
flexmock(SomeClassProxy).should_receive("static_method").and_return(3).twice()
assert SomeClassProxy().static_method() == 3
assert SomeClassProxy.static_method() == 3
instance = SomeClassProxy()
flexmock(instance).should_receive("instance_method").and_return(4).once()
assert instance.instance_method() == 4
def test_spy_proxied_derived_class(self):
# pylint: disable=not-callable,invalid-name
DerivedClassProxy = Proxy(DerivedClass)
flexmock(DerivedClassProxy).should_call("class_method").and_return("class_method").twice()
assert DerivedClassProxy().class_method() == "class_method"
assert DerivedClassProxy.class_method() == "class_method"
flexmock(DerivedClassProxy).should_call("static_method").and_return("static_method").twice()
assert DerivedClassProxy().static_method() == "static_method"
assert DerivedClassProxy.static_method() == "static_method"
instance = DerivedClassProxy()
flexmock(instance).should_call("instance_method").and_return("instance_method").once()
assert instance.instance_method() == "instance_method"
def test_spy_proxied_derived_class_with_args(self):
# pylint: disable=not-callable,invalid-name
DerivedClassProxy = Proxy(DerivedClass)
flexmock(DerivedClassProxy).should_call("class_method_with_args").with_args("a").and_return(
"a"
).twice()
assert DerivedClassProxy().class_method_with_args("a") == "a"
assert DerivedClassProxy.class_method_with_args("a") == "a"
flexmock(DerivedClassProxy).should_call("static_method_with_args").with_args(
"b"
).and_return("b").twice()
assert DerivedClassProxy().static_method_with_args("b") == "b"
assert DerivedClassProxy.static_method_with_args("b") == "b"
instance = DerivedClassProxy()
flexmock(instance).should_call("instance_method_with_args").with_args("c").and_return(
"c"
).once()
assert instance.instance_method_with_args("c") == "c"
def test_spy_proxied_module_function(self):
# pylint: disable=not-callable
some_module_proxy = Proxy(some_module)
flexmock(some_module_proxy).should_receive("module_function").and_return(0).once()
assert some_module_proxy.module_function(2, 2) == 0
def test_spy_proxied_class(self):
# pylint: disable=not-callable,invalid-name
SomeClassProxy = Proxy(SomeClass)
flexmock(SomeClassProxy).should_call("class_method").and_return("class_method").twice()
assert SomeClassProxy().class_method() == "class_method"
assert SomeClassProxy.class_method() == "class_method"
flexmock(SomeClassProxy).should_call("static_method").and_return("static_method").twice()
assert SomeClassProxy().static_method() == "static_method"
assert SomeClassProxy.static_method() == "static_method"
instance = SomeClassProxy()
flexmock(instance).should_call("instance_method").and_return("instance_method").once()
assert instance.instance_method() == "instance_method"
def test_spy_proxied_class_with_args(self):
# pylint: disable=not-callable,invalid-name
SomeClassProxy = Proxy(SomeClass)
flexmock(SomeClassProxy).should_call("class_method_with_args").with_args("a").and_return(
"a"
).twice()
assert SomeClassProxy().class_method_with_args("a") == "a"
assert SomeClassProxy.class_method_with_args("a") == "a"
flexmock(SomeClassProxy).should_call("static_method_with_args").with_args("b").and_return(
"b"
).twice()
assert SomeClassProxy().static_method_with_args("b") == "b"
assert SomeClassProxy.static_method_with_args("b") == "b"
instance = SomeClassProxy()
flexmock(instance).should_call("instance_method_with_args").with_args("c").and_return(
"c"
).once()
assert instance.instance_method_with_args("c") == "c"
flexmock-0.13.0/tests/features/spying.py 0000664 0000000 0000000 00000042026 15130526717 0020261 0 ustar 00root root 0000000 0000000 """Tests for flexmock spying feature."""
# pylint: disable=missing-docstring,no-member,broad-exception-raised
import re
from flexmock import exceptions, flexmock
from flexmock._api import flexmock_teardown
from tests.utils import assert_raises
class SpyingTestCase:
def test_spying_non_existent_mock_object_method_should_fail(self):
mock = flexmock()
with assert_raises(
exceptions.FlexmockError,
"Mock object does not have attribute 'method_foo'. "
'Did you mean to call should_receive("method_foo") instead?',
):
mock.should_call("method_foo")
mock = flexmock(method_foo=lambda: "ok")
mock.should_call("method_foo")
def test_pass_thru_should_call_original_method_only_once(self):
class Nyan:
def __init__(self):
self.value = 0
def method(self):
self.value += 1
obj = Nyan()
flexmock(obj)
obj.should_call("method")
obj.method()
assert obj.value == 1
def test_should_call_works_for_same_method_with_different_args(self):
class Foo:
def method(self, arg):
pass
instance = Foo()
flexmock(instance).should_call("method").with_args("foo").once()
flexmock(instance).should_call("method").with_args("bar").once()
instance.method("foo")
instance.method("bar")
flexmock_teardown()
def test_should_call_fails_properly_for_same_method_with_different_args(self):
class Foo:
def method(self, arg):
pass
instance = Foo()
flexmock(instance).should_call("method").with_args("foo").once()
flexmock(instance).should_call("method").with_args("bar").once()
instance.method("foo")
with assert_raises(
exceptions.MethodCallError,
'method(arg="bar") expected to be called exactly 1 time, called 0 times',
):
flexmock_teardown()
def test_should_call_alias_should_create_a_spy(self):
class Foo:
def get_stuff(self):
return "yay"
instance = Foo()
flexmock(instance).should_call("get_stuff").and_return("yay").once()
with assert_raises(
exceptions.MethodCallError,
"get_stuff() expected to be called exactly 1 time, called 0 times",
):
flexmock_teardown()
def test_spy_should_not_match_falsy_stuff(self):
class Foo:
def method1(self):
return None
def method2(self):
return False
def method3(self):
return []
def method4(self):
return ""
instance = Foo()
flexmock(instance).should_call("method1").and_return("bar").once()
flexmock(instance).should_call("method2").and_return("bar").once()
flexmock(instance).should_call("method3").and_return("bar").once()
flexmock(instance).should_call("method4").and_return("bar").once()
with assert_raises(
exceptions.FlexmockError,
(
"Returned values for call method1 did not match expectation:\n"
" Expected:\t'bar'\n"
" Returned:\tNone"
),
):
instance.method1()
with assert_raises(
exceptions.FlexmockError,
(
"Returned values for call method2 did not match expectation:\n"
" Expected:\t'bar'\n"
" Returned:\tFalse"
),
):
instance.method2()
with assert_raises(
exceptions.FlexmockError,
(
"Returned values for call method3 did not match expectation:\n"
" Expected:\t'bar'\n"
" Returned:\t[]"
),
):
instance.method3()
with assert_raises(
exceptions.FlexmockError,
(
"Returned values for call method4 did not match expectation:\n"
" Expected:\t'bar'\n"
" Returned:\t''"
),
):
instance.method4()
def test_spy_should_match_return_value_class(self):
class User:
pass
user = User()
instance = flexmock(
foo=lambda: ("bar", "baz"),
bar=lambda: user,
baz=lambda: None,
bax=lambda: None,
)
instance.should_call("foo").and_return(str, str)
instance.should_call("bar").and_return(User)
instance.should_call("baz").and_return(object)
instance.should_call("bax").and_return(None)
assert instance.foo() == ("bar", "baz")
assert instance.bar() == user
assert instance.baz() is None
assert instance.bax() is None
def test_flexmock_spy_should_not_clobber_original_method(self):
class User:
def get_stuff(self):
return "real", "stuff"
user = User()
flexmock(user).should_call("get_stuff")
flexmock(user).should_call("get_stuff")
assert user.get_stuff() == ("real", "stuff")
def test_and_raise_with_value_that_is_not_a_class(self):
class RaisesException:
def get_stuff(self):
raise RuntimeError("baz")
instance = RaisesException()
flexmock(instance).should_call("get_stuff").and_raise(RuntimeError("foo")).once()
with assert_raises(
exceptions.ExceptionClassError,
re.compile(
r"Raised exception for call get_stuff did not match expectation:\n"
# Python 3.6 contains comma after 'foo'
r" Expected:\tRuntimeError\('foo',?\)\n"
r" Raised:\t\n\n"
r"Did you try to call and_raise with an instance\?\n"
r'Instead of and_raise\(Exception\("arg"\)\), try and_raise\(Exception, "arg"\)',
),
):
instance.get_stuff()
def test_flexmock_should_blow_up_on_wrong_spy_return_values(self):
class User:
def get_stuff(self):
return "real", "stuff"
def get_more_stuff(self):
return "other", "stuff"
user = User()
flexmock(user).should_call("get_stuff").and_return("other", "stuff")
with assert_raises(
exceptions.MethodSignatureError,
(
"Returned values for call get_stuff did not match expectation:\n"
" Expected:\t('other', 'stuff')\n"
" Returned:\t('real', 'stuff')"
),
):
user.get_stuff()
flexmock(user).should_call("get_more_stuff").and_return()
with assert_raises(
exceptions.MethodSignatureError,
(
"Returned values for call get_more_stuff did not match expectation:\n"
" Expected:\tNone\n"
" Returned:\t('other', 'stuff')"
),
):
user.get_more_stuff()
def test_flexmock_should_reraise_exception_in_spy_with_return_values(self):
class RaisesException:
@classmethod
def class_method(cls):
raise RuntimeError("foo")
@staticmethod
def static_method():
raise RuntimeError("bar")
def instance_method(self):
raise RuntimeError("baz")
instance = RaisesException()
flexmock(instance).should_call("class_method").and_return("foo").once()
flexmock(instance).should_call("static_method").and_return("bar").once()
flexmock(instance).should_call("instance_method").and_return("baz").once()
with assert_raises(RuntimeError, "foo"):
instance.class_method()
with assert_raises(RuntimeError, "bar"):
instance.static_method()
with assert_raises(RuntimeError, "baz"):
instance.instance_method()
flexmock(RaisesException).should_call("class_method").once()
flexmock(RaisesException).should_call("static_method").once()
with assert_raises(RuntimeError, "foo"):
RaisesException.class_method()
with assert_raises(RuntimeError, "bar"):
RaisesException.static_method()
def test_flexmock_should_reraise_exception_in_spy(self):
class RaisesException:
@classmethod
def class_method(cls):
raise RuntimeError("foo")
@staticmethod
def static_method():
raise RuntimeError("bar")
def instance_method(self):
raise RuntimeError("baz")
instance = RaisesException()
flexmock(instance).should_call("class_method").once()
flexmock(instance).should_call("static_method").once()
flexmock(instance).should_call("instance_method").once()
with assert_raises(RuntimeError, "foo"):
instance.class_method()
with assert_raises(RuntimeError, "bar"):
instance.static_method()
with assert_raises(RuntimeError, "baz"):
instance.instance_method()
flexmock(RaisesException).should_call("class_method").once()
flexmock(RaisesException).should_call("static_method").once()
with assert_raises(RuntimeError, "foo"):
RaisesException.class_method()
with assert_raises(RuntimeError, "bar"):
RaisesException.static_method()
def test_flexmock_should_verify_correct_spy_return_values(self):
class User:
def get_stuff(self):
return "real", "stuff"
user = User()
flexmock(user).should_call("get_stuff").and_return("real", "stuff")
assert user.get_stuff() == ("real", "stuff")
def test_flexmock_should_verify_correct_spy_regexp_return_values(self):
class User:
def get_stuff(self):
return "real", "stuff"
user = User()
flexmock(user).should_call("get_stuff").and_return(
re.compile("ea.*"), re.compile("^stuff$")
)
assert user.get_stuff() == ("real", "stuff")
def test_flexmock_should_verify_spy_raises_correct_exception_class(self):
class FakeException(Exception):
def __init__(self, param, param2):
self.message = f"{param}, {param2}"
Exception.__init__(self)
class User:
def get_stuff(self):
raise FakeException(1, 2)
user = User()
flexmock(user).should_call("get_stuff").and_raise(FakeException, 1, 2)
user.get_stuff()
def test_flexmock_should_verify_spy_matches_exception_message(self):
class FakeException(Exception):
def __init__(self, param1, param2):
self.param1 = param1
self.param2 = param2
Exception.__init__(self, param1)
def __str__(self):
return f"{self.param1}, {self.param2}"
class User:
def get_stuff(self):
raise FakeException("1", "2")
user = User()
flexmock(user).should_call("get_stuff").and_raise(FakeException, "2", "1")
with assert_raises(
exceptions.ExceptionMessageError,
(
"Error message mismatch with raised FakeException:\n"
" Expected message:\n\t'1, 2'\n"
" Received message:\n\t'2, 1'"
),
):
user.get_stuff()
def test_flexmock_should_verify_spy_matches_exception_regexp(self):
class User:
def get_stuff(self):
raise Exception("123asdf345")
user = User()
flexmock(user).should_call("get_stuff").and_raise(Exception, re.compile("asdf"))
user.get_stuff()
flexmock_teardown()
def test_flexmock_should_verify_spy_matches_exception_regexp_mismatch(self):
class User:
def get_stuff(self):
raise Exception("123asdf345")
user = User()
flexmock(user).should_call("get_stuff").and_raise(Exception, re.compile("^asdf"))
with assert_raises(
exceptions.ExceptionMessageError,
(
"Error message mismatch with raised Exception:\n"
" Expected pattern:\n\t/^asdf/\n"
" Received message:\n\t'123asdf345'"
),
):
user.get_stuff()
def test_flexmock_should_blow_up_on_wrong_spy_exception_type(self):
class User:
def get_stuff(self):
raise exceptions.CallOrderError("foo")
user = User()
flexmock(user).should_call("get_stuff").and_raise(exceptions.MethodCallError)
with assert_raises(
exceptions.ExceptionClassError,
(
"Raised exception for call get_stuff did not match expectation:\n"
" Expected:\t\n"
" Raised:\t"
),
):
user.get_stuff()
def test_flexmock_should_match_spy_exception_parent_type(self):
class User:
def get_stuff(self):
raise exceptions.CallOrderError("foo")
user = User()
flexmock(user).should_call("get_stuff").and_raise(exceptions.FlexmockError)
user.get_stuff()
def test_flexmock_should_call_respects_matched_expectations(self):
class Group:
def method1(self, arg1, arg2="b"):
return f"{arg1}:{arg2}"
def method2(self, arg):
return arg
group = Group()
flexmock(group).should_call("method1").twice()
assert group.method1("a", arg2="c") == "a:c"
assert group.method1("a") == "a:b"
group.should_call("method2").once().with_args("c")
assert group.method2("c") == "c"
flexmock_teardown()
def test_flexmock_should_call_respects_unmatched_expectations(self):
class Group:
def method1(self, arg1, arg2="b"):
return f"{arg1}:{arg2}"
def method2(self, arg1):
pass
group = Group()
flexmock(group).should_call("method1").at_least().once()
with assert_raises(
exceptions.MethodCallError,
"method1() expected to be called at least 1 time, called 0 times",
):
flexmock_teardown()
flexmock(group)
group.should_call("method2").with_args("a").once()
group.should_receive("method2").with_args("not a")
group.method2("not a")
with assert_raises(
exceptions.MethodCallError,
'method2(arg1="a") expected to be called exactly 1 time, called 0 times',
):
flexmock_teardown()
def test_flexmock_should_not_blow_up_on_should_call_for_class_methods(self):
class User:
@classmethod
def method(cls):
return "class"
flexmock(User).should_call("method")
assert User.method() == "class"
def test_flexmock_should_not_blow_up_on_should_call_for_static_methods(self):
class User:
@staticmethod
def method():
return "static"
flexmock(User).should_call("method")
assert User.method() == "static"
def test_should_call_with_class_default_attributes(self):
"""Flexmock should not allow mocking class default attributes like
__call__ on an instance.
"""
class WithCall:
def __call__(self, arg1):
return arg1
instance = WithCall()
with assert_raises(
exceptions.FlexmockError,
re.compile(r".+\.WithCall object at 0x.+> does not have attribute '__call__'"),
):
flexmock(instance).should_call("__call__")
def test_should_call_on_class_mock(self):
class User:
def __init__(self):
self.value = "value"
def method1(self):
return "class"
def method2(self):
return self.value
# Access class-level method
user1 = User()
user2 = User()
flexmock(User).should_call("method1").once()
with assert_raises(
exceptions.MethodCallError,
"method1() expected to be called exactly 1 time, called 0 times",
):
flexmock_teardown()
flexmock(User).should_call("method1").twice()
assert user1.method1() == "class"
assert user2.method1() == "class"
# Access instance attributes
flexmock(User).should_call("method2").once()
with assert_raises(
exceptions.MethodCallError,
"method2() expected to be called exactly 1 time, called 0 times",
):
flexmock_teardown()
flexmock(User).should_call("method2").twice()
assert user1.method2() == "value"
assert user2.method2() == "value"
# Try resetting the expectation
flexmock(User).should_call("method2").once()
assert user1.method2() == "value"
flexmock-0.13.0/tests/features/stubbing.py 0000664 0000000 0000000 00000003752 15130526717 0020570 0 ustar 00root root 0000000 0000000 """Tests for flexmock stubbing feature."""
# pylint: disable=missing-docstring,no-member
from flexmock import flexmock
from flexmock._api import flexmock_teardown
from tests import some_module
class StubbingTestCase:
def test_use_replace_with_for_callable_shortcut_kwargs(self):
class Foo:
def method(self):
return "bar"
instance = Foo()
flexmock(instance, method=lambda: "baz")
assert instance.method() == "baz"
def test_should_replace_attributes_that_are_instances_of_classes(self):
class Class1:
pass
class Class2:
class1 = Class1()
class2 = Class2()
flexmock(class2, class1="test")
assert class2.class1 == "test"
def test_replace_non_callable_instance_attributes(self):
class FooClass:
def __init__(self):
self.attribute = 1
instance1 = FooClass()
instance2 = FooClass()
flexmock(instance1, attribute=2)
flexmock(instance2, attribute=1)
assert instance1.attribute == 2
flexmock_teardown()
assert instance1.attribute == 1
def test_replace_non_callable_module_attributes(self):
flexmock(some_module, MODULE_LEVEL_ATTRIBUTE="yay")
assert some_module.MODULE_LEVEL_ATTRIBUTE == "yay"
flexmock_teardown()
assert some_module.MODULE_LEVEL_ATTRIBUTE == "test"
def test_replace_non_callable_class_attributes(self):
class FooClass:
attribute = 1
instance1 = FooClass()
instance2 = FooClass()
flexmock(instance1, attribute=2)
assert instance1.attribute == 2
assert instance2.attribute == 1
flexmock_teardown()
assert instance1.attribute == 1
def test_fake_object_takes_properties(self):
fake1 = flexmock(bar=property(lambda self: "baz"))
fake2 = flexmock(foo=property(lambda self: "baz"))
assert fake1.bar == "baz"
assert fake2.foo == "baz"
flexmock-0.13.0/tests/features/teardown.py 0000664 0000000 0000000 00000014227 15130526717 0020575 0 ustar 00root root 0000000 0000000 """Tests for flexmock teardown."""
# pylint: disable=missing-docstring,no-member
from flexmock import exceptions, flexmock
from flexmock._api import UPDATED_ATTRS, flexmock_teardown
from tests import some_module
from tests.utils import assert_raises
class TeardownTestCase:
def test_flexmock_should_properly_restore_static_methods(self):
class User:
@staticmethod
def get_stuff():
return "ok!"
assert isinstance(User.__dict__["get_stuff"], staticmethod)
assert User.get_stuff() == "ok!"
flexmock(User).should_receive("get_stuff")
assert User.get_stuff() is None
flexmock_teardown()
assert User.get_stuff() == "ok!"
assert isinstance(User.__dict__["get_stuff"], staticmethod)
def test_flexmock_should_properly_restore_undecorated_static_methods(self):
class User:
def get_stuff():
return "ok!"
get_stuff = staticmethod(get_stuff) # pylint: disable=no-staticmethod-decorator
assert User.get_stuff() == "ok!"
flexmock(User).should_receive("get_stuff")
assert User.get_stuff() is None
flexmock_teardown()
assert User.get_stuff() == "ok!"
def test_flexmock_should_properly_restore_module_level_functions(self):
flexmock(some_module).should_receive("module_function").with_args(1, 2)
assert some_module.module_function(1, 2) is None
flexmock_teardown()
assert some_module.module_function(1, 2) == -1
def test_flexmock_should_revert_new_instances_on_teardown(self):
class User:
pass
class Group:
pass
user = User()
group = Group()
flexmock(Group).new_instances(user)
assert user is Group()
flexmock_teardown()
assert group.__class__ is Group().__class__
def test_flexmock_should_cleanup_added_methods_and_attributes(self):
class Group:
pass
group = Group()
flexmock(Group)
assert "should_receive" in Group.__dict__
assert "should_receive" not in group.__dict__
flexmock(group)
assert "should_receive" in group.__dict__
flexmock_teardown()
for method in UPDATED_ATTRS:
assert method not in Group.__dict__
assert method not in group.__dict__
def test_class_attributes_are_unchanged_after_mocking(self):
class Base:
@classmethod
def class_method(cls):
pass
@staticmethod
def static_method():
pass
def instance_method(self):
pass
class Child(Base):
pass
instance = Base()
base_attrs = list(vars(Base).keys())
instance_attrs = list(vars(instance).keys())
child_attrs = list(vars(Child).keys())
flexmock(Base).should_receive("class_method").once()
flexmock(Base).should_receive("static_method").once()
Base.class_method()
Base.static_method()
flexmock(instance).should_receive("class_method").once()
flexmock(instance).should_receive("static_method").once()
flexmock(instance).should_receive("instance_method").once()
instance.class_method()
instance.static_method()
instance.instance_method()
flexmock(Child).should_receive("class_method").once()
flexmock(Child).should_receive("static_method").once()
Child.class_method()
Child.static_method()
flexmock_teardown()
assert base_attrs == list(vars(Base).keys())
assert instance_attrs == list(vars(instance).keys())
assert child_attrs == list(vars(Child).keys())
def test_class_attributes_are_unchanged_after_spying(self):
class Base:
@classmethod
def class_method(cls):
pass
@staticmethod
def static_method():
pass
def instance_method(self):
pass
class Child(Base):
pass
instance = Base()
base_attrs = list(vars(Base).keys())
instance_attrs = list(vars(instance).keys())
child_attrs = list(vars(Child).keys())
flexmock(Base).should_call("class_method").times(3) # TODO: should be once #80
flexmock(Base).should_call("static_method").times(3) # TODO: should be once #80
Base.class_method()
Base.static_method()
flexmock(instance).should_call("class_method").once()
flexmock(instance).should_call("static_method").once()
flexmock(instance).should_call("instance_method").once()
instance.class_method()
instance.static_method()
instance.instance_method()
flexmock(Child).should_call("class_method").once()
flexmock(Child).should_call("static_method").once()
Child.class_method()
Child.static_method()
flexmock_teardown()
assert base_attrs == list(vars(Base).keys())
assert instance_attrs == list(vars(instance).keys())
assert child_attrs == list(vars(Child).keys())
def test_flexmock_should_cleanup_after_exception(self):
class User:
def method2(self):
pass
class Group:
def method1(self):
pass
flexmock(Group)
flexmock(User)
Group.should_receive("method1").once()
User.should_receive("method2").once()
with assert_raises(
exceptions.MethodCallError,
"method1() expected to be called exactly 1 time, called 0 times",
):
flexmock_teardown()
for method in UPDATED_ATTRS:
assert method not in dir(Group)
for method in UPDATED_ATTRS:
assert method not in dir(User)
def test_flexmock_teardown_called_between_tests_part1(self):
flexmock().should_receive("method1").ordered()
def test_flexmock_teardown_called_between_tests_part2(self):
mock = flexmock().should_receive("method2").ordered().mock()
# Raises CallOrderError if flexmock teardown is not automatically called
# after test part 1 above
mock.method2()
flexmock-0.13.0/tests/proxy.py 0000664 0000000 0000000 00000007253 15130526717 0016316 0 ustar 00root root 0000000 0000000 """Proxy class for testing proxied objects."""
class Proxy:
"""Proxy to another object."""
# OBJECT PROXYING (PYTHON RECIPE)
# https://code.activestate.com/recipes/496741-object-proxying/
def __init__(self, obj):
object.__setattr__(self, "_obj", obj)
def __getattribute__(self, name):
return getattr(object.__getattribute__(self, "_obj"), name)
def __delattr__(self, name):
delattr(object.__getattribute__(self, "_obj"), name)
def __setattr__(self, name, value):
setattr(object.__getattribute__(self, "_obj"), name, value)
def __nonzero__(self):
return bool(object.__getattribute__(self, "_obj"))
def __str__(self):
return str(object.__getattribute__(self, "_obj"))
def __repr__(self):
return repr(object.__getattribute__(self, "_obj"))
_special_names = [
"__abs__",
"__add__",
"__and__",
"__call__",
"__cmp__",
"__coerce__",
"__contains__",
"__delitem__",
"__delslice__",
"__div__",
"__divmod__",
"__eq__",
"__float__",
"__floordiv__",
"__ge__",
"__getitem__",
"__getslice__",
"__gt__",
"__hash__",
"__hex__",
"__iadd__",
"__iand__",
"__idiv__",
"__idivmod__",
"__ifloordiv__",
"__ilshift__",
"__imod__",
"__imul__",
"__int__",
"__invert__",
"__ior__",
"__ipow__",
"__irshift__",
"__isub__",
"__iter__",
"__itruediv__",
"__ixor__",
"__le__",
"__len__",
"__long__",
"__lshift__",
"__lt__",
"__mod__",
"__mul__",
"__ne__",
"__neg__",
"__oct__",
"__or__",
"__pos__",
"__pow__",
"__radd__",
"__rand__",
"__rdiv__",
"__rdivmod__",
"__reduce__",
"__reduce_ex__",
"__repr__",
"__reversed__",
"__rfloorfiv__",
"__rlshift__",
"__rmod__",
"__rmul__",
"__ror__",
"__rpow__",
"__rrshift__",
"__rshift__",
"__rsub__",
"__rtruediv__",
"__rxor__",
"__setitem__",
"__setslice__",
"__sub__",
"__truediv__",
"__xor__",
"next",
]
@classmethod
def _create_class_proxy(cls, theclass):
"""Creates a proxy for the given class."""
def make_method(name):
def method(self, *args, **kw):
return getattr(object.__getattribute__(self, "_obj"), name)(*args, **kw)
return method
namespace = {}
for name in cls._special_names:
if hasattr(theclass, name):
namespace[name] = make_method(name)
return type(f"{cls.__name__}({theclass.__name__})", (cls,), namespace)
def __new__(cls, obj, *args, **kwargs):
"""Creates an proxy instance referencing `obj`.
(obj, *args, **kwargs) are passed to this class' __init__, so deriving
classes can define an __init__ method of their own.
note: _class_proxy_cache is unique per deriving class (each deriving
class must hold its own cache)
"""
try:
cache = cls.__dict__["_class_proxy_cache"]
except KeyError:
cls._class_proxy_cache = cache = {}
try:
theclass = cache[obj.__class__]
except KeyError:
cache[obj.__class__] = theclass = cls._create_class_proxy(obj.__class__)
ins = object.__new__(theclass)
theclass.__init__(ins, obj, *args, **kwargs)
return ins
flexmock-0.13.0/tests/some_module.py 0000664 0000000 0000000 00000002033 15130526717 0017434 0 ustar 00root root 0000000 0000000 """Bogus module for testing."""
# pylint: disable=missing-docstring,disallowed-name,invalid-name
MODULE_LEVEL_ATTRIBUTE = "test"
class SomeClass:
CLASS_VALUE = "class_method"
def __init__(self):
self.instance_value = "instance_method"
@classmethod
def class_method(cls):
return cls.CLASS_VALUE
@classmethod
def class_method_with_args(cls, a):
return a
@staticmethod
def static_method():
return "static_method"
@staticmethod
def static_method_with_args(a):
return a
def instance_method(self):
return self.instance_value
def instance_method_with_args(self, a):
return a
class DerivedClass(SomeClass):
pass
class ModuleClass:
def __init__(self, x, y):
self.x = x
self.y = y
def a(self):
return self.x + self.y
def module_function(x, y):
return x - y
def kwargs_only_func1(foo, *, bar, baz=5):
return foo + bar + baz
def kwargs_only_func2(foo, *, bar, baz):
return foo + bar + baz
flexmock-0.13.0/tests/test_doctest.py 0000664 0000000 0000000 00000004122 15130526717 0017631 0 ustar 00root root 0000000 0000000 """Test doctest integration and flexmock API examples."""
# pylint: disable=missing-docstring
import doctest
import sys
from flexmock import _api
class Plane:
model = "Airpy 1"
is_flying = True
def __init__(self):
self.speed = 3
self.direction = None
self.destination = None
self.passengers = ["user1", "user2", "user3"]
def pilot(self):
return self.passengers[0]
def fly(self, direction="up", destination="Helsinki"):
self.direction = direction
self.destination = destination
def land(self):
return None
def set_speed(self, speed):
self.speed = speed
def repair(self, part):
del part
def crash(self):
return None
def flight_log(self):
yield from ["land", "repair"]
def passenger_count(self):
return len(self.passengers)
class BadWeatherException(Exception):
pass
class TestDoctestTeardown:
"""Test doctest runner teardown."""
def test_flexmock_teardown_works_with_doctest_part_1(self):
"""Part 1
Examples:
Part 1:
>>> from flexmock import flexmock
>>> flexmock().should_receive("method1").ordered()
"""
def test_flexmock_teardown_works_with_doctest_part_2(self):
"""Raises CallOrderError if flexmock teardown is not automatically called
after test part 1 above.
Examples:
Part 2:
>>> from flexmock import flexmock
>>> mock = flexmock().should_receive("method2").ordered().mock()
>>> mock.method2()
"""
if __name__ == "__main__":
results1 = doctest.testmod(
sys.modules[__name__], # current module
optionflags=doctest.ELLIPSIS,
)
results2 = doctest.testmod(
_api,
extraglobs={
"Plane": Plane,
"plane": Plane(),
"BadWeatherException": BadWeatherException,
},
optionflags=doctest.ELLIPSIS,
)
sys.exit(bool(results1.failed + results2.failed))
flexmock-0.13.0/tests/test_generic_integration.py 0000664 0000000 0000000 00000000353 15130526717 0022205 0 ustar 00root root 0000000 0000000 """Test integrations that work with unittest testcases."""
# pylint: disable=missing-docstring
import unittest
from tests.features import FlexmockTestCase
class TestGenericIntegration(FlexmockTestCase, unittest.TestCase):
pass
flexmock-0.13.0/tests/test_pytest.py 0000664 0000000 0000000 00000005143 15130526717 0017520 0 ustar 00root root 0000000 0000000 """Test flexmock with pytest."""
# pylint: disable=missing-docstring,redefined-outer-name
import unittest
import pytest
from flexmock import flexmock
from flexmock._api import flexmock_teardown
from flexmock.exceptions import MethodCallError
from tests.features import FlexmockTestCase
from tests.utils import assert_raises
def test_module_level_test_for_pytest():
flexmock(foo="bar").should_receive("foo").once()
with assert_raises(
MethodCallError, "foo() expected to be called exactly 1 time, called 0 times"
):
flexmock_teardown()
@pytest.fixture()
def runtest_hook_fixture():
return flexmock(foo="bar").should_receive("foo").once().mock()
def test_runtest_hook_with_fixture_for_pytest(runtest_hook_fixture):
runtest_hook_fixture.foo()
def test_flexmock_teardown_works_with_pytest_part1():
flexmock().should_receive("method1").ordered()
def test_flexmock_teardown_works_with_pytest_part2():
mock = flexmock().should_receive("method2").ordered().mock()
# Raises CallOrderError if flexmock teardown is not automatically called
# after test part 1 above
mock.method2()
class TestForPytest(FlexmockTestCase):
def test_class_level_test_for_pytest(self):
flexmock(foo="bar").should_receive("foo").once()
with assert_raises(
MethodCallError, "foo() expected to be called exactly 1 time, called 0 times"
):
flexmock_teardown()
class TestUnittestClass(unittest.TestCase):
def test_unittest(self):
mocked = flexmock(a=2)
mocked.should_receive("a").once()
with assert_raises(
MethodCallError, "a() expected to be called exactly 1 time, called 0 times"
):
flexmock_teardown()
class TestFailureOnException:
def _setup_failing_expectation(self):
flexmock(foo="bar").should_receive("foo").once()
# Use xfail to ensure we process exceptions as returned by _hook_into_pytest
@pytest.mark.xfail(raises=RuntimeError)
def test_exception(self):
raise RuntimeError("TEST ERROR")
@pytest.mark.xfail(raises=MethodCallError)
def test_flexmock_raises_if_no_exception(self):
self._setup_failing_expectation()
@pytest.mark.xfail(raises=RuntimeError)
def test_flexmock_doesnt_override_existing_exception(self):
self._setup_failing_expectation()
raise RuntimeError("Flexmock shouldn't suppress this exception")
@pytest.mark.xfail(raises=AssertionError)
def test_flexmock_doesnt_override_assertion(self):
self._setup_failing_expectation()
assert False, "Flexmock shouldn't suppress this assertion"
flexmock-0.13.0/tests/test_teamcity.py 0000664 0000000 0000000 00000000664 15130526717 0020012 0 ustar 00root root 0000000 0000000 """Test TeamCity (PyCharm) integration."""
# pylint: disable=missing-docstring
import unittest
from teamcity.unittestpy import TeamcityTestRunner
from tests.features import FlexmockTestCase
class TestTeamCityTeardown(FlexmockTestCase, unittest.TestCase):
"""Test flexmock teardown works with TeamCity test runner (PyCharm)."""
if __name__ == "__main__":
runner = TeamcityTestRunner()
unittest.main(testRunner=runner)
flexmock-0.13.0/tests/test_testtools.py 0000664 0000000 0000000 00000000325 15130526717 0020225 0 ustar 00root root 0000000 0000000 """Test testtools integration."""
# pylint: disable=missing-docstring
import testtools
from tests.features import FlexmockTestCase
class TestTestoolsIntegration(FlexmockTestCase, testtools.TestCase):
pass
flexmock-0.13.0/tests/test_unittest.py 0000664 0000000 0000000 00000001547 15130526717 0020053 0 ustar 00root root 0000000 0000000 """Test unittest integration."""
# pylint: disable=missing-docstring
import sys
import unittest
from flexmock import flexmock
from tests.features import FlexmockTestCase
class TestUnitTestIntegration(FlexmockTestCase, unittest.TestCase):
"""Flexmock unittest integration specific tests."""
def test_failed_test_case(self):
"""This tests that after a successful tests, failing flexmock assertions
will change the test result from successful to failed.
"""
flexmock().should_receive("this_test_should_fail").once()
if __name__ == "__main__":
EXPECTED_FAILURES = 1
test = unittest.main(exit=False)
if (
len(test.result.failures) == EXPECTED_FAILURES
# Make sure that inherited tests are executed
and test.result.testsRun > EXPECTED_FAILURES
):
sys.exit(0) # OK
sys.exit(1)
flexmock-0.13.0/tests/utils.py 0000664 0000000 0000000 00000002627 15130526717 0016275 0 ustar 00root root 0000000 0000000 """Utility functions for testing."""
import re
from contextlib import contextmanager
@contextmanager
def assert_raises(expected_exception: type[BaseException], match: re.Pattern | str | None):
"""Assert that code raises the correct exception with a correct error message.
Args:
expected_exception: Type of the expected exception.
match: String or pattern to match the error message against. Use None
to skip error message checking.
"""
try:
yield
except Exception as raised_exception:
if not isinstance(raised_exception, expected_exception):
raise AssertionError(
f"Expected exception '{type(expected_exception)}' "
f"but '{type(raised_exception)}' was raised"
) from raised_exception
if match is not None:
fail = False
if isinstance(match, re.Pattern):
fail = not match.search(str(raised_exception))
match = match.pattern
else:
fail = str(raised_exception) != str(match)
if fail:
raise AssertionError(
f"Expected error message:\n{'-'*39}\n'{str(match)}'\n"
f"\nBut got:\n\n'{str(raised_exception)}'\n{'-'*39}\n"
) from raised_exception
else:
raise AssertionError(f"Exception '{expected_exception.__name__}' not raised")
flexmock-0.13.0/tox.ini 0000664 0000000 0000000 00000002133 15130526717 0014724 0 ustar 00root root 0000000 0000000 [tox]
isolated_build = True
envlist =
pypy{3.10,3.11}-pytest-latest
py310-pytest{6,7,8,9}
py{311, 312}-pytest{7,8,9}
py313-pytest{8,9}
py314-pytest-latest
[gh-actions]
python =
pypy-3.10: pypy3.10
pypy-3.11: pypy3.11
3.10: py310
3.11: py311
3.12: py312
3.13: py313
3.14: py314
[testenv]
deps =
pytest6: pytest>=6.0,<7.0
pytest7: pytest>=7.0,<8.0
pytest8: pytest>=8.0,<9.0
pytest9: pytest>=9.0,<10.0
pytest-latest: pytest
twisted
zope.testrunner
testtools
python-subunit
teamcity-messages
setenv = PYTHONPATH={toxinidir}
allowlist_externals = sh
commands =
python tests/test_unittest.py
python tests/test_doctest.py
python -c "from twisted.scripts.trial import run; run();" tests/test_generic_integration.py
zope-testrunner --test-path=./ --test-file-pattern=test_generic_integration --verbose
python -m testtools.run --verbose tests/test_testtools.py
sh -c 'python -m subunit.run tests/test_generic_integration.py | subunit2pyunit'
python tests/test_teamcity.py
pytest tests/test_pytest.py