Ngữ cảnh của quy tắc kho lưu trữ chứa các hàm trợ giúp và thông tin về các thuộc tính. Bạn sẽ nhận được đối tượng repository_ctx làm đối số cho hàm implementation khi tạo quy tắc kho lưu trữ.
Hội viên
- attr
- xóa
- tải xuống
- download_and_extract
- thực thi
- trích xuất
- tệp
- getenv
- name
- hệ điều hành
- bản vá
- path
- đọc
- đổi tên
- report_progress
- symlink
- mẫu
- watch
- watch_tree
- mà
- workspace_root
attr
struct repository_ctx.attrMột cấu trúc để truy cập vào các giá trị của thuộc tính. Giá trị do người dùng cung cấp (nếu không, hệ thống sẽ sử dụng giá trị mặc định).
xóa
bool repository_ctx.delete(path)Xoá một tệp hoặc thư mục. Trả về một bool, cho biết liệu lệnh gọi này có thực sự xoá tệp hoặc thư mục hay không.
Tham số
| Thông số | Mô tả |
|---|---|
path
|
chuỗi; hoặc đường dẫn;
bắt buộc Đường dẫn của tệp cần xoá, tương ứng với thư mục kho lưu trữ hoặc tuyệt đối. Có thể là một đường dẫn hoặc một chuỗi. |
tải xuống
unknown repository_ctx.download(url, output='', sha256='', executable=False, allow_fail=False, canonical_id='', auth={}, headers={}, *, integrity='', block=True)
Tải một tệp xuống đường dẫn đầu ra cho URL đã cung cấp và trả về một cấu trúc chứa success, một cờ là true nếu quá trình tải xuống hoàn tất thành công và nếu thành công, một hàm băm của tệp có các trường sha256 và integrity. Khi sha256 hoặc integrity do người dùng chỉ định, bạn nên đặt canonical_id rõ ràng. Ví dụ: get_default_canonical_id
Tham số
| Thông số | Mô tả |
|---|---|
url
|
chuỗi; hoặc Iterable của chuỗi;
bắt buộc Danh sách URL phản chiếu tham chiếu đến cùng một tệp. |
output
|
chuỗi; hoặc Nhãn; hoặc đường dẫn; giá trị mặc định là ''đường dẫn đến tệp đầu ra, tương ứng với thư mục kho lưu trữ. |
sha256
|
chuỗi; giá trị mặc định là ''Hàm băm SHA-256 dự kiến của tệp đã tải xuống. Hàm băm này phải khớp với hàm băm SHA-256 của tệp đã tải xuống. Việc bỏ qua SHA-256 là một rủi ro bảo mật vì các tệp từ xa có thể thay đổi. Tốt nhất là bạn không nên bỏ qua trường này vì sẽ khiến bản dựng của bạn không kín. Bạn không bắt buộc phải làm việc này để việc phát triển trở nên dễ dàng hơn, nhưng bạn nên thiết lập trước khi xuất bản. Trước tiên, bộ nhớ đệm kho lưu trữ sẽ được kiểm tra để tìm tệp có hàm băm đã cho (nếu có); quá trình tải xuống sẽ chỉ được thực hiện nếu không tìm thấy tệp trong bộ nhớ đệm. Sau khi tải xuống thành công, tệp sẽ được thêm vào bộ nhớ đệm. |
executable
|
bool; giá trị mặc định là FalseĐặt cờ thực thi trên tệp đã tạo, giá trị mặc định là false. |
allow_fail
|
bool; giá trị mặc định là FalseNếu được đặt, hãy cho biết lỗi trong giá trị trả về thay vì báo lỗi cho các lượt tải xuống không thành công. |
canonical_id
|
chuỗi;
mặc định là ''Nếu được đặt, hãy hạn chế số lượt truy cập vào bộ nhớ đệm ở những trường hợp tệp được thêm vào bộ nhớ đệm có cùng mã chuẩn hoá. Theo mặc định, tính năng lưu vào bộ nhớ đệm sử dụng tổng kiểm ( sha256 hoặc integrity).
|
auth
|
dict; giá trị mặc định là {}Một dict không bắt buộc chỉ định thông tin xác thực cho một số URL. |
headers
|
dict;
mặc định là {}Một dict không bắt buộc chỉ định tiêu đề http cho tất cả URL. |
integrity
|
string; giá trị mặc định là ''Giá trị tổng kiểm dự kiến của tệp đã tải xuống, ở định dạng Tính toàn vẹn của tài nguyên phụ. Giá trị này phải khớp với tổng kiểm của tệp đã tải xuống. Việc bỏ qua tổng kiểm tra là một rủi ro bảo mật vì các tệp từ xa có thể thay đổi. Tốt nhất là bạn không nên bỏ qua trường này vì sẽ khiến bản dựng của bạn không kín. Bạn không bắt buộc phải làm việc này để việc phát triển trở nên dễ dàng hơn, nhưng bạn nên thiết lập trước khi xuất bản. Trước tiên, nếu được cung cấp, bộ nhớ đệm kho lưu trữ sẽ được kiểm tra để tìm tệp có tổng kiểm đã cho; quá trình tải xuống sẽ chỉ được thực hiện nếu không tìm thấy tệp trong bộ nhớ đệm. Sau khi tải xuống thành công, tệp sẽ được thêm vào bộ nhớ đệm. |
block
|
bool; giá trị mặc định là TrueNếu được đặt thành false, lệnh gọi sẽ trả về ngay lập tức và thay vì giá trị trả về thông thường, lệnh gọi này sẽ trả về một mã thông báo bằng một phương thức duy nhất, wait(), phương thức này sẽ chặn cho đến khi quá trình tải xuống hoàn tất và trả về giá trị trả về thông thường hoặc gửi như bình thường. |
download_and_extract
struct repository_ctx.download_and_extract(url, output='', sha256='', type='', strip_prefix='', allow_fail=False, canonical_id='', auth={}, headers={}, *, integrity='', rename_files={})Tải một tệp xuống đường dẫn đầu ra cho URL đã cung cấp, trích xuất tệp đó và trả về một cấu trúc chứa
success, một cờ là true nếu quá trình tải xuống hoàn tất thành công và nếu thành công, một hàm băm của tệp có các trường sha256 và integrity. Khi sha256 hoặc integrity do người dùng chỉ định, bạn nên đặt canonical_id rõ ràng. Ví dụ: get_default_canonical_id
Tham số
| Thông số | Mô tả |
|---|---|
url
|
chuỗi; hoặc Iterable của chuỗi;
bắt buộc Danh sách URL phản chiếu tham chiếu đến cùng một tệp. |
output
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
mặc định là ''Đường dẫn đến thư mục nơi giải nén tệp lưu trữ, tương ứng với thư mục kho lưu trữ. |
sha256
|
chuỗi; giá trị mặc định là ''Hàm băm SHA-256 dự kiến của tệp đã tải xuống. Hàm băm này phải khớp với hàm băm SHA-256 của tệp đã tải xuống. Việc bỏ qua SHA-256 là một rủi ro bảo mật vì các tệp từ xa có thể thay đổi. Tốt nhất là bạn không nên bỏ qua trường này vì sẽ khiến bản dựng của bạn không kín. Bạn không bắt buộc phải làm việc này để việc phát triển trở nên dễ dàng hơn, nhưng bạn nên thiết lập trước khi xuất bản. Trước tiên, bộ nhớ đệm kho lưu trữ sẽ được kiểm tra để tìm tệp có hàm băm đã cho (nếu có); quá trình tải xuống sẽ chỉ được thực hiện nếu không tìm thấy tệp trong bộ nhớ đệm. Sau khi tải xuống thành công, tệp sẽ được thêm vào bộ nhớ đệm. |
type
|
string; giá trị mặc định là ''Loại tệp lưu trữ của tệp đã tải xuống. Theo mặc định, loại tệp lưu trữ được xác định từ đuôi tệp của URL. Nếu tệp không có đuôi, bạn có thể chỉ định rõ ràng "zip", "jar", "war", "aar", "nupkg", "tar", "tar.gz", "tgz", "tar.xz", "txz", ".tar.zst", ".tzst", "tar.bz2", ".tbz", ".ar" hoặc ".deb" tại đây. |
strip_prefix
|
string; giá trị mặc định là ''Tiền tố thư mục cần xoá khỏi các tệp đã trích xuất. Nhiều tệp lưu trữ chứa một thư mục cấp cao nhất chứa tất cả các tệp trong tệp lưu trữ. Thay vì cần phải chỉ định tiền tố này nhiều lần trong build_file, bạn có thể sử dụng trường này để xoá tiền tố đó khỏi các tệp đã trích xuất.
Để đảm bảo khả năng tương thích, bạn cũng có thể sử dụng tham số này theo tên không dùng nữa là |
allow_fail
|
bool; giá trị mặc định là FalseNếu được đặt, hãy cho biết lỗi trong giá trị trả về thay vì báo lỗi cho các lượt tải xuống không thành công. |
canonical_id
|
chuỗi;
mặc định là ''Nếu được đặt, hãy hạn chế số lượt truy cập vào bộ nhớ đệm ở những trường hợp tệp được thêm vào bộ nhớ đệm có cùng mã chuẩn hoá. Theo mặc định, tính năng lưu vào bộ nhớ đệm sử dụng tổng kiểm" ( sha256 hoặc integrity).
|
auth
|
dict; giá trị mặc định là {}Một dict không bắt buộc chỉ định thông tin xác thực cho một số URL. |
headers
|
dict;
mặc định là {}Một dict không bắt buộc chỉ định tiêu đề http cho tất cả URL. |
integrity
|
string; giá trị mặc định là ''Giá trị tổng kiểm dự kiến của tệp đã tải xuống, ở định dạng Tính toàn vẹn của tài nguyên phụ. Giá trị này phải khớp với tổng kiểm của tệp đã tải xuống. Việc bỏ qua tổng kiểm tra là một rủi ro bảo mật vì các tệp từ xa có thể thay đổi. Tốt nhất là bạn không nên bỏ qua trường này vì sẽ khiến bản dựng của bạn không kín. Bạn không bắt buộc phải làm việc này để việc phát triển trở nên dễ dàng hơn, nhưng bạn nên thiết lập trước khi xuất bản. Trước tiên, nếu được cung cấp, bộ nhớ đệm kho lưu trữ sẽ được kiểm tra để tìm tệp có tổng kiểm đã cho; quá trình tải xuống sẽ chỉ được thực hiện nếu không tìm thấy tệp trong bộ nhớ đệm. Sau khi tải xuống thành công, tệp sẽ được thêm vào bộ nhớ đệm. |
rename_files
|
dict; giá trị mặc định là {}Một dict không bắt buộc chỉ định các tệp cần đổi tên trong quá trình trích xuất. Các mục lưu trữ có tên khớp chính xác với một khoá sẽ được đổi tên thành giá trị đó, trước khi điều chỉnh tiền tố thư mục. Bạn có thể dùng tính năng này để trích xuất các tệp lưu trữ chứa tên tệp không phải Unicode hoặc có các tệp sẽ trích xuất vào cùng một đường dẫn trên các hệ thống tệp không phân biệt chữ hoa chữ thường. |
thực thi
exec_result repository_ctx.execute(arguments, timeout=600, environment={}, quiet=True, working_directory="")Thực thi lệnh do danh sách đối số cung cấp. Thời gian thực thi của lệnh bị giới hạn bởi
timeout (tính bằng giây, mặc định là 600 giây). Phương thức này trả về một cấu trúc exec_result chứa kết quả của lệnh. Bạn có thể sử dụng bản đồ environment để ghi đè một số biến môi trường sẽ được truyền vào quy trình.
Tham số
| Thông số | Mô tả |
|---|---|
arguments
|
sequence;
bắt buộc Danh sách đối số, phần tử đầu tiên phải là đường dẫn đến chương trình cần thực thi. |
timeout
|
int;
mặc định là 600Thời lượng tối đa của lệnh tính bằng giây (mặc định là 600 giây). |
environment
|
dict; giá trị mặc định là {}Buộc một số biến môi trường được đặt để truyền vào quy trình. Giá trị có thể là None để xoá biến môi trường.
|
quiet
|
bool; giá trị mặc định là TrueNếu stdout và stderr được in ra thiết bị đầu cuối. |
working_directory
|
chuỗi; giá trị mặc định là ""Thư mục đang hoạt động để thực thi lệnh. Có thể tương đối so với thư mục gốc của kho lưu trữ hoặc tuyệt đối. Giá trị mặc định là thư mục gốc của kho lưu trữ. |
trích xuất
None repository_ctx.extract(archive, output='', strip_prefix='', *, rename_files={}, watch_archive='auto')Tham số
| Thông số | Mô tả |
|---|---|
archive
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc đường dẫn đến tệp lưu trữ sẽ được giải nén, tương ứng với thư mục kho lưu trữ. |
output
|
chuỗi; hoặc Nhãn; hoặc đường dẫn; giá trị mặc định là ''đường dẫn đến thư mục nơi giải nén tệp lưu trữ, tương ứng với thư mục kho lưu trữ. |
strip_prefix
|
chuỗi; giá trị mặc định là '', tiền tố thư mục cần xoá khỏi các tệp đã trích xuất. Nhiều tệp lưu trữ chứa một thư mục cấp cao nhất chứa tất cả các tệp trong tệp lưu trữ. Thay vì cần phải chỉ định tiền tố này nhiều lần trong build_file, bạn có thể sử dụng trường này để xoá tiền tố đó khỏi các tệp đã trích xuất.
Để đảm bảo khả năng tương thích, bạn cũng có thể sử dụng tham số này theo tên không dùng nữa là |
rename_files
|
dict; giá trị mặc định là {}Một dict không bắt buộc chỉ định các tệp cần đổi tên trong quá trình trích xuất. Các mục lưu trữ có tên khớp chính xác với một khoá sẽ được đổi tên thành giá trị đó, trước khi điều chỉnh tiền tố thư mục. Bạn có thể dùng tính năng này để trích xuất các tệp lưu trữ chứa tên tệp không phải Unicode hoặc có các tệp sẽ trích xuất vào cùng một đường dẫn trên các hệ thống tệp không phân biệt chữ hoa chữ thường. |
watch_archive
|
chuỗi; giá trị mặc định là 'auto'cho biết có xem tệp lưu trữ hay không. Có thể là chuỗi "yes" (có), "no" (không) hoặc "auto" (tự động). Việc truyền "yes" tương đương với việc gọi ngay phương thức watch(); việc truyền "no" sẽ không cố gắng theo dõi tệp; việc truyền "auto" sẽ chỉ cố gắng theo dõi tệp khi được phép (xem tài liệu về watch() để biết thêm thông tin.
|
tệp
None repository_ctx.file(path, content='', executable=True, legacy_utf8=False)Tham số
| Thông số | Mô tả |
|---|---|
path
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc Đường dẫn của tệp cần tạo, tương ứng với thư mục kho lưu trữ. |
content
|
string; giá trị mặc định là ''Nội dung của tệp cần tạo, trống theo mặc định. |
executable
|
bool; giá trị mặc định là TrueĐặt cờ thực thi trên tệp đã tạo, true theo mặc định. |
legacy_utf8
|
bool; giá trị mặc định là FalseKhông hoạt động. Tham số này không còn được dùng nữa và sẽ bị xoá trong phiên bản Bazel sau này. |
getenv
string repository_ctx.getenv(name, default=None)Trả về giá trị của biến môi trường
name dưới dạng chuỗi nếu có hoặc default nếu không có. Khi tạo dần, mọi thay đổi đối với giá trị của biến do name đặt tên sẽ khiến kho lưu trữ này được tìm nạp lại.
Tham số
| Thông số | Mô tả |
|---|---|
name
|
string;
bắt buộc Tên của biến môi trường mong muốn. |
default
|
string; hoặc None; giá trị mặc định là NoneGiá trị mặc định để trả về nếu không tìm thấy name.
|
None.
tên
string repository_ctx.nameTên của kho lưu trữ bên ngoài do quy tắc này tạo.
hệ điều hành
repository_os repository_ctx.osMột cấu trúc để truy cập thông tin từ hệ thống.
bản vá
None repository_ctx.patch(patch_file, strip=0, *, watch_patch='auto')Tham số
| Thông số | Mô tả |
|---|---|
patch_file
|
chuỗi; hoặc Nhãn; hoặc đường dẫn; bắt buộc Tệp bản vá cần áp dụng, có thể là nhãn, đường dẫn tương đối hoặc đường dẫn tuyệt đối. Nếu là đường dẫn tương đối, đường dẫn này sẽ phân giải đến thư mục kho lưu trữ. |
strip
|
int;
mặc định là 0Loại bỏ số lượng thành phần đầu tiên được chỉ định khỏi tên tệp. |
watch_patch
|
string;
mặc định là 'auto'Liệu có theo dõi tệp bản vá hay không. Có thể là chuỗi "yes" (có), "no" (không) hoặc "auto" (tự động). Việc truyền "yes" tương đương với việc gọi ngay phương thức watch(); việc truyền "no" sẽ không cố gắng theo dõi tệp; việc truyền "auto" sẽ chỉ cố gắng theo dõi tệp khi được phép (xem tài liệu về watch() để biết thêm thông tin.
|
đường dẫn
path repository_ctx.path(path)Trả về một đường dẫn từ một chuỗi, nhãn hoặc đường dẫn. Nếu đường dẫn là tương đối, thì đường dẫn đó sẽ phân giải tương ứng với thư mục kho lưu trữ. Nếu đường dẫn là một nhãn, thì đường dẫn đó sẽ phân giải thành đường dẫn của tệp tương ứng. Xin lưu ý rằng các kho lưu trữ từ xa được thực thi trong giai đoạn phân tích và do đó không thể phụ thuộc vào kết quả mục tiêu (nhãn phải trỏ đến một tệp không được tạo). Nếu path là một đường dẫn, thì hàm này sẽ trả về đường dẫn đó nguyên trạng.
Tham số
| Thông số | Mô tả |
|---|---|
path
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộcstring, Label hoặc path để tạo đường dẫn.
|
đọc
string repository_ctx.read(path, *, watch='auto')Đọc nội dung của một tệp trên hệ thống tệp.
Tham số
| Thông số | Mô tả |
|---|---|
path
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc Đường dẫn của tệp cần đọc. |
watch
|
string;
mặc định là 'auto'Liệu có theo dõi tệp hay không. Có thể là chuỗi "yes" (có), "no" (không) hoặc "auto" (tự động). Việc truyền "yes" tương đương với việc gọi ngay phương thức watch(); việc truyền "no" sẽ không cố gắng theo dõi tệp; việc truyền "auto" sẽ chỉ cố gắng theo dõi tệp khi được phép (xem tài liệu về watch() để biết thêm thông tin.
|
đổi tên
None repository_ctx.rename(src, dst)src thành dst. Các thư mục mẹ sẽ được tạo khi cần. Không thành công nếu đường dẫn đích đã tồn tại. Cả hai đường dẫn đều phải nằm trong kho lưu trữ.
Tham số
| Thông số | Mô tả |
|---|---|
src
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc Đường dẫn của tệp hoặc thư mục hiện có cần đổi tên, tương ứng với thư mục kho lưu trữ. |
dst
|
string; hoặc Label; hoặc path;
bắt buộc Tên mới mà tệp hoặc thư mục sẽ được đổi tên thành, so với thư mục kho lưu trữ. |
report_progress
None repository_ctx.report_progress(status='')Tham số
| Thông số | Mô tả |
|---|---|
status
|
chuỗi; giá trị mặc định là ''string mô tả trạng thái hiện tại của tiến trình tìm nạp.
|
liên kết tượng trưng
None repository_ctx.symlink(target, link_name)Tham số
| Thông số | Mô tả |
|---|---|
target
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc Đường dẫn mà đường liên kết tượng trưng sẽ trỏ đến. |
link_name
|
string; hoặc Label; hoặc path;
bắt buộc Đường dẫn của đường liên kết tượng trưng cần tạo. |
ManualContentEmbargoesScheduleTemplate.xlsx
None repository_ctx.template(path, template, substitutions={}, executable=True, *, watch_template='auto')template. Mọi lần xuất hiện trong template của khoá substitutions sẽ được thay thế bằng giá trị tương ứng. Kết quả được viết trong path. Bạn có thể đặt đối số executable không bắt buộc (mặc định là true) để bật hoặc tắt bit thực thi.
Tham số
| Thông số | Mô tả |
|---|---|
path
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc Đường dẫn của tệp cần tạo, tương ứng với thư mục kho lưu trữ. |
template
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc Đường dẫn đến tệp mẫu. |
substitutions
|
dict; giá trị mặc định là {}. Các giá trị thay thế cần thực hiện khi mở rộng mẫu. |
executable
|
bool; giá trị mặc định là TrueĐặt cờ thực thi trên tệp đã tạo, true theo mặc định. |
watch_template
|
string;
mặc định là 'auto'Liệu có theo dõi tệp mẫu hay không. Có thể là chuỗi "yes" (có), "no" (không) hoặc "auto" (tự động). Việc truyền "yes" tương đương với việc gọi ngay phương thức watch(); việc truyền "no" sẽ không cố gắng theo dõi tệp; việc truyền "auto" sẽ chỉ cố gắng theo dõi tệp khi được phép (xem tài liệu về watch() để biết thêm thông tin.
|
đồng hồ
None repository_ctx.watch(path)"Thay đổi" bao gồm các thay đổi đối với nội dung của tệp (nếu đường dẫn là tệp); nếu đường dẫn là tệp nhưng hiện là thư mục hoặc ngược lại; và nếu đường dẫn bắt đầu hoặc ngừng tồn tại. Lưu ý rằng việc này không bao gồm các thay đổi đối với bất kỳ tệp nào trong thư mục nếu đường dẫn là một thư mục. Thay vào đó, hãy sử dụng path.readdir().
Xin lưu ý rằng việc cố gắng theo dõi các đường dẫn bên trong kho lưu trữ đang được tìm nạp hoặc bên trong thư mục đang hoạt động của tiện ích mô-đun hiện tại sẽ dẫn đến lỗi. Tiện ích mô-đun cố gắng theo dõi một đường dẫn bên ngoài không gian làm việc Bazel hiện tại cũng sẽ dẫn đến lỗi.
Tham số
| Thông số | Mô tả |
|---|---|
path
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc Đường dẫn của tệp cần theo dõi. |
watch_tree
None repository_ctx.watch_tree(path)Xin lưu ý rằng việc cố gắng theo dõi các đường dẫn bên trong kho lưu trữ đang được tìm nạp sẽ dẫn đến lỗi.
Tham số
| Thông số | Mô tả |
|---|---|
path
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc Đường dẫn của cây thư mục cần theo dõi. |
thiết bị nào
path repository_ctx.which(program)Trả về
path của chương trình tương ứng hoặc None nếu không có chương trình nào như vậy trong đường dẫn.
Tham số
| Thông số | Mô tả |
|---|---|
program
|
string;
bắt buộc Chương trình cần tìm trong đường dẫn. |
None.
workspace_root
path repository_ctx.workspace_rootĐường dẫn đến không gian làm việc gốc của lệnh gọi bazel.