2017 © Pedro Peláez
 

library piwi-bash-library

The Bash library package of Les Ateliers Pierrot

image

atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  • Saturday, November 22, 2014
  • by picas
  • Repository
  • 0 Watchers
  • 0 Stars
  • 21 Installations
  • 1 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 13 Versions
  • 0 % Grown

The README.md

Piwi-Bash-Library

An open source day-to-day bash library., (*1)

Build Status, (*2)

Key features:, (*3)

  • 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 at the wiki., (*4)

Installation

Installing the Piwi Bash Library is as simple as making a copy of two files in your target directory: the library source itself and its Unix manual page., (*5)

You can install the package in many ways explained in the Global documentation ; the best practice is to use the internal interface as it presents facilities to update the library., (*6)

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

To read the library's manpage, run:, (*7)

man man/piwi-bash-library.man

Usage

To use the library in a bash script, just source it at the top of your code or before any call of its methods or variables:, (*8)

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

The full documentation of the library is available online at http://github.com/piwi/bash-library/wiki., (*9)

Demonstrations

A set of test and demonstration files is included in the samples/ directory of the package. These files are not required for a normal usage of the library., (*10)

To run one of these tests, just run:, (*11)

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

You can use the --help option to get help or info:, (*12)

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

Author & License

  • For sources & updates, see http://github.com/piwi/bash-library
  • For documentation, see http://github.com/piwi/bash-library/wiki/
  • To transmit bugs, see http://github.com/piwi/bash-library/issues
  • To read GPL-3.0 license conditions, see http://www.gnu.org/licenses/gpl-3.0.html, (*13)

    Piwi Bash Library - An open source day-to-day bash library Copyleft (ↄ) 2013-2015 Pierre Cassat & contributors http://e-piwi.fr/ - Some rights reserved., (*14)

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

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

    You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/., (*17)

The Versions

22/11 2014

dev-master-old

dev-master-old http://github.com/atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

21/11 2014

v2.0.4

2.0.4.0 http://github.com/atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

29/06 2014

v2.0.3

2.0.3.0 http://github.com/atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

11/06 2014

v2.0.2

2.0.2.0 http://github.com/atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

16/04 2014

v2.0.1

2.0.1.0 http://github.com/atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

09/04 2014

v2.0.0

2.0.0.0 http://github.com/atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

09/04 2014

v2.0.0-beta

2.0.0.0-beta http://github.com/atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

05/04 2014

1.0.x-dev

1.0.9999999.9999999-dev http://github.com/atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

04/04 2014

v1.0.1

1.0.1.0 http://github.com/atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

03/11 2013

v1.0.0

1.0.0.0 http://github.com/atelierspierrot/piwi-bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

24/10 2013

v1.0.4

1.0.4.0 http://github.com/atelierspierrot/bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

20/10 2013

v1.0.3

1.0.3.0 http://github.com/atelierspierrot/bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

The Development Requires

library bash

18/10 2013

v1.0.2

1.0.2.0 http://github.com/atelierspierrot/bash-library

The Bash library package of Les Ateliers Pierrot

  Sources   Download

GPL-3.0

library bash