fix(typos): Fix almost all typos with hook (#884)

* Fix almost all typos with hook

* align docs
This commit is contained in:
Markus Hofbauer 2024-07-31 16:09:17 +02:00 committed by GitHub
parent 424137f6fc
commit cdbfe4190c
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
25 changed files with 41 additions and 39 deletions

View File

@ -3,7 +3,7 @@
build --keep_going
# Output test errors to stderr so users don't have to `cat` or open test failure log files when test
# fail. This makes the log noiser in exchange for reducing the time-to-feedback on test failures for
# fail. This makes the log noisier in exchange for reducing the time-to-feedback on test failures for
# users.
# Docs: https://bazel.build/docs/user-manual#test-output
test --test_output=errors

2
.gitattributes vendored
View File

@ -9,7 +9,7 @@ docs/*.md linguist-generated=true
lib/tests export-ignore
# Omit the .bazeliskrc file for the smoke test that runs on the Bazel Central
# Regsitry ci because we test on Windows but do not publish Aspect CLI Windows
# Registry ci because we test on Windows but do not publish Aspect CLI Windows
# binaries.
e2e/smoke/.bazeliskrc export-ignore

View File

@ -42,8 +42,8 @@ repos:
- id: typos
exclude: |
(?x)^(
docs/|
lib/
lib/private/yq_toolchain.bzl|
lib/tests/glob_match_test.bzl
)
- repo: local
hooks:

2
.typos.toml Normal file
View File

@ -0,0 +1,2 @@
[default.extend-identifiers]
MODULEs = "MODULEs" # Else it becomes MODULEEs

2
docs/docs.md generated
View File

@ -12,7 +12,7 @@ stardoc_with_diff_test(<a href="#stardoc_with_diff_test-name">name</a>, <a href=
Creates a stardoc target that can be auto-detected by update_docs to write the generated doc to the source tree and test that it's up to date.
This is helpful for minimizing boilerplate in repos wih lots of stardoc targets.
This is helpful for minimizing boilerplate in repos with lots of stardoc targets.
**PARAMETERS**

View File

@ -33,7 +33,7 @@ such as `$(BINDIR)`, `$(TARGET_CPU)`, and `$(COMPILATION_MODE)` as documented in
| <a id="expand_template_rule-is_executable"></a>is_executable | Whether to mark the output file as executable. | Boolean | optional | <code>False</code> |
| <a id="expand_template_rule-out"></a>out | Where to write the expanded file.<br><br> If the <code>template</code> is a source file, then <code>out</code> defaults to be named the same as the template file and outputted to the same workspace-relative path. In this case there will be no pre-declared label for the output file. It can be referenced by the target label instead. This pattern is similar to <code>copy_to_bin</code> but with substitutions on the copy.<br><br> Otherwise, <code>out</code> defaults to <code>[name].txt</code>. | <a href="https://bazel.build/concepts/labels">Label</a> | optional | |
| <a id="expand_template_rule-stamp"></a>stamp | Whether to encode build information into the output. Possible values:<br><br> - <code>stamp = 1</code>: Always stamp the build information into the output, even in [--nostamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) builds. This setting should be avoided, since it is non-deterministic. It potentially causes remote cache misses for the target and any downstream actions that depend on the result. - <code>stamp = 0</code>: Never stamp, instead replace build information by constant values. This gives good build result caching. - <code>stamp = -1</code>: Embedding of build information is controlled by the [--[no]stamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) flag. Stamped targets are not rebuilt unless their dependencies change. | Integer | optional | <code>-1</code> |
| <a id="expand_template_rule-stamp_substitutions"></a>stamp_substitutions | Mapping of strings to substitutions.<br><br> There are overlayed on top of substitutions when stamping is enabled for the target.<br><br> Substitutions can contain $(execpath :target) and $(rootpath :target) expansions, $(MAKEVAR) expansions and {{STAMP_VAR}} expansions when stamping is enabled for the target. | <a href="https://bazel.build/rules/lib/dict">Dictionary: String -> String</a> | optional | <code>{}</code> |
| <a id="expand_template_rule-stamp_substitutions"></a>stamp_substitutions | Mapping of strings to substitutions.<br><br> There are overlaid on top of substitutions when stamping is enabled for the target.<br><br> Substitutions can contain $(execpath :target) and $(rootpath :target) expansions, $(MAKEVAR) expansions and {{STAMP_VAR}} expansions when stamping is enabled for the target. | <a href="https://bazel.build/rules/lib/dict">Dictionary: String -> String</a> | optional | <code>{}</code> |
| <a id="expand_template_rule-substitutions"></a>substitutions | Mapping of strings to substitutions.<br><br> Substitutions can contain $(execpath :target) and $(rootpath :target) expansions, $(MAKEVAR) expansions and {{STAMP_VAR}} expansions when stamping is enabled for the target. | <a href="https://bazel.build/rules/lib/dict">Dictionary: String -> String</a> | optional | <code>{}</code> |
| <a id="expand_template_rule-template"></a>template | The template file to expand. | <a href="https://bazel.build/concepts/labels">Label</a> | required | |

4
docs/glob_match.md generated
View File

@ -41,7 +41,7 @@ True if the path matches the glob expression
is_glob(<a href="#is_glob-expr">expr</a>)
</pre>
Determine if the passed string is a globa expression
Determine if the passed string is a global expression
**PARAMETERS**
@ -52,6 +52,6 @@ Determine if the passed string is a globa expression
**RETURNS**
True if the passed string is a globa expression
True if the passed string is a global expression

2
docs/lists.md generated
View File

@ -67,7 +67,7 @@ find(<a href="#find-f">f</a>, <a href="#find-arr">arr</a>)
Find a particular item from list `arr` by a given function `f`.
Unlike `pick`, the `find` method returns a tuple of the index and the value of first item passing by `f`.
Furhermore `find` does not fail if no item passes `f`.
Furthermore `find` does not fail if no item passes `f`.
In this case `(-1, None)` is returned.

2
docs/params_file.md generated
View File

@ -25,7 +25,7 @@ Handles variable substitutions for args.
| :------------- | :------------- | :------------- |
| <a id="params_file-name"></a>name | Name of the rule. | none |
| <a id="params_file-out"></a>out | Path of the output file, relative to this package. | none |
| <a id="params_file-args"></a>args | Arguments to concatenate into a params file.<br><br>- Subject to 'Make variable' substitution. See https://docs.bazel.build/versions/main/be/make-variables.html.<br><br>- Subject to predefined source/output path variables substitutions.<br><br> The predefined variables <code>execpath</code>, <code>execpaths</code>, <code>rootpath</code>, <code>rootpaths</code>, <code>location</code>, and <code>locations</code> take label parameters (e.g. <code>$(execpath //foo:bar)</code>) and substitute the file paths denoted by that label.<br><br> See https://docs.bazel.build/versions/main/be/make-variables.html#predefined_label_variables for more info.<br><br> NB: This $(location) substition returns the manifest file path which differs from the <code>*_binary</code> & <code>*_test</code> args and genrule bazel substitions. This will be fixed in a future major release. See docs string of <code>expand_location_into_runfiles</code> macro in <code>internal/common/expand_into_runfiles.bzl</code> for more info.<br><br>- Subject to predefined variables & custom variable substitutions.<br><br> Predefined "Make" variables such as <code>$(COMPILATION_MODE)</code> and <code>$(TARGET_CPU)</code> are expanded. See https://docs.bazel.build/versions/main/be/make-variables.html#predefined_variables.<br><br> Custom variables are also expanded including variables set through the Bazel CLI with <code>--define=SOME_VAR=SOME_VALUE</code>. See https://docs.bazel.build/versions/main/be/make-variables.html#custom_variables.<br><br> Predefined genrule variables are not supported in this context. | <code>[]</code> |
| <a id="params_file-args"></a>args | Arguments to concatenate into a params file.<br><br>- Subject to 'Make variable' substitution. See https://docs.bazel.build/versions/main/be/make-variables.html.<br><br>- Subject to predefined source/output path variables substitutions.<br><br> The predefined variables <code>execpath</code>, <code>execpaths</code>, <code>rootpath</code>, <code>rootpaths</code>, <code>location</code>, and <code>locations</code> take label parameters (e.g. <code>$(execpath //foo:bar)</code>) and substitute the file paths denoted by that label.<br><br> See https://docs.bazel.build/versions/main/be/make-variables.html#predefined_label_variables for more info.<br><br> NB: This $(location) substitution returns the manifest file path which differs from the <code>*_binary</code> & <code>*_test</code> args and genrule bazel substitutions. This will be fixed in a future major release. See docs string of <code>expand_location_into_runfiles</code> macro in <code>internal/common/expand_into_runfiles.bzl</code> for more info.<br><br>- Subject to predefined variables & custom variable substitutions.<br><br> Predefined "Make" variables such as <code>$(COMPILATION_MODE)</code> and <code>$(TARGET_CPU)</code> are expanded. See https://docs.bazel.build/versions/main/be/make-variables.html#predefined_variables.<br><br> Custom variables are also expanded including variables set through the Bazel CLI with <code>--define=SOME_VAR=SOME_VALUE</code>. See https://docs.bazel.build/versions/main/be/make-variables.html#custom_variables.<br><br> Predefined genrule variables are not supported in this context. | <code>[]</code> |
| <a id="params_file-data"></a>data | Data for <code>$(location)</code> expansions in args. | <code>[]</code> |
| <a id="params_file-newline"></a>newline | Line endings to use. One of [<code>"auto"</code>, <code>"unix"</code>, <code>"windows"</code>].<br><br>- <code>"auto"</code> for platform-determined - <code>"unix"</code> for LF - <code>"windows"</code> for CRLF | <code>"auto"</code> |
| <a id="params_file-kwargs"></a>kwargs | undocumented named arguments | none |

4
docs/strings.md generated
View File

@ -36,7 +36,7 @@ unicode string of the position
hex(<a href="#hex-number">number</a>)
</pre>
Format integer to hexdecimal representation
Format integer to hexadecimal representation
**PARAMETERS**
@ -47,7 +47,7 @@ Format integer to hexdecimal representation
**RETURNS**
hexdecimal representation of the number argument
hexadecimal representation of the number argument
<a id="ord"></a>

12
docs/utils.md generated
View File

@ -303,7 +303,7 @@ Path to the workspace root
propagate_common_binary_rule_attributes(<a href="#propagate_common_binary_rule_attributes-attrs">attrs</a>)
</pre>
Returns a dict of rule parameters filtered from the input dict that only contains the onces that are common to all binary rules
Returns a dict of rule parameters filtered from the input dict that only contains the ones that are common to all binary rules
These are listed in Bazel's documentation:
https://bazel.build/reference/be/common-definitions#common-attributes
@ -330,7 +330,7 @@ The dict of parameters, containing only common binary attributes
propagate_common_rule_attributes(<a href="#propagate_common_rule_attributes-attrs">attrs</a>)
</pre>
Returns a dict of rule parameters filtered from the input dict that only contains the onces that are common to all rules
Returns a dict of rule parameters filtered from the input dict that only contains the ones that are common to all rules
These are listed in Bazel's documentation:
https://bazel.build/reference/be/common-definitions#common-attributes
@ -356,7 +356,7 @@ The dict of parameters, containing only common attributes
propagate_common_test_rule_attributes(<a href="#propagate_common_test_rule_attributes-attrs">attrs</a>)
</pre>
Returns a dict of rule parameters filtered from the input dict that only contains the onces that are common to all test rules
Returns a dict of rule parameters filtered from the input dict that only contains the ones that are common to all test rules
These are listed in Bazel's documentation:
https://bazel.build/reference/be/common-definitions#common-attributes
@ -720,7 +720,7 @@ List of tags that only contains the well known set
utils.propagate_common_rule_attributes(<a href="#utils.propagate_common_rule_attributes-attrs">attrs</a>)
</pre>
Returns a dict of rule parameters filtered from the input dict that only contains the onces that are common to all rules
Returns a dict of rule parameters filtered from the input dict that only contains the ones that are common to all rules
These are listed in Bazel's documentation:
https://bazel.build/reference/be/common-definitions#common-attributes
@ -746,7 +746,7 @@ The dict of parameters, containing only common attributes
utils.propagate_common_test_rule_attributes(<a href="#utils.propagate_common_test_rule_attributes-attrs">attrs</a>)
</pre>
Returns a dict of rule parameters filtered from the input dict that only contains the onces that are common to all test rules
Returns a dict of rule parameters filtered from the input dict that only contains the ones that are common to all test rules
These are listed in Bazel's documentation:
https://bazel.build/reference/be/common-definitions#common-attributes
@ -773,7 +773,7 @@ The dict of parameters, containing only common test attributes
utils.propagate_common_binary_rule_attributes(<a href="#utils.propagate_common_binary_rule_attributes-attrs">attrs</a>)
</pre>
Returns a dict of rule parameters filtered from the input dict that only contains the onces that are common to all binary rules
Returns a dict of rule parameters filtered from the input dict that only contains the ones that are common to all binary rules
These are listed in Bazel's documentation:
https://bazel.build/reference/be/common-definitions#common-attributes

2
docs/yq.md generated
View File

@ -113,7 +113,7 @@ yq is capable of parsing and outputting to other formats. See their [docs](https
| <a id="yq-srcs"></a>srcs | List of input file labels | none |
| <a id="yq-expression"></a>expression | yq expression (https://mikefarah.gitbook.io/yq/commands/evaluate). Defaults to the identity expression ".". Subject to stamp variable replacements, see [Stamping](./stamping.md). When stamping is enabled, an environment variable named "STAMP" will be available in the expression.<br><br>Be careful to write the filter so that it handles unstamped builds, as in the example above. | <code>"."</code> |
| <a id="yq-args"></a>args | Additional args to pass to yq. Note that you do not need to pass _eval_ or _eval-all_ as this is handled automatically based on the number <code>srcs</code>. Passing the output format or the parse format is optional as these can be guessed based on the file extensions in <code>srcs</code> and <code>outs</code>. | <code>[]</code> |
| <a id="yq-outs"></a>outs | Name of the output files. Defaults to a single output with the name plus a ".yaml" extension, or the extension corresponding to a passed output argment (e.g., "-o=json"). For split operations you must declare all outputs as the name of the output files depends on the expression. | <code>None</code> |
| <a id="yq-outs"></a>outs | Name of the output files. Defaults to a single output with the name plus a ".yaml" extension, or the extension corresponding to a passed output argument (e.g., "-o=json"). For split operations you must declare all outputs as the name of the output files depends on the expression. | <code>None</code> |
| <a id="yq-kwargs"></a>kwargs | Other common named parameters such as <code>tags</code> or <code>visibility</code> | none |

View File

@ -27,8 +27,8 @@ def params_file(
See https://docs.bazel.build/versions/main/be/make-variables.html#predefined_label_variables for more info.
NB: This $(location) substition returns the manifest file path which differs from the `*_binary` & `*_test`
args and genrule bazel substitions. This will be fixed in a future major release.
NB: This $(location) substitution returns the manifest file path which differs from the `*_binary` & `*_test`
args and genrule bazel substitutions. This will be fixed in a future major release.
See docs string of `expand_location_into_runfiles` macro in `internal/common/expand_into_runfiles.bzl`
for more info.

View File

@ -9,7 +9,7 @@ def stardoc_with_diff_test(
**kwargs):
"""Creates a stardoc target that can be auto-detected by update_docs to write the generated doc to the source tree and test that it's up to date.
This is helpful for minimizing boilerplate in repos wih lots of stardoc targets.
This is helpful for minimizing boilerplate in repos with lots of stardoc targets.
Args:
name: the name of the stardoc file to be written to the current source directory (.md will be appended to the name). Call bazel run on this target to update the file.

View File

@ -104,7 +104,7 @@ such as `$(BINDIR)`, `$(TARGET_CPU)`, and `$(COMPILATION_MODE)` as documented in
"stamp_substitutions": attr.string_dict(
doc = """Mapping of strings to substitutions.
There are overlayed on top of substitutions when stamping is enabled
There are overlaid on top of substitutions when stamping is enabled
for the target.
Substitutions can contain $(execpath :target) and $(rootpath :target)

View File

@ -17,20 +17,20 @@ def _validate_glob(expr):
for i in range(expr_len):
if expr[i] == "*" and i < expr_len - 1 and expr[i + 1] == "*":
if i > 0 and expr[i - 1] != "/":
msg = "glob_match: `**` globstar in expression `{}` must be at the start of the expression or preceeded by `/`".format(expr)
msg = "glob_match: `**` globstar in expression `{}` must be at the start of the expression or preceded by `/`".format(expr)
fail(msg)
if i < expr_len - 2 and expr[i + 2] != "/":
msg = "glob_match: `**` globstar in expression `{}` must be at the end of the expression or followed by `/`".format(expr)
fail(msg)
def is_glob(expr):
"""Determine if the passed string is a globa expression
"""Determine if the passed string is a global expression
Args:
expr: the potential glob expression
Returns:
True if the passed string is a globa expression
True if the passed string is a global expression
"""
return expr.find("*") != -1 or expr.find("?") != -1
@ -169,7 +169,7 @@ def glob_match(expr, path, match_path_separator = False):
super_continue = True
break
# Succesfully consumed a path segment
# Successfully consumed a path segment
if super_continue:
continue

View File

@ -38,7 +38,7 @@ def find(f, arr):
"""Find a particular item from list `arr` by a given function `f`.
Unlike `pick`, the `find` method returns a tuple of the index and the value of first item passing by `f`.
Furhermore `find` does not fail if no item passes `f`.
Furthermore `find` does not fail if no item passes `f`.
In this case `(-1, None)` is returned.
Args:

View File

@ -559,13 +559,13 @@ def _to_char(n):
return alpha[n]
def hex(number):
"""Format integer to hexdecimal representation
"""Format integer to hexadecimal representation
Args:
number: number to format
Returns:
hexdecimal representation of the number argument
hexadecimal representation of the number argument
"""
hex_string = ""

View File

@ -312,7 +312,7 @@ _COMMON_BINARY_RULE_ATTRIBUTES = _COMMON_RULE_ATTRIBUTES + [
]
def _propagate_common_rule_attributes(attrs):
"""Returns a dict of rule parameters filtered from the input dict that only contains the onces that are common to all rules
"""Returns a dict of rule parameters filtered from the input dict that only contains the ones that are common to all rules
These are listed in Bazel's documentation:
https://bazel.build/reference/be/common-definitions#common-attributes
@ -331,7 +331,7 @@ def _propagate_common_rule_attributes(attrs):
}
def _propagate_common_test_rule_attributes(attrs):
"""Returns a dict of rule parameters filtered from the input dict that only contains the onces that are common to all test rules
"""Returns a dict of rule parameters filtered from the input dict that only contains the ones that are common to all test rules
These are listed in Bazel's documentation:
https://bazel.build/reference/be/common-definitions#common-attributes
@ -351,7 +351,7 @@ def _propagate_common_test_rule_attributes(attrs):
}
def _propagate_common_binary_rule_attributes(attrs):
"""Returns a dict of rule parameters filtered from the input dict that only contains the onces that are common to all binary rules
"""Returns a dict of rule parameters filtered from the input dict that only contains the ones that are common to all binary rules
These are listed in Bazel's documentation:
https://bazel.build/reference/be/common-definitions#common-attributes

View File

@ -110,7 +110,7 @@ def tar(name, mtree = "auto", stamp = 0, **kwargs):
# Ensure there's a trailing newline, as bsdtar will ignore a last line without one
template = ["#mtree", "{content}", ""],
substitutions = {
# expand_template only expands strings in "substitions" dict. Here
# expand_template only expands strings in "substitutions" dict. Here
# we expand mtree and then replace the template with expanded mtree.
"{content}": "\n".join(mtree),
},

View File

@ -3,7 +3,7 @@
build --keep_going
# Output test errors to stderr so users don't have to `cat` or open test failure log files when test
# fail. This makes the log noiser in exchange for reducing the time-to-feedback on test failures for
# fail. This makes the log noisier in exchange for reducing the time-to-feedback on test failures for
# users.
# Docs: https://bazel.build/docs/user-manual#test-output
test --test_output=errors

View File

@ -68,7 +68,7 @@ build --incompatible_default_to_explicit_init_py
common --incompatible_disallow_empty_glob
# Always download coverage files for tests from the remote cache. By default, coverage files are not
# downloaded on test result cahce hits when --remote_download_minimal is enabled, making it impossible
# downloaded on test result cache hits when --remote_download_minimal is enabled, making it impossible
# to generate a full coverage report.
# Docs: https://bazel.build/reference/command-line-reference#flag--experimental_fetch_all_coverage_outputs
# detching remote cache results

View File

@ -3,7 +3,7 @@
build --keep_going
# Output test errors to stderr so users don't have to `cat` or open test failure log files when test
# fail. This makes the log noiser in exchange for reducing the time-to-feedback on test failures for
# fail. This makes the log noisier in exchange for reducing the time-to-feedback on test failures for
# users.
# Docs: https://bazel.build/docs/user-manual#test-output
test --test_output=errors

View File

@ -94,7 +94,7 @@ call :rlocation "{sh_script}" run_script
for %%a in ("{bash_bin}") do set "bash_bin_dir=%%~dpa"
set PATH=%bash_bin_dir%;%PATH%
set args=%*
rem Escape \ and * in args before passsing it with double quote
rem Escape \ and * in args before passing it with double quote
if defined args (
set args=!args:\=\\\\!
set args=!args:"=\"!

View File

@ -115,7 +115,7 @@ def yq(name, srcs, expression = ".", args = [], outs = None, **kwargs):
is handled automatically based on the number `srcs`. Passing the output format or the parse format
is optional as these can be guessed based on the file extensions in `srcs` and `outs`.
outs: Name of the output files. Defaults to a single output with the name plus a ".yaml" extension, or
the extension corresponding to a passed output argment (e.g., "-o=json"). For split operations you
the extension corresponding to a passed output argument (e.g., "-o=json"). For split operations you
must declare all outputs as the name of the output files depends on the expression.
**kwargs: Other common named parameters such as `tags` or `visibility`
"""