hawat.config module¶

This module contains default configurations for Hawat application. One of the classes defined in this module may be passed as argument to hawat.app.create_app_full() factory function to bootstrap Hawat default configurations. These values may be then optionally overwritten by external configuration file and/or additional configuration file defined indirrectly via environment variable. Please refer to the documentation of hawat.app.create_app_full() factory function for more details on this process.

There are following predefined configuration classess available:

hawat.config.ProductionConfig: Default configuration suite for production environments.
hawat.config.DevelopmentConfig: Default configuration suite for development environments.
hawat.config.TestingConfig: Default configuration suite for testing environments.

There is also following constant structure containing mapping of simple configuration names to configuration classess:

CONFIG_MAP

It is used from inside hawat.app.create_app() factory method to pick and apply correct configuration class to application. Please refer to the documentation of hawat.app.create_app() factory function for more details on this process.

hawat.config.CONFIG_MAP = {'default': <class 'hawat.config.ProductionConfig'>, 'development': <class 'hawat.config.DevelopmentConfig'>, 'production': <class 'hawat.config.ProductionConfig'>, 'testing': <class 'hawat.config.TestingConfig'>}¶: Configuration map for easy mapping of configuration aliases to config objects.

class hawat.config.Config[source]¶

Bases: object

Base class for default configurations of Hawat application. You are free to extend and customize contents of this class to provide better default values for your particular environment.

The configuration keys must be a valid Flask configuration, and so they must be written in UPPERCASE to be correctly recognized.

APPLICATION_ID = 'mentat'¶

APPLICATION_NAME = 'Mentat'¶

BABEL_DEFAULT_LOCALE = 'en'¶

BABEL_DEFAULT_TIMEZONE = 'UTC'¶

BABEL_DETECT_LOCALE = True¶: Custom configuration, make detection of best possible locale optional to enable forcing default.

DEBUG = False¶

DISABLED_ENDPOINTS = []¶: List of endpoints disabled on application level.

DISABLE_MAIL_LOGGING = False¶

EMAIL_ADMINS = ['root@alchemist.cesnet.cz']¶: List of system administrator emails.

ENABLED_BLUEPRINTS = ['hawat.blueprints.auth', 'hawat.blueprints.auth_api', 'hawat.blueprints.design_bs3', 'hawat.blueprints.devtools', 'hawat.blueprints.changelogs', 'hawat.blueprints.auth_env', 'hawat.blueprints.auth_pwd', 'hawat.blueprints.home', 'hawat.blueprints.reports', 'hawat.blueprints.events', 'hawat.blueprints.hosts', 'hawat.blueprints.timeline', 'hawat.blueprints.dnsr', 'hawat.blueprints.geoip', 'hawat.blueprints.whois', 'hawat.blueprints.performance', 'hawat.blueprints.status', 'hawat.blueprints.dbstatus', 'hawat.blueprints.users', 'hawat.blueprints.groups', 'hawat.blueprints.settings_reporting', 'hawat.blueprints.filters', 'hawat.blueprints.networks']¶: List of requested application blueprints to be loaded during setup.

ENDPOINT_HOME = 'home.index'¶: Homepage endpoint.

ENDPOINT_LOGIN = 'auth.login'¶: Default login view. Users will be redirected to this view in case they are not authenticated, but the authentication is required for the requested endpoint.

ENDPOINT_LOGIN_REDIRECT = 'home.index'¶: Default redirection endpoint after login.

ENDPOINT_LOGOUT_REDIRECT = 'home.index'¶: Default redirection endpoint after logout.

HAWAT_CHART_TIMELINE_MAXSTEPS = 200¶: Maximal number of steps (bars) displayed in timeline chart.

HAWAT_LIMIT_AODS = 20¶: Limit for number of objects for which to automatically fetch additional data services.

HAWAT_REPORT_FEEDBACK_MAILS = ['root@alchemist.cesnet.cz']¶: List of system administrator emails, that receive feedback messages for reports.

HAWAT_SEARCH_QUERY_QUOTA = 7¶: Event search query quota per each user.

ICONS = {'action-add-member': '', 'action-create': '', 'action-create-user': '', 'action-delete': '', 'action-delete-user': '', 'action-disable': '', 'action-disable-user': '', 'action-download': '', 'action-download-csv': '', 'action-download-js': '', 'action-download-svg': '', 'action-download-zip': '', 'action-enable': '', 'action-enable-user': '', 'action-genkey': '', 'action-mail': '', 'action-more': '', 'action-rej-member': '', 'action-reload': '', 'action-rem-member': '', 'action-save': '', 'action-search': '', 'action-show': '', 'action-show-user': '', 'action-sort': '', 'action-sort-asc': '', 'action-sort-desc': '', 'action-stop': '', 'action-update': '', 'action-update-user': '', 'actions': '', 'ajax-loader': '', 'alert-danger': '', 'alert-info': '', 'alert-success': '', 'alert-warning': '', 'anchor': '', 'avg': '', 'backtotop': '', 'calendar': '', 'caret-down': '', 'check': '', 'check_blank': '', 'clock': '', 'cnt': '', 'cog': '', 'collapse': '', 'compress': '', 'debug': '', 'domain': '', 'eventclss': '', 'expand': '', 'export': '', 'first': '', 'form-error': '', 'help': '', 'import': '', 'item-disabled': '', 'item-enabled': '', 'ko': '', 'language': '', 'last': '', 'liitem': '', 'list': '', 'login': '', 'logout': '', 'mail': '', 'max': '', 'med': '', 'min': '', 'missing-icon': '', 'modal-question': '', 'module-auth-api': '', 'module-auth-dev': '', 'module-auth-env': '', 'module-changelogs': '', 'module-dashboards': '', 'module-dbstatus': '', 'module-design': '', 'module-devtools': '', 'module-dnsr': '', 'module-events': '', 'module-filters': '', 'module-geoip': '', 'module-groups': '', 'module-help': '', 'module-home': '', 'module-hosts': '', 'module-nerd': '', 'module-networks': '', 'module-pdnsr': '', 'module-performance': '', 'module-reports': '', 'module-settings-reporting': '', 'module-skeleton': '', 'module-status': '', 'module-timeline': '', 'module-users': '', 'module-whois': '', 'mute': '', 'na': '', 'next': '', 'ok': '', 'playground': '', 'previous': '', 'profile': '', 'quicksearch': '', 'r-s-critical': '', 'r-s-high': '', 'r-s-low': '', 'r-s-medium': '', 'r-s-unknown': '', 'r-t-extra': '', 'r-t-summary': '', 'redirect': '', 'reference': '', 'register': '', 'report-data-filtered': '', 'report-data-mailed': '', 'report-data-relapsed': '', 'report-data-test': '', 'role-admin': '', 'role-anonymous': '', 'role-developer': '', 'role-maintainer': '', 'role-user': '', 'search': '', 'section-administration': '', 'section-dashboards': '', 'section-development': '', 'section-home': '', 'section-more': '', 'sortasc': '', 'sortdesc': '', 'stats': '', 'stopwatch': '', 'structure': '', 'sum': '', 'table': '', 'time-from': '', 'time-to': '', 'unassigned': '', 'uncompress': '', 'undisclosed': '', 'unmute': '', 'unredirect': '', 'validate': '', 'weight': ''}¶

LOGIN_MSGCAT = 'info'¶: Default message category for messages related to user authentication.

LOG_DEFAULT_LEVEL = 'info'¶: Default logging level, case insensitive. One of the values DEBUG, INFO, WARNING, ERROR, CRITICAL.

LOG_EMAIL_LEVEL = 'error'¶: File logging level, case insensitive. One of the values DEBUG, INFO, WARNING, ERROR, CRITICAL.

LOG_FILE_LEVEL = 'info'¶: File logging level, case insensitive. One of the values DEBUG, INFO, WARNING, ERROR, CRITICAL.

MAIL_DEFAULT_SENDER = 'mentat@alchemist.cesnet.cz'¶

MAIL_PASSWORD = None¶

MAIL_PORT = 25¶

MAIL_SERVER = 'localhost'¶

MAIL_SUBJECT_PREFIX = '[Mentat]'¶

MAIL_USERNAME = None¶

MENU_MAIN_SKELETON = [{'entry_type': 'submenu', 'ident': 'dashboards', 'position': 100, 'title': l'Dashboards', 'resptitle': True, 'icon': 'section-dashboards'}, {'entry_type': 'submenu', 'ident': 'more', 'position': 200, 'title': l'More', 'resptitle': True, 'icon': 'section-more'}, {'entry_type': 'submenu', 'ident': 'admin', 'position': 300, 'authentication': True, 'authorization': ['power'], 'title': l'Administration', 'resptitle': True, 'icon': 'section-administration'}, {'entry_type': 'submenu', 'ident': 'developer', 'position': 400, 'authentication': True, 'authorization': ['developer'], 'title': l'Development', 'resptitle': True, 'icon': 'section-development'}]¶: Configuration of application menu skeleton.

MIGRATE_DIRECTORY = '/home/buildbot/workers/worker-mentat-py3/mentat-doc/build/lib/hawat/migrations'¶

MODELS = {'group': <class 'mentat.datatype.sqldb.GroupModel'>, 'item_changelog': <class 'mentat.datatype.sqldb.ItemChangeLogModel'>, 'user': <class 'mentat.datatype.sqldb.UserModel'>}¶: Models to be used within the application.

ROLES = ['user', 'developer', 'maintainer', 'admin']¶: List of all valid user roles supported by the application.

SECRET_KEY = 'default-secret-key'¶

SESSION_COOKIE_SECURE = True¶

SQLALCHEMY_SETUP_ARGS = {'metadata': MetaData(bind=None), 'model_class': <class 'sqlalchemy.ext.declarative.api.Base'>, 'query_class': <class 'mentat.services.sqlstorage.RetryingQuery'>}¶

SQLALCHEMY_TRACK_MODIFICATIONS = False¶

SUPPORTED_LOCALES = {'cs': 'Česky', 'en': 'English'}¶: List of all languages (locales) supported by the application.

TESTING = False¶

WTF_CSRF_ENABLED = True¶

class hawat.config.DevelopmentConfig[source]¶

Bases: hawat.config.Config

Class containing application configurations for development environment.

DEBUG = True¶

ENABLED_BLUEPRINTS = ['hawat.blueprints.auth', 'hawat.blueprints.auth_api', 'hawat.blueprints.design_bs3', 'hawat.blueprints.devtools', 'hawat.blueprints.changelogs', 'hawat.blueprints.auth_env', 'hawat.blueprints.auth_dev', 'hawat.blueprints.auth_pwd', 'hawat.blueprints.home', 'hawat.blueprints.reports', 'hawat.blueprints.events', 'hawat.blueprints.hosts', 'hawat.blueprints.timeline', 'hawat.blueprints.dnsr', 'hawat.blueprints.geoip', 'hawat.blueprints.whois', 'hawat.blueprints.performance', 'hawat.blueprints.status', 'hawat.blueprints.dbstatus', 'hawat.blueprints.users', 'hawat.blueprints.groups', 'hawat.blueprints.settings_reporting', 'hawat.blueprints.filters', 'hawat.blueprints.networks']¶

ENDPOINT_LOGIN = 'auth_dev.login'¶

LOG_DEFAULT_LEVEL = 'debug'¶

LOG_FILE_LEVEL = 'debug'¶

class hawat.config.ProductionConfig[source]¶

Bases: hawat.config.Config

Class containing application configurations for production environment.

class hawat.config.TestingConfig[source]¶

Bases: hawat.config.Config

Class containing testing Hawat applications` configurations.

ENABLED_BLUEPRINTS = ['hawat.blueprints.auth', 'hawat.blueprints.auth_api', 'hawat.blueprints.design_bs3', 'hawat.blueprints.devtools', 'hawat.blueprints.changelogs', 'hawat.blueprints.auth_env', 'hawat.blueprints.auth_dev', 'hawat.blueprints.auth_pwd', 'hawat.blueprints.home', 'hawat.blueprints.reports', 'hawat.blueprints.events', 'hawat.blueprints.hosts', 'hawat.blueprints.timeline', 'hawat.blueprints.dnsr', 'hawat.blueprints.geoip', 'hawat.blueprints.whois', 'hawat.blueprints.performance', 'hawat.blueprints.status', 'hawat.blueprints.dbstatus', 'hawat.blueprints.users', 'hawat.blueprints.groups', 'hawat.blueprints.settings_reporting', 'hawat.blueprints.filters', 'hawat.blueprints.networks']¶

ENDPOINT_LOGIN = 'auth_dev.login'¶

EXPLAIN_TEMPLATE_LOADING = False¶

TESTING = True¶

hawat.config.get_app_root_relative_config()[source]¶: These configurations are relative to APP_ROOT_PATH environment setting and must be handled separately.

hawat.config.get_default_config_file()[source]¶: Get path to default configuration file based on the environment.