template_ctx

Đối tượng theo bối cảnh được chuyển đến hàm mở rộng mẫu hành động.

Hội viên

• đối số
• declare_file
• declare_subdirectory
• chạy

đối số

Args template_ctx.args()

Trả về một đối tượng Args có thể dùng để tạo dòng lệnh tiết kiệm bộ nhớ.

declare_file

File template_ctx.declare_file(filename, *, directory)

Khai báo rằng quá trình triển khai sẽ tạo một tệp có tên tệp đã cho trong thư mục được chỉ định.

Hãy nhớ rằng ngoài việc khai báo một tệp, bạn phải tạo riêng một hành động phát ra tệp đó. Để tạo hành động đó, bạn cần chuyển đối tượng File đã trả về đến hàm tạo của hành động.

Thông số

Tham số	Mô tả
filename	chuỗi; bắt buộc Đường dẫn tương đối của tệp trong thư mục.
directory	Tệp; bắt buộc Thư mục mà tệp sẽ được tạo.

declare_subdirectory

File template_ctx.declare_subdirectory(subdirectory, *, directory)

Khai báo rằng quá trình triển khai sẽ tạo một thư mục con có tên đã cho trong thư mục được chỉ định.

Hãy nhớ rằng ngoài việc khai báo một thư mục con, bạn phải tạo riêng một hành động phát ra thư mục con đó. Để tạo hành động đó, bạn cần chuyển đối tượng File đã trả về đến hàm tạo của hành động.

Thông số

Tham số	Mô tả
subdirectory	chuỗi; bắt buộc Đường dẫn tương đối của thư mục con trong thư mục.
directory	Tệp; bắt buộc Thư mục mà thư mục con sẽ được tạo.

chạy

None template_ctx.run(*, outputs, inputs=[], executable, tools=None, arguments=[], progress_message=None)

Tạo một hành động chạy tệp thực thi.

Thông số

Tham số	Mô tả
outputs	dãy của Tệps; bắt buộc Danh sách các tệp đầu ra của hành động.
inputs	dãy Tệp; hoặc depset; mặc định là [] Danh sách hoặc depset của các tệp đầu vào của hành động.
executable	Tệp; hoặc chuỗi; hoặc FilesToRunProvider; bắt buộc Tệp thực thi sẽ được hành động gọi.
tools	dãy; hoặc depset; hoặc None; mặc định là None Danh sách hoặc depset của mọi công cụ mà hành động cần. Công cụ là các đầu vào thực thi có thể có các tệp chạy riêng được tự động cung cấp cho hành động. Khi cung cấp một danh sách, đó có thể là một tập hợp không đồng nhất gồm: File Các thực thể FilesToRunProvider depset của File File từ ctx.executable và FilesToRunProvider trực tiếp trong danh sách sẽ tự động được thêm tệp chạy. Tất cả công cụ đều được ngầm thêm dưới dạng đầu vào.
arguments	dãy; mặc định là [] Đối số dòng lệnh của hành động. Phải là danh sách các chuỗi hoặc actions.args() đối tượng.
progress_message	chuỗi; hoặc None; mặc định là None Thông báo tiến trình sẽ hiển thị cho người dùng trong quá trình xây dựng.