mylar/lib/rarfile/README.rst


rarfile - RAR archive reader for Python
=======================================

This is Python module for RAR_ archive reading.  The interface
is made as zipfile_ like as possible.  Licensed under ISC_
license.

Features:

- Supports both RAR3 and RAR5 format archives.
- Supports multi volume archives.
- Supports Unicode filenames.
- Supports password-protected archives.
- Supports archive and file comments.
- Archive parsing and non-compressed files are handled in pure Python code.
- Compressed files are extracted by executing external tool: either ``unrar``
  from RARLAB_ or ``bsdtar`` from libarchive_.
- Works with both Python 2.7 and 3.x.

Links:

- `Documentation`_
- `Downloads`_
- `Git`_ repo

.. _Git: https://github.com/markokr/rarfile
.. _Downloads: https://pypi.python.org/pypi/rarfile
.. _Documentation: https://rarfile.readthedocs.io/
.. _RAR: https://en.wikipedia.org/wiki/RAR_%28file_format%29
.. _zipfile: https://docs.python.org/2/library/zipfile.html
.. _ISC: https://en.wikipedia.org/wiki/ISC_license
.. _libarchive: https://github.com/libarchive/libarchive
.. _RARLAB: http://www.rarlab.com/
IMP: Updated CT to a newer version - changed to use rarfile, fixes size invalid errors with some cbr's encountered during conversions, IMP: Search and Post-Processing Queues now added in order to queue up all searches/post-processing in sequence instead of loading lists and iterating through it and encountering various lock-related errors, IMP: In most cases, will now post-process directly against comicid/issueid/storyarcid instead of relying on relationship via nzb/torrent, FIX: realigned some checkboxes on series detail page, FIX: in configuration, indicated that ComicRN cannot be used when Completed Download Handling is enabled for a client now, FIX: Fix for issues named as 'special' that are part of the annuals section, but would not work in various portions (also will allow for naming differences in the future hopefully), FIX: Will now trap error properly when file cannot be located during dupecheck so that post-processing can continue without error, FIX: Fixed newznab test option on configuration screen so that it will return the correct response (previous was an invalid api endpoint), FIX: When retrieving image for storyarcs would error when no image was present and stop the process, FIX: accounted for some incorrect newznab responses that would return a non-api endpoint when retrieving via rss, which resulted in invalid nzbs, FIX: in some cases, weekly pull snatches would not update properly on the weekly page due to some db values not being written 2018-06-14 17:07:39 +00:00
			`rarfile - RAR archive reader for Python`
			`=======================================`

			`This is Python module for RAR_ archive reading. The interface`
			`is made as zipfile_ like as possible. Licensed under ISC_`
			`license.`

			`Features:`

			`- Supports both RAR3 and RAR5 format archives.`
			`- Supports multi volume archives.`
			`- Supports Unicode filenames.`
			`- Supports password-protected archives.`
			`- Supports archive and file comments.`
			`- Archive parsing and non-compressed files are handled in pure Python code.`
			- Compressed files are extracted by executing external tool: either ``unrar``
			from RARLAB_ or ``bsdtar`` from libarchive_.
			`- Works with both Python 2.7 and 3.x.`

			`Links:`

			- `Documentation`_
			- `Downloads`_
			- `Git`_ repo

			`.. _Git: https://github.com/markokr/rarfile`
			`.. _Downloads: https://pypi.python.org/pypi/rarfile`
			`.. _Documentation: https://rarfile.readthedocs.io/`
			`.. _RAR: https://en.wikipedia.org/wiki/RAR_%28file_format%29`
			`.. _zipfile: https://docs.python.org/2/library/zipfile.html`
			`.. _ISC: https://en.wikipedia.org/wiki/ISC_license`
			`.. _libarchive: https://github.com/libarchive/libarchive`
			`.. _RARLAB: http://www.rarlab.com/`