Làm cách nào bạn có thể nhập tất cả các chức năng từ tệp python trong thư mục trước?

5. 2. 1. Gói thông thường

Python định nghĩa hai loại gói và. Các gói thông thường là các gói truyền thống khi chúng tồn tại trong Python 3. 2 trở về trước. Một gói thông thường thường được triển khai dưới dạng thư mục chứa tệp

from .foo import Foo

from .foo import Foo

from .foo import Foo

Ví dụ: bố cục hệ thống tệp sau xác định gói

from .foo import Foo

parent/
    __init__.py
    one/
        __init__.py
    two/
        __init__.py
    three/
        __init__.py

Việc nhập

from .foo import Foo

>>> import spam
>>> spam.foo

>>> spam.Foo

>>> import spam
>>> spam.foo

>>> spam.Foo

>>> import spam
>>> spam.foo

>>> spam.Foo

>>> import spam
>>> spam.foo

>>> spam.Foo

>>> import spam
>>> spam.foo

>>> spam.Foo

>>> import spam
>>> spam.foo

>>> spam.Foo

5. 2. 2. Gói không gian tên

Gói không gian tên là tổng hợp của nhiều gói khác nhau, trong đó mỗi phần đóng góp một gói con cho gói mẹ. Các phần có thể nằm ở các vị trí khác nhau trên hệ thống tệp. Các phần cũng có thể được tìm thấy trong tệp zip, trên mạng hoặc bất kỳ nơi nào khác mà Python tìm kiếm trong quá trình nhập. Các gói không gian tên có thể hoặc không tương ứng trực tiếp với các đối tượng trên hệ thống tệp;

Các gói không gian tên không sử dụng danh sách thông thường cho thuộc tính

from .foo import Foo

Với các gói không gian tên, không có tệp

>>> import spam
>>> spam.foo

>>> spam.Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Xem thêm PEP 420 để biết đặc tả gói không gian tên

5. 3. 1. Bộ đệm mô-đun

Vị trí đầu tiên được kiểm tra trong quá trình tìm kiếm nhập khẩu là. Ánh xạ này đóng vai trò là bộ đệm của tất cả các mô-đun đã được nhập trước đó, bao gồm cả các đường dẫn trung gian. Vì vậy, nếu

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Trong quá trình nhập, tên mô-đun được tra cứu và nếu có, giá trị được liên kết là mô-đun đáp ứng yêu cầu nhập và quá trình hoàn tất. Tuy nhiên, nếu giá trị là

from .foo import Foo

có thể ghi được. Việc xóa khóa có thể không hủy mô-đun được liên kết (vì các mô-đun khác có thể giữ tham chiếu đến nó), nhưng nó sẽ làm mất hiệu lực mục nhập bộ đệm cho mô-đun có tên, khiến Python phải tìm kiếm lại mô-đun có tên trong lần nhập tiếp theo. Khóa cũng có thể được gán cho

from .foo import Foo

Mặc dù vậy, hãy cẩn thận, vì nếu bạn giữ một tham chiếu đến đối tượng mô-đun, làm mất hiệu lực mục nhập bộ đệm của nó trong , sau đó nhập lại mô-đun đã đặt tên, hai đối tượng mô-đun sẽ không giống nhau. Ngược lại, sẽ sử dụng lại cùng một đối tượng mô-đun và chỉ cần khởi tạo lại nội dung mô-đun bằng cách chạy lại mã của mô-đun

5. 3. 2. Trình tìm kiếm và trình tải

Nếu không tìm thấy mô-đun được đặt tên trong , thì giao thức nhập của Python sẽ được gọi để tìm và tải mô-đun. Giao thức này bao gồm hai đối tượng khái niệm, và. Công việc của công cụ tìm là xác định xem nó có thể tìm thấy mô-đun được đặt tên hay không bằng cách sử dụng bất kỳ chiến lược nào mà nó biết về. Các đối tượng triển khai cả hai giao diện này được gọi là - chúng tự trả về khi thấy rằng chúng có thể tải mô-đun được yêu cầu

Python bao gồm một số công cụ tìm và nhập mặc định. Cái đầu tiên biết cách định vị các mô-đun tích hợp và cái thứ hai biết cách định vị các mô-đun bị đóng băng. Công cụ tìm kiếm mặc định thứ ba tìm kiếm một mô-đun. Đây là danh sách các vị trí có thể đặt tên cho đường dẫn hệ thống tệp hoặc tệp zip. Nó cũng có thể được mở rộng để tìm kiếm bất kỳ tài nguyên có thể định vị nào, chẳng hạn như những tài nguyên được xác định bởi URL

Máy móc nhập khẩu có thể mở rộng, vì vậy có thể thêm các công cụ tìm kiếm mới để mở rộng phạm vi và phạm vi tìm kiếm mô-đun

Trình tìm kiếm không thực sự tải các mô-đun. Nếu họ có thể tìm thấy mô-đun được đặt tên, họ sẽ trả về một thông số kỹ thuật của mô-đun, một phần đóng gói thông tin liên quan đến nhập của mô-đun, mà sau đó máy móc nhập sẽ sử dụng khi tải mô-đun

Các phần sau đây mô tả chi tiết hơn về giao thức cho trình tìm và trình tải, bao gồm cách bạn có thể tạo và đăng ký những giao thức mới để mở rộng bộ máy nhập

Đã thay đổi trong phiên bản 3. 4. Trong các phiên bản trước của Python, công cụ tìm trả về trực tiếp, trong khi giờ đây, chúng trả về thông số mô-đun chứa bộ tải. Trình tải vẫn được sử dụng trong quá trình nhập nhưng có ít trách nhiệm hơn.

5. 3. 3. Móc nhập

Máy móc nhập khẩu được thiết kế để có thể mở rộng; . Có hai loại móc nhập khẩu. móc meta và móc đường dẫn nhập

Móc meta được gọi khi bắt đầu quá trình nhập, trước khi bất kỳ quá trình nhập nào khác diễn ra, ngoài tra cứu bộ đệm. Điều này cho phép các móc nối meta ghi đè quá trình xử lý, các mô-đun bị đóng băng hoặc thậm chí các mô-đun tích hợp sẵn. Móc meta được đăng ký bằng cách thêm các đối tượng công cụ tìm mới vào , như được mô tả bên dưới

Móc đường dẫn nhập được gọi là một phần của quá trình xử lý (hoặc

from .foo import Foo

5. 3. 4. Đường dẫn meta

Khi không tìm thấy mô-đun có tên trong, Python sẽ tìm kiếm tiếp theo, chứa danh sách các đối tượng công cụ tìm đường dẫn meta. Những công cụ tìm này được truy vấn để xem liệu họ có biết cách xử lý mô-đun được đặt tên hay không. Công cụ tìm đường dẫn meta phải triển khai một phương thức có tên là ba đối số. tên, đường dẫn nhập và (tùy chọn) mô-đun đích. Công cụ tìm đường dẫn meta có thể sử dụng bất kỳ chiến lược nào mà nó muốn để xác định xem nó có thể xử lý mô-đun được đặt tên hay không

Nếu công cụ tìm đường dẫn meta biết cách xử lý mô-đun được đặt tên, nó sẽ trả về một đối tượng cụ thể. Nếu nó không thể xử lý mô-đun được đặt tên, nó sẽ trả về

from .foo import Foo

Phương thức tìm đường dẫn meta được gọi với hai hoặc ba đối số. Đầu tiên là tên đủ điều kiện của mô-đun được nhập, ví dụ:

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Đường dẫn meta có thể được duyệt nhiều lần cho một yêu cầu nhập. Ví dụ: giả sử không có mô-đun nào liên quan đã được lưu vào bộ nhớ cache, việc nhập

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Một số công cụ tìm đường dẫn meta chỉ hỗ trợ nhập cấp cao nhất. Những nhà nhập khẩu này sẽ luôn trả về

from .foo import Foo

from .foo import Foo

Mặc định của Python có ba công cụ tìm đường dẫn meta, một công cụ biết cách nhập các mô-đun tích hợp sẵn, một công cụ biết cách nhập các mô-đun đã đóng băng và một công cụ biết cách nhập các mô-đun từ một (i. e. các )

Đã thay đổi trong phiên bản 3. 4. Đã thay thế phương pháp tìm đường dẫn meta , hiện không được dùng nữa. Mặc dù nó sẽ tiếp tục hoạt động mà không thay đổi, nhưng máy móc nhập khẩu sẽ chỉ thử nếu công cụ tìm không triển khai

from .foo import Foo

Đã thay đổi trong phiên bản 3. 10. Việc sử dụng của hệ thống nhập hiện tăng.

5. 4. 1. Trình tải

Bộ tải mô-đun cung cấp chức năng quan trọng là tải. thực hiện mô-đun. Máy nhập gọi phương thức với một đối số duy nhất, đối tượng mô-đun để thực thi. Mọi giá trị được trả về từ đều bị bỏ qua

Bộ tải phải đáp ứng các yêu cầu sau

• Nếu mô-đun là mô-đun Python (trái ngược với mô-đun tích hợp hoặc tiện ích mở rộng được tải động), trình tải sẽ thực thi mã của mô-đun trong không gian tên chung của mô-đun (

  from .foo import Foo
  

  919)

• Nếu trình tải không thể thực thi mô-đun, nó sẽ đưa ra một , mặc dù bất kỳ ngoại lệ nào khác được đưa ra trong thời gian đó sẽ được lan truyền

Trong nhiều trường hợp, công cụ tìm và trình tải có thể là cùng một đối tượng;

Trình tải mô-đun có thể chọn tham gia tạo đối tượng mô-đun trong khi tải bằng cách triển khai một phương thức. Nó nhận một đối số, thông số mô-đun và trả về đối tượng mô-đun mới để sử dụng trong khi tải.

from .foo import Foo

from .foo import Foo

Mới trong phiên bản 3. 4. Phương pháp bộ nạp.

Đã thay đổi trong phiên bản 3. 4. Phương pháp này đã được thay thế bằng và máy móc nhập khẩu đảm nhận tất cả các trách nhiệm tải sẵn.

Để tương thích với các bộ nạp hiện có, máy móc nhập khẩu sẽ sử dụng phương thức

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Phương thức

from .foo import Foo

• Nếu có một đối tượng mô-đun hiện có với tên đã cho trong , trình tải phải sử dụng mô-đun hiện có đó. (Nếu không, sẽ không hoạt động chính xác. ) Nếu mô-đun được đặt tên không tồn tại trong , trình tải phải tạo một đối tượng mô-đun mới và thêm nó vào

• Mô-đun phải tồn tại trước khi trình tải thực thi mã mô-đun, để ngăn chặn đệ quy không giới hạn hoặc tải nhiều lần

• Nếu quá trình tải không thành công, trình tải phải xóa mọi mô-đun mà nó đã chèn vào, nhưng nó chỉ phải xóa (các) mô-đun bị lỗi và chỉ khi bản thân trình tải đã tải (các) mô-đun đó một cách rõ ràng

Đã thay đổi trong phiên bản 3. 5. A được nâng lên khi

from .foo import Foo

from .foo import Foo

Đã thay đổi trong phiên bản 3. 6. An được nâng lên khi

from .foo import Foo

from .foo import Foo

Đã thay đổi trong phiên bản 3. 10. Việc sử dụng

from .foo import Foo

5. 4. 2. Mô-đun con

Khi một mô-đun con được tải bằng bất kỳ cơ chế nào (e. g.

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

và

from .foo import Foo

from .foo import Foo

sau đó thực hiện các ràng buộc đặt tên sau cho

from .foo import Foo

from .foo import Foo

from .foo import Foo

________số 8

Với các quy tắc ràng buộc tên quen thuộc của Python, điều này có vẻ đáng ngạc nhiên, nhưng nó thực sự là một tính năng cơ bản của hệ thống nhập. Nắm giữ bất biến là nếu bạn có

from .foo import Foo

from .foo import Foo

from .foo import Foo

5. 4. 3. Thông số mô-đun

Máy nhập sử dụng nhiều thông tin khác nhau về từng mô-đun trong quá trình nhập, đặc biệt là trước khi tải. Hầu hết các thông tin là chung cho tất cả các mô-đun. Mục đích của thông số kỹ thuật của mô-đun là gói gọn thông tin liên quan đến nhập này trên cơ sở từng mô-đun

Sử dụng một thông số kỹ thuật trong quá trình nhập cho phép chuyển trạng thái giữa các thành phần hệ thống nhập, e. g. giữa công cụ tìm tạo thông số mô-đun và trình tải thực thi nó. Quan trọng nhất, nó cho phép máy móc nhập khẩu thực hiện các hoạt động tải theo bản mẫu, trong khi không có thông số kỹ thuật mô-đun, trình tải có trách nhiệm đó

Thông số kỹ thuật của mô-đun được hiển thị dưới dạng thuộc tính

from .foo import Foo

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

5. 4. 4. Thuộc tính mô-đun liên quan đến nhập

Bộ máy nhập điền vào các thuộc tính này trên từng đối tượng mô-đun trong khi tải, dựa trên thông số kỹ thuật của mô-đun, trước khi trình tải thực thi mô-đun

Thuộc tính

from .foo import Foo

Thuộc tính

from .foo import Foo

Thuộc tính

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Thuộc tính này được sử dụng thay vì

from .foo import Foo

from .foo import Foo

Đã thay đổi trong phiên bản 3. 6. Giá trị của

from .foo import Foo

from .foo import Foo

Thuộc tính

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Khi

from .foo import Foo

from .foo import Foo

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

Đã thay đổi trong phiên bản 3. 6. ______3975 được sử dụng làm dự phòng khi

from .foo import Foo

Nếu mô-đun là một gói (thông thường hoặc không gian tên), thuộc tính

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Các mô-đun không phải gói không được có thuộc tính

from .foo import Foo

from .foo import Foo

Nếu

from .foo import Foo

from .foo import Foo

Lưu ý rằng có thể đặt

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

5. 4. 5. mô-đun. __đường__

Theo định nghĩa, nếu một mô-đun có thuộc tính

from .foo import Foo

Thuộc tính

from .foo import Foo

from .foo import Foo

from .foo import Foo

Tệp

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

5. 4. 6. Số lần lặp lại mô-đun

Theo mặc định, tất cả các mô-đun đều có một repr có thể sử dụng được, tuy nhiên, tùy thuộc vào các thuộc tính được đặt ở trên và trong thông số kỹ thuật của mô-đun, bạn có thể kiểm soát rõ ràng hơn repr của các đối tượng mô-đun

Nếu mô-đun có thông số kỹ thuật (

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Dưới đây là các quy tắc chính xác được sử dụng

• Nếu mô-đun có thuộc tính

  from .foo import Foo
  

  965, thông tin trong thông số kỹ thuật được sử dụng để tạo repr. Các thuộc tính “name”, “loader”, “origin” và “has_location” được tham khảo

• Nếu mô-đun có thuộc tính

  from .foo import Foo
  

  991, thuộc tính này được sử dụng như một phần của repr mô-đun

• Nếu mô-đun không có

  from .foo import Foo
  

  991 nhưng có

  from .foo import Foo
  

  968 không phải là

  from .foo import Foo
  

  88, thì repr của trình tải được sử dụng như một phần của repr của mô-đun

• Nếu không, chỉ cần sử dụng mô-đun

  from .foo import Foo
  

  967 trong repr

Đã thay đổi trong phiên bản 3. 4. Việc sử dụng of đã không còn được dùng nữa và thông số kỹ thuật của mô-đun hiện được máy móc nhập khẩu sử dụng để tạo repr mô-đun.

Để tương thích ngược với Python 3. 3, mô-đun repr sẽ được tạo bằng cách gọi phương thức của trình tải, nếu được xác định, trước khi thử một trong hai phương pháp được mô tả ở trên. Tuy nhiên, phương pháp này không được chấp nhận

Đã thay đổi trong phiên bản 3. 10. Việc gọi hiện diễn ra sau khi cố gắng sử dụng thuộc tính

from .foo import Foo

from .foo import Foo

5. 4. 7. Hủy hiệu lực mã byte đã lưu trong bộ nhớ cache

Trước khi Python tải mã byte được lưu trong bộ đệm từ tệp

from .foo import Foo

from .foo import Foo

Python cũng hỗ trợ các tệp bộ đệm “dựa trên hàm băm”, lưu trữ hàm băm của nội dung tệp nguồn thay vì siêu dữ liệu của nó. Có hai biến thể của tệp

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Đã thay đổi trong phiên bản 3. 7. Đã thêm tệp

from .foo import Foo

5. 5. 1. Công cụ tìm mục nhập đường dẫn

Chịu trách nhiệm tìm và tải các gói và mô-đun Python có vị trí được chỉ định bằng một chuỗi. Hầu hết các mục nhập đường dẫn đặt tên các vị trí trong hệ thống tệp, nhưng chúng không cần giới hạn ở đây

Là một công cụ tìm đường dẫn meta, giao thức này thực hiện giao thức được mô tả trước đó, tuy nhiên, nó hiển thị các móc nối bổ sung có thể được sử dụng để tùy chỉnh cách tìm thấy và tải các mô-đun từ

Ba biến được sử dụng bởi , , và. Các thuộc tính

from .foo import Foo

chứa danh sách các chuỗi cung cấp vị trí tìm kiếm cho các mô-đun và gói. Nó được khởi tạo từ biến môi trường

from .foo import Foo

Là a , vì vậy máy nhập bắt đầu tìm kiếm bằng cách gọi phương thức của công cụ tìm dựa trên đường dẫn như đã mô tả trước đó. Khi đối số

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Công cụ tìm dựa trên đường dẫn lặp lại qua mọi mục nhập trong đường dẫn tìm kiếm và đối với mỗi mục này, hãy tìm một () thích hợp cho mục nhập đường dẫn. Bởi vì đây có thể là một hoạt động tốn kém (e. g. có thể có chi phí cuộc gọi

from .foo import Foo

Nếu mục nhập đường dẫn không có trong bộ đệm, công cụ tìm đường dẫn dựa trên sẽ lặp lại trên mọi lệnh có thể gọi được trong. Mỗi mục trong danh sách này được gọi với một đối số duy nhất, mục nhập đường dẫn sẽ được tìm kiếm. Cái có thể gọi này có thể trả về một cái có thể xử lý mục nhập đường dẫn hoặc nó có thể tăng. An được sử dụng bởi công cụ tìm dựa trên đường dẫn để báo hiệu rằng hook không thể tìm thấy a cho điều đó. Ngoại lệ bị bỏ qua và quá trình lặp lại tiếp tục. Cái móc sẽ mong đợi một đối tượng chuỗi hoặc byte; . g. nó có thể là mã hóa hệ thống tệp, UTF-8 hoặc thứ gì đó khác) và nếu hook không thể giải mã đối số, nó sẽ tăng

Nếu quá trình lặp lại kết thúc mà không được trả lại, thì phương thức của công cụ tìm đường dẫn sẽ lưu trữ

from .foo import Foo

from .foo import Foo

Nếu a được trả về bởi một trong các hàm có thể gọi trên , thì giao thức sau đây được sử dụng để yêu cầu công cụ tìm thông số mô-đun, sau đó được sử dụng khi tải mô-đun

Thư mục làm việc hiện tại – được biểu thị bằng một chuỗi trống – được xử lý hơi khác so với các mục nhập khác trên. Đầu tiên, nếu thư mục làm việc hiện tại không tồn tại, thì không có giá trị nào được lưu trữ trong. Thứ hai, giá trị cho thư mục làm việc hiện tại được tra cứu mới cho mỗi lần tra cứu mô-đun. Thứ ba, đường dẫn được sử dụng cho và được trả về bởi sẽ là thư mục làm việc thực tế hiện tại chứ không phải chuỗi rỗng

5. 5. 2. Giao thức tìm mục nhập đường dẫn

Để hỗ trợ nhập các mô-đun và các gói đã khởi tạo và cũng để đóng góp các phần cho các gói không gian tên, các công cụ tìm mục nhập đường dẫn phải triển khai phương thức

có hai đối số. tên đủ điều kiện của mô-đun đang được nhập và mô-đun đích (tùy chọn).

from .foo import Foo

Để chỉ ra cho máy móc nhập rằng thông số kỹ thuật đại diện cho một không gian tên , công cụ tìm mục nhập đường dẫn đặt “submodule_search_locations” thành danh sách chứa phần

Đã thay đổi trong phiên bản 3. 4. được thay thế và , cả hai đều không được dùng nữa, nhưng sẽ được sử dụng nếu

from .foo import Foo

Các công cụ tìm mục nhập đường dẫn cũ hơn có thể triển khai một trong hai phương pháp không dùng nữa này thay vì

from .foo import Foo

from .foo import Foo

nhận một đối số, tên đủ điều kiện của mô-đun được nhập.

from .foo import Foo

Để tương thích ngược với các triển khai khác của giao thức nhập, nhiều công cụ tìm mục nhập đường dẫn cũng hỗ trợ cùng một phương thức truyền thống

from .foo import Foo

from .foo import Foo

from .foo import Foo

Phương thức

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo

Đã thay đổi trong phiên bản 3. 10. Các cuộc gọi đến và bởi hệ thống nhập sẽ tăng.

5. 8. 1. __main__. __spec__

Tùy thuộc vào cách được khởi tạo,

from .foo import Foo

from .foo import Foo

Khi Python được khởi động với tùy chọn,

from .foo import Foo

from .foo import Foo

from .foo import Foo

Trong

from .foo import Foo

from .foo import Foo

• lời nhắc tương tác

• Tùy chọn

• chạy từ stdin

• chạy trực tiếp từ tệp mã nguồn hoặc mã byte

Lưu ý rằng

from .foo import Foo

from .foo import Foo

Cũng lưu ý rằng ngay cả khi

from .foo import Foo

from .foo import Foo

from .foo import Foo

from .foo import Foo