Aşağıdaki işlevler @bazel_tools//tools/build_defs/repo:git.bzl
üzerinden yüklenebilir.
git_repository
git_repository(name, branch, build_file, build_file_content, commit, init_submodules, patch_args, patch_cmds, patch_cmds_win, patch_tool, patches, recursive_init_submodules, remote, shallow_since, strip_prefix, tag, verbose, workspace_file, workspace_file_content)
Harici bir Git deposunu klonlayın.
Bir Git deposunu klonlar, belirtilen etiketi kontrol eder veya kaydeder ve hedeflerini bağlama için kullanılabilir hale getirir. Ayrıca, gerçekten kontrol edilen kaydetmenin kimliğini ve tarihini belirleyin ve bu kuralın tekrarlanabilir bir sürümünü sağlayan parametrelerle (bir etiket her zaman mümkün olmayabilir) bir dikte döndürür.
Bazel önce yalnızca belirtilen taahhüt için sığ getirme işlemi gerçekleştirmeye çalışır. Bu işlem başarısız olursa (genellikle sunucu desteğinin eksik olması nedeniyle) depoyu tam olarak getirir.
Özellikler
name |
Ad; zorunlu
Bu kod deposu için benzersiz bir ad. |
branch |
Dize; isteğe bağlı
uzak depodaki dal. branch, tag veya commit özelliklerinden biri belirtilmelidir. |
build_file |
Etiket; isteğe bağlı
Bu kod deposu için BUILD dosyası olarak kullanılacak dosya.Bu özellik mutlak bir etikettir (ana depo için "@//" kullanın). Dosyanın BUILD olarak adlandırılmasına gerek yoktur, ancak şöyle olabilir: (BUILD.new-repo-name gibi bir ad, onu deponun gerçek BUILD dosyalarından ayırt etmek için işe yarayabilir. Build_file veya build_file_content değeri belirtilmelidir. |
build_file_content |
Dize; isteğe bağlı
Bu deponun BUILD dosyasının içeriği. build_file veya build_file_content belirtilmelidir. |
commit |
Dize; isteğe bağlı
belirli bir commit'i kontrol etmeyi seçebilirsiniz. branch, tag veya commit özelliklerinden biri belirtilmelidir. |
init_submodules |
Boole; isteğe bağlı
Depodaki alt modüllerin klonlanıp klonlanmayacağı. |
patch_args |
Dize listesi; isteğe bağlı
Yama aracına verilen bağımsız değişkenler. Varsayılan olarak -p0 değerine ayarlanır ancak git tarafından oluşturulan yamalar için genellikle -p1 değeri gerekir. Birden fazla -p bağımsız değişkeni belirtilirse son bağımsız değişken geçerli olur. -p dışındaki bağımsız değişkenler belirtilirse Bazel, Bazel'da yerel yama uygulaması yerine yama komut satırı aracını kullanmak için yedeklenir. Yama komut satırı aracına geri dönülürken ve patch_tool özelliği belirtilmediyse "patch" kullanılır. |
patch_cmds |
Dize listesi; isteğe bağlı
Yamalar uygulandıktan sonra Linux/Macos'ta uygulanacak Bash komutları dizisi. |
patch_cmds_win |
Dize listesi; isteğe bağlı
Yamalar uygulandıktan sonra Windows'da uygulanacak Powershell komutları dizisi. Bu özellik ayarlanmazsa patch_cmds Windows'ta yürütülür. Bunun için Bash ikilisinin mevcut olması gerekir. |
patch_tool |
Dize; isteğe bağlı
Kullanılacak yama(1) yardımcı programı. Bu belirtilirse Bazel, Bazel'de yerel yama uygulaması yerine belirtilen yama aracını kullanır. |
patches |
Etiket listesi; isteğe bağlı
Arşiv çıkarıldıktan sonra yama olarak uygulanacak dosyaların listesi. Varsayılan olarak, fuzz eşleme ve ikili yamayı desteklemeyen Bazel'da yerel yama uygulamasını kullanır. Ancak "yama_aracı" özelliği belirtilirse veya "patch_args" özelliğinde "-p" dışında bağımsız değişkenler varsa Bazel, yama komut satırı aracını kullanmaya devam eder. |
recursive_init_submodules |
Boole; isteğe bağlı
Alt modüllerin depoda yinelemeli olarak klonlanıp klonlanmayacağı. |
remote |
Dize; zorunlu
Uzak Git deposunun URI'si |
shallow_since |
Dize; isteğe bağlı
Belirtilen commit'ten sonra olmayan isteğe bağlı bir tarih; bir etiket veya dal belirtilirse bağımsız değişkene izin verilmez (bu, --depth=1 ile her zaman klonlanabilir). Sunucu, rastgele taahhütlerin sığ getirmelerini desteklemese bile, belirtilen taahhütlere yakın bir tarih ayarlamak, deponun sığ bir kopyasını oluşturmanıza olanak tanıyabilir. git'in --shallow-since uygulamasındaki hatalar nedeniyle, getirme hatalarına neden olabileceği için bu özelliğin kullanılması önerilmez. |
strip_prefix |
Dize; isteğe bağlı
Ayıklanan dosyalardan alınacak dizin ön eki. |
tag |
Dize; isteğe bağlı
etiketine ekleyerek kontrol edebilirsiniz. Dal, etiket veya kaydetmeden tam olarak biri belirtilmelidir. |
verbose |
Boole; isteğe bağlı |
workspace_file |
Etiket; isteğe bağlı
Bu deponun "WORKSPACE" dosyası olarak kullanılacak dosya. "workspace_file" veya "workspace_file_content"den biri belirtilebilir ya da ikisi birden belirtilemez. |
workspace_file_content |
Dize; isteğe bağlı
Bu deponun WORKSPACE dosyasının içeriği. "workspace_file" veya "workspace_file_content"den biri belirtilebilir ya da ikisi birden belirtilemez. |
new_git_repository
new_git_repository(name, branch, build_file, build_file_content, commit, init_submodules, patch_args, patch_cmds, patch_cmds_win, patch_tool, patches, recursive_init_submodules, remote, shallow_since, strip_prefix, tag, verbose, workspace_file, workspace_file_content)
Harici git deposunu klonlama.
Bir Git deposunu klonlar, belirtilen etiketi kontrol eder veya kaydeder ve hedeflerini bağlama için kullanılabilir hale getirir. Ayrıca, gerçekten kontrol edilen kaydetmenin kimliğini ve tarihini belirleyin ve bu kuralın tekrarlanabilir bir sürümünü sağlayan parametrelerle (bir etiket her zaman mümkün olmayabilir) bir dikte döndürür.
Bazel önce yalnızca belirtilen taahhüt için sığ getirme işlemi gerçekleştirmeye çalışır. Bu işlem başarısız olursa (genellikle sunucu desteğinin eksik olması nedeniyle) depoyu tam olarak getirir.
Özellikler
name |
Ad; zorunlu
Bu kod deposu için benzersiz bir ad. |
branch |
Dize; isteğe bağlı
uzak depodaki dal. Dal, etiket veya kaydetmeden tam olarak biri belirtilmelidir. |
build_file |
Etiket; isteğe bağlı
Bu depolar için BUILD dosyası olarak kullanılacak dosya. Bu özellik mutlak bir etikettir (ana depo için "@//" kullanın). Dosyanın BUILD olarak adlandırılmasına gerek yoktur, ancak şöyle olabilir: (BUILD.new-repo-name gibi bir ad, onu deponun gerçek BUILD dosyalarından ayırt etmek için işe yarayabilir. build_file veya build_file_content belirtilmelidir. |
build_file_content |
Dize; isteğe bağlı
Bu deponun BUILD dosyasının içeriği. build_file veya build_file_content belirtilmelidir. |
commit |
Dize; isteğe bağlı
belirli bir commit'i kontrol etmeyi seçebilirsiniz. branch, tag veya commit özelliklerinden biri belirtilmelidir. |
init_submodules |
Boole; isteğe bağlı
Depodaki alt modüllerin klonlanıp klonlanmayacağı. |
patch_args |
Dize listesi; isteğe bağlı
Yama aracına verilen bağımsız değişkenler. Varsayılan olarak -p0 değerine ayarlanır ancak git tarafından oluşturulan yamalar için genellikle -p1 değeri gerekir. Birden fazla -p bağımsız değişkeni belirtilirse son bağımsız değişken geçerli olur. -p dışındaki bağımsız değişkenler belirtilirse Bazel, Bazel'da yerel yama uygulaması yerine yama komut satırı aracını kullanmak için yedeklenir. Yama komut satırı aracına geri dönülürken ve patch_tool özelliği belirtilmediyse "patch" kullanılır. |
patch_cmds |
Dize listesi; isteğe bağlı
Yamalar uygulandıktan sonra Linux/Macos'ta uygulanacak Bash komutları dizisi. |
patch_cmds_win |
Dize listesi; isteğe bağlı
Yamalar uygulandıktan sonra Windows'da uygulanacak Powershell komutları dizisi. Bu özellik ayarlanmazsa patch_cmds Windows'ta yürütülür. Bunun için Bash ikilisinin mevcut olması gerekir. |
patch_tool |
Dize; isteğe bağlı
Kullanılacak yamalı(1) yardımcı program. Bu belirtilirse Bazel, Bazel'e özgü yamalı uygulama yerine belirtilen yamalı araç kullanır. |
patches |
Etiket listesi; isteğe bağlı
Arşiv ayıklandıktan sonra yama olarak uygulanacak dosyaların listesi. Varsayılan olarak, fuzz eşleme ve ikili yamayı desteklemeyen Bazel'da yerel yama uygulamasını kullanır. Ancak "yama_aracı" özelliği belirtilirse veya "patch_args" özelliğinde "-p" dışında bağımsız değişkenler varsa Bazel, yama komut satırı aracını kullanmaya devam eder. |
recursive_init_submodules |
Boole; isteğe bağlı
Alt modüllerin depoda yinelemeli olarak klonlanıp klonlanmayacağı. |
remote |
Dize; zorunlu
Uzak Git deposunun URI'si |
shallow_since |
Dize; isteğe bağlı
Belirtilen commit'ten sonra olmayan isteğe bağlı bir tarih; bir etiket veya dal belirtilirse bağımsız değişkene izin verilmez (bu, --depth=1 ile her zaman klonlanabilir). Sunucu, rastgele taahhütlerin sığ getirmelerini desteklemese bile, belirtilen taahhütlere yakın bir tarih ayarlamak, deponun sığ bir kopyasını oluşturmanıza olanak tanıyabilir. git'in --shallow-since uygulamasındaki hatalar nedeniyle, getirme hatalarına neden olabileceği için bu özelliğin kullanılması önerilmez. |
strip_prefix |
Dize; isteğe bağlı
Ayıklanan dosyalardan alınacak dizin ön eki. |
tag |
Dize; isteğe bağlı
etiketine ekleyerek kontrol edebilirsiniz. Dal, etiket veya kaydetmeden tam olarak biri belirtilmelidir. |
verbose |
Boole; isteğe bağlı |
workspace_file |
Etiket; isteğe bağlı
Bu deponun "WORKSPACE" dosyası olarak kullanılacak dosya. "workspace_file" veya "workspace_file_content"den biri belirtilebilir ya da ikisi birden belirtilemez. |
workspace_file_content |
Dize; isteğe bağlı
Bu deponun WORKSPACE dosyasının içeriği. "workspace_file" veya "workspace_file_content" belirtilebilir. İkisi birden belirtilemez. |