Gecko [ www.foryou-vip.com ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-04-10 17:07
backends	[ DIR ]	drwxr-xr-x	2025-04-10 17:07
tests	[ DIR ]	drwxr-xr-x	2025-04-10 17:07
util	[ DIR ]	drwxr-xr-x	2025-04-10 17:07
__init__.py	398 B	-rw-r--r--	2016-12-04 19:41
__main__.py	70 B	-rw-r--r--	2016-12-04 19:41
backend.py	5.25 KB	-rw-r--r--	2016-12-04 19:41
cli.py	3.29 KB	-rw-r--r--	2016-12-04 19:41
core.py	3.89 KB	-rw-r--r--	2016-12-04 19:41
credentials.py	1.32 KB	-rw-r--r--	2016-12-04 19:41
errors.py	1.15 KB	-rw-r--r--	2016-12-04 19:41
getpassbackend.py	312 B	-rw-r--r--	2016-12-04 19:41
http.py	1.23 KB	-rw-r--r--	2016-12-04 19:41
py27compat.py	1008 B	-rw-r--r--	2016-12-04 19:41
py33compat.py	660 B	-rw-r--r--	2016-12-04 19:41

Rename

"""
Core API functions and initialization routines.
"""

import os
import sys
import logging
import operator

from .py27compat import configparser, filter
from .py33compat import max

from . import logger
from . import backend
from .util import platform_ as platform
from .util import once
from .backends import fail

log = logging.getLogger(__name__)

_keyring_backend = None

def set_keyring(keyring):
    """Set current keyring backend.
    """
    global _keyring_backend
    if not isinstance(keyring, backend.KeyringBackend):
        raise TypeError("The keyring must be a subclass of KeyringBackend")
    _keyring_backend = keyring

def get_keyring():
    """Get current keyring backend.
    """
    return _keyring_backend

def get_password(service_name, username):
    """Get password from the specified service.
    """
    return _keyring_backend.get_password(service_name, username)

def set_password(service_name, username, password):
    """Set password for the user in the specified service.
    """
    _keyring_backend.set_password(service_name, username, password)

def delete_password(service_name, username):
    """Delete the password for the user in the specified service.
    """
    _keyring_backend.delete_password(service_name, username)

recommended = lambda backend: backend.priority >= 1
by_priority = operator.attrgetter('priority')

def init_backend(limit=None):
    """
    Load a keyring specified in the config file or infer the best available.
    """
    keyrings = filter(limit, backend.get_all_keyring())

set_keyring(
        load_config()
        or max(keyrings, default=fail.Keyring, key=by_priority)
    )

def _load_keyring_class(keyring_name):
    """
    Load the keyring class indicated by name.

These popular names are tested to ensure their presence.

>>> popular_names = [
    ...      'keyring.backends.Windows.WinVaultKeyring',
    ...      'keyring.backends.OS_X.Keyring',
    ...      'keyring.backends.kwallet.DBusKeyring',
    ...      'keyring.backends.SecretService.Keyring',
    ...  ]
    >>> list(map(_load_keyring_class, popular_names))
    [...]

These legacy names are retained for compatibility.

>>> legacy_names = [
    ...  ]
    >>> list(map(_load_keyring_class, legacy_names))
    [...]
    """
    module_name, sep, class_name = keyring_name.rpartition('.')
    __import__(module_name)
    module = sys.modules[module_name]
    return getattr(module, class_name)

def load_keyring(keyring_name):
    """
    Load the specified keyring by name (a fully-qualified name to the
    keyring, such as 'keyring.backends.file.PlaintextKeyring')
    """
    class_ = _load_keyring_class(keyring_name)
    # invoke the priority to ensure it is viable, or raise a RuntimeError
    class_.priority
    return class_()

def load_config():
    """Load a keyring using the config file in the config root."""

filename = 'keyringrc.cfg'

keyring_cfg = os.path.join(platform.config_root(), filename)

if not os.path.exists(keyring_cfg):
        return

config = configparser.RawConfigParser()
    config.read(keyring_cfg)
    _load_keyring_path(config)

# load the keyring class name, and then load this keyring
    try:
        if config.has_section("backend"):
            keyring_name = config.get("backend", "default-keyring").strip()
        else:
            raise configparser.NoOptionError('backend', 'default-keyring')

except (configparser.NoOptionError, ImportError):
        logger.warning("Keyring config file contains incorrect values.\n" +
                       "Config file: %s" % keyring_cfg)
        return

return load_keyring(keyring_name)

def _load_keyring_path(config):
    "load the keyring-path option (if present)"
    try:
        path = config.get("backend", "keyring-path").strip()
        sys.path.insert(0, path)
    except (configparser.NoOptionError, configparser.NoSectionError):
        pass

# init the _keyring_backend
init_backend()