FM / setuptools

/usr/lib/python2.7/site-packages/setuptools/

/usr/lib/python2.7/site-packages/setuptools

Name	Size	Mode	Actions
command/	-	0755	rm
extern/	-	0755	rm
_vendor/	-	0755	rm
archive_util.py	6592	0644	edit dl rm
archive_util.pyc	6142	0644	edit dl rm
archive_util.pyo	6142	0644	edit dl rm
build_meta.py	5671	0644	edit dl rm
build_meta.pyc	6639	0644	edit dl rm
build_meta.pyo	6522	0644	edit dl rm
config.py	16381	0644	edit dl rm
config.pyc	16888	0644	edit dl rm
config.pyo	16888	0644	edit dl rm
depends.py	5837	0644	edit dl rm
depends.pyc	6483	0644	edit dl rm
depends.pyo	6483	0644	edit dl rm
dep_util.py	935	0644	edit dl rm
dep_util.pyc	965	0644	edit dl rm
dep_util.pyo	965	0644	edit dl rm
dist.py	42514	0644	edit dl rm
dist.pyc	41502	0644	edit dl rm
dist.pyo	41444	0644	edit dl rm
extension.py	1729	0644	edit dl rm
extension.pyc	2418	0644	edit dl rm
extension.pyo	2418	0644	edit dl rm
glibc.py	3146	0644	edit dl rm
glibc.pyc	1960	0644	edit dl rm
glibc.pyo	1960	0644	edit dl rm
glob.py	5207	0644	edit dl rm
glob.pyc	4818	0644	edit dl rm
glob.pyo	4756	0644	edit dl rm
launch.py	787	0644	edit dl rm
launch.pyc	1000	0644	edit dl rm
launch.pyo	1000	0644	edit dl rm
lib2to3_ex.py	2013	0644	edit dl rm
lib2to3_ex.pyc	3004	0644	edit dl rm
lib2to3_ex.pyo	3004	0644	edit dl rm
monkey.py	5789	0644	edit dl rm
monkey.pyc	6343	0644	edit dl rm
monkey.pyo	6343	0644	edit dl rm
msvc.py	40877	0644	edit dl rm
msvc.pyc	40352	0644	edit dl rm
msvc.pyo	40352	0644	edit dl rm
namespaces.py	3199	0644	edit dl rm
namespaces.pyc	5033	0644	edit dl rm
namespaces.pyo	5033	0644	edit dl rm
package_index.py	40153	0644	edit dl rm
package_index.pyc	39743	0644	edit dl rm
package_index.pyo	39743	0644	edit dl rm
pep425tags.py	10882	0644	edit dl rm
pep425tags.pyc	9334	0644	edit dl rm
pep425tags.pyo	9334	0644	edit dl rm
py27compat.py	536	0644	edit dl rm
py27compat.pyc	1045	0644	edit dl rm
py27compat.pyo	1045	0644	edit dl rm
py31compat.py	1192	0644	edit dl rm
py31compat.pyc	1898	0644	edit dl rm
py31compat.pyo	1898	0644	edit dl rm
py33compat.py	1182	0644	edit dl rm
py33compat.pyc	1720	0644	edit dl rm
py33compat.pyo	1720	0644	edit dl rm
py36compat.py	2891	0644	edit dl rm
py36compat.pyc	2862	0644	edit dl rm
py36compat.pyo	2862	0644	edit dl rm
sandbox.py	14276	0644	edit dl rm
sandbox.pyc	18900	0644	edit dl rm
sandbox.pyo	18900	0644	edit dl rm
script (dev).tmpl	201	0644	edit dl rm
script.tmpl	138	0644	edit dl rm
site-patch.py	2307	0644	edit dl rm
site-patch.pyc	1739	0644	edit dl rm
site-patch.pyo	1739	0644	edit dl rm
ssl_support.py	8492	0644	edit dl rm
ssl_support.pyc	8516	0644	edit dl rm
ssl_support.pyo	8516	0644	edit dl rm
unicode_utils.py	996	0644	edit dl rm
unicode_utils.pyc	1472	0644	edit dl rm
unicode_utils.pyo	1472	0644	edit dl rm
version.py	144	0644	edit dl rm
version.pyc	322	0644	edit dl rm
version.pyo	322	0644	edit dl rm
wheel.py	7230	0644	edit dl rm
wheel.pyc	7343	0644	edit dl rm
wheel.pyo	7309	0644	edit dl rm
windows_support.py	714	0644	edit dl rm
windows_support.pyc	1274	0644	edit dl rm
windows_support.pyo	1274	0644	edit dl rm
__init__.py	5700	0644	edit dl rm
__init__.pyc	7625	0644	edit dl rm
__init__.pyo	7625	0644	edit dl rm

Edit: /usr/lib/python2.7/site-packages/setuptools/config.py (16381B)

from __future__ import absolute_import, unicode_literals
import io
import os
import sys
from collections import defaultdict
from functools import partial
from importlib import import_module

from distutils.errors import DistutilsOptionError, DistutilsFileError
from setuptools.extern.six import string_types

def read_configuration(
        filepath, find_others=False, ignore_option_errors=False):
    """Read given configuration file and returns options from it as a dict.

:param str|unicode filepath: Path to configuration file
        to get options from.

:param bool find_others: Whether to search for other configuration files
        which could be on in various places.

:param bool ignore_option_errors: Whether to silently ignore
        options, values of which could not be resolved (e.g. due to exceptions
        in directives such as file:, attr:, etc.).
        If False exceptions are propagated as expected.

:rtype: dict
    """
    from setuptools.dist import Distribution, _Distribution

filepath = os.path.abspath(filepath)

if not os.path.isfile(filepath):
        raise DistutilsFileError(
            'Configuration file %s does not exist.' % filepath)

current_directory = os.getcwd()
    os.chdir(os.path.dirname(filepath))

try:
        dist = Distribution()

filenames = dist.find_config_files() if find_others else []
        if filepath not in filenames:
            filenames.append(filepath)

_Distribution.parse_config_files(dist, filenames=filenames)

handlers = parse_configuration(
            dist, dist.command_options,
            ignore_option_errors=ignore_option_errors)

finally:
        os.chdir(current_directory)

return configuration_to_dict(handlers)

def configuration_to_dict(handlers):
    """Returns configuration data gathered by given handlers as a dict.

:param list[ConfigHandler] handlers: Handlers list,
        usually from parse_configuration()

:rtype: dict
    """
    config_dict = defaultdict(dict)

for handler in handlers:

obj_alias = handler.section_prefix
        target_obj = handler.target_obj

for option in handler.set_options:
            getter = getattr(target_obj, 'get_%s' % option, None)

if getter is None:
                value = getattr(target_obj, option)

else:
                value = getter()

config_dict[obj_alias][option] = value

return config_dict

def parse_configuration(
        distribution, command_options, ignore_option_errors=False):
    """Performs additional parsing of configuration options
    for a distribution.

Returns a list of used option handlers.

:param Distribution distribution:
    :param dict command_options:
    :param bool ignore_option_errors: Whether to silently ignore
        options, values of which could not be resolved (e.g. due to exceptions
        in directives such as file:, attr:, etc.).
        If False exceptions are propagated as expected.
    :rtype: list
    """
    meta = ConfigMetadataHandler(
        distribution.metadata, command_options, ignore_option_errors)
    meta.parse()

options = ConfigOptionsHandler(
        distribution, command_options, ignore_option_errors)
    options.parse()

return meta, options

class ConfigHandler(object):
    """Handles metadata supplied in configuration files."""

section_prefix = None
    """Prefix for config sections handled by this handler.
    Must be provided by class heirs.

"""

aliases = {}
    """Options aliases.
    For compatibility with various packages. E.g.: d2to1 and pbr.
    Note: `-` in keys is replaced with `_` by config parser.

"""

def __init__(self, target_obj, options, ignore_option_errors=False):
        sections = {}

section_prefix = self.section_prefix
        for section_name, section_options in options.items():
            if not section_name.startswith(section_prefix):
                continue

section_name = section_name.replace(section_prefix, '').strip('.')
            sections[section_name] = section_options

self.ignore_option_errors = ignore_option_errors
        self.target_obj = target_obj
        self.sections = sections
        self.set_options = []

@property
    def parsers(self):
        """Metadata item name to parser function mapping."""
        raise NotImplementedError(
            '%s must provide .parsers property' % self.__class__.__name__)

def __setitem__(self, option_name, value):
        unknown = tuple()
        target_obj = self.target_obj

# Translate alias into real name.
        option_name = self.aliases.get(option_name, option_name)

current_value = getattr(target_obj, option_name, unknown)

if current_value is unknown:
            raise KeyError(option_name)

if current_value:
            # Already inhabited. Skipping.
            return

skip_option = False
        parser = self.parsers.get(option_name)
        if parser:
            try:
                value = parser(value)

except Exception:
                skip_option = True
                if not self.ignore_option_errors:
                    raise

if skip_option:
            return

setter = getattr(target_obj, 'set_%s' % option_name, None)
        if setter is None:
            setattr(target_obj, option_name, value)
        else:
            setter(value)

self.set_options.append(option_name)

@classmethod
    def _parse_list(cls, value, separator=','):
        """Represents value as a list.

Value is split either by separator (defaults to comma) or by lines.

:param value:
        :param separator: List items separator character.
        :rtype: list
        """
        if isinstance(value, list):  # _get_parser_compound case
            return value

if '\n' in value:
            value = value.splitlines()
        else:
            value = value.split(separator)

return [chunk.strip() for chunk in value if chunk.strip()]

@classmethod
    def _parse_dict(cls, value):
        """Represents value as a dict.

:param value:
        :rtype: dict
        """
        separator = '='
        result = {}
        for line in cls._parse_list(value):
            key, sep, val = line.partition(separator)
            if sep != separator:
                raise DistutilsOptionError(
                    'Unable to parse option value to dict: %s' % value)
            result[key.strip()] = val.strip()

return result

@classmethod
    def _parse_bool(cls, value):
        """Represents value as boolean.

:param value:
        :rtype: bool
        """
        value = value.lower()
        return value in ('1', 'true', 'yes')

@classmethod
    def _parse_file(cls, value):
        """Represents value as a string, allowing including text
        from nearest files using `file:` directive.

Directive is sandboxed and won't reach anything outside
        directory with setup.py.

Examples:
            file: LICENSE
            file: README.rst, CHANGELOG.md, src/file.txt

:param str value:
        :rtype: str
        """
        include_directive = 'file:'

if not isinstance(value, string_types):
            return value

if not value.startswith(include_directive):
            return value

spec = value[len(include_directive):]
        filepaths = (os.path.abspath(path.strip()) for path in spec.split(','))
        return '\n'.join(
            cls._read_file(path)
            for path in filepaths
            if (cls._assert_local(path) or True)
            and os.path.isfile(path)
        )

@staticmethod
    def _assert_local(filepath):
        if not filepath.startswith(os.getcwd()):
            raise DistutilsOptionError(
                '`file:` directive can not access %s' % filepath)

@staticmethod
    def _read_file(filepath):
        with io.open(filepath, encoding='utf-8') as f:
            return f.read()

@classmethod
    def _parse_attr(cls, value):
        """Represents value as a module attribute.

Examples:
            attr: package.attr
            attr: package.module.attr

:param str value:
        :rtype: str
        """
        attr_directive = 'attr:'
        if not value.startswith(attr_directive):
            return value

attrs_path = value.replace(attr_directive, '').strip().split('.')
        attr_name = attrs_path.pop()

module_name = '.'.join(attrs_path)
        module_name = module_name or '__init__'

sys.path.insert(0, os.getcwd())
        try:
            module = import_module(module_name)
            value = getattr(module, attr_name)

finally:
            sys.path = sys.path[1:]

return value

@classmethod
    def _get_parser_compound(cls, *parse_methods):
        """Returns parser function to represents value as a list.

Parses a value applying given methods one after another.

:param parse_methods:
        :rtype: callable
        """
        def parse(value):
            parsed = value

for method in parse_methods:
                parsed = method(parsed)

return parsed

return parse

@classmethod
    def _parse_section_to_dict(cls, section_options, values_parser=None):
        """Parses section options into a dictionary.

Optionally applies a given parser to values.

:param dict section_options:
        :param callable values_parser:
        :rtype: dict
        """
        value = {}
        values_parser = values_parser or (lambda val: val)
        for key, (_, val) in section_options.items():
            value[key] = values_parser(val)
        return value

def parse_section(self, section_options):
        """Parses configuration file section.

:param dict section_options:
        """
        for (name, (_, value)) in section_options.items():
            try:
                self[name] = value

except KeyError:
                pass  # Keep silent for a new option may appear anytime.

def parse(self):
        """Parses configuration file items from one
        or more related sections.

"""
        for section_name, section_options in self.sections.items():

method_postfix = ''
            if section_name:  # [section.option] variant
                method_postfix = '_%s' % section_name

section_parser_method = getattr(
                self,
                # Dots in section names are tranlsated into dunderscores.
                ('parse_section%s' % method_postfix).replace('.', '__'),
                None)

if section_parser_method is None:
                raise DistutilsOptionError(
                    'Unsupported distribution option section: [%s.%s]' % (
                        self.section_prefix, section_name))

section_parser_method(section_options)

class ConfigMetadataHandler(ConfigHandler):

section_prefix = 'metadata'

aliases = {
        'home_page': 'url',
        'summary': 'description',
        'classifier': 'classifiers',
        'platform': 'platforms',
    }

strict_mode = False
    """We need to keep it loose, to be partially compatible with
    `pbr` and `d2to1` packages which also uses `metadata` section.

"""

@property
    def parsers(self):
        """Metadata item name to parser function mapping."""
        parse_list = self._parse_list
        parse_file = self._parse_file
        parse_dict = self._parse_dict

return {
            'platforms': parse_list,
            'keywords': parse_list,
            'provides': parse_list,
            'requires': parse_list,
            'obsoletes': parse_list,
            'classifiers': self._get_parser_compound(parse_file, parse_list),
            'license': parse_file,
            'description': parse_file,
            'long_description': parse_file,
            'version': self._parse_version,
            'project_urls': parse_dict,
        }

def _parse_version(self, value):
        """Parses `version` option value.

:param value:
        :rtype: str

"""
        version = self._parse_attr(value)

if callable(version):
            version = version()

if not isinstance(version, string_types):
            if hasattr(version, '__iter__'):
                version = '.'.join(map(str, version))
            else:
                version = '%s' % version

return version

class ConfigOptionsHandler(ConfigHandler):

section_prefix = 'options'

@property
    def parsers(self):
        """Metadata item name to parser function mapping."""
        parse_list = self._parse_list
        parse_list_semicolon = partial(self._parse_list, separator=';')
        parse_bool = self._parse_bool
        parse_dict = self._parse_dict

return {
            'zip_safe': parse_bool,
            'use_2to3': parse_bool,
            'include_package_data': parse_bool,
            'package_dir': parse_dict,
            'use_2to3_fixers': parse_list,
            'use_2to3_exclude_fixers': parse_list,
            'convert_2to3_doctests': parse_list,
            'scripts': parse_list,
            'eager_resources': parse_list,
            'dependency_links': parse_list,
            'namespace_packages': parse_list,
            'install_requires': parse_list_semicolon,
            'setup_requires': parse_list_semicolon,
            'tests_require': parse_list_semicolon,
            'packages': self._parse_packages,
            'entry_points': self._parse_file,
            'py_modules': parse_list,
        }

def _parse_packages(self, value):
        """Parses `packages` option value.

:param value:
        :rtype: list
        """
        find_directive = 'find:'

if not value.startswith(find_directive):
            return self._parse_list(value)

# Read function arguments from a dedicated section.
        find_kwargs = self.parse_section_packages__find(
            self.sections.get('packages.find', {}))

from setuptools import find_packages

return find_packages(**find_kwargs)

def parse_section_packages__find(self, section_options):
        """Parses `packages.find` configuration file section.

To be used in conjunction with _parse_packages().

:param dict section_options:
        """
        section_data = self._parse_section_to_dict(
            section_options, self._parse_list)

valid_keys = ['where', 'include', 'exclude']

find_kwargs = dict(
            [(k, v) for k, v in section_data.items() if k in valid_keys and v])

where = find_kwargs.get('where')
        if where is not None:
            find_kwargs['where'] = where[0]  # cast list to single val

return find_kwargs

def parse_section_entry_points(self, section_options):
        """Parses `entry_points` configuration file section.

:param dict section_options:
        """
        parsed = self._parse_section_to_dict(section_options, self._parse_list)
        self['entry_points'] = parsed

def _parse_package_data(self, section_options):
        parsed = self._parse_section_to_dict(section_options, self._parse_list)

root = parsed.get('*')
        if root:
            parsed[''] = root
            del parsed['*']

return parsed

def parse_section_package_data(self, section_options):
        """Parses `package_data` configuration file section.

:param dict section_options:
        """
        self['package_data'] = self._parse_package_data(section_options)

def parse_section_exclude_package_data(self, section_options):
        """Parses `exclude_package_data` configuration file section.

:param dict section_options:
        """
        self['exclude_package_data'] = self._parse_package_data(
            section_options)

def parse_section_extras_require(self, section_options):
        """Parses `extras_require` configuration file section.

:param dict section_options:
        """
        parse_list = partial(self._parse_list, separator=';')
        self['extras_require'] = self._parse_section_to_dict(
            section_options, parse_list)

cmd: