How To Install python3-autoclasstoc on Fedora 36

In this tutorial we learn how to install python3-autoclasstoc in Fedora 36. python3-autoclasstoc is Add a succinct TOC to auto-documented classes

Introduction

In this tutorial we learn how to install python3-autoclasstoc on Fedora 36.

What is python3-autoclasstoc

It’s surprisingly difficult to document large Python classes in a way that’s easy for users to navigate. Most projects use the autodoc Sphinx plugin, which simply puts the complete documentation for each class member one after another. While this does fully document the class, it doesn’t give the user a quick way to see everything the class can do. This makes classes of even moderate complexity difficult to navigate. It also encourages projects to be stingy about which class members to include in the documentation (e.g. excluding special methods, inherited methods, private methods, and/or undocumented methods), to the further detriment of the user. What’s needed is for each class to have a succinct table of contents (TOC) that • Is organized into sections that will be meaningful to the user. Different projects and classes may call for different sections, e.g. public/private methods, methods that share a decorator, methods with a common prefix, etc. • Includes every method of the class (so that the documentation is complete), while still making it easy for the user to get a sense for what the class does and find what they’re looking for. • Collapses inherited methods. Complex classes in particular can inherit a lot of methods from their parent classes, and while these methods should be present in the TOC (since they’re part of the class), collapsing them makes it easier for the user to grok the functionality provided by the class itself. autoclasstoc provides a new Restructured Text directive that is all of these things. It also works well with autodoc and autogen, and should be easy to incorporate into any existing project. See the complete documentation (https for more information (including examples).

We can use yum or dnf to install python3-autoclasstoc on Fedora 36. In this tutorial we discuss both methods but you only need to choose one of method to install python3-autoclasstoc.

Install python3-autoclasstoc on Fedora 36 Using dnf

Update yum database with dnf using the following command.

sudo dnf makecache --refresh

After updating yum database, We can install python3-autoclasstoc using dnf by running the following command:

sudo dnf -y install python3-autoclasstoc

Install python3-autoclasstoc on Fedora 36 Using yum

Update yum database with yum using the following command.

sudo yum makecache --refresh

After updating yum database, We can install python3-autoclasstoc using yum by running the following command:

sudo yum -y install python3-autoclasstoc

How To Uninstall python3-autoclasstoc on Fedora 36

To uninstall only the python3-autoclasstoc package we can use the following command:

sudo dnf remove python3-autoclasstoc

python3-autoclasstoc Package Contents on Fedora 36

/usr/lib/python3.10/site-packages/autoclasstoc
/usr/lib/python3.10/site-packages/autoclasstoc-1.3.0.dist-info
/usr/lib/python3.10/site-packages/autoclasstoc-1.3.0.dist-info/INSTALLER
/usr/lib/python3.10/site-packages/autoclasstoc-1.3.0.dist-info/LICENSE.txt
/usr/lib/python3.10/site-packages/autoclasstoc-1.3.0.dist-info/METADATA
/usr/lib/python3.10/site-packages/autoclasstoc-1.3.0.dist-info/WHEEL
/usr/lib/python3.10/site-packages/autoclasstoc/__init__.py
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/__init__.cpython-310.opt-1.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/__init__.cpython-310.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/errors.cpython-310.opt-1.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/errors.cpython-310.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/nodes.cpython-310.opt-1.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/nodes.cpython-310.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/plugin.cpython-310.opt-1.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/plugin.cpython-310.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/sections.cpython-310.opt-1.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/sections.cpython-310.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/utils.cpython-310.opt-1.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/__pycache__/utils.cpython-310.pyc
/usr/lib/python3.10/site-packages/autoclasstoc/_static
/usr/lib/python3.10/site-packages/autoclasstoc/_static/autoclasstoc.css
/usr/lib/python3.10/site-packages/autoclasstoc/errors.py
/usr/lib/python3.10/site-packages/autoclasstoc/nodes.py
/usr/lib/python3.10/site-packages/autoclasstoc/plugin.py
/usr/lib/python3.10/site-packages/autoclasstoc/sections.py
/usr/lib/python3.10/site-packages/autoclasstoc/utils.py
/usr/share/doc/python3-autoclasstoc
/usr/share/doc/python3-autoclasstoc/README.rst
/usr/share/licenses/python3-autoclasstoc
/usr/share/licenses/python3-autoclasstoc/LICENSE.txt

References

Summary

In this tutorial we learn how to install python3-autoclasstoc on Fedora 36 using yum and [dnf]((/fedora/36/dnf/).