README
¶
distrodetector
Detects which Linux distro or BSD a system is running.
Aims to detect:
- The 100 most popular Linux distros and BSDs, according to distrowatch
- macOS
The distro utility and the distrodetector package has no external dependencies.
Pull requests for additional systems are welcome!
Installation of the distro utility
The distro utility can be used as a drop-in replacement for the distro command that comes with python-distro.
Installation of the development version of the distro utility:
go get -u github.com/xyproto/distrodetector/cmd/distro
Example use:
distro
Use of the Go package
package main
import (
"fmt"
"github.com/xyproto/distrodetector"
)
func main() {
distro := distrodetector.New()
fmt.Println(distro.Name())
}
Example output
The parts can be retrieved separately with .Platform(), .Name(), .Codename() and .Version(). A combined string can be returned with the .String() function:
Linux (Arch Linux)
Linux (Ubuntu Bionic 18.04)
macOS (High Sierra 10.13.3)
Linux (Void Linux)
Testing
- More testing is always needed when detecting Linux distros and BSDs.
- Please test the distro detection on your distro/BSD and submit an issue or pull request if it should fail.
General Info
- License: BSD-3
- Version: 1.3.1
- Author: Alexander F. Rødseth <xyproto@archlinux.org>
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AppleCodename ¶
AppleCodename returns a codename, or an empty string. Will first use the lookup table, and then try to fetch it from Apple over HTTP.
Types ¶
type Distro ¶
type Distro struct {
// contains filtered or unexported fields
}
Distro represents the platform, contents of /etc/*release* and name of the detected Linux distribution or BSD.
func New ¶
func New() *Distro
New detects the platform and distro/BSD, then returns a pointer to a Distro struct.
func (*Distro) Codename ¶
Codename returns the detected codename of the current distro/BSD, or an empty string.
func (*Distro) EtcRelease ¶
EtcRelease returns the contents of /etc/*release + /etc/issue, or an empty string. The contents are cached.
func (*Distro) Grep ¶
Grep /etc/*release* for the given string. If the search fails, a case-insensitive string search is attempted. The contents of /etc/*release* is cached.
func (*Distro) Platform ¶
Platform returns the name of the current platform. This is the same as `runtime.GOOS`, but capitalized.
Source Files
Directories