NAME

       pyp - The Pyed Piper: A Modern Python Alternative to awk, sed and Other Unix Text Manipulation Utilities

SYNOPSIS

       pyp [options] files ...

DESCRIPTION

       pyp,  the  Pyed  Piper,  is  a  command  line tool for text manipulation. It is similar to awk and sed in
       functionality, but its subcommands are Python based, and thus more familiar to many programmers.

       It can operate both on a per-line base and on the complete  input  stream.   Different  features  can  be
       pipelined in a single command by using the pipe character familiar from shell commands.

       pyp  backs  up  its  input  for  reruns  with  modified commands, and can save commands as macros. On the
       downside, the rerun feature makes it unsuitable for continuous pipe operation.

OPTIONS

       These programs follow the usual GNU command line syntax, with  long  options  starting  with  two  dashes
       (`-').  A summary of options is included below.  For a complete description, use --manual.

       -h, --help
              Show this help message and exit.

       -m, --manual
              Prints out extended help.

       -l, --macro_list
              Lists all available macros.

       -s MACRO_SAVE_NAME, --macro_save=MACRO_SAVE_NAME
              Saves current command as macro. use "#" for adding
              comments  EXAMPLE:
              pyp -s "great_macro # prints first letter" "p[1]".

       -f MACRO_FIND_NAME, --macro_find=MACRO_FIND_NAME
              Searches for macros with keyword or user name.

       -d MACRO_DELETE_NAME, --macro_delete=MACRO_DELETE_NAME
              Deletes specified public macro.

       -g, --macro_group
              Specify group macros for save and delete; default is user.

       -t TEXT_FILE, --text_file=TEXT_FILE
              Specify text file to load. For advanced users,
              you should typically cat a file into pyp.

       -x, --execute
              Execute all commands.

       -c, --turn_off_color
              Prints raw, uncolored output.

       -u, --unmodified_config
              Prints out generic PypCustom.py config file.

       -b BLANK_INPUTS, --blank_inputs=BLANK_INPUTS
              Generate this number of blank input lines; useful for
              generating numbered lists with variable 'n'.

       -n, --no_input
              Use with command that generates output with no input;
              same as --dummy_input 1.

       -k, --keep_false
              Print blank lines for lines that test as False.
              default is to filter out False lines from the output.

       -r, --rerun
              Rerun based on automatically cached data from the last run.
              Use this after executing "pyp", pasting input into the shell,
              and hitting CTRL-D.

SEE ALSO

       awk(1), grep(1), sed(1).

AUTHOR

       pyp was written by Toby Rosen <tobyrosen@gmail.com>.

       This  manual  page was written by Khalid El Fathi <khalid@elfathi.fr>, for the Debian project (and may be
       used by others).

                                                 March 19, 2012                                           PYP(1)