sysfacts

sysfacts is a system information collector.

It can be used standalone or as a library. In order to achieve its goals, sysfacts tries to leverage existing cross-platform python libraries.

Installation

pipx

The recommended installation method is pipx. More specifically, if you need to run sysfacts just once, you can do it from a temporary virtual environment with:

pipx run sysfacts

If you need to actually install sysfacts for your user you can do it with:

pipx install sysfacts

This command will create a virtual environment in ~/.local/pipx/venvs/sysfacts and add the sysfacts script in ~/.local/bin.

pip

Alternatively you can use good old pip but this is more fragile than pipx.

pip install --user sysfacts

As a dependency for another project

If you use poetry, you can use:

poetry add sysfacts

Usage

Standalone

On standalone mode the output format can be either JSON or YAML. You can also choose between a JSON data blob or colored, pretty-printed output.

sysfacts --help
# JSON output
sysfacts
sysfacts --pretty
sysfacts --pretty --color
# YAML output
sysfacts --yaml
sysfacts --yaml --color

API

The main function is collect_facts() which returns a python dictionary.

from sysfacts import collect_facts

facts = collect_facts()

Alternative projects

Well, this is not really unique, since there are several similar projects out there

• puppet's facter
• chef's ohai is written in ruby.
• datadog's gohai is written in go.
• if you have ansible installed you can also use ansible local -m setup.