> ## Documentation Index
> Fetch the complete documentation index at: https://bazel-pr-29352.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Maintaining Bazel Chocolatey package on Windows

Note: The Chocolatey package is experimental; please provide feedback
(`@petemounce` in issue tracker).

<h2 id="prerequisites">
  Prerequisites
</h2>

You need:

* [chocolatey package manager](https://chocolatey.org) installed
* (to publish) a chocolatey API key granting you permission to publish the
  `bazel` package
  * [@petemounce](https://github.com/petemounce) currently
    maintains this unofficial package.
* (to publish) to have set up that API key for the chocolatey source locally
  via `choco apikey -k <your key here> -s https://chocolatey.org/`

<h2 id="build">
  Build
</h2>

Compile bazel with msys2 shell and `compile.sh`.

```powershell theme={null}
pushd scripts/packages/chocolatey
  ./build.ps1 -version 0.3.2 -mode local
popd
```

Should result in `scripts/packages/chocolatey/bazel.<version>.nupkg` being
created.

The `build.ps1` script supports `mode` values `local`, `rc` and `release`.

<h2 id="test">
  Test
</h2>

0. Build the package (with `-mode local`)

   * run a webserver (`python -m SimpleHTTPServer` in
     `scripts/packages/chocolatey` is convenient and starts one on
     `http://localhost:8000`)

1. Test the install

   The `test.ps1` should install the package cleanly (and error if it did not
   install cleanly), then tell you what to do next.

2. Test the uninstall

   ```sh theme={null}
   choco uninstall bazel
   # should remove bazel from the system
   ```

Chocolatey's moderation process automates checks here as well.

<h2 id="release">
  Release
</h2>

Modify `tools/parameters.json` for the new release's URI and checksum once the
release has been published to github releases.

```powershell theme={null}
./build.ps1 -version <version> -isRelease
./test.ps1 -version <version>
# if the test.ps1 passes
choco push bazel.x.y.z.nupkg --source https://chocolatey.org/
```

Chocolatey.org will then run automated checks and respond to the push via email
to the maintainers.