twine.commands.check module

Module containing the logic for twine check.

class twine.commands.check._WarningStream[source]
write(text: str) → int[source]

Write string to file.

Returns the number of characters written, which is always equal to the length of the string.

twine.commands.check._check_file(filename: str, render_warning_stream: _WarningStream) → Tuple[List[str], bool][source]

Check given distribution.

twine.commands.check.check(dists: List[str], strict: bool = False) → bool[source]

Check that a distribution will render correctly on PyPI and display the results.

This is currently only validates long_description, but more checks could be added; see https://github.com/pypa/twine/projects/2.

Parameters

  • dists – The distribution files to check.

  • output_stream – The destination of the resulting output.

  • strict – If True, treat warnings as errors.

Returns

True if there are rendering errors, otherwise False.

twine.commands.check.main(args: List[str]) → bool[source]

Execute the check command.

Parameters

args – The command-line arguments.

Returns

The exit status of the check command.