Skip to main content

Return facts of server

Project description

Returns facts of local machine.


pip install facts

CLI Usage

Get all facts:

facts all

Get one fact:

fact read foo

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


is: bar
not: baz


fact read foo:is




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

1. by modules

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

# ~/.facts/grafts/

from . import graft

def hello_world():
    return {
        'hello': 'world'

Will append the fact hello with the value world.

2. with setuptools

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

    'facts.graft': [
        'plugin-1 = mylib:plugin_1',
        'plugin-2 = mylib:plugin_2'

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

facts-0.2.tar.gz (6.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page