pyproject-examples 2023.6.30

Description:

pyprojectexamples 2023.6.30

Example pyproject.toml configs for testing.
These are designed to be used in the testsuite for
pyproject-parser
and whey,
but may be useful for other tools based on those.






Tests


PyPI


Activity


QA


Other





Installation
pyproject-examples can be installed from PyPI.
To install with pip:
$ python -m pip install pyproject-examples


Usage
pyproject-examples provides the following API:

pyproject_examples module

valid_pep621_config
A list of pytest params for valid pyproject.toml files per PEP 621.
The params contain the pyproject.toml content as a string.
Each param has its own unique ID, which can be seen in the source
here.


bad_pep621_config
A list of pytest params for invalid pyproject.toml files per PEP 621.
Each param contains the pyproject.toml content (as a string),
the expected Python exception (for catching with pytest.raises), and the expected exception text (for passing as the match argument to pytest.raises.
Each param also has its own unique ID, which can be seen in the source here.


valid_buildsystem_config
A list of pytest params for valid [build-system] tables from pyproject.toml files per PEP 517 and PEP 517.
The params contain the pyproject.toml content as a string.
Each param has its own unique ID, which can be seen in the source
here.


bad_buildsystem_config
A list of pytest params for invalid [build-system] tables from pyproject.toml files per PEP 517 and PEP 517.
Each param contains the pyproject.toml content (as a string),
the expected Python exception (for catching with pytest.raises), and the expected exception text (for passing as the match argument to pytest.raises.
Each param also has its own unique ID, which can be seen in the source here.



pyproject_examples.example_configs submodule
This module contains the example configuration files themselves.
Each file is stored as a string.
The configuration files are:

MINIMAL_CONFIG
KEYWORDS
AUTHORS
UNICODE
MAINTAINERS
CLASSIFIERS
DEPENDENCIES
OPTIONAL_DEPENDENCIES
OPTIONAL_DEPENDENCIES_EMPTY_GROUP
URLS
ENTRY_POINTS
COMPLETE_PROJECT_A
COMPLETE_A
COMPLETE_B
COMPLETE_A_WITH_FILES
DYNAMIC_REQUIREMENTS
LONG_REQUIREMENTS



pyproject_examples.utils submodule
This module contains utility functions.

file_not_found_regex(filename: str) -> str
This function create a regular expression for testing FileNotFoundErrors.
This is useful for testing error messages between Windows and POSIX, as well as between CPython and PyPy.
filename The filename which can’t be found.