Skip to main content

A Bash beautifier for the masses.

Project description

Beautysh takes upon itself the hard task of beautifying Bash scripts (yeesh). Processing Bash scripts is not trivial, they aren’t like C or Java programs — they have a lot of ambiguous syntax, and (shudder) keywords can be used as variables. Years ago, while testing the first version of this program, I encountered this example:

done=3;echo done;done

Same name, but three distinct meanings (sigh). The Bash interpreter can sort out this perversity, but I decided not to try to recreate the Bash interpreter just to beautify a script. This means there will be some border cases this Python program won’t be able to process. But in tests with many large Linux system Bash scripts, its error-free score was roughly 99%.


Simply run

pip install beautysh

or clone the repo and install:

git clone
cd beautysh
python install


Beautysh can be called from the command line such as -f

in which case it will beautify each one of the files.

Available flags are:

Flag Short Meaning
--files -f Files to be beautified
--indent-size -i Number of spaces to be used as indentation
--backup -b Creates a backup file before beautifying

You can use - as an argument to -f and beautysh will use stdin as it’s source and stdout as it’s sink

```shell - < >

You can also call beautysh as a module: ```shell #!/usr/bin/env python # -- coding: utf-8 --

from beautysh import Beautysh

[ ... ]

result,error = Beautysh().beautify_string(source)

As written, beautysh can beautify large numbers of Bash scripts when called from … well, among other things, a Bash script:


for path in `find /path -name '*.sh'`
do -f $path

As well as the more obvious example:

    $ -f *.sh

**CAUTION**: Because Beautysh overwrites all the files submitted to
it, this could have disastrous consequences if the files include
some of the increasingly common Bash scripts that have appended
binary content (a regime where Beautysh's behavior is undefined). So
please — back up your files, and don't treat Beautysh as though it
is a harmless utility. That's only true most of the time.

Beautysh handles Bash here-docs very carefully (and there are probably some border cases it doesn’t handle). The basic idea is that the originator knew what format he wanted in the here-doc, and a beautifier shouldn’t try to outguess him. So Beautysh does all it can to pass along the here-doc content unchanged:

if true

   echo "Before here-doc"

   # Insert 2 lines in file, then save.
   #--------Begin here document-----------#
vi $TARGETFILE <<x23LimitStringx23
This is line 1 of the example file.
This is line 2 of the example file.
   #----------End here document-----------#

   echo "After here-doc"


Originally written by Paul Lutus

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for beautysh, version 3.0
Filename, size File type Python version Upload date Hashes
Filename, size beautysh-3.0.tar.gz (5.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page