| TestsTested | ✓ |
| LangLanguage | C++C++ |
| License | MIT |
| ReleasedLast Release | Mar 2016 |
Maintained by Oleh Kulykov.
It's not yet another wrapper around C part of the LZMA SDK with all it's limitations. Based on C++ LZMA SDK version 15.14 (1514 - latest for now) and patched for iOS & Mac OS platforms.
It's not yet another wrapper around C part of the LZMA SDK with all it's limitations. Based on C++ LZMA SDK version 15.14 (1514 - latest for now) and patched for iOS & Mac OS platforms.
The main advantages is:
use_frameworks!
platform :ios, '8.0'
pod 'LzmaSDK-ObjC', :inhibit_warnings => true// select full path to archive file with 7z or xz extension
NSString * archivePath = <path to archive>;
// 1.1 Create and hold strongly reader object.
self.reader = [[LzmaSDKObjCReader alloc] initWithFileURL:[NSURL fileURLWithPath:archivePath]];
// 1.2 Or create with predefined archive type if path doesn't containes suitable extension
self.reader = [[LzmaSDKObjCReader alloc] initWithFileURL:[NSURL fileURLWithPath:archivePath]
andType:LzmaSDKObjCFileType7z];
// Optionaly: assign weak delegate for tracking extract progress.
_reader.delegate = self;
// If achive encrypted - define password getter handler.
// NOTES:
// - Encrypted file needs password for extract process.
// - Encrypted file with encrypted header needs password for list(iterate) and extract archive items.
_reader.passwordGetter = ^NSString*(void){
return @"password to my achive";
};import LzmaSDK_ObjC
...
// replace path with your actual path to archive
let archivePath = "path to archive"
let reader: LzmaSDKObjCReader = LzmaSDKObjCReader(fileURL: NSURL(string: archivePath)!)
reader.passwordGetter = {() -> String? in
return "password to my achive"
}// Open archive, with or without error. Error can be nil.
NSError * error = nil;
if (![_reader open:&error])
{
NSLog(@"Open error: %@", error);
}
NSLog(@"Open error: %@", _reader.lastError);do {
try reader.open()
}
catch {
// process exception
}// Iterate all archive items, track what items do you need & hold them in array.
NSMutableArray * items = [NSMutableArray array]; // Array with selected items.
[_reader iterateWithHandler:^BOOL(LzmaSDKObjCItem * item, NSError * error){
NSLog(@"\n%@", item);
if (item) [items addObject:item]; // if needs this item - store to array.
return YES; // YES - continue iterate, NO - stop iteration
}];
NSLog(@"Iteration error: %@", _reader.lastError);var items = [LzmaSDKObjCItem]()
reader.iterateWithHandler({(item: LzmaSDKObjCItem, error: NSError?) -> Bool in
items.append(item)
return true
})// Extract selected items from prev. step.
// YES - create subfolders structure for the items.
// NO - place item file to the root of path(in this case items with the same names will be overwrited automaticaly).
[_reader extract:items
toPath:@"/extract/path"
withFullPaths:YES];
NSLog(@"Extract error: %@", _reader.lastError);
// Test selected items from prev. step.
[_reader test:items];
NSLog(@"test error: %@", _reader.lastError);// Extract selected items from prev. step.
reader.extract(items, toPath: "/extract/path", withFullPaths: true)Original C++ part of the LZMA SDK was patched to have a possibility to tune up default(hardcoded) settings.
For list and extract functionality was defined next global variables: kLzmaSDKObjCStreamReadSize, kLzmaSDKObjCStreamWriteSize, kLzmaSDKObjCDecoderReadSize and kLzmaSDKObjCDecoderWriteSize.
This variables holds size values in bytes, so, for the single reader object summary of this 4's values will be allocated.
Keep in mind: operations with memory much more faster than disk IO operations, so read below situations:
switch (<what do I need ?>)
{
case <I need faster list and extract>:
//TODO: Increase stream and decoder size of buffers
Result:
1. more allocated memory
2. less IO read/write operations and less delays
3. less smoothed progress
4. more CPU load (do a job, not distracted to read/write data)
break;
case <I need use less memory or more smoothed progress>:
//TODO: Decrease stream and decoder size of buffers
Result:
1. less allocated memory
2. more IO read/write operations and more delays
3. more smoothed progress
4. less CPU load (wait for read/write data)
break;
default:
//TODO: use current settings
break;
};NOTE: Modify global variables before creating & using reader object.
NOTE: This allocation sizes doesn't affet to memory allocated for the archive dictionary.
tests/files/lzma.7z
tests/files/lzma_aes256.7z
tests/files/lzma_aes256_encfn.7z
tests/files/lzma.7z
tests/files/lzma_aes256.7z
tests/files/lzma_aes256_encfn.7z
tests/files/lzma2.7z
tests/files/lzma2_aes256.7z
tests/files/lzma2_aes256_encfn.7z
tests/files/lzma2.7z
tests/files/lzma2_aes256.7z
tests/files/lzma2_aes256_encfn.7z
By using this all you are accepting original LZMA SDK and MIT license (see below):
The MIT License (MIT)
Copyright (c) 2015 - 2016 Kulykov Oleh [email protected]
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.