Nhập động Python theo tên tệp

Functions

Việc triển khai chức năng tích hợp

Ghi chú

Nhập mô-đun theo chương trình nên sử dụng thay vì chức năng này

Nhập một mô-đun. Đối số tên chỉ định mô-đun nào sẽ nhập theo thuật ngữ tuyệt đối hoặc tương đối (e. g. hoặc là

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Hàm hoạt động như một trình bao bọc đơn giản hóa xung quanh. Điều này có nghĩa là tất cả ngữ nghĩa của hàm được lấy từ. Sự khác biệt quan trọng nhất giữa hai chức năng này là trả về gói hoặc mô-đun đã chỉ định (e. g.

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

Nếu bạn đang nhập động một mô-đun đã được tạo từ khi trình thông dịch bắt đầu thực thi (e. g. , đã tạo tệp nguồn Python), bạn có thể cần phải gọi để hệ thống nhập nhận thấy mô-đun mới

Đã thay đổi trong phiên bản 3. 3. Các gói gốc được nhập tự động.

Tìm trình tải cho một mô-đun, tùy chọn trong đường dẫn đã chỉ định. Nếu mô-đun ở trong , thì

import importlib

itertools = importlib.import_module('itertools')

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Một tên chấm không có cha mẹ của nó được nhập ngầm vì điều đó yêu cầu tải chúng và điều đó có thể không được mong muốn. Để nhập đúng cách một mô hình con, bạn sẽ cần nhập tất cả các gói mẹ của mô hình con và sử dụng đối số chính xác cho đường dẫn

Mới trong phiên bản 3. 3

Đã thay đổi trong phiên bản 3. 4. Nếu

import importlib

itertools = importlib.import_module('itertools')

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Không dùng nữa kể từ phiên bản 3. 4. Sử dụng thay thế.

Vô hiệu hóa bộ đệm nội bộ của công cụ tìm được lưu trữ tại. Nếu một công cụ tìm thực hiện

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

Mới trong phiên bản 3. 3

Đã thay đổi trong phiên bản 3. 10. Các gói không gian tên được tạo/cài đặt ở một vị trí khác sau khi cùng một không gian tên đã được nhập sẽ được chú ý.

Tải lại mô-đun đã nhập trước đó. Đối số phải là một đối tượng mô-đun, vì vậy nó phải được nhập thành công trước đó. Điều này hữu ích nếu bạn đã chỉnh sửa tệp nguồn mô-đun bằng trình chỉnh sửa bên ngoài và muốn dùng thử phiên bản mới mà không cần rời khỏi trình thông dịch Python. Giá trị trả về là đối tượng mô-đun (có thể khác nếu việc nhập lại khiến một đối tượng khác được đặt vào)

Khi nào được thực hiện

• Mã của mô-đun Python được biên dịch lại và mã cấp mô-đun được thực thi lại, xác định một nhóm đối tượng mới được liên kết với các tên trong từ điển của mô-đun bằng cách sử dụng lại đối tượng đã tải mô-đun ban đầu. Chức năng

  import importlib.util
  import sys
  
  # For illustrative purposes.
  name = 'itertools'
  
  if name in sys.modules:
      print(f"{name!r} already in sys.modules")
  elif (spec := importlib.util.find_spec(name)) is not None:
      # If you chose to perform the actual import ...
      module = importlib.util.module_from_spec(spec)
      sys.modules[name] = module
      spec.loader.exec_module(module)
      print(f"{name!r} has been imported")
  else:
      print(f"can't find the {name!r} module")
  

  4 của mô-đun mở rộng không được gọi lần thứ hai

• Như với tất cả các đối tượng khác trong Python, các đối tượng cũ chỉ được lấy lại sau khi số tham chiếu của chúng giảm xuống 0

• Tên trong không gian tên mô-đun được cập nhật để trỏ đến bất kỳ đối tượng mới hoặc thay đổi nào

• Các tham chiếu khác đến các đối tượng cũ (chẳng hạn như các tên bên ngoài mô-đun) không được phục hồi để tham chiếu đến các đối tượng mới và phải được cập nhật trong mỗi không gian tên nơi chúng xuất hiện nếu muốn

Có một số lưu ý khác

Khi một mô-đun được tải lại, từ điển của nó (chứa các biến toàn cục của mô-đun) được giữ lại. Định nghĩa lại tên sẽ ghi đè định nghĩa cũ, vì vậy đây thường không phải là vấn đề. Nếu phiên bản mới của mô-đun không xác định tên đã được xác định bởi phiên bản cũ, thì định nghĩa cũ vẫn còn. Tính năng này có thể được sử dụng để tạo lợi thế cho mô-đun nếu nó duy trì một bảng toàn cầu hoặc bộ đệm của các đối tượng — với một câu lệnh, nó có thể kiểm tra sự hiện diện của bảng và bỏ qua quá trình khởi tạo nếu muốn

try:
    cache
except NameError:
    cache = {}

Thường không hữu ích lắm khi tải lại các mô-đun tích hợp hoặc được tải động. Tải lại , và các mô-đun chính khác không được khuyến nghị. Trong nhiều trường hợp, các mô-đun mở rộng không được thiết kế để khởi tạo nhiều lần và có thể bị lỗi theo các cách tùy ý khi tải lại

Nếu một mô-đun nhập các đối tượng từ một mô-đun khác bằng cách sử dụng … …, thì việc gọi mô-đun kia không xác định lại các đối tượng được nhập từ nó — một cách để giải quyết vấn đề này là thực hiện lại câu lệnh

import importlib.util
import sys

# For illustrative purposes.
name = 'itertools'

if name in sys.modules:
    print(f"{name!r} already in sys.modules")
elif (spec := importlib.util.find_spec(name)) is not None:
    # If you chose to perform the actual import ...
    module = importlib.util.module_from_spec(spec)
    sys.modules[name] = module
    spec.loader.exec_module(module)
    print(f"{name!r} has been imported")
else:
    print(f"can't find the {name!r} module")

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Nếu một mô-đun khởi tạo các thể hiện của một lớp, thì việc tải lại mô-đun định nghĩa lớp đó không ảnh hưởng đến các định nghĩa phương thức của các thể hiện — chúng tiếp tục sử dụng định nghĩa lớp cũ. Điều này cũng đúng với các lớp dẫn xuất

Mới trong phiên bản 3. 4

Đã thay đổi trong phiên bản 3. 7. được nâng lên khi mô-đun được tải lại thiếu.

– Các lớp cơ sở trừu tượng liên quan đến nhập khẩu

Mã nguồn. Lib/nhậplib/abc. py

Mô-đun chứa tất cả các lớp cơ sở trừu tượng cốt lõi được sử dụng bởi. Một số lớp con của các lớp cơ sở trừu tượng cốt lõi cũng được cung cấp để giúp triển khai các ABC cốt lõi.

hệ thống phân cấp ABC

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Một lớp cơ sở trừu tượng đại diện cho một

Không dùng nữa kể từ phiên bản 3. 3. Sử dụng hoặc thay thế.

Một phương pháp trừu tượng để tìm một cho mô-đun được chỉ định. Ban đầu được chỉ định trong PEP 302, phương pháp này được dùng để sử dụng trong và trong hệ thống con nhập dựa trên đường dẫn

Đã thay đổi trong phiên bản 3. 4. Trả về

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Không dùng nữa kể từ phiên bản 3. 10. Triển khai hoặc thay thế.

Một lớp cơ sở trừu tượng đại diện cho một

Mới trong phiên bản 3. 3

Đã thay đổi trong phiên bản 3. 10. Không còn là lớp con của.

Một phương pháp trừu tượng để tìm một cho mô-đun được chỉ định. Nếu đây là lần nhập cấp cao nhất, đường dẫn sẽ là

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

import importlib.machinery
import sys

# For illustrative purposes only.
SpamMetaPathFinder = importlib.machinery.PathFinder
SpamPathEntryFinder = importlib.machinery.FileFinder
loader_details = (importlib.machinery.SourceFileLoader,
                  importlib.machinery.SOURCE_SUFFIXES)

# Setting up a meta path finder.
# Make sure to put the finder in the proper location in the list in terms of
# priority.
sys.meta_path.append(SpamMetaPathFinder)

# Setting up a path entry finder.
# Make sure to put the path hook in the proper location in the list in terms
# of priority.
sys.path_hooks.append(SpamPathEntryFinder.path_hook(loader_details))

import importlib.machinery
import sys

# For illustrative purposes only.
SpamMetaPathFinder = importlib.machinery.PathFinder
SpamPathEntryFinder = importlib.machinery.FileFinder
loader_details = (importlib.machinery.SourceFileLoader,
                  importlib.machinery.SOURCE_SUFFIXES)

# Setting up a meta path finder.
# Make sure to put the finder in the proper location in the list in terms of
# priority.
sys.meta_path.append(SpamMetaPathFinder)

# Setting up a path entry finder.
# Make sure to put the path hook in the proper location in the list in terms
# of priority.
sys.path_hooks.append(SpamPathEntryFinder.path_hook(loader_details))

Mới trong phiên bản 3. 4

Một phương pháp cũ để tìm một cho mô-đun được chỉ định. Nếu đây là lần nhập cấp cao nhất, đường dẫn sẽ là

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Nếu được xác định, chức năng tương thích ngược sẽ được cung cấp

Đã thay đổi trong phiên bản 3. 4. Trả về

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Không dùng nữa kể từ phiên bản 3. 4. Sử dụng thay thế.

Một phương thức tùy chọn, khi được gọi, sẽ làm mất hiệu lực bất kỳ bộ đệm nội bộ nào được sử dụng bởi công cụ tìm. Được sử dụng khi làm mất hiệu lực bộ đệm của tất cả các công cụ tìm trên

Đã thay đổi trong phiên bản 3. 4. Trả về

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

import importlib.util
import sys

def import_module(name, package=None):
    """An approximate implementation of import."""
    absolute_name = importlib.util.resolve_name(name, package)
    try:
        return sys.modules[absolute_name]
    except KeyError:
        pass

    path = None
    if '.' in absolute_name:
        parent_name, _, child_name = absolute_name.rpartition('.')
        parent_module = import_module(parent_name)
        path = parent_module.__spec__.submodule_search_locations
    for finder in sys.meta_path:
        spec = finder.find_spec(absolute_name, path)
        if spec is not None:
            break
    else:
        msg = f'No module named {absolute_name!r}'
        raise ModuleNotFoundError(msg, name=absolute_name)
    module = importlib.util.module_from_spec(spec)
    sys.modules[absolute_name] = module
    spec.loader.exec_module(module)
    if path is not None:
        setattr(parent_module, child_name, module)
    return module

Một lớp cơ sở trừu tượng đại diện cho một. Mặc dù nó có một số điểm tương đồng với , nhưng

>>> import importlib.util
>>> import sys
>>> def lazy_import(name):
..     spec = importlib.util.find_spec(name)
..     loader = importlib.util.LazyLoader(spec.loader)
..     spec.loader = loader
..     module = importlib.util.module_from_spec(spec)
..     sys.modules[name] = module
..     loader.exec_module(module)
..     return module
...
>>> lazy_typing = lazy_import("typing")
>>> #lazy_typing is a real module object,
>>> #but it is not loaded in memory yet.
>>> lazy_typing.TYPE_CHECKING
False

Mới trong phiên bản 3. 3

Đã thay đổi trong phiên bản 3. 10. Không còn là lớp con của.

Một phương pháp trừu tượng để tìm một cho mô-đun được chỉ định. Công cụ tìm sẽ chỉ tìm kiếm mô-đun trong phạm vi mà nó được gán. Nếu không thể tìm thấy một thông số kỹ thuật, thì trả về

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

import importlib.machinery
import sys

# For illustrative purposes only.
SpamMetaPathFinder = importlib.machinery.PathFinder
SpamPathEntryFinder = importlib.machinery.FileFinder
loader_details = (importlib.machinery.SourceFileLoader,
                  importlib.machinery.SOURCE_SUFFIXES)

# Setting up a meta path finder.
# Make sure to put the finder in the proper location in the list in terms of
# priority.
sys.meta_path.append(SpamMetaPathFinder)

# Setting up a path entry finder.
# Make sure to put the path hook in the proper location in the list in terms
# of priority.
sys.path_hooks.append(SpamPathEntryFinder.path_hook(loader_details))

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Mới trong phiên bản 3. 4

Một phương pháp cũ để tìm một cho mô-đun được chỉ định. Trả về 2-tuple của

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Nếu được xác định thì chức năng tương thích ngược được cung cấp

Đã thay đổi trong phiên bản 3. 4. Trả về

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Không dùng nữa kể từ phiên bản 3. 4. Sử dụng thay thế.

Việc triển khai cụ thể tương đương với

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Không dùng nữa kể từ phiên bản 3. 4. Sử dụng thay thế.

Một phương thức tùy chọn, khi được gọi, sẽ làm mất hiệu lực bất kỳ bộ đệm nội bộ nào được sử dụng bởi công cụ tìm. Được sử dụng khi vô hiệu hóa bộ đệm của tất cả các công cụ tìm được lưu trong bộ đệm

Một lớp cơ sở trừu tượng cho một. Xem PEP 302 để biết định nghĩa chính xác cho bộ nạp

Các trình tải muốn hỗ trợ đọc tài nguyên nên triển khai phương pháp

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Đã thay đổi trong phiên bản 3. 7. Giới thiệu phương pháp

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Phương thức trả về đối tượng mô-đun để sử dụng khi nhập mô-đun. Phương thức này có thể trả về

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Mới trong phiên bản 3. 4

Đã thay đổi trong phiên bản 3. 6. Phương thức này không còn tùy chọn khi được xác định.

Một phương thức trừu tượng thực thi mô-đun trong không gian tên của chính nó khi một mô-đun được nhập hoặc tải lại. Mô-đun đã được khởi tạo khi được gọi. Khi phương pháp này tồn tại, phải được xác định

Mới trong phiên bản 3. 4

Đã thay đổi trong phiên bản 3. 6. cũng phải được xác định.

Một phương pháp cũ để tải một mô-đun. Nếu không thể tải mô-đun, nó sẽ được nâng lên, nếu không, mô-đun đã tải sẽ được trả về

Nếu mô-đun được yêu cầu đã tồn tại trong , mô-đun đó sẽ được sử dụng và tải lại. Mặt khác, trình tải sẽ tạo một mô-đun mới và chèn nó vào trước khi bất kỳ quá trình tải nào bắt đầu, để ngăn chặn việc nhập đệ quy. Nếu trình tải đã chèn một mô-đun và quá trình tải không thành công, thì trình tải phải loại bỏ mô-đun đó khỏi ;

Trình tải phải đặt một số thuộc tính trên mô-đun (lưu ý rằng một số thuộc tính này có thể thay đổi khi mô-đun được tải lại)

• Tên đầy đủ của mô-đun. Đó là

  object
   +-- Finder (deprecated)
   +-- MetaPathFinder
   +-- PathEntryFinder
   +-- Loader
        +-- ResourceLoader --------+
        +-- InspectLoader          |
             +-- ExecutionLoader --+
                                   +-- FileLoader
                                   +-- SourceLoader
  

  35 cho một mô-đun được thực thi

• Vị trí được sử dụng để tải mô-đun. Ví dụ: đối với các mô-đun được tải từ một. tệp py đây là tên tệp. Nó không được đặt trên tất cả các mô-đun (e. g. mô-đun tích hợp)

• Tên tệp của phiên bản đã biên dịch của mã mô-đun. Nó không được đặt trên tất cả các mô-đun (e. g. mô-đun tích hợp)

• Danh sách các vị trí nơi các mô hình con của gói sẽ được tìm thấy. Hầu hết thời gian đây là một thư mục duy nhất. Hệ thống nhập chuyển thuộc tính này tới

  object
   +-- Finder (deprecated)
   +-- MetaPathFinder
   +-- PathEntryFinder
   +-- Loader
        +-- ResourceLoader --------+
        +-- InspectLoader          |
             +-- ExecutionLoader --+
                                   +-- FileLoader
                                   +-- SourceLoader
  

  4 và tới công cụ tìm theo cách tương tự nhưng chỉ đối với gói hàng. Nó không được đặt trên các mô-đun không phải gói để nó có thể được sử dụng làm chỉ báo rằng mô-đun là một gói

• Tên đủ điều kiện của gói chứa mô-đun (hoặc chuỗi trống cho mô-đun cấp cao nhất). Nếu mô-đun là một gói thì điều này giống như

• Được sử dụng để tải mô-đun

Khi có sẵn thì chức năng tương thích ngược được cung cấp

Đã thay đổi trong phiên bản 3. 4. Tăng khi được gọi thay vì. Chức năng được cung cấp khi có sẵn.

Không dùng nữa kể từ phiên bản 3. 4. API được đề xuất để tải mô-đun là (và ). Trình tải nên thực hiện nó thay vì. Máy móc nhập khẩu lo tất cả các trách nhiệm khác khi được thực hiện.

Một phương thức kế thừa mà khi được triển khai sẽ tính toán và trả về biểu diễn của mô-đun đã cho, dưới dạng một chuỗi. Mặc định của loại mô-đun

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Mới trong phiên bản 3. 3

Đã thay đổi trong phiên bản 3. 4. Được tạo tùy chọn thay vì một phương thức trừu tượng.

Không dùng nữa kể từ phiên bản 3. 4. Máy móc nhập khẩu giờ đây sẽ tự động xử lý việc này.

Lớp cơ sở trừu tượng dành cho lớp triển khai giao thức PEP 302 tùy chọn để tải các tài nguyên tùy ý từ back-end lưu trữ

Không dùng nữa kể từ phiên bản 3. 7. ABC này không được dùng nữa để hỗ trợ tải tài nguyên thông qua.

Một phương thức trừu tượng để trả về các byte cho dữ liệu nằm ở đường dẫn. Các trình tải có back-end lưu trữ giống như tệp cho phép lưu trữ dữ liệu tùy ý có thể triển khai phương pháp trừu tượng này để cấp quyền truy cập trực tiếp vào dữ liệu được lưu trữ. sẽ được nâng lên nếu không tìm thấy đường dẫn. Đường dẫn dự kiến ​​sẽ được xây dựng bằng thuộc tính của mô-đun hoặc một mục từ gói

Đã thay đổi trong phiên bản 3. 4. Tăng thay vì.

Một lớp cơ sở trừu tượng để triển khai giao thức PEP 302 tùy chọn cho các bộ tải kiểm tra các mô-đun

Trả về đối tượng mã cho một mô-đun hoặc

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Ghi chú

Mặc dù phương thức này có cách triển khai mặc định, nhưng bạn nên ghi đè phương thức này nếu có thể để đảm bảo hiệu suất

Đã thay đổi trong phiên bản 3. 4. Không còn trừu tượng nữa và cung cấp triển khai cụ thể.

Một phương thức trừu tượng để trả về nguồn của một mô-đun. Nó được trả về dưới dạng một chuỗi văn bản bằng cách sử dụng , dịch tất cả các dấu phân cách dòng được nhận dạng thành

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Đã thay đổi trong phiên bản 3. 4. Tăng thay vì.

Một phương thức tùy chọn để trả về giá trị thực nếu mô-đun là một gói, nếu không thì trả về giá trị sai. được nâng lên nếu không thể tìm thấy mô-đun

Đã thay đổi trong phiên bản 3. 4. Tăng thay vì.

Tạo một đối tượng mã từ nguồn Python

Đối số dữ liệu có thể là bất kỳ thứ gì mà hàm hỗ trợ (i. e. chuỗi hoặc byte). Đối số đường dẫn phải là “đường dẫn” đến nguồn gốc của mã nguồn, có thể là một khái niệm trừu tượng (e. g. vị trí trong tệp zip)

Với đối tượng mã tiếp theo, người ta có thể thực thi nó trong một mô-đun bằng cách chạy

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Mới trong phiên bản 3. 4

Đã thay đổi trong phiên bản 3. 5. Tạo phương thức tĩnh.

Tiến hành làm

Mới trong phiên bản 3. 4

Tiến hành làm

Không dùng nữa kể từ phiên bản 3. 4. sử dụng thay thế.

Một lớp cơ sở trừu tượng kế thừa từ đó, khi được triển khai, sẽ giúp một mô-đun được thực thi dưới dạng tập lệnh. ABC đại diện cho một giao thức PEP 302 tùy chọn

Một phương thức trừu tượng để trả về giá trị của mô-đun đã chỉ định. Nếu không có đường dẫn, được nâng lên

Nếu mã nguồn có sẵn, thì phương thức sẽ trả về đường dẫn đến tệp nguồn, bất kể mã byte có được sử dụng để tải mô-đun hay không

Đã thay đổi trong phiên bản 3. 4. Tăng thay vì.

Một lớp cơ sở trừu tượng kế thừa từ và, cung cấp các triển khai cụ thể của và

Đối số tên đầy đủ là tên được giải quyết đầy đủ của mô-đun mà trình tải sẽ xử lý. Đối số đường dẫn là đường dẫn đến tệp cho mô-đun

Mới trong phiên bản 3. 3

Tên của mô-đun mà trình tải có thể xử lý

Đường dẫn đến tệp của mô-đun

Gọi số tiền của

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Không dùng nữa kể từ phiên bản 3. 4. Sử dụng thay thế.

trả lại

Đọc đường dẫn dưới dạng tệp nhị phân và trả về các byte từ nó

Lớp cơ sở trừu tượng để triển khai tải tệp nguồn (và mã byte tùy chọn). Lớp kế thừa từ cả hai và , yêu cầu thực hiện

• Chỉ nên trả lại đường dẫn đến tệp nguồn;

Các phương thức trừu tượng được định nghĩa bởi lớp này là thêm hỗ trợ tệp mã byte tùy chọn. Việc không triển khai các phương thức tùy chọn này (hoặc khiến chúng tăng lên) khiến trình tải chỉ hoạt động với mã nguồn. Việc triển khai các phương thức cho phép trình tải hoạt động với các tệp mã nguồn và mã byte; . Các tệp mã byte là một tối ưu hóa để tăng tốc độ tải bằng cách loại bỏ bước phân tích cú pháp của trình biên dịch Python và do đó không có API dành riêng cho mã byte nào bị lộ

Phương thức trừu tượng tùy chọn trả về siêu dữ liệu có chứa về đường dẫn đã chỉ định. Các khóa từ điển được hỗ trợ là

• object
   +-- Finder (deprecated)
   +-- MetaPathFinder
   +-- PathEntryFinder
   +-- Loader
        +-- ResourceLoader --------+
        +-- InspectLoader          |
             +-- ExecutionLoader --+
                                   +-- FileLoader
                                   +-- SourceLoader
  

  93 (bắt buộc). một số nguyên hoặc số dấu phẩy động biểu thị thời gian sửa đổi của mã nguồn;

• object
   +-- Finder (deprecated)
   +-- MetaPathFinder
   +-- PathEntryFinder
   +-- Loader
        +-- ResourceLoader --------+
        +-- InspectLoader          |
             +-- ExecutionLoader --+
                                   +-- FileLoader
                                   +-- SourceLoader
  

  94 (tùy chọn). kích thước tính bằng byte của mã nguồn

Bất kỳ khóa nào khác trong từ điển đều bị bỏ qua, để cho phép mở rộng trong tương lai. Nếu đường dẫn không thể được xử lý, được nâng lên

Mới trong phiên bản 3. 3

Đã thay đổi trong phiên bản 3. 4. Tăng thay vì.

Phương thức trừu tượng tùy chọn trả về thời gian sửa đổi cho đường dẫn đã chỉ định

Không dùng nữa kể từ phiên bản 3. 3. Phương pháp này không được dùng nữa vì. Bạn không cần phải triển khai nó, nhưng nó vẫn có sẵn cho mục đích tương thích. Tăng nếu đường dẫn không thể được xử lý.

Đã thay đổi trong phiên bản 3. 4. Tăng thay vì.

Phương thức trừu tượng tùy chọn ghi các byte đã chỉ định vào đường dẫn tệp. Bất kỳ thư mục trung gian nào không tồn tại sẽ được tạo tự động

Khi ghi vào đường dẫn không thành công vì đường dẫn chỉ đọc (/), không truyền bá ngoại lệ

Đã thay đổi trong phiên bản 3. 4. Không còn tăng khi được gọi.

Triển khai cụ thể

Triển khai cụ thể

Mới trong phiên bản 3. 4

Triển khai cụ thể

Không dùng nữa kể từ phiên bản 3. 4. Sử dụng thay thế.

Triển khai cụ thể

Triển khai cụ thể. Một mô-đun được xác định là một gói nếu đường dẫn tệp của nó (như được cung cấp bởi ) là một tệp có tên

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

– Trình nhập và móc đường dẫn

Mã nguồn. Lib/importlib/máy móc. py

Mô-đun này chứa các đối tượng khác nhau giúp tìm và tải các mô-đun

Danh sách các chuỗi đại diện cho các hậu tố tệp được nhận dạng cho các mô-đun nguồn

Mới trong phiên bản 3. 3

Danh sách các chuỗi đại diện cho hậu tố tệp cho các mô-đun mã byte không được tối ưu hóa

Mới trong phiên bản 3. 3

Không dùng nữa kể từ phiên bản 3. 5. Sử dụng thay thế.

Danh sách các chuỗi đại diện cho hậu tố tệp cho các mô-đun mã byte được tối ưu hóa

Mới trong phiên bản 3. 3

Không dùng nữa kể từ phiên bản 3. 5. Sử dụng thay thế.

Danh sách các chuỗi đại diện cho các hậu tố tệp được nhận dạng cho các mô-đun mã byte (bao gồm cả dấu chấm ở đầu)

Mới trong phiên bản 3. 3

Đã thay đổi trong phiên bản 3. 5. Giá trị không còn phụ thuộc vào

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Danh sách các chuỗi đại diện cho các hậu tố tệp được công nhận cho các mô-đun mở rộng

Mới trong phiên bản 3. 3

Trả về một danh sách kết hợp các chuỗi đại diện cho tất cả các hậu tố tệp cho các mô-đun được máy móc nhập tiêu chuẩn nhận dạng. Đây là một trình trợ giúp cho mã chỉ cần biết liệu đường dẫn hệ thống tệp có khả năng đề cập đến một mô-đun mà không cần bất kỳ chi tiết nào về loại mô-đun hay không (ví dụ:)

Mới trong phiên bản 3. 3

Một cho các mô-đun tích hợp. Tất cả các mô-đun tích hợp đã biết được liệt kê trong. Lớp này thực hiện và ABC

Chỉ các phương thức lớp được lớp này định nghĩa để giảm bớt nhu cầu khởi tạo

Đã thay đổi trong phiên bản 3. 5. Là một phần của PEP 489, trình nhập khẩu dựng sẵn hiện triển khai

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

Một cho các mô-đun bị đóng băng. Lớp này thực hiện và ABC

Chỉ các phương thức lớp được lớp này định nghĩa để giảm bớt nhu cầu khởi tạo

Đã thay đổi trong phiên bản 3. 4. Đã đạt được phương pháp

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

object
 +-- Finder (deprecated)
 +-- MetaPathFinder
 +-- PathEntryFinder
 +-- Loader
      +-- ResourceLoader --------+
      +-- InspectLoader          |
           +-- ExecutionLoader --+
                                 +-- FileLoader
                                 +-- SourceLoader

cho các mô-đun được khai báo trong sổ đăng ký Windows. Lớp này thực hiện ABC

Chỉ các phương thức lớp được lớp này định nghĩa để giảm bớt nhu cầu khởi tạo

Mới trong phiên bản 3. 3

Không dùng nữa kể từ phiên bản 3. 6. Thay vào đó, hãy sử dụng cấu hình. Các phiên bản Python trong tương lai có thể không bật công cụ tìm này theo mặc định.

Một thuộc tính cho và gói

>>> import importlib.util
>>> import sys
>>> def lazy_import(name):
..     spec = importlib.util.find_spec(name)
..     loader = importlib.util.LazyLoader(spec.loader)
..     spec.loader = loader
..     module = importlib.util.module_from_spec(spec)
..     sys.modules[name] = module
..     loader.exec_module(module)
..     return module
...
>>> lazy_typing = lazy_import("typing")
>>> #lazy_typing is a real module object,
>>> #but it is not loaded in memory yet.
>>> lazy_typing.TYPE_CHECKING
False

Chỉ các phương thức lớp được lớp này định nghĩa để giảm bớt nhu cầu khởi tạo

Phương thức lớp cố gắng tìm một cho mô-đun được chỉ định bởi tên đầy đủ trên hoặc, nếu được xác định, trên đường dẫn. Đối với mỗi mục nhập đường dẫn được tìm kiếm, được kiểm tra. Nếu một đối tượng không sai được tìm thấy thì nó được sử dụng làm đối tượng để tìm mô-đun đang được tìm kiếm. Nếu không tìm thấy mục nào trong , thì sẽ tìm kiếm công cụ tìm mục nhập đường dẫn và nếu tìm thấy, sẽ được lưu vào cùng với việc được truy vấn về mô-đun. Nếu không tìm thấy công cụ tìm nào thì

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Mới trong phiên bản 3. 4

Đã thay đổi trong phiên bản 3. 5. Nếu thư mục làm việc hiện tại – được biểu thị bằng một chuỗi trống – không còn hiệu lực thì hàm trả về ___4_______0 nhưng không có giá trị nào được lưu trong bộ nhớ đệm.

Một trình bao bọc di sản xung quanh

Không dùng nữa kể từ phiên bản 3. 4. Sử dụng thay thế.

Gọi tất cả các công cụ tìm được lưu trữ trong đó xác định phương thức. Nếu không, các mục nhập được đặt thành

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Đã thay đổi trong phiên bản 3. 7. Các mục nhập của

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Đã thay đổi trong phiên bản 3. 4. Gọi các đối tượng trong thư mục làm việc hiện tại cho

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Một triển khai cụ thể trong đó bộ nhớ cache là kết quả từ hệ thống tệp

Đối số đường dẫn là thư mục mà công cụ tìm chịu trách nhiệm tìm kiếm

Đối số loader_details là một số lượng khác nhau của các bộ 2 mục, mỗi bộ chứa một trình tải và một chuỗi các hậu tố tệp mà trình tải nhận ra. Các trình tải dự kiến ​​​​là các hàm có thể gọi được chấp nhận hai đối số là tên của mô-đun và đường dẫn đến tệp được tìm thấy

Công cụ tìm sẽ lưu trữ nội dung thư mục khi cần thiết, thực hiện lệnh gọi stat cho từng tìm kiếm mô-đun để xác minh bộ đệm không bị lỗi thời. Vì độ ổn định của bộ nhớ cache phụ thuộc vào mức độ chi tiết của thông tin trạng thái của hệ điều hành đối với hệ thống tệp, nên có thể xảy ra tình trạng chạy đua tìm kiếm một mô-đun, tạo một tệp mới, sau đó tìm kiếm mô-đun mà tệp mới đại diện. Nếu các hoạt động diễn ra đủ nhanh để phù hợp với mức độ chi tiết của lệnh gọi stat, thì quá trình tìm kiếm mô-đun sẽ không thành công. Để ngăn điều này xảy ra, khi bạn tạo một mô-đun động, hãy nhớ gọi

Mới trong phiên bản 3. 3

Đường dẫn mà công cụ tìm sẽ tìm kiếm trong

Cố gắng tìm thông số kỹ thuật để xử lý tên đầy đủ trong

Mới trong phiên bản 3. 4

Cố gắng tìm trình tải để xử lý tên đầy đủ trong

Không dùng nữa kể từ phiên bản 3. 10. Sử dụng thay thế.

Xóa bộ nhớ cache nội bộ

Một phương thức lớp trả về một bao đóng để sử dụng trên. Một thể hiện của được trả về bởi bao đóng bằng cách sử dụng đối số đường dẫn được cung cấp trực tiếp cho bao đóng và loader_details gián tiếp

Nếu đối số để đóng không phải là một thư mục hiện có, được nâng lên

Việc triển khai cụ thể bằng cách phân lớp và cung cấp một số triển khai cụ thể của các phương thức khác

Mới trong phiên bản 3. 3

Tên của mô-đun mà trình tải này sẽ xử lý

Đường dẫn đến tệp nguồn

Trả lại

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Triển khai cụ thể

Triển khai cụ thể

Việc triển khai cụ thể nơi chỉ định tên của mô-đun sẽ tải là tùy chọn

Không dùng nữa kể từ phiên bản 3. 6. Sử dụng thay thế.

Việc triển khai cụ thể có thể nhập các tệp mã byte (i. e. không có tệp mã nguồn nào tồn tại)

Xin lưu ý rằng việc sử dụng trực tiếp các tệp mã byte (và do đó không phải tệp mã nguồn) sẽ ngăn các mô-đun của bạn sử dụng được bởi tất cả các triển khai Python hoặc các phiên bản Python mới làm thay đổi định dạng mã byte

Mới trong phiên bản 3. 3

Tên của mô-đun mà trình tải sẽ xử lý

Đường dẫn đến tệp mã byte

Xác định xem mô-đun có phải là một gói dựa trên

Trả về đối tượng mã được tạo từ

Trả về

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Việc triển khai cụ thể nơi chỉ định tên của mô-đun sẽ tải là tùy chọn

Không dùng nữa kể từ phiên bản 3. 6. Sử dụng thay thế.

Triển khai cụ thể cho các mô-đun mở rộng

Đối số tên đầy đủ chỉ định tên của mô-đun mà trình tải sẽ hỗ trợ. Đối số đường dẫn là đường dẫn đến tệp của mô-đun mở rộng

Mới trong phiên bản 3. 3

Tên của mô-đun mà trình tải hỗ trợ

Đường dẫn đến mô-đun mở rộng

Tạo đối tượng mô-đun từ thông số kỹ thuật đã cho theo PEP 489

Mới trong phiên bản 3. 5

Khởi tạo đối tượng mô-đun đã cho theo PEP 489

Mới trong phiên bản 3. 5

Trả về

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Trả về

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Trả về

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

trả lại

Mới trong phiên bản 3. 4

Một triển khai cụ thể cho các gói không gian tên. Đây là bí danh cho một lớp riêng tư và chỉ được công khai để xem xét nội quan thuộc tính

import importlib

itertools = importlib.import_module('itertools')

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Mới trong phiên bản 3. 11

Thông số kỹ thuật cho trạng thái liên quan đến hệ thống nhập của mô-đun. Điều này thường được hiển thị dưới dạng thuộc tính của mô-đun. Trong các mô tả bên dưới, các tên trong ngoặc đơn cung cấp thuộc tính tương ứng có sẵn trực tiếp trên đối tượng mô-đun, e. g.

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Mới trong phiên bản 3. 4

()

Tên đầy đủ của mô-đun. Phải luôn đặt thuộc tính này thành một chuỗi không trống

()

Được sử dụng để tải mô-đun. Phải luôn đặt thuộc tính này

()

Vị trí nên sử dụng để tải mô-đun. Ví dụ: đối với các mô-đun được tải từ một. tệp py đây là tên tệp. Phải luôn đặt thuộc tính này thành một giá trị có ý nghĩa để sử dụng. Trong trường hợp không phổ biến là không có (như đối với các gói không gian tên), nó nên được đặt thành

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

()

Danh sách các vị trí nơi các mô hình con của gói sẽ được tìm thấy. Hầu hết thời gian đây là một thư mục duy nhất. Nên đặt thuộc tính này thành một danh sách, thậm chí là một danh sách trống, để cho hệ thống nhập biết rằng mô-đun là một gói. Nó phải được đặt thành

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Có thể đặt thuộc tính này thành một đối tượng chứa dữ liệu bổ sung, dành riêng cho mô-đun để sử dụng khi tải mô-đun. Nếu không, nó nên được đặt thành

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

()

Tên tệp của phiên bản đã biên dịch của mã mô-đun. Phải luôn đặt thuộc tính này nhưng nó có thể là

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

()

(Chỉ đọc) Tên đủ điều kiện của gói chứa mô-đun (hoặc chuỗi trống cho mô-đun cấp cao nhất). Nếu mô-đun là một gói thì điều này giống như

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

– Mã tiện ích cho nhà nhập khẩu

Mã nguồn. Lib/importlib/tận dụng. py

Mô-đun này chứa các đối tượng khác nhau giúp xây dựng một

Các byte đại diện cho số phiên bản mã byte. Nếu bạn cần trợ giúp về việc tải/ghi mã byte thì hãy xem xét

Mới trong phiên bản 3. 4

Trả lại đường dẫn PEP 3147/PEP 488 cho tệp được biên dịch theo byte được liên kết với đường dẫn nguồn. Ví dụ: nếu đường dẫn là

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

Tham số tối ưu hóa được sử dụng để chỉ định mức độ tối ưu hóa của tệp mã byte. Chuỗi rỗng biểu thị không có tối ưu hóa, vì vậy,

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

Tham số debug_override không được dùng nữa và có thể được sử dụng để ghi đè giá trị của hệ thống cho

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Mới trong phiên bản 3. 4

Đã thay đổi trong phiên bản 3. 5. Tham số tối ưu hóa đã được thêm vào và tham số debug_override không được dùng nữa.

Đã thay đổi trong phiên bản 3. 6. Chấp nhận một.

Cung cấp đường dẫn đến tên tệp PEP 3147, trả lại đường dẫn tệp mã nguồn được liên kết. Ví dụ: nếu đường dẫn là

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

Mới trong phiên bản 3. 4

Đã thay đổi trong phiên bản 3. 6. Chấp nhận một.

Giải mã các byte đã cho đại diện cho mã nguồn và trả về nó dưới dạng một chuỗi với các dòng mới chung (theo yêu cầu của )

Mới trong phiên bản 3. 4

Phân giải tên mô-đun tương đối thành tên tuyệt đối

Nếu tên không có dấu chấm ở đầu, thì tên chỉ được trả về. Điều này cho phép sử dụng chẳng hạn như

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

được nâng lên nếu tên là tên mô-đun tương đối nhưng gói là giá trị sai (e. g.

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

Mới trong phiên bản 3. 3

Đã thay đổi trong phiên bản 3. 9. Để cải thiện tính nhất quán với câu lệnh nhập, hãy tăng thay vì tăng đối với các lần nhập tương đối không hợp lệ.

Tìm cho một mô-đun, tùy ý liên quan đến tên gói đã chỉ định. Nếu mô-đun ở trong , thì

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Nếu tên dành cho mô-đun con (chứa dấu chấm), mô-đun mẹ sẽ tự động được nhập

tên và gói hoạt động tương tự như đối với

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Mới trong phiên bản 3. 4

Đã thay đổi trong phiên bản 3. 7. Tăng thay vì nếu gói trên thực tế không phải là gói (i. e. thiếu một thuộc tính).

Tạo một mô-đun mới dựa trên thông số kỹ thuật và

Nếu không trả về

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

This function is preferred over using to create a new module as spec is used to set as many import-controlled attributes on the module as possible

Mới trong phiên bản 3. 5

A for to handle selecting the proper module object to load with. The decorated method is expected to have a call signature taking two positional arguments (e. g.

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

The decorated method will take in the name of the module to be loaded as expected for a . If the module is not found in then a new one is constructed. Regardless of where the module came from, set to self and is set based on what returns (if available). These attributes are set unconditionally to support reloading

If an exception is raised by the decorated method and a module was added to , then the module will be removed to prevent a partially initialized module from being in left in . If the module was already in then it is left alone

Changed in version 3. 3. and are automatically set (when possible).

Changed in version 3. 4. Set , unconditionally to support reloading.

Deprecated since version 3. 4. The import machinery now directly performs all the functionality provided by this function.

A for to set the attribute on the returned module. If the attribute is already set the decorator does nothing. It is assumed that the first positional argument to the wrapped method (i. e.

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

Changed in version 3. 4. Set

import importlib

itertools = importlib.import_module('itertools')

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Deprecated since version 3. 4. The import machinery takes care of this automatically.

A for to set the attribute on the returned module. If is set and has a value other than

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Deprecated since version 3. 4. The import machinery takes care of this automatically.

A factory function for creating a instance based on a loader. The parameters have the same meaning as they do for ModuleSpec. The function uses available APIs, such as

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

Mới trong phiên bản 3. 4

A factory function for creating a instance based on the path to a file. Missing information will be filled in on the spec by making use of loader APIs and by the implication that the module will be file-based

Mới trong phiên bản 3. 4

Đã thay đổi trong phiên bản 3. 6. Chấp nhận một.

Return the hash of source_bytes as bytes. A hash-based

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

New in version 3. 7

A class which postpones the execution of the loader of a module until the module has an attribute accessed

This class only works with loaders that define as control over what module type is used for the module is required. For those same reasons, the loader’s method must return

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

Ghi chú

For projects where startup time is critical, this class allows for potentially minimizing the cost of loading a module if it is never used. For projects where startup time is not essential then use of this class is heavily discouraged due to error messages created during loading being postponed and thus occurring out of context

Mới trong phiên bản 3. 5

Changed in version 3. 6. Began calling , removing the compatibility warning for and .

A static method which returns a callable that creates a lazy loader. This is meant to be used in situations where the loader is passed by class instead of by instance

suffixes = importlib.machinery.SOURCE_SUFFIXES
loader = importlib.machinery.SourceFileLoader
lazy_loader = importlib.util.LazyLoader.factory(loader)
finder = importlib.machinery.FileFinder(path, (lazy_loader, suffixes))

Examples

import importlib

itertools = importlib.import_module('itertools')

>>> from importlib.machinery import NamespaceLoader
>>> import my_namespace
>>> isinstance(my_namespace.__loader__, NamespaceLoader)
True
>>> import importlib.abc
>>> isinstance(my_namespace.__loader__, importlib.abc.Loader)
True

import importlib.util
import sys

# For illustrative purposes.
name = 'itertools'

if name in sys.modules:
    print(f"{name!r} already in sys.modules")
elif (spec := importlib.util.find_spec(name)) is not None:
    # If you chose to perform the actual import ...
    module = importlib.util.module_from_spec(spec)
    sys.modules[name] = module
    spec.loader.exec_module(module)
    print(f"{name!r} has been imported")
else:
    print(f"can't find the {name!r} module")

import importlib.util
import sys

# For illustrative purposes.
import tokenize
file_path = tokenize.__file__
module_name = tokenize.__name__

spec = importlib.util.spec_from_file_location(module_name, file_path)
module = importlib.util.module_from_spec(spec)
sys.modules[module_name] = module
spec.loader.exec_module(module)

>>> import importlib.util
>>> import sys
>>> def lazy_import(name):
..     spec = importlib.util.find_spec(name)
..     loader = importlib.util.LazyLoader(spec.loader)
..     spec.loader = loader
..     module = importlib.util.module_from_spec(spec)
..     sys.modules[name] = module
..     loader.exec_module(module)
..     return module
...
>>> lazy_typing = lazy_import("typing")
>>> #lazy_typing is a real module object,
>>> #but it is not loaded in memory yet.
>>> lazy_typing.TYPE_CHECKING
False

import importlib.machinery
import sys

# For illustrative purposes only.
SpamMetaPathFinder = importlib.machinery.PathFinder
SpamPathEntryFinder = importlib.machinery.FileFinder
loader_details = (importlib.machinery.SourceFileLoader,
                  importlib.machinery.SOURCE_SUFFIXES)

# Setting up a meta path finder.
# Make sure to put the finder in the proper location in the list in terms of
# priority.
sys.meta_path.append(SpamMetaPathFinder)

# Setting up a path entry finder.
# Make sure to put the path hook in the proper location in the list in terms
# of priority.
sys.path_hooks.append(SpamPathEntryFinder.path_hook(loader_details))