https://github.com/tangoman75/tools

TangoMan Tools is an awesome collection of small useful shell scripts
https://github.com/tangoman75/tools

shell shell-scripts shell-tools tangoman-tools

Last synced: 10 months ago
JSON representation

TangoMan Tools is an awesome collection of small useful shell scripts

Host: GitHub
URL: https://github.com/tangoman75/tools
Owner: TangoMan75
License: mit
Created: 2020-02-15T22:46:04.000Z (about 6 years ago)
Default Branch: main
Last Pushed: 2024-11-27T16:39:49.000Z (over 1 year ago)
Last Synced: 2025-03-20T21:07:20.947Z (about 1 year ago)
Topics: shell, shell-scripts, shell-tools, tangoman-tools
Language: Shell
Homepage:
Size: 1.06 MB
Stars: 1
Watchers: 2
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          ![GH language](https://img.shields.io/github/languages/top/TangoMan75/tools)

[![GH license](https://img.shields.io/github/license/TangoMan75/tools)]((https://github.com/TangoMan75/tools/blob/master/LICENSE))

[![GH release](https://img.shields.io/github/v/release/TangoMan75/tools)](https://github.com/TangoMan75/tools/releases)

[![GH stars](https://img.shields.io/github/stars/TangoMan75/tools)](https://github.com/TangoMan75/tools/stargazers)

[![Bash CI](https://github.com/TangoMan75/tools/workflows/bash_unit%20CI/badge.svg)](https://github.com/TangoMan75/tools/actions/workflows/bash_unit.yml)

[![ShellCheck CI](https://github.com/TangoMan75/tools/workflows/ShellCheck%20CI/badge.svg)](https://github.com/TangoMan75/tools/actions/workflows/shellcheck.yml)

![visitors](https://visitor-badge.glitch.me/badge?page_id=TangoMan75.tools)

TangoMan Bash Tool

==================

![tools](./doc/images/tools.png)

**TangoMan Bash Tools** is an awesome collection of small useful shell scripts.

⏳ TL;DR

--------

1. Copy "tools" folder into your project.

2. Source desired script in your own script.

```bash

source ./tools/src/colors/colors.sh

```

3. Call desired function.

```bash

echo_info "Hello World !\n"

```

🎯 Features

-----------

**TangoMan Bash Tool** provides the following features:

### ⚡ colors.sh

A semantic set of colors for shell scripts.

![print_colors](./doc/images/print_colors.png)

Try this in your script :

```bash

#!/bin/bash

CURDIR=$(dirname "$(realpath "${BASH_SOURCE[0]}")")

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/colors/colors.sh

echo_primary   'This is primary text'   2 24; echo 'primary'

echo_secondary 'This is secondary text' 2 24; echo 'secondary'

echo_success   'This is a success'      2 24; echo 'success'

echo_danger    'This is a danger'       2 24; echo 'danger'

echo_warning   'This is a warning'      2 24; echo 'warning'

echo_info      'This is an info'        2 24; echo 'info'

echo_light     'This is light'          2 24; echo 'light'

echo_dark      'This is dark'           2 24; echo 'dark'

```

![echo_colors](./doc/images/echo_colors.png)

```bash

#!/bin/bash

CURDIR=$(dirname "$(realpath "${BASH_SOURCE[0]}")")

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/colors/colors.sh

alert_primary   'This is a primary alert'

alert_secondary 'This is a secondary alert'

alert_success   'This is a success alert'

alert_danger    'This is a danger alert'

alert_warning   'This is a warning alert'

alert_info      'This is a info alert'

alert_light     'This is a light alert'

alert_dark      'This is a dark alert'

```

![alert_colors](./doc/images/alert_colors.png)

If you want to use Symfony theme for alerts use this file instead: `/tools/src/colors/colors_sf.sh`

![alert_colors_sf](./doc/images/alert_colors_sf.png)

📝 NOTE:

- Version a is the same than default version without comments.

- Version b is the same than default version with line feed at the end of each string.

- Version c does not use variables (less clutter).

- Version d is the same than version c with line feed at the end of each string.

### ⚡ get_latest_release.sh

Get repository latest release from github.

### ⚡ get_latest_tag.sh

Get repository latest tag from github.

### ⚡ download.sh

Download file with either curl or wget.

### ⚡ check_install.sh

This script is meant to quickly check for common apps installation.

![check_install](./doc/images/check_install.png)

### ⚡ check_root.sh

Throws error when user doesn't own root privileges.

### ⚡ check_versions.sh

Check version of some development tools.

### ⚡ compare_versions.sh

Compare two semantic versions.

### ⚡ hosts.sh

Edit your local `/etc/hosts` config from shell scripts.

### ⚡ is_installed.sh

Returns true when given application or command is available.

### ⚡ is_ubuntu.sh

Returns true when current operating system runs one of ubuntu version.

### ⚡ prompt_user.sh

Opens a user prompt for given value.

### ⚡ update_grub.sh

Updates GRUB on multiple patforms.

### ⚡ get_parameter.sh

Read parameter from .yaml file.

### ⚡ set_parameter.sh

Set parameter to .yaml file.

🚀 Installation

---------------

Just copy this folder into your project or import this repository into your git project as a submodule.

```bash

# with https

git submodule add https://github.com/TangoMan75/tools.git ./tools

# with ssh

git submodule add git@github.com:TangoMan75/tools.git ./tools

```

🔥 Usage

--------

Place following snippet in your code.

```bash

#!/bin/bash

CURDIR=$(dirname "$(realpath "${BASH_SOURCE[0]}")")

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/colors/colors.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/git/get_latest_release.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/git/get_latest_tag.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/network/download.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/system/check_install.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/system/check_root.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/system/check_versions.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/system/compare_versions.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/system/hosts.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/system/is_installed.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/system/is_root.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/system/is_ubuntu.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/system/prompt_user.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/system/update_grub.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/yaml/get_parameter.sh

# shellcheck source=/dev/null

. "${CURDIR}"/tools/src/yaml/set_parameter.sh

```

🤝 Contributing

---------------

Thank you for your interest in contributing to **TangoMan Bash Tools**.

Please review the [code of conduct](./CODE_OF_CONDUCT.md) and [contribution guidelines](./CONTRIBUTING.md) before starting to work on any features.

If you want to open an issue, please check first if it was not [reported already](https://github.com/TangoMan75/tools/issues) before creating a new one.

📜 License

----------

Copyrights (c) 2021 "Matthias Morin" <mat@tangoman.io>

[![License](https://img.shields.io/badge/Licence-MIT-green.svg)](LICENSE)

Distributed under the MIT license.

If you like **TangoMan Bash Tools** please star, follow or tweet:

[![GitHub stars](https://img.shields.io/github/stars/TangoMan75/tools?style=social)](https://github.com/TangoMan75/tools/stargazers)

[![GitHub followers](https://img.shields.io/github/followers/TangoMan75?style=social)](https://github.com/TangoMan75)

[![Twitter](https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Fgithub.com%2FTangoMan75%2Ftools)](https://twitter.com/intent/tweet?text=Wow:&url=https%3A%2F%2Fgithub.com%2FTangoMan75%2Ftools)

... And check my other cool projects.

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/tangoman75/tools

Awesome Lists containing this project

README