U &]^h4@sdZddlmZddlZz ddlmZmZmZmZm Z Wne k rLYnXdZ e e Z dZdZGdd d eZGd d d eZGd d d eZedkredZededS)z Representation of ar archives for use with Debian binary packages These classes are primarily intended to be used with the :class:`debian.debfile.DebFile` class for working with Debian binary packages. )print_functionN)AnyDictIOListOptionals! <s` c@seZdZdZdS)ArErrorz@ Common base for all exceptions raised within the arfile module N)__name__ __module__ __qualname____doc__rr//usr/lib/python3/dist-packages/debian/arfile.pyr 1sr c@sjeZdZdZdddZddZdd Zd d ZeeZ d d Z ddZ ddZ ddZ ddZddZdS)ArFilea Representation of an ar archive, see man 1 ar. The interface of this class tries to mimic that of the TarFile module in the standard library. ArFile objects have the following (read-only) properties: - members same as getmembers() NrcCsdg|_i|_||_||_|dkr(t}||_|dkrJtjdkrFd}nd}||_|dkr`| dS)a Build an ar file representation starting from either a filename or an existing file object. The only supported mode is 'r'. In Python 3, the encoding and errors parameters control how member names are decoded into Unicode strings. Like tarfile, the default encoding is sys.getfilesystemencoding() and the default error handling scheme is 'surrogateescape' (>= 3.2) or 'strict' (< 3.2). N3.2surrogateescapestrictr) _ArFile__members_ArFile__members_dict_ArFile__fname_ArFile__fileobjsysgetfilesystemencoding_ArFile__encodingversion_ArFile__errors_ArFile__index_archive)selffilenamemodeZfileobjencodingerrorsrrr__init__?s zArFile.__init__cCs|jrt|jd}n|jr"|j}ntd|ttkr@tdtj||j|j |j d}|s^q|j |||j |j<|jddkr||jdq@||jddq@|jr|dS)NrbzUnable to open valid filezUnable to find global header)r"r#r)ropenrr readGLOBAL_HEADER_LENGTH GLOBAL_HEADERArMember from_filerrrappendrnamesizeseekclose)rfpZ newmemberrrrZ__index_archiveas(   zArFile.__index_archivecCs |j|S)a Return the (last occurrence of a) member in the archive whose name is 'name'. Raise KeyError if no member matches the given name. Note that in case of name collisions the only way to retrieve all members matching a given name is to use getmembers. )rrr/rrr getmember|szArFile.getmembercCs|jS)z Return a list of all members contained in the archive. The list has the same order of members in the archive and can contain duplicate members (i.e. members with the same name) if they are duplicate in the archive itself. rrrrr getmembersszArFile.getmemberscCsdd|jDS)z3 Return a list of all member names in the archive. cSsg|] }|jqSr)r/).0frrr sz#ArFile.getnames..r6r7rrrgetnamesszArFile.getnamescCstdSz Not (yet) implemented. NNotImplementedErrorr7rrr extractallszArFile.extractallcCstdSr=r>)rmemberpathrrrextractszArFile.extractcCs@|jD]4}t|tr(|j|jkr(|S||jkr|SqdS)z Return a file object corresponding to the requested member. A member can be specified either as a string (its name) or as a ArMember instance. N)r isinstancer,r/)rrAmrrr extractfiles    zArFile.extractfilecCs t|jS)z5 Iterate over the members of the present ar archive. )iterrr7rrr__iter__szArFile.__iter__cCs ||S)z Same as .getmember(name). )r5r4rrr __getitem__szArFile.__getitem__)NrNNN)r r r r r$rr5r8propertymembersr<r@rCrFrHrIrrrrr5s"  "  rc@seZdZdZddZed"ddZd#dd Zd$d d Zd%d d Z d&ddZ ddZ ddZ ddZ ddZddZeddZeddZeddZeddZeddZed dZed!dZdS)'r,a Member of an ar archive. Implements most of a file object interface: read, readline, next, readlines, seek, tell, close. ArMember objects have the following (read-only) properties: - name member name in an ar archive - mtime modification time - owner owner user - group owner group - fmode file permissions - size size in bytes - fname file namecCsFd|_d|_d|_d|_d|_d|_d|_d|_d|_d|_ d|_ dS)Nr) _ArMember__name_ArMember__mtime_ArMember__owner_ArMember__group_ArMember__fmode_ArMember__size_ArMember__fname _ArMember__fp_ArMember__offset_ArMember__end_ArMember__curr7rrrr$szArMember.__init__NcCsJ|t}|sdSt|tkr&td|ddtkr>tdtjdkrv|dkrXt}|dkr~tjdkrpd}q~d }nd }d }t}|d d  d d  }tjdkr| |||_ n||_ t |d d|_t |dd|_t |dd|_|dd|_t |dd|_||_|s&||_||_|j|j|_|j|_|S)zfp is an open File object positioned on a valid file header inside an ar archive. Return a new ArMember on success, None otherwise. NzIncorrect header length:rzIncorrect file magic3rrrrLr/"(0)r)FILE_HEADER_LENGTHlenIOError FILE_MAGICrrrr,splitstripdecoderMintrNrOrPrQrRrSrTtellrUrVrW)r3fnamer"r#bufr:r/rrrr-sB       zArMember.from_filercCs|jdkrt|jd|_|j|jd|krB|j|jkrbnn|j|}|j|_|S|j|jksz|j|jkr~dS|j|j|j}|j|_|S)Nr%r) rTr(rSr1rWrVr)rhrUrr0rjrrrr)2s     z ArMember.readcCs|jdkrt|jd|_|j|j|dk rZ|j|}|j|_|j|jkrVdS|S|j}|j|_|j|jkrdS|S)Nr%rk)rTr(rSr1rWreadlinerhrVrlrrrrmDs       zArMember.readlinecCs&d}g}|}|sq"||q|SN)rmr.)rsizehintrjlinesrrr readlinesXs zArMember.readlinescCs||j|jkr|j|_|dkr8||j|jkr8td||dkrN|j||_n*|dkrd|j||_n|dkrx|j||_dS)Nr&zCan't seek at %dr'r)rWrUrbrV)roffsetwhencerrrr1es  z ArMember.seekcCs|j|jkrdS|j|jS)Nr)rWrUr7rrrrhts z ArMember.tellcCsdS)NTrr7rrrseekablezszArMember.seekablecCs(|jdk r$|jdk r$|jd|_dSrn)rTrSr2r7rrrr2s zArMember.closecCs|Srnrmr7rrrnextsz ArMember.nextcsfdd}t|S)Nc3s}|r|VdSrnru)liner7rrnextlinesz#ArMember.__iter__..nextline)rG)rrxrr7rrHs zArMember.__iter__cCs|jSrn)rMr7rrrrkzArMember.cCs|jSrn)rNr7rrrryrkcCs|jSrn)rOr7rrrryrkcCs|jSrn)rPr7rrrryrkcCs|jSrn)rQr7rrrryrkcCs|jSrn)rRr7rrrryrkcCs|jSrn)rSr7rrrryrk)NN)r)N)r)r)r r r r r$ staticmethodr-r)rmrqr1rhrtr2rvrHrJr/mtimeownergroupZfmoder0rirrrrr,s, E         r,__main__ztest.ar )r Z __future__rrtypingrrrrr ImportErrorr+rar*r`rc Exceptionr objectrr,r aprintjoinr<rrrrs$  V