Skip to content

Latest commit

 

History

History
57 lines (42 loc) · 1.6 KB

README.md

File metadata and controls

57 lines (42 loc) · 1.6 KB

UnarchiveKit

An iOS framework, written in Swift, to provide a common interface for reading files from archives.

Currently supports unencrypted Zip, Tar, Rar and 7zip files.

Installation

Clone the repository, add the UnarchiveKit Xcode project to your workspace and embed UnarchiveKit.framework in your target.

Or, use Carthage, adding the following to your Cartfile.

github "jlawton/UnarchiveKit"

Usage

import UnarchiveKit
func extractFiles(from archiveURL: URL, to directoryURL: URL) throws {
    let archive: FileArchive = try openFileArchive(url: archiveURL)

    try archive.extractFiles(toDirectory: directoryURL) { f in
        !f.path.isProbablyMacOSJunk()
    }
}
func extractFileToMemory(from archiveURL: URL, filePath: String) throws -> Data? {
    let archive: FileArchive = try openFileArchive(url: archiveURL)

    if let file: ArchivedFileInfo = try archive.locateFile(path: filePath) {
        return try archive.extractData(fileInfo: file)
    }
    return nil
}

Limitations

By design, FileArchive is only intended to deal with extracting normal files, and will generally not preserve file permissions or other metadata when extracting. Also, empty directories, links or other special files will not be extracted.

The tar implementation is very basic, and doesn't parse POSIX.1-2001/pax headers at the moment. The major consequence is that certain tar archives containing files with non-ASCII paths, or paths longer than 100 ASCII characters, may be extracted with incorrect or truncated file names.