# Install beakerlib with Homebrew, dnf

Shell-level integration testing library. Version 1.33.3 via Homebrew; verified 2026-06-22.

## Install

```sh
sudo av install brew:beakerlib
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install beakerlib
```

  Evidence: local Homebrew formula metadata

### Linux

- dnf (92%):

```sh
sudo dnf install beakerlib
```

  Evidence: Fedora Rawhide package metadata: beakerlib from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

## Package facts

- **Package key:** brew:beakerlib
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/beakerlib>
- **Version:** 1.33.3
- **Source summary:** Shell-level integration testing library
- **Homepage:** <https://github.com/beakerlib/beakerlib>
- **Repository:** <https://github.com/beakerlib/beakerlib>
- **Upstream docs:** <https://beakerlib.readthedocs.io/en/latest>
- **License:** GPL-2.0-only
- **Source archive:** <https://github.com/beakerlib/beakerlib/archive/refs/tags/1.33.3.tar.gz>
- **Last updated:** 2026-06-22T14:02:52-07:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- beakerlib-deja-summarize (cli)
- beakerlib-journalcmp (cli)
- beakerlib-journalling (cli)
- beakerlib-lsb_release (cli)
- beakerlib-rlMemAvg (cli)
- beakerlib-rlMemPeak (cli)
- beakerlib-testwatcher (cli)
- beakerlib-deja-summarize (alias)
- beakerlib-journalcmp (alias)
- beakerlib-journalling (alias)
- beakerlib-lsb_release (alias)
- beakerlib-rlMemAvg (alias)
- beakerlib-rlMemPeak (alias)
- beakerlib-testwatcher (alias)

## Dependencies

- coreutils
- gnu-getopt

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.33.3
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://github.com/beakerlib/beakerlib
- Upstream latest detected: 1.33.3 (current)
## Project history and usage

BeakerLib is a shell-level integration testing library for writing, running, logging, and analyzing integration and black-box tests. It is especially associated with Fedora/RHEL-style test automation, where shell tests need consistent phases, assertions, journals, and result files.

### Project history

The current documentation says the project moved to its new official home after fedorahosted.org was shut down. The GitHub repository was created on 2017-03-01 and the README identifies it as the upstream project for a shell testing library with Fedora/RHEL distribution support.

BeakerLib's manual documents the long-lived shell API surface: tests source /usr/share/beakerlib/beakerlib.sh, start and end journals, divide work into phases, run commands, assert conditions, manage services and files, and emit journal.txt, journal.xml, and TestResults output.

### Adoption history

The README documents Fedora and RHEL packaging as the primary distribution path, with newer builds available through COPR. The batch package facts show Homebrew and Fedora packaging, which is narrower than Beads or bdftopcf but notable because the package carries Linux distribution QA practices into local developer environments.

The beakerlib GitHub organization also hosts many domain-specific shell libraries, showing that BeakerLib became more than one script: it is a shared testing vocabulary for distribution and system-integration tests.

### How it is used

A BeakerLib test is usually a shell script that sources beakerlib.sh, opens a journal, runs setup/test/cleanup phases, records assertions and command results, then closes the journal. The official manual centers on repeatable logging and result reporting rather than unit-test style in-process assertions.

The library is used for integration and black-box tests where shell commands, packages, services, files, sockets, mounts, virtual X, performance metrics, reboot handling, and cleanup must be coordinated in a readable script.

### Why package nerds care

BeakerLib is package-nerd significant because it is a packaged testing framework for the shell and the operating system, not just for an application language. It reflects the needs of distribution QA: tests must install from packages, manipulate services, survive real system state, and produce machine-readable logs for automation.

Its move from Fedora Hosted to GitHub/Read the Docs also marks a common infrastructure migration path for older Fedora-era projects after fedorahosted.org was retired.

### Timeline

- Pre-2017: BeakerLib is hosted on fedorahosted.org according to the current docs.
- 2017-03-01: beakerlib/beakerlib GitHub repository is created.
- 2021-11-09: Documentation news lists BeakerLib 1.28 with new OS-detection and dependency-checking functions.
- 2022-10-20: Documentation news lists BeakerLib 1.29.3.
- 2026-04-07: GitHub lists beakerlib-1.33.3 as the latest release.

### Related projects

- Beaker is the broader Red Hat-origin automated test system whose ecosystem gives BeakerLib its name and context.
- Fedora and RHEL packaging are the documented distribution channels.
- The beakerlib GitHub organization hosts companion libraries for areas such as firewalld, database, yum, crypto, and distribution testing.

### Sources

- <https://api.github.com/repos/beakerlib/beakerlib>
- <https://beakerlib.readthedocs.io/en/latest/>
- <https://beakerlib.readthedocs.io/en/latest/manual.html>
- <https://github.com/beakerlib>
- <https://raw.githubusercontent.com/beakerlib/beakerlib/master/README.md>


## Security Notes

generalized runtime or code generation signal.

- **Geiger risk:** yellow / medium
- generalized runtime or code generation signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** beakerlib
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- dnf - beakerlib - 1.33.3-1.fc45: normalized package name match | Fedora Rawhide package metadata: beakerlib from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A shell-level integration testing library | https://github.com/beakerlib
- dnf - beakerlib-vim-syntax - 1.33.3-1.fc45: normalized package name match | Fedora Rawhide package metadata: beakerlib-vim-syntax from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Files for syntax highlighting BeakerLib tests in VIM editor | https://github.com/beakerlib


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [coreutils](https://www.automicvault.com/pkg/brew/coreutils/) - Runtime dependency declared by Homebrew.
- [gnu-getopt](https://www.automicvault.com/pkg/brew/gnu-getopt/) - Runtime dependency declared by Homebrew.
- [tmt](https://www.automicvault.com/pkg/brew/tmt/) - Popular package that depends on this formula.
- [clitest](https://www.automicvault.com/pkg/brew/clitest/) - Shares av.db curated category or tags: cli, developer-tools, shell, testing.
- [shellspec](https://www.automicvault.com/pkg/brew/shellspec/) - Shares av.db curated category or tags: cli, developer-tools, shell, testing.
- [shelltestrunner](https://www.automicvault.com/pkg/brew/shelltestrunner/) - Shares av.db curated category or tags: cli, developer-tools, shell, testing.
- [adb-enhanced](https://www.automicvault.com/pkg/brew/adb-enhanced/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [aliae](https://www.automicvault.com/pkg/brew/aliae/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [allure](https://www.automicvault.com/pkg/brew/allure/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [argc](https://www.automicvault.com/pkg/brew/argc/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [artillery](https://www.automicvault.com/pkg/brew/artillery/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [git-now](https://www.automicvault.com/pkg/brew/git-now/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, getopt, gnu.
- [libfaketime](https://www.automicvault.com/pkg/brew/libfaketime/) - Local package facts share a topical domain. Shared terms: cli, coreutils, developer, developer-tools, testing.

## Combined YAML source

View the package source record on GitHub. [combined/beakerlib.yml](https://github.com/automic-vault/db/blob/main/combined/beakerlib.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
