Summary: A stream editor
Author: Frederic Rentsch
License: Open source for authorship credit
Platform: Any ( pure Python )
Description: A Python stream editor with these characteristics:
1. Does any (practical) number of search-and-replaces in one pass.
2. Does any (practical) number of passes in one run.
3. Handles all 256 octets.
4. Does regular expressions.
5. Notational conveniences.
6. Compiles substitution sets defined in the form of a string.
7. Compiles substitution sets edited and kept in text files.
8. Naming a file in a definition string inserts the file's contents in
the place of its name, making for a modular building-block system.
9. Naming files is recursive. Files may pull in other files.
10. Constructor compiles definitions into an Editor object that will
translate any input.
11. Accepts input as string, file object or file by name. Outputs any of
these types, matching type by default.
12. Overwrite-safe. In-place edits switch name only and keep original data
with a backup extension.
13. Method set () to change runtime parameters.
14. Method show () for object inspection.
15. Methods save (), add (), drop () and reverse () for interactive edits.
16. Optional retention and display of intermediate data with chained passes.
17. Method show_log () displays a list of accumulated glitches and potential
glitches, mainly about IO operations.
18. A Light version (SEL) without interaction except for set () and
19. Method se.SEL () returns a light version of se. Constructor SE.SE (sel)
takes a Light editor object instead of substitutions and makes an
interactive one from it.
20. An extensive manual: SE-DOC.HTM.
21. An example definition file: htm2iso.se. Converts htm-ampersand escapes
22. A demo script walking through the examples in SE-DOC.HTM.
23. FORMEX.py: A derivation for editing complex arithmetic formulas
interactively in any order and executing them.
TODO: Brief introduction on what you do with files - including link to relevant help section.