sysinfo

README

sysinfo

🍪 Buy me a cookie

What is this?

Provides system info for use by other tools.

How to install

Open a terminal and run the following:

$ go get --ldflags "-s -w" --trimpath -u gitlab.com/mjwhitta/sysinfo
$ go install --ldflags "-s -w" --trimpath \
    gitlab.com/mjwhitta/sysinfo/cmd/sysinfo@latest

Or install from source:

$ git clone https://gitlab.com/mjwhitta/sysinfo.git
$ cd sysinfo
$ git submodule update --init
$ make install

Note: make install will install to $HOME/.local/bin.

How to use

$ sysinfo

package main

import (
    "fmt"

    "gitlab.com/mjwhitta/sysinfo"
)

func main() {
    fmt.Println(sysinfo.New())
}

Configuration

Configuration is stored in $HOME/.config/sysinfo/rc. The default config looks like:

{
  "kbg": "on_default",
  "kfg": "blue",
  "vbg": "on_default",
  "vfg": "green"
}

These values can be changed to adjust the key/value bg/fg colors.

Links

• Source

TODO

• Better README.md

Documentation

Index

• Constants
• type SysInfo
  • func New(fields ...string) *SysInfo
  • func (s *SysInfo) Clear()
  • func (s *SysInfo) Collect()
  • func (s *SysInfo) SetDataColors(colors ...string)
  • func (s *SysInfo) SetFieldColors(colors ...string)
  • func (s *SysInfo) String() string

Constants

const Version = "1.4.3"

Version is the package version

Types

type SysInfo

type SysInfo struct {
	Colors string `json:"-"`
	CPU    string `json:"CPU,omitempty"`

	Height int    `json:"-"`
	HomeFS string `json:"HomeFS,omitempty"`
	Host   string `json:"Host,omitempty"`

	IPv4   string `json:"IPv4,omitempty"`
	IPv6   string `json:"IPv6,omitempty"`
	Kernel string `json:"Kernel,omitempty"`

	OS     string `json:"OS,omitempty"`
	RAM    string `json:"RAM,omitempty"`
	RootFS string `json:"RootFS,omitempty"`
	Shell  string `json:"Shell,omitempty"`
	TTY    string `json:"TTY,omitempty"`
	Uptime string `json:"Uptime,omitempty"`
	Width  int    `json:"-"`
	// contains filtered or unexported fields
}

SysInfo is a struct containing relevant system information.

func New

func New(fields ...string) *SysInfo

New will return a SysInfo pointer. A list of fields can be supplied if all info is not wanted.

func (*SysInfo) Clear

func (s *SysInfo) Clear()

Clear will remove all system info.

func (*SysInfo) Collect

func (s *SysInfo) Collect()

Collect will get requested system info.

func (*SysInfo) SetDataColors

func (s *SysInfo) SetDataColors(colors ...string)

SetDataColors will set the color values for the field data. See gitlab.com/mjwhitta/hilighter for valid colors.

func (*SysInfo) SetFieldColors

func (s *SysInfo) SetFieldColors(colors ...string)

SetFieldColors will set the color values for the field names. See gitlab.com/mjwhitta/hilighter for valid colors.

func (*SysInfo) String

func (s *SysInfo) String() string

String will convert the SysInfo struct to a printable string.