https://github.com/gen2brain/Go-unarr

Go bindings for unarr (decompression library for RAR, TAR, ZIP and 7z archives)
https://github.com/gen2brain/Go-unarr

7z-archives 7zip decompression-library golang golang-library rar rar-format tar

Last synced: about 2 months ago
JSON representation

Go bindings for unarr (decompression library for RAR, TAR, ZIP and 7z archives)

• Host: GitHub
• URL: https://github.com/gen2brain/Go-unarr
• Owner: gen2brain
• License: zlib
• Created: 2015-11-01T09:38:37.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-04-23T07:51:04.000Z (5 months ago)
• Last Synced: 2024-06-19T14:01:34.288Z (3 months ago)
• Topics: 7z-archives, 7zip, decompression-library, golang, golang-library, rar, rar-format, tar
• Language: Go
• Homepage:
• Size: 901 KB
• Stars: 274
• Watchers: 11
• Forks: 44
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# go-unarr

[![Build Status](https://github.com/gen2brain/go-unarr/actions/workflows/test.yml/badge.svg)](https://github.com/gen2brain/go-unarr/actions)

[![GoDoc](https://godoc.org/github.com/gen2brain/go-unarr?status.svg)](https://godoc.org/github.com/gen2brain/go-unarr)

[![Go Report Card](https://goreportcard.com/badge/github.com/gen2brain/go-unarr?branch=master)](https://goreportcard.com/report/github.com/gen2brain/go-unarr)

> Golang bindings for the [unarr](https://github.com/selmf/unarr) library from sumatrapdf.

`unarr` is a decompression library and CLI for RAR, TAR, ZIP and 7z archives.

## GoDoc

See 

## Install CLI

```bash

go install github.com/gen2brain/go-unarr/cmd/unarr@latest

```

#### Example

```bash

unarr ./example.7z ./example/

```

#### Build

For one-off builds:

```bash

go build -o ./unarr ./cmd/unarr/*.go

```

For multi-platform cross-compile builds:

```bash

goreleaser --snapshot --skip-publish --rm-dist

```

## Library Examples

#### Install Library

```bash

go get -v github.com/gen2brain/go-unarr

```

#### Open archive

```go

a, err := unarr.NewArchive("test.7z")

if err != nil {

    panic(err)

}

defer a.Close()

```

#### Read first entry from archive

```go

err := a.Entry()

if err != nil {

    panic(err)

}

data, err := a.ReadAll()

if err != nil {

    panic(err)

}

```

#### List contents of archive

```go

list, err := a.List()

if err != nil {

    panic(err)

}

```

#### Read known filename from archive

```go

err := a.EntryFor("filename.txt")

if err != nil {

    panic(err)

}

data, err := a.ReadAll()

if err != nil {

    panic(err)

}

```

#### Read first 8 bytes of the entry

```go

err := a.Entry()

if err != nil {

    panic(err)

}

data := make([]byte, 8)

n, err := a.Read(data)

if err != nil {

    panic(err)

}

```

#### Read all entries from archive

```go

for {

    err := a.Entry()

    if err != nil {

        if err == io.EOF {

            break

        } else {

            panic(err)

        }

    }

    data, err := a.ReadAll()

    if err != nil {

        panic(err)

    }

}

```

#### Extract contents of archive to destination path

```go

_, err := a.Extract("/tmp/path")

if err != nil {

    panic(err)

}

```