Packaging fixes

[Zeitsperre]

Overview

Changes:

• Restructures the package so that the wheel does not install the testing and docs as non-importable packages
• Ensured that data required to run tests and build docs is present in the source distribution (via Manifest.in changes)
• Documentation now includes a sphinx-apidoc-based listing of all installed modules and functions
• Added sphinx-copybutton and sphinx-codeautolink in order to increase the usefulness of code-blocks in the example documentation (copying of code blocks and ability to click on birdy objects and go straight to the documentation entry for the object)
• All the documentation build warnings have been addressed
• Added the birdy[extra] pip install recipe to be able to install all extras needed more directly
• Raised the minimum Python required to 3.9 in the setup block
• Removed the Python package for pandoc (unmaintained)
• Added a documentation entry on using build to build the documentation.

Related Issue / Discussion

The changes here make it so that running the tests requires that the package is installed, as tests are no longer seen as part of the installed package. This reduces the size of the wheel significantly, while also making it so that source distributions have all the required files to run tests (good for conda-forge).

Eventually, it would be good to migrate this package to pyproject.toml to simplify/centralize a lot of these configurations, but this is fine for now.

Additional Information

@cehbrecht Would it make sense to perform another release after this? The changes are relatively significant to the packaging, but doesn't touch the core logic. Perhaps another patch release? I leave that decision up to you.

[cehbrecht]

Thanks for cleaning up birdy 🙂 Looks good 👍

Would it make sense to perform another release after this? The changes are relatively significant to the packaging, but doesn't touch the core logic. Perhaps another patch release? I leave that decision up to you.

I think a new release is worth it.