An open API service indexing awesome lists of open source software.

https://github.com/fchastanet/bash-tools-framework


https://github.com/fchastanet/bash-tools-framework

bash bash-script framework

Last synced: 14 days ago
JSON representation

Awesome Lists containing this project

README

          

# bash-tools-framework

> **_NOTE:_** **Documentation is best viewed on
> [https://bash-tools-framework.devlab.top](https://bash-tools-framework.devlab.top/)**

[![GitHub release (latest SemVer)](https://img.shields.io/github/release/fchastanet/bash-tools-framework?logo=github&sort=semver)](https://github.com/fchastanet/bash-tools-framework/releases)
[![GitHub license](https://img.shields.io/github/license/Naereen/StrapDown.js.svg)](https://github.com/fchastanet/bash-tools-framework/blob/master/LICENSE)
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)
[![CI/CD](https://github.com/fchastanet/bash-tools-framework/actions/workflows/main.yml/badge.svg)](https://github.com/fchastanet/bash-tools-framework/actions/workflows/main.yml?query=branch%3Amaster)
[![Project status](https://opensource.box.com/badges/active.svg)](https://opensource.box.com/badges "Project status")
[![DeepSource](https://deepsource.io/gh/fchastanet/bash-tools-framework.svg/?label=active+issues&show_trend=true)](https://deepsource.io/gh/fchastanet/bash-tools-framework/?ref=repository-badge)
[![DeepSource](https://deepsource.io/gh/fchastanet/bash-tools-framework.svg/?label=resolved+issues&show_trend=true)](https://deepsource.io/gh/fchastanet/bash-tools-framework/?ref=repository-badge)
[![Average time to resolve an issue](https://isitmaintained.com/badge/resolution/fchastanet/bash-tools-framework.svg)](https://isitmaintained.com/project/fchastanet/bash-tools-framework "Average time to resolve an issue")
[![Percentage of issues still open](https://isitmaintained.com/badge/open/fchastanet/bash-tools-framework.svg)](https://isitmaintained.com/project/fchastanet/bash-tools-framework "Percentage of issues still open")

- [1. Key Features](#1-key-features)
- [2. Quick Links](#2-quick-links)
- [3. Related Projects](#3-related-projects)
- [4. Acknowledgements](#4-acknowledgements)

Welcome to the Bash Tools Framework documentation. This framework provides a comprehensive collection of bash functions
and commands that help you lint files, generate shell documentation, compile bash files, and much more.

> **_TIP:_** Checkout related projects of this suite
>
> - [My documents](https://devlab.top/)
> - **[Bash Tools Framework](https://bash-tools-framework.devlab.top/)**
> - [Bash Tools](https://bash-tools.devlab.top/)
> - [Bash Dev Env](https://bash-dev-env.devlab.top/)
> - [Bash Compiler](https://bash-compiler.devlab.top/)

## 1. Key Features

- **150+ Unit-Tested Functions**: Organized by namespace (Array, File, Git, Docker, Database, etc.)
- **Custom Bash Compiler**: Generate standalone executables from YAML definitions
- **Extensive Testing**: Multi-version Bash testing (4.4, 5.0, 5.3 on Ubuntu and Alpine)
- **Build Tools**: Linting and testing infrastructure with pre-commit hooks

## 2. Quick Links

- [Framework Guides](https://bash-tools-framework.devlab.top/docs/guides/) - Learn about framework features
- [Commands](https://bash-tools-framework.devlab.top/docs/commands/) - Available command-line tools
- [Framework Documentation](https://bash-tools-framework.devlab.top/docs/framework-overview/) - Complete function
reference
- [Best Practices](https://bash-tools-framework.devlab.top/docs/guides/best-practices/) - Bash development best
practices
- [Pre-commit Hooks](https://bash-tools-framework.devlab.top/docs/pre-commit-hooks/) - Available pre-commit hooks

## 3. Related Projects

This framework is part of a suite of projects:

- [My Documents](https://devlab.top/)
- [Bash Tools](https://bash-tools.devlab.top/)
- [Bash Dev Env](https://bash-dev-env.devlab.top/)
- [Bash Compiler](https://bash-compiler.devlab.top/)

## 4. Acknowledgements

Like so many projects, this effort has roots in many places.

I would like to thank particularly Bazyli Brzóska for his work on the project
[Bash Infinity](https://github.com/niieani/bash-oo-framework). Framework part of this project is largely inspired by his
work(some parts copied). You can see his [blog](https://invent.life/project/bash-infinity-framework) too that is really
interesting