我有一台运行CherryPy（Python 2.7）的（公司）服务器。在服务器内，我们将大量的自定义服务（20多种）安装到各种URL。作为一个小团队，我们很难维护这些URL和服务的文档。尤其是在更新或添加新服务时。
我想做的是创建一个动态的“目录”页面，该页面可提取（a）所有已安装的应用程序（b）URL和（c）文档/使用说明。例如：
| Service | URL | Documentation |
|----------|-------------------------------|----------------------------|
| Report A | site.com/reporting/A/run | `?user=username&date=date` |
| Report A | site.com/reporting/A/index | `See all parameters` |
| Change | site.com/change/A/make_change | `?object=id` |
| Change | site.com/change/A/autochange | Only use for crontasks |
这是我尝试过的：
Pycco
选项一：使用Pycco从wsgi.py文件创建HTML。这很棒，因为这意味着我们有所有已安装应用程序的列表。但是，在每个路径上使用内联注释存储服务文档有点多余，在wsgi文件中造成很多膨胀，并且并不能真正解决程序员不更新wsgi.py而更新其各个模块的问题。 >
CherryPy.tree.apps
使用类似>>> [k for k,v in cherrypy.tree.apps.iteritems()]的东西，我可以创建所有URL的列表。但是，这是非常基本的-无法添加有关应用程序本身的信息。能够将URL列表绑定到各个模块，并使用模块文档以某种方式生成内容页面，将是很棒的。
有人可以建议吗？我可以根据需要安装软件包，但是CherryPy是必需的。