blob: a85cae8f954d3e66327d373a9b0a8b732f4e236a [file] [log] [blame]
<!--
Documentation generated by Skydoc
-->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width initial-scale=1" />
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>Check Bazel version</title>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,500,600,700" type="text/css">
<link rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons">
<link rel="stylesheet" href="https://code.getmdl.io/1.1.1/material.green-light_blue.min.css">
<script defer src="https://code.getmdl.io/1.1.1/material.min.js"></script>
<link rel="stylesheet" href="/rules_nodejs/main.css">
</head>
<body>
<div class="mdl-layout mdl-js-layout mdl-layout--fixed-drawer
mdl-layout--fixed-header">
<header class="mdl-layout__header">
<div class="mdl-layout__header-row">
<span class="mdl-layout-title">Check Bazel version</span>
</div>
</header>
<div class="mdl-layout__drawer">
<span class="mdl-layout-title">Bazel</span>
<nav class="drawer-nav">
<ul class="drawer-nav">
<li><a href="/rules_nodejs/index.html">Overview</a></li>
<li>
<a href="/rules_nodejs/common/check_bazel_version.html">Check Bazel version</a>
<ul>
<li><a href="/rules_nodejs/common/check_bazel_version.html#overview">Overview</a></li>
</ul>
</li>
<li>
<a href="/rules_nodejs/history-server/history_server.html">Run history-server</a>
<ul>
</ul>
</li>
<li>
<a href="/rules_nodejs/http-server/http_server.html">Run http-server</a>
<ul>
</ul>
</li>
<li>
<a href="/rules_nodejs/jasmine_node_test/jasmine_node_test.html">NodeJS testing</a>
<ul>
<li><a href="/rules_nodejs/jasmine_node_test/jasmine_node_test.html#overview">Overview</a></li>
</ul>
</li>
<li>
<a href="/rules_nodejs/node/node.html">Executing programs</a>
<ul>
<li><a href="/rules_nodejs/node/node.html#overview">Overview</a></li>
<li>
<a href="/rules_nodejs/node/node.html#nodejs_binary">
nodejs_binary
</a>
</li>
<li>
<a href="/rules_nodejs/node/node.html#nodejs_test">
nodejs_test
</a>
</li>
</ul>
</li>
<li>
<a href="/rules_nodejs/node/node_repositories.html">Install NodeJS & Yarn</a>
<ul>
<li><a href="/rules_nodejs/node/node_repositories.html#overview">Overview</a></li>
</ul>
</li>
<li>
<a href="/rules_nodejs/npm_install/npm_install.html">Install npm packages</a>
<ul>
<li><a href="/rules_nodejs/npm_install/npm_install.html#overview">Overview</a></li>
</ul>
</li>
<li>
<a href="/rules_nodejs/npm_package/npm_package.html">npm packaging</a>
<ul>
<li><a href="/rules_nodejs/npm_package/npm_package.html#overview">Overview</a></li>
<li>
<a href="/rules_nodejs/npm_package/npm_package.html#npm_package">
npm_package
</a>
</li>
</ul>
</li>
<li>
<a href="/rules_nodejs/rollup/rollup_bundle.html">Rollup bundling</a>
<ul>
<li><a href="/rules_nodejs/rollup/rollup_bundle.html#overview">Overview</a></li>
<li>
<a href="/rules_nodejs/rollup/rollup_bundle.html#rollup_bundle">
rollup_bundle
</a>
</li>
</ul>
</li>
</ul>
</nav>
</div>
<main class="mdl-layout__content">
<div class="page-content">
<h1>Check Bazel version</h1>
<nav class="toc">
<h2><a href="#overview">Overview</a></h2>
<h2>Macros</h2>
<ul>
<li><a href="#check_bazel_version">check_bazel_version</a></li>
<li><a href="#check_bazel_version_range">check_bazel_version_range</a></li>
</ul>
</nav>
<hr>
<h2 id="overview">Overview</h2>
<p>We recommend forcing all users to update to at least the same version of Bazel
as the continuous integration, so they don't trip over incompatibilities with
rules used in the project.</p>
<hr>
<h2 id="check_bazel_version">check_bazel_version</h2>
<pre>check_bazel_version(<a href="#check_bazel_version.minimum_bazel_version">minimum_bazel_version</a>, <a href="#check_bazel_version.message">message</a>)</pre>
<p>Verify the users Bazel version is at least the given one.</p>
<p>This should be called from the <code>WORKSPACE</code> file so that the build fails as
early as possible. For example:</p>
<pre><code># in WORKSPACE:
load("@build_bazel_rules_nodejs//:defs.bzl", "check_bazel_version")
check_bazel_version("0.26.0")
</code></pre>
<h3 id="check_bazel_version_args">Attributes</h3>
<table class="params-table">
<colgroup>
<col class="col-param" />
<col class="col-description" />
</colgroup>
<tbody>
<tr id="check_bazel_version.minimum_bazel_version">
<td><code>minimum_bazel_version</code></td>
<td>
<p><code>Unknown; Required</code></p>
<p>a string indicating the minimum version</p>
</td>
</tr>
<tr id="check_bazel_version.message">
<td><code>message</code></td>
<td>
<p><code>String; Optional</code></p>
<p>optional string to print to your users, could be used to help them update</p>
</td>
</tr>
</tbody>
</table>
<hr>
<h2 id="check_bazel_version_range">check_bazel_version_range</h2>
<pre>check_bazel_version_range(<a href="#check_bazel_version_range.minimum_bazel_version">minimum_bazel_version</a>, <a href="#check_bazel_version_range.maximum_bazel_version">maximum_bazel_version</a>, <a href="#check_bazel_version_range.message">message</a>)</pre>
<p>Verify the users Bazel version is in the version range.</p>
<p>This should be called from the <code>WORKSPACE</code> file so that the build fails as
early as possible. For example:</p>
<pre><code># in WORKSPACE:
load("@build_bazel_rules_nodejs//:defs.bzl", "check_bazel_version_range")
check_bazel_version_range("0.11.0", "0.22.0")
</code></pre>
<h3 id="check_bazel_version_range_args">Attributes</h3>
<table class="params-table">
<colgroup>
<col class="col-param" />
<col class="col-description" />
</colgroup>
<tbody>
<tr id="check_bazel_version_range.minimum_bazel_version">
<td><code>minimum_bazel_version</code></td>
<td>
<p><code>Unknown; Required</code></p>
<p>a string indicating the minimum version</p>
</td>
</tr>
<tr id="check_bazel_version_range.maximum_bazel_version">
<td><code>maximum_bazel_version</code></td>
<td>
<p><code>Unknown; Required</code></p>
<p>a string indicating the maximum version</p>
</td>
</tr>
<tr id="check_bazel_version_range.message">
<td><code>message</code></td>
<td>
<p><code>String; Optional</code></p>
<p>optional string to print to your users, could be used to help them update</p>
</td>
</tr>
</tbody>
</table>
</div>
<footer class="mdl-mini-footer">
<div class="mdl-mini-footer__left-section">
<div class="mdl-logo">Bazel</div>
<ul class="mdl-mini-footer__link-list">
<li><a href="https://bazel.build">Home</a></li>
<li><a href="https://github.com/bazelbuild">GitHub</a></li>
</ul>
</div>
</footer>
</main>
</div>
</body>
</html>