config Package

environment

Environment related checks or operations are to be defined here.

class tvb.basic.config.environment.Environment

Bases: object

IS_WORK_IN_PROGRESS = False

append_to_path(*paths)

Set PATH :param paths: list of absolute folder paths to join and add BEFORE the current PATH

get_library_folder(default_mac)

Return top level library folder. Will be use for setting paths

static is_distribution()

Return True when TVB is used with Python installed natively (with GitHub clone, SVN, pip or conda)

is_framework_present()

Returns:True when framework classes are present and can be imported.

is_linux()

is_linux_deployment()

Return True if current run is not development and is running on Linux.

static is_mac()

is_mac_deployment()

Return True if current run is not development and is running on Mac OS X

static is_windows()

is_windows_deployment()

Return True if current run is not development and is running on Windows.

setup_python_path(*paths)

Set PYTHONPATH :param paths: list of absolute folder paths to join.

setup_tk_tcl_environ(root_folder)

Given a root folder to look in, find the required configuration files for TCL/TK and set the proper environmental variables so everything works fine in the distribution package.

Parameters:root_folder – the top folder from which to start looking for the required configuration files

profile_settings

Prepare TVB settings to be grouped under various profile classes.

class tvb.basic.config.profile_settings.BaseSettingsProfile(web_enabled=True)

Bases: object

ACCESS_MODE_TVB_FILES = 484

BIN_FOLDER

Return path towards tvb_bin location. It will be used in some environment for determining the starting point

DEFAULT_STORAGE = '/home/tester/TVB/'

FIRST_RUN_STORAGE = '/home/tester/.tvb-temp'

LOGGER_CONFIG_FILE_NAME = 'logger_config.conf'

MAGIC_NUMBER = 9

PYTHON_INTERPRETER_PATH

Get Python path, based on current environment.

TVB_CONFIG_FILE = '/home/tester/.tvb.configuration'

TVB_USER_HOME = '~'

initialize_for_deployment()

initialize_profile()

Make sure tvb folders are created.

prepare_for_operation_mode()

Overwrite PostgreSQL number of connections when executed in the context of a node.

class tvb.basic.config.profile_settings.LibrarySettingsProfile

Bases: tvb.basic.config.profile_settings.BaseSettingsProfile

Profile used when scientific library is used without storage and without web UI.

LOGGER_CONFIG_FILE_NAME = 'library_logger.conf'

TVB_STORAGE = '/home/tester/TVB/'

initialize_profile()

Make sure some warning are thrown when trying to import from framework.

class tvb.basic.config.profile_settings.MATLABLibraryProfile

Bases: tvb.basic.config.profile_settings.LibrarySettingsProfile

Profile use library use from MATLAB.

LOGGER_CONFIG_FILE_NAME = None

class tvb.basic.config.profile_settings.TestLibraryProfile

Bases: tvb.basic.config.profile_settings.LibrarySettingsProfile

Profile for library unit-tests.

LOGGER_CONFIG_FILE_NAME = 'library_logger_test.conf'

settings

TVB Raw Settings are defined here, grouped by their category of usage (e.g. cluster related, web related, etc). Do not instantiate these classes directly, but rather use them through TvpProfile.current instance.

class tvb.basic.config.settings.ClusterSettings(manager)

Bases: object

Cluster related settings.

CLUSTER_NODE_NAME

:return the name of the cluster on which TVB code is executed.

If code is executed on a normal machine (not cluster node) returns None

IN_OPERATION_EXECUTION_PROCESS = False

IS_RUNNING_ON_CLUSTER_NODE

Returns True if current execution happens on cluster node. Even when IS_DEPLOY is True, this call will return False for the web machine.

JOB_ID_STRING

NODE_ENV

SCHEDULER_OAR = 'oar'

SCHEDULER_SLURM = 'slurm'

SCHEDULE_COMMAND

STATUS_COMMAND

STOP_COMMAND

class tvb.basic.config.settings.DBSettings(manager, default_storage, current_storage)

Bases: object

ALLOW_NESTED_TRANSACTIONS = False

MAX_ASYNC_CONNECTIONS = 2

MAX_CONNECTIONS = 20

class tvb.basic.config.settings.VersionSettings(manager, bin_folder)

Bases: object

Gather settings related to various version numbers of TVB application

BASE_VERSION = '1.5.6'

DATA_VERSION = 4

DATA_VERSION_ATTRIBUTE = 'Data_version'

DB_STRUCTURE_VERSION = 17

PROJECT_VERSION = 2

SVN_VERSION

Current SVN version in the package running now.

static parse_svn_version(version_string)

class tvb.basic.config.settings.WebAdminSettings(manager)

Bases: object

Setting related to the default users of web-tvb

ADMINISTRATOR_BLANK_PWD = 'pass'

DEFAULT_ADMIN_EMAIL = 'jira.tvb@gmail.com'

SYSTEM_USER_NAME = 'TVB system'

class tvb.basic.config.settings.WebSettings(manager, enabled)

Bases: object

Web related specifications

ENABLED = False

LOCALHOST = '127.0.0.1'

RENDER_HTML = True

VISUALIZERS_ROOT = 'tvb.interfaces.web.templates.genshi.visualizers'

VISUALIZERS_URL_PREFIX = '/flow/read_datatype_attribute/'

stored

Manages reading and writing settings in file

class tvb.basic.config.stored.SettingsManager(config_file_location)

Bases: object

add_entries_to_config_file(input_data)

Add to the dictionary of settings already existent in the settings file.

Parameters:input_data – A dictionary of pairs that need to be added to the config file.

get_attribute(key, default=None, dtype=<type 'str'>)

Get a cfg attribute that could also be found in the settings file.

is_first_run()

write_config_data(config_dict)

Overwrite anything already existent in the config file

utils

Helper tools, for the configuration area.

class tvb.basic.config.utils.EnhancedDictionary

Bases: dict

A dictionary like class that provides easy access to configuration values.

exception tvb.basic.config.utils.LibraryImportError

Bases: exceptions.ImportError

This is just a flag telling us at “reload” that a module was rejected due to our custom exception

class tvb.basic.config.utils.LibraryModulesFinder

In case users run TVB in ‘library’ profile access should be restricted to some parts of tvb, to avoid errors from those parts (which are not excepted to run with library settings).

find_module(fullname, path=None)

load_module(module_name)

restricted_modules = ['tvb.interfaces', 'tvb.datatype_removers', 'tvb.core', 'tvb.config', 'tvb.adapters']