Command line "entry point" to the docutils package. Part 2/2.

Support ``python -m docutils`` with new module `docutils.__main__`.

Support ``docutils`` CLI command via "entry point" in setup.py.

Keep tools/docutils-cli.py for backwards compatibility
and manual installation.
Calls `docutils.__main__.main()`.

Thanks to Adam Turner for contributions and review.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@9061 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 24 insertions, 0 deletions

diff --git a/docutils/tools/docutils-cli.py b/docutils/tools/docutils-cli.py
new file mode 100755
index 000000000..c1c19a126
--- /dev/null
+++ b/docutils/tools/docutils-cli.py
@@ -0,0 +1,24 @@
+#!/usr/bin/env python3
+# :Copyright: © 2022 Günter Milde.
+# :License: Released under the terms of the `2-Clause BSD license`_, in short:
+#
+#    Copying and distribution of this file, with or without modification,
+#    are permitted in any medium without royalty provided the copyright
+#    notice and this notice are preserved.
+#    This file is offered as-is, without any warranty.
+#
+# .. _2-Clause BSD license: https://opensource.org/licenses/BSD-2-Clause
+#
+# Revision: $Revision$
+# Date: $Date$
+
+"""Generic command line interface for the `docutils` package.
+
+Deprecated:
+Call `docutils` (generated in the binary PATH during package installation)
+or `python3 -m docutils` to get the generic Docutils CLI.
+"""
+
+from docutils import __main__
+
+__main__.main()