OnWorks favicon

bats - Online in the Cloud

Run bats in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command bats that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



bats - Bash Automated Testing System


bats [-c] [-p | -t] test [test ...]

test is the path to a Bats test file, or the path to a directory containing Bats test


Bats is a TAP-compliant testing framework for Bash. It provides a simple way to verify
that the UNIX programs you write behave as expected.

A Bats test file is a Bash script with special syntax for defining test cases. Under the
hood, each test case is just a function with a description.

Test cases consist of standard shell commands. Bats makes use of Bash´s errexit (set -e)
option when running test cases. If every command in the test case exits with a 0 status
code (success), the test passes. In this way, each line is an assertion of truth.

See bats(7) for more information on writing Bats tests.


To run your tests, invoke the bats interpreter with a path to a test file. The file´s test
cases are run sequentially and in isolation. If all the test cases pass, bats exits with a
0 status code. If there are any failures, bats exits with a 1 status code.

You can invoke the bats interpreter with multiple test file arguments, or with a path to a
directory containing multiple .bats files. Bats will run each test file individually and
aggregate the results. If any test case fails, bats exits with a 1 status code.


-c, --count
Count the number of test cases without running any tests

-h, --help
Display help message

-p, --pretty
Show results in pretty format (default for terminals)

-t, --tap
Show results in TAP format

-v, --version
Display the version number


When you run Bats from a terminal, you´ll see output as each test is performed, with a
check-mark next to the test´s name if it passes or an "X" if it fails.

$ bats addition.bats
✓ addition using bc
✓ addition using dc

2 tests, 0 failures

If Bats is not connected to a terminal--in other words, if you run it from a continuous
integration system or redirect its output to a file--the results are displayed in
human-readable, machine-parsable TAP format. You can force TAP output from a terminal by
invoking Bats with the --tap option.

$ bats --tap addition.bats
ok 1 addition using bc
ok 2 addition using dc


The bats interpreter exits with a value of 0 if all test cases pass, or 1 if one or more
test cases fail.

Use bats online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    ExpressLuke GSI
    ExpressLuke GSI
    This SourceForge download page was to
    grant users to download my source built
    GSIs, based upon phhusson's great
    work. I build both Android Pie and
    Android 1...
    Download ExpressLuke GSI
  • 2
    PyQt is the Python bindings for
    Digia's Qt cross-platform
    application development framework. It
    supports Python v2 and v3 and Qt v4 and
    Qt v5. PyQt is avail...
    Download PyQt
  • 3
    Gambas3* coding tools and examples for
    use in SMB or other organizations that
    make internal programs. E.g. from
    database fields to class sourcecode with
    Download garlic3
  • 4
    Sardi is a complete restyling and
    optimisation of svg code. 6 choices for
    your applications and 10 kind of folders
    to use in your file manager. The sardi
    Download Sardi
  • 5
    LMMS Digital Audio Workstation
    LMMS Digital Audio Workstation
    LMMS is a free cross-platform software
    which allows you to produce music with
    your computer. If you like this project
    consider getting involved in the project
    Download LMMS Digital Audio Workstation
  • 6
    FreeRTOS Real Time Kernel (RTOS)
    FreeRTOS Real Time Kernel (RTOS)
    FreeRTOS is a market-leading real-time
    operating system (RTOS) for
    microcontrollers and small
    microprocessors. Distributed freely
    under the MIT open source lice...
    Download FreeRTOS Real Time Kernel (RTOS)
  • 7
    Avogadro is an advanced molecular
    editor designed for cross-platform use
    in computational chemistry, molecular
    modeling, bioinformatics, materials
    science and ...
    Download Avogadro
  • More »

Linux commands