Google Git
Sign in
pigweed / third_party / github / aspect-build / bazel-lib / refs/heads/upstream/chdir_binary
commitadd64ecd3dec32760244935d2b5bc404d3d33b68[log] [tgz]
authorAlex Eagle <alex@aspect.dev>Thu Sep 22 07:14:45 2022 -0700
committerAlex Eagle <alex@aspect.dev>Thu Sep 22 07:14:45 2022 -0700
tree4aecda5707b640b09d04ced290a7023c8ab78400
parent67f6b32fc4c3b5b65a850b59beaed300d73ccbe7 [diff]
chore: compile socat from source
4 files changed
tree: 4aecda5707b640b09d04ced290a7023c8ab78400
  1. .aspect/
  2. .bcr/
  3. .circleci/
  4. .github/
  5. docs/
  6. e2e/
  7. external/
  8. lib/
  9. platforms/
  10. shlib/
  11. tools/
  12. .bazelignore
  13. .bazelrc
  14. .bazelversion
  15. .gitattributes
  16. .gitignore
  17. .pre-commit-config.yaml
  18. .prettierignore
  19. BUILD.bazel
  20. CONTRIBUTING.md
  21. internal_deps.bzl
  22. LICENSE
  23. MODULE.bazel
  24. README.md
  25. renovate.json
  26. WORKSPACE
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.

Running programs

  • wrap_binary Compatibility shims which wrap binaries to adapt to the Bazel execution environment.

Generating documentation

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