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.