from __future__ import print_function, absolute_import

from distutils import sysconfig

from distutils import version

from distutils.core import Extension

import glob

import io

import multiprocessing

import os

import re

import subprocess

import sys

import warnings

from textwrap import fill

PY3 = (sys.version_info[0] >= 3)

try:

from subprocess import check_output

except ImportError:

# check_output is not available in Python 2.6

def check_output(*popenargs, **kwargs):

"""

Run command with arguments and return its output as a byte

string.

Backported from Python 2.7 as it's implemented as pure python

on stdlib.

"""

process = subprocess.Popen(

stdout=subprocess.PIPE, *popenargs, **kwargs)

output, unused_err = process.communicate()

retcode = process.poll()

if retcode:

cmd = kwargs.get("args")

if cmd is None:

cmd = popenargs[0]

error = subprocess.CalledProcessError(retcode, cmd)

error.output = output

raise error

return output

if sys.platform != 'win32':

if sys.version_info[0] < 3:

from commands import getstatusoutput

else:

from subprocess import getstatusoutput

if PY3:

import configparser

else:

import ConfigParser as configparser

# matplotlib build options, which can be altered using setup.cfg

options = {

'display_status': True,

'verbose': False,

'backend': None,

'basedirlist': None

}

setup_cfg = os.environ.get('MPLSETUPCFG', 'setup.cfg')

if os.path.exists(setup_cfg):

config = configparser.SafeConfigParser()

config.read(setup_cfg)

try:

options['display_status'] = not config.getboolean("status", "suppress")

except:

pass

try:

options['backend'] = config.get("rc_options", "backend")

except:

pass

try:

options['basedirlist'] = [

x.strip() for x in

config.get("directories", "basedirlist").split(',')]

except:

pass

else:

config = None

def get_win32_compiler():

"""

Determine the compiler being used on win32.

"""

# Used to determine mingw32 or msvc

# This is pretty bad logic, someone know a better way?

for v in sys.argv:

if 'mingw32' in v:

return 'mingw32'

return 'msvc'

win32_compiler = get_win32_compiler()

def extract_versions():

"""

Extracts version values from the main matplotlib __init__.py and

returns them as a dictionary.

"""

with open('lib/matplotlib/__init__.py') as fd:

for line in fd.readlines():

if (line.startswith('__version__')):

exec(line.strip())

return locals()

def has_include_file(include_dirs, filename):

"""

Returns `True` if `filename` can be found in one of the

directories in `include_dirs`.

"""

if sys.platform == 'win32':

include_dirs += os.environ.get('INCLUDE', '.').split(';')

for dir in include_dirs:

if os.path.exists(os.path.join(dir, filename)):

return True

return False

def check_include_file(include_dirs, filename, package):

"""

Raises an exception if the given include file can not be found.

"""

if not has_include_file(include_dirs, filename):

raise CheckFailed(

"The C/C++ header for %s (%s) could not be found. You "

"may need to install the development package." %

(package, filename))

def get_base_dirs():

"""

Returns a list of standard base directories on this platform.

"""

if options['basedirlist']:

return options['basedirlist']

basedir_map = {

'win32': ['win32_static', ],

'darwin': ['/usr/local/', '/usr', '/usr/X11',

'/opt/X11', '/opt/local'],

'sunos5': [os.getenv('MPLIB_BASE') or '/usr/local', ],

'gnu0': ['/usr'],

'aix5': ['/usr/local'],

}

return basedir_map.get(sys.platform, ['/usr/local', '/usr'])

def get_include_dirs():

"""

Returns a list of standard include directories on this platform.

"""

return [os.path.join(d, 'include') for d in get_base_dirs()]

def is_min_version(found, minversion):

"""

Returns `True` if `found` is at least as high a version as

`minversion`.

"""

expected_version = version.LooseVersion(minversion)

found_version = version.LooseVersion(found)

return found_version >= expected_version

# Define the display functions only if display_status is True.

if options['display_status']:

def print_line(char='='):

print(char * 76)

def print_status(package, status):

initial_indent = "%22s: " % package

indent = ' ' * 24

print(fill(str(status), width=76,

initial_indent=initial_indent,

subsequent_indent=indent))

def print_message(message):

indent = ' ' * 24 + "* "

print(fill(str(message), width=76,

initial_indent=indent,

subsequent_indent=indent))

def print_raw(section):

print(section)

else:

def print_line(*args, **kwargs):

pass

print_status = print_message = print_raw = print_line

# Remove the -Wstrict-prototypesoption, is it's not valid for C++

customize_compiler = sysconfig.customize_compiler

def my_customize_compiler(compiler):

retval = customize_compiler(compiler)

try:

compiler.compiler_so.remove('-Wstrict-prototypes')

except (ValueError, AttributeError):

pass

return retval

sysconfig.customize_compiler = my_customize_compiler

def make_extension(name, files, *args, **kwargs):

"""

Make a new extension. Automatically sets include_dirs and

library_dirs to the base directories appropriate for this

platform.

`name` is the name of the extension.

`files` is a list of source files.

Any additional arguments are passed to the

`distutils.core.Extension` constructor.

"""

ext = DelayedExtension(name, files, *args, **kwargs)

for dir in get_base_dirs():

include_dir = os.path.join(dir, 'include')

if os.path.exists(include_dir):

ext.include_dirs.append(include_dir)

for lib in ('lib', 'lib64'):

lib_dir = os.path.join(dir, lib)

if os.path.exists(lib_dir):

ext.library_dirs.append(lib_dir)

ext.include_dirs.append('.')

return ext

class PkgConfig(object):

"""

This is a class for communicating with pkg-config.

"""

def __init__(self):

"""

Determines whether pkg-config exists on this machine.

"""

if sys.platform == 'win32':

self.has_pkgconfig = False

else:

self.set_pkgconfig_path()

status, output = getstatusoutput("pkg-config --help")

self.has_pkgconfig = (status == 0)

if not self.has_pkgconfig:

print("IMPORTANT WARNING:")

print(

" pkg-config is not installed.\n"

" matplotlib may not be able to find some of its dependencies")

def set_pkgconfig_path(self):

pkgconfig_path = sysconfig.get_config_var('LIBDIR')

if pkgconfig_path is None:

return

pkgconfig_path = os.path.join(pkgconfig_path, 'pkgconfig')

if not os.path.isdir(pkgconfig_path):

return

try:

os.environ['PKG_CONFIG_PATH'] += ':' + pkgconfig_path

except KeyError:

os.environ['PKG_CONFIG_PATH'] = pkgconfig_path

def setup_extension(self, ext, package, default_include_dirs=[],

default_library_dirs=[], default_libraries=[],

alt_exec=None):

"""

Add parameters to the given `ext` for the given `package`.

"""

flag_map = {

'-I': 'include_dirs', '-L': 'library_dirs', '-l': 'libraries'}

executable = alt_exec

if self.has_pkgconfig:

executable = 'pkg-config {0}'.format(package)

use_defaults = True

if executable is not None:

command = "{0} --libs --cflags ".format(executable)

try:

output = check_output(command, shell=True,

stderr=subprocess.STDOUT)

except subprocess.CalledProcessError:

pass

else:

output = output.decode(sys.getfilesystemencoding())

use_defaults = False

for token in output.split():

attr = flag_map.get(token[:2])

if attr is not None:

getattr(ext, attr).insert(0, token[2:])

if use_defaults:

basedirs = get_base_dirs()

for base in basedirs:

for include in default_include_dirs:

dir = os.path.join(base, include)

if os.path.exists(dir):

ext.include_dirs.append(dir)

for lib in default_library_dirs:

dir = os.path.join(base, lib)

if os.path.exists(dir):

ext.library_dirs.append(dir)

ext.libraries.extend(default_libraries)

return True

return False

def get_version(self, package):

"""

Get the version of the package from pkg-config.

"""

if not self.has_pkgconfig:

return None

status, output = getstatusoutput(

"pkg-config %s --modversion" % (package))

if status == 0:

return output

return None

# The PkgConfig class should be used through this singleton

pkg_config = PkgConfig()

class CheckFailed(Exception):

"""

Exception thrown when a `SetupPackage.check` method fails.

"""

pass

class SetupPackage(object):

optional = False

def check(self):

"""

Checks whether the dependencies are met. Should raise a

`CheckFailed` exception if the dependency could not be met,

otherwise return a string indicating a version number or some

other message indicating what was found.

"""

pass

def get_packages(self):

"""

Get a list of package names to add to the configuration.

These are added to the `packages` list passed to

`distutils.setup`.

"""

return []

def get_namespace_packages(self):

"""

Get a list of namespace package names to add to the configuration.

These are added to the `namespace_packages` list passed to

`distutils.setup`.

"""

return []

def get_py_modules(self):

"""

Get a list of top-level modules to add to the configuration.

These are added to the `py_modules` list passed to

`distutils.setup`.

"""

return []

def get_package_data(self):

"""

Get a package data dictionary to add to the configuration.

These are merged into to the `package_data` list passed to

`distutils.setup`.

"""

return {}

def get_extension(self):

"""

Get a list of C extensions (`distutils.core.Extension`

objects) to add to the configuration. These are added to the

`extensions` list passed to `distutils.setup`.

"""

return None

def get_install_requires(self):

"""

Get a list of Python packages that we require.

pip/easy_install will attempt to download and install this

package if it is not installed.

"""

return []

def get_setup_requires(self):

"""

Get a list of Python packages that we require at build time.

pip/easy_install will attempt to download and install this

package if it is not installed.

"""

return []

def _check_for_pkg_config(self, package, include_file, min_version=None,

version=None):

"""

A convenience function for writing checks for a

pkg_config-defined dependency.

`package` is the pkg_config package name.

`include_file` is a top-level include file we expect to find.

`min_version` is the minimum version required.

`version` will override the found version if this package

requires an alternate method for that.

"""

if version is None:

version = pkg_config.get_version(package)

if version is None:

raise CheckFailed(

"pkg-config information for '%s' could not be found." %

package)

if min_version == 'PATCH':

raise CheckFailed(

"Requires patches that have not been merged upstream.")

if min_version:

if (not is_min_version(version, min_version)):

raise CheckFailed(

"Requires %s %s or later. Found %s." %

(package, min_version, version))

ext = self.get_extension()

if ext is None:

ext = make_extension('test', [])

pkg_config.setup_extension(ext, package)

check_include_file(ext.include_dirs, include_file, package)

return 'version %s' % version

class OptionalPackage(SetupPackage):

optional = True

force = False

config_category = "packages"

@classmethod

def get_config(cls):

"""

Look at `setup.cfg` and return one of ["auto", True, False] indicating

if the package is at default state ("auto"), forced by the user (True)

or opted-out (False).

"""

try:

return config.getboolean(cls.config_category, cls.name)

except:

return "auto"

def check(self):

"""

Do not override this method!

For custom dependency checks override self.check_requirements().

Two things are checked: Configuration file and requirements.

"""

# Check configuration file

conf = self.get_config()

# Default "auto" state or install forced by user

if conf in [True, 'auto']:

message = "installing"

# Set non-optional if user sets `True` in config

if conf is True:

self.optional = False

# Configuration opt-out by user

else:

# Some backend extensions (e.g. Agg) need to be built for certain

# other GUI backends (e.g. TkAgg) even when manually disabled

if self.force is True:

message = "installing forced (config override)"

else:

raise CheckFailed("skipping due to configuration")

# Check requirements and add extra information (if any) to message.

# If requirements are not met a CheckFailed should be raised in there.

additional_info = self.check_requirements()

if additional_info:

message += ", " + additional_info

# No CheckFailed raised until now, return install message.

return message

def check_requirements(self):

"""

Override this method to do custom dependency checks.

- Raise CheckFailed() if requirements are not met.

- Return message with additional information, or an empty string

(or None) for no additional information.

"""

return ""

class OptionalBackendPackage(OptionalPackage):

config_category = "gui_support"

class Platform(SetupPackage):

name = "platform"

def check(self):

return sys.platform

class Python(SetupPackage):

name = "python"

def check(self):

major, minor1, minor2, s, tmp = sys.version_info

if major < 2:

raise CheckFailed(

"Requires Python 2.6 or later")

elif major == 2 and minor1 < 6:

raise CheckFailed(

"Requires Python 2.6 or later (in the 2.x series)")

elif major == 3 and minor1 < 1:

raise CheckFailed(

"Requires Python 3.1 or later (in the 3.x series)")

return sys.version

class Matplotlib(SetupPackage):

name = "matplotlib"

def check(self):

return extract_versions()['__version__']

def get_packages(self):

return [

'matplotlib',

'matplotlib.backends',

'matplotlib.backends.qt_editor',

'matplotlib.compat',

'matplotlib.projections',

'matplotlib.axes',

'matplotlib.sphinxext',

'matplotlib.style',

'matplotlib.testing',

'matplotlib.testing.jpl_units',

'matplotlib.tri',

]

def get_py_modules(self):

return ['pylab']

def get_package_data(self):

return {

'matplotlib':

[

'mpl-data/fonts/afm/*.afm',

'mpl-data/fonts/pdfcorefonts/*.afm',

'mpl-data/fonts/pdfcorefonts/*.txt',

'mpl-data/fonts/ttf/*.ttf',

'mpl-data/fonts/ttf/LICENSE_STIX',

'mpl-data/fonts/ttf/COPYRIGHT.TXT',

'mpl-data/fonts/ttf/README.TXT',

'mpl-data/fonts/ttf/RELEASENOTES.TXT',

'mpl-data/images/*.xpm',

'mpl-data/images/*.svg',

'mpl-data/images/*.gif',

'mpl-data/images/*.png',

'mpl-data/images/*.ppm',

'mpl-data/example/*.npy',

'mpl-data/matplotlibrc',

'backends/web_backend/*.*',

'backends/web_backend/jquery/js/*',

'backends/web_backend/jquery/css/themes/base/*.*',

'backends/web_backend/jquery/css/themes/base/images/*',

'backends/web_backend/css/*.*',

'backends/Matplotlib.nib/*',

'mpl-data/stylelib/*.mplstyle',

]}

class SampleData(OptionalPackage):

"""

This handles the sample data that ships with matplotlib. It is

technically optional, though most often will be desired.

"""

name = "sample_data"

def get_package_data(self):

return {

'matplotlib':

[

'mpl-data/sample_data/*.*',

'mpl-data/sample_data/axes_grid/*.*',

]}

class Toolkits(OptionalPackage):

name = "toolkits"

def get_packages(self):

return [

'mpl_toolkits',

'mpl_toolkits.mplot3d',

'mpl_toolkits.axes_grid',

'mpl_toolkits.axes_grid1',

'mpl_toolkits.axisartist',

]

def get_namespace_packages(self):

return ['mpl_toolkits']

class Tests(OptionalPackage):

name = "tests"

nose_min_version = '0.11.1'

def check(self):

super(Tests, self).check()

msgs = []

msg_template = ('{package} is required to run the matplotlib test '

'suite. pip/easy_install may attempt to install it '

'after matplotlib.')

bad_nose = msg_template.format(

package='nose %s or later' % self.nose_min_version

)

try:

import nose

if is_min_version(nose.__version__, self.nose_min_version):

msgs += ['using nose version %s' % nose.__version__]

else:

msgs += [bad_nose]

except ImportError:

msgs += [bad_nose]

if sys.version_info >= (3, 3):

msgs += ['using unittest.mock']

else:

try:

import mock

msgs += ['using mock %s' % mock.__version__]

except ImportError:

msgs += [msg_template.format(package='mock')]

return ' / '.join(msgs)

def get_packages(self):

return [

'matplotlib.tests',

]

def get_package_data(self):

baseline_images = [

'tests/baseline_images/%s/*' % x

for x in os.listdir('lib/matplotlib/tests/baseline_images')]

return {

'matplotlib':

baseline_images +

[

'tests/mpltest.ttf',

'tests/test_rcparams.rc',

'tests/test_utf32_be_rcparams.rc',

]}

def get_install_requires(self):

requires = ['nose>=%s' % self.nose_min_version]

if not sys.version_info >= (3, 3):

requires += ['mock']

return requires

class Toolkits_Tests(Tests):

name = "toolkits_tests"

def check_requirements(self):

conf = self.get_config()

toolkits_conf = Toolkits.get_config()

tests_conf = Tests.get_config()

if conf is True:

Tests.force = True

Toolkits.force = True

elif conf == "auto" and not (toolkits_conf and tests_conf):

# Only auto-install if both toolkits and tests are set

# to be installed

raise CheckFailed("toolkits_tests needs 'toolkits' and 'tests'")

return ""

def get_packages(self):

return [

'mpl_toolkits.tests',

]

def get_package_data(self):

baseline_images = [

'tests/baseline_images/%s/*' % x

for x in os.listdir('lib/mpl_toolkits/tests/baseline_images')]

return {'mpl_toolkits': baseline_images}

def get_namespace_packages(self):

return ['mpl_toolkits']

class DelayedExtension(Extension, object):

"""

A distutils Extension subclass where some of its members

may have delayed computation until reaching the build phase.

This is so we can, for example, get the Numpy include dirs

after pip has installed Numpy for us if it wasn't already

on the system.

"""

def __init__(self, *args, **kwargs):

super(DelayedExtension, self).__init__(*args, **kwargs)

self._finalized = False

self._hooks = {}

def add_hook(self, member, func):

"""

Add a hook to dynamically compute a member.

Parameters

----------

member : string

The name of the member

func : callable

The function to call to get dynamically-computed values

for the member.

"""

self._hooks[member] = func

def finalize(self):

self._finalized = True

class DelayedMember(property):

def __init__(self, name):

self._name = name

def __get__(self, obj, objtype=None):

result = getattr(obj, '_' + self._name, [])

if obj._finalized:

if self._name in obj._hooks:

result = obj._hooks[self._name]() + result

return result

def __set__(self, obj, value):

setattr(obj, '_' + self._name, value)

include_dirs = DelayedMember('include_dirs')

class Numpy(SetupPackage):

name = "numpy"

@staticmethod

def include_dirs_hook():

if sys.version_info[0] >= 3:

import builtins

if hasattr(builtins, '__NUMPY_SETUP__'):

del builtins.__NUMPY_SETUP__

import imp

import numpy

imp.reload(numpy)

else:

import __builtin__

if hasattr(__builtin__, '__NUMPY_SETUP__'):

del __builtin__.__NUMPY_SETUP__

import numpy

reload(numpy)

ext = Extension('test', [])

ext.include_dirs.append(numpy.get_include())

if not has_include_file(

ext.include_dirs, os.path.join("numpy", "arrayobject.h")):

warnings.warn(

"The C headers for numpy could not be found. "

"You may need to install the development package")

return [numpy.get_include()]

def check(self):

min_version = extract_versions()['__version__numpy__']

try:

import numpy

except ImportError:

return 'not found. pip may install it below.'

if not is_min_version(numpy.__version__, min_version):

raise SystemExit(

"Requires numpy %s or later to build. (Found %s)" %

(min_version, numpy.__version__))

return 'version %s' % numpy.__version__

def add_flags(self, ext):

# Ensure that PY_ARRAY_UNIQUE_SYMBOL is uniquely defined for

# each extension

array_api_name = 'MPL_' + ext.name.replace('.', '_') + '_ARRAY_API'

ext.define_macros.append(('PY_ARRAY_UNIQUE_SYMBOL', array_api_name))

ext.add_hook('include_dirs', self.include_dirs_hook)

ext.define_macros.append(('NPY_NO_DEPRECATED_API',

'NPY_1_7_API_VERSION'))

def get_setup_requires(self):

return ['numpy>=1.6']

def get_install_requires(self):

return ['numpy>=1.6']

class LibAgg(SetupPackage):

name = 'libagg'

def check(self):

self.__class__.found_external = True

try:

return self._check_for_pkg_config(

'libagg', 'agg2/agg_basics.h', min_version='PATCH')

except CheckFailed as e:

self.__class__.found_external = False

return str(e) + ' Using local copy.'

def add_flags(self, ext, add_sources=True):

if self.found_external:

pkg_config.setup_extension(ext, 'libagg')

else:

ext.include_dirs.append('extern/agg24-svn/include')

if add_sources:

agg_sources = [

'agg_bezier_arc.cpp',

'agg_curves.cpp',

'agg_image_filters.cpp',

'agg_trans_affine.cpp',

'agg_vcgen_contour.cpp',

'agg_vcgen_dash.cpp',

'agg_vcgen_stroke.cpp',

'agg_vpgen_segmentator.cpp'

]

ext.sources.extend(

os.path.join('extern', 'agg24-svn', 'src', x) for x in agg_sources)

class FreeType(SetupPackage):

name = "freetype"

def check(self):

if sys.platform == 'win32':

check_include_file(get_include_dirs(), 'ft2build.h', 'freetype')

return 'Using unknown version found on system.'

status, output = getstatusoutput("freetype-config --ftversion")

if status == 0:

version = output

else:

version = None

# Early versions of freetype grep badly inside freetype-config,

# so catch those cases. (tested with 2.5.3).

if version is None or 'No such file or directory\ngrep:' in version:

version = self.version_from_header()

return self._check_for_pkg_config(

'freetype2', 'ft2build.h',

min_version='2.3', version=version)

def version_from_header(self):

version = 'Failed to identify version.'

ext = self.get_extension()

if ext is None:

return version

# Return the first version found in the include dirs.

for include_dir in ext.include_dirs:

header_fname = os.path.join(include_dir, 'freetype.h')

if os.path.exists(header_fname):

major, minor, patch = 0, 0, 0

with open(header_fname, 'r') as fh:

for line in fh:

if line.startswith('#define FREETYPE_'):

value = line.rsplit(' ', 1)[1].strip()

if 'MAJOR' in line:

major = value

elif 'MINOR' in line:

minor = value

else:

patch = value

return '.'.join([major, minor, patch])

def add_flags(self, ext):

pkg_config.setup_extension(

ext, 'freetype2',

default_include_dirs=[

'include/freetype2', 'freetype2',

'lib/freetype2/include',

'lib/freetype2/include/freetype2'],

default_library_dirs=[

'freetype2/lib'],

default_libraries=['freetype', 'z'])

class FT2Font(SetupPackage):

name = 'ft2font'

def get_extension(self):

sources = [

'src/ft2font.cpp',

'src/ft2font_wrapper.cpp',

'src/mplutils.cpp'

]

ext = make_extension('matplotlib.ft2font', sources)

FreeType().add_flags(ext)

Numpy().add_flags(ext)

return ext

class Png(SetupPackage):

name = "png"

def check(self):

if sys.platform == 'win32':

check_include_file(get_include_dirs(), 'png.h', 'png')

return 'Using unknown version found on system.'

status, output = getstatusoutput("libpng-config --version")

if status == 0:

version = output

else:

version = None

try:

return self._check_for_pkg_config(

'libpng', 'png.h',

min_version='1.2', version=version)

except CheckFailed as e:

if has_include_file(get_include_dirs(), 'png.h'):

return str(e) + ' Using unknown version found on system.'

raise

def get_extension(self):

sources = [

'src/_png.cpp',

'src/mplutils.cpp'

]

ext = make_extension('matplotlib._png', sources)

pkg_config.setup_extension(

ext, 'libpng', default_libraries=['png', 'z'],

alt_exec='libpng-config --ldflags')

Numpy().add_flags(ext)

return ext

class Qhull(SetupPackage):

name = "qhull"

def check(self):

self.__class__.found_external = True

try:

return self._check_for_pkg_config(

'qhull', 'qhull/qhull_a.h', min_version='2003.1')

except CheckFailed as e:

self.__class__.found_pkgconfig = False

# Qhull may not be in the pkg-config system but may still be

# present on this system, so check if the header files can be

# found.

include_dirs = [

os.path.join(x, 'qhull') for x in get_include_dirs()]

if has_include_file(include_dirs, 'qhull_a.h'):

return 'Using system Qhull (version unknown, no pkg-config info)'