bmmcginty / simpleunrar Goto Github PK

python simpleUnrar (name list/in-memory extraction) coupled with portable unrar version
Original readme is below.
Please read the license.txt file. This package interfaces with the coupled unrar sources, as specified in that file.
The files, comprising "simpleUnrar.c", "Makefile", and "simpleUnrar.py" (and partially this readme.txt" file) are not part of the unrar sources, which make up the rest of this repository or archive.
To compile , just run make.
If your system is not a 64-bit system, please modify makefile.unix and Makefile.
I would appreciate copies of any changes you make to this project.
Goals:
The simpleUnrar.py file should be a shell that interfaces with the .so library, be that .so file a ctypes module, or ported into a full c-based python module.
Simple functions, such as the rarRead and rarList calls, should provide an easy to understand link to the true unrar library.
Todo:
Many features, file information, unrar-based password decryption, etc, could be added into this library.


Original Readme:
                       Portable UnRAR version


   1. General

   This package includes freeware Unrar C++ source and a few makefiles
   (makefile.bcc, makefile.msc+msc.dep, makefile.unix). Unrar source
   is subset of RAR and generated from RAR source automatically,
   by a small program removing blocks like '#ifndef UNRAR ... #endif'.
   Such method is not perfect and you may find some RAR related
   stuff unnecessary in Unrar, especially in header files.

   If you wish to port Unrar to a new platform, you may need to edit
   '#define LITTLE_ENDIAN' in os.hpp and data type definitions
   in rartypes.hpp.

   if computer architecture does not allow not aligned data access,
   you need to undefine ALLOW_NOT_ALIGNED_INT and define
   STRICT_ALIGNMENT_REQUIRED in os.h. Note that it will increase memory
   requirements.

   If you use Borland C++ makefile (makefile.bcc), you need to define
   BASEPATHCC environment (or makefile) variable containing
   the path to Borland C++ installation.

   Makefile.unix contains numerous compiler option sets.
   GCC Linux is selected by default. If you need to compile Unrar
   for other platforms, uncomment corresponding lines.

   UnRAR.vcproj and UnRARDll.vcproj are projects for Microsoft Visual C++.
   UnRARDll.vcproj lets to build unrar.dll library.


   2. Unrar binaries

   If you compiled Unrar for OS, which is not present in "Downloads"
   and "RAR extras" on www.rarlab.com, we will appreciate if you send
   us the compiled executable to place it to our site.


   3. Acknowledgements

   This source includes parts of code written by the following authors:

   Dmitry Shkarin     PPMII v.H text compression
   Dmitry Subbotin    Carryless rangecoder
   Szymon Stefanek    AES encryption
   Brian Gladman      AES encryption
   Steve Reid         SHA-1 hash function
   Marcus Herbert     makefile.unix file
   Tomasz Klim        fixes for libunrar.so
   Robert Riebisch    makefile.dj and patches for DJGPP


   4. Legal stuff

   Unrar source may be used in any software to handle RAR archives
   without limitations free of charge, but cannot be used to re-create
   the RAR compression algorithm, which is proprietary. Distribution
   of modified Unrar source in separate form or as a part of other
   software is permitted, provided that it is clearly stated in
   the documentation and source comments that the code may not be used
   to develop a RAR (WinRAR) compatible archiver.

   More detailed license text is available in license.txt.