Google Git
Sign in
pigweed / third_party / github / aspect-build / bazel-lib / refs/heads/upstream/f0rmiga/improve-copy-programs
commit1e3d21ffb5893763090e0535fc6af45409d52155[log] [tgz]
authorThulio Ferraz Assis <3149049+f0rmiga@users.noreply.github.com>Tue Jan 17 09:21:52 2023 -0800
committerThulio Ferraz Assis <3149049+f0rmiga@users.noreply.github.com>Tue Jan 17 09:21:52 2023 -0800
tree749d4f186ab804f8d45e83d1bc7c89362a66da7f
parent4dc36a97f23c3a925142d4bd923be029ee1fe522 [diff]
refactor: improve copy programs

Signed-off-by: Thulio Ferraz Assis <3149049+f0rmiga@users.noreply.github.com>
3 files changed
tree: 749d4f186ab804f8d45e83d1bc7c89362a66da7f
  1. .aspect/
  2. .bcr/
  3. .circleci/
  4. .github/
  5. docs/
  6. e2e/
  7. lib/
  8. platforms/
  9. shlib/
  10. tools/
  11. .bazelignore
  12. .bazeliskrc
  13. .bazelrc
  14. .bazelversion
  15. .gitattributes
  16. .gitignore
  17. .pre-commit-config.yaml
  18. .prettierignore
  19. BUILD.bazel
  20. CONTRIBUTING.md
  21. deps.bzl
  22. go.mod
  23. go.sum
  24. internal_deps.bzl
  25. LICENSE
  26. MODULE.bazel
  27. README.md
  28. renovate.json
  29. WORKSPACE
  30. workspace_status.sh
README.md

Aspect's Bazel helpers library

Base Starlark libraries and basic Bazel rules which are useful for constructing rulesets and BUILD files.

This module depends on bazel-skylib. In theory all these utilities could be upstreamed to bazel-skylib, but the declared scope of that project is narrow and it‘s very difficult to get anyone’s attention to review PRs there.

bazel-lib is just a part of what Aspect provides:

Installation

Installation instructions are included on each release: https://github.com/aspect-build/bazel-lib/releases

Public API

Copying files

  • copy_directory Copies directories to another package.
  • copy_file Copies files to another package.
  • copy_to_bin Copies a source file to output tree at the same workspace-relative path.
  • copy_to_directory Copies and arranges files and directories into a new directory.
  • write_source_files Write to one or more files or folders in the source tree. Stamp out tests that ensure the sources exist and are up to date.

Transforming files

  • jq A toolchain and custom rule for running jq, a tool that is “like sed for json”.
  • yq A toolchain and custom rule for running yq, a “YAML, JSON and XML processor”.

Manipulating paths

  • directory_path Provide a label to reference some path within a directory, via DirectoryPathInfo.
  • output_files Forwards a subset of the files (via the DefaultInfo provider) from a given target's DefaultInfo or OutputGroupInfo.

Writing rules

  • expand_make_vars Perform make variable and location substitions in strings and templates.
  • paths Useful path resolution methods.
  • transitions Transition sources to a provided platform.
  • utils Various utils for labels and globs.
  • params_file Generate encoded params file from a list of arguments.
  • repo_utils Useful methods for repository rule implementations.
  • run_binary Like skylib's run_binary but adds directory output support.
  • stamping Support version stamping in custom rules.
  • base64 Starlark Base64 encoder & decoder.

Generating documentation

  • docs Rules for generating docs and stamping tests to ensure they are up to date.