docutils-develop

[Docutils-develop] [docutils:bugs] #447 docutils-cli.py not available when installing via pip

[Jesse B. <jes...@us...>]

---

** [bugs:#447] docutils-cli.py not available when installing via pip**

**Status:** open
**Created:** Thu Apr 21, 2022 07:19 PM UTC by Jesse Brennan
**Last Updated:** Thu Apr 21, 2022 07:19 PM UTC
**Owner:** nobody


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.


---

Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/bugs/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.

[Docutils-develop] [docutils:bugs] Re: #447 docutils-cli.py not available when installing via pip

[Günter M. <mi...@us...>]

> 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). 
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.


---

** [bugs:#447] docutils-cli.py not available when installing via pip**

**Status:** open
**Created:** Thu Apr 21, 2022 07:19 PM UTC by Jesse Brennan
**Last Updated:** Thu Apr 21, 2022 07:19 PM UTC
**Owner:** nobody


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.


---

Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/bugs/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.

[Docutils-develop] [docutils:bugs] #447 docutils-cli.py not available when installing via pip

[Günter M. <mi...@us...>]

- **status**: open --> open-fixed
- **Comment**:

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.



---

** [bugs:#447] docutils-cli.py not available when installing via pip**

**Status:** open-fixed
**Created:** Thu Apr 21, 2022 07:19 PM UTC by Jesse Brennan
**Last Updated:** Thu Apr 21, 2022 07:19 PM UTC
**Owner:** nobody


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.


---

Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/bugs/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.

[Docutils-develop] [docutils:bugs] #447 docutils-cli.py not available when installing via pip

[Günter M. <mi...@us...>]

- **status**: open-fixed --> closed-fixed
- **Comment**:

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



---

** [bugs:#447] docutils-cli.py not available when installing via pip**

**Status:** closed-fixed
**Created:** Thu Apr 21, 2022 07:19 PM UTC by Jesse Brennan
**Last Updated:** Mon May 30, 2022 04:57 PM UTC
**Owner:** nobody


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.


---

Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/bugs/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.