Common useful functions and rules for Bazel
Go to file
aiuto e5cf5398cd
Update version and changelog in prep for 1.0.0 release (#196)
* -Update changelog to get ready for release 1.0
-Change README to point to releases page for WORKSPACE setup. Otherwise
 the readme shipped in the archive can never be in sync with the readme
 that has the correct sha256.

* update incompatible changes

* -Update changelog to get ready for release 1.0
-Change README to point to releases page for WORKSPACE setup. Otherwise
 the readme shipped in the archive can never be in sync with the readme
 that has the correct sha256.

* fix wording of changelog

* remove false file
2019-10-04 14:55:59 -04:00
.bazelci e2e tests: make them run on Windows (#121) 2019-03-19 13:37:33 +01:00
distribution Use rules_pkg to make the skylib tarball for a release. (#185) 2019-08-23 14:37:16 -04:00
docs Delete maprule. Fix Buildifier lint errors. (#192) 2019-09-17 14:03:22 +02:00
lib Avoid some repetition in _make_analysis_test (#197) 2019-10-04 11:19:43 -04:00
rules Delete maprule. Fix Buildifier lint errors. (#192) 2019-09-17 14:03:22 +02:00
tests Add types.is_set() to test whether an arbitrary object is a set as defined by new_sets.bzl. (#181) 2019-09-17 10:21:44 -04:00
toolchains/unittest Add basic shell testing for unittest.bzl (#108) 2019-02-11 17:18:56 -05:00
.gitignore Add initial .gitignore with bazel-* folders 2017-10-31 07:04:27 -07:00
AUTHORS Fix grammar. 2018-02-20 16:53:50 -05:00
BUILD Use rules_pkg to make the skylib tarball for a release. (#185) 2019-08-23 14:37:16 -04:00
CHANGELOG.md Update version and changelog in prep for 1.0.0 release (#196) 2019-10-04 14:55:59 -04:00
CODEOWNERS add aiuto as code owner. direct changes to distribution/ to them (#187) 2019-08-23 11:57:39 -04:00
CONTRIBUTING.md Initial check-in. 2017-10-10 07:59:31 -07:00
CONTRIBUTORS add cparsons and bttk to the CONTRIBUTORS file (#73) 2018-11-20 15:19:06 -05:00
LICENSE Initial check-in. 2017-10-10 07:59:31 -07:00
README.md Update version and changelog in prep for 1.0.0 release (#196) 2019-10-04 14:55:59 -04:00
WORKSPACE load rules thorugh maybe so we can simultaneous updates (#195) 2019-10-02 11:15:53 -04:00
bzl_library.bzl buildifier lint issues/validation 2018-11-21 13:04:25 -05:00
internal_deps.bzl Use rules_pkg to make the skylib tarball for a release. (#185) 2019-08-23 14:37:16 -04:00
internal_setup.bzl Comply with the standards of the Bazel federation (#182) 2019-08-13 21:28:45 +02:00
lib.bzl `print`->`fail` and suppress the warning in another case. (#177) 2019-07-22 13:25:00 -04:00
skylark_library.bzl `print`->`fail` and suppress the warning in another case. (#177) 2019-07-22 13:25:00 -04:00
version.bzl Update version and changelog in prep for 1.0.0 release (#196) 2019-10-04 14:55:59 -04:00
workspace.bzl add missing license notices (#94) 2019-01-14 16:00:11 -05:00

README.md

Skylib

Build status

Skylib is a standard library that provides functions useful for manipulating collections, file paths, and other features that are useful when writing custom build rules in Bazel.

This library is currently under early development. Be aware that the APIs in these modules may change during this time.

Each of the .bzl files in the lib directory defines a "module"—a struct that contains a set of related functions and/or other symbols that can be loaded as a single unit, for convenience.

Skylib also provides build rules under the rules directory.

Getting Started

WORKSPACE file

See the WORKSPACE setup section for the current release.

If you want to use lib/unittest.bzl from Skylib versions released in or after December 2018, then you also should add to the WORKSPACE file:

load("@bazel_skylib//:workspace.bzl", "bazel_skylib_workspace")

bazel_skylib_workspace()

BUILD and *.bzl files

Then, in the BUILD and/or *.bzl files in your own workspace, you can load the modules (listed below) and access the symbols by dotting into those structs:

load("@bazel_skylib//lib:paths.bzl", "paths")
load("@bazel_skylib//lib:shell.bzl", "shell")

p = paths.basename("foo.bar")
s = shell.quote(p)

List of modules (in lib/)

List of rules (in rules/)

Writing a new module

Steps to add a module to Skylib:

  1. Create a new .bzl file in the lib directory.

  2. Write the functions or other symbols (such as constants) in that file, defining them privately (prefixed by an underscore).

  3. Create the exported module struct, mapping the public names of the symbols to their implementations. For example, if your module was named things and had a function named manipulate, your things.bzl file would look like this:

    def _manipulate():
      ...
    
    things = struct(
        manipulate=_manipulate,
    )
    
  4. Add unit tests for your module in the tests directory.

bzl_library

The bzl_library.bzl rule can be used to aggregate a set of Starlark files and its dependencies for use in test targets and documentation generation.

Troubleshooting

If you try to use unittest and you get the following error:

ERROR: While resolving toolchains for target //foo:bar: no matching toolchains found for types @bazel_skylib//toolchains:toolchain_type
ERROR: Analysis of target '//foo:bar' failed; build aborted: no matching toolchains found for types @bazel_skylib//toolchains:toolchain_type

then you probably forgot to load and call bazel_skylib_workspace() in your WORKSPACE file.