2
0
Fork 0
mirror of https://github.com/bazelbuild/bazel-skylib synced 2024-11-28 08:43:51 +00:00
bazel-skylib/docs/versions_doc.md
nickgooding 31ab4c8bd2
feat: bzlmod setup (#385)
Creates MODULE.bazel and WORKSPACE.bzlmod files to enable bazel-skylib
to work with the `--experimental_enable_bzlmod` flag.

rules_go has been updated as the previously used version is not
available in the BCR.

stardoc has been updated due to a strange issue with Bzlmod enabled that
caused the `diff_test` and `unittest` docs to be generated without any
contents that was magically fixed upon updating.

bazelbuild/bazel-central-registry#124

Co-authored-by: Alexandre Rostovtsev <arostovtsev@google.com>
2022-08-30 14:57:34 -04:00

2.8 KiB
Executable file

Skylib module containing functions for checking Bazel versions.

versions.get

versions.get()

Returns the current Bazel version

versions.parse

versions.parse(bazel_version)

Parses a version string into a 3-tuple of ints

int tuples can be compared directly using binary operators (<, >).

PARAMETERS

Name Description Default Value
bazel_version the Bazel version string none

RETURNS

An int 3-tuple of a (major, minor, patch) version.

versions.check

versions.check(minimum_bazel_version, maximum_bazel_version, bazel_version)

Check that the version of Bazel is valid within the specified range.

PARAMETERS

Name Description Default Value
minimum_bazel_version minimum version of Bazel expected none
maximum_bazel_version maximum version of Bazel expected None
bazel_version the version of Bazel to check. Used for testing, defaults to native.bazel_version None

versions.is_at_most

versions.is_at_most(threshold, version)

Check that a version is lower or equals to a threshold.

PARAMETERS

Name Description Default Value
threshold the maximum version string none
version the version string to be compared to the threshold none

RETURNS

True if version <= threshold.

versions.is_at_least

versions.is_at_least(threshold, version)

Check that a version is higher or equals to a threshold.

PARAMETERS

Name Description Default Value
threshold the minimum version string none
version the version string to be compared to the threshold none

RETURNS

True if version >= threshold.