# Install beakerlib with Homebrew, dnf

Shell-level integration testing library. Version 1.33.3 via Homebrew; verified 2026-06-22. Also installable with dnf: sudo dnf install beakerlib.

## 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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

## Package facts

- **Package key:** brew:beakerlib
- **Package manager:** Homebrew
- **Version:** 1.33.3
- **Source summary:** Shell-level integration testing library
- **Homepage:** <https://github.com/beakerlib/beakerlib>
- **Repository:** <https://github.com/beakerlib/beakerlib>
- **Last updated:** 2026-06-22T14:02:52-07:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

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

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.33.3
## 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

## Other Package-Manager Records

- dnf - beakerlib - 1.33.3-2.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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | A shell-level integration testing library | https://github.com/beakerlib
- dnf - beakerlib-vim-syntax - 1.33.3-2.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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Files for syntax highlighting BeakerLib tests in VIM editor | https://github.com/beakerlib


## Combined YAML source

View the package source record on GitHub. [combined/beakerlib.yml](https://github.com/mxcl/pkgdb/blob/main/combined/beakerlib.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
