Mô-đun tài liệu trong python

Trong Python 2. 0, thiết lập API python. py build --build-base=/path/to/pybuild/foo-1. 0 3 lần đầu tiên được thêm vào thư viện tiêu chuẩn. Điều này đã cung cấp cho người bảo trì Linux một cách tiêu chuẩn để chuyển đổi các dự án Python thành các gói phân phối Linux và quản trị viên hệ thống theo một cách tiêu chuẩn để cài đặt chúng trực tiếp lên các hệ thống đích.

Trong nhiều năm được kể từ khi Python 2. 0 đã được phát hành, việc kết hợp chặt chẽ hệ thống xây dựng và gói cài đặt với chu kỳ phát hành thời gian chạy ngôn ngữ đã trở nên có vấn đề và hiện tại nên sử dụng gói cài đặt

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Xem Cài đặt các mô-đun Python và phân phối các mô-đun Python để biết thêm chi tiết

Tài liệu di sản này chỉ được giữ lại cho đến khi chúng tôi tự tin rằng tài liệu

$ py -3 -m venv venv

Đối với Windows, lệnh này sẽ được chạy từ cửa sổ lệnh []

Nếu tất cả những điều này là đúng, thì bạn đã biết cách xây dựng và cài đặt các mô-đun mà bạn vừa tải xuống. run command at on. Ngoại trừ trường hợp bạn cần cài đặt mọi thứ theo cách không chuẩn hoặc tùy chỉnh quy trình xây dựng tùy chọn, bạn không thực sự cần hướng dẫn này. Hay đúng hơn, lệnh trên là tất cả những thứ bạn cần để thoát khỏi hướng dẫn này

$ py -3 -m venv venv

Build and install set standardunzip or pkunzip] để giải nén kho lưu trữ. Sau đó, mở cửa sổ nhắc lệnh và chạy

$ py -3 -m venv venv

Như đã được mô tả trong Phần nguồn phân phối dựa trên DisTUTILS, xây dựng và cài đặt mô-đun phân phối bằng cách sử dụng DisTUtils thông thường là một lệnh đơn giản để chạy từ thiết bị đầu cuối

Đế nền tảng có thể biến thể

Bạn phải luôn chạy lệnh thiết lập từ thư mục gốc phân phối, tức là thư mục con cấp cao nhất mà mô-đun giải nén nguồn phân phối vào. Ví dụ. if you just download down module-module source

$ py -3 -m venv venv

$ py -3 -m venv venv

Trên Windows, bạn có thể tải xuống

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Chia công việc lên

Cách xây dựng hoạt động

Theo nghĩa ở trên, lệnh xây dựng có nhiệm vụ đặt các tệp để cài đặt vào thư mục xây dựng. Theo default, here is

$ py -3 -m venv venv

$ py -3 -m venv venv

.Tệp cấu hình của Distutils . ] Thông thường, điều này là không cần thiết.

Định nghĩa mặc định cục bộ cho cây xây dựng như sau

$ py -3 -m venv venv

in which

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Trong tương lai, nhiều thư mục sẽ được thêm vào để xử lý các tập lệnh Python, tài liệu, thực thi nhị phân và bất cứ điều gì khác cần thiết để xử lý công việc cài đặt các mô-đun và ứng dụng Python

Cách cài đặt hoạt động

Sau khi lệnh build chạy [cho dù bạn chạy nó một cách rõ ràng hay lệnh cài đặt thực hiện nó cho bạn], công việc của lệnh cài đặt tương đối đơn giản. Tất cả những gì nó phải làm là sao chép mọi thứ theo

$ py -3 -m venv venv

Nếu bạn không chọn một thư mục cài đặt, tức là, nếu bạn chỉ chạy ____ ____ 62, thì lệnh cài đặt cài đặt vào vị trí tiêu chuẩn cho mô-đun Python của bên thứ ba. Vị trí này thay đổi nền tảng và cách bạn xây dựng/cài đặt Python chính. Trên Unix [và MacOS, cũng dựa trên UNIX], nó cũng phụ thuộc vào mô đun phân phối được cài đặt phải là Python tinh khiết hay chứa các tiện ích mở rộng [không phải là PURE hay không]. lệnh cài đặt cài đặt vào vị trí tiêu chuẩn cho các mô-đun Python của bên thứ ba. Vị trí này thay đổi theo nền tảng và cách bạn xây dựng/cài đặt Python. Trên Unix [và macOS, cũng dựa trên Unix], nó cũng phụ thuộc vào việc bản phân phối mô-đun đang được cài đặt là Python thuần túy hay chứa các tiện ích mở rộng [“không thuần túy”]

nền tảng

Standard setting setting

default value

Ghi chú

UNIX [tinh khiết]

$ py -3 -m venv venv

$ py -3 -m venv venv

[1]

UNIX [không thuần túy]

$ py -3 -m venv venv

$ py -3 -m venv venv

[1]

các cửa sổ

$ py -3 -m venv venv

[2]

ghi chú

1. Hầu hết các bản phân phối Linux bao gồm Python là một phần tiêu chuẩn của hệ thống, do đó

   $ py -3 -m venv venv
   

   239 và

   $ py -3 -m venv venv
   

   240 thường là cả____1241 trên Linux. Nếu bạn tự xây dựng Python trên Linux [hoặc bất kỳ hệ thống nào giống với UNIX nào], default_______1239 và_______1240 là

   $ py -3 -m venv venv
   

   244

2. Mặc định cài đặt thư mục trên Windows là

   $ py -3 -m venv venv
   

   245 theo Python 1. 6A1, 1. 5. 2 và trước đó

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Một vài người giữ chỗ khác được sử dụng trong tài liệu này

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Nếu bạn không muốn cài đặt các mô-đun -module vào vị trí tiêu chuẩn hoặc nếu bạn không có quyền viết ở đó, thì bạn cần đọc về các cài đặt thay thế trong phần cài đặt thay thế. Nếu bạn muốn tùy chỉnh thư mục cài đặt của mình nhiều hơn, hãy xem phần Cài đặt tùy chỉnh trên cài đặt tùy chỉnh. Cài đặt thay thế . Nếu bạn muốn tùy chỉnh nhiều hơn các thư mục cài đặt của mình, hãy xem phần Cài đặt tùy chỉnh về cài đặt tùy chỉnh.

Cài đặt thay thế. user map

Sơ đồ này được thiết kế để trở thành giải pháp thuận tiện nhất cho người dùng không có quyền viết cho thư mục gói trang web toàn cầu hoặc không muốn cài đặt vào đó. Nó được kích hoạt với một tùy chọn đơn giản

$ py -3 -m venv venv

Các tập tin sẽ được cài đặt vào các thư mục con của

$ py -3 -m venv venv

$ py -3 -m venv venv

loại tập tin

Cài đặt thư mục

Mô-đun

$ py -3 -m venv venv

kịch bản

$ py -3 -m venv venv

Data

$ py -3 -m venv venv

C tiêu đề

$ py -3 -m venv venv

Và đây là các giá trị được sử dụng trên Windows

loại tập tin

Cài đặt thư mục

Mô-đun

$ py -3 -m venv venv

kịch bản

$ py -3 -m venv venv

Data

$ py -3 -m venv venv

C tiêu đề

$ py -3 -m venv venv

Và đây là các giá trị được sử dụng trên Windows

Ưu điểm của việc sử dụng sơ đồ này so với các kế hoạch khác được mô tả dưới đây là thư mục gói trang web người dùng nằm trong điều kiện bình thường luôn luôn được bao gồm trong

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Lệnh build_ext cũng có tùy chọn /usr/bin/python setup. py install --prefix=/usr/local 0 to add cd c. \Temp\foo-1. 0 thiết lập trăn. py cài đặt 11 vào đường dẫn tìm kiếm trình biên dịch cho các tệp tiêu đề và cd c. \Temp\foo-1. 0 thiết lập trăn. py install 12 vào đường dẫn biên dịch tìm kiếm biên dịch cho các thư viện cũng như đường dẫn tìm kiếm thời gian chạy cho thư viện C được chia sẻ [RPATH]

Cài đặt thay thế. Gia đình chương trình

Ý tưởng phía sau chương trình nhà của người Viking là bạn xây dựng và duy trì một bản mô-đun Python cá nhân. Tên kế hoạch này có nguồn gốc từ ý tưởng về một thư mục gia đình trên mạng trên UNIX, vì nó không phải là bất thường đối với người dùng Unix để làm cho thư mục nhà của họ có bố cục tương tự như vậy.

$ py -3 -m venv venv

$ py -3 -m venv venv

Cài đặt phân phối mô-đun mới đơn giản như lệnh cài đặt sẽ mở rộng lệnh này vào thư mục chính của bạn

$ py -3 -m venv venv

nơi bạn có thể cung cấp bất kỳ thư mục nào bạn thích cho tùy chọn

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Để thực hiện Python, hãy tìm các bản phân phối đã được cài đặt với sơ đồ này, bạn có thể phải sửa đổi đường dẫn tìm kiếm Python hoặc chỉnh sửa

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

loại tập tin

Cài đặt thư mục

Mô-đun

$ py -3 -m venv venv

kịch bản

$ py -3 -m venv venv

Data

$ py -3 -m venv venv

C tiêu đề

$ py -3 -m venv venv

Và đây là các giá trị được sử dụng trên Windows

Ưu điểm của việc sử dụng sơ đồ này so với các kế hoạch khác được mô tả dưới đây là thư mục gói trang web người dùng nằm trong các điều kiện bình thường luôn luôn được bao gồm trong cd c:\Temp\foo-1.0 python setup.py install 07 [xem --- build/ --- lib/ or --- build/ --- lib./ temp./ 3 tập lệnh để hoàn thiện cài đặt.

Lệnh build_ext cũng có tùy chọn

$ py -3 -m venv venv

$ py -3 -m venv venv

Cài đặt thay thế. Gia đình chương trình

$ py -3 -m venv venv

Ý tưởng phía sau chương trình nhà của người Viking là bạn xây dựng và duy trì một bản mô-đun Python cá nhân. Tên kế hoạch này có nguồn gốc từ ý tưởng về một thư mục gia đình trên mạng trên UNIX, vì nó không phải là bất thường đối với người dùng Unix để làm cho thư mục nhà của họ có bố cục tương tự như vậy.

$ py -3 -m venv venv

$ py -3 -m venv venv

Cài đặt phân phối mô-đun mới đơn giản như

loại tập tin

Cài đặt thư mục

Mô-đun Python

$ py -3 -m venv venv

Mô-đun mở rộng

$ py -3 -m venv venv

kịch bản

$ py -3 -m venv venv

Data

$ py -3 -m venv venv

C tiêu đề

$ py -3 -m venv venv

No request that

$ py -3 -m venv venv

$ py -3 -m venv venv

Đương nhiên, lý do thực sự của sơ đồ tiền tố rất quan trọng chỉ đơn giản là việc cài đặt UNIX tiêu chuẩn sử dụng sơ đồ tiền tố, nhưng với

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Lưu ý rằng việc cài đặt các tiện ích mở rộng vào cài đặt Python thay thế không ảnh hưởng đến cách các tiện ích mở rộng được xây dựng. đặc biệt, các tệp tiêu đề Python [

$ py -3 -m venv venv

Cài đặt thay thế. Windows [sơ đồ tiền tố] ¶

Windows không có khái niệm về thư mục nhà của người dùng và do việc cài đặt tiêu chuẩn Python trong Windows đơn giản hơn so với Unix, tùy chọn

$ py -3 -m venv venv

$ py -3 -m venv venv

To install the module -module to directory

$ py -3 -m venv venv

Cơ sở cài đặt được xác định theo tùy chọn

$ py -3 -m venv venv

loại tập tin

Cài đặt thư mục

Mô-đun Python

$ py -3 -m venv venv

kịch bản

$ py -3 -m venv venv

Data

$ py -3 -m venv venv

C tiêu đề

$ py -3 -m venv venv

Ghi chú

Khi một môi trường ảo được kích hoạt, mọi tùy chọn thay đổi đường dẫn cài đặt sẽ bị loại bỏ khỏi tất cả các tệp cấu hình Distutils để ngăn chặn việc cài đặt các dự án bên ngoài môi trường ảo.

$ py -3 -m venv venv

Sửa đổi đường dẫn tìm kiếm Python từ

Khi thông dịch Python thực thi câu lệnh

$ py -3 -m venv venv

String null in

$ py -3 -m venv venv

Công ước dự kiến ​​các gói được cài đặt cục bộ được đưa vào thư mục

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Thuận tiện nhất là thêm tệp cấu hình đường dẫn vào thư mục mà trên đường dẫn của Python, thường là vào thư mục

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Các đường dẫn có thể là tuyệt đối hoặc tương đối, trong trường hợp chúng liên quan đến thư mục chứa tệp

$ py -3 -m venv venv

$ py -3 -m venv venv

Có thể sửa đổi hai môi trường biến

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Variation

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Cuối cùng,

$ py -3 -m venv venv

Vị trí và tên của các cấu hình tệp

Tên và vị trí của cấu hình tệp thay đổi một chút trên nền tảng. Trên Unix và MacOS, ba tệp cấu hình [theo thứ tự chúng được xử lý] là

loại tập tin

Vị trí và tên tệp

Ghi chú

hệ thống

$ py -3 -m venv venv

[1]

private

$ py -3 -m venv venv

[2]

address

$ py -3 -m venv venv

[3]

And on Windows, configuration file is

loại tập tin

Vị trí và tên tệp

Ghi chú

hệ thống

$ py -3 -m venv venv

[4]

private

$ py -3 -m venv venv

[5]

address

$ py -3 -m venv venv

[3]

And on Windows, configuration file is

ghi chú

1. Trên tất cả các nền tảng, tệp cá nhân trên mạng có thể bị vô hiệu hóa tạm thời theo cách truyền tùy chọn

   $ py -3 -m venv venv
   

   2631

2. Nói đúng ra, tệp cấu hình toàn bộ hệ thống sống trong thư mục nơi cài đặt distutils; . 6 và sau đó trên Unix, điều này được hiển thị. Đối chiếu với Python 1. 5. 2, các phương pháp distutils thông thường sẽ được cài đặt thành

   $ py -3 -m venv venv
   

   2632, làm điều đó, tệp cấu hình hệ thống phải được đặt ở đó theo Python 1. 5. 2. Biến môi trường

   $ py -3 -m venv venv
   

   2633 không được xác định, thư mục chính của người dùng sẽ được xác định bằng hàm

   $ py -3 -m venv venv
   

   2634 từ mô-đun

   $ py -3 -m venv venv
   

   2635 tiêu chuẩn. Điều này được thực hiện bởi hàm

   $ py -3 -m venv venv
   

   2636 được sử dụng bởi Distutils

3. Trên Unix, nếu môi trường biến

   $ py -3 -m venv venv
   

   2633 không được xác định, thư mục nhà của người dùng sẽ được xác định với hàm

   $ py -3 -m venv venv
   

   2634 từ mô-đun ___12635 tiêu chuẩn. Điều này được thực hiện bởi chức năng

   $ py -3 -m venv venv
   

   2636 được sử dụng bởi distutils

4. Tức là, trong thư mục hiện tại [thường là vị trí của thiết lập lệnh tập tin]

5. Theo Python 1. 5. 2, default money is

   $ py -3 -m venv venv
   

   2639 và DisTutils không phải là một phần của thư viện tiêu chuẩn, vì vậy tệp cấu hình hệ thống sẽ là ____12640 khi cài đặt Python 1. 5. 2 standard in Windows. Biến môi trường

   $ py -3 -m venv venv
   

   2633 không được xác định,

   $ py -3 -m venv venv
   

   2642 thì

   $ py -3 -m venv venv
   

   2643 và

   $ py -3 -m venv venv
   

   2644 sẽ được thử. Điều này được thực hiện bởi hàm

   $ py -3 -m venv venv
   

   2636 được sử dụng bởi Distutils

Trên Windows, nếu môi trường thiết lập python biến. py xây dựng thiết lập python. cài đặt py 33 không được xác định, thiết lập python. py xây dựng thiết lập python. py install 42 thì cài đặt python. py xây dựng thiết lập python. py install 43 và python setup. py xây dựng thiết lập python. py install 44 will be try. Điều này được thực hiện nhờ chức năng thiết lập python. py xây dựng thiết lập python. py install 36 được sử dụng bởi distutils

Cú pháp của các cấu hình tệp

Các cấu hình tệp Distutils đều có cùng một cú pháp. Các cấu hình tệp được nhóm thành các phần. Có một phần cho mỗi distutils lệnh, cộng với phần

$ py -3 -m venv venv

$ py -3 -m venv venv

Ví dụ. sau đây là một tệp cấu hình hoàn chỉnh chỉ buộc tất cả các lệnh phải chạy im lặng theo mặc định

Nếu điều này được cài đặt dưới dạng tệp cấu hình hệ thống, thì nó sẽ ảnh hưởng đến tất cả công việc xử lý bất kỳ phân phối mô-đun Python nào của bất kỳ người dùng nào trên hệ thống hiện tại. Nếu nó được cài đặt dưới dạng tệp cấu hình cá nhân của bạn [trên các hệ thống hỗ trợ của chúng], nó sẽ chỉ ảnh hưởng đến phân phối mô-đun do bạn xử lý. Và nếu nó được sử dụng làm

$ py -3 -m venv venv

$ py -3 -m venv venv

Bạn có thể ghi lại thư mục mặc định của Build Build Base và thực hiện lệnh Build* luôn bắt buộc phải xây dựng lại tất cả các tệp sau

$ py -3 -m venv venv

tương ứng với các đối số dòng lệnhxây dựng lệnh trên dòng lệnh có nghĩa là lệnh đó sẽ được chạy. Bao gồm một lệnh cụ thể trong các tệp cấu hình không có hàm ý như vậy; . [Hoặc nếu các lệnh khác lấy giá trị từ nó được chạy, chúng sẽ sử dụng các giá trị trong tệp cấu hình. ]

Ngoại trừ bao gồm cả lệnh xây dựng trên dòng lệnh có nghĩa là lệnh đó sẽ được chạy. Bao gồm một lệnh cụ thể trong các cấu hình tệp không có ý nghĩa hàm như vậy; . [Hoặc nếu các lệnh khác lấy giá trị từ nó được chạy, chúng sẽ sử dụng các giá trị trong tệp cấu hình. ]

$ py -3 -m venv venv

Và bạn có thể tìm ra danh sách đầy đủ các tùy chọn toàn cầu bằng cách sử dụng

$ py -3 -m venv venv

Xem thêm phần Tài liệu tham khảo của người Viking trong hướng dẫn sử dụng các mô-đun Python phân phối của Python

Điều chỉnh biên dịch/liên kết cờ

Biên dịch một phần Python mở rộng được viết bằng C hoặc C ++ đôi khi sẽ yêu cầu chỉ định các cờ tùy chỉnh cho trình biên dịch và trình liên kết để sử dụng một thư viện công cụ hoặc tạo ra một loại mã đối tượng . Điều này đặc biệt đúng nếu tiện ích mở rộng đã được thử nghiệm trên nền tảng của bạn hoặc nếu bạn đang cố gắng kết hợp Python chéo

Trong trường hợp hợp nhất chung nhất, tác vụ mở rộng có thể dự đoán rằng việc biên dịch các tiện ích mở rộng sẽ phức tạp và cung cấp tệp

$ py -3 -m venv venv

One file

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Hãy lần lượt kiểm tra từng lĩnh vực

• Mô -đun là tên của mô-đun mở rộng -mô-đun sẽ được xây dựng và phải là danh sách Python hợp lệ. Bạn chỉ có thể cần thay đổi điều này để đổi tên một mô-đun [chỉ sửa đổi thành mã nguồn cũng cần thiết], vì vậy điều này nên được để lại cho một mình

• SourceFile là bất cứ điều gì mà có khả năng là một tệp mã nguồn, ít nhất được đánh giá bởi tên tệp. Name file end in

  $ py -3 -m venv venv
  

  2655 được giả định là viết bằng C, tên tệp kết thúc bằng

  $ py -3 -m venv venv
  

  2656,

  $ py -3 -m venv venv
  

  2657 và

  $ py -3 -m venv venv
  

  2658 được cho là C++ và tên tệp kết thúc trong

  $ py -3 -m venv venv
  

  2659 hoặc

  $ py -3 -m venv venv
  

  2660 được giả định là mục tiêu C

• CPPARG là một đối số cho bộ xử lý tiền C và là bất cứ điều gì bắt đầu với

  $ py -3 -m venv venv
  

  2661,______12662,______12663 hoặc

  $ py -3 -m venv venv
  

  2664

• Thư viện là bất cứ điều gì kết thúc trong

  $ py -3 -m venv venv
  

  2665 ​​hoặc bắt đầu bằng

  $ py -3 -m venv venv
  

  2666 hoặc

  $ py -3 -m venv venv
  

  2667

Nếu một nền tảng cụ thể có thể yêu cầu một thư viện đặc biệt trên nền tảng nền của bạn, bạn có thể thêm nó bằng cách chỉnh sửa tệp đã chỉnh sửa

$ py -3 -m venv venv

$ py -3 -m venv venv

You must be lien kết với thư viện toán học

$ py -3 -m venv venv

$ py -3 -m venv venv

Các tùy chọn công tắc dành cho biên dịch hoặc trình liên kết có thể được cung cấp cho các tùy chọn

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Tùy chọn tiếp theo

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Cờ biên dịch cũng có thể được cung cấp thông qua việc thiết lập biến môi trường

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

Sử dụng biên dịch biên dịch không phải Microsoft trên Windows¶

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv

$ py -3 -m venv venv