# -*- coding: utf-8 -*-
###########################################################################
# Copyright (c), The AiiDA team. All rights reserved. #
# This file is part of the AiiDA code. #
# #
# The code is hosted on GitHub at https://github.com/aiidateam/aiida-core #
# For further information on the license, see the LICENSE.txt file #
# For further information please visit http://www.aiida.net #
###########################################################################
"""
AiiDA is a flexible and scalable informatics' infrastructure to manage,
preserve, and disseminate the simulations, data, and workflows of
modern-day computational science.
Able to store the full provenance of each object, and based on a
tailored database built for efficient data mining of heterogeneous results,
AiiDA gives the user the ability to interact seamlessly with any number of
remote HPC resources and codes, thanks to its flexible plugin interface
and workflow engine for the automation of complex sequences of simulations.
More information at http://www.aiida.net
"""
import warnings
from aiida.common.log import configure_logging
from aiida.common.warnings import AiidaDeprecationWarning
from aiida.manage.configuration import get_config_option, get_profile, load_profile
__copyright__ = (
'Copyright (c), This file is part of the AiiDA platform. '
'For further information please visit http://www.aiida.net/. All rights reserved.'
)
__license__ = 'MIT license, see LICENSE.txt file.'
__version__ = '1.2.1'
__authors__ = 'The AiiDA team.'
__paper__ = (
'G. Pizzi, A. Cepellotti, R. Sabatini, N. Marzari, and B. Kozinsky,'
'"AiiDA: automated interactive infrastructure and database for computational science", '
'Comp. Mat. Sci 111, 218-230 (2016); https://doi.org/10.1016/j.commatsci.2015.09.013 '
'- http://www.aiida.net.'
)
__paper_short__ = 'G. Pizzi et al., Comp. Mat. Sci 111, 218 (2016).'
[docs]def load_dbenv(profile=None):
"""Alias for `load_dbenv` from `aiida.backends.utils`
:param profile: name of the profile to load
:type profile: str
.. deprecated:: 1.0.0
Will be removed in `v2.0.0`, use :func:`aiida.manage.configuration.load_profile` instead.
"""
warnings.warn('function is deprecated, use `load_profile` instead', AiidaDeprecationWarning) # pylint: disable=no-member
current_profile = get_profile()
from aiida.common import InvalidOperation
if current_profile:
raise InvalidOperation('You cannot call load_dbenv multiple times!')
load_profile(profile)
[docs]def try_load_dbenv(profile=None):
"""Run `load_dbenv` unless the dbenv has already been loaded.
:param profile: name of the profile to load
:type profile: str
:returns: whether profile was loaded
:rtype: bool
.. deprecated:: 1.0.0
Will be removed in `v2.0.0`, use :func:`aiida.manage.configuration.load_profile` instead.
"""
warnings.warn('function is deprecated, use `load_profile` instead', AiidaDeprecationWarning) # pylint: disable=no-member
if not is_dbenv_loaded():
load_dbenv(profile)
return True
return False
[docs]def is_dbenv_loaded():
"""Determine whether database environment is already loaded.
:rtype: bool
.. deprecated:: 1.0.0
Will be removed in `v2.0.0`, use :func:`aiida.manage.configuration.load_profile` instead.
"""
warnings.warn('function is deprecated, use `load_profile` instead', AiidaDeprecationWarning) # pylint: disable=no-member
return get_profile() is not None
[docs]def get_strict_version():
"""
Return a distutils StrictVersion instance with the current distribution version
:returns: StrictVersion instance with the current version
:rtype: :class:`!distutils.version.StrictVersion`
"""
from distutils.version import StrictVersion
return StrictVersion(__version__)
[docs]def get_version():
"""
Return the current AiiDA distribution version
:returns: the current version
:rtype: str
"""
return __version__