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

from textwrap import fill

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 sys.version_info[0] < 3:

import ConfigParser as configparser

else:

import 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`.

"""

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 sys.platform == 'win32':

include_dirs.extend(os.getenv('INCLUDE', '.').split(';'))

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/local'],

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

'gnu0': ['/usr'],

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

}

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

def run_child_process(cmd):

"""

Run a subprocess as a sanity check.

"""

p = subprocess.Popen(cmd, shell=True,

stdin=subprocess.PIPE,

stdout=subprocess.PIPE,

stderr=subprocess.STDOUT,

close_fds=(sys.platform != 'win32'))

return p.stdin, p.stdout

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 = Extension(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)

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).append(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_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 _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

def get_config(self):

install = True

if config is not None:

try:

install = config.getboolean(

'packages', self.name)

except:

pass

return install

def check(self):

self.install = self.get_config()

if not self.install:

raise CheckFailed("skipping due to configuration")

return "installing"

class OptionalBackendPackage(SetupPackage):

optional = True

def get_config(self):

install = 'auto'

if config is not None:

try:

install = config.getboolean(

'gui_support', self.name)

except:

install = 'auto'

if install is True:

self.optional = False

return install

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.qt4_editor',

'matplotlib.compat',

'matplotlib.projections',

'matplotlib.axes',

'matplotlib.sphinxext',

'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/*.*',

]}

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',

]

class Tests(OptionalPackage):

name = "tests"

def check(self):

super(Tests, self).check()

try:

import nose

except ImportError:

return (

"nose 0.11.1 or later is required to run the "

"matplotlib test suite")

if nose.__versioninfo__ < (0, 11, 1):

return (

"nose 0.11.1 or later is required to run the "

"matplotlib test suite")

return 'using nose version %s' % nose.__version__

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_rcsetup.rc'

]}

def get_install_requires(self):

return ['nose']

class Numpy(SetupPackage):

name = "numpy"

def check(self):

min_version = extract_versions()['__version__numpy__']

try:

import numpy

except ImportError:

raise SystemExit(

"Requires numpy %s or later to build. (Numpy not found)" %

min_version)

if not is_min_version(numpy.__version__, min_version):

raise SystemExit(

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

(min_version, numpy.__version__))

ext = make_extension('test', [])

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

if not has_include_file(

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

raise CheckFailed(

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

"may need to install the development package.")

return 'version %s' % numpy.__version__

def add_flags(self, ext):

import numpy

# Ensure that PY_ARRAY_UNIQUE_SYMBOL is uniquely defined for

# each extension

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

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

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

class CXX(SetupPackage):

name = 'pycxx'

def check(self):

if sys.version_info[0] >= 3:

# There is no version of PyCXX in the wild that will work

# with Python 3.x

self.__class__.found_external = False

return ("Official versions of PyCXX are not compatible with "

"Python 3.x. Using local copy")

self.__class__.found_external = True

old_stdout = sys.stdout

sys.stdout = io.BytesIO()

try:

import CXX

except ImportError:

self.__class__.found_external = False

return "Couldn't import. Using local copy."

finally:

sys.stdout = old_stdout

try:

return self._check_for_pkg_config(

'PyCXX', 'CXX/Extensions.hxx', min_version='6.2.4')

except CheckFailed as e:

# Since there is no .pc file for PyCXX upstream, many

# distros don't package it either. We don't necessarily

# need to fall back to a local build in that scenario if

# the header files can be found.

base_include_dirs = [

os.path.join(x, 'include') for x in get_base_dirs()]

if has_include_file(base_include_dirs, 'CXX/Extensions.hxx'):

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

else:

self.__class__.found_external = False

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

def add_flags(self, ext):

if self.found_external and not 'sdist' in sys.argv:

support_dir = os.path.normpath(

os.path.join(

sys.prefix,

'share',

'python%d.%d' % (

sys.version_info[0], sys.version_info[1]),

'CXX'))

if not os.path.exists(support_dir):

# On Fedora 17, these files are installed in /usr/share/CXX

support_dir = '/usr/src/CXX'

ext.sources.extend([

os.path.join(support_dir, x) for x in

['cxxsupport.cxx', 'cxx_extensions.cxx',

'IndirectPythonInterface.cxx',

'cxxextensions.c']])

pkg_config.setup_extension(ext, 'PyCXX')

else:

ext.sources.extend(glob.glob('CXX/*.cxx'))

ext.sources.extend(glob.glob('CXX/*.c'))

ext.define_macros.append(('PYCXX_ISO_CPP_LIB', '1'))

if sys.version_info[0] >= 3:

ext.define_macros.append(('PYCXX_PYTHON_2TO3', '1'))

if not (sys.platform == 'win32' and win32_compiler == 'msvc'):

ext.libraries.append('stdc++')

ext.libraries.append('m')

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):

if self.found_external:

pkg_config.setup_extension(ext, 'libagg')

else:

ext.include_dirs.append('agg24/include')

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('agg24', 'src', x) for x in agg_sources)

class FreeType(SetupPackage):

name = "freetype"

def check(self):

if sys.platform == 'win32':

return "Unknown version"

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

if status == 0:

version = output

else:

version = None

return self._check_for_pkg_config(

'freetype2', 'ft2build.h',

min_version='2.4', version=version)

def add_flags(self, ext):

pkg_config.setup_extension(

ext, 'freetype2',

default_include_dirs=[

'freetype2', 'lib/freetype2/include',

'lib/freetype2/include/freetype2'],

default_library_dirs=[

'freetype2/lib'],

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

alt_exec='freetype-config')

class FT2Font(SetupPackage):

name = 'ft2font'

def get_extension(self):

sources = [

'src/ft2font.cpp',

'src/mplutils.cpp'

]

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

FreeType().add_flags(ext)

Numpy().add_flags(ext)

CXX().add_flags(ext)

return ext

class Png(SetupPackage):

name = "png"

def check(self):

try:

return self._check_for_pkg_config(

'libpng', 'png.h',

min_version='1.2')

except CheckFailed as e:

self.__class__.found_external = False

return str(e) + ' Using unknown version.'

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'])

Numpy().add_flags(ext)

CXX().add_flags(ext)

return ext

class TTConv(SetupPackage):

name = "ttconv"

def get_extension(self):

sources = [

'src/_ttconv.cpp',

'ttconv/pprdrv_tt.cpp',

'ttconv/pprdrv_tt2.cpp',

'ttconv/ttutil.cpp'

]

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

Numpy().add_flags(ext)

CXX().add_flags(ext)

return ext

class Path(SetupPackage):

name = "path"

def get_extension(self):

sources = [

'src/_path.cpp',

'src/path_cleanup.cpp',

'src/agg_py_transforms.cpp'

]

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

Numpy().add_flags(ext)

LibAgg().add_flags(ext)

CXX().add_flags(ext)

return ext

class Image(SetupPackage):

name = "image"

def get_extension(self):

sources = [

'src/_image.cpp', 'src/mplutils.cpp'

]

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

Numpy().add_flags(ext)

LibAgg().add_flags(ext)

CXX().add_flags(ext)

return ext

class Contour(SetupPackage):

name = "contour"

def get_extension(self):

sources = [

"src/cntr.c"

]

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

Numpy().add_flags(ext)

return ext

class Delaunay(SetupPackage):

name = "delaunay"

def get_packages(self):

return ['matplotlib.delaunay']

def get_extension(self):

sources = ["_delaunay.cpp", "VoronoiDiagramGenerator.cpp",

"delaunay_utils.cpp", "natneighbors.cpp"]

sources = [os.path.join('lib/matplotlib/delaunay', s) for s in sources]

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

Numpy().add_flags(ext)

return ext

class Tri(SetupPackage):

name = "tri"

def get_extension(self):

sources = [

"lib/matplotlib/tri/_tri.cpp",

"src/mplutils.cpp"

]

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

Numpy().add_flags(ext)

CXX().add_flags(ext)

return ext

class Dateutil(SetupPackage):

name = "dateutil"

def check(self):

try:

import dateutil

except ImportError:

return (

"dateutil was not found. It is required for date axis "

"support. pip/easy_install may attempt to install it "

"after matplotlib.")

return "using dateutil version %s" % dateutil.__version__

def get_install_requires(self):

return ['python-dateutil']

class Tornado(SetupPackage):

name = "tornado"

def check(self):

try:

import tornado

except ImportError:

return (

"tornado was not found. It is required for the WebAgg "

"backend. pip/easy_install may attempt to install it "

"after matplotlib.")

return "using tornado version %s" % tornado.version

def get_install_requires(self):

return ['tornado']

class Pyparsing(SetupPackage):

name = "pyparsing"

def check(self):

try:

import pyparsing

except ImportError:

return (

"pyparsing was not found. It is required for mathtext "

"support. pip/easy_install may attempt to install it "

"after matplotlib.")

if sys.version_info[0] >= 3:

required = [2, 0, 0]

else:

required = [1, 5, 6]

if [int(x) for x in pyparsing.__version__.split('.')] < required:

return (

"matplotlib requires pyparsing >= {0} on Python {1}".format(

'.'.join(str(x) for x in required),

sys.version_info[0]))

return "using pyparsing version %s" % pyparsing.__version__

def get_install_requires(self):

if sys.version_info[0] >= 3:

return ['pyparsing>=1.5.6']

else:

# pyparsing >= 2.0.0 is not compatible with Python 2

return ['pyparsing>=1.5.6,<2.0.0']

class BackendAgg(OptionalBackendPackage):

name = "agg"

force = False

def check(self):

# The Agg backend extension needs to be built even

# for certain GUI backends, such as TkAgg

config = self.get_config()

if config is False and self.force is False:

raise CheckFailed("skipping due to configuration")

else:

return "installing"

def get_extension(self):

sources = [

"src/mplutils.cpp",

"src/agg_py_transforms.cpp",

"src/_backend_agg.cpp"