Skip to content

Latest commit

 

History

History
executable file
·
96 lines (55 loc) · 2.47 KB

subpackages_doc.md

File metadata and controls

executable file
·
96 lines (55 loc) · 2.47 KB

Skylib module containing common functions for working with native.subpackages()

subpackages.all

subpackages.all(exclude, allow_empty, fully_qualified)

List all direct subpackages of the current package regardless of directory depth.

The returned list contains all subpackages, but not subpackages of subpackages.

Example: Assuming the following BUILD files exist:

BUILD
foo/BUILD
foo/sub/BUILD
bar/BUILD
baz/deep/dir/BUILD

If the current package is '//' all() will return ['//foo', '//bar', '//baz/deep/dir']. //foo/sub is not included because it is a direct subpackage of '//foo' not '//'

NOTE: fail()s if native.subpackages() is not supported.

PARAMETERS

Name Description Default Value
exclude see native.subpackages(exclude) []
allow_empty see native.subpackages(allow_empty) False
fully_qualified It true return fully qualified Labels for subpackages, otherwise returns subpackage path relative to current package. True

RETURNS

A mutable sorted list containing all sub-packages of the current Bazel package.

subpackages.exists

subpackages.exists(relative_path)

Checks to see if relative_path is a direct subpackage of the current package.

Example:

BUILD
foo/BUILD
foo/sub/BUILD

If the current package is '//' (the top-level BUILD file): subpackages.exists("foo") == True subpackages.exists("foo/sub") == False subpackages.exists("bar") == False

NOTE: fail()s if native.subpackages() is not supported in the current Bazel version.

PARAMETERS

Name Description Default Value
relative_path a path to a subpackage to test, must not be an absolute Label. none

RETURNS

True if 'relative_path' is a subpackage of the current package.

subpackages.supported

subpackages.supported()