pynguin 0.40.0__tar.gz → 0.41.0__tar.gz

pynguin-0.41.0/LICENSE.rst

@@ -0,0 +1,10 @@
+MIT License
+===========
+
+Copyright (c) 2019–2025 Pynguin Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

pynguin-0.41.0/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.3
+Name: pynguin
+Version: 0.41.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.11
+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 :: Implementation :: CPython
+Classifier: Topic :: Education :: Testing
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Testing :: Unit
+Classifier: Typing :: Typed
+Requires-Dist: Jinja2 (>=3.1.6,<4.0.0)
+Requires-Dist: Pygments (>=2.19.1,<3.0.0)
+Requires-Dist: asciitree (>=0.3.3,<0.4.0)
+Requires-Dist: astroid (>=3.3.9,<4.0.0)
+Requires-Dist: black (>=25.1.0,<26.0.0)
+Requires-Dist: bytecode (>=0.16.1,<0.17.0)
+Requires-Dist: dill (>=0.3.9,<0.4.0)
+Requires-Dist: libcst (>=1.7.0,<2.0.0)
+Requires-Dist: multiprocess (>=0.70.16,<0.71.0)
+Requires-Dist: networkx (>=3.4,<4.0)
+Requires-Dist: psutil (>=7.0.0,<8.0.0)
+Requires-Dist: pytest (>=8.3.5,<9.0.0)
+Requires-Dist: rich (>=14.0.0,<15.0.0)
+Requires-Dist: setuptools (>=78.1,<79.0)
+Requires-Dist: simple-parsing (>=0.1.7,<0.2.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Requires-Dist: typing_inspect (>=0.9.0,<0.10.0)
+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–2025 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)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
+[![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/en/latest/?badge=latest)
+[![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 (we have not yet tested with Python
+  3.11, there might be some problems due to changed internals regarding the byte-code
+  instrumentation).
+
+  **Attention:** Pynguin now requires 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/en/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/en/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:
+- [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.41.0/README.md

@@ -0,0 +1,169 @@
+<!--
+SPDX-FileCopyrightText: 2019–2025 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)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
+[![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/en/latest/?badge=latest)
+[![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 (we have not yet tested with Python
+  3.11, there might be some problems due to changed internals regarding the byte-code
+  instrumentation).
+
+  **Attention:** Pynguin now requires 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/en/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/en/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:
+- [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.41.0/pyproject.toml

@@ -0,0 +1,278 @@
+# SPDX-FileCopyrightText: 2019–2025 Pynguin Contributors
+#
+# SPDX-License-Identifier: MIT
+
+[tool.poetry]
+name = "pynguin"
+version = "0.41.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 :: 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.11"
+astroid = "^3.3.9"
+black = "^25.1.0"
+bytecode = "^0.16.1"
+dill = "^0.3.9"
+Jinja2 = "^3.1.6"
+networkx = "^3.4"
+multiprocess = "^0.70.16"
+rich = "^14.0.0"
+Pygments = "^2.19.1"
+pytest = "^8.3.5"
+simple-parsing = "^0.1.7"
+typing_inspect = "^0.9.0"
+asciitree = "^0.3.3"
+libcst = "^1.7.0"
+setuptools = "^78.1"
+toml = "^0.10.2"
+psutil = "^7.0.0"
+
+[tool.poetry.group.dev.dependencies]
+isort = { extras = ["pyproject"], version = "^6.0.1" }
+mypy = "^1.15.0"
+pre-commit = "^4.2.0"
+ruff = "^0.11"
+types-toml = "^0.10.8.20240310"
+types-pyyaml = "^6.0.12.20250516"
+
+[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.group.openai]
+optional = true
+
+[tool.poetry.group.openai.dependencies]
+openai = "^1.72.0"
+
+[tool.poetry.group.numpy]
+optional = true
+
+[tool.poetry.group.numpy.dependencies]
+numpy = "^1.26.4"
+
+[tool.poetry.scripts]
+pynguin = "pynguin.cli:main"
+
+[tool.coverage.run]
+branch = true
+source = ["src/pynguin", "tests"]
+omit = ["tests/fixtures/*"]
+
+[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.isort]
+py_version = 310
+profile = "black"
+force_single_line = true
+combine_as_imports = true
+lines_between_types = 1
+lines_after_imports = 2
+src_paths = ["src", "tests"]
+
+[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
+  "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
+]