Configuration Reference

The nmk-python plugin handles the configuration items listed in this page.

All of them are initiliazed with convenient default values, so that you don’t need to setup them for a default working behavior. You can anyway override them in your project if you need to fine tune the plugin behavior. Some items are specifically designed to be extended by nmk projects and plugins.

Files

`pythonSrcFolders` – Python source code folders

Type	Default value
list[str]	[ ${sourceDir} ]

These are the paths nmk will browse to find source files.

`pythonGeneratedSrcFiles` – Python generated source files

Type	Default value
list[str]	[]

This is a list of generated source files, which shall be contributed by any source code generation logic (out of scope of this plugin).

`pythonFoundSrcFiles` – Python found source files

Type	Default value
list[str]	Generated by `nmk_python.files.PythonFilesFinder`

This is the list of source files for this python project (excluding test and generated ones; found in ${pythonSrcFolders}).

`pythonTestPackage` – Python tests package name

Type	Default value
str	tests

This is the name of the python module containing tests.

`pythonTestSources` – Python tests source code root folder

Type	Default value
str	${sourceDir}/${pythonTestPackage}

This is the root folder for python tests source code.

`pythonTestSrcFiles` – Python tests found source files

Type	Default value
list[str]	Generated by `nmk_python.files.PythonTestFilesFinder`

This is the list of python tests files for this project (found in ${pythonTestSources} folder).

`pythonSrcFiles` – All python source files

Type	Default value
list[str]	[ ${pythonFoundSrcFiles}, ${pythonTestSrcFiles}, ${pythonGeneratedSrcFiles} ]

This is a concatenation of all python source code files for this project.

Version

`pythonVersion` – Python version

Type	Default value
str	Generated by `nmk_python.version.PythonVersionResolver`

This is the current project version (respecting PyPa version specifiers), derived from ${gitVersion}

`pythonVersionStamp` – Python version stamp file

Type	Default value
str	${outputDir}/.pythonversion

This is the python version stamp file, updated each time the version is modified.

`pythonMinVersion` – Minimum supported python version

Type	Default value
str	“3.8”

This is the minimum python version supported by this project.

`pythonMaxVersion` – Maximum supported python version

Type	Default value
str	“3.12”

This is the maximum python version supported by this project.

`pythonSupportedVersions` – List of all supported python version

Type	Default value
list[str]	Generated by `nmk_python.version.PythonSupportedVersionsResolver`

This is the list of all supported python versions for this project.

Project

`pythonProjectFile` – Python project file

Type	Default value
str	${PROJECTDIR}/pyproject.toml

This is python project file, holding settings for python package generation and various python tools.

`pythonProjectFileFragments` – Python project contributed fragment files

Type	Default value
list[str]	[]

List of project fragment files to be merged in generated ${pythonProjectFile} file.

`pythonProjectFileItems` – Python project file contributed items

Type	Default value
Dict	{}

Dictionary of items to be contributed in generated ${pythonProjectFile} file.

Code format/analysis

`pythonLineLength` – Max python source line length

Type	Default value
int	160

This is the maximum line length when formatting code with ruff.

`pythonIgnoredRules` – List of ignored rules

Type	Default value
list[str]	[“E203”,”E501”]

This is the list of rules that need to be ignored when analyzing code with ruff.

`pythonAutoFixRules` – List of auto-fixed rules (list version)

Type	Default value
list[str]	[“I”]

This is the list of rules categories for which ruff will be invoked with fix option, helping the developer to quickly fix common mistakes.

Added in version 1.2

`pythonAutoFixJoinedRules` – List of auto-fixed rules (string version)

Type	Default value
str	Generated by `nmk_python.ruff.JoinedRulesResolver`

This is a comma seperated string version of ${pythonAutoFixRules}

Added in version 1.2

`pythonRuffCommonExtraArgs` – Extra args for all ruff commands

Type	Default value
str	“”

Extra arguments to be added to all ruff commands executed by py.format, py.fix and py.analyze tasks.

Added in version 1.2

`pythonRuffFormatExtraArgs` – Extra args for ruff format command

Type	Default value
str	“”

Extra arguments to be added to ruff command executed by py.format task.

Added in version 1.2

`pythonRuffFixExtraArgs` – Extra args for ruff fix command

Type	Default value
str	“”

Extra arguments to be added to ruff command executed by py.fix task.

Added in version 1.2

`pythonRuffCheckExtraArgs` – Extra args for ruff check command

Type	Default value
str	“”

Extra arguments to be added to ruff command executed by py.analyze task.

Added in version 1.2

`pythonRuffFormatStamp` – Python format stamp file

Type	Default value
str	${outputDir}/.ruff-format

This is the stamp file updated each time the py.format task is executed.

`pythonRuffFixStamp` – Python fix stamp file

Type	Default value
str	${outputDir}/.ruff-fix

This is the stamp file updated each time the py.fix task is executed.

Added in version 1.2

`pythonRuffCheckStamp` – Python check stamp file

Type	Default value
str	${outputDir}/.ruff-check

This is the stamp file updated each time the py.analyze task is executed.

Build

`pythonPackage` – Python package name

Type	Default value
str	${projectName}

This is the name of the python package (wheel) to be generated.

`pythonModule` – Python module name

Type	Default value
str	Generated by `nmk_python.build.PythonModuleResolver`

This is the name of the python module (typically the same than the wheel name, with “_” instead of “-“).

`pythonPackagePlatform` – Python package platform tag

Type	Default value
str	any

This is the platform tag for the current python project.

`pythonArtifacts` – Python artifacts folder

Type	Default value
str	${outputDir}/artifacts

This is the output folder where the python wheel is generated.

`pythonBuildDir` – Python build folder

Type	Default value
str	${outputDir}/python

This is the output path where the wheel build is performed.

`pythonWheel` – Python generated wheel file

Type	Default value
str	${pythonArtifacts}/${pythonModule}-${pythonVersion}-py3-none-${pythonPackagePlatform}.whl

This is the generated python wheel file.

`pythonPackageRequirements` – Python package dependencies

Type	Default value
list[str]	[]

This is the list of python package dependencies for the built wheel (i.e. list of packages to be installed when the wheel itself is installed).

`pythonExtraResources` – Python extra bundled resources

Type	Default value
dict[str,str]	{}

This is a dictionary specifying extra resources to be bundled in the built python wheel, that are not part of the source tree:

keys are existing resource files or folders
values are expected paths in the source tree

Paths may be absolute or relative; non-absolute paths are considered to be relative to the project root folder.

Note

Resources won’t actually be copied in the source tree. Destination path should be considered as the location where resource would exist in the source tree.

`pythonEditableStamp` – Python editable install stamp file

Type	Default value
str	${outputDir}/.pyeditable

This is the python editable install stamp file, updated each time the project is installed in editable mode.

`pythonEditableInstallArgs` – pip arguments for editable mode install

Type	Default value
list[str]	[”–no-deps”, “–no-build-isolation”]

This is the list of pip install options to be used when installing project in editable mode with py.editable task.

Added in version 1.1

`pythonWheelInstallArgs` – pip arguments for wheel install

Type	Default value
list[str]	[”–force-reinstall”, “–no-deps”]

This is the list of pip install options to be used when installing project built wheel with py.install task.

Added in version 1.1

Tests

`pythonTestOutput` – Python tests output folder

Type	Default value
str	${outputDir}/tests

This is the output folder where tests results are generated.

`pythonCoverageHtmlReport` – Python code coverage HTML report folder

Type	Default value
str	${outputDir}/coverage-report

This is the output folder where python code coverage HTML report is generated.

`pythonCoverageXmlReport` – Python code coverage XML report file

Type	Default value
str	${outputDir}/coverage.xml

This is the output file for python code coverage XML report.

`pythonCoverageFile` – Python code coverage data file

Type	Default value
str	${outputDir}/.coverage

This is the cumulative data file for python code coverage.

`pytestExtraArgs` – Extra pytest arguments

Type	Default value
dict[str, str]	{“numprocesses”: “auto”, “cov-fail-under”: 100, “dist”: “loadgroup”}

This is a name/value dictionary of pytest options used on the command line when launching tests.

Configuration Reference

Files

pythonSrcFolders – Python source code folders

pythonGeneratedSrcFiles – Python generated source files

pythonFoundSrcFiles – Python found source files

pythonTestPackage – Python tests package name

pythonTestSources – Python tests source code root folder

pythonTestSrcFiles – Python tests found source files

pythonSrcFiles – All python source files

Version

pythonVersion – Python version

pythonVersionStamp – Python version stamp file

pythonMinVersion – Minimum supported python version

pythonMaxVersion – Maximum supported python version

pythonSupportedVersions – List of all supported python version

Project

pythonProjectFile – Python project file

pythonProjectFileFragments – Python project contributed fragment files

pythonProjectFileItems – Python project file contributed items

Code format/analysis

pythonLineLength – Max python source line length

pythonIgnoredRules – List of ignored rules

pythonAutoFixRules – List of auto-fixed rules (list version)

pythonAutoFixJoinedRules – List of auto-fixed rules (string version)

pythonRuffCommonExtraArgs – Extra args for all ruff commands

pythonRuffFormatExtraArgs – Extra args for ruff format command

pythonRuffFixExtraArgs – Extra args for ruff fix command

pythonRuffCheckExtraArgs – Extra args for ruff check command

pythonRuffFormatStamp – Python format stamp file

pythonRuffFixStamp – Python fix stamp file

pythonRuffCheckStamp – Python check stamp file

Build

pythonPackage – Python package name

pythonModule – Python module name

pythonPackagePlatform – Python package platform tag

pythonArtifacts – Python artifacts folder

pythonBuildDir – Python build folder

pythonWheel – Python generated wheel file

pythonPackageRequirements – Python package dependencies

pythonExtraResources – Python extra bundled resources

pythonEditableStamp – Python editable install stamp file

pythonEditableInstallArgs – pip arguments for editable mode install

pythonWheelInstallArgs – pip arguments for wheel install

Tests

pythonTestOutput – Python tests output folder

pythonCoverageHtmlReport – Python code coverage HTML report folder

pythonCoverageXmlReport – Python code coverage XML report file

pythonCoverageFile – Python code coverage data file

pytestExtraArgs – Extra pytest arguments

`pythonSrcFolders` – Python source code folders

`pythonGeneratedSrcFiles` – Python generated source files

`pythonFoundSrcFiles` – Python found source files

`pythonTestPackage` – Python tests package name

`pythonTestSources` – Python tests source code root folder

`pythonTestSrcFiles` – Python tests found source files

`pythonSrcFiles` – All python source files

`pythonVersion` – Python version

`pythonVersionStamp` – Python version stamp file

`pythonMinVersion` – Minimum supported python version

`pythonMaxVersion` – Maximum supported python version

`pythonSupportedVersions` – List of all supported python version

`pythonProjectFile` – Python project file

`pythonProjectFileFragments` – Python project contributed fragment files

`pythonProjectFileItems` – Python project file contributed items

`pythonLineLength` – Max python source line length

`pythonIgnoredRules` – List of ignored rules

`pythonAutoFixRules` – List of auto-fixed rules (list version)

`pythonAutoFixJoinedRules` – List of auto-fixed rules (string version)

`pythonRuffCommonExtraArgs` – Extra args for all ruff commands

`pythonRuffFormatExtraArgs` – Extra args for ruff format command

`pythonRuffFixExtraArgs` – Extra args for ruff fix command

`pythonRuffCheckExtraArgs` – Extra args for ruff check command

`pythonRuffFormatStamp` – Python format stamp file

`pythonRuffFixStamp` – Python fix stamp file

`pythonRuffCheckStamp` – Python check stamp file

`pythonPackage` – Python package name

`pythonModule` – Python module name

`pythonPackagePlatform` – Python package platform tag

`pythonArtifacts` – Python artifacts folder

`pythonBuildDir` – Python build folder

`pythonWheel` – Python generated wheel file

`pythonPackageRequirements` – Python package dependencies

`pythonExtraResources` – Python extra bundled resources

`pythonEditableStamp` – Python editable install stamp file

`pythonEditableInstallArgs` – pip arguments for editable mode install

`pythonWheelInstallArgs` – pip arguments for wheel install

`pythonTestOutput` – Python tests output folder

`pythonCoverageHtmlReport` – Python code coverage HTML report folder

`pythonCoverageXmlReport` – Python code coverage XML report file

`pythonCoverageFile` – Python code coverage data file

`pytestExtraArgs` – Extra pytest arguments