Quy tắc shell

Báo cáo vấn đề Xem nguồn Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Quy tắc

sh_binary

Xem nguồn quy tắc 
sh_binary(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, output_licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

Quy tắc sh_binary dùng để khai báo tập lệnh shell có thể thực thi. (sh_binary là tên gọi sai: đầu ra của hàm này không nhất thiết phải là tệp nhị phân.) Quy tắc này đảm bảo rằng tất cả phần phụ thuộc đều được tạo và xuất hiện trong vùng runfiles tại thời điểm thực thi. Bạn nên đặt tên cho các quy tắc sh_binary() theo tên của tập lệnh trừ đi đuôi tệp (ví dụ: .sh); tên quy tắc và tên tệp phải khác nhau. sh_binary tuân theo shebang, vì vậy, bạn có thể sử dụng bất kỳ trình thông dịch nào có sẵn (ví dụ: #!/bin/zsh)

Ví dụ:

Đối với tập lệnh shell đơn giản không có phần phụ thuộc và một số tệp dữ liệu: 

sh_binary(
    name = "foo",
    srcs = ["foo.sh"],
    data = glob(["datafiles/*.txt"]),
)

Đối số

Thuộc tính
name

Tên; bắt buộc

Tên duy nhất cho mục tiêu này.
deps

Danh sách nhãn; mặc định là []

Danh sách mục tiêu "thư viện" được tổng hợp vào mục tiêu này. Xem các nhận xét chung về deps tại phần Các thuộc tính thông thường do hầu hết các quy tắc bản dựng xác định.

Bạn nên sử dụng thuộc tính này để liệt kê các quy tắc sh_library khác cung cấp mã nguồn chương trình được diễn giải mà mã trong srcs phụ thuộc vào. Các tệp do các quy tắc này cung cấp sẽ xuất hiện trong runfiles của mục tiêu này.

srcs

Danh sách nhãn; mặc định là []

Danh sách tệp đầu vào.

Bạn nên sử dụng thuộc tính này để liệt kê các tệp nguồn tập lệnh shell thuộc thư viện này. Các tập lệnh có thể tải các tập lệnh khác bằng cách sử dụng lệnh source hoặc . của shell.

env_inherit

Danh sách chuỗi; mặc định là []

sh_library

Xem nguồn quy tắc 
sh_library(name, deps, srcs, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

Mục đích chính của quy tắc này là tổng hợp một "thư viện" logic bao gồm các tập lệnh liên quan – các chương trình bằng một ngôn ngữ được diễn giải không yêu cầu biên dịch hoặc liên kết, chẳng hạn như Bourne shell – và mọi dữ liệu mà các chương trình đó cần trong thời gian chạy. Sau đó, bạn có thể sử dụng "thư viện" như vậy từ thuộc tính data của một hoặc nhiều quy tắc sh_binary.

Bạn có thể sử dụng quy tắc filegroup để tổng hợp các tệp dữ liệu.

Trong các ngôn ngữ lập trình được diễn giải, không phải lúc nào cũng có sự phân biệt rõ ràng giữa "mã" và "dữ liệu": xét cho cùng, chương trình chỉ là "dữ liệu" theo quan điểm của trình thông dịch. Vì lý do này, quy tắc này có 3 thuộc tính về cơ bản là tương đương: srcs, deps và data. Cách triển khai hiện tại không phân biệt giữa các phần tử của các danh sách này. Cả ba thuộc tính đều chấp nhận quy tắc, tệp nguồn và tệp được tạo. Tuy nhiên, bạn nên sử dụng các thuộc tính cho mục đích thông thường (như với các quy tắc khác).

Ví dụ

sh_library(
    name = "foo",
    data = [
        ":foo_service_script",  # an sh_binary with srcs
        ":deploy_foo",  # another sh_binary with srcs
    ],
)

Đối số

Thuộc tính
name

Tên; bắt buộc

Tên duy nhất cho mục tiêu này.
deps

Danh sách nhãn; mặc định là []

Danh sách các mục tiêu "thư viện" sẽ được tổng hợp vào mục tiêu này. Xem các nhận xét chung về deps tại phần Các thuộc tính thông thường do hầu hết các quy tắc bản dựng xác định.

Bạn nên sử dụng thuộc tính này để liệt kê các quy tắc sh_library khác cung cấp mã nguồn chương trình được diễn giải phụ thuộc vào mã trong srcs. Các tệp do các quy tắc này cung cấp sẽ xuất hiện trong runfiles của mục tiêu này.

srcs

Danh sách nhãn; mặc định là []

Danh sách tệp nhập.

Bạn nên sử dụng thuộc tính này để liệt kê các tệp nguồn tập lệnh shell thuộc về thư viện này. Các tập lệnh có thể tải các tập lệnh khác bằng lệnh source hoặc . của shell.

sh_test

Xem nguồn quy tắc 
sh_test(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, local, restricted_to, shard_count, size, tags, target_compatible_with, testonly, timeout, toolchains, visibility)

Quy tắc sh_binary dùng để khai báo các tập lệnh shell có thể thực thi. (sh_binary là tên gọi sai: đầu ra của hàm này không nhất thiết phải là tệp nhị phân.) Quy tắc này đảm bảo rằng tất cả phần phụ thuộc đều được tạo và xuất hiện trong vùng runfiles tại thời điểm thực thi. Bạn nên đặt tên cho các quy tắc sh_binary() sau tên của tập lệnh trừ đi phần mở rộng (ví dụ: .sh); tên quy tắc và tên tệp phải khác biệt. sh_binary tuân theo nguyên tắc cộng đồng, vì vậy, bạn có thể sử dụng bất kỳ thông dịch viên nào có sẵn (ví dụ: #!/bin/zsh)

Ví dụ:

Đối với tập lệnh shell đơn giản không có phần phụ thuộc và một số tệp dữ liệu: 

sh_binary(
    name = "foo",
    srcs = ["foo.sh"],
    data = glob(["datafiles/*.txt"]),
)

Đối số

Thuộc tính
name

Tên; bắt buộc

Tên duy nhất cho mục tiêu này.
deps

Danh sách nhãn; mặc định là []

Danh sách các mục tiêu "thư viện" sẽ được tổng hợp vào mục tiêu này. Xem nhận xét chung về deps tại phần Các thuộc tính điển hình được hầu hết các quy tắc xây dựng xác định.

Bạn nên sử dụng thuộc tính này để liệt kê các quy tắc sh_library khác cung cấp mã nguồn chương trình được diễn giải mà mã trong srcs phụ thuộc vào. Các tệp do các quy tắc này cung cấp sẽ xuất hiện trong runfiles của mục tiêu này.

srcs

Danh sách nhãn; mặc định là []

Danh sách tệp nhập.

Bạn nên sử dụng thuộc tính này để liệt kê các tệp nguồn tập lệnh shell thuộc thư viện này. Các tập lệnh có thể tải các tập lệnh khác bằng cách sử dụng lệnh source hoặc . của shell.