Returns facts of local machine.

pip install facts

Get all facts:

facts all

Get one fact:

fact read foo

Get the human readable memory usage:

fact read memory --human

Set one custom fact:

fact write foo 'It is nice'

When value is a mapping, then you can choose between 2 merging strategies:

fact write foo '{is: bar}' --format yaml --replace
fact write foo '{not: baz}' --format yaml --merge

Delete a custom fact:

fact delete foo

By convention key facts can't have colon marks. Because facts can be nested, and it's possible to target these sub data. Each parts must be seperated by a colon. For example if:

fact read foo

returns:

is: bar
not: baz

Then:

fact read foo:is

returns:

bar

But:

fact read foo:wrong:key

will return nothing.

It is also possible to check if a certain fact turns out true:

fact match foo:is:bar

Facts allow you to extends with 'grafts'. There is 2 ways

You can extend with your own facts. Any python modules under ~/.facts/grafts will be loaded. For example:

# ~/.facts/grafts/my_grafts.py

from facts import graft, mark

@graft
def hello_world():
    return {
        'hello': 'world',
        'size': mark(1234567890, 'bytes')
    }

Will append the fact hello with the value world, and the fact size with one of these values (depending the --human switch) 1234567890 or 1.1G.

You also write python libraries that will contribute to facts with using setuptools. Add the following to the setup.py function:

entry_points={
    'facts.graft': [
        'plugin-1 = mylib:plugin_1',
        'plugin-2 = mylib:plugin_2'
    ]
}