← Back
Editing: text_file.cpython-33.pyc
� �� f�0 c @ sA d Z d d l Z d d l Z d d l Z Gd d � d � Z d S( u� text_file provides the TextFile class, which gives an interface to text files that (optionally) takes care of stripping comments, ignoring blank lines, and joining lines with backslashes.i Nc B s� | Ee Z d Z d Z i d d 6d d 6d d 6d d 6d d 6d d 6d d 6Z d d d d � Z d d � Z d d � Z d d d � Z d d d � Z d d d � Z d d � Z d d � Z d d � Z d S( u TextFileu� Provides a file-like object that takes care of all the things you commonly want to do when processing a text file that has some line-by-line syntax: strip comments (as long as "#" is your comment character), skip blank lines, join adjacent lines by escaping the newline (ie. backslash at end of line), strip leading and/or trailing whitespace. All of these are optional and independently controllable. Provides a 'warn()' method so you can generate warning messages that report physical line number, even if the logical line in question spans multiple physical lines. Also provides 'unreadline()' for implementing line-at-a-time lookahead. Constructor is called as: TextFile (filename=None, file=None, **options) It bombs (RuntimeError) if both 'filename' and 'file' are None; 'filename' should be a string, and 'file' a file object (or something that provides 'readline()' and 'close()' methods). It is recommended that you supply at least 'filename', so that TextFile can include it in warning messages. If 'file' is not supplied, TextFile creates its own using 'io.open()'. The options are all boolean, and affect the value returned by 'readline()': strip_comments [default: true] strip from "#" to end-of-line, as well as any whitespace leading up to the "#" -- unless it is escaped by a backslash lstrip_ws [default: false] strip leading whitespace from each line before returning it rstrip_ws [default: true] strip trailing whitespace (including line terminator!) from each line before returning it skip_blanks [default: true} skip lines that are empty *after* stripping comments and whitespace. (If both lstrip_ws and rstrip_ws are false, then some lines may consist of solely whitespace: these will *not* be skipped, even if 'skip_blanks' is true.) join_lines [default: false] if a backslash is the last non-newline character on a line after stripping comments and whitespace, join the following line to it to form one "logical line"; if N consecutive lines end with a backslash, then N+1 physical lines will be joined to form one logical line. collapse_join [default: false] strip leading whitespace from lines that are joined to their predecessor; only matters if (join_lines and not lstrip_ws) errors [default: 'strict'] error handler used to decode the file content Note that since 'rstrip_ws' can strip the trailing newline, the semantics of 'readline()' must differ from those of the builtin file object's 'readline()' method! In particular, 'readline()' returns None for end-of-file: an empty string might just be a blank line (or an all-whitespace line), if 'rstrip_ws' is true but 'skip_blanks' is not.i u strip_commentsu skip_blanksi u lstrip_wsu rstrip_wsu join_linesu collapse_joinu strictu errorsc K s� | d k r' | d k r' t d � � n xQ | j j � D]@ } | | k r` t | | | | � q7 t | | | j | � q7 Wx6 | j � D]( } | | j k r� t d | � � q� q� W| d k r� | j | � n | | _ | | _ d | _ g | _ d S( u� Construct a new TextFile object. At least one of 'filename' (a string) and 'file' (a file-like object) must be supplied. They keyword argument options are described above and affect the values returned by 'readline()'.u7 you must supply either or both of 'filename' and 'file'u invalid TextFile option '%s'i N( u Noneu RuntimeErroru default_optionsu keysu setattru KeyErroru openu filenameu fileu current_lineu linebuf( u selfu filenameu fileu optionsu opt( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu __init__N s u TextFile.__init__c C s7 | | _ t j | j d d | j �| _ d | _ d S( uy Open a new file named 'filename'. This overrides both the 'filename' and 'file' arguments to the constructor.u ru errorsi N( u filenameu iou openu errorsu fileu current_line( u selfu filename( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu openo s !u TextFile.openc C s, | j j � d | _ d | _ d | _ d S( ui Close the current file and forget everything we know about it (filename, current line number).N( u fileu closeu Noneu filenameu current_line( u self( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu closev s u TextFile.closec C s� g } | d k r | j } n | j | j d � t | t t f � ra | j d t | � � n | j d | � | j t | � � d j | � S( Nu , u lines %d-%d: u line %d: u ( u Noneu current_lineu appendu filenameu isinstanceu listu tupleu stru join( u selfu msgu lineu outmsg( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu gen_error~ s u TextFile.gen_errorc C s t d | j | | � � � d S( Nu error: ( u ValueErroru gen_error( u selfu msgu line( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu error� s u TextFile.errorc C s( t j j d | j | | � d � d S( u� Print (to stderr) a warning message tied to the current logical line in the current file. If the current logical line in the file spans multiple physical lines, the warning refers to the whole range, eg. "lines 3-5". If 'line' supplied, it overrides the current line number; it may be a list or tuple to indicate a range of physical lines, or an integer for a single physical line.u warning: u N( u sysu stderru writeu gen_error( u selfu msgu line( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu warn� s u TextFile.warnc C s� | j r$ | j d } | j d =| Sd } x�| j j � } | d k rQ d } n | j r� | r� | j d � } | d k r~ q� | d k s� | | d d k r� | d d k r� d p� d } | d | � | } | j � d k r� q- q� q� | j d d � } n | j r�| r�| d k r*| j d � | S| j rB| j � } n | | } t | j t � ry| j d d | j d <q�| j | j d g | _ nI | d k r�d St | j t � r�| j d d | _ n | j d | _ | j r�| j r�| j � } n0 | j r| j � } n | j r/| j � } n | d k sG| d k rV| j rVq- n | j r�| d d k r�| d d � } q- n | d d � d k r�| d d � d } q- q�n | Sd S( uU Read and return a single logical line from the current file (or from an internal buffer if lines have previously been "unread" with 'unreadline()'). If the 'join_lines' option is true, this may involve reading multiple physical lines concatenated into a single string. Updates the current line number, so calling 'warn()' after 'readline()' emits a warning about the physical line(s) just read. Returns None on end-of-file, since the empty string can occur if 'rstrip_ws' is true but 'strip_blanks' is not.i u u #i u \u u \#u2 continuation line immediately precedes end-of-fileNi u \ i����i����i����i����i����i����i����i����( u linebufu fileu readlineu Noneu strip_commentsu findu stripu replaceu join_linesu warnu collapse_joinu lstripu isinstanceu current_lineu listu lstrip_wsu rstrip_wsu rstripu skip_blanks( u selfu lineu buildup_lineu posu eol( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu readline� sf ! u TextFile.readlinec C s9 g } x, | j � } | d k r% | S| j | � q d S( uW Read and return the list of all logical lines remaining in the current file.N( u readlineu Noneu append( u selfu linesu line( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu readlines s u TextFile.readlinesc C s | j j | � d S( u� Push 'line' (a string) onto an internal buffer that will be checked by future 'readline()' calls. Handy for implementing a parser with line-at-a-time lookahead.N( u linebufu append( u selfu line( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu unreadline s u TextFile.unreadlineN( u __name__u __module__u __qualname__u __doc__u default_optionsu Noneu __init__u openu closeu gen_erroru erroru warnu readlineu readlinesu unreadline( u __locals__( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu TextFile s" 9 ! x u TextFile( u __doc__u sysu osu iou TextFile( ( ( u8 /opt/alt/python33/lib64/python3.3/distutils/text_file.pyu <module> s $
Save File
Cancel