Args

Thường xảy ra trường hợp một hành động yêu cầu một dòng lệnh lớn chứa các giá trị được tích luỹ từ các phần phụ thuộc bắc cầu. Ví dụ: một dòng lệnh của trình liên kết có thể liệt kê mọi tệp đối tượng mà tất cả thư viện đang được liên kết cần. Phương pháp hay nhất là lưu trữ dữ liệu bắc cầu như vậy trong depset để chúng có thể được nhiều mục tiêu chia sẻ. Tuy nhiên, nếu tác giả quy tắc phải chuyển đổi các phần sắp xếp lại này thành danh sách chuỗi để tạo một dòng lệnh hành động, thì việc tối ưu hoá chia sẻ bộ nhớ sẽ không cho phép tác giả.

Vì lý do này, các hàm xây dựng hành động chấp nhận cả đối tượng Args ngoài chuỗi. Mỗi đối tượng Args đại diện cho một chuỗi và phần tách, với các phép biến đổi tuỳ chọn để thao tác với dữ liệu. Các đối tượng Args không xử lý phần mô tả mà chúng đóng gói cho đến giai đoạn thực thi, khi đến thời điểm tính toán dòng lệnh. Cách này giúp trì hoãn mọi hoạt động sao chép tốn kém cho đến khi giai đoạn phân tích hoàn tất. Hãy xem trang Tối ưu hoá hiệu suất để biết thêm thông tin.

Args được tạo bằng cách gọi ctx.actions.args(). Các sự kiện này có thể được truyền dưới dạng tham số arguments của ctx.actions.run() hoặc ctx.actions.run_shell(). Mỗi lần đột biến của một đối tượng Args sẽ thêm các giá trị vào dòng lệnh cuối cùng.

Tính năng map_each hỗ trợ bạn tuỳ chỉnh cách các mục được chuyển đổi thành chuỗi. Nếu bạn không cung cấp hàm map_each, thì lượt chuyển đổi chuẩn như sau:

• Các giá trị đã là chuỗi vẫn được giữ nguyên.
• Các đối tượng File được chuyển thành giá trị File.path.
• Tất cả các loại khác được chuyển thành chuỗi theo cách không được chỉ định. Vì lý do này, bạn nên tránh truyền các giá trị không phải là chuỗi hoặc loại File vào add(), và nếu truyền các giá trị đó đến add_all() hoặc add_joined() thì bạn nên cung cấp hàm map_each.

Khi sử dụng định dạng chuỗi (tham số format, format_each và format_joined của phương thức add*()), mẫu định dạng được diễn giải theo cách tương tự như phép thay thế % trên chuỗi, ngoại trừ việc mẫu phải có đúng một phần giữ chỗ thay thế và phải là %s. Tỷ lệ phần trăm cố định có thể được thoát dưới dạng %%. Định dạng được áp dụng sau khi giá trị được chuyển đổi thành chuỗi theo cách trên.

Mỗi phương thức add*() đều có một biểu mẫu thay thế chấp nhận một thông số vị trí bổ sung là "tên đối số" cần chèn trước phần còn lại của đối số. Đối với add_all và add_joined, chuỗi bổ sung sẽ không được thêm vào nếu chuỗi đó trống. Ví dụ: cùng một cách sử dụng có thể thêm --foo val1 val2 val3 --bar hoặc chỉ --bar vào dòng lệnh, tuỳ thuộc vào việc trình tự đã cho có chứa val1..val3 hay trống.

Nếu kích thước của dòng lệnh có thể dài hơn kích thước tối đa mà hệ thống cho phép, các đối số có thể bị tràn vào các tệp tham số. Hãy xem use_param_file() và set_param_file_format().

Ví dụ: Giả sử chúng ta muốn tạo dòng lệnh:

--foo foo1.txt foo2.txt ... fooN.txt --bar bar1.txt,bar2.txt,...,barM.txt --baz

# foo_deps and bar_deps are depsets containing
# File objects for the foo and bar .txt files.
args = ctx.actions.args()
args.add_all("--foo", foo_deps)
args.add_joined("--bar", bar_deps, join_with=",")
args.add("--baz")
ctx.actions.run(
  ...
  arguments = [args],
  ...
)

Hội viên

• thêm
• add_all
• add_joined
• set_param_file_format
• use_param_file

thêm

Args Args.add(arg_name_or_value, value=unbound, *, format=None)

Tham số

add_all

Args Args.add_all(arg_name_or_values, values=unbound, *, map_each=None, format_each=None, before_each=None, omit_if_empty=True, uniquify=False, expand_directories=True, terminate_with=None, allow_closure=False)

Hầu hết quá trình xử lý diễn ra đối với một danh sách các đối số cần được thêm vào, theo các bước sau:

1. Mỗi mục trong thư mục File sẽ được thay thế bằng tất cả các File có trong thư mục đó theo quy tắc đệ quy.
2. Nếu cung cấp map_each, đối số này sẽ được áp dụng cho từng mục và danh sách các chuỗi thu được sẽ được nối với nhau để tạo thành danh sách đối số ban đầu. Nếu không, danh sách đối số ban đầu là kết quả của việc áp dụng lượt chuyển đổi chuẩn cho mỗi mục.
3. Mỗi đối số trong danh sách được định dạng bằng format_each nếu có.
4. Nếu uniquify là đúng, các đối số trùng lặp sẽ bị xoá. Lần xuất hiện đầu tiên là sự kiện còn lại.
5. Nếu đã cung cấp một chuỗi before_each, chuỗi đó sẽ được chèn dưới dạng một đối số mới trước mỗi đối số hiện có trong danh sách. Thao tác này sẽ tăng gấp đôi số lượng đối số cần thêm vào điểm này một cách hiệu quả.
6. Ngoại trừ trường hợp danh sách trống và omit_if_empty là true (mặc định), tên đối số và terminate_with sẽ được chèn lần lượt làm đối số đầu và đối số cuối, nếu có.

Tham số

add_joined

Args Args.add_joined(arg_name_or_values, values=unbound, *, join_with, map_each=None, format_each=None, format_joined=None, omit_if_empty=True, uniquify=False, expand_directories=True, allow_closure=False)

Quá trình xử lý tương tự như add_all(), nhưng danh sách các đối số bắt nguồn từ values được kết hợp thành một đối số duy nhất như thể bằng join_with.join(...), sau đó được định dạng bằng mẫu chuỗi format_joined đã cho. Không giống như add_all(), không có tham số before_each hoặc terminate_with vì các tham số này thường không hữu ích khi các mục được kết hợp thành một đối số duy nhất.

Nếu sau khi lọc không có chuỗi nào để kết hợp vào một đối số và nếu omit_if_empty là true (giá trị mặc định), thì quá trình xử lý sẽ không được hoàn tất. Ngược lại, nếu không có chuỗi nào để kết hợp nhưng omit_if_empty là false, thì chuỗi đã kết hợp sẽ là một chuỗi trống.

Tham số

set_param_file_format

Args Args.set_param_file_format(format)

Tham số

use_param_file

Args Args.use_param_file(param_file_arg, *, use_always=False)

Bazel có thể chọn elide ghi tệp tham số vào cây đầu ra trong quá trình thực thi để đảm bảo hiệu quả. Nếu bạn đang gỡ lỗi hành động và muốn kiểm tra tệp thông số, hãy truyền --materialize_param_files vào bản dựng.

Tham số