tomerfiliba / plumbum

Plumbum: Shell Combinators
https://plumbum.readthedocs.io
MIT License
2.78k stars 182 forks source link

1.8.2: sphinx warnings `reference target not found` #654

Open kloczek opened 10 months ago

kloczek commented 10 months ago

First of all currently it is not possible to use straight sphinx-build command to build documentation out of source tree

```console + /usr/bin/sphinx-build -n -T -b man docs build/sphinx/man Running Sphinx v7.0.1 Traceback (most recent call last): File "/usr/lib/python3.8/site-packages/sphinx/config.py", line 354, in eval_config_file exec(code, namespace) # NoQA: S102 File "/home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/conf.py", line 53, in from plumbum.version import version as release ModuleNotFoundError: No module named 'plumbum' The above exception was the direct cause of the following exception: Traceback (most recent call last): File "/usr/lib/python3.8/site-packages/sphinx/cmd/build.py", line 280, in build_main app = Sphinx(args.sourcedir, args.confdir, args.outputdir, File "/usr/lib/python3.8/site-packages/sphinx/application.py", line 207, in __init__ self.config = Config.read(self.confdir, confoverrides or {}, self.tags) File "/usr/lib/python3.8/site-packages/sphinx/config.py", line 177, in read namespace = eval_config_file(filename, tags) File "/usr/lib/python3.8/site-packages/sphinx/config.py", line 367, in eval_config_file raise ConfigError(msg % traceback.format_exc()) from exc sphinx.errors.ConfigError: There is a programmable error in your configuration file: Traceback (most recent call last): File "/usr/lib/python3.8/site-packages/sphinx/config.py", line 354, in eval_config_file exec(code, namespace) # NoQA: S102 File "/home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/conf.py", line 53, in from plumbum.version import version as release ModuleNotFoundError: No module named 'plumbum' Configuration error: There is a programmable error in your configuration file: Traceback (most recent call last): File "/usr/lib/python3.8/site-packages/sphinx/config.py", line 354, in eval_config_file exec(code, namespace) # NoQA: S102 File "/home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/conf.py", line 53, in from plumbum.version import version as release ModuleNotFoundError: No module named 'plumbum' ```

This can be fixed by patch like below:

--- a/docs/conf.py
+++ b/docs/conf.py
@@ -17,7 +17,7 @@
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-# sys.path.insert(0, os.path.abspath('.'))
+sys.path.insert(0, os.path.abspath('..'))

 # -- General configuration -----------------------------------------------------

This patch fixes what is in the comment and that can of fix is suggested in sphinx example copy.py https://www.sphinx-doc.org/en/master/usage/configuration.html#example-of-configuration-file

Than .. on building my packages I'm using sphinx-build command with -n switch which shows warmings about missing references. These are not critical issues.

Here is sphinx output with warnings:

```console + /usr/bin/sphinx-build -n -T -b man docs build/sphinx/man Running Sphinx v7.0.1 making output directory... done building [mo]: targets for 0 po files that are out of date writing output... building [man]: all manpages updating environment: [new config] 18 added, 0 changed, 0 removed reading sources... [100%] utils /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/colorlib/styles.py:docstring of plumbum.colorlib.styles.Color.number:1: WARNING: duplicate object description of plumbum.colorlib.styles.Color.number, other instance in api/colors, use :noindex: for one of them /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/quickref.rst:75: ERROR: Malformed table. Text in column margin in table line 12. ====================== ===================================== Utility Usage ====================== ===================================== ``PROGNAME=`` Custom program name and/or color ``VERSION=`` Custom version ``DESCRIPTION=`` Custom description (or use docstring) ``DESCRIPTION_MORE=`` Custom description with whitespace ``ALLOW_ABREV=True`` Allow argparse style abbreviations ``COLOR_USAGE=`` Custom color for usage statement ``COLOR_USAGE_TITLE=`` Custom color for usage statement's title ``COLOR_GROUPS=`` Colors of groups (dictionary) ``COLOR_GROUP_TITLES=`` Colors of group titles (dictionary) ====================== ===================================== looking for now-outdated files... none found pickling environment... done checking consistency... done writing... python-plumbum.3 { local_commands paths local_machine remote utils cli typed_env colors changelog quickref api/cli api/commands api/machines api/path api/fs api/colors colorlib } /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/paths.rst:7: WARNING: py:func reference target not found: platform.local_machine.LocalMachine.path /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/remote.rst:36: WARNING: py:class reference target not found: plumbum.remote_machine.SshMachine /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/remote.rst:43: WARNING: py:class reference target not found: plumbum.remote_machine.PuttyMachine /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/remote.rst:190: WARNING: py:class reference target not found: plumbum.paramiko_machine.ParamikoMachine /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/utils.rst:34: WARNING: py:func reference target not found: plumbum.path.utils.xdg_open /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/cli.rst:14: WARNING: py:class reference target not found: plumbum.cli.Application /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/cli.rst:14: WARNING: py:func reference target not found: plumbum.cli.switch /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/cli.rst:57: WARNING: py:class reference target not found: plumbum.cli.Application /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/cli.rst:125: WARNING: py:func reference target not found: plumbum.cli.switch /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/cli.rst:154: WARNING: py:func reference target not found: plumbum.cli.autoswitch /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/cli.rst:322: WARNING: py:class reference target not found: plumbum.cli.SwitchAttr /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/typed_env.rst:5: WARNING: py:class reference target not found: plumbum.cli.Application /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/docs/typed_env.rst:5: WARNING: py:class reference target not found: plumbum.typed_env.TypedEnv /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.switch:25: WARNING: py:func reference target not found: plumbum.cli.WrongArgumentType /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.switch:42: WARNING: py:class reference target not found: plumbum.cli.MissingMandatorySwitch /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.switch:46: WARNING: py:class reference target not found: plumbum.cli.SwitchCombinationError /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.switch:62: WARNING: py:class reference target not found: plumbum.cli.SwitchCombinationError /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.autoswitch:1: WARNING: py:func reference target not found: plumbum.cli.switch /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.SwitchAttr:14: WARNING: py:func reference target not found: plumbum.cli.switch /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.Flag:1: WARNING: py:class reference target not found: plumbum.cli.SwitchAttr /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.Flag:10: WARNING: py:func reference target not found: plumbum.cli.switch /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.CountOf:1: WARNING: py:class reference target not found: plumbum.cli.SwitchAttr /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.CountOf:11: WARNING: py:func reference target not found: plumbum.cli.switch /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/cli/switches.py:docstring of plumbum.cli.switches.Set:1: WARNING: py:class reference target not found: collections.abc.Set /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.processes.iter_lines:1: WARNING: py:class reference target not found: plumbum.commands.ProcessExecutionError /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.processes.iter_lines:17: WARNING: py:class reference target not found: plumbum.commands.ProcessLineTimedOut /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.processes.run_proc:10: WARNING: py:class reference target not found: plumbum.cli.ProcessTimedOut /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.base.BaseCommand.popen:5: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.base.BaseCommand.bgrun:18: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.base.BaseCommand.run:1: WARNING: py:func reference target not found: plumbum.commands.run_proc /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.base.BaseCommand.run:1: WARNING: py:class reference target not found: plumbum.commands.ProcessExecutionError /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.base.Pipeline.popen:5: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.base.BaseRedirection.popen:5: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.base.BoundCommand.popen:5: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.base.BoundEnvCommand.popen:5: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.base.ConcreteCommand.popen:5: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/base.py:docstring of plumbum.commands.base.StdinDataRedirection.popen:5: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/modifiers.py:docstring of plumbum.commands.modifiers.Future.wait:1: WARNING: py:class reference target not found: plumbum.commands.ProcessExecutionError /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/processes.py:docstring of plumbum.commands.processes.ProcessExecutionError:1: WARNING: py:func reference target not found: plumbum.commands.run_proc /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/processes.py:docstring of plumbum.commands.processes.ProcessTimedOut:1: WARNING: py:func reference target not found: plumbum.commands.run_proc /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/processes.py:docstring of plumbum.commands.processes.ProcessLineTimedOut:1: WARNING: py:func reference target not found: plumbum.commands.iter_lines /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/processes.py:docstring of plumbum.commands.processes.CommandNotFound:1: WARNING: py:func reference target not found: plumbum.machines.remote.RemoteMachine.which /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/processes.py:docstring of plumbum.commands.processes.run_proc:10: WARNING: py:class reference target not found: plumbum.cli.ProcessTimedOut /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/processes.py:docstring of plumbum.commands.processes.iter_lines:1: WARNING: py:class reference target not found: plumbum.commands.ProcessExecutionError /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/commands/processes.py:docstring of plumbum.commands.processes.iter_lines:17: WARNING: py:class reference target not found: plumbum.commands.ProcessLineTimedOut /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/local.py:docstring of plumbum.commands.processes.iter_lines:1: WARNING: py:class reference target not found: plumbum.commands.ProcessExecutionError /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/local.py:docstring of plumbum.commands.processes.iter_lines:17: WARNING: py:class reference target not found: plumbum.commands.ProcessLineTimedOut /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/local.py:docstring of plumbum.machines.local.LocalCommand.popen:5: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/local.py:docstring of plumbum.machines.local.LocalMachine.which:1: WARNING: py:class reference target not found: plumbum.commands.CommandNotFound /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/local.py:docstring of plumbum.machines.local.LocalMachine.which:9: WARNING: py:class reference target not found: plumbum.machines.local.LocalPath /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/local.py:docstring of plumbum.machines.local.LocalMachine.session:1: WARNING: py:class reference target not found: plumbum.session.ShellSession /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/session.py:docstring of plumbum.machines.session.ShellSessionError:1: WARNING: py:func reference target not found: plumbum.session.ShellSession.popen /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/session.py:docstring of plumbum.machines.session.ShellSession:1: WARNING: py:class reference target not found: plumbum.machines.remote.SshMachine /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/session.py:docstring of plumbum.machines.session.ShellSession.popen:4: WARNING: py:class reference target not found: plumbum.commands.BaseCommand /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/session.py:docstring of plumbum.machines.session.ShellSession.popen:6: WARNING: py:class reference target not found: plumbum.session.SessionPopen /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/session.py:docstring of plumbum.machines.session.ShellSession.run:3: WARNING: py:class reference target not found: plumbum.commands.BaseCommand /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/remote.py:docstring of plumbum.machines.remote.RemoteCommand.popen:5: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/remote.py:docstring of plumbum.machines.remote.RemoteCommand.popen:5: WARNING: py:class reference target not found: plumbum.commands.BG /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/remote.py:docstring of plumbum.machines.remote.BaseRemoteMachine.which:1: WARNING: py:class reference target not found: plumbum.commands.CommandNotFound /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/remote.py:docstring of plumbum.machines.remote.BaseRemoteMachine.which:9: WARNING: py:class reference target not found: plumbum.path.local.RemotePath /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/remote.py:docstring of plumbum.machines.remote.BaseRemoteMachine.session:1: WARNING: py:class reference target not found: plumbum.session.ShellSession /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/remote.py:docstring of plumbum.machines.remote.BaseRemoteMachine.download:1: WARNING: py:class reference target not found: plumbum.machines.local.LocalPath /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/remote.py:docstring of plumbum.machines.remote.BaseRemoteMachine.upload:1: WARNING: py:class reference target not found: plumbum.machines.local.LocalPath /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/ssh_machine.py:docstring of plumbum.machines.ssh_machine.SshTunnel:1: WARNING: py:func reference target not found: plumbum.machines.remote.SshMachine.tunnel /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/ssh_machine.py:docstring of plumbum.machines.ssh_machine.SshMachine.session:1: WARNING: py:class reference target not found: plumbum.session.ShellSession /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/ssh_machine.py:docstring of plumbum.machines.ssh_machine.SshMachine.tunnel:1: WARNING: py:class reference target not found: plumbum.machines.remote.SshTunnel /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/ssh_machine.py:docstring of plumbum.machines.ssh_machine.SshMachine.download:1: WARNING: py:class reference target not found: plumbum.machines.local.LocalPath /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/ssh_machine.py:docstring of plumbum.machines.ssh_machine.SshMachine.upload:1: WARNING: py:class reference target not found: plumbum.machines.local.LocalPath /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/ssh_machine.py:docstring of plumbum.machines.ssh_machine.PuttyMachine:4: WARNING: py:class reference target not found: plumbum.machines.remote.SshMachine /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/ssh_machine.py:docstring of plumbum.machines.ssh_machine.PuttyMachine.session:1: WARNING: py:class reference target not found: plumbum.session.ShellSession /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/paramiko_machine.py:docstring of plumbum.machines.paramiko_machine.ParamikoMachine.session:1: WARNING: py:class reference target not found: plumbum.session.ShellSession /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/paramiko_machine.py:docstring of plumbum.machines.paramiko_machine.ParamikoMachine.download:1: WARNING: py:class reference target not found: plumbum.machines.local.LocalPath /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/machines/paramiko_machine.py:docstring of plumbum.machines.paramiko_machine.ParamikoMachine.upload:1: WARNING: py:class reference target not found: plumbum.machines.local.LocalPath /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path:1: WARNING: py:class reference target not found: plumbum.machines.local.LocalPath /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.__truediv__:1: WARNING: py:class reference target not found: plumbum.path.base._PathImpl /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.dirname:1: WARNING: py:class reference target not found: plumbum.path.base._PathImpl /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.uid:1: WARNING: py:class reference target not found: plumbum.path.FSUser /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.gid:1: WARNING: py:class reference target not found: plumbum.path.FSUser /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.join:1: WARNING: py:class reference target not found: plumbum.path.base._PathImpl /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.list:1: WARNING: py:class reference target not found: plumbum.path.base._PathImpl /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.iterdir:1: WARNING: py:class reference target not found: plumbum.path.base._PathImpl /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.stat:1: WARNING: py:class reference target not found: os.stat_result /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.with_name:1: WARNING: py:class reference target not found: plumbum.path.base._PathImpl /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.with_suffix:1: WARNING: py:class reference target not found: plumbum.path.base._PathImpl /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.glob:1: WARNING: py:class reference target not found: plumbum.path.base._PathImpl /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/base.py:docstring of plumbum.path.base.Path.open:1: WARNING: py:class reference target not found: io.IOBase /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/local.py:docstring of plumbum.path.local.LocalPath.uid:1: WARNING: py:class reference target not found: plumbum.path.FSUser /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/local.py:docstring of plumbum.path.local.LocalPath.gid:1: WARNING: py:class reference target not found: plumbum.path.FSUser /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/remote.py:docstring of plumbum.path.remote.RemotePath.uid:1: WARNING: py:class reference target not found: plumbum.path.FSUser /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/path/remote.py:docstring of plumbum.path.remote.RemotePath.gid:1: WARNING: py:class reference target not found: plumbum.path.FSUser /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/fs/atomic.py:docstring of plumbum.fs.atomic.PidFile.acquire:1: WARNING: py:class reference target not found: plumbum.atomic.PidFileTaken /home/tkloczko/rpmbuild/BUILD/plumbum-1.8.2/plumbum/fs/mounts.py:docstring of plumbum.fs.mounts.mount_table:1: WARNING: py:class reference target not found: plumbum.unixutils.MountEntry done build succeeded, 94 warnings. ```

You can peak on fixes that kind of issues in other projects https://github.com/RDFLib/rdflib-sqlalchemy/issues/95 https://github.com/RDFLib/rdflib/pull/2036 https://github.com/click-contrib/sphinx-click/commit/abc31069 https://github.com/frostming/unearth/issues/14 https://github.com/jaraco/cssutils/issues/21 https://github.com/latchset/jwcrypto/pull/289 https://github.com/latchset/jwcrypto/pull/289 https://github.com/pypa/distlib/commit/98b9b89f https://github.com/pywbem/pywbem/pull/2895 https://github.com/sissaschool/elementpath/commit/bf869d9e https://github.com/sissaschool/xmlschema/commit/42ea98f2 https://github.com/sqlalchemy/sqlalchemy/commit/5e88e6e8