유틸리티 저장소 규칙

문제 신고 소스 보기 1박 · 7.2 · 7.1 · 7.0 · 6.5 · 6.4

다음 함수가 @bazel_tools//tools/build_defs/repo:utils.bzl

가져온 후에는 외부 저장소를 조작하는 유틸리티입니다.

설정

이러한 유틸리티는 다른 저장소 규칙에서 사용하기 위한 것입니다. 그들은 다음과 같이 로드할 수 있습니다.

load(
    "@bazel_tools//tools/build_defs/repo:utils.bzl",
    "workspace_and_buildfile",
    "patch",
    "update_attrs",
)

download_remote_files

download_remote_files(ctx, auth)

원격 파일을 다운로드하기 위한 유틸리티 기능입니다.

이 규칙은 생성할 수 있습니다 매개변수 remote_file_urlsremote_file_integrityctx.attr에 있어야 합니다.

매개변수

ctx 점을 기억하실 것입니다 여기에는

이 유틸리티를 호출하는 저장소 규칙의 저장소 컨텍스트 함수를 사용하세요.

auth 선택사항. 기본값은 None입니다.

일부 URL에 대한 인증 정보를 지정하는 선택적 사전입니다.

get_auth

get_auth(ctx, urls)

.netrc 파일에서 URL 목록에 대한 올바른 인증 사전을 가져오는 유틸리티 함수입니다.

가능한 경우 선택적 netrc 및 auth_patterns 속성을 지원합니다.

매개변수

ctx 점을 기억하실 것입니다 여기에는

이 유틸리티를 호출하는 저장소 규칙의 저장소 컨텍스트 함수를 사용하세요.

urls 점을 기억하실 것입니다 여기에는

읽을 URL 목록

반환 값

저장소_ctx.download에 전달할 수 있는 인증 사전

미정

maybe(repo_rule, name, kwargs)

저장소가 아직 없는 경우에만 추가하는 유틸리티 함수입니다.

이는 https://bazel.build/rules/deploying#dependencies.

매개변수

repo_rule 점을 기억하실 것입니다 여기에는

저장소 규칙 함수입니다.

name 점을 기억하실 것입니다 여기에는

만들 저장소의 이름입니다.

kwargs 선택사항.

나머지 인수는 repo_rule 함수에 전달됩니다.

반환 값

없습니다. 필요할 때 저장소를 부작용으로 정의합니다.

parse_netrc

parse_netrc(contents, filename)

최소 기본 .netrc 파일을 파싱하는 유틸리티 함수입니다.

매개변수

contents 점을 기억하실 것입니다 여기에는

파서의 입력을 생성합니다.

filename 선택사항. 기본값은 None입니다.

오류 메시지에 사용할 파일 이름입니다(있는 경우).

반환 값

제공된 정보를 사용하여 머신 이름을 dict에 매핑하는 dict 정보

patch

patch(ctx, patches, patch_cmds, patch_cmds_win, patch_tool, patch_args, auth)

이미 추출된 저장소에 패치를 적용합니다.

이 규칙은 생성할 수 있습니다 매개변수가 patches, patch_tool인 경우 patch_args, patch_cmds, patch_cmds_win가 지정되지 않음 ctx.attr에서 가져온 것입니다.

매개변수

ctx 점을 기억하실 것입니다 여기에는

이 유틸리티를 호출하는 저장소 규칙의 저장소 컨텍스트 함수를 사용하세요.

patches 선택사항. 기본값은 None입니다.

적용할 패치 파일입니다. 문자열, 라벨 또는 경로의 목록입니다.

patch_cmds 선택사항. 기본값은 None입니다.

패치를 위해 실행되는 Bash 명령어는 bash -c에 대한 시간 문자열 목록

patch_cmds_win 선택사항. 기본값은 None입니다.

패치를 위해 실행되는 PowerShell 명령어, 전달됨 한 번에 하나씩 Powershell /c에 연결합니다. 문자열 목록. 만약 이 매개변수의 부울 값이 false이면 patch_cmds는 이 매개변수는 무시됩니다.

patch_tool 선택사항. 기본값은 None입니다.

적용을 위해 실행할 패치 도구의 경로 패치를 제공합니다 문자열.

patch_args 선택사항. 기본값은 None입니다.

패치 도구에 전달할 인수입니다. 문자열 목록.

auth 선택사항. 기본값은 None입니다.

일부 URL에 대한 인증 정보를 지정하는 선택적 사전입니다.

read_netrc

read_netrc(ctx, filename)

최소 기본 .netrc 파일을 파싱하는 유틸리티 함수입니다.

매개변수

ctx 점을 기억하실 것입니다 여기에는

이 유틸리티를 호출하는 저장소 규칙의 저장소 컨텍스트 함수를 사용하세요.

filename 점을 기억하실 것입니다 여기에는

읽을 .netrc 파일의 이름

반환 값

제공된 정보를 사용하여 머신 이름을 dict에 매핑하는 dict 정보

read_user_netrc

read_user_netrc(ctx)

사용자의 기본 netrc 파일을 읽습니다.

매개변수

ctx 점을 기억하실 것입니다 여기에는

이 유틸리티 함수를 호출하는 저장소 규칙의 저장소 컨텍스트입니다.

반환 값

제공된 정보를 사용하여 머신 이름을 dict에 매핑하는 dict.

update_attrs

update_attrs(orig, keys, override)

지정된 속성을 변경하고 특정 저장소 규칙 호출에 추가하는 유틸리티 함수입니다.

규칙을 재현 가능하게 만드는 데 사용됩니다.

매개변수

orig 점을 기억하실 것입니다 여기에는

실제로 설정된 속성의 사전 (명시적 또는 암시적) 특정 규칙 호출로

keys 점을 기억하실 것입니다 여기에는

이 규칙에 정의된 전체 속성 집합

override 점을 기억하실 것입니다 여기에는

원본을 재정의하거나 추가할 속성

반환 값

재정의 삽입/업데이트의 키가 포함된 속성 사전

use_netrc

use_netrc(netrc, urls, patterns)

파싱된 netrc 파일과 URL 목록에서 인증 dict를 계산합니다.

매개변수

netrc 점을 기억하실 것입니다 여기에는

사전으로 파싱된 netrc 파일(예: read_netrc

urls 점을 기억하실 것입니다 여기에는

URL 목록입니다.

patterns 점을 기억하실 것입니다 여기에는

승인 패턴에 대한 URL 사전(선택사항)

반환 값

ctx.download의 인증 인수로 적합한 dict; 더 정확히 말하면 netrc 파일이 로그인 및 비밀번호를 제공하는 모든 URL을 해당 로그인, 비밀번호 및 선택적 인증 패턴을 포함하는 dict 'type' 매핑도 '기본'으로 변경 또는 '패턴'입니다.

workspace_and_buildfile

workspace_and_buildfile(ctx)

WORKSPACE와 BUILD 파일(요청된 경우)을 작성하기 위한 유틸리티 함수입니다.

이 규칙은 저장소 규칙을 따릅니다. 여기서는 매개변수 name, build_file, build_file_content, workspace_file, workspace_file_content 남음 ctx.attr에 있음 나머지 4개는 값이 None으로 지정될 수 있습니다.

매개변수

ctx 점을 기억하실 것입니다 여기에는

이 유틸리티를 호출하는 저장소 규칙의 저장소 컨텍스트 함수를 사용하세요.