rarfile

L'interface ressemble à l'interface de fichier zip.
L'analyse de la structure de l'archive et les fichiers non compressés sont traités en Python pur.
Décompression se fait via "unrar 'utilitaire de ligne de commande

Caractéristiques :..

• Comprendre archives RAR 3.x
• Poignées archives multi-volumes.
• Poignées se fichiers stockés.
• Poignées noms Unicode.
• Poignées archives protégées par mot de passe.
• Poignées commentaires archives.
• Pour la décompression utilise utilitaire unrar de ligne de commande externe.

Ce qui est nouveau dans cette version:

• .read () et .readinto () maintenant le faire boucle lire pour fonctionner correctement sur courte lectures. Important pour Python 3.2 et versions ultérieures où les lire à partir de tuyaux peut renvoyer le résultat à court même sur le blocage de descripteur de fichier.
• erreur approprié rapports dans .extract (), .extractall (), .testrar ()
• .read () à partir de tuyaux unrar: préfèrent retourner le code d'erreur unrar, si ce est pas disponible, faire des vérifications d'erreur propres
.
• Eviter l'ajout de chaîne dans .read (), au lieu de toujours utiliser la liste + rejoindre de fusionner plusieurs parties lit.
• dumprar: Dont chaînes d'octets ré-encoder (Python 2.x). Cela évite l'échec inutiles lors de l'impression invalide Unicode.

Ce qui est nouveau dans la version 2.4:

• Correction de bugs:
• USE_DATETIME: survivre mauvaises valeurs de RAR
.
• bogue dans corrompus manutention unicode de nom de fichier.
• dumprar:. Caractères unicode font travailler à la fois avec tuyau et la console

Ce qui est nouveau dans la version 2.3:

• Caractéristiques:

Méthode
• Support .seek () sur les flux de fichiers. (Kristian Larsson)

Méthode
• Support .readinto () sur les flux de fichiers. Optimized est disponible sur Python 2.6+ où memoryview est disponible.
• commentaires de fichiers de soutien -. RarInfo.comment contient des données décompressés si disponible
• Les objets de fichier retourné par RarFile.open () sont io.RawIOBase-compatible. Ils peuvent en outre enveloppé avec io.BufferedReader` et `` io.TextIOWrapper.
• Maintenant .getinfo () utilise dict recherche lieu de scan séquentiel lors de la recherche entrée d'archives. Cela accélère prococessing pour les archives qui ont de nombreuses entrées.
• rarfile.UNICODE_COMMENTS Option pour décoder la fois archive et déposer des observations en unicode. Il utilise TRY_ENCODINGS pour la liste des encodages à essayer. Si elle est désactivée, les commentaires sont laissées telles chaînes d'octets. Par défaut: 0
• Option rarfile.PATH_SEP pour changer séparateur de chemin. Par défaut:. R '& # x5C;', mis rarfile.PATH_SEP = '/' pour être Compatibe avec zipfile
• Option rarfile.USE_DATETIME convertir horodateurs aux objets datetime. Par défaut: 0, les horodateurs sont tuples
.
• rarfile.TRY_ENCODINGS Option pour permettre le réglage tentative de liste de codage.
• Réorganiser RarInfo Fiels aux champs de fichier zip compatible meilleur spectacle.
• regtests standard pour se assurer que diverses caractéristiques travaux
• Compatibilité:
• Chute RarInfo.unicode_filename, RarInfo.filename plaine est déjà depuis Unicode 2.0.
• .read (-1) se lit maintenant jusqu'à EOF. Auparavant, il revint tampon vide.
• Corrections:
• Ne têtes chiffrés travaillent avec Python 3.x octets () et avec le vieux 2.x module 'sha'.
• Simplifier subprocess.Popen () utilisation lors du lancement unrar. Auparavant, il a essayé d'optimiser et de travail autour de bogues OS / Python, mais ce ne est pas maintenable.
• Utiliser le fichier rar temp pirater sur les archives multi-volumes aussi.
• Toujours .wait () sur unrar, pour éviter zombies
• Convertir struct.error à BadRarFile
• Branchez quelques fuites de fd. Visé:. Jython, PyPy
• archives brisées sont traitées de façon plus robuste.

Ce qui est nouveau dans la version 2.2:

• Corrections:
• nommage de volume décontractée. Maintenant, il calcule tout nouveau nom de volume en trouvant nombre dans ancien et de l'augmenter, sans aucune attente que ce nombre devrait être.
• Fichiers avec 4G de données compressées dans une colume ont été traitées mal. Fix.
• DOS horodatage secondes doivent être multipliés par deux.
• Correct EXTTIME analyse.
• nettoyages:
• Taille compressée est par volume, résumer ensemble, de sorte que l'utilisateur voit taille compressée complète pour les fichiers répartis sur plusieurs volumes.
• dumprar:. Voir les bits inconnus
• Utiliser struct.Struct () pour mettre en cache formats déballage.
• Support os.devnull manquantes. (Python 2.3)

Ce qui est nouveau dans la version 2.1:

• Caractéristiques:
• implmentation minimale pour .extract (), .extractall (), .testrar (). Ils sont des raccourcis simples à l'invocation unrar.
• Accepter objet RarInfo où il est prévu nom de fichier.
• Inclure dumprar.py dans .tgz. Il peut être utilisé pour visualiser la structure de RAR et le module de test.
• Soutien aux en-têtes de fichiers chiffrés.
• Corrections:
• Ne lisez pas passé ENDARC, il pourrait y avoir des données non-RAR là.
• RAR 2.x: Il ne écrit pas ENDARC, mais notre code de volume attendait. Corriger cela.
• RAR 2.x: Soutenez plus de 200 volumes de style ancien
.
• nettoyages:
• Load commentaire que lorsque demandé.
• Nettoyage des variables de configuration internes. Ils doivent avoir des noms désormais finales.
• .Open ():. Ajouter mode = argument r pour correspondre zipfile
• Doc et commentaires nettoyage, de minimiser les doubles emplois.
• emballages communs pour les deux fichiers compressés et non compressés, maintenant .Open () fait aussi CRC-contrôle.

Ce qui est nouveau dans la version 2.0:

• Caractéristiques:
• Python 3 soutien. Travaille encore avec 2.x.
• Analyse les champs de temps prolongées. (.mtime, .ctime, .atime)
• méthode .Open (). Cela permet de traiter de grandes entrées qui ne rentrent pas dans la mémoire.
• Prise en charge des archives protégées par mot de passe.
• Supports commentaires archives.
• nettoyages:
• utilise le module de sous-processus pour lancer unrar.
• .FileName est toujours chaîne Unicode, .unicode_filename est maintenant obsolète.
• .CRC ne est pas signé de nouveau, comme python3 crc32 () ne est pas signé.