quange / nvhtargzipv2

A library to handle .tgz and .tar.gz files on iOS

NVHTarGzip

IS

• nvh#23, works for me, if any shows up, contacts：[email protected]
• nvh#21, fixed
• nvh#19, fixed, NSASCIIStringEncoding -> NSUTF8StringEncoding
• nvh#18, ignored, providing your bug case?
• nvh#17, fixed
• nvh#16, ignored
• nvh#14, works for me, if any shows up, contacts: [email protected]
• nvh#13, merged
• nvh#11, TODO:
• nvh#8, TODO: , clue: I defaulted back to the Light-Untar-for-iOS, and it worked. So not sure why this one wouldn't do it.
• nvh#7, TODO:

PR

• nvh#24, merged
• nvh#22, nvh#20, they fixed the bug with cutting off the name when it exceeds, while i use NAME_MAX, if other show up, contacts: [email protected]
• nvh#12, partially merged, reject the fix about NSProgress multithreading issue.

Usage

Asynchronous

Inflate Gzip file

[[NVHTarGzip sharedInstance] unGzipFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* gzipError) {
    if (gzipError != nil) {
        NSLog(@"Error ungzipping %@", gzipError);
    }
}];

Untar file

[[NVHTarGzip sharedInstance] unTarFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* tarError) {
    if (tarError != nil) {
        NSLog(@"Error untarring %@", tarError);
    }
}];

Inflate Gzip and Untar

[[NVHTarGzip sharedInstance] unTarGzipFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* error) {
    if (error != nil) {
        NSLog(@"Error extracting %@", error);
    }
}];

Deflate Gzip file

[[NVHTarGzip sharedInstance] gzipFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* gzipError) {
    if (gzipError != nil) {
        NSLog(@"Error gzipping %@", gzipError);
    }
}];

Tar file

[[NVHTarGzip sharedInstance] tarFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* tarError) {
    if (tarError != nil) {
        NSLog(@"Error tarring %@", tarError);
    }
}];

Deflate Gzip and Tar

[[NVHTarGzip sharedInstance] tarGzipFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* error) {
    if (error != nil) {
        NSLog(@"Error packing %@", error);
    }
}];

Synchronous

Inflate Gzip file

[[NVHTarGzip sharedInstance] unGzipFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* gzipError) {
    if (gzipError != nil) {
        NSLog(@"Error ungzipping %@", gzipError);
    }
}];

Untar file

[[NVHTarGzip sharedInstance] unTarFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* tarError) {
    if (tarError != nil) {
        NSLog(@"Error untarring %@", tarError);
    }
}];

Inflate Gzip and Untar

[[NVHTarGzip sharedInstance] unTarGzipFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* error) {
    if (error != nil) {
        NSLog(@"Error extracting %@", error);
    }
}];

Deflate Gzip file

[[NVHTarGzip sharedInstance] gzipFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* gzipError) {
    if (gzipError != nil) {
        NSLog(@"Error gzipping %@", gzipError);
    }
}];

Tar file

[[NVHTarGzip sharedInstance] tarFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* tarError) {
    if (tarError != nil) {
        NSLog(@"Error untarring %@", tarError);
    }
}];

Deflate Gzip and Tar

[[NVHTarGzip sharedInstance] tarGzipFileAtPath:sourcePath toPath:destinationPath completion:^(NSError* error) {
    if (error != nil) {
        NSLog(@"Error extracting %@", error);
    }
}];

Note

Sequential tar.gz packing and unpacking will either tar or ungzip the intermediate tar file to a temporary-directory, and subsequently gzip or untar it. After gzipping/untarring, the temporary-file is deleted. You can customize the cachePath by setting it on the singleton object before extracting:

[[NVHTarGzip sharedInstance] setCachePath:customCachePath];

Progress

NVHTarGzip uses NSProgress to handle progress reporting. To keep track of progress create your own progress instance and use KVO to inspect the fractionCompleted property. See the documentation of NSProgress and this great article by Ole Begemann for more information.

NSProgress* progress = [NSProgress progressWithTotalUnitCount:1];
NSString* keyPath = NSStringFromSelector(@selector(fractionCompleted));
[progress addObserver:self forKeyPath:keyPath options:NSKeyValueObservingOptionInitial context:NVHProgressFractionCompletedObserverContext];
[progress becomeCurrentWithPendingUnitCount:1];
[[NVHTarGzip sharedInstance] unTarGzipFileAtPath:self.demoSourceFilePath toPath:self.demoDestinationFilePath completion:^(NSError* error) {
    [progress resignCurrent];
    [progress removeObserver:self forKeyPath:keyPath];
}];

Checkout a full usage example in the example project; clone the repo, and run pod install from the Example directory first.

Todo

Add streaming support (NSStream). This would allow the usage of an intermediate file for tar.gz packing and unpacking, thus speeding things a bit.

Pull requests are welcome!

• Current benchmark ?

  • Cpu Almost full payload
  • Memory Low when TarGzip?
  • Disk IO high payload
  • Network None

Installation

NVHTarGzip is available through CocoaPods, to install it simply add the following line to your Podfile:

pod "NVHTarGzip"

2th Author

Seven, [email protected]