amoffat/sh
Sh
sh is a Python process management library that provides programmatic wrappers and interfaces for controlling Unix system commands and child process lifecycles. It functions as an asynchronous process wrapper, allowing shell commands and system programs to run within a non-blocking event loop.
The library maps command-line arguments and standard input/output streams to native Python functions and objects. It includes a process lifecycle controller to manage signal groups, execution timeouts, and process permissions for spawned child processes.
The project provides capabilities for executable file lookup, I/O redirection via pipes and buffers, and execution context configuration to maintain shared environment variables and working directories across multiple commands. It also includes security controls for specifying user IDs and managing file descriptor inheritance.
Features
- Programmatic Command Wrappers - Maps Unix system program calls to native Python functions, translating command-line arguments and I/O streams into programmatic interfaces.
- Process Lifecycle Managers - Manages signal groups, execution timeouts, and process permissions for spawned child processes.
- Process Lifecycle Management - Manages how tasks start, stop, and terminate via process group signals and execution timeouts.
- Subprocess Management Libraries - Provides a high-level Python interface for executing and controlling external system processes with advanced lifecycle and timeout handling.
- Asynchronous Event Loops - Implements a non-blocking event loop to execute system processes without freezing the main Python thread.
- Asynchronous Process Wrappers - Provides a non-blocking execution layer for running shell commands within a Python event loop.
- Process Management Libraries - Provides a programmatic Python interface for launching and controlling system processes as an alternative to manual subprocess calls.
- Asynchronous Execution - Executes system processes using a non-blocking event loop to maintain main thread responsiveness.
- Command Execution Contexts - Provides reusable context objects to maintain shared environment variables and working directories across multiple system commands.
- Execution Context Management - Stores common arguments, environment variables, and working directories in a reusable context.
- System Command Interfaces - Provides an interface mapping command-line arguments and I/O streams to native Python objects.
- Shell Automation - Automates sequences of system commands by managing shared environments, working directories, and I/O pipes.
- I/O Redirections - Captures and routes standard input and output streams using system pipes and buffers.
- System Program Interfaces - Provides a programmatic interface for invoking Unix system programs and mapping their command-line arguments to native constructs.
- Process Signal Management - Sends signals to entire process groups to ensure synchronized termination of spawned tasks.
- DevOps Tools - Listed in the “DevOps Tools” section of the Awesome Python awesome list.
- Infrastructure and Cloud - Subprocess replacement for shell-like commands.
- Process Management - Simplifies launching and interacting with system subprocesses.
