pysed 0.3.0

CLI and API utility that parses and transforms text

pysed

CLI and API utility that parses and transforms text written in Python.

Pysed is a Python stream editor, is used to perform basic text transformations from a file. It reads text, line by line, from a file and replace, insert or print all text or specific area. One of the elements of distinction is the use of colors.

Read more for Regular Expression Syntax

[CHANGELOG]

Video Tutorial

Installation

$ pip install pysed

uninstall

$ pip uninstall pysed

Usage Examples

Functions:

replace(), replace text with new
append(), insert new text
lines(), print lines

How to use the module in your own python code:

>>> from pysed import replace, append, lines
>>>
>>> text = '''This is my cat,
...      whose name is Betty.
...     This is my dog,
...      whose name is Frank.
...     This is my fish,
...     whose name is George.
...     This is my goat,
...      whose name is Adam.'''
>>>
>>> result = replace(text, 'This', 'THIS')
>>>
>>> print result
THIS is my cat,
 whose name is Betty.
THIS is my dog,
 whose name is Frank.
THIS is my fish,
 whose name is George.
THIS is my goat,
 whose name is Adam.
>>>
>>> result = replace(text, 'max=2/This', 'THIS/red')
>>>
>>> print result
THIS is my cat,
 whose name is Betty.
THIS is my dog,
 whose name is Frank.
This is my fish,
 whose name is George.
This is my goat,
 whose name is Adam.
>>>
>>> result = append(text, 'max=1/cat', ' >>> /green')
>>>
>>> print result
This is my >>>cat,
 whose name is Betty.
This is my dog,
 whose name is Frank.
This is my fish,
 whose name is George.
This is my goat,
 whose name is Adam.
>>>
>>> result = replace(text, 'select=[30-100]/my', 'MY')
>>>
>>> print result
This is my cat,
 whose name is Betty.
This is MY dog,
 whose name is Frank.
This is MY fish,
whose name is George.
This is my goat,
 whose name is Adam.
>>>
>>> result = lines(text, '0,5')
>>>
>>> print result
This is my cat,
whose name is George.
>>>
>>> result = lines(text, 'step=2/*')
>>>
>>> print result
This is my cat,
This is my dog,
This is my fish,
This is my goat,

Command Line Tool Usage

usage: pysed [-h] [-v] [-p] [-l] [-r] [-i]

Utility that parses and transforms text

optional arguments:
  -h, --help     : show this help message and exit
  -v, --version  : print version and exit
  -p, --print    : print text
                   e extract/, c chars/, s sum/
  -l, --lines    : print lines
                   'N', '[N-N]', 's step=N/*, all',
                   'c count'
  -r, --replace  : replace text
                   m max=N/, u upper=*/, l lower=*/,
                   s select=[N-N]/, n lines=[N-N]/, /color
  -i, --insert   : insert text
                   m max=N/, s select=[N-N]/, n lines=[N-N]/,
                   /color

N = Number, Options/, 'Pattern'
color = black, red, green, blue, cyan, yellow, magenta, default

See changes before modification with options -p –print:

Print text file:

(NOTE: Windows users maybe avoid using quotes ‘’)

$ pysed --print text.txt

This is my cat,
 whose name is Betty.
This is my dog,
 whose name is Frank.
This is my fish,
whose name is George.
This is my goat,
 whose name is Adam.

$ pysed --print chars/'a' text.txt

find 8 --> 'a'

$ pysed --print chars/'is' text.txt

find 13 --> 'is'

$ pysed --print sum/'' text.txt

7 lines
118 characters
32 words
35 blanks

Print lines:

$ pysed --lines '0,3,2,1,4,7,6,5' text.txt

This is my cat,
 whose name is Frank.
This is my dog,
 whose name is Betty.
This is my fish,
 whose name is Adam.
This is my goat,
whose name is George.

$ pysed --lines '2,7' text.txt

This is my dog,
 whose name is Adam.

$ pysed --lines '[3-5]' text.txt

 whose name is Frank.
This is my fish,
whose name is George.

$ pysed --lines step=2/'*' text.txt

This is my cat,
This is my dog,
This is my fish,
This is my goat,

$ pysed --lines 'count' text.txt

0 <-- This is my cat,
1 <--  whose name is Betty.
2 <-- This is my dog,
3 <--  whose name is Frank.
4 <-- This is my fish,
5 <-- whose name is George.
6 <-- This is my goat,
7 <--  whose name is Adam.

Extract text:

$ pysed pysed -p extract/'is' text.txt

is is is is is is is is is is is is is

Remove new lines:

$ pysed -r --print '\n ' ' ' text.txt

This is my cat, whose name is Betty.
This is my dog, whose name is Frank.
This is my fish,
whose name is George.
This is my goat, whose name is Adam.

Redirect results to another file:

$ pysed -r --print '\n ' ' ' text.txt > text2.txt
$ cat text2.txt

This is my cat, whose name is Betty.
This is my dog, whose name is Frank.
This is my fish,
whose name is George.
This is my goat, whose name is Adam.

$ pysed -p extract/'This' text.txt > text3.txt
$ pysed --print text3.txt

This This This This

$ pysed --lines '0,2,4,6' text.txt > text4.txt
$ pysed --print text4.txt

This is my cat,
This is my dog,
This is my fish,
This is my goat,

Replace text:

$ pysed -r --print 'This' 'THIS' text.txt

THIS is my cat,
 whose name is Betty.
THIS is my dog,
 whose name is Frank.
THIS is my fish,
whose name is George.
THIS is my goat,
 whose name is Adam.

$ pysed -r --print '[a-z]' '_' text.txt

T___ __ __ ___,
 _____ ____ __ B____.
T___ __ __ ___,
 _____ ____ __ F____.
T___ __ __ ____,
_____ ____ __ G_____.
T___ __ __ ____,
 _____ ____ __ A___.

$ pysed -r --print '[a-k]' '' text.txt

Ts s my t,
 wos nm s Btty.
Ts s my o,
 wos nm s rn.
Ts s my s,
wos nm s Gor.
Ts s my ot,
 wos nm s Am.

$ pysed -r --print 'a' 'A'/green text.txt

This is my cAt,
 whose nAme is Betty.
This is my dog,
 whose nAme is FrAnk.
This is my fish,
whose nAme is George.
This is my goAt,
 whose nAme is AdAm.

Replace max:

$ pysed -r --print max=2/'This' 'THIS' text.txt

THIS is my cat,
 whose name is Betty.
THIS is my dog,
 whose name is Frank.
This is my fish,
 whose name is George.
This is my goat,
 whose name is Adam.

Select region to replace text:

$ pysed -r -p select=[16-90]/'my' 'your' text.txt

This is my cat,
 whose name is Betty.
This is your dog,
 whose name is Frank.
This is your fish,
whose name is George.
This is my goat,
 whose name is Adam.

Select lines to replace text:

$ pysed -r -p lines=[4-6]/'This' 'THIS' text.txt

This is my cat,
 whose name is Betty.
This is my dog,
 whose name is Frank.
THIS is my fish,
whose name is George.
THIS is my goat,
 whose name is Adam.

Convert text to uppercase:

$ pysed -r --print upper/'This' 'this' text.txt

THIS is my cat,
 whose name is Betty.
THIS is my dog,
 whose name is Frank.
THIS is my fish,
whose name is George.
THIS is my goat,
 whose name is Adam.

$ pysed -r --print upper=*/'' '' text.txt

THIS IS MY CAT,
 WHOSE NAME IS BETTY.
THIS IS MY DOG,
 WHOSE NAME IS FRANK.
THIS IS MY FISH,
WHOSE NAME IS GEORGE.
THIS IS MY GOAT,
 WHOSE NAME IS ADAM.

Convert text to lowercase:

$ pysed -r --print lower/'T' 'T' text.txt

this is my cat,
 whose name is Betty.
this is my dog,
 whose name is Frank.
this is my fish,
whose name is George.
this is my goat,
 whose name is Adam.

$ pysed -r --print lower=*/'' '' text.txt

this is my cat,
 whose name is betty.
this is my dog,
 whose name is frank.
this is my fish,
 whose name is george.
this is my goat,
 whose name is adam

Insert text:

$ pysed -i --print 'whose ' 'sur' text.txt

This is my cat,
 whose surname is Betty.
This is my dog,
 whose surname is Frank.
This is my fish,
 whose surname is George.
This is my goat,
 whose surname is Adam.

Add character to the beginning of each line:

$ pysed -i -p '^.' '-> ' text.txt

-> This is my cat,
 whose name is Betty.
-> This is my dog,
 whose name is Frank.
-> This is my fish,
whose name is George.
-> This is my goat,
 whose name is Adam.

Add character to the end of each line:

$ pysed -i -p '\n' ' <-' text.txt

This is my cat, <-
 whose name is Betty. <-
This is my dog, <-
 whose name is Frank. <-
This is my fish, <-
whose name is George. <-
This is my goat, <-
 whose name is Adam. <-

Insert max:

$ pysed -i --print m=2/'name' 'sur' text.txt

This is my cat,
 whose surname is Betty.
This is my dog,
 whose surname is Frank.
This is my fish,
 whose name is George.
This is my goat,
 whose name is Adam.

Select region to insert text:

$ pysed -i -p s=[20-90]/'name' 'sur' text.txt

This is my cat,
 whose surname is Betty.
This is my dog,
 whose surname is Frank.
This is my fish,
whose name is George.
This is my goat,
 whose name is Adam.

Select lines to insert text:

$ pysed -i -p lines=[4-6]/'^.' '--> ' text.txt

This is my cat,
 whose name is Betty.
This is my dog,
 whose name is Frank.
--> This is my fish,
whose name is George.
--> This is my goat,
 whose name is Adam.

Delete text:

$ pysed -r --print 'my ' '' text.txt

This is cat,
 whose name is Betty.
This is dog,
 whose name is arank.
This is fish,
whose name is George.
This is goat,
 whose name is Adam.

More features come….