1.0.0: sphinx warnings

[kloczek]

+ /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 https://docs.python.org/3/objects.inv...
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 14 added, 0 changed, 0 removed
reading sources... [100%] usage
/home/tkloczko/rpmbuild/BUILD/dateparser-1.0.0/dateparser/date.py:docstring of dateparser.date.DateDataParser.get_date_data:34: WARNING: Unknown target name: "settings".
WARNING: autodoc: failed to import module 'jalali' from module 'dateparser.calendars'; the following exception was raised:
No module named 'convertdate'
WARNING: autodoc: failed to import module 'detection' from module 'dateparser.languages'; the following exception was raised:
No module named 'dateparser.languages.detection'
WARNING: autodoc: failed to import module 'language' from module 'dateparser.languages'; the following exception was raised:
No module named 'dateparser.languages.language'
/home/tkloczko/rpmbuild/BUILD/dateparser-1.0.0/dateparser/__init__.py:docstring of dateparser:1: WARNING: duplicate object description of dateparser, other instance in dateparser, use :noindex: for one of them
/home/tkloczko/rpmbuild/BUILD/dateparser-1.0.0/dateparser/__init__.py:docstring of dateparser.parse:1: WARNING: duplicate object description of dateparser.parse, other instance in dateparser, use :noindex: for one of them
/home/tkloczko/rpmbuild/BUILD/dateparser-1.0.0/dateparser/__init__.py:docstring of dateparser:1: WARNING: duplicate object description of dateparser, other instance in index, use :noindex: for one of them
/home/tkloczko/rpmbuild/BUILD/dateparser-1.0.0/dateparser/__init__.py:docstring of dateparser.parse:1: WARNING: duplicate object description of dateparser.parse, other instance in index, use :noindex: for one of them
/home/tkloczko/rpmbuild/BUILD/dateparser-1.0.0/dateparser/search/__init__.py:docstring of dateparser.search:1: WARNING: duplicate object description of dateparser.search, other instance in index, use :noindex: for one of them
/home/tkloczko/rpmbuild/BUILD/dateparser-1.0.0/dateparser/search/__init__.py:docstring of dateparser.search.search_dates:1: WARNING: duplicate object description of dateparser.search.search_dates, other instance in index, use :noindex: for one of them
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/tkloczko/rpmbuild/BUILD/dateparser-1.0.0/docs/modules.rst: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/dateparser-1.0.0/docs/template.rst: WARNING: document isn't included in any toctree
done
writing... dateparser.1 { introduction installation usage settings supported_locales contributing authors history } done
build succeeded, 13 warnings.

[noviluni]

I'm not able to reproduce this :thinking:

@Gallaecio, are you getting these errors?

[kloczek]

Are you using sphinx 4.0.x?

[noviluni]

No, I'm running tox -e docs and it is using the last release Sphinx v4.1.1. Also, when doing it manually: python3 setup.py build_sphinx -b man --build-dir build/sphinx, I'm not getting those warnings.

I don't mean they are not legit, but for some reason they are not arising.

(Well, this WARNING: autodoc: failed to import module 'jalali' from module 'dateparser.calendars'; the following exception was raised: No module named 'convertdate' is because if you want to run it without using tox, you should do pip install dateparser[calendars] or pip install -e .[calendars] before running it)

[Gallaecio]

Hmm, I cannot reproduce it either. Although I expected those warnings about duplicate stuff to affect me regardless of what’s installed.

@kloczek Could you update your RPM metadata to include the missing dependencies?

Also, do you get any warning in your system if you use tox -e docs. I assume your goal is not to use Tox, but it would be useful to first determine if there is something in your system that would cause warnings/errors with Tox, and once we get a clean Tox build on your end, we can work on figuring out why things do not work without Tox.

[kloczek]

OK will check that one more time wirh sphinx 4.1.1 :) Will back shortly :P

@kloczek Could you update your RPM metadata to include the missing dependencies?

Hmm .. what you mean? 🤔

[Gallaecio]

Based on /home/tkloczko/rpmbuild/BUILD/dateparser-1.0.0/ I assume you are building an RPM package, and as @noviluni said some of the documentation errors are due to missing dependencies that would get installed with dateparser[calendars].

[kloczek]

due to missing dependencies that would get installed with dateparser[calendars].

Cannot find that module on pypi. Where it is?

[Gallaecio]

It’s not a package, it’s a package extra. You can see in setup.py what additional packages that extra brings. For Sphinx documentation using the InterSphinx extension, installing all extra packages can be necessary to build the documentation.