niieani/bash-oo-framework
Bash Oo Framework
This project is a collection of specialized shell frameworks that provide object-oriented programming patterns, unit testing tools, and a standard utility library for Bash scripts. It enables the organization of script logic through the implementation of classes, objects, and singleton design patterns to create modular and reusable components.
The framework includes a dedicated exception handling library that captures command failures using try-catch blocks and stores error metadata in objects. It also provides a unit testing framework that executes shell commands as independent test cases and monitors exit codes to detect failures.
Additional capabilities cover application log management with severity-based stream routing and terminal user interface formatting for applying colors and symbols to console output. The standard library also includes tools for manipulating complex data types, such as arrays, strings, and numbers.
Features
- OO Pattern Implementations - Enables the organization of script logic through the implementation of classes, objects, and singleton design patterns.
- Object-Oriented Programming - Implements object-oriented programming patterns and classes within Bash shell scripts for modularity.
- Object-Oriented Scripting - Provides a framework for implementing object-oriented programming patterns and classes within Bash scripts.
- Exception-Based Error Handling - Intercepts shell command failures using signal traps to simulate try-catch error handling blocks.
- Shell Exception Libraries - Provides a dedicated system for capturing command failures and storing error metadata in objects.
- Shell Standard Libraries - Provides a comprehensive collection of reusable functions for handling complex data types and system logging.
- Object Simulation Namespaces - Simulates object-oriented behavior using variable prefixing and namespaces to organize related data and functions.
- Bash Script Testing - Executes shell commands as independent test cases to identify failures through exit code monitoring.
- Unit Testing Frameworks - Provides a framework for executing shell commands as independent test cases and monitoring exit codes.
- Dynamic Method Invocation - Implements the process of resolving method names at runtime to execute specific shell functions.
- Shell Expression Evaluators - Provides a mechanism to determine object properties by evaluating strings as expressions in the shell.
- Shell Data Type Manipulators - Provides a set of specialized methods for processing strings, numbers, and arrays, including regex matching.
- Dynamic State Variables - Tracks object properties and class instances by storing state in dynamically named global shell variables.
- Application Log Routing - Routes system messages to different output streams based on severity levels for better debugging.
- Category-Based Log Routing - Redirects log entries to different file descriptors based on severity levels to separate output streams.
- Console Output Formatting - Applies colors and symbols to terminal text with automatic fallbacks for environments without visual support.
- Terminal Output Formatting - Applies colors and symbols to console output with automatic fallbacks for restricted environments.
- Shell Script Development - Object-oriented boilerplate and standard library for shell.
