#447 docutils-cli.py not available when installing via pip

[Jesse Brennan]

This might not be an actual bug, but the behavior is surprising, and the documentation lead me to believe that docutils-cli.py should be available regardless of installation method.

I created a new virtual environment with Python 3.8.3. With the virtual environment active, I updated to the latest version of pip, then installed docutils.

I then tried to run docutils-cli.py but the command could not be found. Other tools were available, such as rst2html.py.

[Günter Milde]

This might not be an actual bug, but the behavior is surprising, and
the documentation lead me to believe that docutils-cli.py should be
available regardless of installation method.

... the command could not be found.
Other tools were available, such as rst2html.py.

The reason is a missing entry in the package_data['scripts'] list
in setup.py. This is an oversight during the recent addition of this tool.

There are plans, to overhoul the front-end tool naming and installation using
"entry points" (that allow automatic installation and leaving out the ".py"
extension also on Windows). See also [feature-requests:#88].
In the course of this changes, the generic front-end tool
could/should be renamed from docutils-cli.py to docutils.
We may consider using the new name (and entry-point) already in 0.19.

Thank you for reporting.

[Günter Milde]

Fixed in [r9061].
Installing the "docutils" package (>= 0.19.dev) with pip or setuptools will also install
the docutils CLI command.

Thank you for reporting.

[Günter Milde]

Fixed in Docutils 0.19.
https://docutils.sourceforge.io/docs/user/tools.html#generic-command-line-front-end
Thank you for reporting.