Support of documentation commands and extensions for setuptools / distutils.
The ‘setupdocx‘ provides a control layer for continuous documentation by the simplified creation, packaging, and installation of documentation. The provided commands are distributed as entry points and optional base classes for further customization into setup.py - setuptools / distutils.
The current release supports the following commands:
build_docx - Enhanced documentation.
Supports the first integration of Epydoc into Sphinx for combined Javadoc style documentation of Python and Java. Manages arbitrary document templates for the supported builder, supports multiple builds with arbitrary document layouts, designs, and patched contents.
install_docx - Installs local documentation.
Installs documentation locally from build directory, see PEP-0370.
dist_docx - Documentation packaging.
Creates distribution packages for documentation.
build_apidoc - Standalone Generator for API Documentation
Extracts the inline documentation only. Manages arbitrary document templates for the supported builder, supports multiple builds with arbitrary document layouts, designs, and patched contents.
build_apiref - Standalone Generator for API Reference
Extracts the inline documentation as JavaDoc style API reference. Manages arbitrary document templates for the supported builder, supports multiple builds with arbitrary document layouts, designs, and patched contents.
For more extensions refer to the online documentation.
Install: pip install setupdocx, see also section ‘Install’ of the online documentation.
MISSION: Command extension of setup.py for multi-platform and documentation deployments.
AUTHOR: Arno-Can Uestuensoez
COPYRIGHT: Copyright (C) 2019 Arno-Can Uestuensoez @Ingenieurbuero Arno-Can Uestuensoez
LICENSE: Artistic-License-2.0 + Forced-Fairplay-Constraints
Concepts and enumeration values are migrated from the
UnifiedSessionsManager (C) 2008 Arno-Can Uestuensoez @Ingenieurbuero Arno-Can Uestuensoez.
Tested with Sphinx-1.7 on Python2.7.14, and Python3.6.5.
For a comprehensive list refer to the documentation.
Python Syntax Support
Python2.7, and Python3
Python Implementation Support
CPython, IPython, IronPython, Jython, and PyPy
OS on Server, Workstation, Laptops, Virtual Machines, and Containers
Linux: AlpineLinux, ArchLinux, CentOS, Debian, Fedora, Gentoo, OpenSUSE, Raspbian, RHEL, Slackware, SLES, Ubuntu, …
BSD: DragonFlyBSD, FreeBSD, NetBSD, OpenBSD, GhostBSD, TrueOS, NomadBSD
OS-X: Snow Leopard
Windows: Win10, Win8.1, Win7, WinXP, Win2019, Win2016, Win2012, Win2008, Win2000
WSL-1.0: Alpine, Debian, KaliLinux, openSUSE, SLES, Ubuntu
UNIX: Solaris10, Solaris11
Network and Security
Network Devices: OpenWRT
Security: KaliLinux, pfSense
OS on Embedded Devices
RaspberryPI: ArchLinux, CentOS, OpenBSD, OpenWRT, Raspbian
Currently tested by application to the other projects of the author. So for now no package tests defined.
Current release supports shell only and is released for bash, so safe to use on POSIX platforms. So may should on Windows-10 et.al. / NT-10.0, in any case in WSL. General support for Windows platforms is coming soon - so the full scale of platforms will be supported.
make all templates completely generic for any package - some like ‘man’ contain hardcoded names for setupdocx
Add optional gzip to man pages.
Add rpm, deb, apk.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.