Metadata-Version: 2.1
Name: sedsed
Version: 2.0.0
Summary: Debugger and code formatter for sed scripts
Home-page: https://aurelio.net/projects/sedsed/
Author: Aurelio Jargas
Author-email: aurelio@aurelio.net
License: GPLv3
Project-URL: Bug Tracker, https://github.com/aureliojargas/sedsed/issues
Project-URL: Source Code, https://github.com/aureliojargas/sedsed
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Description-Content-Type: text/markdown
License-File: LICENSE

# sedsed

Debugger and code formatter for sed scripts, by Aurelio Jargas.

Website: https://aurelio.net/projects/sedsed/


## Download / Install

Sedsed is available as a pip package, just install it:

    pip install --user sedsed

- Compatible with Python 2.7 and Python 3.x
- License: GPLv3
- [Released versions](https://github.com/aureliojargas/sedsed/releases)
- [CHANGELOG.md](https://github.com/aureliojargas/sedsed/blob/master/CHANGELOG.md) for the list of changes in each version

> Alternative: sedsed is a single file application, so you can also just download and run [sedsed.py](https://raw.githubusercontent.com/aureliojargas/sedsed/master/sedsed.py). Note that you'll also need to download its only external requirement, [sedparse.py](https://raw.githubusercontent.com/aureliojargas/sedparse/master/sedparse.py).


## Code formatting for sed scripts

Sedsed can turn cryptic oneliners into readable indented code:

```console
$ sedsed --indent ':a;s/<[^>]*>//g;/</{N;ba;}'
:a
s/<[^>]*>//g
/</ {
    N
    b a
}
```

Convert your script to HTML to get code formatting, beautiful syntax highlighting and clickable links for GOTO commands (`b` and `t`).

```console
$ sedsed --htmlize -f myscript.sed > myscript.html
```

See many examples of HTML-converted scripts in http://sed.sourceforge.net/local/scripts/


## Debugging sed scripts

Sedsed allows you to debug your sed scripts. It inserts extra sed commands into the script and uses the system's sed to execute the modified script.

The added commands won't affect the script's original logic, but will show debug information while sed is running the script: the current command is printed, as well as the contents of both `PATTERN SPACE` and `HOLD SPACE` buffers, before and after every command.

With that information at hand, you can see how sed operates under the curtains.

For example, compare the normal sed run and the sedsed debug run for a script to reverse the line order (similar to Unix `tac`):

```
$ echo -e 'A\nB\nC' | sed '1!G;h;$!d'
C
B
A
```

```
$ echo -e 'A\nB\nC' | sedsed --debug '1!G;h;$!d'
PATT:A$
HOLD:$
COMM:1 !G
PATT:A$
HOLD:$
COMM:h
PATT:A$
HOLD:A$
COMM:$ !d
PATT:B$
HOLD:A$
COMM:1 !G
PATT:B\nA$
HOLD:A$
COMM:h
PATT:B\nA$
HOLD:B\nA$
COMM:$ !d
PATT:C$
HOLD:B\nA$
COMM:1 !G
PATT:C\nB\nA$
HOLD:B\nA$
COMM:h
PATT:C\nB\nA$
HOLD:C\nB\nA$
COMM:$ !d
PATT:C\nB\nA$
HOLD:C\nB\nA$
C
B
A
```

The input is three lines A, B and C, and the output is those three lines reversed: C, B, A. You can see how the sed buffers (`PATT` and `HOLD`) changed after every command (`COMM`).

Another example, a script to remove all HTML tags. It even removes tags that span in multiple lines.

```
$ cat menu.html
<a
   class="menu"
   href="index.html">Home</a>
```

```
$ cat menu.html | sed -e ':a;s/<[^>]*>//g;/</{N;ba;}'
Home
```

```
$ cat menu.html | sedsed --debug --hide=hold -e ':a;s/<[^>]*>//g;/</{N;ba;}'
PATT:<a$
COMM::a
COMM:s/<[^>]*>//g
PATT:<a$
COMM:/</ {
COMM:N
PATT:<a\n   class="menu"$
COMM:b a
COMM:s/<[^>]*>//g
PATT:<a\n   class="menu"$
COMM:/</ {
COMM:N
PATT:<a\n   class="menu"\n   href="index.html">Home</a>$
COMM:b a
COMM:s/<[^>]*>//g
PATT:Home$
COMM:/</ {
PATT:Home$
Home
```

You can see in the `PATT` lines how the multiline `<a>` tag is accumulated before the `s` command can remove the whole tag at once, leaving only its contents: `Home`.

Note that the `--hide=hold` option was used to avoid showing the contents of the `HOLD SPACE` buffer. It would be empty all the way, since this script does not use that extra buffer. You can also hide the `PATT` and `COMM` lines, if necessary.

For tricky scripts, sometimes it helps to only see the contents of the `PATTERN SPACE` buffer changing, so you can get a sense of how it is manipulated during execution. Using `--hide=hold,comm` you can achieve that. The next example uses that to show how ABC turned into CBA in this nice script to reverse strings (similar to Unix `rev`):

```
$ echo ABC | sedsed --debug --hide=hold,comm \
    -e '/\n/!G;s/\(.\)\(.*\n\)/&\2\1/;//D;s/.//' | uniq
PATT:ABC$
PATT:ABC\n$
PATT:ABC\nBC\nA$
PATT:BC\nA$
PATT:BC\nC\nBA$
PATT:C\nBA$
PATT:C\n\nCBA$
PATT:\nCBA$
PATT:CBA$
CBA
```

In those examples the sed script was informed as an argument using the `-e` option. Sedsed also supports the `-f` option to inform a sed script file, and the traditional `-n` option to run in quiet mode.

Enjoy!
