dylanaraps/pure-sh-bibleArchived
Pure Sh Bible
This project is a collection of POSIX-compliant shell functions and polyfills designed to replace external binaries with portable, built-in utility implementations. It serves as a compatibility library and utility kit for shell scripting, providing shell-native alternatives to common command line utilities.
The library focuses on removing dependencies on external processes by implementing tasks directly within the shell. This includes the use of shell-native sequences for terminal user interface design, such as text coloring and cursor movement, and the use of built-in pattern matching for text processing instead of external tools.
Capabilities cover a broad range of system operations, including file system analysis, string manipulation, and numeric type validation. The project also provides utilities for key-value configuration parsing, signal handling, and native arithmetic operations.
Features
- POSIX Shell Utilities - Provides a comprehensive collection of POSIX-compliant shell utility implementations that replace external binaries.
- POSIX-Compliant Shell Scripts - Provides a collection of utilities implemented strictly using portable POSIX shell syntax.
- File and Directory Management - Analyzes file paths, directory contents, and line counts without invoking external binaries.
- Shell-Native Substitutions - Parses strings and configuration files using shell-native substitutions instead of external tools.
- Number Type Validation - Validates whether a given input value is an integer or a floating-point number.
- Shell-Native - Checks for integers, floating-point numbers, and string patterns using native shell logic.
- Glob Pattern Resolvers - Resolves directory contents and file paths using internal shell glob expansion mechanisms.
- File Content Readers - Retrieves the first few lines, counts total lines, and iterates through file contents line by line.
- Shell Built-ins - Implements native shell built-ins for arithmetic, string manipulation, and file system analysis.
- Portable Unix Utilities - Implements portable Unix shell commands that function consistently across different operating systems.
- Polyfills - Offers shell-native alternatives to external binaries to ensure maximum portability across different Unix-like environments.
- Arithmetic Operations - Performs basic addition, subtraction, multiplication, division, and bitwise logic using shell arithmetic.
- Integer Arithmetic - Provides native shell implementations of fundamental integer arithmetic and bitwise operations.
- String Manipulators - Transforms and analyzes text using shell-native pattern matching and parameter expansion.
- Path Manipulators - Implements native shell functions to extract directory and base names from paths and verify file permissions.
- Configuration Parsers - Provides a utility to extract keys and values from configuration files for simple loading.
- Terminal Escape Sequences - Implements low-level terminal control and cursor positioning using standard ANSI escape sequences.
- Execution Flow Control - Manages program execution paths using shell-native loops, signal traps, and dynamic variable naming.
- System Signal Handling - Manages process cleanup and state transitions by trapping system-level interrupt signals.
- String Manipulation Utilities - Includes native shell operations for trimming whitespace, stripping patterns, and splitting strings.
- Content Analysis - Provides built-in pattern matching to check if strings contain, start with, or end with specific substrings.
- Terminal User Interfaces - Creates interactive command-line interfaces using shell-native sequences for coloring and cursor movement.
- Technical Manuals and Guides - Collection of pure POSIX sh alternatives to external utilities.
