Existe uma maneira padrão de listar nomes de módulos Python em um pacote?

Existe uma maneira direta de listar os nomes de todos os módulos em um pacote, sem usar __all__?

Por exemplo, dado este pacote:

/testpkg
/testpkg/__init__.py
/testpkg/modulea.py
/testpkg/moduleb.py

Estou me perguntando se existe uma maneira padrão ou integrada de fazer algo assim:

>>> package_contents("testpkg")
['modulea', 'moduleb']

A abordagem manual seria iterar pelos caminhos de pesquisa do módulo para encontrar o diretório do pacote. Pode-se então listar todos os arquivos nesse diretório, filtrar os arquivos py / pyc / pyo nomeados exclusivamente, remover as extensões e retornar essa lista. Mas isso parece uma quantidade razoável de trabalho para algo que o mecanismo de importação de módulo já está fazendo internamente. Essa funcionalidade está exposta em algum lugar?

Talvez isso faça o que você está procurando?

import imp
import os
MODULE_EXTENSIONS = ('.py', '.pyc', '.pyo')

def package_contents(package_name):
    file, pathname, description = imp.find_module(package_name)
    if file:
        raise ImportError('Not a package: %r', package_name)
    # Use a set because some may be both source and compiled.
    return set([os.path.splitext(module)[0]
        for module in os.listdir(pathname)
        if module.endswith(MODULE_EXTENSIONS)])

Usando python2.3 e superior , você também pode usar o pkgutilmódulo:

>>> import pkgutil
>>> [name for _, name, _ in pkgutil.iter_modules(['testpkg'])]
['modulea', 'moduleb']

EDITAR: Observe que o parâmetro não é uma lista de módulos, mas uma lista de caminhos, então você pode querer fazer algo assim:

>>> import os.path, pkgutil
>>> import testpkg
>>> pkgpath = os.path.dirname(testpkg.__file__)
>>> print [name for _, name, _ in pkgutil.iter_modules([pkgpath])]

import module
help(module)

Não sei se estou negligenciando algo, ou se as respostas estão apenas desatualizadas, mas;

Conforme declarado pelo usuário815423426, isso só funciona para objetos ativos e os módulos listados são apenas módulos que foram importados antes.

Listar módulos em um pacote parece muito fácil usando inspect :

>>> import inspect, testpkg
>>> inspect.getmembers(testpkg, inspect.ismodule)
['modulea', 'moduleb']

Esta é uma versão recursiva que funciona com o python 3.6 e superior:

import importlib.util
from pathlib import Path
import os
MODULE_EXTENSIONS = '.py'

def package_contents(package_name):
    spec = importlib.util.find_spec(package_name)
    if spec is None:
        return set()

    pathname = Path(spec.origin).parent
    ret = set()
    with os.scandir(pathname) as entries:
        for entry in entries:
            if entry.name.startswith('__'):
                continue
            current = '.'.join((package_name, entry.name.partition('.')[0]))
            if entry.is_file():
                if entry.name.endswith(MODULE_EXTENSIONS):
                    ret.add(current)
            elif entry.is_dir():
                ret.add(current)
                ret |= package_contents(current)


    return ret

Com base no exemplo de cdleary, aqui está um caminho de listagem de versão recursiva para todos os submódulos:

import imp, os

def iter_submodules(package):
    file, pathname, description = imp.find_module(package)
    for dirpath, _, filenames in os.walk(pathname):
        for  filename in filenames:
            if os.path.splitext(filename)[1] == ".py":
                yield os.path.join(dirpath, filename)

Isso deve listar os módulos:

help("modules")

Se você gostaria de ver uma informação sobre o seu pacote fora do código Python (de um prompt de comando), você pode usar o pydoc para isso.

# get a full list of packages that you have installed on you machine
$ python -m pydoc modules

# get information about a specific package
$ python -m pydoc <your package>

Você terá o mesmo resultado que pydoc, mas dentro do interpretador usando a ajuda

>>> import <my package>
>>> help(<my package>)

def package_contents(package_name):
  package = __import__(package_name)
  return [module_name for module_name in dir(package) if not module_name.startswith("__")]

imprimir dir (módulo)