Có cách tiêu chuẩn nào để liệt kê tên của các mô-đun Python trong một gói không?

Có cách nào đơn giản để liệt kê tên của tất cả các mô-đun trong một gói mà không cần sử dụng __all__không?

Ví dụ, với gói này:

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

Tôi đang tự hỏi liệu có cách chuẩn hoặc cách tích hợp nào để làm điều gì đó như thế này không:

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

Cách tiếp cận thủ công sẽ là lặp qua các đường dẫn tìm kiếm mô-đun để tìm thư mục của gói. Sau đó, người ta có thể liệt kê tất cả các tệp trong thư mục đó, lọc ra các tệp py / pyc / pyo có tên duy nhất, loại bỏ các phần mở rộng và trả lại danh sách đó. Nhưng điều này có vẻ như là một khối lượng công việc hợp lý cho một cái gì đó mà cơ chế nhập mô-đun đã thực hiện nội bộ. Chức năng đó có hiển thị ở bất cứ đâu không?

Có lẽ điều này sẽ làm những gì bạn đang tìm kiếm?

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)])

Sử dụng python2.3 trở lên , bạn cũng có thể sử dụng pkgutilmô-đun:

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

CHỈNH SỬA: Lưu ý rằng tham số không phải là danh sách các mô-đun, mà là danh sách các đường dẫn, vì vậy bạn có thể muốn thực hiện điều gì đó như sau:

>>> 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)

Không biết liệu tôi có đang bỏ qua điều gì không, hay câu trả lời chỉ là lạc hậu nhưng;

Như đã nêu bởi user815423426, điều này chỉ hoạt động với các đối tượng trực tiếp và các mô-đun được liệt kê chỉ là các mô-đun đã được nhập trước đó.

Liệt kê các mô-đun trong một gói có vẻ thực sự dễ dàng bằng cách sử dụng kiểm tra :

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

Đây là phiên bản đệ quy hoạt động với python 3.6 trở lên:

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

Dựa trên ví dụ của cdleary, đây là đường dẫn liệt kê phiên bản đệ quy cho tất cả các mô-đun con:

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)

Điều này sẽ liệt kê các mô-đun:

help("modules")

Nếu bạn muốn xem thông tin về gói của mình bên ngoài mã python (từ dấu nhắc lệnh), bạn có thể sử dụng pydoc cho nó.

# 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>

Bạn sẽ có kết quả tương tự như pydoc nhưng bên trong trình thông dịch sử dụng trợ giúp

>>> 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("__")]

in dir (mô-đun)