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
- name
- hệ điều hành
- bản vá
- đường dẫn
- đọc
- report_progress
- symlink
- mẫu
- mà
- workspace_root
attr
struct repository_ctx.attr
xóa
bool repository_ctx.delete(path)
Thông 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
struct repository_ctx.download(url, output='', sha256='', executable=False, allow_fail=False, canonical_id='', auth={}, *, integrity='')
success
. Cờ này 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
.
Thông số
Thông số | Mô tả |
---|---|
url
|
string; hoặc Có thể lặp lại 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
|
string; hoặc Label; hoặc path;
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
|
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 sẽ gây 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 nên bỏ qua trường này để bản dựng của bạn không bị ngắt quãng. 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. |
executable
|
mặc định là False đặt cờ thực thi trên tệp được tạo, mặc định là false. |
allow_fail
|
mặc định là False Nế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
|
mặc định là '' Nếu được đặt, hãy hạn chế các 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ã nhận dạng chuẩn |
auth
|
mặc định là {} Một tập hợp từ điển không bắt buộc chỉ định thông tin xác thực cho một số URL. |
integrity
|
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. |
download_and_extract
struct repository_ctx.download_and_extract(url, output='', sha256='', type='', stripPrefix='', allow_fail=False, canonical_id='', auth={}, *, integrity='', rename_files={})
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
.
Thông 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
|
string; hoặc Label; hoặc path;
mặc định là '' đường dẫn đến thư mục nơi tệp lưu trữ sẽ được giải nén, tương ứng với thư mục kho lưu trữ. |
sha256
|
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 sẽ gây 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
|
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", "tar", "tar.gz", "tgz", "tar.xz", "txz", ".tar.zst", ".tzst", "tar.bz2", ".tbz", ".ar" hoặc ".deb" tại đây. |
stripPrefix
|
mặc định là '' tiền tố thư mục để loại bỏ 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 chỉ định tiền tố này nhiều lần trong build_file , bạn có thể dùng trường này để xoá tiền tố đó khỏi các tệp đã trích xuất.
|
allow_fail
|
mặc định là False Nế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
|
mặc định là '' Nếu được đặt, hãy hạn chế các 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ã nhận dạng chuẩn |
auth
|
mặc định là {} Một tập hợp từ điển không bắt buộc chỉ định thông tin xác thực cho một số URL. |
integrity
|
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. |
rename_files
|
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 nhập lưu trữ có tên khớp chính xác với 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ể sử dụng công cụ này để trích xuất các tệp lưu trữ có chứa tên tệp không phải Unicode hoặc có tệp sẽ trích xuất sang cùng một đường dẫn trong 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="")
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ể dùng bản đồ environment
để ghi đè một số biến môi trường sẽ được truyền vào quy trình.
Thông số
Thông số | Mô tả |
---|---|
arguments
|
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
|
mặc định là 600 thời lượng tối đa của lệnh tính bằng giây (mặc định là 600 giây). |
environment
|
mặc định là {} buộc một số biến môi trường được đặt để truyền vào quy trình. |
quiet
|
mặc định là True Nếu stdout và stderr được in ra thiết bị đầu cuối. |
working_directory
|
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. |
trích xuất
None
repository_ctx.extract(archive, output='', stripPrefix='', *, rename_files={})
Thông 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ữ. |
stripPrefix
|
mặc định là '' tiền tố thư mục để loại bỏ 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 chỉ định tiền tố này nhiều lần trong build_file , bạn có thể dùng trường này để xoá tiền tố đó khỏi các tệp đã trích xuất.
|
rename_files
|
mặc định là {} Một lệnh chính tả 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ể sử dụng công cụ này để trích xuất các tệp lưu trữ có chứa tên tệp không phải Unicode hoặc có tệp sẽ trích xuất sang cùng một đường dẫn trong hệ thống tệp không phân biệt chữ hoa chữ thường. |
tệp
None
repository_ctx.file(path, content='', executable=True, legacy_utf8=True)
Thông số
Thông số | Mô tả |
---|---|
path
|
string; hoặc Label; hoặc path;
đường dẫn bắt buộc của tệp cần tạo, liên quan đến thư mục kho lưu trữ. |
content
|
mặc định là '' nội dung của tệp cần tạo, trống theo mặc định. |
executable
|
mặc định là True đặt cờ thực thi trên tệp được tạo, true theo mặc định. |
legacy_utf8
|
mặc định là True mã hoá nội dung tệp thành UTF-8, đúng theo mặc định. Các phiên bản trong tương lai sẽ thay đổi giá trị mặc định và xoá tham số này. |
tên
string repository_ctx.name
hệ điều hành
repository_os repository_ctx.os
bản vá
None
repository_ctx.patch(patch_file, strip=0)
Thông 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à một đường dẫn tương đối, thì đường dẫn này sẽ được phân giải thành thư mục kho lưu trữ. |
strip
|
mặc định là 0 xoá số thành phần đầu tiên được chỉ định khỏi tên tệp. |
đường dẫn
path repository_ctx.path(path)
Thông số
Thông số | Mô tả |
---|---|
path
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc chuỗi, nhãn hoặc đường dẫn để tạo đường dẫn từ đó |
đọc
string repository_ctx.read(path)
Thông 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. |
report_progress
None
repository_ctx.report_progress(status='')
Thông số
Thông số | Mô tả |
---|---|
status
|
chuỗi; giá trị mặc định là chuỗi '' 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)
Thông 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
|
chuỗi; hoặc Nhãn; hoặc đường dẫn;
bắt buộc Đường dẫn của đường liên kết tượng trưng cần tạo, tương ứng với thư mục kho lưu trữ. |
ManualContentEmbargoesScheduleTemplate.xlsx
None
repository_ctx.template(path, template, substitutions={}, executable=True)
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.
Thông số
Thông số | Mô tả |
---|---|
path
|
string; hoặc Label; hoặc path;
đường dẫn bắt buộc của tệp cần tạo, liên quan đến 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
|
mặc định là {} các giá trị thay thế cần thực hiện khi mở rộng mẫu. |
executable
|
mặc định là True đặt cờ thực thi trên tệp đã tạo, đúng theo mặc định. |
thiết bị nào
path repository_ctx.which(program)
Thông số
Thông số | Mô tả |
---|---|
program
|
bắt buộc Chương trình cần tìm trong đường dẫn. |
None
.
workspace_root
path repository_ctx.workspace_root