pscfpp.text.FileEditor Class Reference

Class to substitute text in one or more files. More...

Public Member Functions
def	__init__ (self)
	Constructor. More...
def	setFilter (self, filter)
	Set the filter string. More...
def	setOld (self, old)
	Set the old string (the string to be replaced) More...
def	setNew (self, new)
	Set the new string (the replacement string) More...
def	setIsTest (self, isTest)
	Set the isTest boolean flag. More...
def	setBlockSize (self, blockSize)
	Set the blockSize attribute. More...
def	editFile (self, filename)
	Edit a single file - edits confined to individual lines. More...
def	editFileBlocks (self, filename)
	Edit a single file - edits may span several lines. More...
def	editFiles (self, dirName, pattern)
	Edit all files in specified directory that matches a pattern. More...

Detailed Description

Class to substitute text in one or more files.

String attributes:

• filter : a regex used to filter lines for possible editing
• old : a regex pattern that should be replaced in lines
• new : the string that should replace the old string

The editFile method checks each line in a specified file to see if it contains a string that matches the regular expression defined by the filter attribute. If a line matches the filter expression, it search for substrings that match the regular expression defined by the "old" attribute, and replaces each occurence by the string given by the "new" attribute.

The editFiles method applies the editFile method to every file in a specified directory tree with a name that matches a specified filename pattern.

Definition at line 347 of file text.py.

Constructor & Destructor Documentation

__init__()

def pscfpp.text.FileEditor.__init__

(

self

)

Constructor.

Definition at line 352 of file text.py.

References pscfpp.text.FileEditor.blockSize, pscfpp.text.RecordEditor.hasFilter, pscfpp.text.FileEditor.hasFilter, pscfpp.text.RecordEditor.hasNew, pscfpp.text.FileEditor.hasNew, pscfpp.text.FileEditor.hasOld, pscfpp.text.RecordEditor.isReady, pscfpp.text.FileEditor.isReady, Pscf::PropagatorTmpl< Propagator >.isReady(), Pscf::PropagatorTmpl< TP >.isReady(), Pscf::PropagatorTmpl< Propagator< D > >.isReady(), pscfpp.make.MakeMaker.isTest, pscfpp.text.RecordEditor.isTest, and pscfpp.text.FileEditor.isTest.

Member Function Documentation

setFilter()

def pscfpp.text.FileEditor.setFilter	(		self,
			filter
	)

Set the filter string.

Set the regular expression used to identify lines for possible modification - lines that match the filter are checked for a sub-string that matches the "old" string.

Parameters

filter

the new "filter" string

Definition at line 369 of file text.py.

References pscfpp.text.RecordEditor.filter, pscfpp.text.FileEditor.filter, pscfpp.text.RecordEditor.hasFilter, pscfpp.text.FileEditor.hasFilter, pscfpp.text.RecordEditor.hasNew, pscfpp.text.FileEditor.hasNew, pscfpp.text.FileEditor.hasOld, pscfpp.text.RecordEditor.isReady, pscfpp.text.FileEditor.isReady, Pscf::PropagatorTmpl< Propagator >.isReady(), Pscf::PropagatorTmpl< TP >.isReady(), and Pscf::PropagatorTmpl< Propagator< D > >.isReady().

setOld()

def pscfpp.text.FileEditor.setOld	(		self,
			old
	)

Set the old string (the string to be replaced)

The "old" string is replaced by the "new" string in lines that match the "filter" string.

Parameters

old	the "old" string, to be replaced

Definition at line 383 of file text.py.

References pscfpp.text.RecordEditor.hasFilter, pscfpp.text.FileEditor.hasFilter, pscfpp.text.RecordEditor.hasNew, pscfpp.text.FileEditor.hasNew, pscfpp.text.FileEditor.hasOld, pscfpp.text.RecordEditor.isReady, pscfpp.text.FileEditor.isReady, Pscf::PropagatorTmpl< Propagator >.isReady(), Pscf::PropagatorTmpl< TP >.isReady(), Pscf::PropagatorTmpl< Propagator< D > >.isReady(), and pscfpp.text.FileEditor.old.

setNew()

def pscfpp.text.FileEditor.setNew	(		self,
			new
	)

Set the new string (the replacement string)

Parameters

new	the "new" string that replaces the old string

Definition at line 394 of file text.py.

References pscfpp.text.RecordEditor.hasFilter, pscfpp.text.FileEditor.hasFilter, pscfpp.text.RecordEditor.hasNew, pscfpp.text.FileEditor.hasNew, pscfpp.text.FileEditor.hasOld, pscfpp.text.RecordEditor.isReady, pscfpp.text.FileEditor.isReady, Pscf::PropagatorTmpl< Propagator >.isReady(), Pscf::PropagatorTmpl< TP >.isReady(), Pscf::PropagatorTmpl< Propagator< D > >.isReady(), pscfpp.text.RecordEditor.new, and pscfpp.text.FileEditor.new.

setIsTest()

def pscfpp.text.FileEditor.setIsTest	(		self,
			isTest
	)

Set the isTest boolean flag.

If isTest is true, the edit functions only perform a dry run in which they report what changes would be made if isTest were false.

Parameters

isTest

perform a dry run (no changes) if true (boolean)

Definition at line 409 of file text.py.

References pscfpp.make.MakeMaker.isTest, pscfpp.text.RecordEditor.isTest, and pscfpp.text.FileEditor.isTest.

setBlockSize()

def pscfpp.text.FileEditor.setBlockSize	(		self,
			blockSize
	)

Set the blockSize attribute.

Parameters

blockSize

number of lines in block for editFileBlock

Definition at line 417 of file text.py.

References pscfpp.text.FileEditor.blockSize.

editFile()

def pscfpp.text.FileEditor.editFile	(		self,
			filename
	)

Edit a single file - edits confined to individual lines.

Parameters

filename

name of file to be edited

Definition at line 425 of file text.py.

References pscfpp.text.RecordEditor.filter, pscfpp.text.FileEditor.filter, pscfpp.text.RecordEditor.isReady, pscfpp.text.FileEditor.isReady, Pscf::PropagatorTmpl< Propagator >.isReady(), Pscf::PropagatorTmpl< Propagator< D > >.isReady(), Pscf::PropagatorTmpl< TP >.isReady(), pscfpp.make.MakeMaker.isTest, pscfpp.text.RecordEditor.isTest, pscfpp.text.FileEditor.isTest, pscfpp.text.RecordEditor.new, pscfpp.text.FileEditor.new, and pscfpp.text.FileEditor.old.

editFileBlocks()

def pscfpp.text.FileEditor.editFileBlocks	(		self,
			filename
	)

Edit a single file - edits may span several lines.

Parameters

filename

name of file to be edited

Definition at line 457 of file text.py.

References pscfpp.text.FileEditor.blockSize, pscfpp.text.RecordEditor.filter, pscfpp.text.FileEditor.filter, pscfpp.text.RecordEditor.isReady, pscfpp.text.FileEditor.isReady, Pscf::PropagatorTmpl< Propagator >.isReady(), Pscf::PropagatorTmpl< Propagator< D > >.isReady(), Pscf::PropagatorTmpl< TP >.isReady(), pscfpp.make.MakeMaker.isTest, pscfpp.text.RecordEditor.isTest, pscfpp.text.FileEditor.isTest, pscfpp.text.RecordEditor.new, pscfpp.text.FileEditor.new, and pscfpp.text.FileEditor.old.

Referenced by pscfpp.text.FileEditor.editFiles().

editFiles()

def pscfpp.text.FileEditor.editFiles	(		self,
			dirName,
			pattern
	)

Edit all files in specified directory that matches a pattern.

Parameters

dirName	name of directory (string)
pattern	filename pattern (string)

Definition at line 498 of file text.py.

References pscfpp.text.FileEditor.editFileBlocks(), pscfpp.text.RecordEditor.isReady, pscfpp.text.FileEditor.isReady, Pscf::PropagatorTmpl< Propagator< D > >.isReady(), Pscf::PropagatorTmpl< Propagator >.isReady(), and Pscf::PropagatorTmpl< TP >.isReady().

---

The documentation for this class was generated from the following file:

• text.py