Movatterモバイル変換

4.4.3 Differ Objects

Note thatDiffer-generated deltas make no claim to beminimal diffs. To the contrary, minimal diffs are oftencounter-intuitive, because they synch up anywhere possible, sometimesaccidental matches 100 pages apart. Restricting synch points tocontiguous matches preserves some notion of locality, at theoccasional cost of producing a longer diff.

TheDiffer class has this constructor:

class Differ( [linejunk[, charjunk]])

Optional keyword parameterslinejunk andcharjunk are for filter functions (orNone):

linejunk: A function that accepts a single string argument, and returns true if the string is junk. The default isNone, meaning that no line is considered junk.

charjunk: A function that accepts a single character argument (a string of length 1), and returns true if the character is junk. The default isNone, meaning that no character is considered junk.

Differ objects are used (deltas generated) via a singlemethod:

compare( a, b): Compare two sequences of lines, and generate the delta (a sequence of lines).
Each sequence must contain individual single-line strings ending with newlines. Such sequences can be obtained from thereadlines() method of file-like objects. The delta generated also consists of newline-terminated strings, ready to be printed as-is via thewritelines() method of a file-like object.

Release 2.5.2, documentation updated on 21st February, 2008.

SeeAbout this document... for information on suggesting changes.

[8]ページ先頭