Registry / devops / beautysh

beautysh

JSON →
library6.4.3pypypi✓ verified 83d ago

A bash beautifier for the masses, providing automated formatting and indentation of shell scripts. Current version is 6.4.3, with regular releases to fix bugs and update dependencies.

pip install beautysh
INSTALL
IMPORT
SIG · BEAUTYSH
B
beautysh
devopspythonv6.4.3
Install
1.7s avg
Import
Disk
16MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v6.4.3 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 18.4MB
glibc
py 3.103.95 runs
installs and imports cleanly · install 1.7s · import 0.000s · 19MB
16MB installed
● package 16MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

BeautyshCLI
from beautysh import BeautyshCLI
from beautysh import beautysh
BeautyshConfig
from beautysh import BeautyshConfig
from beautysh import beautysh
BashFormatter
from beautysh import BashFormatter
from beautysh import beautysh

Basic usage: format a bash script file using beautysh.

from beautysh import beautysh import tempfile, os code = '''if [ -z "$1" ]; then echo "No argument" fi''' with tempfile.NamedTemporaryFile(mode='w', suffix='.sh', delete=False) as f: f.write(code) fname = f.name try: result = beautysh(files=[fname]) print('Formatted successfully') finally: os.unlink(fname)
beautysh --version
Debug
Known issues
gotchabeautysh modifies files in-place by default. Ensure you have backups or use the --check flag before formatting.
fix
Use beautysh with --check to only verify formatting, or pass --force to overwrite.
affects: all
gotchabeautysh may not correctly handle shell scripts with unusual syntax (e.g., heredocs with special characters, complex case patterns). Test on your codebase before integrating.
fix
Review changed lines after formatting, especially around heredocs and case statements.
affects: all
Upgrade
Version history
6.4.3latest on PyPI · released Mar 12, 2026
Audit
Dependencies

No dependency data recorded yet.

Agent activity
11 hits · last 30 days
node
10
Resources
beautysh — pip install beautysh · libregistry