system-query 0.2.0

comprehensive and concise system information querying tool

Comprehensive and concise system information tool.

The goal is to gather all relevant:

• hardware information (processors, accelerators, memory, networks, drives)

• static operating system information (name, version, hostname)

• runtime information (environment, libraries, system load, etc.)

and provide them in a concise form that’s both machine- and human-readable.

Another important goal is to also be fail-safe, even with unexpected hardware configurations, low-level tool errors and deal with incomplete information.

You can use system-query as a library and as a command-line tool.

Contents

• Motiviation

  • Where am I running?

  • How to rerun this experiment?

• Using

  • As library

  • As command-line tool

• Requirements

• Contributors

Motiviation

Where am I running?

One of the main motivations for creating system-query is to assist with answering the question “what is the actual hardware and software configuration of the system I’m using?” regardless of the official specification.

How to rerun this experiment?

The system-query was also created to assist with the computational experiment reproducibility and verification of results. Only if you know exactly where you ran your experiment, you can reason about its results and be able to reproduce them.

Using

As library

In [1]: from system_query import query_cpu
        query_cpu()

Out[1]: {'brand': 'Intel(R) Core(TM) i7-3770K CPU @ 3.50GHz',
         'clock': 1771.0370000000003,
         'clock_max': 3900.0,
         'clock_min': 1600.0,
         'logical_cores': 8,
         'physical_cores': 4}

More examples in examples.ipynb.

As command-line tool

For example:

$ python3 -m system_query
{'cpu': {'brand': 'Intel(R) Core(TM) i7-3770K CPU @ 3.50GHz',
         'clock': 1725.031125,
         'clock_max': 3900.0,
         'clock_min': 1600.0,
         'logical_cores': 8,
         'physical_cores': 4},
 'gpus': [],
 'host': 'TestMachine',
 'os': 'Linux-4.4.0-109-generic-x86_64-with-debian-stretch-sid',
 'ram': {'total': 33701269504},
 'swap': 0}

Usage information:

$ python3 -m system_query -h
usage: system_query [-h] [-s {all,cpu,gpu,ram}] [-f {raw,json}] [-t TARGET]
                    [--version]

Comprehensive and concise system information tool. Query a given hardware
and/or softawre scope of your system and get results in human- and machine-
readable formats.

optional arguments:
  -h, --help            show this help message and exit
  -s {all,cpu,gpu,ram}, --scope {all,cpu,gpu,ram}
                        Scope of the query (default: all)
  -f {raw,json}, --format {raw,json}
                        Format of the results of the query. (default: raw)
  -t TARGET, --target TARGET
                        File path where to write the results of the query.
                        Special values: "stdout" and "stderr" to write to
                        stdout and stderr, respectively. (default: stdout)
  --version             show program's version number and exit

Copyright 2017-2018 by the contributors, Apache License 2.0,
https://github.com/mbdevpl/system-query

Requirements

Python version 3.5 or later.

Python libraries as specified in requirements.txt. Recommended (but optional) packages are listed in optional_requirements.txt.

Building and running tests additionally requires packages listed in test_requirements.txt.

Tested on Linux, OS X and Windows.

Contributors

Aleksandr Drozd

Mateusz Bysiek

For licensing information, please see LICENSE and NOTICE.