README.md

Description

A simple Go based Yum metadata parser with fetching capabilities.

Installation

 go get github.com/content-services/yummy  

Usage

To get yum repository metadata from a URL

// Define repository settings and create new repository 
url := "https://download-i2.fedoraproject.org/pub/epel/7/x86_64/"
client := &http.Client { 
     Timeout: time.Second*10 
 }
 
settings := YummySettings{
    Client: client,
    URL:    url,
}

repo, err := NewRepository(settings)

ctx := context.Background()

// To get repomd metadata
repomd, statusCode, err := repo.Repomd(ctx)

// To get package metadata
packages, statusCode, err := repo.Packages(ctx)

// To get repository signature
signature, statusCode, err := repo.Signature(ctx)

// To get repository package groups
packageGroups, statusCode, err := repo.PackageGroups(ctx)

// To get repository environments
environments, statusCode, err := repo.Environments(ctx)

To parse packages from a yum repository on disk

 xmlFile, err := os.Open("/some/yum/repo/repodata/primary.xml.gz") 
 if err != nil { 
	 log.Fatal(err) 
 } 
 defer xmlFile.Close() 
 result, err := ParseCompressedXMLData(xmlFile)  

To get a GPG Key from a URL

url := "https://packages.microsoft.com/keys/microsoft.asc"
client := http.Client { Timeout: time.Second*10 }   
gpgKey, statusCode, err := FetchGPGKey(context.Background(), url, client)

Mocking Yum also exports a mock interface you can regenerate using the mockery tool.