# niieani/bash-oo-framework

Bash Infinity is a modern standard library / framework / boilerplate for Bash

Repository: https://github.com/niieani/bash-oo-framework
Canonical: https://ross.abutalabs.com/products/bash-oo-framework
Homepage: https://github.com/niieani/bash-oo-framework/discussions
Language: Shell
License: MIT
License Family: permissive
Topics: bash, shell, framework, oop, functional-programming, boilerplate, standard-library, testing, error-handling, logging
Last push: 2023-12-15T14:25:19+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4266, "days_push": 992, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5617, forks 244 (observed 2026-08-28T04:09:23.039421+00:00)

## What it is
Bash Infinity is a standard library and boilerplate framework for writing Bash scripts, bringing concepts like OOP, try-catch exceptions, named parameters, and imports from languages like C# and JavaScript into Bash. It is modular and plug-and-play, letting scripts adopt individual features such as error handling, logging, and unit testing gradually.

## Use cases
- add try-catch error handling with stack traces to bash scripts
- write unit tests for shell scripts
- use named parameters instead of $1 $2 in bash functions
- add colorful structured logging to bash tooling
- import modules into bash scripts like require-js
- make large bash scripts more readable and maintainable

## When to choose
- you maintain substantial bash scripts and want cleaner syntax, error handling, and logging
- you want a modular standard library you can adopt feature-by-feature
- you need a unit test library for shell code

## When to avoid
- starting a major new project on the whole framework - the author recommends against it pending a 3.0 rewrite
- you need bash 3 compatibility without porting effort
- you want an actively developed project with strong test coverage

## Facets
- artifact type: framework
- maturity: maintenance
- function: error-handling, logging, testing, cli, developer-tools
- domain: developer-tools
- platform: cli, cross-platform
- tags: bash, shell, oop, standard-library, boilerplate, try-catch, exceptions, named-parameters, unit-testing, command-line, automation, linux, macos

## Member repositories
- niieani/bash-oo-framework (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:23.039421+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:55:24.488961+00:00, confidence not recorded.
  - readme: https://github.com/niieani/bash-oo-framework (fetched 2026-08-28T04:09:23.039421+00:00, sha 464e8c558a4f)
  - homepage: https://github.com/niieani/bash-oo-framework/discussions (fetched 2026-08-29T08:50:06.118086+00:00, sha 6f29837a34e7)
- Data as of 2026-08-30T08:39:29.467469+00:00.