81 lines
2.1 KiB
Markdown
81 lines
2.1 KiB
Markdown
|
archiver [](https://godoc.org/github.com/mholt/archiver) [](https://travis-ci.org/mholt/archiver) [](https://ci.appveyor.com/project/mholt/archiver)
|
||
|
|
========
|
||
|
|
|
||
|
|
Package archiver makes it trivially easy to make and extract .zip and .tar.gz files. Simply give the input and output file(s).
|
||
|
|
|
||
|
|
Files are put into the root of the archive; directories are recursively added.
|
||
|
|
|
||
|
|
The `archiver` command runs the same cross-platform and has no external dependencies (not even libc); powered by the Go standard library. Enjoy.
|
||
|
|
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
```bash
|
||
|
|
go get github.com/mholt/archiver
|
||
|
|
```
|
||
|
|
|
||
|
|
Or download from the [releases](https://github.com/mholt/archiver/releases) page.
|
||
|
|
|
||
|
|
|
||
|
|
## Command Use
|
||
|
|
|
||
|
|
Make a new archive:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
$ archiver make [archive name] [input files...]
|
||
|
|
```
|
||
|
|
|
||
|
|
(At least one input file is required.)
|
||
|
|
|
||
|
|
To extract an archive:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
$ archiver open [archive name] [destination]
|
||
|
|
```
|
||
|
|
|
||
|
|
(The destination path is optional; default is current directory.)
|
||
|
|
|
||
|
|
The archive name must end with a supported file extension like .zip or .tar.gz—this is how it knows what kind of archive to make.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Library Use
|
||
|
|
|
||
|
|
Create a .zip file:
|
||
|
|
|
||
|
|
```go
|
||
|
|
err := archiver.Zip("output.zip", []string{"file.txt", "folder"})
|
||
|
|
```
|
||
|
|
|
||
|
|
Extract a .zip file:
|
||
|
|
|
||
|
|
```go
|
||
|
|
err := archiver.Unzip("input.zip", "output_folder")
|
||
|
|
```
|
||
|
|
|
||
|
|
Create a .tar.gz file:
|
||
|
|
|
||
|
|
```go
|
||
|
|
err := archiver.TarGz("output.tar.gz", []string{"file.txt", "folder"})
|
||
|
|
```
|
||
|
|
|
||
|
|
Extract a .tar.gz file:
|
||
|
|
|
||
|
|
```go
|
||
|
|
err := archiver.UntarGz("input.tar.gz", "output_folder")
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## FAQ
|
||
|
|
|
||
|
|
#### Can I list a file to go in a different folder in the archive?
|
||
|
|
|
||
|
|
No. Just structure your input files to mirror the structure you want in the archive, like you would normally do when you make an archive using your OS.
|
||
|
|
|
||
|
|
|
||
|
|
#### Can it add files to an existing archive?
|
||
|
|
|
||
|
|
Nope. It's a simple tool; it just makes new archives or extracts existing ones.
|