rarfile

інтерфейс нагадує інтерфейс ZipFile-х років.
Структура архіву розбору і незжатих файлів обробляються в чистому Python.
Декомпресія здійснюється за допомогою "UnRAR" утиліти командного рядка

Особливості : ..

• Розуміє Рар 3.x архіви
• Ручки багатотомні архіви.
• Ручки збережені файли самостійно.
• Ручки імена Unicode.
• Ручки архіви, захищені паролем.
• Ручки архівні коментарі.
• Для декомпресії використовує зовнішню утиліту командного рядка UnRAR.

Що нового У цьому випуску:

• .read () і .readinto () тепер робити петлі читати правильно працювати на коротких йдеться в повідомленні. Важливо для Python 3.2+, де читаються з труби може повернутися короткий результат навіть на блокування дескриптор файлу.
• Правильне помилка звітності в .extract (), .extractall (), .testrar ()
• .read () з UNRAR труби: воліють повернутися UNRAR код помилки, якщо той недоступний, зробити власні перевірки помилок
.
• Уникайте рядок додавання в .read (), замість того, щоб завжди використовувати список + зареєструватися, щоб об'єднати декількох частин читає.
• dumprar: Чи не перекодувати байт рядка (Python 2.x). Це дозволяє уникнути непотрібного відмова при друку невірний Unicode.

Що нового у версії 2.4:

• Виправлена ​​помилка:
• USE_DATETIME: вижити погані значення з RAR
.
• помилка в корумпованій обробки Unicode імен файлів.
• dumprar :. Зробити Unicode символи працювати як з трубою і консолі

Що нового у версії 2.3:

• Особливості:

Метод
• Підтримка .seek () на файлових потоків. (Kristian Larsson)

Метод
• Підтримка .readinto () на файлових потоків. Оптимізована реалізація є на Python 2.6+, де memoryview доступний.
• коментарі Підтримка файлів -. RarInfo.comment містить розпаковані дані, якщо доступні
• Файлові об'єкти, які повертаються RarFile.open () є io.RawIOBase-сумісними. Вони можуть розбиватися з io.BufferedReader` і `` io.TextIOWrapper.
• Тепер .getinfo () використовує Dict пошук замість послідовного перегляду при пошуку архіву записи. Це прискорює prococessing для архівів, які мають багато записів.
• Варіант rarfile.UNICODE_COMMENTS декодувати і архів і коментарі до файлів на Unicode. Він використовує TRY_ENCODINGS для списку кодувань, щоб спробувати. Якщо вимкнено, коментарі залишили у вигляді байтових рядків. За замовчуванням: 0
• Варіант rarfile.PATH_SEP змінити роздільник шляху. За замовчуванням :. R '& # x5c;', встановіть rarfile.PATH_SEP = '/', щоб бути compatibe з ZipFile
• Варіант rarfile.USE_DATETIME для перетворення теги до об'єктів дати і часу. Значення за замовчуванням: 0, штампи часу кортежі
.
• Варіант rarfile.TRY_ENCODINGS, щоб налаштування намагалися список кодування.
• Змінити RarInfo файлу до тіла сообщнія краще шоу ZipFile-сумісний полів.
• Стандартні regtests щоб переконатися, що різні особливості роботи
• Сумісність:
• Падіння RarInfo.unicode_filename, простий RarInfo.filename вже юнікод, починаючи з 2.0.
• .read (-1) не читає тепер до кінця файлу. Раніше він повернувся порожній буфер.
• Виправлення:
• Створити зашифрований заголовки працювати з Python 3.x байт () і модуля зі старим 2.x "SHA".
• Спростити subprocess.Popen () використання при запуску UnRAR. Раніше він намагався оптимізувати і обійти OS / Python помилок, але це не супроводі.
• Використовувати файл RAR температура зламати на багатотомних архівів теж.
• Завжди .wait () на UnRAR, щоб уникнути зомбі
• Перетворити struct.error в BadRarFile
• Підключіть кілька ФО витоків. Постраждалих :. Jython, PyPy
• зіпсовані архіви обробляються більш надійно.

Що нового у версії 2.2:

• Виправлення:
• Розслаблення імен обсяг. Тепер він просто обчислює нове ім'я томи, знаходячи номер в старій і збільшення його без будь-яких очікувань, що це число має бути.
• Файли з 4G стислих даних в одному colume були оброблені неправильно. Fix.
• DOS мітки часу секунд потрібно помножити на 2.
• Правильне EXTTIME розбору.
• прибирань:
• Стиснутий розмір кожного тому, підвести їх разом, так що користувач бачить повний стислий розмір для файлів, розбитий на кілька томів.
• dumprar :. Показати невідомі біт
• Використання struct.Struct () для кешування розпакування форматів.
• Підтримка вистачає os.devnull. (Python 2.3)

Що нового у версії 2.1:

• Особливості:
• Мінімальна implmentation для .extract (), .extractall (), .testrar (). Вони прості ярлики розпаковувати виклику.
• Прийняти об'єкт RarInfo де ім'я файлу не очікується.
• Включити dumprar.py в .tgz. Він може бути використаний для візуалізації структури RAR і модуль тестування.
• Підтримка зашифрованих заголовків файлів.
• Виправлення:
• Не читайте повз ENDARC, не може бути не RAR дані там.
• RAR 2.x: Це не написати ENDARC, але наш код обсяг очікував. Виправити це.
• RAR 2.x: Підтримка більше 200 томів в старому стилі
.
• прибирань:
• Load коментар тільки за запитом.
• Очищення внутрішніх змінних конфігурації. Вони повинні мати тепер остаточні імена.
• .open () :. Додати MODE = г аргумент, щоб відповідати ZipFile
• Док і коментарі очищення, звести до мінімуму дублювання.
• Загальні обгортки для обох стислих і незжатих файлів, тепер .open () також робить CRC-перевірки.

Що нового у версії 2.0:

• Особливості:
• Python 3 підтримка. Проте працює з 2.x.
• Аналізує розширені поля часу. (.mtime, .ctime, .atime)
• метод .open (). Це дає можливість обробляти великі елементи, які не вписуються в пам'яті.
• Підтримка архіви, захищені паролем.
• Підтримка архівів коментарі.
• прибирань:
• Використання модуля подпроцесс для запуску UnRAR.
• .filename завжди рядок Unicode, .unicode_filename тепер застарів.
• .CRC не підписаний знову, як python3 crc32 () не підписаний.