Skylib module containing utilities for Bazel modules and module extensions.

modules.as_extension

Wraps a WORKSPACE dependency macro into a module extension.

Example:

def rules_foo_deps(optional_arg = True):
    some_repo_rule(name = "foobar")
    http_archive(name = "bazqux")

rules_foo_deps_ext = modules.as_extension(rules_foo_deps)

PARAMETERS

NameDescriptionDefault Value
macroA WORKSPACE dependency macro, i.e., a function with no required parameters that instantiates one or more repository rules.none
docA description of the module extension that can be extracted by documentation generating tools.None

RETURNS

A module extension that generates the repositories instantiated by the given macro and also uses use_all_repos to indicate that all of those repositories should be imported via use_repo.

modules.use_all_repos

Return from a module extension that should have all its repositories imported via use_repo.

Example:

def _ext_impl(module_ctx):
    some_repo_rule(name = "foobar")
    http_archive(name = "bazqux")
    return modules.use_all_repos(module_ctx)

ext = module_extension(_ext_impl)

PARAMETERS

NameDescriptionDefault Value
module_ctxThe module_ctx object passed to the module extension's implementation function.none

RETURNS

An extension_metadata object that, when returned from a module extension implementation function, specifies that all repositories generated by this extension should be imported via use_repo. If the current version of Bazel doesn't support extension_metadata, returns None instead, which can safely be returned from a module extension implementation function in all versions of Bazel.