bash-base

Welcome to bash-base

What's bash-base?

A common lib for creating bash script easily.

Latest Update

See CHANGELOG.md

How to use

Get from github

Import bash-base directly from github during every execution

Simply write in console or script:

If to import latest version:

source <(curl -fsSL https://raw.githubusercontent.com/zhang-hongjie/bash-base/master/src/bash-base.sh)
or
eval "$(curl -fsSL https://raw.githubusercontent.com/zhang-hongjie/bash-base/master/src/bash-base.sh)"

If to import specific version:

source <(curl -fsSL https://raw.githubusercontent.com/zhang-hongjie/bash-base/v2.3.1/src/bash-base.sh)
or
eval "$(curl -fsSL https://raw.githubusercontent.com/zhang-hongjie/bash-base/v2.3.1/src/bash-base.sh)

Verify the import in console:

string_trim ' hello '

Import bash-base using install.sh

The directory installed is ~/.bash-base.

source or install the specific version in console or shell script:

• the man page of version v2.3.3: man bash-base.${version},
• you can import this version in one line in your script:

source bash-base.v2.3.3 2>/dev/null || curl -o- -L https://raw.githubusercontent.com/zhang-hongjie/bash-base/master/scripts/install.sh | bash -s -- v2.3.3"

but if you want always the latest version, source or install the latest version in console or shell script:

• the man page is: man bash-base,
• and import like this:

source bash-base 2>/dev/null || curl -o- -L https://raw.githubusercontent.com/zhang-hongjie/bash-base/master/scripts/install.sh | bash
or
source bash-base 2>/dev/null || curl -o- -L https://raw.githubusercontent.com/zhang-hongjie/bash-base/master/scripts/install.sh | bash -s -- latest

this way, your script will access github to check whether a newer version published during every time it launched. if you don't like this behavior, you can specify a fixed version to use in your script.

Using param verify to check all functions of bash-base is compatible with your environment:

source bash-base 2>/dev/null || curl -o- -L https://raw.githubusercontent.com/zhang-hongjie/bash-base/master/scripts/install.sh | bash -s -- latest verify
or
source bash-base 2>/dev/null || curl -o- -L https://raw.githubusercontent.com/zhang-hongjie/bash-base/master/scripts/install.sh | bash -s -- v2.3.3 verify

To uninstall all versions of bash-base from your system:

curl -o- -L https://raw.githubusercontent.com/zhang-hongjie/bash-base/master/scripts/install.sh | bash -s -- uninstall

Install from NPM

See npm repackage

npm install -g bash-base

verify the installation

man bash-base

or one line in your script:

# import, and install bash-base from npmjs only if not installed:
source bash-base 2>/dev/null || npm install -g bash-base

To uninstall:

npm uninstall -g bash-base

Install from docker

See docker hub

docker pull zhj2074/bash-base:latest

Or run a specific version directly

docker run -it zhj2074/bash-base:2.3.2

Download only

download a specific version:

• from NPM: https://registry.npmjs.org/bash-base/-/bash-base-2.3.2.tgz
• from github: https://github.com/zhang-hongjie/bash-base/archive/v2.3.3.tar.gz

Example

See example folder

Reference

See reference

Specification

See spec folder

Contributing

See How to contribute

License

MIT.