JackDandy
10 years ago
18 changed files with 78 additions and 1262 deletions
@ -1,4 +0,0 @@ |
|||||
syntax: glob |
|
||||
|
|
||||
*.pyc |
|
||||
build/* |
|
||||
@ -1,4 +0,0 @@ |
|||||
f2570b5f7205f1433661a9508f464f691cf63389 0.97 |
|
||||
d3595b2c9a1aec510f8ae1dcfef1eb8562a77fc0 0.99.1 |
|
||||
d23822f936c663784c5edda09cd5a6effe1e882d 0.99.2 |
|
||||
855a137f51581bd6d7a79264856020aa52fd0b66 0.99.3 |
|
||||
@ -1,2 +0,0 @@ |
|||||
recursive-include UnRARDLL *.* |
|
||||
include test.rar UnRAR2.html license.txt |
|
||||
@ -1,27 +0,0 @@ |
|||||
Metadata-Version: 1.1 |
|
||||
Name: pyUnRAR2 |
|
||||
Version: 0.99.3 |
|
||||
Summary: Improved Python wrapper around the free UnRAR.dll |
|
||||
Home-page: http://code.google.com/py-unrar2 |
|
||||
Author: Konstantin Yegupov |
|
||||
Author-email: yk4ever@gmail.com |
|
||||
License: MIT |
|
||||
Description: pyUnRAR2 is a ctypes based wrapper around the free UnRAR.dll. |
|
||||
|
|
||||
It is an modified version of Jimmy Retzlaff's pyUnRAR - more simple, |
|
||||
stable and foolproof. |
|
||||
Notice that it has INCOMPATIBLE interface. |
|
||||
|
|
||||
It enables reading and unpacking of archives created with the |
|
||||
RAR/WinRAR archivers. There is a low-level interface which is very |
|
||||
similar to the C interface provided by UnRAR. There is also a |
|
||||
higher level interface which makes some common operations easier. |
|
||||
Platform: Windows |
|
||||
Classifier: Development Status :: 4 - Beta |
|
||||
Classifier: Environment :: Win32 (MS Windows) |
|
||||
Classifier: License :: OSI Approved :: MIT License |
|
||||
Classifier: Natural Language :: English |
|
||||
Classifier: Operating System :: Microsoft :: Windows |
|
||||
Classifier: Programming Language :: Python |
|
||||
Classifier: Topic :: Software Development :: Libraries :: Python Modules |
|
||||
Classifier: Topic :: System :: Archiving :: Compression |
|
||||
@ -1,194 +0,0 @@ |
|||||
|
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
|
||||
<html><head><title>Python: package UnRAR2</title> |
|
||||
</head><body bgcolor="#f0f0f8"> |
|
||||
|
|
||||
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading"> |
|
||||
<tr bgcolor="#7799ee"> |
|
||||
<td valign=bottom> <br> |
|
||||
<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong>UnRAR2</strong></big></big> (version 0.99.2)</font></td |
|
||||
><td align=right valign=bottom |
|
||||
><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/rainman/dev/py-unrar2/UnRAR2/__init__.py">/home/rainman/dev/py-unrar2/UnRAR2/__init__.py</a></font></td></tr></table> |
|
||||
<p><tt>pyUnRAR2 is a ctypes based wrapper around the free UnRAR.dll. <br> |
|
||||
<br> |
|
||||
It is an modified version of Jimmy Retzlaff's pyUnRAR - more simple,<br> |
|
||||
stable and foolproof.<br> |
|
||||
Notice that it has INCOMPATIBLE interface.<br> |
|
||||
<br> |
|
||||
It enables reading and unpacking of archives created with the<br> |
|
||||
RAR/WinRAR archivers. There is a low-level interface which is very<br> |
|
||||
similar to the C interface provided by UnRAR. There is also a<br> |
|
||||
higher level interface which makes some common operations easier.</tt></p> |
|
||||
<p> |
|
||||
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
|
||||
<tr bgcolor="#aa55cc"> |
|
||||
<td colspan=3 valign=bottom> <br> |
|
||||
<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr> |
|
||||
|
|
||||
<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td> |
|
||||
<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="UnRAR2.UnRAR2.html"><strong>UnRAR2</strong> (package)</a><br> |
|
||||
<a href="UnRAR2.rar_exceptions.html">rar_exceptions</a><br> |
|
||||
</td><td width="25%" valign=top><a href="UnRAR2.setup.html">setup</a><br> |
|
||||
<a href="UnRAR2.test_UnRAR2.html">test_UnRAR2</a><br> |
|
||||
</td><td width="25%" valign=top><a href="UnRAR2.unix.html">unix</a><br> |
|
||||
<a href="UnRAR2.windows.html">windows</a><br> |
|
||||
</td><td width="25%" valign=top></td></tr></table></td></tr></table><p> |
|
||||
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
|
||||
<tr bgcolor="#ee77aa"> |
|
||||
<td colspan=3 valign=bottom> <br> |
|
||||
<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr> |
|
||||
|
|
||||
<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td> |
|
||||
<td width="100%"><dl> |
|
||||
<dt><font face="helvetica, arial"><a href="UnRAR2.unix.html#RarFileImplementation">UnRAR2.unix.RarFileImplementation</a>(<a href="__builtin__.html#object">__builtin__.object</a>) |
|
||||
</font></dt><dd> |
|
||||
<dl> |
|
||||
<dt><font face="helvetica, arial"><a href="UnRAR2.html#RarFile">RarFile</a> |
|
||||
</font></dt></dl> |
|
||||
</dd> |
|
||||
<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a> |
|
||||
</font></dt><dd> |
|
||||
<dl> |
|
||||
<dt><font face="helvetica, arial"><a href="UnRAR2.html#RarInfo">RarInfo</a> |
|
||||
</font></dt></dl> |
|
||||
</dd> |
|
||||
</dl> |
|
||||
<p> |
|
||||
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
|
||||
<tr bgcolor="#ffc8d8"> |
|
||||
<td colspan=3 valign=bottom> <br> |
|
||||
<font color="#000000" face="helvetica, arial"><a name="RarFile">class <strong>RarFile</strong></a>(<a href="UnRAR2.unix.html#RarFileImplementation">UnRAR2.unix.RarFileImplementation</a>)</font></td></tr> |
|
||||
|
|
||||
<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> |
|
||||
<td width="100%"><dl><dt>Method resolution order:</dt> |
|
||||
<dd><a href="UnRAR2.html#RarFile">RarFile</a></dd> |
|
||||
<dd><a href="UnRAR2.unix.html#RarFileImplementation">UnRAR2.unix.RarFileImplementation</a></dd> |
|
||||
<dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
|
||||
</dl> |
|
||||
<hr> |
|
||||
Methods defined here:<br> |
|
||||
<dl><dt><a name="RarFile-__del__"><strong>__del__</strong></a>(self)</dt></dl> |
|
||||
|
|
||||
<dl><dt><a name="RarFile-__init__"><strong>__init__</strong></a>(self, archiveName, password<font color="#909090">=None</font>)</dt><dd><tt>Instantiate the archive.<br> |
|
||||
<br> |
|
||||
archiveName is the name of the RAR file.<br> |
|
||||
password is used to decrypt the files in the archive.<br> |
|
||||
<br> |
|
||||
Properties:<br> |
|
||||
comment - comment associated with the archive<br> |
|
||||
<br> |
|
||||
>>> print <a href="#RarFile">RarFile</a>('test.rar').comment<br> |
|
||||
This is a test.</tt></dd></dl> |
|
||||
|
|
||||
<dl><dt><a name="RarFile-extract"><strong>extract</strong></a>(self, condition<font color="#909090">='*'</font>, path<font color="#909090">='.'</font>, withSubpath<font color="#909090">=True</font>, overwrite<font color="#909090">=True</font>)</dt><dd><tt>Extract specific files from archive to disk.<br> |
|
||||
<br> |
|
||||
If "condition" is a list of numbers, then extract files which have those positions in infolist.<br> |
|
||||
If "condition" is a string, then it is treated as a wildcard for names of files to extract.<br> |
|
||||
If "condition" is a function, it is treated as a callback function, which accepts a <a href="#RarInfo">RarInfo</a> <a href="__builtin__.html#object">object</a><br> |
|
||||
and returns either boolean True (extract) or boolean False (skip).<br> |
|
||||
DEPRECATED: If "condition" callback returns string (only supported for Windows) - <br> |
|
||||
that string will be used as a new name to save the file under.<br> |
|
||||
If "condition" is omitted, all files are extracted.<br> |
|
||||
<br> |
|
||||
"path" is a directory to extract to<br> |
|
||||
"withSubpath" flag denotes whether files are extracted with their full path in the archive.<br> |
|
||||
"overwrite" flag denotes whether extracted files will overwrite old ones. Defaults to true.<br> |
|
||||
<br> |
|
||||
Returns list of RarInfos for extracted files.</tt></dd></dl> |
|
||||
|
|
||||
<dl><dt><a name="RarFile-infoiter"><strong>infoiter</strong></a>(self)</dt><dd><tt>Iterate over all the files in the archive, generating RarInfos.<br> |
|
||||
<br> |
|
||||
>>> import os<br> |
|
||||
>>> for fileInArchive in <a href="#RarFile">RarFile</a>('test.rar').<a href="#RarFile-infoiter">infoiter</a>():<br> |
|
||||
... print os.path.split(fileInArchive.filename)[-1],<br> |
|
||||
... print fileInArchive.isdir,<br> |
|
||||
... print fileInArchive.size,<br> |
|
||||
... print fileInArchive.comment,<br> |
|
||||
... print tuple(fileInArchive.datetime)[0:5],<br> |
|
||||
... print time.strftime('%a, %d %b %Y %H:%M', fileInArchive.datetime)<br> |
|
||||
test True 0 None (2003, 6, 30, 1, 59) Mon, 30 Jun 2003 01:59<br> |
|
||||
test.txt False 20 None (2003, 6, 30, 2, 1) Mon, 30 Jun 2003 02:01<br> |
|
||||
this.py False 1030 None (2002, 2, 8, 16, 47) Fri, 08 Feb 2002 16:47</tt></dd></dl> |
|
||||
|
|
||||
<dl><dt><a name="RarFile-infolist"><strong>infolist</strong></a>(self)</dt><dd><tt>Return a list of RarInfos, descripting the contents of the archive.</tt></dd></dl> |
|
||||
|
|
||||
<dl><dt><a name="RarFile-read_files"><strong>read_files</strong></a>(self, condition<font color="#909090">='*'</font>)</dt><dd><tt>Read specific files from archive into memory.<br> |
|
||||
If "condition" is a list of numbers, then return files which have those positions in infolist.<br> |
|
||||
If "condition" is a string, then it is treated as a wildcard for names of files to extract.<br> |
|
||||
If "condition" is a function, it is treated as a callback function, which accepts a <a href="#RarInfo">RarInfo</a> <a href="__builtin__.html#object">object</a> <br> |
|
||||
and returns boolean True (extract) or False (skip).<br> |
|
||||
If "condition" is omitted, all files are returned.<br> |
|
||||
<br> |
|
||||
Returns list of tuples (<a href="#RarInfo">RarInfo</a> info, str contents)</tt></dd></dl> |
|
||||
|
|
||||
<hr> |
|
||||
Methods inherited from <a href="UnRAR2.unix.html#RarFileImplementation">UnRAR2.unix.RarFileImplementation</a>:<br> |
|
||||
<dl><dt><a name="RarFile-call"><strong>call</strong></a>(self, cmd, options<font color="#909090">=[]</font>, files<font color="#909090">=[]</font>)</dt></dl> |
|
||||
|
|
||||
<dl><dt><a name="RarFile-destruct"><strong>destruct</strong></a>(self)</dt></dl> |
|
||||
|
|
||||
<dl><dt><a name="RarFile-escaped_password"><strong>escaped_password</strong></a>(self)</dt></dl> |
|
||||
|
|
||||
<dl><dt><a name="RarFile-init"><strong>init</strong></a>(self, password<font color="#909090">=None</font>)</dt></dl> |
|
||||
|
|
||||
<hr> |
|
||||
Data descriptors inherited from <a href="UnRAR2.unix.html#RarFileImplementation">UnRAR2.unix.RarFileImplementation</a>:<br> |
|
||||
<dl><dt><strong>__dict__</strong></dt> |
|
||||
<dd><tt>dictionary for instance variables (if defined)</tt></dd> |
|
||||
</dl> |
|
||||
<dl><dt><strong>__weakref__</strong></dt> |
|
||||
<dd><tt>list of weak references to the object (if defined)</tt></dd> |
|
||||
</dl> |
|
||||
</td></tr></table> <p> |
|
||||
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
|
||||
<tr bgcolor="#ffc8d8"> |
|
||||
<td colspan=3 valign=bottom> <br> |
|
||||
<font color="#000000" face="helvetica, arial"><a name="RarInfo">class <strong>RarInfo</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr> |
|
||||
|
|
||||
<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> |
|
||||
<td colspan=2><tt>Represents a file header in an archive. Don't instantiate directly.<br> |
|
||||
Use only to obtain information about file.<br> |
|
||||
YOU CANNOT EXTRACT FILE CONTENTS USING THIS OBJECT.<br> |
|
||||
USE METHODS OF <a href="#RarFile">RarFile</a> CLASS INSTEAD.<br> |
|
||||
<br> |
|
||||
Properties:<br> |
|
||||
index - index of file within the archive<br> |
|
||||
filename - name of the file in the archive including path (if any)<br> |
|
||||
datetime - file date/time as a struct_time suitable for time.strftime<br> |
|
||||
isdir - True if the file is a directory<br> |
|
||||
size - size in bytes of the uncompressed file<br> |
|
||||
comment - comment associated with the file<br> |
|
||||
<br> |
|
||||
Note - this is not currently intended to be a Python file-like <a href="__builtin__.html#object">object</a>.<br> </tt></td></tr> |
|
||||
<tr><td> </td> |
|
||||
<td width="100%">Methods defined here:<br> |
|
||||
<dl><dt><a name="RarInfo-__init__"><strong>__init__</strong></a>(self, rarfile, data)</dt></dl> |
|
||||
|
|
||||
<dl><dt><a name="RarInfo-__str__"><strong>__str__</strong></a>(self)</dt></dl> |
|
||||
|
|
||||
<hr> |
|
||||
Data descriptors defined here:<br> |
|
||||
<dl><dt><strong>__dict__</strong></dt> |
|
||||
<dd><tt>dictionary for instance variables (if defined)</tt></dd> |
|
||||
</dl> |
|
||||
<dl><dt><strong>__weakref__</strong></dt> |
|
||||
<dd><tt>list of weak references to the object (if defined)</tt></dd> |
|
||||
</dl> |
|
||||
</td></tr></table></td></tr></table><p> |
|
||||
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
|
||||
<tr bgcolor="#eeaa77"> |
|
||||
<td colspan=3 valign=bottom> <br> |
|
||||
<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr> |
|
||||
|
|
||||
<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td> |
|
||||
<td width="100%"><dl><dt><a name="-condition2checker"><strong>condition2checker</strong></a>(condition)</dt><dd><tt>Converts different condition types to callback</tt></dd></dl> |
|
||||
</td></tr></table><p> |
|
||||
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
|
||||
<tr bgcolor="#55aa55"> |
|
||||
<td colspan=3 valign=bottom> <br> |
|
||||
<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr> |
|
||||
|
|
||||
<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td> |
|
||||
<td width="100%"><strong>__version__</strong> = '0.99.2'<br> |
|
||||
<strong>in_windows</strong> = False</td></tr></table> |
|
||||
</body></html> |
|
||||
@ -1,140 +0,0 @@ |
|||||
#ifndef _UNRAR_DLL_ |
|
||||
#define _UNRAR_DLL_ |
|
||||
|
|
||||
#define ERAR_END_ARCHIVE 10 |
|
||||
#define ERAR_NO_MEMORY 11 |
|
||||
#define ERAR_BAD_DATA 12 |
|
||||
#define ERAR_BAD_ARCHIVE 13 |
|
||||
#define ERAR_UNKNOWN_FORMAT 14 |
|
||||
#define ERAR_EOPEN 15 |
|
||||
#define ERAR_ECREATE 16 |
|
||||
#define ERAR_ECLOSE 17 |
|
||||
#define ERAR_EREAD 18 |
|
||||
#define ERAR_EWRITE 19 |
|
||||
#define ERAR_SMALL_BUF 20 |
|
||||
#define ERAR_UNKNOWN 21 |
|
||||
#define ERAR_MISSING_PASSWORD 22 |
|
||||
|
|
||||
#define RAR_OM_LIST 0 |
|
||||
#define RAR_OM_EXTRACT 1 |
|
||||
#define RAR_OM_LIST_INCSPLIT 2 |
|
||||
|
|
||||
#define RAR_SKIP 0 |
|
||||
#define RAR_TEST 1 |
|
||||
#define RAR_EXTRACT 2 |
|
||||
|
|
||||
#define RAR_VOL_ASK 0 |
|
||||
#define RAR_VOL_NOTIFY 1 |
|
||||
|
|
||||
#define RAR_DLL_VERSION 4 |
|
||||
|
|
||||
#ifdef _UNIX |
|
||||
#define CALLBACK |
|
||||
#define PASCAL |
|
||||
#define LONG long |
|
||||
#define HANDLE void * |
|
||||
#define LPARAM long |
|
||||
#define UINT unsigned int |
|
||||
#endif |
|
||||
|
|
||||
struct RARHeaderData |
|
||||
{ |
|
||||
char ArcName[260]; |
|
||||
char FileName[260]; |
|
||||
unsigned int Flags; |
|
||||
unsigned int PackSize; |
|
||||
unsigned int UnpSize; |
|
||||
unsigned int HostOS; |
|
||||
unsigned int FileCRC; |
|
||||
unsigned int FileTime; |
|
||||
unsigned int UnpVer; |
|
||||
unsigned int Method; |
|
||||
unsigned int FileAttr; |
|
||||
char *CmtBuf; |
|
||||
unsigned int CmtBufSize; |
|
||||
unsigned int CmtSize; |
|
||||
unsigned int CmtState; |
|
||||
}; |
|
||||
|
|
||||
|
|
||||
struct RARHeaderDataEx |
|
||||
{ |
|
||||
char ArcName[1024]; |
|
||||
wchar_t ArcNameW[1024]; |
|
||||
char FileName[1024]; |
|
||||
wchar_t FileNameW[1024]; |
|
||||
unsigned int Flags; |
|
||||
unsigned int PackSize; |
|
||||
unsigned int PackSizeHigh; |
|
||||
unsigned int UnpSize; |
|
||||
unsigned int UnpSizeHigh; |
|
||||
unsigned int HostOS; |
|
||||
unsigned int FileCRC; |
|
||||
unsigned int FileTime; |
|
||||
unsigned int UnpVer; |
|
||||
unsigned int Method; |
|
||||
unsigned int FileAttr; |
|
||||
char *CmtBuf; |
|
||||
unsigned int CmtBufSize; |
|
||||
unsigned int CmtSize; |
|
||||
unsigned int CmtState; |
|
||||
unsigned int Reserved[1024]; |
|
||||
}; |
|
||||
|
|
||||
|
|
||||
struct RAROpenArchiveData |
|
||||
{ |
|
||||
char *ArcName; |
|
||||
unsigned int OpenMode; |
|
||||
unsigned int OpenResult; |
|
||||
char *CmtBuf; |
|
||||
unsigned int CmtBufSize; |
|
||||
unsigned int CmtSize; |
|
||||
unsigned int CmtState; |
|
||||
}; |
|
||||
|
|
||||
struct RAROpenArchiveDataEx |
|
||||
{ |
|
||||
char *ArcName; |
|
||||
wchar_t *ArcNameW; |
|
||||
unsigned int OpenMode; |
|
||||
unsigned int OpenResult; |
|
||||
char *CmtBuf; |
|
||||
unsigned int CmtBufSize; |
|
||||
unsigned int CmtSize; |
|
||||
unsigned int CmtState; |
|
||||
unsigned int Flags; |
|
||||
unsigned int Reserved[32]; |
|
||||
}; |
|
||||
|
|
||||
enum UNRARCALLBACK_MESSAGES { |
|
||||
UCM_CHANGEVOLUME,UCM_PROCESSDATA,UCM_NEEDPASSWORD |
|
||||
}; |
|
||||
|
|
||||
typedef int (CALLBACK *UNRARCALLBACK)(UINT msg,LPARAM UserData,LPARAM P1,LPARAM P2); |
|
||||
|
|
||||
typedef int (PASCAL *CHANGEVOLPROC)(char *ArcName,int Mode); |
|
||||
typedef int (PASCAL *PROCESSDATAPROC)(unsigned char *Addr,int Size); |
|
||||
|
|
||||
#ifdef __cplusplus |
|
||||
extern "C" { |
|
||||
#endif |
|
||||
|
|
||||
HANDLE PASCAL RAROpenArchive(struct RAROpenArchiveData *ArchiveData); |
|
||||
HANDLE PASCAL RAROpenArchiveEx(struct RAROpenArchiveDataEx *ArchiveData); |
|
||||
int PASCAL RARCloseArchive(HANDLE hArcData); |
|
||||
int PASCAL RARReadHeader(HANDLE hArcData,struct RARHeaderData *HeaderData); |
|
||||
int PASCAL RARReadHeaderEx(HANDLE hArcData,struct RARHeaderDataEx *HeaderData); |
|
||||
int PASCAL RARProcessFile(HANDLE hArcData,int Operation,char *DestPath,char *DestName); |
|
||||
int PASCAL RARProcessFileW(HANDLE hArcData,int Operation,wchar_t *DestPath,wchar_t *DestName); |
|
||||
void PASCAL RARSetCallback(HANDLE hArcData,UNRARCALLBACK Callback,LPARAM UserData); |
|
||||
void PASCAL RARSetChangeVolProc(HANDLE hArcData,CHANGEVOLPROC ChangeVolProc); |
|
||||
void PASCAL RARSetProcessDataProc(HANDLE hArcData,PROCESSDATAPROC ProcessDataProc); |
|
||||
void PASCAL RARSetPassword(HANDLE hArcData,char *Password); |
|
||||
int PASCAL RARGetDllVersion(); |
|
||||
|
|
||||
#ifdef __cplusplus |
|
||||
} |
|
||||
#endif |
|
||||
|
|
||||
#endif |
|
||||
@ -1,606 +0,0 @@ |
|||||
|
|
||||
UnRAR.dll Manual |
|
||||
~~~~~~~~~~~~~~~~ |
|
||||
|
|
||||
UnRAR.dll is a 32-bit Windows dynamic-link library which provides |
|
||||
file extraction from RAR archives. |
|
||||
|
|
||||
|
|
||||
Exported functions |
|
||||
|
|
||||
==================================================================== |
|
||||
HANDLE PASCAL RAROpenArchive(struct RAROpenArchiveData *ArchiveData) |
|
||||
==================================================================== |
|
||||
|
|
||||
Description |
|
||||
~~~~~~~~~~~ |
|
||||
Open RAR archive and allocate memory structures |
|
||||
|
|
||||
Parameters |
|
||||
~~~~~~~~~~ |
|
||||
ArchiveData Points to RAROpenArchiveData structure |
|
||||
|
|
||||
struct RAROpenArchiveData |
|
||||
{ |
|
||||
char *ArcName; |
|
||||
UINT OpenMode; |
|
||||
UINT OpenResult; |
|
||||
char *CmtBuf; |
|
||||
UINT CmtBufSize; |
|
||||
UINT CmtSize; |
|
||||
UINT CmtState; |
|
||||
}; |
|
||||
|
|
||||
Structure fields: |
|
||||
|
|
||||
ArcName |
|
||||
Input parameter which should point to zero terminated string |
|
||||
containing the archive name. |
|
||||
|
|
||||
OpenMode |
|
||||
Input parameter. |
|
||||
|
|
||||
Possible values |
|
||||
|
|
||||
RAR_OM_LIST |
|
||||
Open archive for reading file headers only. |
|
||||
|
|
||||
RAR_OM_EXTRACT |
|
||||
Open archive for testing and extracting files. |
|
||||
|
|
||||
RAR_OM_LIST_INCSPLIT |
|
||||
Open archive for reading file headers only. If you open an archive |
|
||||
in such mode, RARReadHeader[Ex] will return all file headers, |
|
||||
including those with "file continued from previous volume" flag. |
|
||||
In case of RAR_OM_LIST such headers are automatically skipped. |
|
||||
So if you process RAR volumes in RAR_OM_LIST_INCSPLIT mode, you will |
|
||||
get several file header records for same file if file is split between |
|
||||
volumes. For such files only the last file header record will contain |
|
||||
the correct file CRC and if you wish to get the correct packed size, |
|
||||
you need to sum up packed sizes of all parts. |
|
||||
|
|
||||
OpenResult |
|
||||
Output parameter. |
|
||||
|
|
||||
Possible values |
|
||||
|
|
||||
0 Success |
|
||||
ERAR_NO_MEMORY Not enough memory to initialize data structures |
|
||||
ERAR_BAD_DATA Archive header broken |
|
||||
ERAR_BAD_ARCHIVE File is not valid RAR archive |
|
||||
ERAR_UNKNOWN_FORMAT Unknown encryption used for archive headers |
|
||||
ERAR_EOPEN File open error |
|
||||
|
|
||||
CmtBuf |
|
||||
Input parameter which should point to the buffer for archive |
|
||||
comments. Maximum comment size is limited to 64Kb. Comment text is |
|
||||
zero terminated. If the comment text is larger than the buffer |
|
||||
size, the comment text will be truncated. If CmtBuf is set to |
|
||||
NULL, comments will not be read. |
|
||||
|
|
||||
CmtBufSize |
|
||||
Input parameter which should contain size of buffer for archive |
|
||||
comments. |
|
||||
|
|
||||
CmtSize |
|
||||
Output parameter containing size of comments actually read into the |
|
||||
buffer, cannot exceed CmtBufSize. |
|
||||
|
|
||||
CmtState |
|
||||
Output parameter. |
|
||||
|
|
||||
Possible values |
|
||||
|
|
||||
0 comments not present |
|
||||
1 Comments read completely |
|
||||
ERAR_NO_MEMORY Not enough memory to extract comments |
|
||||
ERAR_BAD_DATA Broken comment |
|
||||
ERAR_UNKNOWN_FORMAT Unknown comment format |
|
||||
ERAR_SMALL_BUF Buffer too small, comments not completely read |
|
||||
|
|
||||
Return values |
|
||||
~~~~~~~~~~~~~ |
|
||||
Archive handle or NULL in case of error |
|
||||
|
|
||||
|
|
||||
======================================================================== |
|
||||
HANDLE PASCAL RAROpenArchiveEx(struct RAROpenArchiveDataEx *ArchiveData) |
|
||||
======================================================================== |
|
||||
|
|
||||
Description |
|
||||
~~~~~~~~~~~ |
|
||||
Similar to RAROpenArchive, but uses RAROpenArchiveDataEx structure |
|
||||
allowing to specify Unicode archive name and returning information |
|
||||
about archive flags. |
|
||||
|
|
||||
Parameters |
|
||||
~~~~~~~~~~ |
|
||||
ArchiveData Points to RAROpenArchiveDataEx structure |
|
||||
|
|
||||
struct RAROpenArchiveDataEx |
|
||||
{ |
|
||||
char *ArcName; |
|
||||
wchar_t *ArcNameW; |
|
||||
unsigned int OpenMode; |
|
||||
unsigned int OpenResult; |
|
||||
char *CmtBuf; |
|
||||
unsigned int CmtBufSize; |
|
||||
unsigned int CmtSize; |
|
||||
unsigned int CmtState; |
|
||||
unsigned int Flags; |
|
||||
unsigned int Reserved[32]; |
|
||||
}; |
|
||||
|
|
||||
Structure fields: |
|
||||
|
|
||||
ArcNameW |
|
||||
Input parameter which should point to zero terminated Unicode string |
|
||||
containing the archive name or NULL if Unicode name is not specified. |
|
||||
|
|
||||
Flags |
|
||||
Output parameter. Combination of bit flags. |
|
||||
|
|
||||
Possible values |
|
||||
|
|
||||
0x0001 - Volume attribute (archive volume) |
|
||||
0x0002 - Archive comment present |
|
||||
0x0004 - Archive lock attribute |
|
||||
0x0008 - Solid attribute (solid archive) |
|
||||
0x0010 - New volume naming scheme ('volname.partN.rar') |
|
||||
0x0020 - Authenticity information present |
|
||||
0x0040 - Recovery record present |
|
||||
0x0080 - Block headers are encrypted |
|
||||
0x0100 - First volume (set only by RAR 3.0 and later) |
|
||||
|
|
||||
Reserved[32] |
|
||||
Reserved for future use. Must be zero. |
|
||||
|
|
||||
Information on other structure fields and function return values |
|
||||
is available above, in RAROpenArchive function description. |
|
||||
|
|
||||
|
|
||||
==================================================================== |
|
||||
int PASCAL RARCloseArchive(HANDLE hArcData) |
|
||||
==================================================================== |
|
||||
|
|
||||
Description |
|
||||
~~~~~~~~~~~ |
|
||||
Close RAR archive and release allocated memory. It must be called when |
|
||||
archive processing is finished, even if the archive processing was stopped |
|
||||
due to an error. |
|
||||
|
|
||||
Parameters |
|
||||
~~~~~~~~~~ |
|
||||
hArcData |
|
||||
This parameter should contain the archive handle obtained from the |
|
||||
RAROpenArchive function call. |
|
||||
|
|
||||
Return values |
|
||||
~~~~~~~~~~~~~ |
|
||||
0 Success |
|
||||
ERAR_ECLOSE Archive close error |
|
||||
|
|
||||
|
|
||||
==================================================================== |
|
||||
int PASCAL RARReadHeader(HANDLE hArcData, |
|
||||
struct RARHeaderData *HeaderData) |
|
||||
==================================================================== |
|
||||
|
|
||||
Description |
|
||||
~~~~~~~~~~~ |
|
||||
Read header of file in archive. |
|
||||
|
|
||||
Parameters |
|
||||
~~~~~~~~~~ |
|
||||
hArcData |
|
||||
This parameter should contain the archive handle obtained from the |
|
||||
RAROpenArchive function call. |
|
||||
|
|
||||
HeaderData |
|
||||
It should point to RARHeaderData structure: |
|
||||
|
|
||||
struct RARHeaderData |
|
||||
{ |
|
||||
char ArcName[260]; |
|
||||
char FileName[260]; |
|
||||
UINT Flags; |
|
||||
UINT PackSize; |
|
||||
UINT UnpSize; |
|
||||
UINT HostOS; |
|
||||
UINT FileCRC; |
|
||||
UINT FileTime; |
|
||||
UINT UnpVer; |
|
||||
UINT Method; |
|
||||
UINT FileAttr; |
|
||||
char *CmtBuf; |
|
||||
UINT CmtBufSize; |
|
||||
UINT CmtSize; |
|
||||
UINT CmtState; |
|
||||
}; |
|
||||
|
|
||||
Structure fields: |
|
||||
|
|
||||
ArcName |
|
||||
Output parameter which contains a zero terminated string of the |
|
||||
current archive name. May be used to determine the current volume |
|
||||
name. |
|
||||
|
|
||||
FileName |
|
||||
Output parameter which contains a zero terminated string of the |
|
||||
file name in OEM (DOS) encoding. |
|
||||
|
|
||||
Flags |
|
||||
Output parameter which contains file flags: |
|
||||
|
|
||||
0x01 - file continued from previous volume |
|
||||
0x02 - file continued on next volume |
|
||||
0x04 - file encrypted with password |
|
||||
0x08 - file comment present |
|
||||
0x10 - compression of previous files is used (solid flag) |
|
||||
|
|
||||
bits 7 6 5 |
|
||||
|
|
||||
0 0 0 - dictionary size 64 Kb |
|
||||
0 0 1 - dictionary size 128 Kb |
|
||||
0 1 0 - dictionary size 256 Kb |
|
||||
0 1 1 - dictionary size 512 Kb |
|
||||
1 0 0 - dictionary size 1024 Kb |
|
||||
1 0 1 - dictionary size 2048 KB |
|
||||
1 1 0 - dictionary size 4096 KB |
|
||||
1 1 1 - file is directory |
|
||||
|
|
||||
Other bits are reserved. |
|
||||
|
|
||||
PackSize |
|
||||
Output parameter means packed file size or size of the |
|
||||
file part if file was split between volumes. |
|
||||
|
|
||||
UnpSize |
|
||||
Output parameter - unpacked file size. |
|
||||
|
|
||||
HostOS |
|
||||
Output parameter - operating system used for archiving: |
|
||||
|
|
||||
0 - MS DOS; |
|
||||
1 - OS/2. |
|
||||
2 - Win32 |
|
||||
3 - Unix |
|
||||
|
|
||||
FileCRC |
|
||||
Output parameter which contains unpacked file CRC. In case of file parts |
|
||||
split between volumes only the last part contains the correct CRC |
|
||||
and it is accessible only in RAR_OM_LIST_INCSPLIT listing mode. |
|
||||
|
|
||||
FileTime |
|
||||
Output parameter - contains date and time in standard MS DOS format. |
|
||||
|
|
||||
UnpVer |
|
||||
Output parameter - RAR version needed to extract file. |
|
||||
It is encoded as 10 * Major version + minor version. |
|
||||
|
|
||||
Method |
|
||||
Output parameter - packing method. |
|
||||
|
|
||||
FileAttr |
|
||||
Output parameter - file attributes. |
|
||||
|
|
||||
CmtBuf |
|
||||
File comments support is not implemented in the new DLL version yet. |
|
||||
Now CmtState is always 0. |
|
||||
|
|
||||
/* |
|
||||
* Input parameter which should point to the buffer for file |
|
||||
* comments. Maximum comment size is limited to 64Kb. Comment text is |
|
||||
* a zero terminated string in OEM encoding. If the comment text is |
|
||||
* larger than the buffer size, the comment text will be truncated. |
|
||||
* If CmtBuf is set to NULL, comments will not be read. |
|
||||
*/ |
|
||||
|
|
||||
CmtBufSize |
|
||||
Input parameter which should contain size of buffer for archive |
|
||||
comments. |
|
||||
|
|
||||
CmtSize |
|
||||
Output parameter containing size of comments actually read into the |
|
||||
buffer, should not exceed CmtBufSize. |
|
||||
|
|
||||
CmtState |
|
||||
Output parameter. |
|
||||
|
|
||||
Possible values |
|
||||
|
|
||||
0 Absent comments |
|
||||
1 Comments read completely |
|
||||
ERAR_NO_MEMORY Not enough memory to extract comments |
|
||||
ERAR_BAD_DATA Broken comment |
|
||||
ERAR_UNKNOWN_FORMAT Unknown comment format |
|
||||
ERAR_SMALL_BUF Buffer too small, comments not completely read |
|
||||
|
|
||||
Return values |
|
||||
~~~~~~~~~~~~~ |
|
||||
|
|
||||
0 Success |
|
||||
ERAR_END_ARCHIVE End of archive |
|
||||
ERAR_BAD_DATA File header broken |
|
||||
|
|
||||
|
|
||||
==================================================================== |
|
||||
int PASCAL RARReadHeaderEx(HANDLE hArcData, |
|
||||
struct RARHeaderDataEx *HeaderData) |
|
||||
==================================================================== |
|
||||
|
|
||||
Description |
|
||||
~~~~~~~~~~~ |
|
||||
Similar to RARReadHeader, but uses RARHeaderDataEx structure, |
|
||||
containing information about Unicode file names and 64 bit file sizes. |
|
||||
|
|
||||
struct RARHeaderDataEx |
|
||||
{ |
|
||||
char ArcName[1024]; |
|
||||
wchar_t ArcNameW[1024]; |
|
||||
char FileName[1024]; |
|
||||
wchar_t FileNameW[1024]; |
|
||||
unsigned int Flags; |
|
||||
unsigned int PackSize; |
|
||||
unsigned int PackSizeHigh; |
|
||||
unsigned int UnpSize; |
|
||||
unsigned int UnpSizeHigh; |
|
||||
unsigned int HostOS; |
|
||||
unsigned int FileCRC; |
|
||||
unsigned int FileTime; |
|
||||
unsigned int UnpVer; |
|
||||
unsigned int Method; |
|
||||
unsigned int FileAttr; |
|
||||
char *CmtBuf; |
|
||||
unsigned int CmtBufSize; |
|
||||
unsigned int CmtSize; |
|
||||
unsigned int CmtState; |
|
||||
unsigned int Reserved[1024]; |
|
||||
}; |
|
||||
|
|
||||
|
|
||||
==================================================================== |
|
||||
int PASCAL RARProcessFile(HANDLE hArcData, |
|
||||
int Operation, |
|
||||
char *DestPath, |
|
||||
char *DestName) |
|
||||
==================================================================== |
|
||||
|
|
||||
Description |
|
||||
~~~~~~~~~~~ |
|
||||
Performs action and moves the current position in the archive to |
|
||||
the next file. Extract or test the current file from the archive |
|
||||
opened in RAR_OM_EXTRACT mode. If the mode RAR_OM_LIST is set, |
|
||||
then a call to this function will simply skip the archive position |
|
||||
to the next file. |
|
||||
|
|
||||
Parameters |
|
||||
~~~~~~~~~~ |
|
||||
hArcData |
|
||||
This parameter should contain the archive handle obtained from the |
|
||||
RAROpenArchive function call. |
|
||||
|
|
||||
Operation |
|
||||
File operation. |
|
||||
|
|
||||
Possible values |
|
||||
|
|
||||
RAR_SKIP Move to the next file in the archive. If the |
|
||||
archive is solid and RAR_OM_EXTRACT mode was set |
|
||||
when the archive was opened, the current file will |
|
||||
be processed - the operation will be performed |
|
||||
slower than a simple seek. |
|
||||
|
|
||||
RAR_TEST Test the current file and move to the next file in |
|
||||
the archive. If the archive was opened with |
|
||||
RAR_OM_LIST mode, the operation is equal to |
|
||||
RAR_SKIP. |
|
||||
|
|
||||
RAR_EXTRACT Extract the current file and move to the next file. |
|
||||
If the archive was opened with RAR_OM_LIST mode, |
|
||||
the operation is equal to RAR_SKIP. |
|
||||
|
|
||||
|
|
||||
DestPath |
|
||||
This parameter should point to a zero terminated string containing the |
|
||||
destination directory to which to extract files to. If DestPath is equal |
|
||||
to NULL, it means extract to the current directory. This parameter has |
|
||||
meaning only if DestName is NULL. |
|
||||
|
|
||||
DestName |
|
||||
This parameter should point to a string containing the full path and name |
|
||||
to assign to extracted file or it can be NULL to use the default name. |
|
||||
If DestName is defined (not NULL), it overrides both the original file |
|
||||
name saved in the archive and path specigied in DestPath setting. |
|
||||
|
|
||||
Both DestPath and DestName must be in OEM encoding. If necessary, |
|
||||
use CharToOem to convert text to OEM before passing to this function. |
|
||||
|
|
||||
Return values |
|
||||
~~~~~~~~~~~~~ |
|
||||
0 Success |
|
||||
ERAR_BAD_DATA File CRC error |
|
||||
ERAR_BAD_ARCHIVE Volume is not valid RAR archive |
|
||||
ERAR_UNKNOWN_FORMAT Unknown archive format |
|
||||
ERAR_EOPEN Volume open error |
|
||||
ERAR_ECREATE File create error |
|
||||
ERAR_ECLOSE File close error |
|
||||
ERAR_EREAD Read error |
|
||||
ERAR_EWRITE Write error |
|
||||
|
|
||||
|
|
||||
Note: if you wish to cancel extraction, return -1 when processing |
|
||||
UCM_PROCESSDATA callback message. |
|
||||
|
|
||||
|
|
||||
==================================================================== |
|
||||
int PASCAL RARProcessFileW(HANDLE hArcData, |
|
||||
int Operation, |
|
||||
wchar_t *DestPath, |
|
||||
wchar_t *DestName) |
|
||||
==================================================================== |
|
||||
|
|
||||
Description |
|
||||
~~~~~~~~~~~ |
|
||||
Unicode version of RARProcessFile. It uses Unicode DestPath |
|
||||
and DestName parameters, other parameters and return values |
|
||||
are the same as in RARProcessFile. |
|
||||
|
|
||||
|
|
||||
==================================================================== |
|
||||
void PASCAL RARSetCallback(HANDLE hArcData, |
|
||||
int PASCAL (*CallbackProc)(UINT msg,LPARAM UserData,LPARAM P1,LPARAM P2), |
|
||||
LPARAM UserData); |
|
||||
==================================================================== |
|
||||
|
|
||||
Description |
|
||||
~~~~~~~~~~~ |
|
||||
Set a user-defined callback function to process Unrar events. |
|
||||
|
|
||||
Parameters |
|
||||
~~~~~~~~~~ |
|
||||
hArcData |
|
||||
This parameter should contain the archive handle obtained from the |
|
||||
RAROpenArchive function call. |
|
||||
|
|
||||
CallbackProc |
|
||||
It should point to a user-defined callback function. |
|
||||
|
|
||||
The function will be passed four parameters: |
|
||||
|
|
||||
|
|
||||
msg Type of event. Described below. |
|
||||
|
|
||||
UserData User defined value passed to RARSetCallback. |
|
||||
|
|
||||
P1 and P2 Event dependent parameters. Described below. |
|
||||
|
|
||||
|
|
||||
Possible events |
|
||||
|
|
||||
UCM_CHANGEVOLUME Process volume change. |
|
||||
|
|
||||
P1 Points to the zero terminated name |
|
||||
of the next volume. |
|
||||
|
|
||||
P2 The function call mode: |
|
||||
|
|
||||
RAR_VOL_ASK Required volume is absent. The function should |
|
||||
prompt user and return a positive value |
|
||||
to retry or return -1 value to terminate |
|
||||
operation. The function may also specify a new |
|
||||
volume name, placing it to the address specified |
|
||||
by P1 parameter. |
|
||||
|
|
||||
RAR_VOL_NOTIFY Required volume is successfully opened. |
|
||||
This is a notification call and volume name |
|
||||
modification is not allowed. The function should |
|
||||
return a positive value to continue or -1 |
|
||||
to terminate operation. |
|
||||
|
|
||||
UCM_PROCESSDATA Process unpacked data. It may be used to read |
|
||||
a file while it is being extracted or tested |
|
||||
without actual extracting file to disk. |
|
||||
Return a positive value to continue process |
|
||||
or -1 to cancel the archive operation |
|
||||
|
|
||||
P1 Address pointing to the unpacked data. |
|
||||
Function may refer to the data but must not |
|
||||
change it. |
|
||||
|
|
||||
P2 Size of the unpacked data. It is guaranteed |
|
||||
only that the size will not exceed the maximum |
|
||||
dictionary size (4 Mb in RAR 3.0). |
|
||||
|
|
||||
UCM_NEEDPASSWORD DLL needs a password to process archive. |
|
||||
This message must be processed if you wish |
|
||||
to be able to handle archives with encrypted |
|
||||
file names. It can be also used as replacement |
|
||||
of RARSetPassword function even for usual |
|
||||
encrypted files with non-encrypted names. |
|
||||
|
|
||||
P1 Address pointing to the buffer for a password. |
|
||||
You need to copy a password here. |
|
||||
|
|
||||
P2 Size of the password buffer. |
|
||||
|
|
||||
|
|
||||
UserData |
|
||||
User data passed to callback function. |
|
||||
|
|
||||
Other functions of UnRAR.dll should not be called from the callback |
|
||||
function. |
|
||||
|
|
||||
Return values |
|
||||
~~~~~~~~~~~~~ |
|
||||
None |
|
||||
|
|
||||
|
|
||||
|
|
||||
==================================================================== |
|
||||
void PASCAL RARSetChangeVolProc(HANDLE hArcData, |
|
||||
int PASCAL (*ChangeVolProc)(char *ArcName,int Mode)); |
|
||||
==================================================================== |
|
||||
|
|
||||
Obsoleted, use RARSetCallback instead. |
|
||||
|
|
||||
|
|
||||
|
|
||||
==================================================================== |
|
||||
void PASCAL RARSetProcessDataProc(HANDLE hArcData, |
|
||||
int PASCAL (*ProcessDataProc)(unsigned char *Addr,int Size)) |
|
||||
==================================================================== |
|
||||
|
|
||||
Obsoleted, use RARSetCallback instead. |
|
||||
|
|
||||
|
|
||||
==================================================================== |
|
||||
void PASCAL RARSetPassword(HANDLE hArcData, |
|
||||
char *Password); |
|
||||
==================================================================== |
|
||||
|
|
||||
Description |
|
||||
~~~~~~~~~~~ |
|
||||
Set a password to decrypt files. |
|
||||
|
|
||||
Parameters |
|
||||
~~~~~~~~~~ |
|
||||
hArcData |
|
||||
This parameter should contain the archive handle obtained from the |
|
||||
RAROpenArchive function call. |
|
||||
|
|
||||
Password |
|
||||
It should point to a string containing a zero terminated password. |
|
||||
|
|
||||
Return values |
|
||||
~~~~~~~~~~~~~ |
|
||||
None |
|
||||
|
|
||||
|
|
||||
==================================================================== |
|
||||
void PASCAL RARGetDllVersion(); |
|
||||
==================================================================== |
|
||||
|
|
||||
Description |
|
||||
~~~~~~~~~~~ |
|
||||
Returns API version. |
|
||||
|
|
||||
Parameters |
|
||||
~~~~~~~~~~ |
|
||||
None. |
|
||||
|
|
||||
Return values |
|
||||
~~~~~~~~~~~~~ |
|
||||
Returns an integer value denoting UnRAR.dll API version, which is also |
|
||||
defined in unrar.h as RAR_DLL_VERSION. API version number is incremented |
|
||||
only in case of noticeable changes in UnRAR.dll API. Do not confuse it |
|
||||
with version of UnRAR.dll stored in DLL resources, which is incremented |
|
||||
with every DLL rebuild. |
|
||||
|
|
||||
If RARGetDllVersion() returns a value lower than UnRAR.dll which your |
|
||||
application was designed for, it may indicate that DLL version is too old |
|
||||
and it will fail to provide all necessary functions to your application. |
|
||||
|
|
||||
This function is absent in old versions of UnRAR.dll, so it is safer |
|
||||
to use LoadLibrary and GetProcAddress to access this function. |
|
||||
|
|
||||
@ -1,80 +0,0 @@ |
|||||
List of unrar.dll API changes. We do not include performance and reliability |
|
||||
improvements into this list, but this library and RAR/UnRAR tools share |
|
||||
the same source code. So the latest version of unrar.dll usually contains |
|
||||
same decompression algorithm changes as the latest UnRAR version. |
|
||||
============================================================================ |
|
||||
|
|
||||
-- 18 January 2008 |
|
||||
|
|
||||
all LONG parameters of CallbackProc function were changed |
|
||||
to LPARAM type for 64 bit mode compatibility. |
|
||||
|
|
||||
|
|
||||
-- 12 December 2007 |
|
||||
|
|
||||
Added new RAR_OM_LIST_INCSPLIT open mode for function RAROpenArchive. |
|
||||
|
|
||||
|
|
||||
-- 14 August 2007 |
|
||||
|
|
||||
Added NoCrypt\unrar_nocrypt.dll without decryption code for those |
|
||||
applications where presence of encryption or decryption code is not |
|
||||
allowed because of legal restrictions. |
|
||||
|
|
||||
|
|
||||
-- 14 December 2006 |
|
||||
|
|
||||
Added ERAR_MISSING_PASSWORD error type. This error is returned |
|
||||
if empty password is specified for encrypted file. |
|
||||
|
|
||||
|
|
||||
-- 12 June 2003 |
|
||||
|
|
||||
Added RARProcessFileW function, Unicode version of RARProcessFile |
|
||||
|
|
||||
|
|
||||
-- 9 August 2002 |
|
||||
|
|
||||
Added RAROpenArchiveEx function allowing to specify Unicode archive |
|
||||
name and get archive flags. |
|
||||
|
|
||||
|
|
||||
-- 24 January 2002 |
|
||||
|
|
||||
Added RARReadHeaderEx function allowing to read Unicode file names |
|
||||
and 64 bit file sizes. |
|
||||
|
|
||||
|
|
||||
-- 23 January 2002 |
|
||||
|
|
||||
Added ERAR_UNKNOWN error type (it is used for all errors which |
|
||||
do not have special ERAR code yet) and UCM_NEEDPASSWORD callback |
|
||||
message. |
|
||||
|
|
||||
Unrar.dll automatically opens all next volumes not only when extracting, |
|
||||
but also in RAR_OM_LIST mode. |
|
||||
|
|
||||
|
|
||||
-- 27 November 2001 |
|
||||
|
|
||||
RARSetChangeVolProc and RARSetProcessDataProc are replaced by |
|
||||
the single callback function installed with RARSetCallback. |
|
||||
Unlike old style callbacks, the new function accepts the user defined |
|
||||
parameter. Unrar.dll still supports RARSetChangeVolProc and |
|
||||
RARSetProcessDataProc for compatibility purposes, but if you write |
|
||||
a new application, better use RARSetCallback. |
|
||||
|
|
||||
File comments support is not implemented in the new DLL version yet. |
|
||||
Now CmtState is always 0. |
|
||||
|
|
||||
|
|
||||
-- 13 August 2001 |
|
||||
|
|
||||
Added RARGetDllVersion function, so you may distinguish old unrar.dll, |
|
||||
which used C style callback functions and the new one with PASCAL callbacks. |
|
||||
|
|
||||
|
|
||||
-- 10 May 2001 |
|
||||
|
|
||||
Callback functions in RARSetChangeVolProc and RARSetProcessDataProc |
|
||||
use PASCAL style call convention now. |
|
||||
@ -1 +0,0 @@ |
|||||
This is x64 version of unrar.dll. |
|
||||
@ -1,54 +0,0 @@ |
|||||
# setup.py, config file for distutils |
|
||||
|
|
||||
import __init__ |
|
||||
|
|
||||
from distutils.core import setup |
|
||||
from distutils.command.install_data import install_data |
|
||||
import os |
|
||||
|
|
||||
|
|
||||
class smart_install_data(install_data): |
|
||||
def run(self): |
|
||||
#need to change self.install_dir to the actual library dir |
|
||||
install_cmd = self.get_finalized_command('install') |
|
||||
self.install_dir = getattr(install_cmd, 'install_lib') |
|
||||
return install_data.run(self) |
|
||||
|
|
||||
|
|
||||
data_files = [] |
|
||||
for dirpath, dirnames, filenames in os.walk(r'.'): |
|
||||
for dirname in ['.svn','build', 'dist', '_sgbak', '.hg']: |
|
||||
try: |
|
||||
dirnames.remove(dirname) |
|
||||
except ValueError: |
|
||||
pass |
|
||||
for filename in [fn for fn in filenames if os.path.splitext(fn)[-1].lower() in ('.pyc', '.pyo', '.scc')]: |
|
||||
filenames.remove(filename) |
|
||||
parts = ['UnRAR2']+dirpath.split(os.sep)[1:] |
|
||||
|
|
||||
data_files.append((os.path.join(*parts), [os.path.join(dirpath, fn) for fn in filenames])) |
|
||||
|
|
||||
setup(name='pyUnRAR2', |
|
||||
version=__init__.__version__, |
|
||||
description='Improved Python wrapper around the free UnRAR.dll', |
|
||||
long_description=__init__.__doc__.strip(), |
|
||||
author='Konstantin Yegupov', |
|
||||
author_email='yk4ever@gmail.com', |
|
||||
url='http://code.google.com/py-unrar2', |
|
||||
license='MIT', |
|
||||
platforms='Windows', |
|
||||
classifiers=[ |
|
||||
'Development Status :: 4 - Beta', |
|
||||
'Environment :: Win32 (MS Windows)', |
|
||||
'License :: OSI Approved :: MIT License', |
|
||||
'Natural Language :: English', |
|
||||
'Operating System :: Microsoft :: Windows', |
|
||||
'Programming Language :: Python', |
|
||||
'Topic :: Software Development :: Libraries :: Python Modules', |
|
||||
'Topic :: System :: Archiving :: Compression', |
|
||||
], |
|
||||
packages=['UnRAR2'], |
|
||||
package_dir={'UnRAR2' : ''}, |
|
||||
data_files=data_files, |
|
||||
cmdclass = {'install_data': smart_install_data}, |
|
||||
) |
|
||||
@ -1,138 +0,0 @@ |
|||||
import os, sys |
|
||||
|
|
||||
import UnRAR2 |
|
||||
from UnRAR2.rar_exceptions import * |
|
||||
|
|
||||
|
|
||||
def cleanup(dir='test'): |
|
||||
for path, dirs, files in os.walk(dir): |
|
||||
for fn in files: |
|
||||
os.remove(os.path.join(path, fn)) |
|
||||
for dir in dirs: |
|
||||
os.removedirs(os.path.join(path, dir)) |
|
||||
|
|
||||
|
|
||||
# basic test |
|
||||
cleanup() |
|
||||
rarc = UnRAR2.RarFile('test.rar') |
|
||||
rarc.infolist() |
|
||||
assert rarc.comment == "This is a test." |
|
||||
for info in rarc.infoiter(): |
|
||||
saveinfo = info |
|
||||
assert (str(info)=="""<RarInfo "test" in "test.rar">""") |
|
||||
break |
|
||||
rarc.extract() |
|
||||
assert os.path.exists('test'+os.sep+'test.txt') |
|
||||
assert os.path.exists('test'+os.sep+'this.py') |
|
||||
del rarc |
|
||||
assert (str(saveinfo)=="""<RarInfo "test" in "[ARCHIVE_NO_LONGER_LOADED]">""") |
|
||||
cleanup() |
|
||||
|
|
||||
# extract all the files in test.rar |
|
||||
cleanup() |
|
||||
UnRAR2.RarFile('test.rar').extract() |
|
||||
assert os.path.exists('test'+os.sep+'test.txt') |
|
||||
assert os.path.exists('test'+os.sep+'this.py') |
|
||||
cleanup() |
|
||||
|
|
||||
# extract all the files in test.rar matching the wildcard *.txt |
|
||||
cleanup() |
|
||||
UnRAR2.RarFile('test.rar').extract('*.txt') |
|
||||
assert os.path.exists('test'+os.sep+'test.txt') |
|
||||
assert not os.path.exists('test'+os.sep+'this.py') |
|
||||
cleanup() |
|
||||
|
|
||||
|
|
||||
# check the name and size of each file, extracting small ones |
|
||||
cleanup() |
|
||||
archive = UnRAR2.RarFile('test.rar') |
|
||||
assert archive.comment == 'This is a test.' |
|
||||
archive.extract(lambda rarinfo: rarinfo.size <= 1024) |
|
||||
for rarinfo in archive.infoiter(): |
|
||||
if rarinfo.size <= 1024 and not rarinfo.isdir: |
|
||||
assert rarinfo.size == os.stat(rarinfo.filename).st_size |
|
||||
assert file('test'+os.sep+'test.txt', 'rt').read() == 'This is only a test.' |
|
||||
assert not os.path.exists('test'+os.sep+'this.py') |
|
||||
cleanup() |
|
||||
|
|
||||
|
|
||||
# extract this.py, overriding it's destination |
|
||||
cleanup('test2') |
|
||||
archive = UnRAR2.RarFile('test.rar') |
|
||||
archive.extract('*.py', 'test2', False) |
|
||||
assert os.path.exists('test2'+os.sep+'this.py') |
|
||||
cleanup('test2') |
|
||||
|
|
||||
|
|
||||
# extract test.txt to memory |
|
||||
cleanup() |
|
||||
archive = UnRAR2.RarFile('test.rar') |
|
||||
entries = UnRAR2.RarFile('test.rar').read_files('*test.txt') |
|
||||
assert len(entries)==1 |
|
||||
assert entries[0][0].filename.endswith('test.txt') |
|
||||
assert entries[0][1]=='This is only a test.' |
|
||||
|
|
||||
|
|
||||
# extract all the files in test.rar with overwriting |
|
||||
cleanup() |
|
||||
fo = open('test'+os.sep+'test.txt',"wt") |
|
||||
fo.write("blah") |
|
||||
fo.close() |
|
||||
UnRAR2.RarFile('test.rar').extract('*.txt') |
|
||||
assert open('test'+os.sep+'test.txt',"rt").read()!="blah" |
|
||||
cleanup() |
|
||||
|
|
||||
# extract all the files in test.rar without overwriting |
|
||||
cleanup() |
|
||||
fo = open('test'+os.sep+'test.txt',"wt") |
|
||||
fo.write("blahblah") |
|
||||
fo.close() |
|
||||
UnRAR2.RarFile('test.rar').extract('*.txt', overwrite = False) |
|
||||
assert open('test'+os.sep+'test.txt',"rt").read()=="blahblah" |
|
||||
cleanup() |
|
||||
|
|
||||
# list big file in an archive |
|
||||
list(UnRAR2.RarFile('test_nulls.rar').infoiter()) |
|
||||
|
|
||||
# extract files from an archive with protected files |
|
||||
cleanup() |
|
||||
rarc = UnRAR2.RarFile('test_protected_files.rar', password="protected") |
|
||||
rarc.extract() |
|
||||
assert os.path.exists('test'+os.sep+'top_secret_xxx_file.txt') |
|
||||
cleanup() |
|
||||
errored = False |
|
||||
try: |
|
||||
UnRAR2.RarFile('test_protected_files.rar', password="proteqted").extract() |
|
||||
except IncorrectRARPassword: |
|
||||
errored = True |
|
||||
assert not os.path.exists('test'+os.sep+'top_secret_xxx_file.txt') |
|
||||
assert errored |
|
||||
cleanup() |
|
||||
|
|
||||
# extract files from an archive with protected headers |
|
||||
cleanup() |
|
||||
UnRAR2.RarFile('test_protected_headers.rar', password="secret").extract() |
|
||||
assert os.path.exists('test'+os.sep+'top_secret_xxx_file.txt') |
|
||||
cleanup() |
|
||||
errored = False |
|
||||
try: |
|
||||
UnRAR2.RarFile('test_protected_headers.rar', password="seqret").extract() |
|
||||
except IncorrectRARPassword: |
|
||||
errored = True |
|
||||
assert not os.path.exists('test'+os.sep+'top_secret_xxx_file.txt') |
|
||||
assert errored |
|
||||
cleanup() |
|
||||
|
|
||||
# make sure docstring examples are working |
|
||||
import doctest |
|
||||
doctest.testmod(UnRAR2) |
|
||||
|
|
||||
# update documentation |
|
||||
import pydoc |
|
||||
pydoc.writedoc(UnRAR2) |
|
||||
|
|
||||
# cleanup |
|
||||
try: |
|
||||
os.remove('__init__.pyc') |
|
||||
except: |
|
||||
pass |
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading…
Reference in new issue