Help on module flask.config in flask:
NAME
flask.config
DESCRIPTION
flask.config
~~~~~~~~~~~~
Implements the configuration related objects.
:copyright: 2010 Pallets
:license: BSD-3-Clause
CLASSES
builtins.dict(builtins.object)
Config
builtins.object
ConfigAttribute
class Config(builtins.dict)
| Config(root_path, defaults=None)
|
| Works exactly like a dict but provides ways to fill it from files
| or special dictionaries. There are two common patterns to populate the
| config.
|
| Either you can fill the config from a config file::
|
| app.config.from_pyfile('yourconfig.cfg')
|
| Or alternatively you can define the configuration options in the
| module that calls :meth:`from_object` or provide an import path to
| a module that should be loaded. It is also possible to tell it to
| use the same module and with that provide the configuration values
| just before the call::
|
| DEBUG = True
| SECRET_KEY = 'development key'
| app.config.from_object(__name__)
|
| In both cases (loading from any Python file or loading from modules),
| only uppercase keys are added to the config. This makes it possible to use
| lowercase values in the config file for temporary values that are not added
| to the config or to define the config keys in the same file that implements
| the application.
|
| Probably the most interesting way to load configurations is from an
| environment variable pointing to a file::
|
| app.config.from_envvar('YOURAPPLICATION_SETTINGS')
|
| In this case before launching the application you have to set this
| environment variable to the file you want to use. On Linux and OS X
| use the export statement::
|
| export YOURAPPLICATION_SETTINGS='/path/to/config/file'
|
| On windows use `set` instead.
|
| :param root_path: path to which files are read relative from. When the
| config object is created by the application, this is
| the application's :attr:`~flask.Flask.root_path`.
| :param defaults: an optional dictionary of default values
|
| Method resolution order:
| Config
| builtins.dict
| builtins.object
|
| Methods defined here:
|
| __init__(self, root_path, defaults=None)
| Initialize self. See help(type(self)) for accurate signature.
|
| __repr__(self)
| Return repr(self).
|
| from_envvar(self, variable_name, silent=False)
| Loads a configuration from an environment variable pointing to
| a configuration file. This is basically just a shortcut with nicer
| error messages for this line of code::
|
| app.config.from_pyfile(os.environ['YOURAPPLICATION_SETTINGS'])
|
| :param variable_name: name of the environment variable
| :param silent: set to ``True`` if you want silent failure for missing
| files.
| :return: bool. ``True`` if able to load config, ``False`` otherwise.
|
| from_json(self, filename, silent=False)
| Updates the values in the config from a JSON file. This function
| behaves as if the JSON object was a dictionary and passed to the
| :meth:`from_mapping` function.
|
| :param filename: the filename of the JSON file. This can either be an
| absolute filename or a filename relative to the
| root path.
| :param silent: set to ``True`` if you want silent failure for missing
| files.
|
| .. versionadded:: 0.11
|
| from_mapping(self, *mapping, **kwargs)
| Updates the config like :meth:`update` ignoring items with non-upper
| keys.
|
| .. versionadded:: 0.11
|
| from_object(self, obj)
| Updates the values from the given object. An object can be of one
| of the following two types:
|
| - a string: in this case the object with that name will be imported
| - an actual object reference: that object is used directly
|
| Objects are usually either modules or classes. :meth:`from_object`
| loads only the uppercase attributes of the module/class. A ``dict``
| object will not work with :meth:`from_object` because the keys of a
| ``dict`` are not attributes of the ``dict`` class.
|
| Example of module-based configuration::
|
| app.config.from_object('yourapplication.default_config')
| from yourapplication import default_config
| app.config.from_object(default_config)
|
| Nothing is done to the object before loading. If the object is a
| class and has ``@property`` attributes, it needs to be
| instantiated before being passed to this method.
|
| You should not use this function to load the actual configuration but
| rather configuration defaults. The actual config should be loaded
| with :meth:`from_pyfile` and ideally from a location not within the
| package because the package might be installed system wide.
|
| See :ref:`config-dev-prod` for an example of class-based configuration
| using :meth:`from_object`.
|
| :param obj: an import name or object
|
| from_pyfile(self, filename, silent=False)
| Updates the values in the config from a Python file. This function
| behaves as if the file was imported as module with the
| :meth:`from_object` function.
|
| :param filename: the filename of the config. This can either be an
| absolute filename or a filename relative to the
| root path.
| :param silent: set to ``True`` if you want silent failure for missing
| files.
|
| .. versionadded:: 0.7
| `silent` parameter.
|
| get_namespace(self, namespace, lowercase=True, trim_namespace=True)
| Returns a dictionary containing a subset of configuration options
| that match the specified namespace/prefix. Example usage::
|
| app.config['IMAGE_STORE_TYPE'] = 'fs'
| app.config['IMAGE_STORE_PATH'] = '/var/app/images'
| app.config['IMAGE_STORE_BASE_URL'] = 'http://img.website.com'
| image_store_config = app.config.get_namespace('IMAGE_STORE_')
|
| The resulting dictionary `image_store_config` would look like::
|
| {
| 'type': 'fs',
| 'path': '/var/app/images',
| 'base_url': 'http://img.website.com'
| }
|
| This is often useful when configuration options map directly to
| keyword arguments in functions or class constructors.
|
| :param namespace: a configuration namespace
| :param lowercase: a flag indicating if the keys of the resulting
| dictionary should be lowercase
| :param trim_namespace: a flag indicating if the keys of the resulting
| dictionary should not include the namespace
|
| .. versionadded:: 0.11
|
| ----------------------------------------------------------------------
| Data descriptors defined here:
|
| __dict__
| dictionary for instance variables (if defined)
|
| __weakref__
| list of weak references to the object (if defined)
|
| ----------------------------------------------------------------------
| Methods inherited from builtins.dict:
|
| __contains__(self, key, /)
| True if the dictionary has the specified key, else False.
|
| __delitem__(self, key, /)
| Delete self[key].
|
| __eq__(self, value, /)
| Return self==value.
|
| __ge__(self, value, /)
| Return self>=value.
|
| __getattribute__(self, name, /)
| Return getattr(self, name).
|
| __getitem__(...)
| x.__getitem__(y) <==> x[y]
|
| __gt__(self, value, /)
| Return self>value.
|
| __iter__(self, /)
| Implement iter(self).
|
| __le__(self, value, /)
| Return self<=value.
|
| __len__(self, /)
| Return len(self).
|
| __lt__(self, value, /)
| Return self<value.
|
| __ne__(self, value, /)
| Return self!=value.
|
| __reversed__(self, /)
| Return a reverse iterator over the dict keys.
|
| __setitem__(self, key, value, /)
| Set self[key] to value.
|
| __sizeof__(...)
| D.__sizeof__() -> size of D in memory, in bytes
|
| clear(...)
| D.clear() -> None. Remove all items from D.
|
| copy(...)
| D.copy() -> a shallow copy of D
|
| get(self, key, default=None, /)
| Return the value for key if key is in the dictionary, else default.
|
| items(...)
| D.items() -> a set-like object providing a view on D's items
|
| keys(...)
| D.keys() -> a set-like object providing a view on D's keys
|
| pop(...)
| D.pop(k[,d]) -> v, remove specified key and return the corresponding value.
| If key is not found, d is returned if given, otherwise KeyError is raised
|
| popitem(self, /)
| Remove and return a (key, value) pair as a 2-tuple.
|
| Pairs are returned in LIFO (last-in, first-out) order.
| Raises KeyError if the dict is empty.
|
| setdefault(self, key, default=None, /)
| Insert key with a value of default if key is not in the dictionary.
|
| Return the value for key if key is in the dictionary, else default.
|
| update(...)
| D.update([E, ]**F) -> None. Update D from dict/iterable E and F.
| If E is present and has a .keys() method, then does: for k in E: D[k] = E[k]
| If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v
| In either case, this is followed by: for k in F: D[k] = F[k]
|
| values(...)
| D.values() -> an object providing a view on D's values
|
| ----------------------------------------------------------------------
| Class methods inherited from builtins.dict:
|
| fromkeys(iterable, value=None, /) from builtins.type
| Create a new dictionary with keys from iterable and values set to value.
|
| ----------------------------------------------------------------------
| Static methods inherited from builtins.dict:
|
| __new__(*args, **kwargs) from builtins.type
| Create and return a new object. See help(type) for accurate signature.
|
| ----------------------------------------------------------------------
| Data and other attributes inherited from builtins.dict:
|
| __hash__ = None
class ConfigAttribute(builtins.object)
| ConfigAttribute(name, get_converter=None)
|
| Makes an attribute forward to the config
|
| Methods defined here:
|
| __get__(self, obj, type=None)
|
| __init__(self, name, get_converter=None)
| Initialize self. See help(type(self)) for accurate signature.
|
| __set__(self, obj, value)
|
| ----------------------------------------------------------------------
| Data descriptors defined here:
|
| __dict__
| dictionary for instance variables (if defined)
|
| __weakref__
| list of weak references to the object (if defined)
DATA
string_types = (<class 'str'>,)
FILE
c:\users\eigenaar\anaconda3\lib\site-packages\flask\config.py