Config

This module holds the Nutils global configuration, stored as (immutable) attributes. To inspect the current configuration, use print() or vars() on this module. The configuration can be changed temporarily by calling this module with the new settings passed as keyword arguments and entering the returned context. The old settings are restored as soon as the context is exited. Example:

>>> from nutils import config
>>> config.verbose
4
>>> with config(verbose=2, nprocs=4):
...   # The configuration has been updated.
...   config.verbose
2
>>> # Exiting the context reverts the changes:
>>> config.verbose
4

Note

The default entry point for Nutils scripts nutils.cli.run() (and nutils.cli.choose()) will read user configuration from disk.

Important

The configuration is not thread-safe: changing the configuration inside a thread changes the process wide configuration.