| Current File : //usr/lib/python2.7/site-packages/paramiko/file.pyo |
�
=OXc @ sz d d l m Z m Z m Z m Z m Z d d l m Z m Z m Z m
Z
m Z d d l m
Z
d e
f d � � YZ d S( i����( t linefeed_byte_valuet crlft cr_bytet
linefeed_bytet
cr_byte_value( t BytesIOt PY2t ut bt bytes_types( t ClosingContextManagert BufferedFilec B s[ e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d Z d Z
d
� Z d � Z d � Z d
� Z d � Z e r� d � Z n d � Z d � Z d � Z d � Z d � Z d& d � Z d& d � Z d& d � Z d d � Z d � Z d � Z d � Z! d � Z" e# d � � Z$ d � Z% d � Z& d � Z' d! d" d# � Z( d$ � Z) d% � Z* RS(' sc
Reusable base class to implement Python-style file buffering around a
simpler stream.
i i i i i i i i@ i� c C se d | _ d | _ | j | _ t � | _ t � | _ t | _
t | _ d | _ | _
d | _ d S( Ni ( t Nonet newlinest _flagst _DEFAULT_BUFSIZEt _bufsizeR t _wbuffert bytest _rbuffert Falset _at_trailing_crt _closedt _post _realpost _size( t self( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt __init__- s c C s | j � d S( N( t close( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt __del__< s c C s | j r t d � � n | S( s�
Returns an iterator that can be used to iterate over the lines in this
file. This iterator happens to return the file itself, since a file is
its own iterator.
:raises ValueError: if the file is closed.
s I/O operation on closed file( R t
ValueError( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt __iter__? s c C s | j � t | _ d S( sN
Close the file. Future read and write operations will fail.
N( t flusht TrueR ( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyR K s
c C s& | j | j j � � t � | _ d S( s{
Write out any data in the write buffer. This may do nothing if write
buffering is not turned on.
N( t
_write_allR t getvalueR ( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyR R s c C s | j � } | s t � n | S( s_
Returns the next line from the input, or raises
`~exceptions.StopIteration` when EOF is hit. Unlike Python file
objects, it's okay to mix calls to `next` and `readline`.
:raises StopIteration: when the end of the file is reached.
:returns: a line (`str`) read from the file.
( t readlinet
StopIteration( R t line( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt next\ s
c C s | j � } | s t � n | S( sV
Returns the next line from the input, or raises `.StopIteration` when
EOF is hit. Unlike python file objects, it's okay to mix calls to
`.next` and `.readline`.
:raises StopIteration: when the end of the file is reached.
:returns: a line (`str`) read from the file.
( R$ R% ( R R& ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt __next__k s
c C s | j | j @| j k S( s�
Check if the file can be read from.
:returns:
`True` if the file can be read from. If `False`, `read` will raise
an exception.
( R t FLAG_READ( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt readablez s c C s | j | j @| j k S( s�
Check if the file can be written to.
:returns:
`True` if the file can be written to. If `False`, `write` will
raise an exception.
( R t
FLAG_WRITE( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt writable� s c C s t S( s�
Check if the file supports random access.
:returns:
`True` if the file supports random access. If `False`, `seek` will
raise an exception.
( R ( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt seekable� s c C s/ | j t | � � } | | t | � *t | � S( s�
Read up to ``len(buff)`` bytes into :class:`bytearray` *buff* and
return the number of bytes read.
:returns:
The number of bytes read.
( t readt len( R t bufft data( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt readinto� s c C sX | j r t d � � n | j | j @s7 t d � � n | d k sO | d k r| j } t � | _ | j t | � 7_ x� t r y | j
| j � } Wn t k
r� d } n X| d k s� t | � d k r� Pn | | 7} | j
t | � 7_
| j t | � 7_ q| W| S| t | j � k r[| j | } | j | | _ | j t | � 7_ | Sx� t | j � | k r!| t | j � } | j | j @r�t | j | � } n y | j
| � } Wn t k
r�d } n X| d k s�t | � d k r�Pn | j | 7_ | j
t | � 7_
q^W| j | } | j | | _ | j t | � 7_ | S( s�
Read at most ``size`` bytes from the file (less if we hit the end of the
file first). If the ``size`` argument is negative or omitted, read all
the remaining data in the file.
.. note::
``'b'`` mode flag is ignored (``self.FLAG_BINARY`` in
``self._flags``), because SSH treats all files as binary, since we
have no idea what encoding the file is in, or even if the file is
text data.
:param int size: maximum number of bytes to read
:returns:
data read from the file (as bytes), or an empty string if EOF was
encountered immediately
s File is closeds File is not open for readingi N( R t IOErrorR R) R R R R R/ R! t _readR t EOFErrorR t
FLAG_BUFFEREDt maxR ( R t sizet resultt new_datat read_size( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyR. � sP
c
C s� | j r t d � � n | j | j @s7 t d � � n | j } t } x�t r�| j r� | j | j @r� t | � d k r� | d t
k r� | d } | j t � n
| j t
� t | _ n | d k r| d k rt | � | k r| | | _ | | } t } Pn | t | � } n | j } t | k sL| j | j @rPt
| k rPPn y | j | � } Wn t k
r|d } n X| d k s�t | � d k r�t � | _ | j t | � 7_ | j | j @r�| St | � S| | 7} | j t | � 7_ qI W| j t � } | j | j @r[| j t
� } | d k r[| | k sO| d k r[| } q[n | d k r�| j t | � 7_ | j | j @r�| St | � S| d } | | t k r�| t | � k r�| | t
k r�| d 7} n | r�| | | j n | | | _ | | | !} | | t } t | j � d k rO| t
k rOt | _ n
| j | � | j t | � 7_ | j | j @r�| St | � S( s�
Read one entire line from the file. A trailing newline character is
kept in the string (but may be absent when a file ends with an
incomplete line). If the size argument is present and non-negative, it
is a maximum byte count (including the trailing newline) and an
incomplete line may be returned. An empty string is returned only when
EOF is encountered immediately.
.. note::
Unlike stdio's ``fgets``, the returned string contains null
characters (``'\0'``) if they occurred in the input.
:param int size: maximum length of returned string.
:returns:
next line of the file, or an empty string if the end of the
file has been reached.
If the file was opened in binary (``'b'``) mode: bytes are returned
Else: the encoding of the file is assumed to be UTF-8 and character
strings (`str`) are returned
s File is closeds File not open for readingi i i����N( R R3 R R) R R R! R t FLAG_UNIVERSAL_NEWLINER/ R t _record_newlineR R R R R R4 R5 R R t FLAG_BINARYR R t findR (
R R8 R& t truncatedt nR: t post rpost xpost lf( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyR$ � sh +
(
$
2
$
!
c C sx g } d } xe t rs | j � } t | � d k r7 Pn | j | � | t | � 7} | d k r | | k r Pq q W| S( s�
Read all remaining lines using `readline` and return them as a list.
If the optional ``sizehint`` argument is present, instead of reading up
to EOF, whole lines totalling approximately sizehint bytes (possibly
after rounding up to an internal buffer size) are read.
:param int sizehint: desired maximum number of bytes to read.
:returns: `list` of lines read from the file.
i N( R! R$ R/ t appendR ( R t sizehintt linest
byte_countR& ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt readlines: s
c C s t d � � d S( s�
Set the file's current position, like stdio's ``fseek``. Not all file
objects support seeking.
.. note::
If a file is opened in append mode (``'a'`` or ``'a+'``), any seek
operations will be undone at the next write (as the file position
will move back to the end of the file).
:param int offset:
position to move to within the file, relative to ``whence``.
:param int whence:
type of movement: 0 = absolute; 1 = relative to the current
position; 2 = relative to the end of the file.
:raises IOError: if the file doesn't support random access.
s File does not support seeking.N( R3 ( R t offsett whence( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt seekP s c C s | j S( s�
Return the file's current position. This may not be accurate or
useful if the underlying file doesn't support random access, or was
opened in append mode.
:returns: file position (`number <int>` of bytes).
( R ( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt telld s c C s1 t | � } | j r$ t d � � n | j | j @sC t d � � n | j | j @sd | j | � d S| j j | � | j | j @r| j
t � } | d k r| j j � } | t
| � t
| � 7} | j | | d � t � | _ | j j | | d � n d S| j j � | j k r-| j � n d S( s*
Write data to the file. If write buffering is on (``bufsize`` was
specified and non-zero), some or all of the data may not actually be
written yet. (Use `flush` or `close` to force buffered data to be
written out.)
:param str data: data to write
s File is closeds File not open for writingNi i ( R R R3 R R+ R6 R" R t writet FLAG_LINE_BUFFEREDt rfindR R# R/ R RN R R ( R R1 t last_newline_post wbuf( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyRO n s*
c C s" x | D] } | j | � q Wd S( sH
Write a sequence of strings to the file. The sequence can be any
iterable object producing strings, typically a list of strings. (The
name is intended to match `readlines`; `writelines` does not add line
separators.)
:param iterable sequence: an iterable sequence of strings.
N( RO ( R t sequenceR& ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt
writelines� s
c C s | S( s
Identical to ``iter(f)``. This is a deprecated file interface that
predates Python iterator support.
( ( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt
xreadlines� s c C s | j S( N( R ( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt closed� s c C s
t � � d S( s�
(subclass override)
Read data from the stream. Return ``None`` or raise ``EOFError`` to
indicate EOF.
N( R5 ( R R8 ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyR4 � s c C s t d � � d S( sI
(subclass override)
Write data into the stream.
s write not implementedN( R3 ( R R1 ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt _write� s c C s d S( si
(subclass override)
Return the size of the file. This is called from within `_set_mode`
if the file is opened in append mode, so the file position can be
tracked and `seek` and `tell` will work correctly. If the file is
a stream that can't be randomly accessed, you don't need to override
this method,
i ( ( R ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt _get_size� s t ri����c C s� | j | _ | d k r! d } n | d k rI | j | j | j BO_ nf | d k r� | | _ | j | j O_ | j | j M_ n) | d k r� | j | j | j BM_ n d | k s� d | k r� | j | j O_ n d | k s� d | k r | j | j O_ n d | k rS| j | j | j BO_ | j � | _ | j | _
| _ n d | k rt| j | j O_ n d | k r�| j | j
O_ d | _ n d S(
sM
Subclasses call this method to initialize the BufferedFile.
i i RZ t +t wt aR t UN( R R R R6 RP R) R+ t FLAG_APPENDRY R R R R> R< R R
( R t modet bufsize( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt _set_mode� s0 c C s� x� t | � d k r� | j | � } | | } | j | j @rc | j | 7_ | j | _ | _ q | j | 7_ | j | 7_ q Wd S( Ni ( R/ RX R R_ R R R R ( R R1 t count( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyR" � s
c C s� | j | j @s d S| j d k r/ | | _ nZ | j | k re t | j t � re | j | f | _ n$ | | j k r� | j | f 7_ n d S( N( R R< R
R t
isinstanceR ( R t newline( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyR= � s !N(+ t __name__t
__module__t __doc__R t SEEK_SETt SEEK_CURt SEEK_ENDR) R+ R_ R> R6 RP R< R R R R R R R' R( R* R, R- R2 R R. R$ RJ RM RN RO RU RV t propertyRW R4 RX RY Rb R" R= ( ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyR sN
; [
"
( N( t paramiko.commonR R R R R t paramiko.py3compatR R R R R t
paramiko.utilR
R ( ( ( s1 /usr/lib/python2.7/site-packages/paramiko/file.pyt <module> s ((