py-pepe 0.0.5

Description:

pypepe 0.0.5

py-pepe
Super simple pipeline helper on Python. Works like awk but easier to remember (and also less posibilities...).
PEPE can work in 2 different ways:
1. As python module
Don't remember awk commands? Not a problem! Just insert python script here and read result of previous
command using pepe.read(). Additionally, you can select N column (like column 6 in example):
# Show max usage RAM from process
ps ux | python -c "import pepe; x=pepe.read(6); print(max(x[1:]))"

2. As CLI
Don't want to call python scripts like that? We got you a CLI tool too!
CLI interface totally mimics python functions usage:
# Show total RAM usage of Visual Studio Code process
ps ux | grep "Visual Studio Code" | pepe sum 6

Here you add pepe sum 6 in pipe. That's identical to import pepe; pepe.sum(6). Same args and same positions.
That's why if you want to sort lines as numbers, you need to add 0 positional arg: pepe sort 0 true,
because that's identical to pepe.sort(0, True).
CLI doesn't have any flags, only positional args. That's for simplicity.
Installation
pip install py-pepe

Functions/Example of usage
help
To show help just call pepe command in terminal.
Also on each error in input you probably will see pepe help.
pepe.read
Python-code only function (no cli). Reads all stdin and returns list of lines.
NOTE: This is the only function in pepe that returns a value. All other function just print their results.
Optional positional params:
- <column> - select only N column
# Show max usage RAM from process
ps ux | python -c "import pepe; x=pepe.read(6); print(max(x[1:]))"

pepe.out
Display result. Works like cat or echo, but can select column.
Optional positional params:
- <column> - select only N column
# Display only 1 column of ps ux
ps ux | head -n 10 | pepe out 1

# Same, but using python code
ps ux | head -n 10 | python -c "import pepe; pepe.out(1)"

# Without pepe
ps ux | head -n 10 | awk '{ print $1 }'

pepe.sum
Command sum allows to sum lines as numbers.
Optional positional params:
- <column> - select only N column
Let's count RAM usage of all VSCode processes (on mac). Column 6 of "ps ux" output contains info about RAM:
# Select column 6 and sum
ps ux | grep "Visual Studio Code" | pepe sum 6

# Select column 6 using awk and sum all lines
ps ux | grep "Visual Studio Code" | awk '{ print $6 }' | pepe sum

# Same, but using python code
ps ux | grep "Visual Studio Code" | python -c "import pepe; pepe.sum(6)"

# Without pepe
ps ux | grep "Visual Studio Code" | awk '{sum+=$6} END {print sum}'

pepe.sort
pepe.min
pepe.max
pepe.size
pepe.count