PythonTests

Miscellaneous machinery around traversing & querying the build hierarchy, that should not be needed by normal users of Mill

The direct dependencies of this module. This is meant to be overridden to add dependencies.

Bundles the project into a single PEX executable(bundle.pex).

Command-line options to pass as bundle configuration defined by the user.

Opens up a Python console with your module and all dependencies present, for you to test and operate your code interactively.

The name of the default command, which will be automatically executed if the module name is provided at the Mill command line.

Any environment variables you want to pass to the forked Env

Folders containing source files that are generated rather than handwritten; these files can be generated in this target itself, or can refer to files generated from other targets

Python interpreter found on the host system. This will be used to create a new virtual environment, which will be used by all tasks in this module.

If you'd like to use a specific python version, override this task to point to a specific python executable.

Examples:

// use whatever python version is installed on the host system (default)
def hostPythonCommand = T{ "python3" }

// use a specific minor release
def hostPythonCommand = T{ "python3.12" }

// use a specific executable file
def hostPythonCommand = T{ "/usr/bin/python3" }

Base URLs of the Python Package Indexes to search for packages. Defaults to https://pypi.org/simple.

These should point to repositories compliant with PEP 503 (the simple repository API) or local directories laid out in the same format.

The directories used to construct the PYTHONPATH for this module, used for execution, excluding upstream modules.

This includes source directories, resources and other unmanaged directories.

The python script to run. This file may not exist if this module is only a library.

Arguments to be passed to pip install when preparing the environment.

This task is called by pythonExe. It serves as an escape hatch, should you need to override it for some reason. Normally, you should not need to edit this task directly. Instead, prefer editing the other tasks of this module which influence how the arguments are created.

Any python dependencies you want to add to this module. The format of each dependency should be the same as used with pip install, or as you would find in a requirements.txt file. E.g. def pythonDeps = Seq("numpy==2.1.3").

Dependencies declared here will also be required when installing this module.

An executable python interpreter. This interpreter is set up to run in a virtual environment which has been initialized to contain all libraries and tools needed by this module and its dependencies.

Command-line options to pass to the Python Interpreter defined by the user.

Python dependencies declared in requirements.txt files. This is similar to pythonDeps, but reads dependencies from a text file, allowing you to reuse requirements files from existing projects.

Any python dependencies for development tools you want to add to this module.

These dependencies are similar to pythonDeps, but will not be required to install this module, only to work on it. For example, type checkers, linters, and bundlers should be declared here.

The folders where the resource files for this module live.

Run the main python script of this module.

Run the main python script of this module.

The folders where the source files for this mill module live.

Python modules will be defined relative to these directories.

Returns a string representation of the object.

The default representation is platform dependent.

Python dependencies of this module, and all other modules that this module depends on, recursively.

The transitive version of localPythonPath: this includes the directories of all upstream modules as well.

requirements.txt of this module, and all other modules that this module depends on, recursively.

Any python wheels to install directly, for this module and all upstream modules, recursively.

Run a typechecker on this module.

Additional directories to include in the PYTHONPATH directly. These paths are "unmanaged": they'll be included as they are on disk.

Any python wheels to install directly.

Note: you can also include wheels by using direct references in pythonRequirementFiles, for example "pip @ file:///localbuilds/pip-1.3.1-py33-none-any.whl". However, if you do that then changes to these files won't get picked up and you are on the hook for cache invalidation. Therefore, if you have any wheels that you wish to install directly, it is recommended to add them here.