pynguin 0.43.0__tar.gz → 0.45.0__tar.gz

pynguin-0.45.0/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.3
+Name: pynguin
+Version: 0.45.0
+Summary: Pynguin is a tool for automated unit test generation for Python
+License: MIT
+Keywords: unit test,random testing,search based,test generation
+Author: Stephan Lukasczyk
+Author-email: stephan@pynguin.eu
+Requires-Python: >=3.10,<3.15
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Education :: Testing
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Testing :: Unit
+Classifier: Typing :: Typed
+Provides-Extra: fandango-faker
+Provides-Extra: numpy
+Provides-Extra: openai
+Provides-Extra: typing
+Requires-Dist: Jinja2 (>=3.1.6,<4.0.0)
+Requires-Dist: Pygments (>=2.19.2,<3.0.0)
+Requires-Dist: asciitree (>=0.3.3,<0.4.0)
+Requires-Dist: astroid (>=4.0.1,<5.0.0)
+Requires-Dist: black (>=25.1.0,<26.0.0)
+Requires-Dist: bytecode (==0.17.0)
+Requires-Dist: dill (>=0.4.0,<0.5.0)
+Requires-Dist: faker (>=37.3.0,<38.0.0) ; extra == "fandango-faker"
+Requires-Dist: fandango-fuzzer (>=0.8.2,<0.9.0) ; extra == "fandango-faker"
+Requires-Dist: libcst (>=1.7.0,<2.0.0)
+Requires-Dist: multiprocess (>=0.70.18,<0.71.0)
+Requires-Dist: mypy (>=1.15.0,<2.0.0) ; extra == "typing"
+Requires-Dist: networkx (>=3.4.2,<4.0.0)
+Requires-Dist: numpy (>=1.26.4,<2.0.0) ; extra == "numpy"
+Requires-Dist: openai (>=1.72.0,<2.0.0) ; extra == "openai"
+Requires-Dist: psutil (>=7.1.1,<8.0.0)
+Requires-Dist: pytest (>=8.3.5,<9.0.0)
+Requires-Dist: python-dotenv (>=1.0.0,<2.0.0) ; extra == "openai"
+Requires-Dist: rich (>=14.0.0,<15.0.0)
+Requires-Dist: rstr (>=3.2.2,<4.0.0)
+Requires-Dist: setuptools (>=80.9.0,<81.0.0)
+Requires-Dist: simple-parsing (>=0.1.7,<0.2.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Requires-Dist: typing-extensions (>=4.12.2,<5.0.0) ; extra == "typing"
+Requires-Dist: typing_inspect (>=0.9.0,<0.10.0)
+Requires-Dist: xmltodict (>=0.14.2,<0.15.0) ; extra == "fandango-faker"
+Project-URL: Documentation, https://pynguin.readthedocs.io
+Project-URL: Homepage, https://www.pynguin.eu
+Project-URL: Repository, https://github.com/se2p/pynguin
+Description-Content-Type: text/markdown
+
+<!--
+SPDX-FileCopyrightText: 2019–2026 Pynguin Contributors
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+# Pynguin
+
+Pynguin (IPA: ˈpɪŋɡuiːn),
+the
+PYthoN
+General
+UnIt
+test
+geNerator,
+is a tool that allows developers to generate unit tests automatically.
+
+Testing software is often considered to be a tedious task.
+Thus, automated generation techniques have been proposed and mature tools exist—for
+statically typed languages, such as Java.
+There is, however, no fully-automated tool available that produces unit tests for
+general-purpose programs in a dynamically typed language.
+Pynguin is, to the best of our knowledge, the first tool that fills this gap
+and allows the automated generation of unit tests for Python programs.
+
+<details>
+<summary>Internal Pipeline Status</summary>
+
+[![pipeline status](https://gitlab.infosun.fim.uni-passau.de/se2/pynguin/pynguin/badges/main/pipeline.svg)](https://gitlab.infosun.fim.uni-passau.de/se2/pynguin/pynguin/-/commits/main)
+[![coverage report](https://gitlab.infosun.fim.uni-passau.de/se2/pynguin/pynguin/badges/main/coverage.svg)](https://gitlab.infosun.fim.uni-passau.de/se2/pynguin/pynguin/-/commits/main)
+
+</details>
+
+[![License MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![PyPI version](https://badge.fury.io/py/pynguin.svg)](https://badge.fury.io/py/pynguin)
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/pynguin.svg)](https://github.com/se2p/pynguin)
+[![Documentation Status](https://readthedocs.org/projects/pynguin/badge/?version=latest)](https://pynguin.readthedocs.io/)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3989840.svg)](https://doi.org/10.5281/zenodo.3989840)
+[![REUSE status](https://api.reuse.software/badge/github.com/se2p/pynguin)](https://api.reuse.software/info/github.com/se2p/pynguin)
+[![Downloads](https://static.pepy.tech/personalized-badge/pynguin?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/pynguin)
+[![SWH](https://archive.softwareheritage.org/badge/origin/https://github.com/se2p/pynguin/)](https://archive.softwareheritage.org/browse/origin/?origin_url=https://github.com/se2p/pynguin)
+
+
+![Pynguin Logo](https://raw.githubusercontent.com/se2p/pynguin/master/docs/source/_static/pynguin-logo.png "Pynguin Logo")
+
+## Attention
+
+*Please Note:*
+
+**Pynguin executes the module under test!**
+As a consequence, depending on what code is in that module,
+running Pynguin can cause serious harm to your computer,
+for example, wipe your entire hard disk!
+We recommend running Pynguin in an isolated environment;
+use, for example, a Docker container to minimize the risk of damaging
+your system.
+
+**Pynguin is only a research prototype!**
+It is not tailored towards production use whatsoever.
+However, we would love to see Pynguin in a production-ready stage at some point;
+please report your experiences in using Pynguin to us.
+
+
+## Prerequisites
+
+Before you begin, ensure you have met the following requirements:
+- You have installed Python 3.10 (the support for 3.11, 3.12, 3.13 and 3.14 is experimental).
+
+  **Attention:** Pynguin now requires at least Python 3.10!  Older versions are no longer
+  supported!
+- You have a recent Linux/macOS/Windows machine.
+
+Please consider reading the [online documentation](https://pynguin.readthedocs.io)
+to start your Pynguin adventure.
+
+## Installing Pynguin
+
+Pynguin can be easily installed using the `pip` tool by typing:
+```bash
+pip install pynguin
+```
+
+Make sure that your version of `pip` is that of a supported Python version, as any
+older version is not supported by Pynguin!
+
+## Using Pynguin
+
+Before you continue, please read the [quick start guide](https://pynguin.readthedocs.io/latest/user/quickstart.html)
+
+Pynguin is a command-line application.
+Once you installed it to a virtual environment, you can invoke the tool by typing
+`pynguin` inside this virtual environment.
+Pynguin will then print a list of its command-line parameters.
+
+A minimal full command line to invoke Pynguin could be the following,
+where we assume that a project `foo` is located in `/tmp/foo`,
+we want to store Pynguin's generated tests in `/tmp/testgen`,
+and we want to generate tests using a whole-suite approach for the module `foo.bar`
+(wrapped for better readability):
+```bash
+pynguin \
+  --project-path /tmp/foo \
+  --output-path /tmp/testgen \
+  --module-name foo.bar
+```
+Please find a more detailed example in the [quick start guide](https://pynguin.readthedocs.io/latest/user/quickstart.html).
+
+
+## Contributing to Pynguin
+
+For the development of Pynguin you will need the [`poetry`](https://python-poetry.org)
+dependency management and packaging tool.
+To start developing, follow these steps:
+1. Clone the repository
+2. Change to the `pynguin` folder: `cd pynguin`
+3. Create a virtual environment and install dependencies using `poetry`: `poetry install`
+4. Make your changes
+5. Run `make check` to verify that your changes pass all checks
+
+   Please see the [`poetry` documentation](https://python-poetry.org/docs/) for more information on this tool.
+
+## Contributors
+
+Pynguin is developed at the
+[Chair of Software Engineering II](https://www.fim.uni-passau.de/lehrstuhl-fuer-software-engineering-ii/)
+of the [University of Passau](https://www.uni-passau.de).
+
+Maintainers: [Stephan Lukasczyk](https://github.com/stephanlukasczyk), [Lukas Krodinger](https://github.com/LuKrO2011)
+
+Contributors:
+- [Lukas Vögl](https://github.com/lvoegl)
+- [Louis Leppelmann](https://github.com/Tudeldu)
+- [Alexander Wüst](https://github.com/Ravaqor)
+- [Altin Hajdari](https://github.com/AltinHajdari)
+- [Abdelillah Aissani](https://github.com/Abassion)
+- [Juan Altmayer Pizzorno](https://github.com/jaltmayerpizzorno)
+- [Lucas Berg](https://github.com/BergLucas)
+- [Tucker Blue](https://github.com/tuckcodes)
+- [Gordon Fraser](https://github.com/gofraser)
+- [Abdur-Rahmaan Janhangeer](https://github.com/Abdur-rahmaanJ)
+- [Maximilian Königseder](https://github.com/mak1ng)
+- [Florian Kroiß](https://github.com/Wooza)
+- [Simon Labrenz](https://github.com/labrenz)
+- [Roman Levin](https://github.com/romanlevin)
+- [Juan Julián Merelo Guervós](https://github.com/JJ)
+- [Lukas Steffens](https://github.com/Luki42)
+- [Florian Straubinger](https://github.com/f-str)
+- [Sara Tavares](https://github.com/stavares843)
+
+
+### Development using PyCharm.
+
+If you want to use the PyCharm IDE you have to set up a few things:
+1. Import `pynguin` into PyCharm.
+2. Let PyCharm configure configure a virtual environment using `poetry`.
+3. Set the default test runner to `pytest`
+4. Set the DocString format to `Google`
+
+
+## License
+
+This project is licensed under the terms of the [MIT License](LICENSE.rst).
+Pynguin was using the GNU Lesser General Public License (LGPL) until version 0.29.0,
+its licence was changed with version 0.30.0.
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=se2p/pynguin&type=Date)](https://star-history.com/#se2p/pynguin)
+

pynguin-0.45.0/README.md

@@ -0,0 +1,169 @@
+<!--
+SPDX-FileCopyrightText: 2019–2026 Pynguin Contributors
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+# Pynguin
+
+Pynguin (IPA: ˈpɪŋɡuiːn),
+the
+PYthoN
+General
+UnIt
+test
+geNerator,
+is a tool that allows developers to generate unit tests automatically.
+
+Testing software is often considered to be a tedious task.
+Thus, automated generation techniques have been proposed and mature tools exist—for
+statically typed languages, such as Java.
+There is, however, no fully-automated tool available that produces unit tests for
+general-purpose programs in a dynamically typed language.
+Pynguin is, to the best of our knowledge, the first tool that fills this gap
+and allows the automated generation of unit tests for Python programs.
+
+<details>
+<summary>Internal Pipeline Status</summary>
+
+[![pipeline status](https://gitlab.infosun.fim.uni-passau.de/se2/pynguin/pynguin/badges/main/pipeline.svg)](https://gitlab.infosun.fim.uni-passau.de/se2/pynguin/pynguin/-/commits/main)
+[![coverage report](https://gitlab.infosun.fim.uni-passau.de/se2/pynguin/pynguin/badges/main/coverage.svg)](https://gitlab.infosun.fim.uni-passau.de/se2/pynguin/pynguin/-/commits/main)
+
+</details>
+
+[![License MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![PyPI version](https://badge.fury.io/py/pynguin.svg)](https://badge.fury.io/py/pynguin)
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/pynguin.svg)](https://github.com/se2p/pynguin)
+[![Documentation Status](https://readthedocs.org/projects/pynguin/badge/?version=latest)](https://pynguin.readthedocs.io/)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3989840.svg)](https://doi.org/10.5281/zenodo.3989840)
+[![REUSE status](https://api.reuse.software/badge/github.com/se2p/pynguin)](https://api.reuse.software/info/github.com/se2p/pynguin)
+[![Downloads](https://static.pepy.tech/personalized-badge/pynguin?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/pynguin)
+[![SWH](https://archive.softwareheritage.org/badge/origin/https://github.com/se2p/pynguin/)](https://archive.softwareheritage.org/browse/origin/?origin_url=https://github.com/se2p/pynguin)
+
+
+![Pynguin Logo](https://raw.githubusercontent.com/se2p/pynguin/master/docs/source/_static/pynguin-logo.png "Pynguin Logo")
+
+## Attention
+
+*Please Note:*
+
+**Pynguin executes the module under test!**
+As a consequence, depending on what code is in that module,
+running Pynguin can cause serious harm to your computer,
+for example, wipe your entire hard disk!
+We recommend running Pynguin in an isolated environment;
+use, for example, a Docker container to minimize the risk of damaging
+your system.
+
+**Pynguin is only a research prototype!**
+It is not tailored towards production use whatsoever.
+However, we would love to see Pynguin in a production-ready stage at some point;
+please report your experiences in using Pynguin to us.
+
+
+## Prerequisites
+
+Before you begin, ensure you have met the following requirements:
+- You have installed Python 3.10 (the support for 3.11, 3.12, 3.13 and 3.14 is experimental).
+
+  **Attention:** Pynguin now requires at least Python 3.10!  Older versions are no longer
+  supported!
+- You have a recent Linux/macOS/Windows machine.
+
+Please consider reading the [online documentation](https://pynguin.readthedocs.io)
+to start your Pynguin adventure.
+
+## Installing Pynguin
+
+Pynguin can be easily installed using the `pip` tool by typing:
+```bash
+pip install pynguin
+```
+
+Make sure that your version of `pip` is that of a supported Python version, as any
+older version is not supported by Pynguin!
+
+## Using Pynguin
+
+Before you continue, please read the [quick start guide](https://pynguin.readthedocs.io/latest/user/quickstart.html)
+
+Pynguin is a command-line application.
+Once you installed it to a virtual environment, you can invoke the tool by typing
+`pynguin` inside this virtual environment.
+Pynguin will then print a list of its command-line parameters.
+
+A minimal full command line to invoke Pynguin could be the following,
+where we assume that a project `foo` is located in `/tmp/foo`,
+we want to store Pynguin's generated tests in `/tmp/testgen`,
+and we want to generate tests using a whole-suite approach for the module `foo.bar`
+(wrapped for better readability):
+```bash
+pynguin \
+  --project-path /tmp/foo \
+  --output-path /tmp/testgen \
+  --module-name foo.bar
+```
+Please find a more detailed example in the [quick start guide](https://pynguin.readthedocs.io/latest/user/quickstart.html).
+
+
+## Contributing to Pynguin
+
+For the development of Pynguin you will need the [`poetry`](https://python-poetry.org)
+dependency management and packaging tool.
+To start developing, follow these steps:
+1. Clone the repository
+2. Change to the `pynguin` folder: `cd pynguin`
+3. Create a virtual environment and install dependencies using `poetry`: `poetry install`
+4. Make your changes
+5. Run `make check` to verify that your changes pass all checks
+
+   Please see the [`poetry` documentation](https://python-poetry.org/docs/) for more information on this tool.
+
+## Contributors
+
+Pynguin is developed at the
+[Chair of Software Engineering II](https://www.fim.uni-passau.de/lehrstuhl-fuer-software-engineering-ii/)
+of the [University of Passau](https://www.uni-passau.de).
+
+Maintainers: [Stephan Lukasczyk](https://github.com/stephanlukasczyk), [Lukas Krodinger](https://github.com/LuKrO2011)
+
+Contributors:
+- [Lukas Vögl](https://github.com/lvoegl)
+- [Louis Leppelmann](https://github.com/Tudeldu)
+- [Alexander Wüst](https://github.com/Ravaqor)
+- [Altin Hajdari](https://github.com/AltinHajdari)
+- [Abdelillah Aissani](https://github.com/Abassion)
+- [Juan Altmayer Pizzorno](https://github.com/jaltmayerpizzorno)
+- [Lucas Berg](https://github.com/BergLucas)
+- [Tucker Blue](https://github.com/tuckcodes)
+- [Gordon Fraser](https://github.com/gofraser)
+- [Abdur-Rahmaan Janhangeer](https://github.com/Abdur-rahmaanJ)
+- [Maximilian Königseder](https://github.com/mak1ng)
+- [Florian Kroiß](https://github.com/Wooza)
+- [Simon Labrenz](https://github.com/labrenz)
+- [Roman Levin](https://github.com/romanlevin)
+- [Juan Julián Merelo Guervós](https://github.com/JJ)
+- [Lukas Steffens](https://github.com/Luki42)
+- [Florian Straubinger](https://github.com/f-str)
+- [Sara Tavares](https://github.com/stavares843)
+
+
+### Development using PyCharm.
+
+If you want to use the PyCharm IDE you have to set up a few things:
+1. Import `pynguin` into PyCharm.
+2. Let PyCharm configure configure a virtual environment using `poetry`.
+3. Set the default test runner to `pytest`
+4. Set the DocString format to `Google`
+
+
+## License
+
+This project is licensed under the terms of the [MIT License](LICENSE.rst).
+Pynguin was using the GNU Lesser General Public License (LGPL) until version 0.29.0,
+its licence was changed with version 0.30.0.
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=se2p/pynguin&type=Date)](https://star-history.com/#se2p/pynguin)

pynguin-0.45.0/pyproject.toml

@@ -0,0 +1,293 @@
+# SPDX-FileCopyrightText: 2019–2026 Pynguin Contributors
+#
+# SPDX-License-Identifier: MIT
+
+[tool.poetry]
+name = "pynguin"
+version = "0.45.0"
+description = "Pynguin is a tool for automated unit test generation for Python"
+authors = [
+  "Stephan Lukasczyk <stephan@pynguin.eu>",
+  "Lukas Krodinger <lukas.krodinger@gmail.com>",
+]
+license = "MIT"
+readme = "README.md"
+repository = "https://github.com/se2p/pynguin"
+documentation = "https://pynguin.readthedocs.io"
+homepage = "https://www.pynguin.eu"
+keywords = [
+  "unit test",
+  "random testing",
+  "search based",
+  "test generation"
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Education",
+  "Intended Audience :: Science/Research",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: MacOS :: MacOS X",
+  "Operating System :: Microsoft :: Windows",
+  "Operating System :: POSIX :: Linux",
+  "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 :: Implementation :: CPython",
+  "Topic :: Education :: Testing",
+  "Topic :: Software Development :: Testing",
+  "Topic :: Software Development :: Testing :: Unit",
+  "Typing :: Typed",
+]
+packages = [
+  { include = "pynguin", from = "src" }
+]
+include = [
+  { path = "tests", format = "sdist" }
+]
+
+[tool.poetry.dependencies]
+python = ">=3.10, <3.15"
+astroid = "^4.0.1"
+black = "^25.1.0"
+bytecode = "0.17.0"
+dill = "^0.4.0"
+Jinja2 = "^3.1.6"
+networkx = "^3.4.2"
+multiprocess = "^0.70.18"
+rich = "^14.0.0"
+Pygments = "^2.19.2"
+pytest = "^8.3.5"
+simple-parsing = "^0.1.7"
+typing_inspect = "^0.9.0"
+asciitree = "^0.3.3"
+libcst = "^1.7.0"
+setuptools = "^80.9.0"
+toml = "^0.10.2"
+psutil = "^7.1.1"
+rstr = "^3.2.2"
+openai = { version = "^1.72.0", optional = true }
+python-dotenv = { version = "^1.0.0", optional = true }
+numpy = { version = "^1.26.4", optional = true }
+mypy = { version = "^1.15.0", optional = true }
+typing-extensions = { version = "^4.12.2", optional = true }
+faker = { version = "^37.3.0", optional = true }
+fandango-fuzzer = { version = "^0.8.2", optional = true }
+xmltodict = { version = "^0.14.2", optional = true }
+
+[tool.poetry.group.dev.dependencies]
+mypy = "^1.15.0"
+pre-commit = "^4.2.0"
+ruff = "^0.11"
+types-toml = "^0.10.8.20240310"
+types-pyyaml = "^6.0.12.20250516"
+types-networkx = "^3.4"
+
+[tool.poetry.group.docs.dependencies]
+sphinx = "^8.1.3"
+sphinx-autodoc-typehints = "^3.0"
+sphinx-hoverxref = "^1.4.2"
+sphinx-rtd-theme = "^3.0.2"
+
+[tool.poetry.group.test.dependencies]
+coverage = "^7.8.0"
+hypothesis = "^6.131"
+pytest-cov = "^6.1.1"
+pytest-mock = "^3.14.0"
+pytest-picked = "^0.5.1"
+pytest-sugar = "^1.0.0"
+
+[tool.poetry.extras]
+openai = [ "openai", "python-dotenv" ]
+numpy = [ "numpy" ]
+typing = [ "mypy", "typing-extensions" ]
+fandango-faker = [ "faker", "fandango-fuzzer", "xmltodict" ]
+
+[tool.poetry.scripts]
+pynguin = "pynguin.cli:main"
+
+[tool.coverage.run]
+branch = true
+source = ["src/pynguin", "tests"]
+omit = ["tests/fixtures/*"]
+relative_files = true
+
+[tool.coverage.report]
+exclude_lines = [
+  "pragma: no cover",
+  "def __repr__",
+  "def __str__",
+  "raise AssertionError",
+  "raise NotImplementedError",
+  "if __name__ == .__main__.:",
+  "if TYPE_CHECKING:",
+  "if typing.TYPE_CHECKING:"
+]
+
+[tool.coverage.html]
+directory = "cov_html"
+
+[tool.mypy]
+files = "src"
+mypy_path = "src"
+namespace_packages = true
+explicit_package_bases = true
+show_error_codes = true
+enable_error_code = [
+  "ignore-without-code",
+  "truthy-bool",
+]
+check_untyped_defs = true
+ignore_errors = false
+ignore_missing_imports = true
+strict_optional = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+warn_unused_configs = true
+
+[tool.pytest.ini_options]
+testpaths = [
+  "tests",
+]
+# A lot of our own classes start with Test so pytest will pick them up during test collection.
+# But they don't actually contains tests, so we set an empty matcher for the class name.
+python_classes = ''
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+
+[tool.ruff]
+# Assume Python 3.10.
+target-version = "py310"
+line-length = 100
+preview = true
+src = ["src", "tests"]
+exclude = [
+  ".bzr",
+  ".direnv",
+  ".eggs",
+  ".git",
+  ".hg",
+  ".mypy_cache",
+  ".nox",
+  ".pants.d",
+  ".ruff_cache",
+  ".svn",
+  ".tox",
+  ".venv",
+  "__pypackages__",
+  "_build",
+  "buck-out",
+  "build",
+  "dist",
+  "docs",
+  "node_modules",
+  "venv",
+  "tests/fixtures/*.py",
+  "tests/fixtures/*.pyi",
+]
+
+[tool.ruff.lint]
+select = [
+  "A", # flake8-builtins
+  "ARG", # flake8-unused-arguments
+  "B", # bugbear
+  "BLE", # flake8-blind-except
+  "CPY", # flake8-copyright
+  "C4", # flake8-comprehensions
+  "C90", # mccabe
+  "D", # pydocstyle
+  "DTZ", # flake8-datetimez
+  "E", # pycodestyle
+  "ERA", # flake8-eradicate
+  "F", # pyflakes
+  "FA", # flake8-future-annotations
+  "FBT", # flake8-boolean-trap
+  "FIX", # flake8-fixme
+  "FLY", # flynt
+  "FURB", # refurb
+  "G", # flake8-logging-format
+  "I", # isort
+  "ICN", # flake8-import-conventions
+  "INT", # flake8-gettext
+  "ISC", # flake8-implicit-str-concat
+  "LOG", # flake8-logging
+  "N", # flake8-naming
+  "NPY", # numpy
+  "PERF", # perflint
+  "PGH", # pygrep-hooks
+  "PIE", # flake8-pie
+  "PL", # pylint
+  "PT", # flake8-pytest-style
+  "PTH", # flake8-use-pathlib
+  "PYI", # flake8-pyi
+  "Q", # flake8-quotes
+  "RET", # flake8-return
+  "RSE", # flake8-raise
+  "RUF", # ruff
+  "S", # flake8-bandig
+  "SIM", # flake8-simplify
+  "SLF", # flake8-self
+  "SLOT", # flake8-slots
+  "TCH", # flake8-type-checking
+  "TID", # flake8-tidy-imports
+  "T20", # flake8-print
+  "UP", # pyupgrade
+  "W", # pycodestyle
+]
+ignore = [
+  "ARG002", # unused method argument
+  "B019", # functools.lru_cache might cause memory leaks
+  "CPY001", # missing copyright notice at top of file
+  "D105", # missing docstrings in magic methods
+  "FIX002", # valid TODO comments
+  "ISC001", # conflicts with ruff-format
+  "PLR0911", # do not complain about too many return statements
+  "PLR0912", # do not complain about too many branches
+  "PLR0913", # do not complain about too many arguments to function call
+  "PLR2004", # magic values in comparisons
+  "PLR6301", # method could be a function, class method, or static method
+  "RUF003", # comment contains ambiguous en dash
+  "RUF009", # do not perform function call in dataclass defaults
+  "S101", # do not complain about using assert statements
+]
+# Allow unused variables when underscore-prefixed:
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[tool.ruff.lint.mccabe]
+max-complexity = 10
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+  "D100", # Missing docstring in public module
+  "D101", # Missing docstring in public class
+  "D102", # Missing docstring in public method
+  "D103", # Missing docstring in public function
+  "D104", # Missing docstring in public package
+  "PT006", # Wrong name(s) type in `@pytest.mark.parameterize`, expected `tuple`
+  "S101", # Use of `assert` detected
+  "SLF001", # Private member accessed
+]
+
+[tool.tox]
+requires = ["tox~=4.28"]
+env_list = ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+[tool.tox.env_run_base]
+skip_install = true
+allowlist_externals = ["make", "poetry"]
+commands_pre = [
+  ["poetry", "env", "use", "{env_name}"],
+  ["poetry", "install", "--extras", "openai numpy fandango-faker"]
+]
+commands = [
+  ["make", "check"],
+]