Thông tin về thời gian chạy PyRuntimeInfo

Báo cáo vấn đề Xem nguồn Nightly · 7.4 .

Chứa thông tin về môi trường thời gian chạy Python, do quy tắc py_runtime trả về.

Môi trường thời gian chạy Python mô tả môi trường thời gian chạy nền tảng hoặc môi trường thời gian chạy tích hợp sẵn. Môi trường thời gian chạy nền tảng truy cập vào trình thông dịch do hệ thống cài đặt tại một đường dẫn đã biết, trong khi môi trường thời gian chạy tích hợp sẵn trỏ đến File đóng vai trò là trình thông dịch. Trong cả hai trường hợp, "trình thông dịch" thực sự là bất kỳ tập lệnh bao bọc hoặc tệp nhị phân có thể thực thi nào có khả năng chạy tập lệnh Python được truyền trên dòng lệnh, tuân theo các quy ước giống như trình thông dịch CPython chuẩn.

Hội viên

PyRuntimeInfo

PyRuntimeInfo PyRuntimeInfo(interpreter_path=None, interpreter=None, files=None, coverage_tool=None, coverage_files=None, python_version, stub_shebang=None, bootstrap_template=None)

Hàm khởi tạo PyRuntimeInfo.

Thông số

Thông số Mô tả
interpreter_path chuỗi; hoặc None; giá trị mặc định là None
Giá trị cho trường interpreter_path của đối tượng mới. Không cung cấp giá trị cho đối số này nếu bạn truyền vào interpreter.
interpreter Tệp; hoặc None; giá trị mặc định là None
Giá trị cho trường interpreter của đối tượng mới. Không cung cấp giá trị cho đối số này nếu bạn truyền vào interpreter_path.
files depset của Tệp; hoặc None; giá trị mặc định là None
Giá trị cho trường files của đối tượng mới. Không cung cấp giá trị cho đối số này nếu bạn truyền vào interpreter_path. Nếu interpreter được cung cấp và đối số này là None, thì files sẽ trở thành depset trống.
coverage_tool File; hoặc None; mặc định là None
Giá trị cho trường coverage_tool của đối tượng mới.
coverage_files depset của Tệp; hoặc None; giá trị mặc định là None
Giá trị cho trường coverage_files của đối tượng mới. Không cung cấp giá trị cho đối số này nếu bạn không truyền vào coverage_tool.
python_version string; bắt buộc
Giá trị cho trường python_version của đối tượng mới.
stub_shebang chuỗi; giá trị mặc định là None
Giá trị cho trường stub_shebang của đối tượng mới. Nếu không có hoặc không được chỉ định, hệ thống sẽ sử dụng #!/usr/bin/env python3.
bootstrap_template Tệp; hoặc None; mặc định là None

bootstrap_template

File PyRuntimeInfo.bootstrap_template

Tệp mẫu tập lệnh mã giả lập để sử dụng. Cần có %python_binary%, %workspace_name%, %main% và %imports%. Hãy xem @bazel_tools//tools/python:python_bootstrap_template.txt để biết thêm biến.

coverage_files

depset PyRuntimeInfo.coverage_files

Các tệp cần thiết trong thời gian chạy để sử dụng coverage_tool. Giá trị này sẽ là None nếu bạn không cung cấp coverage_tool. Có thể trả về None.

coverage_tool

File PyRuntimeInfo.coverage_tool

Nếu được đặt, trường này là một công cụ đại diện File dùng để thu thập thông tin về mức độ sử dụng mã từ các chương trình kiểm thử python. Nếu không, giá trị sẽ là None. Có thể trả về None.

tệp

depset PyRuntimeInfo.files

Nếu đây là môi trường thời gian chạy đang được tạo bản dựng, thì trường này là depset gồm các File cần được thêm vào các tệp chạy của một mục tiêu thực thi sử dụng thời gian chạy này (cụ thể là các tệp mà interpreter cần đến). Bạn không cần thêm giá trị của interpreter vào trường này. Nếu đây là thời gian chạy nền tảng thì trường này là None. Có thể trả về None.

trình thông dịch

File PyRuntimeInfo.interpreter

Nếu đây là thời gian chạy tích hợp, thì trường này là File đại diện cho trình phiên dịch. Nếu không, giá trị này là None. Xin lưu ý rằng môi trường thời gian chạy tích hợp có thể sử dụng trình phiên dịch tạo sẵn, có yêu cầu xác nhận an toàn hoặc trình thông dịch được tạo từ nguồn. Có thể trả về None.

interpreter_path

string PyRuntimeInfo.interpreter_path

Nếu đây là môi trường thời gian chạy trên nền tảng, trường này là đường dẫn hệ thống tệp tuyệt đối đến trình phiên dịch trên nền tảng đích. Nếu không, giá trị này là None. Có thể trả về None.

python_version

string PyRuntimeInfo.python_version

Cho biết thời gian chạy này sử dụng phiên bản chính Python 2 hay 3. Các giá trị hợp lệ (chỉ) là "PY2" và "PY3".

stub_shebang

string PyRuntimeInfo.stub_shebang

Biểu thức "Shebang" được thêm vào tập lệnh giả lập Python khởi động được dùng khi thực thi các mục tiêu py_binary. Không áp dụng cho Windows.