Est-ce que pydoc peut générer des sous-répertoires?

Question

Est-il possible d'obtenir la fonction writedocs() de pydoc pour créer des sous-répertoires pour les packages? Par exemple, disons que je les modules suivants document:

foo.py 
dir/bar.py 
dir/__init__.py 

Quand je lance pydoc.writedocs(), je reçois les fichiers suivants:

foo.html 
dir.bar.html 

Je voudrais obtenir:

foo.html 
dir/bar.html 

Y at-il un moyen de le faire?

Answer 1

pydoc.writedocs juste des boucles appelant writedoc, qui est documentée (et implémentée) pour "écrire un fichier dans le répertoire courant". La seule issue que je puisse voir est de faire une version modifiée et de la forcer (c'est-à-dire soupirer, monotyper) dans le module, ou d'en saisir un aspect clé, à savoir où 'open' s'ouvre pour écrire les fichiers HTML demandés ouvrir. Plus précisément, dans votre code, vous pouvez faire quelque chose comme:

import pydoc 

def monkey_open(name, option): 
    if option == 'w' and name.endswith('.html'): 
    name_pieces = name.split('.') 
    name_pieces[-2:] = '.'.join(name_pieces[-2:]) 
    name = '/'.join(name_pieces) 
    return open(name, option) 

pydoc.open = monkey_open 

Pas une solution élégante ou extrêmement robuste, mais « les besoins doivent » ... pydoc tout simplement pas conçu pour vous permettre de faire ce que vous voulez, donc la chose doit être "coincée" un peu.