Skip to content
Bash Shell Function Library
Branch: develop
Clone or download
SkypLabs Merge pull request #6 from SkypLabs/dependabot/submodules/doc/bash-do…
…xygen-94094df

Bump doc/bash-doxygen from `ac0bafb` to `94094df`
Latest commit c031c91 Feb 26, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Bump doc/bash-doxygen from `ac0bafb` to `94094df` Feb 26, 2019
examples fix typos May 25, 2018
lib fix 'trim()' Sep 24, 2018
test
.gitignore update gitignore file Jul 2, 2015
.gitmodules add 'bash-doxygen' as submodule Jun 8, 2018
.travis.yml deploy the documentation only on tags Apr 27, 2018
AUTHORS.md fix 'mailto' links in authors file Nov 27, 2015
LICENSE update license to year range Feb 9, 2017
README.md update readme Jun 8, 2018
bsfl.spec improve SPEC file indentation Sep 18, 2015

README.md

BSFL

Build Status

The Bash Shell Function Library (BSFL) is a small bash script that acts as a library for bash scripts. It provides a couple of functions that makes the lives of most people using shell scripts a bit easier.

This project is a fork of the original work of Louwrentius.

asciicast

Getting started

In order to use BSFL, you have to include the library in your bash scripts. You can do it with an absolute path:

source <absolute path to BSFL>

For example:

source /opt/bsfl/bsfl.sh

Or with a relative path:

declare -r DIR=$(cd "$(dirname "$0")" && pwd)
source $DIR/<relative path to BSFL>

For example:

declare -r DIR=$(cd "$(dirname "$0")" && pwd)
source $DIR/../lib/bsfl.sh

What's next?

The best way to learn how BSFL works is to look at the examples available in the examples folder.

Documentation

The online documentation is available here.

Building the documentation is done by using Doxygen:

cd <BSFL repository>/doc
git submodule update --init --recursive
doxygen Doxyfile

Dependencies

BSFL is implemented for bash version 4. Prior versions of bash will fail at interpreting its code.

In addition, BSFL depends of some external programs. Here is the list of these programs:

  • date
  • grep
  • logger
  • printf
  • tput
  • tr

However, we try to get as much as possible a standalone library. Hence, some of these external dependencies will be removed in the future.

Unit tests

BSFL uses Bats testing framework to verify the correct behaviour of its functions.

To run all the tests:

bats <BSFL repository>/test

Or, to run only the tests of a specific group:

bats <BSFL repository>/test/<test file>

For example, for the network group:

bats <BSFL repository>/test/network.bats

Releasing a new version

Below are the different steps to do before releasing a new version:

  • Run all tests and be sure they all pass
  • Update the BSFL_VERSION variable in lib/bsfl.sh
  • Update the PROJECT_NUMBER variable in doc/Doxygen
  • Update the Version variable in bsfl.spec
  • Update README.md if needed

Get involved!

This project is still under development. Contributions are welcomed.

License

New BSD

You can’t perform that action at this time.