osrelease

package module

v0.0.0-...-a93a0a5 Latest Latest Go to latest Published: Dec 18, 2018 License: BSD-3-Clause Imports: 5 Imported by: 12

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/cobaugh/osrelease

README ¶

osrelease

A Go package to make reading in os-release files easy.

See https://www.freedesktop.org/software/systemd/man/os-release.html

Installation

$ go get github.com/cobaugh/osrelease

Usage

See godoc

package main

import (
	"fmt"
	"github.com/cobaugh/osrelease"
)

func main() {
	// for reference, two variables are provided:
	fmt.Printf("EtcOsRelease = %v\n", osrelease.EtcOsRelease)
	fmt.Printf("UsrLibOsRelease = %v\n", osrelease.UsrLibOsRelease)

	// let osrelease find what file to load
	osrelease, err := osrelease.Read()
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}
	fmt.Printf("PRETTY_NAME = %v\n", osrelease["PRETTY_NAME"])

	// specify the file to load explicitly
	osrelease, err = osrelease.ReadFile("/etc/os-release")
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}
	fmt.Printf("PRETTY_NAME = %v\n", osrelease["PRETTY_NAME"])
}

Output:

$ ./examples 
EtcOsRelease = /etc/os-release
UsrLibOsRelease = /usr/lib/os-release
PRETTY_NAME = void
PRETTY_NAME = void```

Documentation ¶

Overview ¶

osrelease is a go package to make reading the contents of os-release files easier

See https://www.freedesktop.org/software/systemd/man/os-release.html

Index ¶

Constants
func Read() (osrelease map[string]string, err error)
func ReadFile(filename string) (osrelease map[string]string, err error)
func ReadString(content string) (osrelease map[string]string, err error)

Constants ¶

View Source

const EtcOsRelease string = "/etc/os-release"

View Source

const UsrLibOsRelease string = "/usr/lib/os-release"

Variables ¶

This section is empty.

Functions ¶

func Read ¶

func Read() (osrelease map[string]string, err error)

Read and return os-release, trying EtcOsRelease, followed by UsrLibOsRelease. err will contain an error message if neither file exists or failed to parse

Example ¶

osrelease, err := Read()
if err != nil {
	fmt.Printf("Error: %v\n", err)
	return
}
fmt.Printf("PRETTY_NAME = %v\n", osrelease["PRETTY_NAME"])

Output:

func ReadFile ¶

func ReadFile(filename string) (osrelease map[string]string, err error)

Similar to Read(), but takes the name of a file to load instead

Example ¶

osrelease, err := ReadFile("/etc/os-release")
if err != nil {
	fmt.Printf("Error: %v\n", err)
	return
}
fmt.Printf("PRETTY_NAME = %v\n", osrelease["PRETTY_NAME"])

Output:

func ReadString ¶

func ReadString(content string) (osrelease map[string]string, err error)

ReadString is similar to Read(), but takes a string to load instead

Types ¶

This section is empty.

Source Files ¶

View all Source files

osrelease.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL