Fixes for sphinx build

[ericwb]

• The build_sphinx command has long since replaced with sphinx-build.
• The root of the docs is now defined by root_doc instead of master_doc
• Guard against the importlib.metadata.PackageNotFoundError exception occurring during the Sphinx build.
• Update the copyright to current year
• Use a platform agnostic sys.path loading in Sphinx conf

[ericwb]

Verified it is now building: https://readthedocs.org/projects/bandit/builds/22008003/

[ericwb]

Verified it is now building: https://readthedocs.org/projects/bandit/builds/22008003/

Nevermind, it's building, but the output looks very broken.

[ericwb]

Docs now build and look proper: https://bandit.readthedocs.io/en/ericwb-patch-2/

[ericwb]

FYI, the cryptic error from the Sphinx build looks like the following:

WARNING: autodoc: failed to import module 'formatters.screen' from module 'bandit'; the following exception was raised:
bandit

https://readthedocs.org/projects/bandit/builds/22797524/

Sphinx is swallowing the full exception, but it's raising a importlib.metadata.PackageNotFoundError

[sigmavirus24]

We can install bandit as a requirement for building the docs. This is fairly common. It will resolve the version issue

[sigmavirus24]

Let's install bandit from source locally to avoid the importlib problem

[sigmavirus24]

Please no

[ericwb]

We can install bandit as a requirement for building the docs. This is fairly common. It will resolve the version issue

Thanks for the tip. That does work better!

[ericwb]

Latest build and output:
https://readthedocs.org/projects/bandit/builds/22799290/
https://bandit.readthedocs.io/en/ericwb-patch-2/