Repository files navigation

An open source day-to-day bash library.

Key features:

• manage strings, files, integers and arrays easily
• build colorized contents with text effect, foreground and background colors
• execute sub-jobs with a large control upon outputs, errors and status
• build some scripts with command line options and arguments easily
• the library is well-documented and unit-tested

To begin, have a look atthe wiki.

Installing thePiwi Bash Library is as simple as making a copy of two files in your targetdirectory: thelibrary source itself andits Unix manual page.

You can install the package in many ways explained in theGlobal documentation ;the best practice is to usethe internal interface as it presents facilities to update the library.

wget --no-check-certificate https://github.com/piwi/bash-library/archive/master.tar.gztar -xvf master.tar.gzcd piwi-bash-library-master./bin/piwi-bash-library help

To read the library's manpage, run:

man man/piwi-bash-library.man

To use the library in a bash script, justsource it at the top of your code or before anycall of its methods or variables:

#!/bin/bashsource path/to/piwi-bash-library.bash...

The full documentation of the library is available online athttp://github.com/piwi/bash-library/wiki.

A set of test and demonstration files is included in thesamples/ directory of the package.These files are not required for a normal usage of the library.

To run one of these tests, just run:

cd path/to/downloaded/package/piwi-bash-library./samples/file-test.sh

You can use the--help option to get help or info:

./samples/file-test.sh --help

• For sources & updates, seehttp://github.com/piwi/bash-library

• For documentation, seehttp://github.com/piwi/bash-library/wiki/

• To transmit bugs, seehttp://github.com/piwi/bash-library/issues

• To read GPL-3.0 license conditions, seehttp://www.gnu.org/licenses/gpl-3.0.html

  Piwi Bash Library - An open source day-to-day bash libraryCopyleft (ↄ) 2013-2015 Pierre Cassat & contributorshttp://e-piwi.fr/ - Some rights reserved.

  This program is free software: you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe Free Software Foundation, either version 3 of the License, or(at your option) any later version.

  This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See theGNU General Public License for more details.

  You should have received a copy of the GNU General Public Licensealong with this program. If not, seehttp://www.gnu.org/licenses/.