bibop

README

Usage demo • Installation • Usage • Build Status • License

bibop is a utility for testing command-line tools and daemons. Initially, this utility was created for testing packages from ESSENTIAL KAOS Public Yum Repository.

Information about bibop recipe syntax you can find in our cookbook.

Usage demo

Installation

From source

Before the initial install allows git to use redirects for pkg.re service (reason why you should do this described here):

git config --global http.https://pkg.re.followRedirects true

To build the bibop from scratch, make sure you have a working Go 1.13+ workspace (instructions), then:

go get github.com/essentialkaos/bibop

If you want to update bibop to latest stable release, do:

go get -u github.com/essentialkaos/bibop

Prebuilt binaries

You can download prebuilt binaries for Linux from EK Apps Repository.

To install the latest prebuilt version of bibop, do:

bash <(curl -fsSL https://apps.kaos.st/get) bibop

Docker support

You can use Docker containers for testing your packages. Install latest version of Docker, then:

curl -fL# -o bibop-docker https://kaos.sh/bibop/bibop-docker
chmod +x bibop-docker
sudo mv bibop-docker /usr/bin/
bibop-docker --image essentialkaos/bibop:centos6 your.recipe your-package.rpm

Official Docker images with bibop:

• essentialkaos/bibop:centos6
• essentialkaos/bibop:centos7

Recipe syntax highlighting

• Sublime Text 3
• nano

Command-line completion

You can generate completion for bash, zsh or fish shell.

Bash:

sudo bibop --completion=bash 1> /etc/bash_completion.d/bibop

ZSH:

sudo bibop --completion=zsh 1> /usr/share/zsh/site-functions/bibop

Fish:

sudo bibop --completion=fish 1> /usr/share/fish/vendor_completions.d/bibop.fish

Usage

Usage: bibop {options} recipe

Options

  --dir, -d dir             Path to working directory
  --error-dir, -e dir       Path to directory for errors data
  --tag, -t tag             Command tag
  --quiet, -q               Quiet mode
  --ignore-packages, -ip    Skip packages check
  --dry-run, -D             Parse and validate recipe
  --list-packages, -L       List required packages
  --no-color, -nc           Disable colors in output
  --help, -h                Show this help message
  --version, -v             Show version

Examples

  bibop app.recipe
  Run tests from app.recipe

  bibop app.recipe --quiet --error-dir bibop-errors
  Run tests from app.recipe in quiet mode and save errors data to bibop-errors directory

  bibop app.recipe --tag init,service
  Run tests from app.recipe and execute commands with tags init and service

Build Status

Branch	Status
master
develop

License

Apache License, Version 2.0