sphinx-contrib / autoprogram

Documenting CLI programs
https://pypi.org/project/sphinxcontrib-autoprogram/
Other
44 stars 23 forks source link

0.1.7: sphinx warnings #50

Open kloczek opened 3 years ago

kloczek commented 3 years ago
+ /usr/bin/python3 setup.py build_sphinx -b man --build-dir build/sphinx
running build_sphinx
Running Sphinx v4.0.2
making output directory... done
WARNING: html_static_path entry '_static' does not exist
loading intersphinx inventory from http://docs.python.org/objects.inv...
loading intersphinx inventory from http://sphinx-doc.org/objects.inv...
intersphinx inventory has moved: http://docs.python.org/objects.inv -> https://docs.python.org/3/objects.inv
intersphinx inventory has moved: http://sphinx-doc.org/objects.inv -> https://www.sphinx-doc.org/en/master/
WARNING: failed to reach any of the inventories with the following issues:
intersphinx inventory 'http://sphinx-doc.org/objects.inv' not readable due to ValueError: unknown or unsupported inventory version: ValueError('invalid inventory header: ')
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 2 added, 0 changed, 0 removed
reading sources... [100%] index
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-sphinxcontrib-autoprogram.3 { } done
build succeeded, 2 warnings.
langston-barrett commented 1 year ago

@kloczek Can you please post a minimal example that demonstrates the issue?

kloczek commented 1 year ago

Minimal example is in first line /usr/bin/python3 setup.py build_sphinx -b man --build-dir build/sphinx. That command can be executed in source root just after clone git repo.

In mean time I made as well some patch to move away from pkg_resources namespaces.

Remove using namespaces basing on:
https://github.com/jaraco/jaraco.functools/commit/d84738ac

--- a//setup.py~        2021-02-10 17:12:43.000000000 +0000
+++ b//setup.py 2022-05-23 18:23:34.109196173 +0000
@@ -51,7 +51,6 @@
     ],
     platforms='any',
     packages=find_packages(),
-    namespace_packages=['sphinxcontrib'],
     include_package_data=True,
     install_requires=requires,
     test_suite='sphinxcontrib.autoprogram.suite'
--- a/sphinxcontrib/__init__.py~        2021-02-10 17:12:43.000000000 +0000
+++ b/sphinxcontrib/__init__.py 2022-05-23 18:22:07.523348583 +0000
@@ -10,4 +10,4 @@
     :license: BSD, see LICENSE for details.
 """

-__import__("pkg_resources").declare_namespace(__name__)
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)