project_config.reporters package

Error reporters.

exception project_config.reporters.InvalidNotBasedThirdPartyReporter(message: str)[source]

Bases: project_config.exceptions.ProjectConfigException

Reporter not based on base reporter class.

All reporters must be based on the base reporter class :py::class:project_config.reporters.base.BaseReporter.

message: str
exception project_config.reporters.InvalidThirdPartyReportersModule(message: str)[source]

Bases: project_config.exceptions.ProjectConfigException

Third party reporters module is invalid.

Third party reporters module must expose a color and a black/white reporter.

message: str
class project_config.reporters.ThirdPartyReporters[source]

Bases: object

Third party reporters loader from entrypoints.

_prepare_third_party_reporters() → None[source]
property ids: List[str]

Returns the identifiers of the 3rd party reporters.

instance: Optional[project_config.reporters.ThirdPartyReporters] = <project_config.reporters.ThirdPartyReporters object>
load(reporter_name: str) → module[source]

Load a third party reporter.

Parameters

reporter_name (str) – Reporter module entrypoint name.

validate_reporter_class(reporter_class: Any) → None[source]

Validate a reporter class.

Parameters

reporter_class (type) – Reporter class to validate.

validate_reporter_module(reporter_module: module) → Tuple[str, str][source]

Validate a reporter module.

Returns black/white and color reporter class names if the reporters module is valid.

Parameters

reporter_module (type) – Reporters module to validate.

project_config.reporters._parse_reporter_arguments(arguments_string: str) → Dict[str, Any][source]
project_config.reporters.get_reporter(reporter_name: str, reporter_kwargs: Dict[str, Any], color: Optional[bool], rootdir: str, only_hints: bool = False) → Any[source]

Reporters factory.

Parameters

  • reporter_name (str) – Reporter identifier name.

  • reporter_kwargs (dict) – Optional arguments for reporter class.

  • color (bool) – Return the colorized version of the reporter, if is implemented, using the black/white version as a fallback.

  • rootdir (str) – Root directory of the project.

  • only_hints (bool) – If True, only hints will be reported.

project_config.reporters.parse_reporter_id(value: str) → Tuple[str, Dict[str, Any]][source]

Parse a reporter identifier.

Returns the reporter name and the optional arguments for his class.

Parameters

value (str) – Reporter identifier.

Submodules