"Return whether version *a* is greater than or equal to version *b*."

if isinstance(a, bytes):

cbook.warn_deprecated(

"3.0", message="compare_versions arguments should be strs.")

a = a.decode('ascii')

if isinstance(b, bytes):

cbook.warn_deprecated(

"3.0", message="compare_versions arguments should be strs.")

b = b.decode('ascii')

if a:

return LooseVersion(a) >= LooseVersion(b)

else:

for modname, minver in [

("cycler", "0.10"),

("dateutil", "2.1"),

("kiwisolver", "1.0.1"),

("numpy", "1.11"),

("pyparsing", "2.0.1"),

]:

module = importlib.import_module(modname)

if LooseVersion(module.__version__) < minver:

raise ImportError("Matplotlib requires {}>={}; you have {}"

"""

handler = logging.StreamHandler()

handler.setFormatter(logging.Formatter(logging.BASIC_FORMAT))

_log.addHandler(handler)

"""

_log.setLevel(level.upper())

"""

if func is None: # Return the actual decorator.

return functools.partial(_logged_cached, fmt)

called = False

ret = None

@functools.wraps(func)

def wrapper():

nonlocal called, ret

if not called:

ret = func()

called = True

_log.debug(fmt, ret)

return ret

"""

def impl(args, regex, min_ver=None):

# Execute the subprocess specified by args; capture stdout and stderr.

# Search for a regex match in the output; if the match succeeds, the

# first group of the match is the version.

# Return an _ExecInfo if the executable exists, and has a version of

# at least min_ver (if set); else, raise FileNotFoundError.

output = subprocess.check_output(

args, stderr=subprocess.STDOUT, universal_newlines=True)

match = re.search(regex, output)

if match:

version = LooseVersion(match.group(1))

if min_ver is not None and version < min_ver:

raise FileNotFoundError(

f"You have {args[0]} version {version} but the minimum "

f"version supported by Matplotlib is {min_ver}.")

return _ExecInfo(args[0], version)

else:

raise FileNotFoundError(

f"Failed to determine the version of {args[0]} from "

f"{' '.join(args)}, which output {output}")

if name == "dvipng":

return impl(["dvipng", "-version"], "(?m)^dvipng .* (.+)", "1.6")

elif name == "gs":

execs = (["gswin32c", "gswin64c", "mgs", "gs"] # "mgs" for miktex.

if sys.platform == "win32" else

["gs"])

for e in execs:

try:

return impl([e, "--version"], "(.*)", "9")

except FileNotFoundError:

pass

raise FileNotFoundError("Failed to find a Ghostscript installation")

elif name == "inkscape":

return impl(["inkscape", "-V"], "^Inkscape ([^ ]*)")

elif name == "magick":

path = None

if sys.platform == "win32":

# Check the registry to avoid confusing ImageMagick's convert with

# Windows's builtin convert.exe.

import winreg

binpath = ""

for flag in [0, winreg.KEY_WOW64_32KEY, winreg.KEY_WOW64_64KEY]:

try:

with winreg.OpenKeyEx(

winreg.HKEY_LOCAL_MACHINE,

r"Software\Imagemagick\Current",

0, winreg.KEY_QUERY_VALUE | flag) as hkey:

binpath = winreg.QueryValueEx(hkey, "BinPath")[0]

except OSError:

pass

if binpath:

for name in ["convert.exe", "magick.exe"]:

candidate = Path(binpath, name)

if candidate.exists():

path = str(candidate)

break

else:

path = "convert"

if path is None:

raise FileNotFoundError(

"Failed to find an ImageMagick installation")

return impl([path, "--version"], r"^Version: ImageMagick (\S*)")

elif name == "pdftops":

info = impl(["pdftops", "-v"], "^pdftops version (.*)")

if info and not ("3.0" <= info.version

# poppler version numbers.

or "0.9" <= info.version <= "1.0"):

raise FileNotFoundError(

f"You have pdftops version {info.version} but the minimum "

f"version supported by Matplotlib is 3.0.")

return info

else:

try:

s = subprocess.Popen(['dvipng', '-version'],

stdout=subprocess.PIPE,

stderr=subprocess.PIPE)

stdout, stderr = s.communicate()

line = stdout.decode('ascii').split('\n')[1]

v = line.split()[-1]

return v

except (IndexError, ValueError, OSError):

if checkdep_ghostscript.executable is None:

if sys.platform == 'win32':

# mgs is the name in miktex

gs_execs = ['gswin32c', 'gswin64c', 'mgs', 'gs']

else:

gs_execs = ['gs']

for gs_exec in gs_execs:

try:

s = subprocess.Popen(

[gs_exec, '--version'], stdout=subprocess.PIPE,

stderr=subprocess.PIPE)

stdout, stderr = s.communicate()

if s.returncode == 0:

v = stdout[:-1].decode('ascii')

if compare_versions(v, '9.0'):

checkdep_ghostscript.executable = gs_exec

checkdep_ghostscript.version = v

except (IndexError, ValueError, OSError):

pass

try:

s = subprocess.Popen(['pdftops', '-v'], stdout=subprocess.PIPE,

stderr=subprocess.PIPE)

stdout, stderr = s.communicate()

lines = stderr.decode('ascii').split('\n')

for line in lines:

if 'version' in line:

v = line.split()[-1]

return v

except (IndexError, ValueError, UnboundLocalError, OSError):

if checkdep_inkscape.version is None:

try:

s = subprocess.Popen(['inkscape', '-V'],

stdout=subprocess.PIPE,

stderr=subprocess.PIPE)

stdout, stderr = s.communicate()

lines = stdout.decode('ascii').split('\n')

for line in lines:

if 'Inkscape' in line:

v = line.split()[1]

break

checkdep_inkscape.version = v

except (IndexError, ValueError, UnboundLocalError, OSError):

pass

if not s:

return False

try:

_get_executable_info("gs")

except FileNotFoundError:

_log.warning(

"Setting rcParams['ps.usedistiller'] requires ghostscript.")

return False

if s == "xpdf":

try:

_get_executable_info("pdftops")

except FileNotFoundError:

_log.warning(

"Setting rcParams['ps.usedistiller'] to 'xpdf' requires xpdf.")

return False

if not s:

return False

if not shutil.which("tex"):

_log.warning("usetex mode requires TeX.")

return False

try:

_get_executable_info("dvipng")

except FileNotFoundError:

_log.warning("usetex mode requires dvipng.")

return False

try:

_get_executable_info("gs")

except FileNotFoundError:

_log.warning("usetex mode requires ghostscript.")

return False

"""

try:

return str(Path.home())

except Exception:

"""

configdir = os.environ['MPLCONFIGDIR'] = (

tempfile.mkdtemp(prefix='matplotlib-'))

atexit.register(shutil.rmtree, configdir)

"""

"""

configdir = os.environ.get('MPLCONFIGDIR')

if configdir:

configdir = Path(configdir).resolve()

elif sys.platform.startswith(('linux', 'freebsd')) and xdg_base:

configdir = Path(xdg_base, "matplotlib")

else:

configdir = Path.home() / ".matplotlib"

try:

configdir.mkdir(parents=True, exist_ok=True)

except OSError:

pass

else:

if os.access(str(configdir), os.W_OK) and configdir.is_dir():

return str(configdir)

"""

"""

'get the path to matplotlib data'

if 'MATPLOTLIBDATA' in os.environ:

path = os.environ['MATPLOTLIBDATA']

if not os.path.isdir(path):

raise RuntimeError('Path in environment MATPLOTLIBDATA not a '

'directory')

cbook.warn_deprecated(

"3.1", name="MATPLOTLIBDATA", obj_type="environment variable")

return path

def get_candidate_paths():

yield Path(__file__).with_name('mpl-data')

# setuptools' namespace_packages may hijack this init file

# so need to try something known to be in Matplotlib, not basemap.

import matplotlib.afm

yield Path(matplotlib.afm.__file__).with_name('mpl-data')

# py2exe zips pure python, so still need special check.

if getattr(sys, 'frozen', None):

yield Path(sys.executable).with_name('mpl-data')

# Try again assuming we need to step up one more directory.

yield Path(sys.executable).parent.with_name('mpl-data')

# Try again assuming sys.path[0] is a dir not a exe.

yield Path(sys.path[0]) / 'mpl-data'

for path in get_candidate_paths():

if path.is_dir():

return str(path)

data_path = Path(get_data_path())

d = {}

for path in filter(Path.is_file, data_path.glob("**/*")):

(d.setdefault(str(path.parent.relative_to(data_path.parent)), [])

.append(str(path)))

"""

def gen_candidates():

yield os.path.join(os.getcwd(), 'matplotlibrc')

try:

matplotlibrc = os.environ['MATPLOTLIBRC']

except KeyError:

pass

else:

yield matplotlibrc

yield os.path.join(matplotlibrc, 'matplotlibrc')

yield os.path.join(get_configdir(), 'matplotlibrc')

yield os.path.join(get_data_path(), 'matplotlibrc')

for fname in gen_candidates():

if os.path.exists(fname) and not os.path.isdir(fname):

return fname

raise RuntimeError("Could not find matplotlibrc file; your Matplotlib "

'text.latex.unicode': ('3.0',),

'savefig.frameon': ('3.1',),

'verbose.fileo': ('3.1',),

'verbose.level': ('3.1',),

"""

validate = {key: converter

for key, (default, converter) in defaultParams.items()

if key not in _all_deprecated}

@cbook.deprecated("3.0")

@property

def msg_depr(self):

return "%s is deprecated and replaced with %s; please use the latter."

@cbook.deprecated("3.0")

@property

def msg_depr_ignore(self):

return "%s is deprecated and ignored. Use %s instead."

@cbook.deprecated("3.0")

@property

def msg_depr_set(self):

return ("%s is deprecated. Please remove it from your matplotlibrc "

"and/or style files.")

@cbook.deprecated("3.0")

@property

def msg_obsolete(self):

return ("%s is obsolete. Please remove it from your matplotlibrc "

"and/or style files.")

@cbook.deprecated("3.0")

@property

def msg_backend_obsolete(self):

return ("The {} rcParam was deprecated in version 2.2. In order to "

"force the use of a specific Qt binding, either import that "

"binding first, or set the QT_API environment variable.")

# validate values on the way in

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

self.update(*args, **kwargs)

def __setitem__(self, key, val):

try:

if key in _deprecated_map:

version, alt_key, alt_val, inverse_alt = _deprecated_map[key]

cbook.warn_deprecated(

version, name=key, obj_type="rcparam", alternative=alt_key)

key = alt_key

val = alt_val(val)

elif key in _deprecated_remain_as_none and val is not None:

version, = _deprecated_remain_as_none[key]

cbook.warn_deprecated(

version, name=key, obj_type="rcparam")

elif key in _deprecated_ignore_map:

version, alt_key = _deprecated_ignore_map[key]

cbook.warn_deprecated(

version, name=key, obj_type="rcparam", alternative=alt_key)

return

elif key == 'examples.directory':

cbook.warn_deprecated(

"3.0", name=key, obj_type="rcparam", addendum="In the "

"future, examples will be found relative to the "

"'datapath' directory.")

elif key == 'backend':

if val is rcsetup._auto_backend_sentinel:

if 'backend' in self:

return

try:

cval = self.validate[key](val)

except ValueError as ve:

raise ValueError("Key %s: %s" % (key, str(ve)))

dict.__setitem__(self, key, cval)

except KeyError:

raise KeyError(

f"{key} is not a valid rc parameter (see rcParams.keys() for "

f"a list of valid parameters)")

def __getitem__(self, key):

if key in _deprecated_map:

version, alt_key, alt_val, inverse_alt = _deprecated_map[key]

cbook.warn_deprecated(

version, name=key, obj_type="rcparam", alternative=alt_key)

return inverse_alt(dict.__getitem__(self, alt_key))

elif key in _deprecated_ignore_map:

version, alt_key = _deprecated_ignore_map[key]

cbook.warn_deprecated(

version, name=key, obj_type="rcparam", alternative=alt_key)

return dict.__getitem__(self, alt_key) if alt_key else None

elif key == 'examples.directory':

cbook.warn_deprecated(

"3.0", name=key, obj_type="rcparam", addendum="In the future, "

"examples will be found relative to the 'datapath' directory.")

elif key == "backend":

val = dict.__getitem__(self, key)

if val is rcsetup._auto_backend_sentinel:

from matplotlib import pyplot as plt

plt.switch_backend(rcsetup._auto_backend_sentinel)

return dict.__getitem__(self, key)

def __repr__(self):

class_name = self.__class__.__name__

indent = len(class_name) + 1

with cbook._suppress_matplotlib_deprecation_warning():

repr_split = pprint.pformat(dict(self), indent=1,

width=80 - indent).split('\n')

repr_indented = ('\n' + ' ' * indent).join(repr_split)

return '{}({})'.format(class_name, repr_indented)

def __str__(self):

return '\n'.join(map('{0[0]}: {0[1]}'.format, sorted(self.items())))

def __iter__(self):

"""Yield sorted list of keys."""

with cbook._suppress_matplotlib_deprecation_warning():

yield from sorted(dict.__iter__(self))

def __len__(self):

return dict.__len__(self)

def find_all(self, pattern):

"""

pattern_re = re.compile(pattern)

return RcParams((key, value)

for key, value in self.items()

if pattern_re.search(key))

def copy(self):

"""Return a :class:`matplotlib.RcParams` instance from the

if is_url(fname):

import urllib.request

with urllib.request.urlopen(fname) as f:

yield (line.decode('utf-8') for line in f)

else:

fname = os.path.expanduser(fname)

encoding = locale.getpreferredencoding(do_setlocale=False)

if encoding is None:

encoding = "utf-8"

with open(fname, encoding=encoding) as f:

"""Return :class:`matplotlib.RcParams` from the contents of the given file.

cnt = 0

rc_temp = {}

with _open_file_or_url(fname) as fd:

try:

for line in fd:

cnt += 1

strippedline = line.split('#', 1)[0].strip()

if not strippedline:

continue

tup = strippedline.split(':', 1)

if len(tup) != 2:

error_details = _error_details_fmt % (cnt, line, fname)

_log.warning('Illegal %s', error_details)

continue

key, val = tup

key = key.strip()

val = val.strip()

if key in rc_temp:

_log.warning('Duplicate key in file %r line #%d.',

fname, cnt)

rc_temp[key] = (val, line, cnt)

except UnicodeDecodeError:

_log.warning('Cannot decode configuration file %s with encoding '

'%s, check LANG and LC_* variables.',

fname,

locale.getpreferredencoding(do_setlocale=False)

or 'utf-8 (default)')

raise

config = RcParams()

for key, (val, line, cnt) in rc_temp.items():

if key in defaultParams:

if fail_on_error:

config[key] = val # try to convert to proper type or raise

else:

try:

config[key] = val # try to convert to proper type or skip

except Exception as msg:

error_details = _error_details_fmt % (cnt, line, fname)

_log.warning('Bad val %r on %s\n\t%s',

val, error_details, msg)

elif key in _deprecated_ignore_map:

version, alt_key = _deprecated_ignore_map[key]

cbook.warn_deprecated(

version, name=key, alternative=alt_key,

addendum="Please update your matplotlibrc.")

else:

print("""

or from the matplotlib source distribution""" % (key, cnt, fname),

file=sys.stderr)

"""Return :class:`matplotlib.RcParams` from the contents of the given file.

config_from_file = _rc_params_in_file(fname, fail_on_error)

if not use_default_template:

return config_from_file

iter_params = defaultParams.items()

with cbook._suppress_matplotlib_deprecation_warning():

config = RcParams([(key, default) for key, (default, _) in iter_params

if key not in _all_deprecated])

config.update(config_from_file)

if config['datapath'] is None:

config['datapath'] = get_data_path()

if "".join(config['text.latex.preamble']):

_log.info("""

""", '\n'.join(config['text.latex.preamble']))

_log.debug('loaded rc file %s', fname)