setuptools-20.7.0/0000775000175000017500000000000012702524134014665 5ustar travistravis00000000000000setuptools-20.7.0/docs/0000775000175000017500000000000012702524134015615 5ustar travistravis00000000000000setuptools-20.7.0/docs/_templates/0000775000175000017500000000000012702524134017752 5ustar travistravis00000000000000setuptools-20.7.0/docs/_templates/indexsidebar.html0000664000175000017500000000046712702524020023302 0ustar travistravis00000000000000

Download

Current version: {{ version }}

Get Setuptools from the Python Package Index

Questions? Suggestions? Contributions?

Visit the Setuptools project page

setuptools-20.7.0/docs/_theme/0000775000175000017500000000000012702524134017056 5ustar travistravis00000000000000setuptools-20.7.0/docs/_theme/nature/0000775000175000017500000000000012702524134020354 5ustar travistravis00000000000000setuptools-20.7.0/docs/_theme/nature/static/0000775000175000017500000000000012702524134021643 5ustar travistravis00000000000000setuptools-20.7.0/docs/_theme/nature/static/nature.css_t0000664000175000017500000000741512702524020024177 0ustar travistravis00000000000000/** * Sphinx stylesheet -- default theme * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */ @import url("basic.css"); /* -- page layout ----------------------------------------------------------- */ body { font-family: Arial, sans-serif; font-size: 100%; background-color: #111111; color: #555555; margin: 0; padding: 0; } div.documentwrapper { float: left; width: 100%; } div.bodywrapper { margin: 0 0 0 300px; } hr{ border: 1px solid #B1B4B6; } div.document { background-color: #fafafa; } div.body { background-color: #ffffff; color: #3E4349; padding: 1em 30px 30px 30px; font-size: 0.9em; } div.footer { color: #555; width: 100%; padding: 13px 0; text-align: center; font-size: 75%; } div.footer a { color: #444444; } div.related { background-color: #6BA81E; line-height: 36px; color: #ffffff; text-shadow: 0px 1px 0 #444444; font-size: 1.1em; } div.related a { color: #E2F3CC; } div.related .right { font-size: 0.9em; } div.sphinxsidebar { font-size: 0.9em; line-height: 1.5em; width: 300px; } div.sphinxsidebarwrapper{ padding: 20px 0; } div.sphinxsidebar h3, div.sphinxsidebar h4 { font-family: Arial, sans-serif; color: #222222; font-size: 1.2em; font-weight: bold; margin: 0; padding: 5px 10px; text-shadow: 1px 1px 0 white } div.sphinxsidebar h3 a { color: #444444; } div.sphinxsidebar p { color: #888888; padding: 5px 20px; margin: 0.5em 0px; } div.sphinxsidebar p.topless { } div.sphinxsidebar ul { margin: 10px 10px 10px 20px; padding: 0; color: #000000; } div.sphinxsidebar a { color: #444444; } div.sphinxsidebar a:hover { color: #E32E00; } div.sphinxsidebar input { border: 1px solid #cccccc; font-family: sans-serif; font-size: 1.1em; padding: 0.15em 0.3em; } div.sphinxsidebar input[type=text]{ margin-left: 20px; } /* -- body styles ----------------------------------------------------------- */ a { color: #005B81; text-decoration: none; } a:hover { color: #E32E00; } div.body h1, div.body h2, div.body h3, div.body h4, div.body h5, div.body h6 { font-family: Arial, sans-serif; font-weight: normal; color: #212224; margin: 30px 0px 10px 0px; padding: 5px 0 5px 0px; text-shadow: 0px 1px 0 white; border-bottom: 1px solid #C8D5E3; } div.body h1 { margin-top: 0; font-size: 200%; } div.body h2 { font-size: 150%; } div.body h3 { font-size: 120%; } div.body h4 { font-size: 110%; } div.body h5 { font-size: 100%; } div.body h6 { font-size: 100%; } a.headerlink { color: #c60f0f; font-size: 0.8em; padding: 0 4px 0 4px; text-decoration: none; } a.headerlink:hover { background-color: #c60f0f; color: white; } div.body p, div.body dd, div.body li { line-height: 1.8em; } div.admonition p.admonition-title + p { display: inline; } div.highlight{ background-color: white; } div.note { background-color: #eeeeee; border: 1px solid #cccccc; } div.seealso { background-color: #ffffcc; border: 1px solid #ffff66; } div.topic { background-color: #fafafa; border-width: 0; } div.warning { background-color: #ffe4e4; border: 1px solid #ff6666; } p.admonition-title { display: inline; } p.admonition-title:after { content: ":"; } pre { padding: 10px; background-color: #fafafa; color: #222222; line-height: 1.5em; font-size: 1.1em; margin: 1.5em 0 1.5em 0; -webkit-box-shadow: 0px 0px 4px #d8d8d8; -moz-box-shadow: 0px 0px 4px #d8d8d8; box-shadow: 0px 0px 4px #d8d8d8; } tt { color: #222222; padding: 1px 2px; font-size: 1.2em; font-family: monospace; } #table-of-contents ul { padding-left: 2em; } setuptools-20.7.0/docs/_theme/nature/static/pygments.css0000664000175000017500000000523512702524020024222 0ustar travistravis00000000000000.c { color: #999988; font-style: italic } /* Comment */ .k { font-weight: bold } /* Keyword */ .o { font-weight: bold } /* Operator */ .cm { color: #999988; font-style: italic } /* Comment.Multiline */ .cp { color: #999999; font-weight: bold } /* Comment.preproc */ .c1 { color: #999988; font-style: italic } /* Comment.Single */ .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */ .ge { font-style: italic } /* Generic.Emph */ .gr { color: #aa0000 } /* Generic.Error */ .gh { color: #999999 } /* Generic.Heading */ .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */ .go { color: #111 } /* Generic.Output */ .gp { color: #555555 } /* Generic.Prompt */ .gs { font-weight: bold } /* Generic.Strong */ .gu { color: #aaaaaa } /* Generic.Subheading */ .gt { color: #aa0000 } /* Generic.Traceback */ .kc { font-weight: bold } /* Keyword.Constant */ .kd { font-weight: bold } /* Keyword.Declaration */ .kp { font-weight: bold } /* Keyword.Pseudo */ .kr { font-weight: bold } /* Keyword.Reserved */ .kt { color: #445588; font-weight: bold } /* Keyword.Type */ .m { color: #009999 } /* Literal.Number */ .s { color: #bb8844 } /* Literal.String */ .na { color: #008080 } /* Name.Attribute */ .nb { color: #999999 } /* Name.Builtin */ .nc { color: #445588; font-weight: bold } /* Name.Class */ .no { color: #ff99ff } /* Name.Constant */ .ni { color: #800080 } /* Name.Entity */ .ne { color: #990000; font-weight: bold } /* Name.Exception */ .nf { color: #990000; font-weight: bold } /* Name.Function */ .nn { color: #555555 } /* Name.Namespace */ .nt { color: #000080 } /* Name.Tag */ .nv { color: purple } /* Name.Variable */ .ow { font-weight: bold } /* Operator.Word */ .mf { color: #009999 } /* Literal.Number.Float */ .mh { color: #009999 } /* Literal.Number.Hex */ .mi { color: #009999 } /* Literal.Number.Integer */ .mo { color: #009999 } /* Literal.Number.Oct */ .sb { color: #bb8844 } /* Literal.String.Backtick */ .sc { color: #bb8844 } /* Literal.String.Char */ .sd { color: #bb8844 } /* Literal.String.Doc */ .s2 { color: #bb8844 } /* Literal.String.Double */ .se { color: #bb8844 } /* Literal.String.Escape */ .sh { color: #bb8844 } /* Literal.String.Heredoc */ .si { color: #bb8844 } /* Literal.String.Interpol */ .sx { color: #bb8844 } /* Literal.String.Other */ .sr { color: #808000 } /* Literal.String.Regex */ .s1 { color: #bb8844 } /* Literal.String.Single */ .ss { color: #bb8844 } /* Literal.String.Symbol */ .bp { color: #999999 } /* Name.Builtin.Pseudo */ .vc { color: #ff99ff } /* Name.Variable.Class */ .vg { color: #ff99ff } /* Name.Variable.Global */ .vi { color: #ff99ff } /* Name.Variable.Instance */ .il { color: #009999 } /* Literal.Number.Integer.Long */setuptools-20.7.0/docs/_theme/nature/theme.conf0000664000175000017500000000010712702524020022315 0ustar travistravis00000000000000[theme] inherit = basic stylesheet = nature.css pygments_style = tango setuptools-20.7.0/docs/Makefile0000664000175000017500000000444312702524020017254 0ustar travistravis00000000000000# Makefile for Sphinx documentation # # You can set these variables from the command line. SPHINXOPTS = SPHINXBUILD = sphinx-build PAPER = # Internal variables. PAPEROPT_a4 = -D latex_paper_size=a4 PAPEROPT_letter = -D latex_paper_size=letter ALLSPHINXOPTS = -d build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . .PHONY: help clean html web pickle htmlhelp latex changes linkcheck help: @echo "Please use \`make ' where is one of" @echo " html to make standalone HTML files" @echo " pickle to make pickle files" @echo " json to make JSON files" @echo " htmlhelp to make HTML files and a HTML help project" @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" @echo " changes to make an overview over all changed/added/deprecated items" @echo " linkcheck to check all external links for integrity" clean: -rm -rf build/* html: mkdir -p build/html build/doctrees $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) build/html @echo @echo "Build finished. The HTML pages are in build/html." pickle: mkdir -p build/pickle build/doctrees $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) build/pickle @echo @echo "Build finished; now you can process the pickle files." web: pickle json: mkdir -p build/json build/doctrees $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) build/json @echo @echo "Build finished; now you can process the JSON files." htmlhelp: mkdir -p build/htmlhelp build/doctrees $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) build/htmlhelp @echo @echo "Build finished; now you can run HTML Help Workshop with the" \ ".hhp project file in build/htmlhelp." latex: mkdir -p build/latex build/doctrees $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) build/latex @echo @echo "Build finished; the LaTeX files are in build/latex." @echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \ "run these through (pdf)latex." changes: mkdir -p build/changes build/doctrees $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) build/changes @echo @echo "The overview file is in build/changes." linkcheck: mkdir -p build/linkcheck build/doctrees $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) build/linkcheck @echo @echo "Link check complete; look for any errors in the above output " \ "or in build/linkcheck/output.txt." setuptools-20.7.0/docs/conf.py0000664000175000017500000002033412702524020017110 0ustar travistravis00000000000000# -*- coding: utf-8 -*- # # Setuptools documentation build configuration file, created by # sphinx-quickstart on Fri Jul 17 14:22:37 2009. # # This file is execfile()d with the current directory set to its containing dir. # # The contents of this file are pickled, so don't put values in the namespace # that aren't pickleable (module imports are okay, they're removed automatically). # # Note that not all possible configuration values are present in this # autogenerated file. # # All configuration values have a default; values that are commented out # serve to show the default # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. # Allow Sphinx to find the setup command that is imported below, as referenced above. import sys, os sys.path.append(os.path.abspath('..')) import setup as setup_script # -- General configuration ----------------------------------------------------- # Add any Sphinx extension module names here, as strings. They can be extensions # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. extensions = ['rst.linker'] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] # The suffix of source filenames. source_suffix = '.txt' # The encoding of source files. #source_encoding = 'utf-8' # The master toctree document. master_doc = 'index' # General information about the project. project = 'Setuptools' copyright = '2009-2014, The fellowship of the packaging' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the # built documents. # # The short X.Y version. version = setup_script.setup_params['version'] # The full version, including alpha/beta/rc tags. release = setup_script.setup_params['version'] # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. #language = None # There are two options for replacing |today|: either, you set today to some # non-false value, then it is used: #today = '' # Else, today_fmt is used as the format for a strftime call. #today_fmt = '%B %d, %Y' # List of documents that shouldn't be included in the build. #unused_docs = [] # List of directories, relative to source directory, that shouldn't be searched # for source files. exclude_trees = [] # The reST default role (used for this markup: `text`) to use for all documents. #default_role = None # If true, '()' will be appended to :func: etc. cross-reference text. #add_function_parentheses = True # If true, the current module name will be prepended to all description # unit titles (such as .. function::). #add_module_names = True # If true, sectionauthor and moduleauthor directives will be shown in the # output. They are ignored by default. #show_authors = False # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'sphinx' # A list of ignored prefixes for module index sorting. #modindex_common_prefix = [] # -- Options for HTML output --------------------------------------------------- # The theme to use for HTML and HTML Help pages. Major themes that come with # Sphinx are currently 'default' and 'sphinxdoc'. html_theme = 'nature' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. #html_theme_options = {} # Add any paths that contain custom themes here, relative to this directory. html_theme_path = ['_theme'] # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". html_title = "Setuptools documentation" # A shorter title for the navigation bar. Default is the same as html_title. html_short_title = "Setuptools" # The name of an image file (relative to this directory) to place at the top # of the sidebar. #html_logo = None # The name of an image file (within the static path) to use as favicon of the # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 # pixels large. #html_favicon = None # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". #html_static_path = ['_static'] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. #html_last_updated_fmt = '%b %d, %Y' # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. html_use_smartypants = True # Custom sidebar templates, maps document names to template names. html_sidebars = {'index': 'indexsidebar.html'} # Additional templates that should be rendered to pages, maps page names to # template names. #html_additional_pages = {} # If false, no module index is generated. html_use_modindex = False # If false, no index is generated. html_use_index = False # If true, the index is split into individual pages for each letter. #html_split_index = False # If true, links to the reST sources are added to the pages. #html_show_sourcelink = True # If true, an OpenSearch description file will be output, and all pages will # contain a tag referring to it. The value of this option must be the # base URL from which the finished HTML is served. #html_use_opensearch = '' # If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml"). #html_file_suffix = '' # Output file base name for HTML help builder. htmlhelp_basename = 'Setuptoolsdoc' # -- Options for LaTeX output -------------------------------------------------- # The paper size ('letter' or 'a4'). #latex_paper_size = 'letter' # The font size ('10pt', '11pt' or '12pt'). #latex_font_size = '10pt' # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, author, documentclass [howto/manual]). latex_documents = [ ('index', 'Setuptools.tex', 'Setuptools Documentation', 'The fellowship of the packaging', 'manual'), ] # The name of an image file (relative to this directory) to place at the top of # the title page. #latex_logo = None # For "manual" documents, if this is true, then toplevel headings are parts, # not chapters. #latex_use_parts = False # Additional stuff for the LaTeX preamble. #latex_preamble = '' # Documents to append as an appendix to all manuals. #latex_appendices = [] # If false, no module index is generated. #latex_use_modindex = True link_files = { 'CHANGES.rst': dict( using=dict( BB='https://bitbucket.org', GH='https://github.com', ), replace=[ dict( pattern=r"(Issue )?#(?P\d+)", url='{GH}/pypa/setuptools/issues/{issue}', ), dict( pattern=r"BB Pull Request ?#(?P\d+)", url='{BB}/pypa/setuptools/pull-request/{bb_pull_request}', ), dict( pattern=r"Distribute #(?P\d+)", url='{BB}/tarek/distribute/issue/{distribute}', ), dict( pattern=r"Buildout #(?P\d+)", url='{GH}/buildout/buildout/issues/{buildout}', ), dict( pattern=r"Old Setuptools #(?P\d+)", url='http://bugs.python.org/setuptools/issue{old_setuptools}', ), dict( pattern=r"Jython #(?P\d+)", url='http://bugs.jython.org/issue{jython}', ), dict( pattern=r"Python #(?P\d+)", url='http://bugs.python.org/issue{python}', ), dict( pattern=r"Interop #(?P\d+)", url='{GH}/pypa/interoperability-peps/issues/{interop}', ), dict( pattern=r"Pip #(?P\d+)", url='{GH}/pypa/pip/issues/{pip}', ), dict( pattern=r"Packaging #(?P\d+)", url='{GH}/pypa/packaging/issues/{packaging}', ), dict( pattern=r"[Pp]ackaging (?P\d+(\.\d+)+)", url='{GH}/pypa/packaging/blob/{packaging_ver}/CHANGELOG.rst', ), dict( pattern=r"PEP[- ](?P\d+)", url='https://www.python.org/dev/peps/pep-{pep_number:0>4}/', ), dict( pattern=r"^(?m)((?Pv?\d+(\.\d+){1,2}))\n[-=]+\n", with_scm="{text}\n{rev[timestamp]:%d %b %Y}\n", ), ], ), } setuptools-20.7.0/docs/developer-guide.txt0000664000175000017500000001033012702524020021425 0ustar travistravis00000000000000================================ Developer's Guide for Setuptools ================================ If you want to know more about contributing on Setuptools, this is the place. .. contents:: **Table of Contents** ------------------- Recommended Reading ------------------- Please read `How to write the perfect pull request `_ for some tips on contributing to open source projects. Although the article is not authoritative, it was authored by the maintainer of Setuptools, so reflects his opinions and will improve the likelihood of acceptance and quality of contribution. ------------------ Project Management ------------------ Setuptools is maintained primarily in Github at `this home `_. Setuptools is maintained under the Python Packaging Authority (PyPA) with several core contributors. All bugs for Setuptools are filed and the canonical source is maintained in Github. User support and discussions are done through the issue tracker (for specific) issues, through the distutils-sig mailing list, or on IRC (Freenode) at #pypa. Discussions about development happen on the pypa-dev mailing list or on IRC (Freenode) at #pypa-dev. ----------------- Authoring Tickets ----------------- Before authoring any source code, it's often prudent to file a ticket describing the motivation behind making changes. First search to see if a ticket already exists for your issue. If not, create one. Try to think from the perspective of the reader. Explain what behavior you expected, what you got instead, and what factors might have contributed to the unexpected behavior. In Github, surround a block of code or traceback with the triple backtick "\`\`\`" so that it is formatted nicely. Filing a ticket provides a forum for justification, discussion, and clarification. The ticket provides a record of the purpose for the change and any hard decisions that were made. It provides a single place for others to reference when trying to understand why the software operates the way it does or why certain changes were made. Setuptools makes extensive use of hyperlinks to tickets in the changelog so that system integrators and other users can get a quick summary, but then jump to the in-depth discussion about any subject referenced. ----------- Source Code ----------- Grab the code at Github:: $ git checkout https://github.com/pypa/setuptools If you want to contribute changes, we recommend you fork the repository on Github, commit the changes to your repository, and then make a pull request on Github. If you make some changes, don't forget to: - add a note in CHANGES.rst Please commit all changes in the 'master' branch against the latest available commit or for bug-fixes, against an earlier commit or release in which the bug occurred. If you find yourself working on more than one issue at a time, Setuptools generally prefers Git-style branches, so use Mercurial bookmarks or Git branches or multiple forks to maintain separate efforts. The Continuous Integration tests that validate every release are run from this repository. For posterity, the old `Bitbucket mirror `_ is available. ------- Testing ------- The primary tests are run using py.test. To run the tests:: $ python setup.py test Or install py.test into your environment and run ``PYTHONPATH=. py.test`` or ``python -m pytest``. Under continuous integration, additional tests may be run. See the ``.travis.yml`` file for full details on the tests run under Travis-CI. ------------------- Semantic Versioning ------------------- Setuptools follows ``semver``. .. explain value of reflecting meaning in versions. ---------------------- Building Documentation ---------------------- Setuptools relies on the Sphinx system for building documentation and in particular the ``build_sphinx`` distutils command. To build the documentation, invoke:: python setup.py build_sphinx from the root of the repository. Setuptools will download a compatible build of Sphinx and any requisite plugins and then build the documentation in the build/sphinx directory. Setuptools does not support invoking the doc builder from the docs/ directory as some tools expect. setuptools-20.7.0/docs/development.txt0000664000175000017500000000270212702524020020673 0ustar travistravis00000000000000------------------------- Development on Setuptools ------------------------- Setuptools is maintained by the Python community under the Python Packaging Authority (PyPA) and led by Jason R. Coombs. This document describes the process by which Setuptools is developed. This document assumes the reader has some passing familiarity with *using* setuptools, the ``pkg_resources`` module, and EasyInstall. It does not attempt to explain basic concepts like inter-project dependencies, nor does it contain detailed lexical syntax for most file formats. Neither does it explain concepts like "namespace packages" or "resources" in any detail, as all of these subjects are covered at length in the setuptools developer's guide and the ``pkg_resources`` reference manual. Instead, this is **internal** documentation for how those concepts and features are *implemented* in concrete terms. It is intended for people who are working on the setuptools code base, who want to be able to troubleshoot setuptools problems, want to write code that reads the file formats involved, or want to otherwise tinker with setuptools-generated files and directories. Note, however, that these are all internal implementation details and are therefore subject to change; stick to the published API if you don't want to be responsible for keeping your code from breaking when setuptools changes. You have been warned. .. toctree:: :maxdepth: 1 developer-guide formats releases setuptools-20.7.0/docs/easy_install.txt0000664000175000017500000022341612702524020021047 0ustar travistravis00000000000000============ Easy Install ============ Easy Install is a python module (``easy_install``) bundled with ``setuptools`` that lets you automatically download, build, install, and manage Python packages. Please share your experiences with us! If you encounter difficulty installing a package, please contact us via the `distutils mailing list `_. (Note: please DO NOT send private email directly to the author of setuptools; it will be discarded. The mailing list is a searchable archive of previously-asked and answered questions; you should begin your research there before reporting something as a bug -- and then do so via list discussion first.) (Also, if you'd like to learn about how you can use ``setuptools`` to make your own packages work better with EasyInstall, or provide EasyInstall-like features without requiring your users to use EasyInstall directly, you'll probably want to check out the full `setuptools`_ documentation as well.) .. contents:: **Table of Contents** Using "Easy Install" ==================== .. _installation instructions: Installing "Easy Install" ------------------------- Please see the `setuptools PyPI page `_ for download links and basic installation instructions for each of the supported platforms. You will need at least Python 2.6. An ``easy_install`` script will be installed in the normal location for Python scripts on your platform. Note that the instructions on the setuptools PyPI page assume that you are are installing to Python's primary ``site-packages`` directory. If this is not the case, you should consult the section below on `Custom Installation Locations`_ before installing. (And, on Windows, you should not use the ``.exe`` installer when installing to an alternate location.) Note that ``easy_install`` normally works by downloading files from the internet. If you are behind an NTLM-based firewall that prevents Python programs from accessing the net directly, you may wish to first install and use the `APS proxy server `_, which lets you get past such firewalls in the same way that your web browser(s) do. (Alternately, if you do not wish easy_install to actually download anything, you can restrict it from doing so with the ``--allow-hosts`` option; see the sections on `restricting downloads with --allow-hosts`_ and `command-line options`_ for more details.) Troubleshooting ~~~~~~~~~~~~~~~ If EasyInstall/setuptools appears to install correctly, and you can run the ``easy_install`` command but it fails with an ``ImportError``, the most likely cause is that you installed to a location other than ``site-packages``, without taking any of the steps described in the `Custom Installation Locations`_ section below. Please see that section and follow the steps to make sure that your custom location will work correctly. Then re-install. Similarly, if you can run ``easy_install``, and it appears to be installing packages, but then you can't import them, the most likely issue is that you installed EasyInstall correctly but are using it to install packages to a non-standard location that hasn't been properly prepared. Again, see the section on `Custom Installation Locations`_ for more details. Windows Notes ~~~~~~~~~~~~~ Installing setuptools will provide an ``easy_install`` command according to the techniques described in `Executables and Launchers`_. If the ``easy_install`` command is not available after installation, that section provides details on how to configure Windows to make the commands available. Downloading and Installing a Package ------------------------------------ For basic use of ``easy_install``, you need only supply the filename or URL of a source distribution or .egg file (`Python Egg`__). __ http://peak.telecommunity.com/DevCenter/PythonEggs **Example 1**. Install a package by name, searching PyPI for the latest version, and automatically downloading, building, and installing it:: easy_install SQLObject **Example 2**. Install or upgrade a package by name and version by finding links on a given "download page":: easy_install -f http://pythonpaste.org/package_index.html SQLObject **Example 3**. Download a source distribution from a specified URL, automatically building and installing it:: easy_install http://example.com/path/to/MyPackage-1.2.3.tgz **Example 4**. Install an already-downloaded .egg file:: easy_install /my_downloads/OtherPackage-3.2.1-py2.3.egg **Example 5**. Upgrade an already-installed package to the latest version listed on PyPI:: easy_install --upgrade PyProtocols **Example 6**. Install a source distribution that's already downloaded and extracted in the current directory (New in 0.5a9):: easy_install . **Example 7**. (New in 0.6a1) Find a source distribution or Subversion checkout URL for a package, and extract it or check it out to ``~/projects/sqlobject`` (the name will always be in all-lowercase), where it can be examined or edited. (The package will not be installed, but it can easily be installed with ``easy_install ~/projects/sqlobject``. See `Editing and Viewing Source Packages`_ below for more info.):: easy_install --editable --build-directory ~/projects SQLObject **Example 7**. (New in 0.6.11) Install a distribution within your home dir:: easy_install --user SQLAlchemy Easy Install accepts URLs, filenames, PyPI package names (i.e., ``distutils`` "distribution" names), and package+version specifiers. In each case, it will attempt to locate the latest available version that meets your criteria. When downloading or processing downloaded files, Easy Install recognizes distutils source distribution files with extensions of .tgz, .tar, .tar.gz, .tar.bz2, or .zip. And of course it handles already-built .egg distributions as well as ``.win32.exe`` installers built using distutils. By default, packages are installed to the running Python installation's ``site-packages`` directory, unless you provide the ``-d`` or ``--install-dir`` option to specify an alternative directory, or specify an alternate location using distutils configuration files. (See `Configuration Files`_, below.) By default, any scripts included with the package are installed to the running Python installation's standard script installation location. However, if you specify an installation directory via the command line or a config file, then the default directory for installing scripts will be the same as the package installation directory, to ensure that the script will have access to the installed package. You can override this using the ``-s`` or ``--script-dir`` option. Installed packages are added to an ``easy-install.pth`` file in the install directory, so that Python will always use the most-recently-installed version of the package. If you would like to be able to select which version to use at runtime, you should use the ``-m`` or ``--multi-version`` option. Upgrading a Package ------------------- You don't need to do anything special to upgrade a package: just install the new version, either by requesting a specific version, e.g.:: easy_install "SomePackage==2.0" a version greater than the one you have now:: easy_install "SomePackage>2.0" using the upgrade flag, to find the latest available version on PyPI:: easy_install --upgrade SomePackage or by using a download page, direct download URL, or package filename:: easy_install -f http://example.com/downloads ExamplePackage easy_install http://example.com/downloads/ExamplePackage-2.0-py2.4.egg easy_install my_downloads/ExamplePackage-2.0.tgz If you're using ``-m`` or ``--multi-version`` , using the ``require()`` function at runtime automatically selects the newest installed version of a package that meets your version criteria. So, installing a newer version is the only step needed to upgrade such packages. If you're installing to a directory on PYTHONPATH, or a configured "site" directory (and not using ``-m``), installing a package automatically replaces any previous version in the ``easy-install.pth`` file, so that Python will import the most-recently installed version by default. So, again, installing the newer version is the only upgrade step needed. If you haven't suppressed script installation (using ``--exclude-scripts`` or ``-x``), then the upgraded version's scripts will be installed, and they will be automatically patched to ``require()`` the corresponding version of the package, so that you can use them even if they are installed in multi-version mode. ``easy_install`` never actually deletes packages (unless you're installing a package with the same name and version number as an existing package), so if you want to get rid of older versions of a package, please see `Uninstalling Packages`_, below. Changing the Active Version --------------------------- If you've upgraded a package, but need to revert to a previously-installed version, you can do so like this:: easy_install PackageName==1.2.3 Where ``1.2.3`` is replaced by the exact version number you wish to switch to. If a package matching the requested name and version is not already installed in a directory on ``sys.path``, it will be located via PyPI and installed. If you'd like to switch to the latest installed version of ``PackageName``, you can do so like this:: easy_install PackageName This will activate the latest installed version. (Note: if you have set any ``find_links`` via distutils configuration files, those download pages will be checked for the latest available version of the package, and it will be downloaded and installed if it is newer than your current version.) Note that changing the active version of a package will install the newly active version's scripts, unless the ``--exclude-scripts`` or ``-x`` option is specified. Uninstalling Packages --------------------- If you have replaced a package with another version, then you can just delete the package(s) you don't need by deleting the PackageName-versioninfo.egg file or directory (found in the installation directory). If you want to delete the currently installed version of a package (or all versions of a package), you should first run:: easy_install -m PackageName This will ensure that Python doesn't continue to search for a package you're planning to remove. After you've done this, you can safely delete the .egg files or directories, along with any scripts you wish to remove. Managing Scripts ---------------- Whenever you install, upgrade, or change versions of a package, EasyInstall automatically installs the scripts for the selected package version, unless you tell it not to with ``-x`` or ``--exclude-scripts``. If any scripts in the script directory have the same name, they are overwritten. Thus, you do not normally need to manually delete scripts for older versions of a package, unless the newer version of the package does not include a script of the same name. However, if you are completely uninstalling a package, you may wish to manually delete its scripts. EasyInstall's default behavior means that you can normally only run scripts from one version of a package at a time. If you want to keep multiple versions of a script available, however, you can simply use the ``--multi-version`` or ``-m`` option, and rename the scripts that EasyInstall creates. This works because EasyInstall installs scripts as short code stubs that ``require()`` the matching version of the package the script came from, so renaming the script has no effect on what it executes. For example, suppose you want to use two versions of the ``rst2html`` tool provided by the `docutils `_ package. You might first install one version:: easy_install -m docutils==0.3.9 then rename the ``rst2html.py`` to ``r2h_039``, and install another version:: easy_install -m docutils==0.3.10 This will create another ``rst2html.py`` script, this one using docutils version 0.3.10 instead of 0.3.9. You now have two scripts, each using a different version of the package. (Notice that we used ``-m`` for both installations, so that Python won't lock us out of using anything but the most recently-installed version of the package.) Executables and Launchers ------------------------- On Unix systems, scripts are installed with as natural files with a "#!" header and no extension and they launch under the Python version indicated in the header. On Windows, there is no mechanism to "execute" files without extensions, so EasyInstall provides two techniques to mirror the Unix behavior. The behavior is indicated by the SETUPTOOLS_LAUNCHER environment variable, which may be "executable" (default) or "natural". Regardless of the technique used, the script(s) will be installed to a Scripts directory (by default in the Python installation directory). It is recommended for EasyInstall that you ensure this directory is in the PATH environment variable. The easiest way to ensure the Scripts directory is in the PATH is to run ``Tools\Scripts\win_add2path.py`` from the Python directory (requires Python 2.6 or later). Note that instead of changing your ``PATH`` to include the Python scripts directory, you can also retarget the installation location for scripts so they go on a directory that's already on the ``PATH``. For more information see `Command-Line Options`_ and `Configuration Files`_. During installation, pass command line options (such as ``--script-dir``) to ``ez_setup.py`` to control where ``easy_install.exe`` will be installed. Windows Executable Launcher ~~~~~~~~~~~~~~~~~~~~~~~~~~~ If the "executable" launcher is used, EasyInstall will create a '.exe' launcher of the same name beside each installed script (including ``easy_install`` itself). These small .exe files launch the script of the same name using the Python version indicated in the '#!' header. This behavior is currently default. To force the use of executable launchers, set ``SETUPTOOLS_LAUNCHER`` to "executable". Natural Script Launcher ~~~~~~~~~~~~~~~~~~~~~~~ EasyInstall also supports deferring to an external launcher such as `pylauncher `_ for launching scripts. Enable this experimental functionality by setting the ``SETUPTOOLS_LAUNCHER`` environment variable to "natural". EasyInstall will then install scripts as simple scripts with a .pya (or .pyw) extension appended. If these extensions are associated with the pylauncher and listed in the PATHEXT environment variable, these scripts can then be invoked simply and directly just like any other executable. This behavior may become default in a future version. EasyInstall uses the .pya extension instead of simply the typical '.py' extension. This distinct extension is necessary to prevent Python from treating the scripts as importable modules (where name conflicts exist). Current releases of pylauncher do not yet associate with .pya files by default, but future versions should do so. Tips & Techniques ----------------- Multiple Python Versions ~~~~~~~~~~~~~~~~~~~~~~~~ EasyInstall installs itself under two names: ``easy_install`` and ``easy_install-N.N``, where ``N.N`` is the Python version used to install it. Thus, if you install EasyInstall for both Python 3.2 and 2.7, you can use the ``easy_install-3.2`` or ``easy_install-2.7`` scripts to install packages for the respective Python version. Setuptools also supplies easy_install as a runnable module which may be invoked using ``python -m easy_install`` for any Python with Setuptools installed. Restricting Downloads with ``--allow-hosts`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can use the ``--allow-hosts`` (``-H``) option to restrict what domains EasyInstall will look for links and downloads on. ``--allow-hosts=None`` prevents downloading altogether. You can also use wildcards, for example to restrict downloading to hosts in your own intranet. See the section below on `Command-Line Options`_ for more details on the ``--allow-hosts`` option. By default, there are no host restrictions in effect, but you can change this default by editing the appropriate `configuration files`_ and adding: .. code-block:: ini [easy_install] allow_hosts = *.myintranet.example.com,*.python.org The above example would then allow downloads only from hosts in the ``python.org`` and ``myintranet.example.com`` domains, unless overridden on the command line. Installing on Un-networked Machines ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Just copy the eggs or source packages you need to a directory on the target machine, then use the ``-f`` or ``--find-links`` option to specify that directory's location. For example:: easy_install -H None -f somedir SomePackage will attempt to install SomePackage using only eggs and source packages found in ``somedir`` and disallowing all remote access. You should of course make sure you have all of SomePackage's dependencies available in somedir. If you have another machine of the same operating system and library versions (or if the packages aren't platform-specific), you can create the directory of eggs using a command like this:: easy_install -zmaxd somedir SomePackage This will tell EasyInstall to put zipped eggs or source packages for SomePackage and all its dependencies into ``somedir``, without creating any scripts or .pth files. You can then copy the contents of ``somedir`` to the target machine. (``-z`` means zipped eggs, ``-m`` means multi-version, which prevents .pth files from being used, ``-a`` means to copy all the eggs needed, even if they're installed elsewhere on the machine, and ``-d`` indicates the directory to place the eggs in.) You can also build the eggs from local development packages that were installed with the ``setup.py develop`` command, by including the ``-l`` option, e.g.:: easy_install -zmaxld somedir SomePackage This will use locally-available source distributions to build the eggs. Packaging Others' Projects As Eggs ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Need to distribute a package that isn't published in egg form? You can use EasyInstall to build eggs for a project. You'll want to use the ``--zip-ok``, ``--exclude-scripts``, and possibly ``--no-deps`` options (``-z``, ``-x`` and ``-N``, respectively). Use ``-d`` or ``--install-dir`` to specify the location where you'd like the eggs placed. By placing them in a directory that is published to the web, you can then make the eggs available for download, either in an intranet or to the internet at large. If someone distributes a package in the form of a single ``.py`` file, you can wrap it in an egg by tacking an ``#egg=name-version`` suffix on the file's URL. So, something like this:: easy_install -f "http://some.example.com/downloads/foo.py#egg=foo-1.0" foo will install the package as an egg, and this:: easy_install -zmaxd. \ -f "http://some.example.com/downloads/foo.py#egg=foo-1.0" foo will create a ``.egg`` file in the current directory. Creating your own Package Index ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In addition to local directories and the Python Package Index, EasyInstall can find download links on most any web page whose URL is given to the ``-f`` (``--find-links``) option. In the simplest case, you can simply have a web page with links to eggs or Python source packages, even an automatically generated directory listing (such as the Apache web server provides). If you are setting up an intranet site for package downloads, you may want to configure the target machines to use your download site by default, adding something like this to their `configuration files`_: .. code-block:: ini [easy_install] find_links = http://mypackages.example.com/somedir/ http://turbogears.org/download/ http://peak.telecommunity.com/dist/ As you can see, you can list multiple URLs separated by whitespace, continuing on multiple lines if necessary (as long as the subsequent lines are indented. If you are more ambitious, you can also create an entirely custom package index or PyPI mirror. See the ``--index-url`` option under `Command-Line Options`_, below, and also the section on `Package Index "API"`_. Password-Protected Sites ------------------------ If a site you want to download from is password-protected using HTTP "Basic" authentication, you can specify your credentials in the URL, like so:: http://some_userid:some_password@some.example.com/some_path/ You can do this with both index page URLs and direct download URLs. As long as any HTML pages read by easy_install use *relative* links to point to the downloads, the same user ID and password will be used to do the downloading. Using .pypirc Credentials ------------------------- In additional to supplying credentials in the URL, ``easy_install`` will also honor credentials if present in the .pypirc file. Teams maintaining a private repository of packages may already have defined access credentials for uploading packages according to the distutils documentation. ``easy_install`` will attempt to honor those if present. Refer to the distutils documentation for Python 2.5 or later for details on the syntax. Controlling Build Options ~~~~~~~~~~~~~~~~~~~~~~~~~ EasyInstall respects standard distutils `Configuration Files`_, so you can use them to configure build options for packages that it installs from source. For example, if you are on Windows using the MinGW compiler, you can configure the default compiler by putting something like this: .. code-block:: ini [build] compiler = mingw32 into the appropriate distutils configuration file. In fact, since this is just normal distutils configuration, it will affect any builds using that config file, not just ones done by EasyInstall. For example, if you add those lines to ``distutils.cfg`` in the ``distutils`` package directory, it will be the default compiler for *all* packages you build. See `Configuration Files`_ below for a list of the standard configuration file locations, and links to more documentation on using distutils configuration files. Editing and Viewing Source Packages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Sometimes a package's source distribution contains additional documentation, examples, configuration files, etc., that are not part of its actual code. If you want to be able to examine these files, you can use the ``--editable`` option to EasyInstall, and EasyInstall will look for a source distribution or Subversion URL for the package, then download and extract it or check it out as a subdirectory of the ``--build-directory`` you specify. If you then wish to install the package after editing or configuring it, you can do so by rerunning EasyInstall with that directory as the target. Note that using ``--editable`` stops EasyInstall from actually building or installing the package; it just finds, obtains, and possibly unpacks it for you. This allows you to make changes to the package if necessary, and to either install it in development mode using ``setup.py develop`` (if the package uses setuptools, that is), or by running ``easy_install projectdir`` (where ``projectdir`` is the subdirectory EasyInstall created for the downloaded package. In order to use ``--editable`` (``-e`` for short), you *must* also supply a ``--build-directory`` (``-b`` for short). The project will be placed in a subdirectory of the build directory. The subdirectory will have the same name as the project itself, but in all-lowercase. If a file or directory of that name already exists, EasyInstall will print an error message and exit. Also, when using ``--editable``, you cannot use URLs or filenames as arguments. You *must* specify project names (and optional version requirements) so that EasyInstall knows what directory name(s) to create. If you need to force EasyInstall to use a particular URL or filename, you should specify it as a ``--find-links`` item (``-f`` for short), and then also specify the project name, e.g.:: easy_install -eb ~/projects \ -fhttp://prdownloads.sourceforge.net/ctypes/ctypes-0.9.6.tar.gz?download \ ctypes==0.9.6 Dealing with Installation Conflicts ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (NOTE: As of 0.6a11, this section is obsolete; it is retained here only so that people using older versions of EasyInstall can consult it. As of version 0.6a11, installation conflicts are handled automatically without deleting the old or system-installed packages, and without ignoring the issue. Instead, eggs are automatically shifted to the front of ``sys.path`` using special code added to the ``easy-install.pth`` file. So, if you are using version 0.6a11 or better of setuptools, you do not need to worry about conflicts, and the following issues do not apply to you.) EasyInstall installs distributions in a "managed" way, such that each distribution can be independently activated or deactivated on ``sys.path``. However, packages that were not installed by EasyInstall are "unmanaged", in that they usually live all in one directory and cannot be independently activated or deactivated. As a result, if you are using EasyInstall to upgrade an existing package, or to install a package with the same name as an existing package, EasyInstall will warn you of the conflict. (This is an improvement over ``setup.py install``, becuase the ``distutils`` just install new packages on top of old ones, possibly combining two unrelated packages or leaving behind modules that have been deleted in the newer version of the package.) EasyInstall will stop the installation if it detects a conflict between an existing, "unmanaged" package, and a module or package in any of the distributions you're installing. It will display a list of all of the existing files and directories that would need to be deleted for the new package to be able to function correctly. To proceed, you must manually delete these conflicting files and directories and re-run EasyInstall. Of course, once you've replaced all of your existing "unmanaged" packages with versions managed by EasyInstall, you won't have any more conflicts to worry about! Compressed Installation ~~~~~~~~~~~~~~~~~~~~~~~ EasyInstall tries to install packages in zipped form, if it can. Zipping packages can improve Python's overall import performance if you're not using the ``--multi-version`` option, because Python processes zipfile entries on ``sys.path`` much faster than it does directories. As of version 0.5a9, EasyInstall analyzes packages to determine whether they can be safely installed as a zipfile, and then acts on its analysis. (Previous versions would not install a package as a zipfile unless you used the ``--zip-ok`` option.) The current analysis approach is fairly conservative; it currenly looks for: * Any use of the ``__file__`` or ``__path__`` variables (which should be replaced with ``pkg_resources`` API calls) * Possible use of ``inspect`` functions that expect to manipulate source files (e.g. ``inspect.getsource()``) * Top-level modules that might be scripts used with ``python -m`` (Python 2.4) If any of the above are found in the package being installed, EasyInstall will assume that the package cannot be safely run from a zipfile, and unzip it to a directory instead. You can override this analysis with the ``-zip-ok`` flag, which will tell EasyInstall to install the package as a zipfile anyway. Or, you can use the ``--always-unzip`` flag, in which case EasyInstall will always unzip, even if its analysis says the package is safe to run as a zipfile. Normally, however, it is simplest to let EasyInstall handle the determination of whether to zip or unzip, and only specify overrides when needed to work around a problem. If you find you need to override EasyInstall's guesses, you may want to contact the package author and the EasyInstall maintainers, so that they can make appropriate changes in future versions. (Note: If a package uses ``setuptools`` in its setup script, the package author has the option to declare the package safe or unsafe for zipped usage via the ``zip_safe`` argument to ``setup()``. If the package author makes such a declaration, EasyInstall believes the package's author and does not perform its own analysis. However, your command-line option, if any, will still override the package author's choice.) Reference Manual ================ Configuration Files ------------------- (New in 0.4a2) You may specify default options for EasyInstall using the standard distutils configuration files, under the command heading ``easy_install``. EasyInstall will look first for a ``setup.cfg`` file in the current directory, then a ``~/.pydistutils.cfg`` or ``$HOME\\pydistutils.cfg`` (on Unix-like OSes and Windows, respectively), and finally a ``distutils.cfg`` file in the ``distutils`` package directory. Here's a simple example: .. code-block:: ini [easy_install] # set the default location to install packages install_dir = /home/me/lib/python # Notice that indentation can be used to continue an option # value; this is especially useful for the "--find-links" # option, which tells easy_install to use download links on # these pages before consulting PyPI: # find_links = http://sqlobject.org/ http://peak.telecommunity.com/dist/ In addition to accepting configuration for its own options under ``[easy_install]``, EasyInstall also respects defaults specified for other distutils commands. For example, if you don't set an ``install_dir`` for ``[easy_install]``, but *have* set an ``install_lib`` for the ``[install]`` command, this will become EasyInstall's default installation directory. Thus, if you are already using distutils configuration files to set default install locations, build options, etc., EasyInstall will respect your existing settings until and unless you override them explicitly in an ``[easy_install]`` section. For more information, see also the current Python documentation on the `use and location of distutils configuration files `_. Notice that ``easy_install`` will use the ``setup.cfg`` from the current working directory only if it was triggered from ``setup.py`` through the ``install_requires`` option. The standalone command will not use that file. Command-Line Options -------------------- ``--zip-ok, -z`` Install all packages as zip files, even if they are marked as unsafe for running as a zipfile. This can be useful when EasyInstall's analysis of a non-setuptools package is too conservative, but keep in mind that the package may not work correctly. (Changed in 0.5a9; previously this option was required in order for zipped installation to happen at all.) ``--always-unzip, -Z`` Don't install any packages as zip files, even if the packages are marked as safe for running as a zipfile. This can be useful if a package does something unsafe, but not in a way that EasyInstall can easily detect. EasyInstall's default analysis is currently very conservative, however, so you should only use this option if you've had problems with a particular package, and *after* reporting the problem to the package's maintainer and to the EasyInstall maintainers. (Note: the ``-z/-Z`` options only affect the installation of newly-built or downloaded packages that are not already installed in the target directory; if you want to convert an existing installed version from zipped to unzipped or vice versa, you'll need to delete the existing version first, and re-run EasyInstall.) ``--multi-version, -m`` "Multi-version" mode. Specifying this option prevents ``easy_install`` from adding an ``easy-install.pth`` entry for the package being installed, and if an entry for any version the package already exists, it will be removed upon successful installation. In multi-version mode, no specific version of the package is available for importing, unless you use ``pkg_resources.require()`` to put it on ``sys.path``. This can be as simple as:: from pkg_resources import require require("SomePackage", "OtherPackage", "MyPackage") which will put the latest installed version of the specified packages on ``sys.path`` for you. (For more advanced uses, like selecting specific versions and enabling optional dependencies, see the ``pkg_resources`` API doc.) Changed in 0.6a10: this option is no longer silently enabled when installing to a non-PYTHONPATH, non-"site" directory. You must always explicitly use this option if you want it to be active. ``--upgrade, -U`` (New in 0.5a4) By default, EasyInstall only searches online if a project/version requirement can't be met by distributions already installed on sys.path or the installation directory. However, if you supply the ``--upgrade`` or ``-U`` flag, EasyInstall will always check the package index and ``--find-links`` URLs before selecting a version to install. In this way, you can force EasyInstall to use the latest available version of any package it installs (subject to any version requirements that might exclude such later versions). ``--install-dir=DIR, -d DIR`` Set the installation directory. It is up to you to ensure that this directory is on ``sys.path`` at runtime, and to use ``pkg_resources.require()`` to enable the installed package(s) that you need. (New in 0.4a2) If this option is not directly specified on the command line or in a distutils configuration file, the distutils default installation location is used. Normally, this would be the ``site-packages`` directory, but if you are using distutils configuration files, setting things like ``prefix`` or ``install_lib``, then those settings are taken into account when computing the default installation directory, as is the ``--prefix`` option. ``--script-dir=DIR, -s DIR`` Set the script installation directory. If you don't supply this option (via the command line or a configuration file), but you *have* supplied an ``--install-dir`` (via command line or config file), then this option defaults to the same directory, so that the scripts will be able to find their associated package installation. Otherwise, this setting defaults to the location where the distutils would normally install scripts, taking any distutils configuration file settings into account. ``--exclude-scripts, -x`` Don't install scripts. This is useful if you need to install multiple versions of a package, but do not want to reset the version that will be run by scripts that are already installed. ``--user`` (New in 0.6.11) Use the the user-site-packages as specified in :pep:`370` instead of the global site-packages. ``--always-copy, -a`` (New in 0.5a4) Copy all needed distributions to the installation directory, even if they are already present in a directory on sys.path. In older versions of EasyInstall, this was the default behavior, but now you must explicitly request it. By default, EasyInstall will no longer copy such distributions from other sys.path directories to the installation directory, unless you explicitly gave the distribution's filename on the command line. Note that as of 0.6a10, using this option excludes "system" and "development" eggs from consideration because they can't be reliably copied. This may cause EasyInstall to choose an older version of a package than what you expected, or it may cause downloading and installation of a fresh copy of something that's already installed. You will see warning messages for any eggs that EasyInstall skips, before it falls back to an older version or attempts to download a fresh copy. ``--find-links=URLS_OR_FILENAMES, -f URLS_OR_FILENAMES`` Scan the specified "download pages" or directories for direct links to eggs or other distributions. Any existing file or directory names or direct download URLs are immediately added to EasyInstall's search cache, and any indirect URLs (ones that don't point to eggs or other recognized archive formats) are added to a list of additional places to search for download links. As soon as EasyInstall has to go online to find a package (either because it doesn't exist locally, or because ``--upgrade`` or ``-U`` was used), the specified URLs will be downloaded and scanned for additional direct links. Eggs and archives found by way of ``--find-links`` are only downloaded if they are needed to meet a requirement specified on the command line; links to unneeded packages are ignored. If all requested packages can be found using links on the specified download pages, the Python Package Index will not be consulted unless you also specified the ``--upgrade`` or ``-U`` option. (Note: if you want to refer to a local HTML file containing links, you must use a ``file:`` URL, as filenames that do not refer to a directory, egg, or archive are ignored.) You may specify multiple URLs or file/directory names with this option, separated by whitespace. Note that on the command line, you will probably have to surround the URL list with quotes, so that it is recognized as a single option value. You can also specify URLs in a configuration file; see `Configuration Files`_, above. Changed in 0.6a10: previously all URLs and directories passed to this option were scanned as early as possible, but from 0.6a10 on, only directories and direct archive links are scanned immediately; URLs are not retrieved unless a package search was already going to go online due to a package not being available locally, or due to the use of the ``--update`` or ``-U`` option. ``--no-find-links`` Blocks the addition of any link. This parameter is useful if you want to avoid adding links defined in a project easy_install is installing (whether it's a requested project or a dependency). When used, ``--find-links`` is ignored. Added in Distribute 0.6.11 and Setuptools 0.7. ``--index-url=URL, -i URL`` (New in 0.4a1; default changed in 0.6c7) Specifies the base URL of the Python Package Index. The default is https://pypi.python.org/simple if not specified. When a package is requested that is not locally available or linked from a ``--find-links`` download page, the package index will be searched for download pages for the needed package, and those download pages will be searched for links to download an egg or source distribution. ``--editable, -e`` (New in 0.6a1) Only find and download source distributions for the specified projects, unpacking them to subdirectories of the specified ``--build-directory``. EasyInstall will not actually build or install the requested projects or their dependencies; it will just find and extract them for you. See `Editing and Viewing Source Packages`_ above for more details. ``--build-directory=DIR, -b DIR`` (UPDATED in 0.6a1) Set the directory used to build source packages. If a package is built from a source distribution or checkout, it will be extracted to a subdirectory of the specified directory. The subdirectory will have the same name as the extracted distribution's project, but in all-lowercase. If a file or directory of that name already exists in the given directory, a warning will be printed to the console, and the build will take place in a temporary directory instead. This option is most useful in combination with the ``--editable`` option, which forces EasyInstall to *only* find and extract (but not build and install) source distributions. See `Editing and Viewing Source Packages`_, above, for more information. ``--verbose, -v, --quiet, -q`` (New in 0.4a4) Control the level of detail of EasyInstall's progress messages. The default detail level is "info", which prints information only about relatively time-consuming operations like running a setup script, unpacking an archive, or retrieving a URL. Using ``-q`` or ``--quiet`` drops the detail level to "warn", which will only display installation reports, warnings, and errors. Using ``-v`` or ``--verbose`` increases the detail level to include individual file-level operations, link analysis messages, and distutils messages from any setup scripts that get run. If you include the ``-v`` option more than once, the second and subsequent uses are passed down to any setup scripts, increasing the verbosity of their reporting as well. ``--dry-run, -n`` (New in 0.4a4) Don't actually install the package or scripts. This option is passed down to any setup scripts run, so packages should not actually build either. This does *not* skip downloading, nor does it skip extracting source distributions to a temporary/build directory. ``--optimize=LEVEL``, ``-O LEVEL`` (New in 0.4a4) If you are installing from a source distribution, and are *not* using the ``--zip-ok`` option, this option controls the optimization level for compiling installed ``.py`` files to ``.pyo`` files. It does not affect the compilation of modules contained in ``.egg`` files, only those in ``.egg`` directories. The optimization level can be set to 0, 1, or 2; the default is 0 (unless it's set under ``install`` or ``install_lib`` in one of your distutils configuration files). ``--record=FILENAME`` (New in 0.5a4) Write a record of all installed files to FILENAME. This is basically the same as the same option for the standard distutils "install" command, and is included for compatibility with tools that expect to pass this option to "setup.py install". ``--site-dirs=DIRLIST, -S DIRLIST`` (New in 0.6a1) Specify one or more custom "site" directories (separated by commas). "Site" directories are directories where ``.pth`` files are processed, such as the main Python ``site-packages`` directory. As of 0.6a10, EasyInstall automatically detects whether a given directory processes ``.pth`` files (or can be made to do so), so you should not normally need to use this option. It is is now only necessary if you want to override EasyInstall's judgment and force an installation directory to be treated as if it supported ``.pth`` files. ``--no-deps, -N`` (New in 0.6a6) Don't install any dependencies. This is intended as a convenience for tools that wrap eggs in a platform-specific packaging system. (We don't recommend that you use it for anything else.) ``--allow-hosts=PATTERNS, -H PATTERNS`` (New in 0.6a6) Restrict downloading and spidering to hosts matching the specified glob patterns. E.g. ``-H *.python.org`` restricts web access so that only packages listed and downloadable from machines in the ``python.org`` domain. The glob patterns must match the *entire* user/host/port section of the target URL(s). For example, ``*.python.org`` will NOT accept a URL like ``http://python.org/foo`` or ``http://www.python.org:8080/``. Multiple patterns can be specified by separating them with commas. The default pattern is ``*``, which matches anything. In general, this option is mainly useful for blocking EasyInstall's web access altogether (e.g. ``-Hlocalhost``), or to restrict it to an intranet or other trusted site. EasyInstall will do the best it can to satisfy dependencies given your host restrictions, but of course can fail if it can't find suitable packages. EasyInstall displays all blocked URLs, so that you can adjust your ``--allow-hosts`` setting if it is more strict than you intended. Some sites may wish to define a restrictive default setting for this option in their `configuration files`_, and then manually override the setting on the command line as needed. ``--prefix=DIR`` (New in 0.6a10) Use the specified directory as a base for computing the default installation and script directories. On Windows, the resulting default directories will be ``prefix\\Lib\\site-packages`` and ``prefix\\Scripts``, while on other platforms the defaults will be ``prefix/lib/python2.X/site-packages`` (with the appropriate version substituted) for libraries and ``prefix/bin`` for scripts. Note that the ``--prefix`` option only sets the *default* installation and script directories, and does not override the ones set on the command line or in a configuration file. ``--local-snapshots-ok, -l`` (New in 0.6c6) Normally, EasyInstall prefers to only install *released* versions of projects, not in-development ones, because such projects may not have a currently-valid version number. So, it usually only installs them when their ``setup.py`` directory is explicitly passed on the command line. However, if this option is used, then any in-development projects that were installed using the ``setup.py develop`` command, will be used to build eggs, effectively upgrading the "in-development" project to a snapshot release. Normally, this option is used only in conjunction with the ``--always-copy`` option to create a distributable snapshot of every egg needed to run an application. Note that if you use this option, you must make sure that there is a valid version number (such as an SVN revision number tag) for any in-development projects that may be used, as otherwise EasyInstall may not be able to tell what version of the project is "newer" when future installations or upgrades are attempted. .. _non-root installation: Custom Installation Locations ----------------------------- By default, EasyInstall installs python packages into Python's main ``site-packages`` directory, and manages them using a custom ``.pth`` file in that same directory. Very often though, a user or developer wants ``easy_install`` to install and manage python packages in an alternative location, usually for one of 3 reasons: 1. They don't have access to write to the main Python site-packages directory. 2. They want a user-specific stash of packages, that is not visible to other users. 3. They want to isolate a set of packages to a specific python application, usually to minimize the possibility of version conflicts. Historically, there have been many approaches to achieve custom installation. The following section lists only the easiest and most relevant approaches [1]_. `Use the "--user" option`_ `Use the "--user" option and customize "PYTHONUSERBASE"`_ `Use "virtualenv"`_ .. [1] There are older ways to achieve custom installation using various ``easy_install`` and ``setup.py install`` options, combined with ``PYTHONPATH`` and/or ``PYTHONUSERBASE`` alterations, but all of these are effectively deprecated by the User scheme brought in by `PEP-370`_ in Python 2.6. .. _PEP-370: http://www.python.org/dev/peps/pep-0370/ Use the "--user" option ~~~~~~~~~~~~~~~~~~~~~~~ With Python 2.6 came the User scheme for installation, which means that all python distributions support an alternative install location that is specific to a user [2]_ [3]_. The Default location for each OS is explained in the python documentation for the ``site.USER_BASE`` variable. This mode of installation can be turned on by specifying the ``--user`` option to ``setup.py install`` or ``easy_install``. This approach serves the need to have a user-specific stash of packages. .. [2] Prior to Python2.6, Mac OS X offered a form of the User scheme. That is now subsumed into the User scheme introduced in Python 2.6. .. [3] Prior to the User scheme, there was the Home scheme, which is still available, but requires more effort than the User scheme to get packages recognized. Use the "--user" option and customize "PYTHONUSERBASE" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The User scheme install location can be customized by setting the ``PYTHONUSERBASE`` environment variable, which updates the value of ``site.USER_BASE``. To isolate packages to a specific application, simply set the OS environment of that application to a specific value of ``PYTHONUSERBASE``, that contains just those packages. Use "virtualenv" ~~~~~~~~~~~~~~~~ "virtualenv" is a 3rd-party python package that effectively "clones" a python installation, thereby creating an isolated location to install packages. The evolution of "virtualenv" started before the existence of the User installation scheme. "virtualenv" provides a version of ``easy_install`` that is scoped to the cloned python install and is used in the normal way. "virtualenv" does offer various features that the User installation scheme alone does not provide, e.g. the ability to hide the main python site-packages. Please refer to the `virtualenv`_ documentation for more details. .. _virtualenv: https://pypi.python.org/pypi/virtualenv Package Index "API" ------------------- Custom package indexes (and PyPI) must follow the following rules for EasyInstall to be able to look up and download packages: 1. Except where stated otherwise, "pages" are HTML or XHTML, and "links" refer to ``href`` attributes. 2. Individual project version pages' URLs must be of the form ``base/projectname/version``, where ``base`` is the package index's base URL. 3. Omitting the ``/version`` part of a project page's URL (but keeping the trailing ``/``) should result in a page that is either: a) The single active version of that project, as though the version had been explicitly included, OR b) A page with links to all of the active version pages for that project. 4. Individual project version pages should contain direct links to downloadable distributions where possible. It is explicitly permitted for a project's "long_description" to include URLs, and these should be formatted as HTML links by the package index, as EasyInstall does no special processing to identify what parts of a page are index-specific and which are part of the project's supplied description. 5. Where available, MD5 information should be added to download URLs by appending a fragment identifier of the form ``#md5=...``, where ``...`` is the 32-character hex MD5 digest. EasyInstall will verify that the downloaded file's MD5 digest matches the given value. 6. Individual project version pages should identify any "homepage" or "download" URLs using ``rel="homepage"`` and ``rel="download"`` attributes on the HTML elements linking to those URLs. Use of these attributes will cause EasyInstall to always follow the provided links, unless it can be determined by inspection that they are downloadable distributions. If the links are not to downloadable distributions, they are retrieved, and if they are HTML, they are scanned for download links. They are *not* scanned for additional "homepage" or "download" links, as these are only processed for pages that are part of a package index site. 7. The root URL of the index, if retrieved with a trailing ``/``, must result in a page containing links to *all* projects' active version pages. (Note: This requirement is a workaround for the absence of case-insensitive ``safe_name()`` matching of project names in URL paths. If project names are matched in this fashion (e.g. via the PyPI server, mod_rewrite, or a similar mechanism), then it is not necessary to include this all-packages listing page.) 8. If a package index is accessed via a ``file://`` URL, then EasyInstall will automatically use ``index.html`` files, if present, when trying to read a directory with a trailing ``/`` on the URL. Backward Compatibility ~~~~~~~~~~~~~~~~~~~~~~ Package indexes that wish to support setuptools versions prior to 0.6b4 should also follow these rules: * Homepage and download links must be preceded with ``"Home Page"`` or ``"Download URL"``, in addition to (or instead of) the ``rel=""`` attributes on the actual links. These marker strings do not need to be visible, or uncommented, however! For example, the following is a valid homepage link that will work with any version of setuptools::
  • Home Page: http://sqlobject.org
  • Even though the marker string is in an HTML comment, older versions of EasyInstall will still "see" it and know that the link that follows is the project's home page URL. * The pages described by paragraph 3(b) of the preceding section *must* contain the string ``"Index of Packages"`` somewhere in their text. This can be inside of an HTML comment, if desired, and it can be anywhere in the page. (Note: this string MUST NOT appear on normal project pages, as described in paragraphs 2 and 3(a)!) In addition, for compatibility with PyPI versions that do not use ``#md5=`` fragment IDs, EasyInstall uses the following regular expression to match PyPI's displayed MD5 info (broken onto two lines for readability):: ([^<]+)\n\s+\(md5\) History ======= 0.6c9 * Fixed ``win32.exe`` support for .pth files, so unnecessary directory nesting is flattened out in the resulting egg. (There was a case-sensitivity problem that affected some distributions, notably ``pywin32``.) * Prevent ``--help-commands`` and other junk from showing under Python 2.5 when running ``easy_install --help``. * Fixed GUI scripts sometimes not executing on Windows * Fixed not picking up dependency links from recursive dependencies. * Only make ``.py``, ``.dll`` and ``.so`` files executable when unpacking eggs * Changes for Jython compatibility * Improved error message when a requirement is also a directory name, but the specified directory is not a source package. * Fixed ``--allow-hosts`` option blocking ``file:`` URLs * Fixed HTTP SVN detection failing when the page title included a project name (e.g. on SourceForge-hosted SVN) * Fix Jython script installation to handle ``#!`` lines better when ``sys.executable`` is a script. * Removed use of deprecated ``md5`` module if ``hashlib`` is available * Keep site directories (e.g. ``site-packages``) from being included in ``.pth`` files. 0.6c7 * ``ftp:`` download URLs now work correctly. * The default ``--index-url`` is now ``https://pypi.python.org/simple``, to use the Python Package Index's new simpler (and faster!) REST API. 0.6c6 * EasyInstall no longer aborts the installation process if a URL it wants to retrieve can't be downloaded, unless the URL is an actual package download. Instead, it issues a warning and tries to keep going. * Fixed distutils-style scripts originally built on Windows having their line endings doubled when installed on any platform. * Added ``--local-snapshots-ok`` flag, to allow building eggs from projects installed using ``setup.py develop``. * Fixed not HTML-decoding URLs scraped from web pages 0.6c5 * Fixed ``.dll`` files on Cygwin not having executable permissions when an egg is installed unzipped. 0.6c4 * Added support for HTTP "Basic" authentication using ``http://user:pass@host`` URLs. If a password-protected page contains links to the same host (and protocol), those links will inherit the credentials used to access the original page. * Removed all special support for Sourceforge mirrors, as Sourceforge's mirror system now works well for non-browser downloads. * Fixed not recognizing ``win32.exe`` installers that included a custom bitmap. * Fixed not allowing ``os.open()`` of paths outside the sandbox, even if they are opened read-only (e.g. reading ``/dev/urandom`` for random numbers, as is done by ``os.urandom()`` on some platforms). * Fixed a problem with ``.pth`` testing on Windows when ``sys.executable`` has a space in it (e.g., the user installed Python to a ``Program Files`` directory). 0.6c3 * You can once again use "python -m easy_install" with Python 2.4 and above. * Python 2.5 compatibility fixes added. 0.6c2 * Windows script wrappers now support quoted arguments and arguments containing spaces. (Patch contributed by Jim Fulton.) * The ``ez_setup.py`` script now actually works when you put a setuptools ``.egg`` alongside it for bootstrapping an offline machine. * A writable installation directory on ``sys.path`` is no longer required to download and extract a source distribution using ``--editable``. * Generated scripts now use ``-x`` on the ``#!`` line when ``sys.executable`` contains non-ASCII characters, to prevent deprecation warnings about an unspecified encoding when the script is run. 0.6c1 * EasyInstall now includes setuptools version information in the ``User-Agent`` string sent to websites it visits. 0.6b4 * Fix creating Python wrappers for non-Python scripts * Fix ``ftp://`` directory listing URLs from causing a crash when used in the "Home page" or "Download URL" slots on PyPI. * Fix ``sys.path_importer_cache`` not being updated when an existing zipfile or directory is deleted/overwritten. * Fix not recognizing HTML 404 pages from package indexes. * Allow ``file://`` URLs to be used as a package index. URLs that refer to directories will use an internally-generated directory listing if there is no ``index.html`` file in the directory. * Allow external links in a package index to be specified using ``rel="homepage"`` or ``rel="download"``, without needing the old PyPI-specific visible markup. * Suppressed warning message about possibly-misspelled project name, if an egg or link for that project name has already been seen. 0.6b3 * Fix local ``--find-links`` eggs not being copied except with ``--always-copy``. * Fix sometimes not detecting local packages installed outside of "site" directories. * Fix mysterious errors during initial ``setuptools`` install, caused by ``ez_setup`` trying to run ``easy_install`` twice, due to a code fallthru after deleting the egg from which it's running. 0.6b2 * Don't install or update a ``site.py`` patch when installing to a ``PYTHONPATH`` directory with ``--multi-version``, unless an ``easy-install.pth`` file is already in use there. * Construct ``.pth`` file paths in such a way that installing an egg whose name begins with ``import`` doesn't cause a syntax error. * Fixed a bogus warning message that wasn't updated since the 0.5 versions. 0.6b1 * Better ambiguity management: accept ``#egg`` name/version even if processing what appears to be a correctly-named distutils file, and ignore ``.egg`` files with no ``-``, since valid Python ``.egg`` files always have a version number (but Scheme eggs often don't). * Support ``file://`` links to directories in ``--find-links``, so that easy_install can build packages from local source checkouts. * Added automatic retry for Sourceforge mirrors. The new download process is to first just try dl.sourceforge.net, then randomly select mirror IPs and remove ones that fail, until something works. The removed IPs stay removed for the remainder of the run. * Ignore bdist_dumb distributions when looking at download URLs. 0.6a11 * Process ``dependency_links.txt`` if found in a distribution, by adding the URLs to the list for scanning. * Use relative paths in ``.pth`` files when eggs are being installed to the same directory as the ``.pth`` file. This maximizes portability of the target directory when building applications that contain eggs. * Added ``easy_install-N.N`` script(s) for convenience when using multiple Python versions. * Added automatic handling of installation conflicts. Eggs are now shifted to the front of sys.path, in an order consistent with where they came from, making EasyInstall seamlessly co-operate with system package managers. The ``--delete-conflicting`` and ``--ignore-conflicts-at-my-risk`` options are now no longer necessary, and will generate warnings at the end of a run if you use them. * Don't recursively traverse subdirectories given to ``--find-links``. 0.6a10 * Added exhaustive testing of the install directory, including a spawn test for ``.pth`` file support, and directory writability/existence checks. This should virtually eliminate the need to set or configure ``--site-dirs``. * Added ``--prefix`` option for more do-what-I-mean-ishness in the absence of RTFM-ing. :) * Enhanced ``PYTHONPATH`` support so that you don't have to put any eggs on it manually to make it work. ``--multi-version`` is no longer a silent default; you must explicitly use it if installing to a non-PYTHONPATH, non-"site" directory. * Expand ``$variables`` used in the ``--site-dirs``, ``--build-directory``, ``--install-dir``, and ``--script-dir`` options, whether on the command line or in configuration files. * Improved SourceForge mirror processing to work faster and be less affected by transient HTML changes made by SourceForge. * PyPI searches now use the exact spelling of requirements specified on the command line or in a project's ``install_requires``. Previously, a normalized form of the name was used, which could lead to unnecessary full-index searches when a project's name had an underscore (``_``) in it. * EasyInstall can now download bare ``.py`` files and wrap them in an egg, as long as you include an ``#egg=name-version`` suffix on the URL, or if the ``.py`` file is listed as the "Download URL" on the project's PyPI page. This allows third parties to "package" trivial Python modules just by linking to them (e.g. from within their own PyPI page or download links page). * The ``--always-copy`` option now skips "system" and "development" eggs since they can't be reliably copied. Note that this may cause EasyInstall to choose an older version of a package than what you expected, or it may cause downloading and installation of a fresh version of what's already installed. * The ``--find-links`` option previously scanned all supplied URLs and directories as early as possible, but now only directories and direct archive links are scanned immediately. URLs are not retrieved unless a package search was already going to go online due to a package not being available locally, or due to the use of the ``--update`` or ``-U`` option. * Fixed the annoying ``--help-commands`` wart. 0.6a9 * Fixed ``.pth`` file processing picking up nested eggs (i.e. ones inside "baskets") when they weren't explicitly listed in the ``.pth`` file. * If more than one URL appears to describe the exact same distribution, prefer the shortest one. This helps to avoid "table of contents" CGI URLs like the ones on effbot.org. * Quote arguments to python.exe (including python's path) to avoid problems when Python (or a script) is installed in a directory whose name contains spaces on Windows. * Support full roundtrip translation of eggs to and from ``bdist_wininst`` format. Running ``bdist_wininst`` on a setuptools-based package wraps the egg in an .exe that will safely install it as an egg (i.e., with metadata and entry-point wrapper scripts), and ``easy_install`` can turn the .exe back into an ``.egg`` file or directory and install it as such. 0.6a8 * Update for changed SourceForge mirror format * Fixed not installing dependencies for some packages fetched via Subversion * Fixed dependency installation with ``--always-copy`` not using the same dependency resolution procedure as other operations. * Fixed not fully removing temporary directories on Windows, if a Subversion checkout left read-only files behind * Fixed some problems building extensions when Pyrex was installed, especially with Python 2.4 and/or packages using SWIG. 0.6a7 * Fixed not being able to install Windows script wrappers using Python 2.3 0.6a6 * Added support for "traditional" PYTHONPATH-based non-root installation, and also the convenient ``virtual-python.py`` script, based on a contribution by Ian Bicking. The setuptools egg now contains a hacked ``site`` module that makes the PYTHONPATH-based approach work with .pth files, so that you can get the full EasyInstall feature set on such installations. * Added ``--no-deps`` and ``--allow-hosts`` options. * Improved Windows ``.exe`` script wrappers so that the script can have the same name as a module without confusing Python. * Changed dependency processing so that it's breadth-first, allowing a depender's preferences to override those of a dependee, to prevent conflicts when a lower version is acceptable to the dependee, but not the depender. Also, ensure that currently installed/selected packages aren't given precedence over ones desired by a package being installed, which could cause conflict errors. 0.6a3 * Improved error message when trying to use old ways of running ``easy_install``. Removed the ability to run via ``python -m`` or by running ``easy_install.py``; ``easy_install`` is the command to run on all supported platforms. * Improved wrapper script generation and runtime initialization so that a VersionConflict doesn't occur if you later install a competing version of a needed package as the default version of that package. * Fixed a problem parsing version numbers in ``#egg=`` links. 0.6a2 * EasyInstall can now install "console_scripts" defined by packages that use ``setuptools`` and define appropriate entry points. On Windows, console scripts get an ``.exe`` wrapper so you can just type their name. On other platforms, the scripts are installed without a file extension. * Using ``python -m easy_install`` or running ``easy_install.py`` is now DEPRECATED, since an ``easy_install`` wrapper is now available on all platforms. 0.6a1 * EasyInstall now does MD5 validation of downloads from PyPI, or from any link that has an "#md5=..." trailer with a 32-digit lowercase hex md5 digest. * EasyInstall now handles symlinks in target directories by removing the link, rather than attempting to overwrite the link's destination. This makes it easier to set up an alternate Python "home" directory (as described above in the `Non-Root Installation`_ section). * Added support for handling MacOS platform information in ``.egg`` filenames, based on a contribution by Kevin Dangoor. You may wish to delete and reinstall any eggs whose filename includes "darwin" and "Power_Macintosh", because the format for this platform information has changed so that minor OS X upgrades (such as 10.4.1 to 10.4.2) do not cause eggs built with a previous OS version to become obsolete. * easy_install's dependency processing algorithms have changed. When using ``--always-copy``, it now ensures that dependencies are copied too. When not using ``--always-copy``, it tries to use a single resolution loop, rather than recursing. * Fixed installing extra ``.pyc`` or ``.pyo`` files for scripts with ``.py`` extensions. * Added ``--site-dirs`` option to allow adding custom "site" directories. Made ``easy-install.pth`` work in platform-specific alternate site directories (e.g. ``~/Library/Python/2.x/site-packages`` on Mac OS X). * If you manually delete the current version of a package, the next run of EasyInstall against the target directory will now remove the stray entry from the ``easy-install.pth`` file. * EasyInstall now recognizes URLs with a ``#egg=project_name`` fragment ID as pointing to the named project's source checkout. Such URLs have a lower match precedence than any other kind of distribution, so they'll only be used if they have a higher version number than any other available distribution, or if you use the ``--editable`` option. The ``#egg`` fragment can contain a version if it's formatted as ``#egg=proj-ver``, where ``proj`` is the project name, and ``ver`` is the version number. You *must* use the format for these values that the ``bdist_egg`` command uses; i.e., all non-alphanumeric runs must be condensed to single underscore characters. * Added the ``--editable`` option; see `Editing and Viewing Source Packages`_ above for more info. Also, slightly changed the behavior of the ``--build-directory`` option. * Fixed the setup script sandbox facility not recognizing certain paths as valid on case-insensitive platforms. 0.5a12 * Fix ``python -m easy_install`` not working due to setuptools being installed as a zipfile. Update safety scanner to check for modules that might be used as ``python -m`` scripts. * Misc. fixes for win32.exe support, including changes to support Python 2.4's changed ``bdist_wininst`` format. 0.5a10 * Put the ``easy_install`` module back in as a module, as it's needed for ``python -m`` to run it! * Allow ``--find-links/-f`` to accept local directories or filenames as well as URLs. 0.5a9 * EasyInstall now automatically detects when an "unmanaged" package or module is going to be on ``sys.path`` ahead of a package you're installing, thereby preventing the newer version from being imported. By default, it will abort installation to alert you of the problem, but there are also new options (``--delete-conflicting`` and ``--ignore-conflicts-at-my-risk``) available to change the default behavior. (Note: this new feature doesn't take effect for egg files that were built with older ``setuptools`` versions, because they lack the new metadata file required to implement it.) * The ``easy_install`` distutils command now uses ``DistutilsError`` as its base error type for errors that should just issue a message to stderr and exit the program without a traceback. * EasyInstall can now be given a path to a directory containing a setup script, and it will attempt to build and install the package there. * EasyInstall now performs a safety analysis on module contents to determine whether a package is likely to run in zipped form, and displays information about what modules may be doing introspection that would break when running as a zipfile. * Added the ``--always-unzip/-Z`` option, to force unzipping of packages that would ordinarily be considered safe to unzip, and changed the meaning of ``--zip-ok/-z`` to "always leave everything zipped". 0.5a8 * There is now a separate documentation page for `setuptools`_; revision history that's not specific to EasyInstall has been moved to that page. .. _setuptools: http://peak.telecommunity.com/DevCenter/setuptools 0.5a5 * Made ``easy_install`` a standard ``setuptools`` command, moving it from the ``easy_install`` module to ``setuptools.command.easy_install``. Note that if you were importing or extending it, you must now change your imports accordingly. ``easy_install.py`` is still installed as a script, but not as a module. 0.5a4 * Added ``--always-copy/-a`` option to always copy needed packages to the installation directory, even if they're already present elsewhere on sys.path. (In previous versions, this was the default behavior, but now you must request it.) * Added ``--upgrade/-U`` option to force checking PyPI for latest available version(s) of all packages requested by name and version, even if a matching version is available locally. * Added automatic installation of dependencies declared by a distribution being installed. These dependencies must be listed in the distribution's ``EGG-INFO`` directory, so the distribution has to have declared its dependencies by using setuptools. If a package has requirements it didn't declare, you'll still have to deal with them yourself. (E.g., by asking EasyInstall to find and install them.) * Added the ``--record`` option to ``easy_install`` for the benefit of tools that run ``setup.py install --record=filename`` on behalf of another packaging system.) 0.5a3 * Fixed not setting script permissions to allow execution. * Improved sandboxing so that setup scripts that want a temporary directory (e.g. pychecker) can still run in the sandbox. 0.5a2 * Fix stupid stupid refactoring-at-the-last-minute typos. :( 0.5a1 * Added support for converting ``.win32.exe`` installers to eggs on the fly. EasyInstall will now recognize such files by name and install them. * Fixed a problem with picking the "best" version to install (versions were being sorted as strings, rather than as parsed values) 0.4a4 * Added support for the distutils "verbose/quiet" and "dry-run" options, as well as the "optimize" flag. * Support downloading packages that were uploaded to PyPI (by scanning all links on package pages, not just the homepage/download links). 0.4a3 * Add progress messages to the search/download process so that you can tell what URLs it's reading to find download links. (Hopefully, this will help people report out-of-date and broken links to package authors, and to tell when they've asked for a package that doesn't exist.) 0.4a2 * Added support for installing scripts * Added support for setting options via distutils configuration files, and using distutils' default options as a basis for EasyInstall's defaults. * Renamed ``--scan-url/-s`` to ``--find-links/-f`` to free up ``-s`` for the script installation directory option. * Use ``urllib2`` instead of ``urllib``, to allow use of ``https:`` URLs if Python includes SSL support. 0.4a1 * Added ``--scan-url`` and ``--index-url`` options, to scan download pages and search PyPI for needed packages. 0.3a4 * Restrict ``--build-directory=DIR/-b DIR`` option to only be used with single URL installs, to avoid running the wrong setup.py. 0.3a3 * Added ``--build-directory=DIR/-b DIR`` option. * Added "installation report" that explains how to use 'require()' when doing a multiversion install or alternate installation directory. * Added SourceForge mirror auto-select (Contributed by Ian Bicking) * Added "sandboxing" that stops a setup script from running if it attempts to write to the filesystem outside of the build area * Added more workarounds for packages with quirky ``install_data`` hacks 0.3a2 * Added subversion download support for ``svn:`` and ``svn+`` URLs, as well as automatic recognition of HTTP subversion URLs (Contributed by Ian Bicking) * Misc. bug fixes 0.3a1 * Initial release. Future Plans ============ * Additional utilities to list/remove/verify packages * Signature checking? SSL? Ability to suppress PyPI search? * Display byte progress meter when downloading distributions and long pages? * Redirect stdout/stderr to log during run_setup? setuptools-20.7.0/docs/formats.txt0000664000175000017500000007501212702524020020030 0ustar travistravis00000000000000===================================== The Internal Structure of Python Eggs ===================================== STOP! This is not the first document you should read! .. contents:: **Table of Contents** ---------------------- Eggs and their Formats ---------------------- A "Python egg" is a logical structure embodying the release of a specific version of a Python project, comprising its code, resources, and metadata. There are multiple formats that can be used to physically encode a Python egg, and others can be developed. However, a key principle of Python eggs is that they should be discoverable and importable. That is, it should be possible for a Python application to easily and efficiently find out what eggs are present on a system, and to ensure that the desired eggs' contents are importable. There are two basic formats currently implemented for Python eggs: 1. ``.egg`` format: a directory or zipfile *containing* the project's code and resources, along with an ``EGG-INFO`` subdirectory that contains the project's metadata 2. ``.egg-info`` format: a file or directory placed *adjacent* to the project's code and resources, that directly contains the project's metadata. Both formats can include arbitrary Python code and resources, including static data files, package and non-package directories, Python modules, C extension modules, and so on. But each format is optimized for different purposes. The ``.egg`` format is well-suited to distribution and the easy uninstallation or upgrades of code, since the project is essentially self-contained within a single directory or file, unmingled with any other projects' code or resources. It also makes it possible to have multiple versions of a project simultaneously installed, such that individual programs can select the versions they wish to use. The ``.egg-info`` format, on the other hand, was created to support backward-compatibility, performance, and ease of installation for system packaging tools that expect to install all projects' code and resources to a single directory (e.g. ``site-packages``). Placing the metadata in that same directory simplifies the installation process, since it isn't necessary to create ``.pth`` files or otherwise modify ``sys.path`` to include each installed egg. Its disadvantage, however, is that it provides no support for clean uninstallation or upgrades, and of course only a single version of a project can be installed to a given directory. Thus, support from a package management tool is required. (This is why setuptools' "install" command refers to this type of egg installation as "single-version, externally managed".) Also, they lack sufficient data to allow them to be copied from their installation source. easy_install can "ship" an application by copying ``.egg`` files or directories to a target location, but it cannot do this for ``.egg-info`` installs, because there is no way to tell what code and resources belong to a particular egg -- there may be several eggs "scrambled" together in a single installation location, and the ``.egg-info`` format does not currently include a way to list the files that were installed. (This may change in a future version.) Code and Resources ================== The layout of the code and resources is dictated by Python's normal import layout, relative to the egg's "base location". For the ``.egg`` format, the base location is the ``.egg`` itself. That is, adding the ``.egg`` filename or directory name to ``sys.path`` makes its contents importable. For the ``.egg-info`` format, however, the base location is the directory that *contains* the ``.egg-info``, and thus it is the directory that must be added to ``sys.path`` to make the egg importable. (Note that this means that the "normal" installation of a package to a ``sys.path`` directory is sufficient to make it an "egg" if it has an ``.egg-info`` file or directory installed alongside of it.) Project Metadata ================= If eggs contained only code and resources, there would of course be no difference between them and any other directory or zip file on ``sys.path``. Thus, metadata must also be included, using a metadata file or directory. For the ``.egg`` format, the metadata is placed in an ``EGG-INFO`` subdirectory, directly within the ``.egg`` file or directory. For the ``.egg-info`` format, metadata is stored directly within the ``.egg-info`` directory itself. The minimum project metadata that all eggs must have is a standard Python ``PKG-INFO`` file, named ``PKG-INFO`` and placed within the metadata directory appropriate to the format. Because it's possible for this to be the only metadata file included, ``.egg-info`` format eggs are not required to be a directory; they can just be a ``.egg-info`` file that directly contains the ``PKG-INFO`` metadata. This eliminates the need to create a directory just to store one file. This option is *not* available for ``.egg`` formats, since setuptools always includes other metadata. (In fact, setuptools itself never generates ``.egg-info`` files, either; the support for using files was added so that the requirement could easily be satisfied by other tools, such as the distutils in Python 2.5). In addition to the ``PKG-INFO`` file, an egg's metadata directory may also include files and directories representing various forms of optional standard metadata (see the section on `Standard Metadata`_, below) or user-defined metadata required by the project. For example, some projects may define a metadata format to describe their application plugins, and metadata in this format would then be included by plugin creators in their projects' metadata directories. Filename-Embedded Metadata ========================== To allow introspection of installed projects and runtime resolution of inter-project dependencies, a certain amount of information is embedded in egg filenames. At a minimum, this includes the project name, and ideally will also include the project version number. Optionally, it can also include the target Python version and required runtime platform if platform-specific C code is included. The syntax of an egg filename is as follows:: name ["-" version ["-py" pyver ["-" required_platform]]] "." ext The "name" and "version" should be escaped using the ``to_filename()`` function provided by ``pkg_resources``, after first processing them with ``safe_name()`` and ``safe_version()`` respectively. These latter two functions can also be used to later "unescape" these parts of the filename. (For a detailed description of these transformations, please see the "Parsing Utilities" section of the ``pkg_resources`` manual.) The "pyver" string is the Python major version, as found in the first 3 characters of ``sys.version``. "required_platform" is essentially a distutils ``get_platform()`` string, but with enhancements to properly distinguish Mac OS versions. (See the ``get_build_platform()`` documentation in the "Platform Utilities" section of the ``pkg_resources`` manual for more details.) Finally, the "ext" is either ``.egg`` or ``.egg-info``, as appropriate for the egg's format. Normally, an egg's filename should include at least the project name and version, as this allows the runtime system to find desired project versions without having to read the egg's PKG-INFO to determine its version number. Setuptools, however, only includes the version number in the filename when an ``.egg`` file is built using the ``bdist_egg`` command, or when an ``.egg-info`` directory is being installed by the ``install_egg_info`` command. When generating metadata for use with the original source tree, it only includes the project name, so that the directory will not have to be renamed each time the project's version changes. This is especially important when version numbers change frequently, and the source metadata directory is kept under version control with the rest of the project. (As would be the case when the project's source includes project-defined metadata that is not generated from by setuptools from data in the setup script.) Egg Links ========= In addition to the ``.egg`` and ``.egg-info`` formats, there is a third egg-related extension that you may encounter on occasion: ``.egg-link`` files. These files are not eggs, strictly speaking. They simply provide a way to reference an egg that is not physically installed in the desired location. They exist primarily as a cross-platform alternative to symbolic links, to support "installing" code that is being developed in a different location than the desired installation location. For example, if a user is developing an application plugin in their home directory, but the plugin needs to be "installed" in an application plugin directory, running "setup.py develop -md /path/to/app/plugins" will install an ``.egg-link`` file in ``/path/to/app/plugins``, that tells the egg runtime system where to find the actual egg (the user's project source directory and its ``.egg-info`` subdirectory). ``.egg-link`` files are named following the format for ``.egg`` and ``.egg-info`` names, but only the project name is included; no version, Python version, or platform information is included. When the runtime searches for available eggs, ``.egg-link`` files are opened and the actual egg file/directory name is read from them. Each ``.egg-link`` file should contain a single file or directory name, with no newlines. This filename should be the base location of one or more eggs. That is, the name must either end in ``.egg``, or else it should be the parent directory of one or more ``.egg-info`` format eggs. As of setuptools 0.6c6, the path may be specified as a platform-independent (i.e. ``/``-separated) relative path from the directory containing the ``.egg-link`` file, and a second line may appear in the file, specifying a platform-independent relative path from the egg's base directory to its setup script directory. This allows installation tools such as EasyInstall to find the project's setup directory and build eggs or perform other setup commands on it. ----------------- Standard Metadata ----------------- In addition to the minimum required ``PKG-INFO`` metadata, projects can include a variety of standard metadata files or directories, as described below. Except as otherwise noted, these files and directories are automatically generated by setuptools, based on information supplied in the setup script or through analysis of the project's code and resources. Most of these files and directories are generated via "egg-info writers" during execution of the setuptools ``egg_info`` command, and are listed in the ``egg_info.writers`` entry point group defined by setuptools' own ``setup.py`` file. Project authors can register their own metadata writers as entry points in this group (as described in the setuptools manual under "Adding new EGG-INFO Files") to cause setuptools to generate project-specific metadata files or directories during execution of the ``egg_info`` command. It is up to project authors to document these new metadata formats, if they create any. ``.txt`` File Formats ===================== Files described in this section that have ``.txt`` extensions have a simple lexical format consisting of a sequence of text lines, each line terminated by a linefeed character (regardless of platform). Leading and trailing whitespace on each line is ignored, as are blank lines and lines whose first nonblank character is a ``#`` (comment symbol). (This is the parsing format defined by the ``yield_lines()`` function of the ``pkg_resources`` module.) All ``.txt`` files defined by this section follow this format, but some are also "sectioned" files, meaning that their contents are divided into sections, using square-bracketed section headers akin to Windows ``.ini`` format. Note that this does *not* imply that the lines within the sections follow an ``.ini`` format, however. Please see an individual metadata file's documentation for a description of what the lines and section names mean in that particular file. Sectioned files can be parsed using the ``split_sections()`` function; see the "Parsing Utilities" section of the ``pkg_resources`` manual for for details. Dependency Metadata =================== ``requires.txt`` ---------------- This is a "sectioned" text file. Each section is a sequence of "requirements", as parsed by the ``parse_requirements()`` function; please see the ``pkg_resources`` manual for the complete requirement parsing syntax. The first, unnamed section (i.e., before the first section header) in this file is the project's core requirements, which must be installed for the project to function. (Specified using the ``install_requires`` keyword to ``setup()``). The remaining (named) sections describe the project's "extra" requirements, as specified using the ``extras_require`` keyword to ``setup()``. The section name is the name of the optional feature, and the section body lists that feature's dependencies. Note that it is not normally necessary to inspect this file directly; ``pkg_resources.Distribution`` objects have a ``requires()`` method that can be used to obtain ``Requirement`` objects describing the project's core and optional dependencies. ``setup_requires.txt`` ---------------------- Much like ``requires.txt`` except represents the requirements specified by the ``setup_requires`` parameter to the Distribution. ``dependency_links.txt`` ------------------------ A list of dependency URLs, one per line, as specified using the ``dependency_links`` keyword to ``setup()``. These may be direct download URLs, or the URLs of web pages containing direct download links, and will be used by EasyInstall to find dependencies, as though the user had manually provided them via the ``--find-links`` command line option. Please see the setuptools manual and EasyInstall manual for more information on specifying this option, and for information on how EasyInstall processes ``--find-links`` URLs. ``depends.txt`` -- Obsolete, do not create! ------------------------------------------- This file follows an identical format to ``requires.txt``, but is obsolete and should not be used. The earliest versions of setuptools required users to manually create and maintain this file, so the runtime still supports reading it, if it exists. The new filename was created so that it could be automatically generated from ``setup()`` information without overwriting an existing hand-created ``depends.txt``, if one was already present in the project's source ``.egg-info`` directory. ``namespace_packages.txt`` -- Namespace Package Metadata ======================================================== A list of namespace package names, one per line, as supplied to the ``namespace_packages`` keyword to ``setup()``. Please see the manuals for setuptools and ``pkg_resources`` for more information about namespace packages. ``entry_points.txt`` -- "Entry Point"/Plugin Metadata ===================================================== This is a "sectioned" text file, whose contents encode the ``entry_points`` keyword supplied to ``setup()``. All sections are named, as the section names specify the entry point groups in which the corresponding section's entry points are registered. Each section is a sequence of "entry point" lines, each parseable using the ``EntryPoint.parse`` classmethod; please see the ``pkg_resources`` manual for the complete entry point parsing syntax. Note that it is not necessary to parse this file directly; the ``pkg_resources`` module provides a variety of APIs to locate and load entry points automatically. Please see the setuptools and ``pkg_resources`` manuals for details on the nature and uses of entry points. The ``scripts`` Subdirectory ============================ This directory is currently only created for ``.egg`` files built by the setuptools ``bdist_egg`` command. It will contain copies of all of the project's "traditional" scripts (i.e., those specified using the ``scripts`` keyword to ``setup()``). This is so that they can be reconstituted when an ``.egg`` file is installed. The scripts are placed here using the distutils' standard ``install_scripts`` command, so any ``#!`` lines reflect the Python installation where the egg was built. But instead of copying the scripts to the local script installation directory, EasyInstall writes short wrapper scripts that invoke the original scripts from inside the egg, after ensuring that sys.path includes the egg and any eggs it depends on. For more about `script wrappers`_, see the section below on `Installation and Path Management Issues`_. Zip Support Metadata ==================== ``native_libs.txt`` ------------------- A list of C extensions and other dynamic link libraries contained in the egg, one per line. Paths are ``/``-separated and relative to the egg's base location. This file is generated as part of ``bdist_egg`` processing, and as such only appears in ``.egg`` files (and ``.egg`` directories created by unpacking them). It is used to ensure that all libraries are extracted from a zipped egg at the same time, in case there is any direct linkage between them. Please see the `Zip File Issues`_ section below for more information on library and resource extraction from ``.egg`` files. ``eager_resources.txt`` ----------------------- A list of resource files and/or directories, one per line, as specified via the ``eager_resources`` keyword to ``setup()``. Paths are ``/``-separated and relative to the egg's base location. Resource files or directories listed here will be extracted simultaneously, if any of the named resources are extracted, or if any native libraries listed in ``native_libs.txt`` are extracted. Please see the setuptools manual for details on what this feature is used for and how it works, as well as the `Zip File Issues`_ section below. ``zip-safe`` and ``not-zip-safe`` --------------------------------- These are zero-length files, and either one or the other should exist. If ``zip-safe`` exists, it means that the project will work properly when installed as an ``.egg`` zipfile, and conversely the existence of ``not-zip-safe`` means the project should not be installed as an ``.egg`` file. The ``zip_safe`` option to setuptools' ``setup()`` determines which file will be written. If the option isn't provided, setuptools attempts to make its own assessment of whether the package can work, based on code and content analysis. If neither file is present at installation time, EasyInstall defaults to assuming that the project should be unzipped. (Command-line options to EasyInstall, however, take precedence even over an existing ``zip-safe`` or ``not-zip-safe`` file.) Note that these flag files appear only in ``.egg`` files generated by ``bdist_egg``, and in ``.egg`` directories created by unpacking such an ``.egg`` file. ``top_level.txt`` -- Conflict Management Metadata ================================================= This file is a list of the top-level module or package names provided by the project, one Python identifier per line. Subpackages are not included; a project containing both a ``foo.bar`` and a ``foo.baz`` would include only one line, ``foo``, in its ``top_level.txt``. This data is used by ``pkg_resources`` at runtime to issue a warning if an egg is added to ``sys.path`` when its contained packages may have already been imported. (It was also once used to detect conflicts with non-egg packages at installation time, but in more recent versions, setuptools installs eggs in such a way that they always override non-egg packages, thus preventing a problem from arising.) ``SOURCES.txt`` -- Source Files Manifest ======================================== This file is roughly equivalent to the distutils' ``MANIFEST`` file. The differences are as follows: * The filenames always use ``/`` as a path separator, which must be converted back to a platform-specific path whenever they are read. * The file is automatically generated by setuptools whenever the ``egg_info`` or ``sdist`` commands are run, and it is *not* user-editable. Although this metadata is included with distributed eggs, it is not actually used at runtime for any purpose. Its function is to ensure that setuptools-built *source* distributions can correctly discover what files are part of the project's source, even if the list had been generated using revision control metadata on the original author's system. In other words, ``SOURCES.txt`` has little or no runtime value for being included in distributed eggs, and it is possible that future versions of the ``bdist_egg`` and ``install_egg_info`` commands will strip it before installation or distribution. Therefore, do not rely on its being available outside of an original source directory or source distribution. ------------------------------ Other Technical Considerations ------------------------------ Zip File Issues =============== Although zip files resemble directories, they are not fully substitutable for them. Most platforms do not support loading dynamic link libraries contained in zipfiles, so it is not possible to directly import C extensions from ``.egg`` zipfiles. Similarly, there are many existing libraries -- whether in Python or C -- that require actual operating system filenames, and do not work with arbitrary "file-like" objects or in-memory strings, and thus cannot operate directly on the contents of zip files. To address these issues, the ``pkg_resources`` module provides a "resource API" to support obtaining either the contents of a resource, or a true operating system filename for the resource. If the egg containing the resource is a directory, the resource's real filename is simply returned. However, if the egg is a zipfile, then the resource is first extracted to a cache directory, and the filename within the cache is returned. The cache directory is determined by the ``pkg_resources`` API; please see the ``set_cache_path()`` and ``get_default_cache()`` documentation for details. The Extraction Process ---------------------- Resources are extracted to a cache subdirectory whose name is based on the enclosing ``.egg`` filename and the path to the resource. If there is already a file of the correct name, size, and timestamp, its filename is returned to the requester. Otherwise, the desired file is extracted first to a temporary name generated using ``mkstemp(".$extract",target_dir)``, and then its timestamp is set to match the one in the zip file, before renaming it to its final name. (Some collision detection and resolution code is used to handle the fact that Windows doesn't overwrite files when renaming.) If a resource directory is requested, all of its contents are recursively extracted in this fashion, to ensure that the directory name can be used as if it were valid all along. If the resource requested for extraction is listed in the ``native_libs.txt`` or ``eager_resources.txt`` metadata files, then *all* resources listed in *either* file will be extracted before the requested resource's filename is returned, thus ensuring that all C extensions and data used by them will be simultaneously available. Extension Import Wrappers ------------------------- Since Python's built-in zip import feature does not support loading C extension modules from zipfiles, the setuptools ``bdist_egg`` command generates special import wrappers to make it work. The wrappers are ``.py`` files (along with corresponding ``.pyc`` and/or ``.pyo`` files) that have the same module name as the corresponding C extension. These wrappers are located in the same package directory (or top-level directory) within the zipfile, so that say, ``foomodule.so`` will get a corresponding ``foo.py``, while ``bar/baz.pyd`` will get a corresponding ``bar/baz.py``. These wrapper files contain a short stanza of Python code that asks ``pkg_resources`` for the filename of the corresponding C extension, then reloads the module using the obtained filename. This will cause ``pkg_resources`` to first ensure that all of the egg's C extensions (and any accompanying "eager resources") are extracted to the cache before attempting to link to the C library. Note, by the way, that ``.egg`` directories will also contain these wrapper files. However, Python's default import priority is such that C extensions take precedence over same-named Python modules, so the import wrappers are ignored unless the egg is a zipfile. Installation and Path Management Issues ======================================= Python's initial setup of ``sys.path`` is very dependent on the Python version and installation platform, as well as how Python was started (i.e., script vs. ``-c`` vs. ``-m`` vs. interactive interpreter). In fact, Python also provides only two relatively robust ways to affect ``sys.path`` outside of direct manipulation in code: the ``PYTHONPATH`` environment variable, and ``.pth`` files. However, with no cross-platform way to safely and persistently change environment variables, this leaves ``.pth`` files as EasyInstall's only real option for persistent configuration of ``sys.path``. But ``.pth`` files are rather strictly limited in what they are allowed to do normally. They add directories only to the *end* of ``sys.path``, after any locally-installed ``site-packages`` directory, and they are only processed *in* the ``site-packages`` directory to start with. This is a double whammy for users who lack write access to that directory, because they can't create a ``.pth`` file that Python will read, and even if a sympathetic system administrator adds one for them that calls ``site.addsitedir()`` to allow some other directory to contain ``.pth`` files, they won't be able to install newer versions of anything that's installed in the systemwide ``site-packages``, because their paths will still be added *after* ``site-packages``. So EasyInstall applies two workarounds to solve these problems. The first is that EasyInstall leverages ``.pth`` files' "import" feature to manipulate ``sys.path`` and ensure that anything EasyInstall adds to a ``.pth`` file will always appear before both the standard library and the local ``site-packages`` directories. Thus, it is always possible for a user who can write a Python-read ``.pth`` file to ensure that their packages come first in their own environment. Second, when installing to a ``PYTHONPATH`` directory (as opposed to a "site" directory like ``site-packages``) EasyInstall will also install a special version of the ``site`` module. Because it's in a ``PYTHONPATH`` directory, this module will get control before the standard library version of ``site`` does. It will record the state of ``sys.path`` before invoking the "real" ``site`` module, and then afterwards it processes any ``.pth`` files found in ``PYTHONPATH`` directories, including all the fixups needed to ensure that eggs always appear before the standard library in sys.path, but are in a relative order to one another that is defined by their ``PYTHONPATH`` and ``.pth``-prescribed sequence. The net result of these changes is that ``sys.path`` order will be as follows at runtime: 1. The ``sys.argv[0]`` directory, or an empty string if no script is being executed. 2. All eggs installed by EasyInstall in any ``.pth`` file in each ``PYTHONPATH`` directory, in order first by ``PYTHONPATH`` order, then normal ``.pth`` processing order (which is to say alphabetical by ``.pth`` filename, then by the order of listing within each ``.pth`` file). 3. All eggs installed by EasyInstall in any ``.pth`` file in each "site" directory (such as ``site-packages``), following the same ordering rules as for the ones on ``PYTHONPATH``. 4. The ``PYTHONPATH`` directories themselves, in their original order 5. Any paths from ``.pth`` files found on ``PYTHONPATH`` that were *not* eggs installed by EasyInstall, again following the same relative ordering rules. 6. The standard library and "site" directories, along with the contents of any ``.pth`` files found in the "site" directories. Notice that sections 1, 4, and 6 comprise the "normal" Python setup for ``sys.path``. Sections 2 and 3 are inserted to support eggs, and section 5 emulates what the "normal" semantics of ``.pth`` files on ``PYTHONPATH`` would be if Python natively supported them. For further discussion of the tradeoffs that went into this design, as well as notes on the actual magic inserted into ``.pth`` files to make them do these things, please see also the following messages to the distutils-SIG mailing list: * http://mail.python.org/pipermail/distutils-sig/2006-February/006026.html * http://mail.python.org/pipermail/distutils-sig/2006-March/006123.html Script Wrappers --------------- EasyInstall never directly installs a project's original scripts to a script installation directory. Instead, it writes short wrapper scripts that first ensure that the project's dependencies are active on sys.path, before invoking the original script. These wrappers have a #! line that points to the version of Python that was used to install them, and their second line is always a comment that indicates the type of script wrapper, the project version required for the script to run, and information identifying the script to be invoked. The format of this marker line is:: "# EASY-INSTALL-" script_type ": " tuple_of_strings "\n" The ``script_type`` is one of ``SCRIPT``, ``DEV-SCRIPT``, or ``ENTRY-SCRIPT``. The ``tuple_of_strings`` is a comma-separated sequence of Python string constants. For ``SCRIPT`` and ``DEV-SCRIPT`` wrappers, there are two strings: the project version requirement, and the script name (as a filename within the ``scripts`` metadata directory). For ``ENTRY-SCRIPT`` wrappers, there are three: the project version requirement, the entry point group name, and the entry point name. (See the "Automatic Script Creation" section in the setuptools manual for more information about entry point scripts.) In each case, the project version requirement string will be a string parseable with the ``pkg_resources`` modules' ``Requirement.parse()`` classmethod. The only difference between a ``SCRIPT`` wrapper and a ``DEV-SCRIPT`` is that a ``DEV-SCRIPT`` actually executes the original source script in the project's source tree, and is created when the "setup.py develop" command is run. A ``SCRIPT`` wrapper, on the other hand, uses the "installed" script written to the ``EGG-INFO/scripts`` subdirectory of the corresponding ``.egg`` zipfile or directory. (``.egg-info`` eggs do not have script wrappers associated with them, except in the "setup.py develop" case.) The purpose of including the marker line in generated script wrappers is to facilitate introspection of installed scripts, and their relationship to installed eggs. For example, an uninstallation tool could use this data to identify what scripts can safely be removed, and/or identify what scripts would stop working if a particular egg is uninstalled. setuptools-20.7.0/docs/history.txt0000664000175000017500000000012112702524020020043 0ustar travistravis00000000000000:tocdepth: 2 .. _changes: History ******* .. include:: ../CHANGES (links).rst setuptools-20.7.0/docs/index.txt0000664000175000017500000000103112702524020017452 0ustar travistravis00000000000000Welcome to Setuptools' documentation! ===================================== Setuptools is a fully-featured, actively-maintained, and stable library designed to facilitate packaging Python projects, where packaging includes: - Python package and module definitions - Distribution package metadata - Test hooks - Project installation - Platform-specific details - Python 3 support Documentation content: .. toctree:: :maxdepth: 2 history roadmap python3 setuptools easy_install pkg_resources development setuptools-20.7.0/docs/pkg_resources.txt0000664000175000017500000027036412702524020021237 0ustar travistravis00000000000000============================================================= Package Discovery and Resource Access using ``pkg_resources`` ============================================================= The ``pkg_resources`` module distributed with ``setuptools`` provides an API for Python libraries to access their resource files, and for extensible applications and frameworks to automatically discover plugins. It also provides runtime support for using C extensions that are inside zipfile-format eggs, support for merging packages that have separately-distributed modules or subpackages, and APIs for managing Python's current "working set" of active packages. .. contents:: **Table of Contents** -------- Overview -------- The ``pkg_resources`` module provides runtime facilities for finding, introspecting, activating and using installed Python distributions. Some of the more advanced features (notably the support for parallel installation of multiple versions) rely specifically on the "egg" format (either as a zip archive or subdirectory), while others (such as plugin discovery) will work correctly so long as "egg-info" metadata directories are available for relevant distributions. Eggs are a distribution format for Python modules, similar in concept to Java's "jars" or Ruby's "gems", or the "wheel" format defined in PEP 427. However, unlike a pure distribution format, eggs can also be installed and added directly to ``sys.path`` as an import location. When installed in this way, eggs are *discoverable*, meaning that they carry metadata that unambiguously identifies their contents and dependencies. This means that an installed egg can be *automatically* found and added to ``sys.path`` in response to simple requests of the form, "get me everything I need to use docutils' PDF support". This feature allows mutually conflicting versions of a distribution to co-exist in the same Python installation, with individual applications activating the desired version at runtime by manipulating the contents of ``sys.path`` (this differs from the virtual environment approach, which involves creating isolated environments for each application). The following terms are needed in order to explain the capabilities offered by this module: project A library, framework, script, plugin, application, or collection of data or other resources, or some combination thereof. Projects are assumed to have "relatively unique" names, e.g. names registered with PyPI. release A snapshot of a project at a particular point in time, denoted by a version identifier. distribution A file or files that represent a particular release. importable distribution A file or directory that, if placed on ``sys.path``, allows Python to import any modules contained within it. pluggable distribution An importable distribution whose filename unambiguously identifies its release (i.e. project and version), and whose contents unambiguously specify what releases of other projects will satisfy its runtime requirements. extra An "extra" is an optional feature of a release, that may impose additional runtime requirements. For example, if docutils PDF support required a PDF support library to be present, docutils could define its PDF support as an "extra", and list what other project releases need to be available in order to provide it. environment A collection of distributions potentially available for importing, but not necessarily active. More than one distribution (i.e. release version) for a given project may be present in an environment. working set A collection of distributions actually available for importing, as on ``sys.path``. At most one distribution (release version) of a given project may be present in a working set, as otherwise there would be ambiguity as to what to import. eggs Eggs are pluggable distributions in one of the three formats currently supported by ``pkg_resources``. There are built eggs, development eggs, and egg links. Built eggs are directories or zipfiles whose name ends with ``.egg`` and follows the egg naming conventions, and contain an ``EGG-INFO`` subdirectory (zipped or otherwise). Development eggs are normal directories of Python code with one or more ``ProjectName.egg-info`` subdirectories. The development egg format is also used to provide a default version of a distribution that is available to software that doesn't use ``pkg_resources`` to request specific versions. Egg links are ``*.egg-link`` files that contain the name of a built or development egg, to support symbolic linking on platforms that do not have native symbolic links (or where the symbolic link support is limited). (For more information about these terms and concepts, see also this `architectural overview`_ of ``pkg_resources`` and Python Eggs in general.) .. _architectural overview: http://mail.python.org/pipermail/distutils-sig/2005-June/004652.html .. ----------------- .. Developer's Guide .. ----------------- .. This section isn't written yet. Currently planned topics include Accessing Resources Finding and Activating Package Distributions get_provider() require() WorkingSet iter_distributions Running Scripts Configuration Namespace Packages Extensible Applications and Frameworks Locating entry points Activation listeners Metadata access Extended Discovery and Installation Supporting Custom PEP 302 Implementations .. For now, please check out the extensive `API Reference`_ below. ------------- API Reference ------------- Namespace Package Support ========================= A namespace package is a package that only contains other packages and modules, with no direct contents of its own. Such packages can be split across multiple, separately-packaged distributions. They are normally used to split up large packages produced by a single organization, such as in the ``zope`` namespace package for Zope Corporation packages, and the ``peak`` namespace package for the Python Enterprise Application Kit. To create a namespace package, you list it in the ``namespace_packages`` argument to ``setup()``, in your project's ``setup.py``. (See the `setuptools documentation on namespace packages`_ for more information on this.) Also, you must add a ``declare_namespace()`` call in the package's ``__init__.py`` file(s): ``declare_namespace(name)`` Declare that the dotted package name `name` is a "namespace package" whose contained packages and modules may be spread across multiple distributions. The named package's ``__path__`` will be extended to include the corresponding package in all distributions on ``sys.path`` that contain a package of that name. (More precisely, if an importer's ``find_module(name)`` returns a loader, then it will also be searched for the package's contents.) Whenever a Distribution's ``activate()`` method is invoked, it checks for the presence of namespace packages and updates their ``__path__`` contents accordingly. Applications that manipulate namespace packages or directly alter ``sys.path`` at runtime may also need to use this API function: ``fixup_namespace_packages(path_item)`` Declare that `path_item` is a newly added item on ``sys.path`` that may need to be used to update existing namespace packages. Ordinarily, this is called for you when an egg is automatically added to ``sys.path``, but if your application modifies ``sys.path`` to include locations that may contain portions of a namespace package, you will need to call this function to ensure they are added to the existing namespace packages. Although by default ``pkg_resources`` only supports namespace packages for filesystem and zip importers, you can extend its support to other "importers" compatible with PEP 302 using the ``register_namespace_handler()`` function. See the section below on `Supporting Custom Importers`_ for details. .. _setuptools documentation on namespace packages: http://peak.telecommunity.com/DevCenter/setuptools#namespace-packages ``WorkingSet`` Objects ====================== The ``WorkingSet`` class provides access to a collection of "active" distributions. In general, there is only one meaningful ``WorkingSet`` instance: the one that represents the distributions that are currently active on ``sys.path``. This global instance is available under the name ``working_set`` in the ``pkg_resources`` module. However, specialized tools may wish to manipulate working sets that don't correspond to ``sys.path``, and therefore may wish to create other ``WorkingSet`` instances. It's important to note that the global ``working_set`` object is initialized from ``sys.path`` when ``pkg_resources`` is first imported, but is only updated if you do all future ``sys.path`` manipulation via ``pkg_resources`` APIs. If you manually modify ``sys.path``, you must invoke the appropriate methods on the ``working_set`` instance to keep it in sync. Unfortunately, Python does not provide any way to detect arbitrary changes to a list object like ``sys.path``, so ``pkg_resources`` cannot automatically update the ``working_set`` based on changes to ``sys.path``. ``WorkingSet(entries=None)`` Create a ``WorkingSet`` from an iterable of path entries. If `entries` is not supplied, it defaults to the value of ``sys.path`` at the time the constructor is called. Note that you will not normally construct ``WorkingSet`` instances yourself, but instead you will implicitly or explicitly use the global ``working_set`` instance. For the most part, the ``pkg_resources`` API is designed so that the ``working_set`` is used by default, such that you don't have to explicitly refer to it most of the time. All distributions available directly on ``sys.path`` will be activated automatically when ``pkg_resources`` is imported. This behaviour can cause version conflicts for applications which require non-default versions of those distributions. To handle this situation, ``pkg_resources`` checks for a ``__requires__`` attribute in the ``__main__`` module when initializing the default working set, and uses this to ensure a suitable version of each affected distribution is activated. For example:: __requires__ = ["CherryPy < 3"] # Must be set before pkg_resources import import pkg_resources Basic ``WorkingSet`` Methods ---------------------------- The following methods of ``WorkingSet`` objects are also available as module- level functions in ``pkg_resources`` that apply to the default ``working_set`` instance. Thus, you can use e.g. ``pkg_resources.require()`` as an abbreviation for ``pkg_resources.working_set.require()``: ``require(*requirements)`` Ensure that distributions matching `requirements` are activated `requirements` must be a string or a (possibly-nested) sequence thereof, specifying the distributions and versions required. The return value is a sequence of the distributions that needed to be activated to fulfill the requirements; all relevant distributions are included, even if they were already activated in this working set. For the syntax of requirement specifiers, see the section below on `Requirements Parsing`_. In general, it should not be necessary for you to call this method directly. It's intended more for use in quick-and-dirty scripting and interactive interpreter hacking than for production use. If you're creating an actual library or application, it's strongly recommended that you create a "setup.py" script using ``setuptools``, and declare all your requirements there. That way, tools like EasyInstall can automatically detect what requirements your package has, and deal with them accordingly. Note that calling ``require('SomePackage')`` will not install ``SomePackage`` if it isn't already present. If you need to do this, you should use the ``resolve()`` method instead, which allows you to pass an ``installer`` callback that will be invoked when a needed distribution can't be found on the local machine. You can then have this callback display a dialog, automatically download the needed distribution, or whatever else is appropriate for your application. See the documentation below on the ``resolve()`` method for more information, and also on the ``obtain()`` method of ``Environment`` objects. ``run_script(requires, script_name)`` Locate distribution specified by `requires` and run its `script_name` script. `requires` must be a string containing a requirement specifier. (See `Requirements Parsing`_ below for the syntax.) The script, if found, will be executed in *the caller's globals*. That's because this method is intended to be called from wrapper scripts that act as a proxy for the "real" scripts in a distribution. A wrapper script usually doesn't need to do anything but invoke this function with the correct arguments. If you need more control over the script execution environment, you probably want to use the ``run_script()`` method of a ``Distribution`` object's `Metadata API`_ instead. ``iter_entry_points(group, name=None)`` Yield entry point objects from `group` matching `name` If `name` is None, yields all entry points in `group` from all distributions in the working set, otherwise only ones matching both `group` and `name` are yielded. Entry points are yielded from the active distributions in the order that the distributions appear in the working set. (For the global ``working_set``, this should be the same as the order that they are listed in ``sys.path``.) Note that within the entry points advertised by an individual distribution, there is no particular ordering. Please see the section below on `Entry Points`_ for more information. ``WorkingSet`` Methods and Attributes ------------------------------------- These methods are used to query or manipulate the contents of a specific working set, so they must be explicitly invoked on a particular ``WorkingSet`` instance: ``add_entry(entry)`` Add a path item to the ``entries``, finding any distributions on it. You should use this when you add additional items to ``sys.path`` and you want the global ``working_set`` to reflect the change. This method is also called by the ``WorkingSet()`` constructor during initialization. This method uses ``find_distributions(entry,True)`` to find distributions corresponding to the path entry, and then ``add()`` them. `entry` is always appended to the ``entries`` attribute, even if it is already present, however. (This is because ``sys.path`` can contain the same value more than once, and the ``entries`` attribute should be able to reflect this.) ``__contains__(dist)`` True if `dist` is active in this ``WorkingSet``. Note that only one distribution for a given project can be active in a given ``WorkingSet``. ``__iter__()`` Yield distributions for non-duplicate projects in the working set. The yield order is the order in which the items' path entries were added to the working set. ``find(req)`` Find a distribution matching `req` (a ``Requirement`` instance). If there is an active distribution for the requested project, this returns it, as long as it meets the version requirement specified by `req`. But, if there is an active distribution for the project and it does *not* meet the `req` requirement, ``VersionConflict`` is raised. If there is no active distribution for the requested project, ``None`` is returned. ``resolve(requirements, env=None, installer=None)`` List all distributions needed to (recursively) meet `requirements` `requirements` must be a sequence of ``Requirement`` objects. `env`, if supplied, should be an ``Environment`` instance. If not supplied, an ``Environment`` is created from the working set's ``entries``. `installer`, if supplied, will be invoked with each requirement that cannot be met by an already-installed distribution; it should return a ``Distribution`` or ``None``. (See the ``obtain()`` method of `Environment Objects`_, below, for more information on the `installer` argument.) ``add(dist, entry=None)`` Add `dist` to working set, associated with `entry` If `entry` is unspecified, it defaults to ``dist.location``. On exit from this routine, `entry` is added to the end of the working set's ``.entries`` (if it wasn't already present). `dist` is only added to the working set if it's for a project that doesn't already have a distribution active in the set. If it's successfully added, any callbacks registered with the ``subscribe()`` method will be called. (See `Receiving Change Notifications`_, below.) Note: ``add()`` is automatically called for you by the ``require()`` method, so you don't normally need to use this method directly. ``entries`` This attribute represents a "shadow" ``sys.path``, primarily useful for debugging. If you are experiencing import problems, you should check the global ``working_set`` object's ``entries`` against ``sys.path``, to ensure that they match. If they do not, then some part of your program is manipulating ``sys.path`` without updating the ``working_set`` accordingly. IMPORTANT NOTE: do not directly manipulate this attribute! Setting it equal to ``sys.path`` will not fix your problem, any more than putting black tape over an "engine warning" light will fix your car! If this attribute is out of sync with ``sys.path``, it's merely an *indicator* of the problem, not the cause of it. Receiving Change Notifications ------------------------------ Extensible applications and frameworks may need to receive notification when a new distribution (such as a plug-in component) has been added to a working set. This is what the ``subscribe()`` method and ``add_activation_listener()`` function are for. ``subscribe(callback)`` Invoke ``callback(distribution)`` once for each active distribution that is in the set now, or gets added later. Because the callback is invoked for already-active distributions, you do not need to loop over the working set yourself to deal with the existing items; just register the callback and be prepared for the fact that it will be called immediately by this method. Note that callbacks *must not* allow exceptions to propagate, or they will interfere with the operation of other callbacks and possibly result in an inconsistent working set state. Callbacks should use a try/except block to ignore, log, or otherwise process any errors, especially since the code that caused the callback to be invoked is unlikely to be able to handle the errors any better than the callback itself. ``pkg_resources.add_activation_listener()`` is an alternate spelling of ``pkg_resources.working_set.subscribe()``. Locating Plugins ---------------- Extensible applications will sometimes have a "plugin directory" or a set of plugin directories, from which they want to load entry points or other metadata. The ``find_plugins()`` method allows you to do this, by scanning an environment for the newest version of each project that can be safely loaded without conflicts or missing requirements. ``find_plugins(plugin_env, full_env=None, fallback=True)`` Scan `plugin_env` and identify which distributions could be added to this working set without version conflicts or missing requirements. Example usage:: distributions, errors = working_set.find_plugins( Environment(plugin_dirlist) ) map(working_set.add, distributions) # add plugins+libs to sys.path print "Couldn't load", errors # display errors The `plugin_env` should be an ``Environment`` instance that contains only distributions that are in the project's "plugin directory" or directories. The `full_env`, if supplied, should be an ``Environment`` instance that contains all currently-available distributions. If `full_env` is not supplied, one is created automatically from the ``WorkingSet`` this method is called on, which will typically mean that every directory on ``sys.path`` will be scanned for distributions. This method returns a 2-tuple: (`distributions`, `error_info`), where `distributions` is a list of the distributions found in `plugin_env` that were loadable, along with any other distributions that are needed to resolve their dependencies. `error_info` is a dictionary mapping unloadable plugin distributions to an exception instance describing the error that occurred. Usually this will be a ``DistributionNotFound`` or ``VersionConflict`` instance. Most applications will use this method mainly on the master ``working_set`` instance in ``pkg_resources``, and then immediately add the returned distributions to the working set so that they are available on sys.path. This will make it possible to find any entry points, and allow any other metadata tracking and hooks to be activated. The resolution algorithm used by ``find_plugins()`` is as follows. First, the project names of the distributions present in `plugin_env` are sorted. Then, each project's eggs are tried in descending version order (i.e., newest version first). An attempt is made to resolve each egg's dependencies. If the attempt is successful, the egg and its dependencies are added to the output list and to a temporary copy of the working set. The resolution process continues with the next project name, and no older eggs for that project are tried. If the resolution attempt fails, however, the error is added to the error dictionary. If the `fallback` flag is true, the next older version of the plugin is tried, until a working version is found. If false, the resolution process continues with the next plugin project name. Some applications may have stricter fallback requirements than others. For example, an application that has a database schema or persistent objects may not be able to safely downgrade a version of a package. Others may want to ensure that a new plugin configuration is either 100% good or else revert to a known-good configuration. (That is, they may wish to revert to a known configuration if the `error_info` return value is non-empty.) Note that this algorithm gives precedence to satisfying the dependencies of alphabetically prior project names in case of version conflicts. If two projects named "AaronsPlugin" and "ZekesPlugin" both need different versions of "TomsLibrary", then "AaronsPlugin" will win and "ZekesPlugin" will be disabled due to version conflict. ``Environment`` Objects ======================= An "environment" is a collection of ``Distribution`` objects, usually ones that are present and potentially importable on the current platform. ``Environment`` objects are used by ``pkg_resources`` to index available distributions during dependency resolution. ``Environment(search_path=None, platform=get_supported_platform(), python=PY_MAJOR)`` Create an environment snapshot by scanning `search_path` for distributions compatible with `platform` and `python`. `search_path` should be a sequence of strings such as might be used on ``sys.path``. If a `search_path` isn't supplied, ``sys.path`` is used. `platform` is an optional string specifying the name of the platform that platform-specific distributions must be compatible with. If unspecified, it defaults to the current platform. `python` is an optional string naming the desired version of Python (e.g. ``'2.4'``); it defaults to the currently-running version. You may explicitly set `platform` (and/or `python`) to ``None`` if you wish to include *all* distributions, not just those compatible with the running platform or Python version. Note that `search_path` is scanned immediately for distributions, and the resulting ``Environment`` is a snapshot of the found distributions. It is not automatically updated if the system's state changes due to e.g. installation or removal of distributions. ``__getitem__(project_name)`` Returns a list of distributions for the given project name, ordered from newest to oldest version. (And highest to lowest format precedence for distributions that contain the same version of the project.) If there are no distributions for the project, returns an empty list. ``__iter__()`` Yield the unique project names of the distributions in this environment. The yielded names are always in lower case. ``add(dist)`` Add `dist` to the environment if it matches the platform and python version specified at creation time, and only if the distribution hasn't already been added. (i.e., adding the same distribution more than once is a no-op.) ``remove(dist)`` Remove `dist` from the environment. ``can_add(dist)`` Is distribution `dist` acceptable for this environment? If it's not compatible with the ``platform`` and ``python`` version values specified when the environment was created, a false value is returned. ``__add__(dist_or_env)`` (``+`` operator) Add a distribution or environment to an ``Environment`` instance, returning a *new* environment object that contains all the distributions previously contained by both. The new environment will have a ``platform`` and ``python`` of ``None``, meaning that it will not reject any distributions from being added to it; it will simply accept whatever is added. If you want the added items to be filtered for platform and Python version, or you want to add them to the *same* environment instance, you should use in-place addition (``+=``) instead. ``__iadd__(dist_or_env)`` (``+=`` operator) Add a distribution or environment to an ``Environment`` instance *in-place*, updating the existing instance and returning it. The ``platform`` and ``python`` filter attributes take effect, so distributions in the source that do not have a suitable platform string or Python version are silently ignored. ``best_match(req, working_set, installer=None)`` Find distribution best matching `req` and usable on `working_set` This calls the ``find(req)`` method of the `working_set` to see if a suitable distribution is already active. (This may raise ``VersionConflict`` if an unsuitable version of the project is already active in the specified `working_set`.) If a suitable distribution isn't active, this method returns the newest distribution in the environment that meets the ``Requirement`` in `req`. If no suitable distribution is found, and `installer` is supplied, then the result of calling the environment's ``obtain(req, installer)`` method will be returned. ``obtain(requirement, installer=None)`` Obtain a distro that matches requirement (e.g. via download). In the base ``Environment`` class, this routine just returns ``installer(requirement)``, unless `installer` is None, in which case None is returned instead. This method is a hook that allows subclasses to attempt other ways of obtaining a distribution before falling back to the `installer` argument. ``scan(search_path=None)`` Scan `search_path` for distributions usable on `platform` Any distributions found are added to the environment. `search_path` should be a sequence of strings such as might be used on ``sys.path``. If not supplied, ``sys.path`` is used. Only distributions conforming to the platform/python version defined at initialization are added. This method is a shortcut for using the ``find_distributions()`` function to find the distributions from each item in `search_path`, and then calling ``add()`` to add each one to the environment. ``Requirement`` Objects ======================= ``Requirement`` objects express what versions of a project are suitable for some purpose. These objects (or their string form) are used by various ``pkg_resources`` APIs in order to find distributions that a script or distribution needs. Requirements Parsing -------------------- ``parse_requirements(s)`` Yield ``Requirement`` objects for a string or iterable of lines. Each requirement must start on a new line. See below for syntax. ``Requirement.parse(s)`` Create a ``Requirement`` object from a string or iterable of lines. A ``ValueError`` is raised if the string or lines do not contain a valid requirement specifier, or if they contain more than one specifier. (To parse multiple specifiers from a string or iterable of strings, use ``parse_requirements()`` instead.) The syntax of a requirement specifier is defined in full in PEP 508. Some examples of valid requirement specifiers:: FooProject >= 1.2 Fizzy [foo, bar] PickyThing<1.6,>1.9,!=1.9.6,<2.0a0,==2.4c1 SomethingWhoseVersionIDontCareAbout SomethingWithMarker[foo]>1.0;python_version<"2.7" The project name is the only required portion of a requirement string, and if it's the only thing supplied, the requirement will accept any version of that project. The "extras" in a requirement are used to request optional features of a project, that may require additional project distributions in order to function. For example, if the hypothetical "Report-O-Rama" project offered optional PDF support, it might require an additional library in order to provide that support. Thus, a project needing Report-O-Rama's PDF features could use a requirement of ``Report-O-Rama[PDF]`` to request installation or activation of both Report-O-Rama and any libraries it needs in order to provide PDF support. For example, you could use:: easy_install.py Report-O-Rama[PDF] To install the necessary packages using the EasyInstall program, or call ``pkg_resources.require('Report-O-Rama[PDF]')`` to add the necessary distributions to sys.path at runtime. The "markers" in a requirement are used to specify when a requirement should be installed -- the requirement will be installed if the marker evaluates as true in the current environment. For example, specifying ``argparse;python_version<"2.7"`` will not install in an Python 2.7 or 3.3 environment, but will in a Python 2.6 environment. ``Requirement`` Methods and Attributes -------------------------------------- ``__contains__(dist_or_version)`` Return true if `dist_or_version` fits the criteria for this requirement. If `dist_or_version` is a ``Distribution`` object, its project name must match the requirement's project name, and its version must meet the requirement's version criteria. If `dist_or_version` is a string, it is parsed using the ``parse_version()`` utility function. Otherwise, it is assumed to be an already-parsed version. The ``Requirement`` object's version specifiers (``.specs``) are internally sorted into ascending version order, and used to establish what ranges of versions are acceptable. Adjacent redundant conditions are effectively consolidated (e.g. ``">1, >2"`` produces the same results as ``">2"``, and ``"<2,<3"`` produces the same results as``"<2"``). ``"!="`` versions are excised from the ranges they fall within. The version being tested for acceptability is then checked for membership in the resulting ranges. ``__eq__(other_requirement)`` A requirement compares equal to another requirement if they have case-insensitively equal project names, version specifiers, and "extras". (The order that extras and version specifiers are in is also ignored.) Equal requirements also have equal hashes, so that requirements can be used in sets or as dictionary keys. ``__str__()`` The string form of a ``Requirement`` is a string that, if passed to ``Requirement.parse()``, would return an equal ``Requirement`` object. ``project_name`` The name of the required project ``key`` An all-lowercase version of the ``project_name``, useful for comparison or indexing. ``extras`` A tuple of names of "extras" that this requirement calls for. (These will be all-lowercase and normalized using the ``safe_extra()`` parsing utility function, so they may not exactly equal the extras the requirement was created with.) ``specs`` A list of ``(op,version)`` tuples, sorted in ascending parsed-version order. The `op` in each tuple is a comparison operator, represented as a string. The `version` is the (unparsed) version number. ``marker`` An instance of ``packaging.markers.Marker`` that allows evaluation against the current environment. May be None if no marker specified. ``url`` The location to download the requirement from if specified. Entry Points ============ Entry points are a simple way for distributions to "advertise" Python objects (such as functions or classes) for use by other distributions. Extensible applications and frameworks can search for entry points with a particular name or group, either from a specific distribution or from all active distributions on sys.path, and then inspect or load the advertised objects at will. Entry points belong to "groups" which are named with a dotted name similar to a Python package or module name. For example, the ``setuptools`` package uses an entry point named ``distutils.commands`` in order to find commands defined by distutils extensions. ``setuptools`` treats the names of entry points defined in that group as the acceptable commands for a setup script. In a similar way, other packages can define their own entry point groups, either using dynamic names within the group (like ``distutils.commands``), or possibly using predefined names within the group. For example, a blogging framework that offers various pre- or post-publishing hooks might define an entry point group and look for entry points named "pre_process" and "post_process" within that group. To advertise an entry point, a project needs to use ``setuptools`` and provide an ``entry_points`` argument to ``setup()`` in its setup script, so that the entry points will be included in the distribution's metadata. For more details, see the ``setuptools`` documentation. (XXX link here to setuptools) Each project distribution can advertise at most one entry point of a given name within the same entry point group. For example, a distutils extension could advertise two different ``distutils.commands`` entry points, as long as they had different names. However, there is nothing that prevents *different* projects from advertising entry points of the same name in the same group. In some cases, this is a desirable thing, since the application or framework that uses the entry points may be calling them as hooks, or in some other way combining them. It is up to the application or framework to decide what to do if multiple distributions advertise an entry point; some possibilities include using both entry points, displaying an error message, using the first one found in sys.path order, etc. Convenience API --------------- In the following functions, the `dist` argument can be a ``Distribution`` instance, a ``Requirement`` instance, or a string specifying a requirement (i.e. project name, version, etc.). If the argument is a string or ``Requirement``, the specified distribution is located (and added to sys.path if not already present). An error will be raised if a matching distribution is not available. The `group` argument should be a string containing a dotted identifier, identifying an entry point group. If you are defining an entry point group, you should include some portion of your package's name in the group name so as to avoid collision with other packages' entry point groups. ``load_entry_point(dist, group, name)`` Load the named entry point from the specified distribution, or raise ``ImportError``. ``get_entry_info(dist, group, name)`` Return an ``EntryPoint`` object for the given `group` and `name` from the specified distribution. Returns ``None`` if the distribution has not advertised a matching entry point. ``get_entry_map(dist, group=None)`` Return the distribution's entry point map for `group`, or the full entry map for the distribution. This function always returns a dictionary, even if the distribution advertises no entry points. If `group` is given, the dictionary maps entry point names to the corresponding ``EntryPoint`` object. If `group` is None, the dictionary maps group names to dictionaries that then map entry point names to the corresponding ``EntryPoint`` instance in that group. ``iter_entry_points(group, name=None)`` Yield entry point objects from `group` matching `name`. If `name` is None, yields all entry points in `group` from all distributions in the working set on sys.path, otherwise only ones matching both `group` and `name` are yielded. Entry points are yielded from the active distributions in the order that the distributions appear on sys.path. (Within entry points for a particular distribution, however, there is no particular ordering.) (This API is actually a method of the global ``working_set`` object; see the section above on `Basic WorkingSet Methods`_ for more information.) Creating and Parsing -------------------- ``EntryPoint(name, module_name, attrs=(), extras=(), dist=None)`` Create an ``EntryPoint`` instance. `name` is the entry point name. The `module_name` is the (dotted) name of the module containing the advertised object. `attrs` is an optional tuple of names to look up from the module to obtain the advertised object. For example, an `attrs` of ``("foo","bar")`` and a `module_name` of ``"baz"`` would mean that the advertised object could be obtained by the following code:: import baz advertised_object = baz.foo.bar The `extras` are an optional tuple of "extra feature" names that the distribution needs in order to provide this entry point. When the entry point is loaded, these extra features are looked up in the `dist` argument to find out what other distributions may need to be activated on sys.path; see the ``load()`` method for more details. The `extras` argument is only meaningful if `dist` is specified. `dist` must be a ``Distribution`` instance. ``EntryPoint.parse(src, dist=None)`` (classmethod) Parse a single entry point from string `src` Entry point syntax follows the form:: name = some.module:some.attr [extra1,extra2] The entry name and module name are required, but the ``:attrs`` and ``[extras]`` parts are optional, as is the whitespace shown between some of the items. The `dist` argument is passed through to the ``EntryPoint()`` constructor, along with the other values parsed from `src`. ``EntryPoint.parse_group(group, lines, dist=None)`` (classmethod) Parse `lines` (a string or sequence of lines) to create a dictionary mapping entry point names to ``EntryPoint`` objects. ``ValueError`` is raised if entry point names are duplicated, if `group` is not a valid entry point group name, or if there are any syntax errors. (Note: the `group` parameter is used only for validation and to create more informative error messages.) If `dist` is provided, it will be used to set the ``dist`` attribute of the created ``EntryPoint`` objects. ``EntryPoint.parse_map(data, dist=None)`` (classmethod) Parse `data` into a dictionary mapping group names to dictionaries mapping entry point names to ``EntryPoint`` objects. If `data` is a dictionary, then the keys are used as group names and the values are passed to ``parse_group()`` as the `lines` argument. If `data` is a string or sequence of lines, it is first split into .ini-style sections (using the ``split_sections()`` utility function) and the section names are used as group names. In either case, the `dist` argument is passed through to ``parse_group()`` so that the entry points will be linked to the specified distribution. ``EntryPoint`` Objects ---------------------- For simple introspection, ``EntryPoint`` objects have attributes that correspond exactly to the constructor argument names: ``name``, ``module_name``, ``attrs``, ``extras``, and ``dist`` are all available. In addition, the following methods are provided: ``load(require=True, env=None, installer=None)`` Load the entry point, returning the advertised Python object, or raise ``ImportError`` if it cannot be obtained. If `require` is a true value, then ``require(env, installer)`` is called before attempting the import. ``require(env=None, installer=None)`` Ensure that any "extras" needed by the entry point are available on sys.path. ``UnknownExtra`` is raised if the ``EntryPoint`` has ``extras``, but no ``dist``, or if the named extras are not defined by the distribution. If `env` is supplied, it must be an ``Environment``, and it will be used to search for needed distributions if they are not already present on sys.path. If `installer` is supplied, it must be a callable taking a ``Requirement`` instance and returning a matching importable ``Distribution`` instance or None. ``__str__()`` The string form of an ``EntryPoint`` is a string that could be passed to ``EntryPoint.parse()`` to produce an equivalent ``EntryPoint``. ``Distribution`` Objects ======================== ``Distribution`` objects represent collections of Python code that may or may not be importable, and may or may not have metadata and resources associated with them. Their metadata may include information such as what other projects the distribution depends on, what entry points the distribution advertises, and so on. Getting or Creating Distributions --------------------------------- Most commonly, you'll obtain ``Distribution`` objects from a ``WorkingSet`` or an ``Environment``. (See the sections above on `WorkingSet Objects`_ and `Environment Objects`_, which are containers for active distributions and available distributions, respectively.) You can also obtain ``Distribution`` objects from one of these high-level APIs: ``find_distributions(path_item, only=False)`` Yield distributions accessible via `path_item`. If `only` is true, yield only distributions whose ``location`` is equal to `path_item`. In other words, if `only` is true, this yields any distributions that would be importable if `path_item` were on ``sys.path``. If `only` is false, this also yields distributions that are "in" or "under" `path_item`, but would not be importable unless their locations were also added to ``sys.path``. ``get_distribution(dist_spec)`` Return a ``Distribution`` object for a given ``Requirement`` or string. If `dist_spec` is already a ``Distribution`` instance, it is returned. If it is a ``Requirement`` object or a string that can be parsed into one, it is used to locate and activate a matching distribution, which is then returned. However, if you're creating specialized tools for working with distributions, or creating a new distribution format, you may also need to create ``Distribution`` objects directly, using one of the three constructors below. These constructors all take an optional `metadata` argument, which is used to access any resources or metadata associated with the distribution. `metadata` must be an object that implements the ``IResourceProvider`` interface, or None. If it is None, an ``EmptyProvider`` is used instead. ``Distribution`` objects implement both the `IResourceProvider`_ and `IMetadataProvider Methods`_ by delegating them to the `metadata` object. ``Distribution.from_location(location, basename, metadata=None, **kw)`` (classmethod) Create a distribution for `location`, which must be a string such as a URL, filename, or other string that might be used on ``sys.path``. `basename` is a string naming the distribution, like ``Foo-1.2-py2.4.egg``. If `basename` ends with ``.egg``, then the project's name, version, python version and platform are extracted from the filename and used to set those properties of the created distribution. Any additional keyword arguments are forwarded to the ``Distribution()`` constructor. ``Distribution.from_filename(filename, metadata=None**kw)`` (classmethod) Create a distribution by parsing a local filename. This is a shorter way of saying ``Distribution.from_location(normalize_path(filename), os.path.basename(filename), metadata)``. In other words, it creates a distribution whose location is the normalize form of the filename, parsing name and version information from the base portion of the filename. Any additional keyword arguments are forwarded to the ``Distribution()`` constructor. ``Distribution(location,metadata,project_name,version,py_version,platform,precedence)`` Create a distribution by setting its properties. All arguments are optional and default to None, except for `py_version` (which defaults to the current Python version) and `precedence` (which defaults to ``EGG_DIST``; for more details see ``precedence`` under `Distribution Attributes`_ below). Note that it's usually easier to use the ``from_filename()`` or ``from_location()`` constructors than to specify all these arguments individually. ``Distribution`` Attributes --------------------------- location A string indicating the distribution's location. For an importable distribution, this is the string that would be added to ``sys.path`` to make it actively importable. For non-importable distributions, this is simply a filename, URL, or other way of locating the distribution. project_name A string, naming the project that this distribution is for. Project names are defined by a project's setup script, and they are used to identify projects on PyPI. When a ``Distribution`` is constructed, the `project_name` argument is passed through the ``safe_name()`` utility function to filter out any unacceptable characters. key ``dist.key`` is short for ``dist.project_name.lower()``. It's used for case-insensitive comparison and indexing of distributions by project name. extras A list of strings, giving the names of extra features defined by the project's dependency list (the ``extras_require`` argument specified in the project's setup script). version A string denoting what release of the project this distribution contains. When a ``Distribution`` is constructed, the `version` argument is passed through the ``safe_version()`` utility function to filter out any unacceptable characters. If no `version` is specified at construction time, then attempting to access this attribute later will cause the ``Distribution`` to try to discover its version by reading its ``PKG-INFO`` metadata file. If ``PKG-INFO`` is unavailable or can't be parsed, ``ValueError`` is raised. parsed_version The ``parsed_version`` is an object representing a "parsed" form of the distribution's ``version``. ``dist.parsed_version`` is a shortcut for calling ``parse_version(dist.version)``. It is used to compare or sort distributions by version. (See the `Parsing Utilities`_ section below for more information on the ``parse_version()`` function.) Note that accessing ``parsed_version`` may result in a ``ValueError`` if the ``Distribution`` was constructed without a `version` and without `metadata` capable of supplying the missing version info. py_version The major/minor Python version the distribution supports, as a string. For example, "2.7" or "3.4". The default is the current version of Python. platform A string representing the platform the distribution is intended for, or ``None`` if the distribution is "pure Python" and therefore cross-platform. See `Platform Utilities`_ below for more information on platform strings. precedence A distribution's ``precedence`` is used to determine the relative order of two distributions that have the same ``project_name`` and ``parsed_version``. The default precedence is ``pkg_resources.EGG_DIST``, which is the highest (i.e. most preferred) precedence. The full list of predefined precedences, from most preferred to least preferred, is: ``EGG_DIST``, ``BINARY_DIST``, ``SOURCE_DIST``, ``CHECKOUT_DIST``, and ``DEVELOP_DIST``. Normally, precedences other than ``EGG_DIST`` are used only by the ``setuptools.package_index`` module, when sorting distributions found in a package index to determine their suitability for installation. "System" and "Development" eggs (i.e., ones that use the ``.egg-info`` format), however, are automatically given a precedence of ``DEVELOP_DIST``. ``Distribution`` Methods ------------------------ ``activate(path=None)`` Ensure distribution is importable on `path`. If `path` is None, ``sys.path`` is used instead. This ensures that the distribution's ``location`` is in the `path` list, and it also performs any necessary namespace package fixups or declarations. (That is, if the distribution contains namespace packages, this method ensures that they are declared, and that the distribution's contents for those namespace packages are merged with the contents provided by any other active distributions. See the section above on `Namespace Package Support`_ for more information.) ``pkg_resources`` adds a notification callback to the global ``working_set`` that ensures this method is called whenever a distribution is added to it. Therefore, you should not normally need to explicitly call this method. (Note that this means that namespace packages on ``sys.path`` are always imported as soon as ``pkg_resources`` is, which is another reason why namespace packages should not contain any code or import statements.) ``as_requirement()`` Return a ``Requirement`` instance that matches this distribution's project name and version. ``requires(extras=())`` List the ``Requirement`` objects that specify this distribution's dependencies. If `extras` is specified, it should be a sequence of names of "extras" defined by the distribution, and the list returned will then include any dependencies needed to support the named "extras". ``clone(**kw)`` Create a copy of the distribution. Any supplied keyword arguments override the corresponding argument to the ``Distribution()`` constructor, allowing you to change some of the copied distribution's attributes. ``egg_name()`` Return what this distribution's standard filename should be, not including the ".egg" extension. For example, a distribution for project "Foo" version 1.2 that runs on Python 2.3 for Windows would have an ``egg_name()`` of ``Foo-1.2-py2.3-win32``. Any dashes in the name or version are converted to underscores. (``Distribution.from_location()`` will convert them back when parsing a ".egg" file name.) ``__cmp__(other)``, ``__hash__()`` Distribution objects are hashed and compared on the basis of their parsed version and precedence, followed by their key (lowercase project name), location, Python version, and platform. The following methods are used to access ``EntryPoint`` objects advertised by the distribution. See the section above on `Entry Points`_ for more detailed information about these operations: ``get_entry_info(group, name)`` Return the ``EntryPoint`` object for `group` and `name`, or None if no such point is advertised by this distribution. ``get_entry_map(group=None)`` Return the entry point map for `group`. If `group` is None, return a dictionary mapping group names to entry point maps for all groups. (An entry point map is a dictionary of entry point names to ``EntryPoint`` objects.) ``load_entry_point(group, name)`` Short for ``get_entry_info(group, name).load()``. Returns the object advertised by the named entry point, or raises ``ImportError`` if the entry point isn't advertised by this distribution, or there is some other import problem. In addition to the above methods, ``Distribution`` objects also implement all of the `IResourceProvider`_ and `IMetadataProvider Methods`_ (which are documented in later sections): * ``has_metadata(name)`` * ``metadata_isdir(name)`` * ``metadata_listdir(name)`` * ``get_metadata(name)`` * ``get_metadata_lines(name)`` * ``run_script(script_name, namespace)`` * ``get_resource_filename(manager, resource_name)`` * ``get_resource_stream(manager, resource_name)`` * ``get_resource_string(manager, resource_name)`` * ``has_resource(resource_name)`` * ``resource_isdir(resource_name)`` * ``resource_listdir(resource_name)`` If the distribution was created with a `metadata` argument, these resource and metadata access methods are all delegated to that `metadata` provider. Otherwise, they are delegated to an ``EmptyProvider``, so that the distribution will appear to have no resources or metadata. This delegation approach is used so that supporting custom importers or new distribution formats can be done simply by creating an appropriate `IResourceProvider`_ implementation; see the section below on `Supporting Custom Importers`_ for more details. ``ResourceManager`` API ======================= The ``ResourceManager`` class provides uniform access to package resources, whether those resources exist as files and directories or are compressed in an archive of some kind. Normally, you do not need to create or explicitly manage ``ResourceManager`` instances, as the ``pkg_resources`` module creates a global instance for you, and makes most of its methods available as top-level names in the ``pkg_resources`` module namespace. So, for example, this code actually calls the ``resource_string()`` method of the global ``ResourceManager``:: import pkg_resources my_data = pkg_resources.resource_string(__name__, "foo.dat") Thus, you can use the APIs below without needing an explicit ``ResourceManager`` instance; just import and use them as needed. Basic Resource Access --------------------- In the following methods, the `package_or_requirement` argument may be either a Python package/module name (e.g. ``foo.bar``) or a ``Requirement`` instance. If it is a package or module name, the named module or package must be importable (i.e., be in a distribution or directory on ``sys.path``), and the `resource_name` argument is interpreted relative to the named package. (Note that if a module name is used, then the resource name is relative to the package immediately containing the named module. Also, you should not use use a namespace package name, because a namespace package can be spread across multiple distributions, and is therefore ambiguous as to which distribution should be searched for the resource.) If it is a ``Requirement``, then the requirement is automatically resolved (searching the current ``Environment`` if necessary) and a matching distribution is added to the ``WorkingSet`` and ``sys.path`` if one was not already present. (Unless the ``Requirement`` can't be satisfied, in which case an exception is raised.) The `resource_name` argument is then interpreted relative to the root of the identified distribution; i.e. its first path segment will be treated as a peer of the top-level modules or packages in the distribution. Note that resource names must be ``/``-separated paths and cannot be absolute (i.e. no leading ``/``) or contain relative names like ``".."``. Do *not* use ``os.path`` routines to manipulate resource paths, as they are *not* filesystem paths. ``resource_exists(package_or_requirement, resource_name)`` Does the named resource exist? Return ``True`` or ``False`` accordingly. ``resource_stream(package_or_requirement, resource_name)`` Return a readable file-like object for the specified resource; it may be an actual file, a ``StringIO``, or some similar object. The stream is in "binary mode", in the sense that whatever bytes are in the resource will be read as-is. ``resource_string(package_or_requirement, resource_name)`` Return the specified resource as a string. The resource is read in binary fashion, such that the returned string contains exactly the bytes that are stored in the resource. ``resource_isdir(package_or_requirement, resource_name)`` Is the named resource a directory? Return ``True`` or ``False`` accordingly. ``resource_listdir(package_or_requirement, resource_name)`` List the contents of the named resource directory, just like ``os.listdir`` except that it works even if the resource is in a zipfile. Note that only ``resource_exists()`` and ``resource_isdir()`` are insensitive as to the resource type. You cannot use ``resource_listdir()`` on a file resource, and you can't use ``resource_string()`` or ``resource_stream()`` on directory resources. Using an inappropriate method for the resource type may result in an exception or undefined behavior, depending on the platform and distribution format involved. Resource Extraction ------------------- ``resource_filename(package_or_requirement, resource_name)`` Sometimes, it is not sufficient to access a resource in string or stream form, and a true filesystem filename is needed. In such cases, you can use this method (or module-level function) to obtain a filename for a resource. If the resource is in an archive distribution (such as a zipped egg), it will be extracted to a cache directory, and the filename within the cache will be returned. If the named resource is a directory, then all resources within that directory (including subdirectories) are also extracted. If the named resource is a C extension or "eager resource" (see the ``setuptools`` documentation for details), then all C extensions and eager resources are extracted at the same time. Archived resources are extracted to a cache location that can be managed by the following two methods: ``set_extraction_path(path)`` Set the base path where resources will be extracted to, if needed. If you do not call this routine before any extractions take place, the path defaults to the return value of ``get_default_cache()``. (Which is based on the ``PYTHON_EGG_CACHE`` environment variable, with various platform-specific fallbacks. See that routine's documentation for more details.) Resources are extracted to subdirectories of this path based upon information given by the resource provider. You may set this to a temporary directory, but then you must call ``cleanup_resources()`` to delete the extracted files when done. There is no guarantee that ``cleanup_resources()`` will be able to remove all extracted files. (On Windows, for example, you can't unlink .pyd or .dll files that are still in use.) Note that you may not change the extraction path for a given resource manager once resources have been extracted, unless you first call ``cleanup_resources()``. ``cleanup_resources(force=False)`` Delete all extracted resource files and directories, returning a list of the file and directory names that could not be successfully removed. This function does not have any concurrency protection, so it should generally only be called when the extraction path is a temporary directory exclusive to a single process. This method is not automatically called; you must call it explicitly or register it as an ``atexit`` function if you wish to ensure cleanup of a temporary directory used for extractions. "Provider" Interface -------------------- If you are implementing an ``IResourceProvider`` and/or ``IMetadataProvider`` for a new distribution archive format, you may need to use the following ``IResourceManager`` methods to co-ordinate extraction of resources to the filesystem. If you're not implementing an archive format, however, you have no need to use these methods. Unlike the other methods listed above, they are *not* available as top-level functions tied to the global ``ResourceManager``; you must therefore have an explicit ``ResourceManager`` instance to use them. ``get_cache_path(archive_name, names=())`` Return absolute location in cache for `archive_name` and `names` The parent directory of the resulting path will be created if it does not already exist. `archive_name` should be the base filename of the enclosing egg (which may not be the name of the enclosing zipfile!), including its ".egg" extension. `names`, if provided, should be a sequence of path name parts "under" the egg's extraction location. This method should only be called by resource providers that need to obtain an extraction location, and only for names they intend to extract, as it tracks the generated names for possible cleanup later. ``extraction_error()`` Raise an ``ExtractionError`` describing the active exception as interfering with the extraction process. You should call this if you encounter any OS errors extracting the file to the cache path; it will format the operating system exception for you, and add other information to the ``ExtractionError`` instance that may be needed by programs that want to wrap or handle extraction errors themselves. ``postprocess(tempname, filename)`` Perform any platform-specific postprocessing of `tempname`. Resource providers should call this method ONLY after successfully extracting a compressed resource. They must NOT call it on resources that are already in the filesystem. `tempname` is the current (temporary) name of the file, and `filename` is the name it will be renamed to by the caller after this routine returns. Metadata API ============ The metadata API is used to access metadata resources bundled in a pluggable distribution. Metadata resources are virtual files or directories containing information about the distribution, such as might be used by an extensible application or framework to connect "plugins". Like other kinds of resources, metadata resource names are ``/``-separated and should not contain ``..`` or begin with a ``/``. You should not use ``os.path`` routines to manipulate resource paths. The metadata API is provided by objects implementing the ``IMetadataProvider`` or ``IResourceProvider`` interfaces. ``Distribution`` objects implement this interface, as do objects returned by the ``get_provider()`` function: ``get_provider(package_or_requirement)`` If a package name is supplied, return an ``IResourceProvider`` for the package. If a ``Requirement`` is supplied, resolve it by returning a ``Distribution`` from the current working set (searching the current ``Environment`` if necessary and adding the newly found ``Distribution`` to the working set). If the named package can't be imported, or the ``Requirement`` can't be satisfied, an exception is raised. NOTE: if you use a package name rather than a ``Requirement``, the object you get back may not be a pluggable distribution, depending on the method by which the package was installed. In particular, "development" packages and "single-version externally-managed" packages do not have any way to map from a package name to the corresponding project's metadata. Do not write code that passes a package name to ``get_provider()`` and then tries to retrieve project metadata from the returned object. It may appear to work when the named package is in an ``.egg`` file or directory, but it will fail in other installation scenarios. If you want project metadata, you need to ask for a *project*, not a package. ``IMetadataProvider`` Methods ----------------------------- The methods provided by objects (such as ``Distribution`` instances) that implement the ``IMetadataProvider`` or ``IResourceProvider`` interfaces are: ``has_metadata(name)`` Does the named metadata resource exist? ``metadata_isdir(name)`` Is the named metadata resource a directory? ``metadata_listdir(name)`` List of metadata names in the directory (like ``os.listdir()``) ``get_metadata(name)`` Return the named metadata resource as a string. The data is read in binary mode; i.e., the exact bytes of the resource file are returned. ``get_metadata_lines(name)`` Yield named metadata resource as list of non-blank non-comment lines. This is short for calling ``yield_lines(provider.get_metadata(name))``. See the section on `yield_lines()`_ below for more information on the syntax it recognizes. ``run_script(script_name, namespace)`` Execute the named script in the supplied namespace dictionary. Raises ``ResolutionError`` if there is no script by that name in the ``scripts`` metadata directory. `namespace` should be a Python dictionary, usually a module dictionary if the script is being run as a module. Exceptions ========== ``pkg_resources`` provides a simple exception hierarchy for problems that may occur when processing requests to locate and activate packages:: ResolutionError DistributionNotFound VersionConflict UnknownExtra ExtractionError ``ResolutionError`` This class is used as a base class for the other three exceptions, so that you can catch all of them with a single "except" clause. It is also raised directly for miscellaneous requirement-resolution problems like trying to run a script that doesn't exist in the distribution it was requested from. ``DistributionNotFound`` A distribution needed to fulfill a requirement could not be found. ``VersionConflict`` The requested version of a project conflicts with an already-activated version of the same project. ``UnknownExtra`` One of the "extras" requested was not recognized by the distribution it was requested from. ``ExtractionError`` A problem occurred extracting a resource to the Python Egg cache. The following attributes are available on instances of this exception: manager The resource manager that raised this exception cache_path The base directory for resource extraction original_error The exception instance that caused extraction to fail Supporting Custom Importers =========================== By default, ``pkg_resources`` supports normal filesystem imports, and ``zipimport`` importers. If you wish to use the ``pkg_resources`` features with other (PEP 302-compatible) importers or module loaders, you may need to register various handlers and support functions using these APIs: ``register_finder(importer_type, distribution_finder)`` Register `distribution_finder` to find distributions in ``sys.path`` items. `importer_type` is the type or class of a PEP 302 "Importer" (``sys.path`` item handler), and `distribution_finder` is a callable that, when passed a path item, the importer instance, and an `only` flag, yields ``Distribution`` instances found under that path item. (The `only` flag, if true, means the finder should yield only ``Distribution`` objects whose ``location`` is equal to the path item provided.) See the source of the ``pkg_resources.find_on_path`` function for an example finder function. ``register_loader_type(loader_type, provider_factory)`` Register `provider_factory` to make ``IResourceProvider`` objects for `loader_type`. `loader_type` is the type or class of a PEP 302 ``module.__loader__``, and `provider_factory` is a function that, when passed a module object, returns an `IResourceProvider`_ for that module, allowing it to be used with the `ResourceManager API`_. ``register_namespace_handler(importer_type, namespace_handler)`` Register `namespace_handler` to declare namespace packages for the given `importer_type`. `importer_type` is the type or class of a PEP 302 "importer" (sys.path item handler), and `namespace_handler` is a callable with a signature like this:: def namespace_handler(importer, path_entry, moduleName, module): # return a path_entry to use for child packages Namespace handlers are only called if the relevant importer object has already agreed that it can handle the relevant path item. The handler should only return a subpath if the module ``__path__`` does not already contain an equivalent subpath. Otherwise, it should return None. For an example namespace handler, see the source of the ``pkg_resources.file_ns_handler`` function, which is used for both zipfile importing and regular importing. IResourceProvider ----------------- ``IResourceProvider`` is an abstract class that documents what methods are required of objects returned by a `provider_factory` registered with ``register_loader_type()``. ``IResourceProvider`` is a subclass of ``IMetadataProvider``, so objects that implement this interface must also implement all of the `IMetadataProvider Methods`_ as well as the methods shown here. The `manager` argument to the methods below must be an object that supports the full `ResourceManager API`_ documented above. ``get_resource_filename(manager, resource_name)`` Return a true filesystem path for `resource_name`, coordinating the extraction with `manager`, if the resource must be unpacked to the filesystem. ``get_resource_stream(manager, resource_name)`` Return a readable file-like object for `resource_name`. ``get_resource_string(manager, resource_name)`` Return a string containing the contents of `resource_name`. ``has_resource(resource_name)`` Does the package contain the named resource? ``resource_isdir(resource_name)`` Is the named resource a directory? Return a false value if the resource does not exist or is not a directory. ``resource_listdir(resource_name)`` Return a list of the contents of the resource directory, ala ``os.listdir()``. Requesting the contents of a non-existent directory may raise an exception. Note, by the way, that your provider classes need not (and should not) subclass ``IResourceProvider`` or ``IMetadataProvider``! These classes exist solely for documentation purposes and do not provide any useful implementation code. You may instead wish to subclass one of the `built-in resource providers`_. Built-in Resource Providers --------------------------- ``pkg_resources`` includes several provider classes that are automatically used where appropriate. Their inheritance tree looks like this:: NullProvider EggProvider DefaultProvider PathMetadata ZipProvider EggMetadata EmptyProvider FileMetadata ``NullProvider`` This provider class is just an abstract base that provides for common provider behaviors (such as running scripts), given a definition for just a few abstract methods. ``EggProvider`` This provider class adds in some egg-specific features that are common to zipped and unzipped eggs. ``DefaultProvider`` This provider class is used for unpacked eggs and "plain old Python" filesystem modules. ``ZipProvider`` This provider class is used for all zipped modules, whether they are eggs or not. ``EmptyProvider`` This provider class always returns answers consistent with a provider that has no metadata or resources. ``Distribution`` objects created without a ``metadata`` argument use an instance of this provider class instead. Since all ``EmptyProvider`` instances are equivalent, there is no need to have more than one instance. ``pkg_resources`` therefore creates a global instance of this class under the name ``empty_provider``, and you may use it if you have need of an ``EmptyProvider`` instance. ``PathMetadata(path, egg_info)`` Create an ``IResourceProvider`` for a filesystem-based distribution, where `path` is the filesystem location of the importable modules, and `egg_info` is the filesystem location of the distribution's metadata directory. `egg_info` should usually be the ``EGG-INFO`` subdirectory of `path` for an "unpacked egg", and a ``ProjectName.egg-info`` subdirectory of `path` for a "development egg". However, other uses are possible for custom purposes. ``EggMetadata(zipimporter)`` Create an ``IResourceProvider`` for a zipfile-based distribution. The `zipimporter` should be a ``zipimport.zipimporter`` instance, and may represent a "basket" (a zipfile containing multiple ".egg" subdirectories) a specific egg *within* a basket, or a zipfile egg (where the zipfile itself is a ".egg"). It can also be a combination, such as a zipfile egg that also contains other eggs. ``FileMetadata(path_to_pkg_info)`` Create an ``IResourceProvider`` that provides exactly one metadata resource: ``PKG-INFO``. The supplied path should be a distutils PKG-INFO file. This is basically the same as an ``EmptyProvider``, except that requests for ``PKG-INFO`` will be answered using the contents of the designated file. (This provider is used to wrap ``.egg-info`` files installed by vendor-supplied system packages.) Utility Functions ================= In addition to its high-level APIs, ``pkg_resources`` also includes several generally-useful utility routines. These routines are used to implement the high-level APIs, but can also be quite useful by themselves. Parsing Utilities ----------------- ``parse_version(version)`` Parsed a project's version string as defined by PEP 440. The returned value will be an object that represents the version. These objects may be compared to each other and sorted. The sorting algorithm is as defined by PEP 440 with the addition that any version which is not a valid PEP 440 version will be considered less than any valid PEP 440 version and the invalid versions will continue sorting using the original algorithm. .. _yield_lines(): ``yield_lines(strs)`` Yield non-empty/non-comment lines from a string/unicode or a possibly- nested sequence thereof. If `strs` is an instance of ``basestring``, it is split into lines, and each non-blank, non-comment line is yielded after stripping leading and trailing whitespace. (Lines whose first non-blank character is ``#`` are considered comment lines.) If `strs` is not an instance of ``basestring``, it is iterated over, and each item is passed recursively to ``yield_lines()``, so that an arbitrarily nested sequence of strings, or sequences of sequences of strings can be flattened out to the lines contained therein. So for example, passing a file object or a list of strings to ``yield_lines`` will both work. (Note that between each string in a sequence of strings there is assumed to be an implicit line break, so lines cannot bridge two strings in a sequence.) This routine is used extensively by ``pkg_resources`` to parse metadata and file formats of various kinds, and most other ``pkg_resources`` parsing functions that yield multiple values will use it to break up their input. However, this routine is idempotent, so calling ``yield_lines()`` on the output of another call to ``yield_lines()`` is completely harmless. ``split_sections(strs)`` Split a string (or possibly-nested iterable thereof), yielding ``(section, content)`` pairs found using an ``.ini``-like syntax. Each ``section`` is a whitespace-stripped version of the section name ("``[section]``") and each ``content`` is a list of stripped lines excluding blank lines and comment-only lines. If there are any non-blank, non-comment lines before the first section header, they're yielded in a first ``section`` of ``None``. This routine uses ``yield_lines()`` as its front end, so you can pass in anything that ``yield_lines()`` accepts, such as an open text file, string, or sequence of strings. ``ValueError`` is raised if a malformed section header is found (i.e. a line starting with ``[`` but not ending with ``]``). Note that this simplistic parser assumes that any line whose first nonblank character is ``[`` is a section heading, so it can't support .ini format variations that allow ``[`` as the first nonblank character on other lines. ``safe_name(name)`` Return a "safe" form of a project's name, suitable for use in a ``Requirement`` string, as a distribution name, or a PyPI project name. All non-alphanumeric runs are condensed to single "-" characters, such that a name like "The $$$ Tree" becomes "The-Tree". Note that if you are generating a filename from this value you should combine it with a call to ``to_filename()`` so all dashes ("-") are replaced by underscores ("_"). See ``to_filename()``. ``safe_version(version)`` This will return the normalized form of any PEP 440 version, if the version string is not PEP 440 compatible than it is similar to ``safe_name()`` except that spaces in the input become dots, and dots are allowed to exist in the output. As with ``safe_name()``, if you are generating a filename from this you should replace any "-" characters in the output with underscores. ``safe_extra(extra)`` Return a "safe" form of an extra's name, suitable for use in a requirement string or a setup script's ``extras_require`` keyword. This routine is similar to ``safe_name()`` except that non-alphanumeric runs are replaced by a single underbar (``_``), and the result is lowercased. ``to_filename(name_or_version)`` Escape a name or version string so it can be used in a dash-separated filename (or ``#egg=name-version`` tag) without ambiguity. You should only pass in values that were returned by ``safe_name()`` or ``safe_version()``. Platform Utilities ------------------ ``get_build_platform()`` Return this platform's identifier string. For Windows, the return value is ``"win32"``, and for Mac OS X it is a string of the form ``"macosx-10.4-ppc"``. All other platforms return the same uname-based string that the ``distutils.util.get_platform()`` function returns. This string is the minimum platform version required by distributions built on the local machine. (Backward compatibility note: setuptools versions prior to 0.6b1 called this function ``get_platform()``, and the function is still available under that name for backward compatibility reasons.) ``get_supported_platform()`` (New in 0.6b1) This is the similar to ``get_build_platform()``, but is the maximum platform version that the local machine supports. You will usually want to use this value as the ``provided`` argument to the ``compatible_platforms()`` function. ``compatible_platforms(provided, required)`` Return true if a distribution built on the `provided` platform may be used on the `required` platform. If either platform value is ``None``, it is considered a wildcard, and the platforms are therefore compatible. Likewise, if the platform strings are equal, they're also considered compatible, and ``True`` is returned. Currently, the only non-equal platform strings that are considered compatible are Mac OS X platform strings with the same hardware type (e.g. ``ppc``) and major version (e.g. ``10``) with the `provided` platform's minor version being less than or equal to the `required` platform's minor version. ``get_default_cache()`` Determine the default cache location for extracting resources from zipped eggs. This routine returns the ``PYTHON_EGG_CACHE`` environment variable, if set. Otherwise, on Windows, it returns a "Python-Eggs" subdirectory of the user's "Application Data" directory. On all other systems, it returns ``os.path.expanduser("~/.python-eggs")`` if ``PYTHON_EGG_CACHE`` is not set. PEP 302 Utilities ----------------- ``get_importer(path_item)`` Retrieve a PEP 302 "importer" for the given path item (which need not actually be on ``sys.path``). This routine simulates the PEP 302 protocol for obtaining an "importer" object. It first checks for an importer for the path item in ``sys.path_importer_cache``, and if not found it calls each of the ``sys.path_hooks`` and caches the result if a good importer is found. If no importer is found, this routine returns an ``ImpWrapper`` instance that wraps the builtin import machinery as a PEP 302-compliant "importer" object. This ``ImpWrapper`` is *not* cached; instead a new instance is returned each time. (Note: When run under Python 2.5, this function is simply an alias for ``pkgutil.get_importer()``, and instead of ``pkg_resources.ImpWrapper`` instances, it may return ``pkgutil.ImpImporter`` instances.) File/Path Utilities ------------------- ``ensure_directory(path)`` Ensure that the parent directory (``os.path.dirname``) of `path` actually exists, using ``os.makedirs()`` if necessary. ``normalize_path(path)`` Return a "normalized" version of `path`, such that two paths represent the same filesystem location if they have equal ``normalized_path()`` values. Specifically, this is a shortcut for calling ``os.path.realpath`` and ``os.path.normcase`` on `path`. Unfortunately, on certain platforms (notably Cygwin and Mac OS X) the ``normcase`` function does not accurately reflect the platform's case-sensitivity, so there is always the possibility of two apparently-different paths being equal on such platforms. History ------- 0.6c9 * Fix ``resource_listdir('')`` always returning an empty list for zipped eggs. 0.6c7 * Fix package precedence problem where single-version eggs installed in ``site-packages`` would take precedence over ``.egg`` files (or directories) installed in ``site-packages``. 0.6c6 * Fix extracted C extensions not having executable permissions under Cygwin. * Allow ``.egg-link`` files to contain relative paths. * Fix cache dir defaults on Windows when multiple environment vars are needed to construct a path. 0.6c4 * Fix "dev" versions being considered newer than release candidates. 0.6c3 * Python 2.5 compatibility fixes. 0.6c2 * Fix a problem with eggs specified directly on ``PYTHONPATH`` on case-insensitive filesystems possibly not showing up in the default working set, due to differing normalizations of ``sys.path`` entries. 0.6b3 * Fixed a duplicate path insertion problem on case-insensitive filesystems. 0.6b1 * Split ``get_platform()`` into ``get_supported_platform()`` and ``get_build_platform()`` to work around a Mac versioning problem that caused the behavior of ``compatible_platforms()`` to be platform specific. * Fix entry point parsing when a standalone module name has whitespace between it and the extras. 0.6a11 * Added ``ExtractionError`` and ``ResourceManager.extraction_error()`` so that cache permission problems get a more user-friendly explanation of the problem, and so that programs can catch and handle extraction errors if they need to. 0.6a10 * Added the ``extras`` attribute to ``Distribution``, the ``find_plugins()`` method to ``WorkingSet``, and the ``__add__()`` and ``__iadd__()`` methods to ``Environment``. * ``safe_name()`` now allows dots in project names. * There is a new ``to_filename()`` function that escapes project names and versions for safe use in constructing egg filenames from a Distribution object's metadata. * Added ``Distribution.clone()`` method, and keyword argument support to other ``Distribution`` constructors. * Added the ``DEVELOP_DIST`` precedence, and automatically assign it to eggs using ``.egg-info`` format. 0.6a9 * Don't raise an error when an invalid (unfinished) distribution is found unless absolutely necessary. Warn about skipping invalid/unfinished eggs when building an Environment. * Added support for ``.egg-info`` files or directories with version/platform information embedded in the filename, so that system packagers have the option of including ``PKG-INFO`` files to indicate the presence of a system-installed egg, without needing to use ``.egg`` directories, zipfiles, or ``.pth`` manipulation. * Changed ``parse_version()`` to remove dashes before pre-release tags, so that ``0.2-rc1`` is considered an *older* version than ``0.2``, and is equal to ``0.2rc1``. The idea that a dash *always* meant a post-release version was highly non-intuitive to setuptools users and Python developers, who seem to want to use ``-rc`` version numbers a lot. 0.6a8 * Fixed a problem with ``WorkingSet.resolve()`` that prevented version conflicts from being detected at runtime. * Improved runtime conflict warning message to identify a line in the user's program, rather than flagging the ``warn()`` call in ``pkg_resources``. * Avoid giving runtime conflict warnings for namespace packages, even if they were declared by a different package than the one currently being activated. * Fix path insertion algorithm for case-insensitive filesystems. * Fixed a problem with nested namespace packages (e.g. ``peak.util``) not being set as an attribute of their parent package. 0.6a6 * Activated distributions are now inserted in ``sys.path`` (and the working set) just before the directory that contains them, instead of at the end. This allows e.g. eggs in ``site-packages`` to override unmanaged modules in the same location, and allows eggs found earlier on ``sys.path`` to override ones found later. * When a distribution is activated, it now checks whether any contained non-namespace modules have already been imported and issues a warning if a conflicting module has already been imported. * Changed dependency processing so that it's breadth-first, allowing a depender's preferences to override those of a dependee, to prevent conflicts when a lower version is acceptable to the dependee, but not the depender. * Fixed a problem extracting zipped files on Windows, when the egg in question has had changed contents but still has the same version number. 0.6a4 * Fix a bug in ``WorkingSet.resolve()`` that was introduced in 0.6a3. 0.6a3 * Added ``safe_extra()`` parsing utility routine, and use it for Requirement, EntryPoint, and Distribution objects' extras handling. 0.6a1 * Enhanced performance of ``require()`` and related operations when all requirements are already in the working set, and enhanced performance of directory scanning for distributions. * Fixed some problems using ``pkg_resources`` w/PEP 302 loaders other than ``zipimport``, and the previously-broken "eager resource" support. * Fixed ``pkg_resources.resource_exists()`` not working correctly, along with some other resource API bugs. * Many API changes and enhancements: * Added ``EntryPoint``, ``get_entry_map``, ``load_entry_point``, and ``get_entry_info`` APIs for dynamic plugin discovery. * ``list_resources`` is now ``resource_listdir`` (and it actually works) * Resource API functions like ``resource_string()`` that accepted a package name and resource name, will now also accept a ``Requirement`` object in place of the package name (to allow access to non-package data files in an egg). * ``get_provider()`` will now accept a ``Requirement`` instance or a module name. If it is given a ``Requirement``, it will return a corresponding ``Distribution`` (by calling ``require()`` if a suitable distribution isn't already in the working set), rather than returning a metadata and resource provider for a specific module. (The difference is in how resource paths are interpreted; supplying a module name means resources path will be module-relative, rather than relative to the distribution's root.) * ``Distribution`` objects now implement the ``IResourceProvider`` and ``IMetadataProvider`` interfaces, so you don't need to reference the (no longer available) ``metadata`` attribute to get at these interfaces. * ``Distribution`` and ``Requirement`` both have a ``project_name`` attribute for the project name they refer to. (Previously these were ``name`` and ``distname`` attributes.) * The ``path`` attribute of ``Distribution`` objects is now ``location``, because it isn't necessarily a filesystem path (and hasn't been for some time now). The ``location`` of ``Distribution`` objects in the filesystem should always be normalized using ``pkg_resources.normalize_path()``; all of the setuptools and EasyInstall code that generates distributions from the filesystem (including ``Distribution.from_filename()``) ensure this invariant, but if you use a more generic API like ``Distribution()`` or ``Distribution.from_location()`` you should take care that you don't create a distribution with an un-normalized filesystem path. * ``Distribution`` objects now have an ``as_requirement()`` method that returns a ``Requirement`` for the distribution's project name and version. * Distribution objects no longer have an ``installed_on()`` method, and the ``install_on()`` method is now ``activate()`` (but may go away altogether soon). The ``depends()`` method has also been renamed to ``requires()``, and ``InvalidOption`` is now ``UnknownExtra``. * ``find_distributions()`` now takes an additional argument called ``only``, that tells it to only yield distributions whose location is the passed-in path. (It defaults to False, so that the default behavior is unchanged.) * ``AvailableDistributions`` is now called ``Environment``, and the ``get()``, ``__len__()``, and ``__contains__()`` methods were removed, because they weren't particularly useful. ``__getitem__()`` no longer raises ``KeyError``; it just returns an empty list if there are no distributions for the named project. * The ``resolve()`` method of ``Environment`` is now a method of ``WorkingSet`` instead, and the ``best_match()`` method now uses a working set instead of a path list as its second argument. * There is a new ``pkg_resources.add_activation_listener()`` API that lets you register a callback for notifications about distributions added to ``sys.path`` (including the distributions already on it). This is basically a hook for extensible applications and frameworks to be able to search for plugin metadata in distributions added at runtime. 0.5a13 * Fixed a bug in resource extraction from nested packages in a zipped egg. 0.5a12 * Updated extraction/cache mechanism for zipped resources to avoid inter- process and inter-thread races during extraction. The default cache location can now be set via the ``PYTHON_EGGS_CACHE`` environment variable, and the default Windows cache is now a ``Python-Eggs`` subdirectory of the current user's "Application Data" directory, if the ``PYTHON_EGGS_CACHE`` variable isn't set. 0.5a10 * Fix a problem with ``pkg_resources`` being confused by non-existent eggs on ``sys.path`` (e.g. if a user deletes an egg without removing it from the ``easy-install.pth`` file). * Fix a problem with "basket" support in ``pkg_resources``, where egg-finding never actually went inside ``.egg`` files. * Made ``pkg_resources`` import the module you request resources from, if it's not already imported. 0.5a4 * ``pkg_resources.AvailableDistributions.resolve()`` and related methods now accept an ``installer`` argument: a callable taking one argument, a ``Requirement`` instance. The callable must return a ``Distribution`` object, or ``None`` if no distribution is found. This feature is used by EasyInstall to resolve dependencies by recursively invoking itself. 0.4a4 * Fix problems with ``resource_listdir()``, ``resource_isdir()`` and resource directory extraction for zipped eggs. 0.4a3 * Fixed scripts not being able to see a ``__file__`` variable in ``__main__`` * Fixed a problem with ``resource_isdir()`` implementation that was introduced in 0.4a2. 0.4a1 * Fixed a bug in requirements processing for exact versions (i.e. ``==`` and ``!=``) when only one condition was included. * Added ``safe_name()`` and ``safe_version()`` APIs to clean up handling of arbitrary distribution names and versions found on PyPI. 0.3a4 * ``pkg_resources`` now supports resource directories, not just the resources in them. In particular, there are ``resource_listdir()`` and ``resource_isdir()`` APIs. * ``pkg_resources`` now supports "egg baskets" -- .egg zipfiles which contain multiple distributions in subdirectories whose names end with ``.egg``. Having such a "basket" in a directory on ``sys.path`` is equivalent to having the individual eggs in that directory, but the contained eggs can be individually added (or not) to ``sys.path``. Currently, however, there is no automated way to create baskets. * Namespace package manipulation is now protected by the Python import lock. 0.3a1 * Initial release. setuptools-20.7.0/docs/python3.txt0000664000175000017500000000760212702524020017761 0ustar travistravis00000000000000===================================================== Supporting both Python 2 and Python 3 with Setuptools ===================================================== Starting with Distribute version 0.6.2 and Setuptools 0.7, the Setuptools project supported Python 3. Installing and using setuptools for Python 3 code works exactly the same as for Python 2 code. Setuptools provides a facility to invoke 2to3 on the code as a part of the build process, by setting the keyword parameter ``use_2to3`` to True, but the Setuptools strongly recommends instead developing a unified codebase using `six `_, `future `_, or another compatibility library. Using 2to3 ========== Setuptools attempts to make the porting process easier by automatically running 2to3 as a part of running tests. To do so, you need to configure the setup.py so that you can run the unit tests with ``python setup.py test``. See :ref:`test` for more information on this. Once you have the tests running under Python 2, you can add the use_2to3 keyword parameters to setup(), and start running the tests under Python 3. The test command will now first run the build command during which the code will be converted with 2to3, and the tests will then be run from the build directory, as opposed from the source directory as is normally done. Setuptools will convert all Python files, and also all doctests in Python files. However, if you have doctests located in separate text files, these will not automatically be converted. By adding them to the ``convert_2to3_doctests`` keyword parameter Setuptools will convert them as well. By default, the conversion uses all fixers in the ``lib2to3.fixers`` package. To use additional fixers, the parameter ``use_2to3_fixers`` can be set to a list of names of packages containing fixers. To exclude fixers, the parameter ``use_2to3_exclude_fixers`` can be set to fixer names to be skipped. An example setup.py might look something like this:: from setuptools import setup setup( name='your.module', version='1.0', description='This is your awesome module', author='You', author_email='your@email', package_dir={'': 'src'}, packages=['your', 'you.module'], test_suite='your.module.tests', use_2to3=True, convert_2to3_doctests=['src/your/module/README.txt'], use_2to3_fixers=['your.fixers'], use_2to3_exclude_fixers=['lib2to3.fixes.fix_import'], ) Differential conversion ----------------------- Note that a file will only be copied and converted during the build process if the source file has been changed. If you add a file to the doctests that should be converted, it will not be converted the next time you run the tests, since it hasn't been modified. You need to remove it from the build directory. Also if you run the build, install or test commands before adding the use_2to3 parameter, you will have to remove the build directory before you run the test command, as the files otherwise will seem updated, and no conversion will happen. In general, if code doesn't seem to be converted, deleting the build directory and trying again is a good safeguard against the build directory getting "out of sync" with the source directory. Distributing Python 3 modules ============================= You can distribute your modules with Python 3 support in different ways. A normal source distribution will work, but can be slow in installing, as the 2to3 process will be run during the install. But you can also distribute the module in binary format, such as a binary egg. That egg will contain the already converted code, and hence no 2to3 conversion is needed during install. Advanced features ================= If you don't want to run the 2to3 conversion on the doctests in Python files, you can turn that off by setting ``setuptools.use_2to3_on_doctests = False``. setuptools-20.7.0/docs/releases.txt0000664000175000017500000000466112702524020020162 0ustar travistravis00000000000000=============== Release Process =============== In order to allow for rapid, predictable releases, Setuptools uses a mechanical technique for releases, enacted by Travis following a successful build of a tagged release per `PyPI deployment `_. To cut a release, install and run ``bumpversion {part}`` where ``part`` is major, minor, or patch based on the scope of the changes in the release. Then, push the commits to the master branch. If tests pass, the release will be uploaded to PyPI. Bootstrap Bookmark ------------------ Setuptools has a bootstrap script (ez_setup.py) which is hosted in the repository and must be updated with each release (to bump the default version). The "published" version of the script is the one indicated by the ``bootstrap`` branch. Therefore, the latest bootstrap script can be retrieved by checking out the repository at that bookmark. It's also possible to get the bootstrap script for any particular release by grabbing the script from that tagged release. The officially-published location of the bootstrap script is hosted on Python infrastructure (#python-infra on freenode) at https://bootstrap.pypa.io and is updated every fifteen minutes from the bootstrap script. Sometimes, especially when the bootstrap script is rolled back, this process doesn't work as expected and requires manual intervention. Release Frequency ----------------- Some have asked why Setuptools is released so frequently. Because Setuptools uses a mechanical release process, it's very easy to make releases whenever the code is stable (tests are passing). As a result, the philosophy is to release early and often. While some find the frequent releases somewhat surprising, they only empower the user. Although releases are made frequently, users can choose the frequency at which they use those releases. If instead Setuptools contributions were only released in batches, the user would be constrained to only use Setuptools when those official releases were made. With frequent releases, the user can govern exactly how often he wishes to update. Frequent releases also then obviate the need for dev or beta releases in most cases. Because releases are made early and often, bugs are discovered and corrected quickly, in many cases before other users have yet to encounter them. Release Managers ---------------- Additionally, anyone with push access to the master branch has access to cut releases. setuptools-20.7.0/docs/roadmap.txt0000664000175000017500000000024712702524020017776 0ustar travistravis00000000000000======= Roadmap ======= Setuptools is primarily in maintenance mode. The project attempts to address user issues, concerns, and feature requests in a timely fashion. setuptools-20.7.0/docs/setuptools.txt0000664000175000017500000036534312702524020020607 0ustar travistravis00000000000000================================================== Building and Distributing Packages with Setuptools ================================================== ``Setuptools`` is a collection of enhancements to the Python ``distutils`` (for Python 2.6 and up) that allow developers to more easily build and distribute Python packages, especially ones that have dependencies on other packages. Packages built and distributed using ``setuptools`` look to the user like ordinary Python packages based on the ``distutils``. Your users don't need to install or even know about setuptools in order to use them, and you don't have to include the entire setuptools package in your distributions. By including just a single `bootstrap module`_ (a 12K .py file), your package will automatically download and install ``setuptools`` if the user is building your package from source and doesn't have a suitable version already installed. .. _bootstrap module: https://bootstrap.pypa.io/ez_setup.py Feature Highlights: * Automatically find/download/install/upgrade dependencies at build time using the `EasyInstall tool `_, which supports downloading via HTTP, FTP, Subversion, and SourceForge, and automatically scans web pages linked from PyPI to find download links. (It's the closest thing to CPAN currently available for Python.) * Create `Python Eggs `_ - a single-file importable distribution format * Enhanced support for accessing data files hosted in zipped packages. * Automatically include all packages in your source tree, without listing them individually in setup.py * Automatically include all relevant files in your source distributions, without needing to create a ``MANIFEST.in`` file, and without having to force regeneration of the ``MANIFEST`` file when your source tree changes. * Automatically generate wrapper scripts or Windows (console and GUI) .exe files for any number of "main" functions in your project. (Note: this is not a py2exe replacement; the .exe files rely on the local Python installation.) * Transparent Pyrex support, so that your setup.py can list ``.pyx`` files and still work even when the end-user doesn't have Pyrex installed (as long as you include the Pyrex-generated C in your source distribution) * Command aliases - create project-specific, per-user, or site-wide shortcut names for commonly used commands and options * PyPI upload support - upload your source distributions and eggs to PyPI * Deploy your project in "development mode", such that it's available on ``sys.path``, yet can still be edited directly from its source checkout. * Easily extend the distutils with new commands or ``setup()`` arguments, and distribute/reuse your extensions for multiple projects, without copying code. * Create extensible applications and frameworks that automatically discover extensions, using simple "entry points" declared in a project's setup script. In addition to the PyPI downloads, the development version of ``setuptools`` is available from the `Python SVN sandbox`_, and in-development versions of the `0.6 branch`_ are available as well. .. _0.6 branch: http://svn.python.org/projects/sandbox/branches/setuptools-0.6/#egg=setuptools-dev06 .. _Python SVN sandbox: http://svn.python.org/projects/sandbox/trunk/setuptools/#egg=setuptools-dev .. contents:: **Table of Contents** .. _ez_setup.py: `bootstrap module`_ ----------------- Developer's Guide ----------------- Installing ``setuptools`` ========================= Please follow the `EasyInstall Installation Instructions`_ to install the current stable version of setuptools. In particular, be sure to read the section on `Custom Installation Locations`_ if you are installing anywhere other than Python's ``site-packages`` directory. .. _EasyInstall Installation Instructions: easy_install.html#installation-instructions .. _Custom Installation Locations: easy_install.html#custom-installation-locations If you want the current in-development version of setuptools, you should first install a stable version, and then run:: ez_setup.py setuptools==dev This will download and install the latest development (i.e. unstable) version of setuptools from the Python Subversion sandbox. Basic Use ========= For basic use of setuptools, just import things from setuptools instead of the distutils. Here's a minimal setup script using setuptools:: from setuptools import setup, find_packages setup( name = "HelloWorld", version = "0.1", packages = find_packages(), ) As you can see, it doesn't take much to use setuptools in a project. Run that script in your project folder, alongside the Python packages you have developed. Invoke that script to produce eggs, upload to PyPI, and automatically include all packages in the directory where the setup.py lives. See the `Command Reference`_ section below to see what commands you can give to this setup script. For example, to produce a source distribution, simply invoke:: python setup.py sdist Of course, before you release your project to PyPI, you'll want to add a bit more information to your setup script to help people find or learn about your project. And maybe your project will have grown by then to include a few dependencies, and perhaps some data files and scripts:: from setuptools import setup, find_packages setup( name = "HelloWorld", version = "0.1", packages = find_packages(), scripts = ['say_hello.py'], # Project uses reStructuredText, so ensure that the docutils get # installed or upgraded on the target machine install_requires = ['docutils>=0.3'], package_data = { # If any package contains *.txt or *.rst files, include them: '': ['*.txt', '*.rst'], # And include any *.msg files found in the 'hello' package, too: 'hello': ['*.msg'], }, # metadata for upload to PyPI author = "Me", author_email = "me@example.com", description = "This is an Example Package", license = "PSF", keywords = "hello world example examples", url = "http://example.com/HelloWorld/", # project home page, if any # could also include long_description, download_url, classifiers, etc. ) In the sections that follow, we'll explain what most of these ``setup()`` arguments do (except for the metadata ones), and the various ways you might use them in your own project(s). Specifying Your Project's Version --------------------------------- Setuptools can work well with most versioning schemes; there are, however, a few special things to watch out for, in order to ensure that setuptools and EasyInstall can always tell what version of your package is newer than another version. Knowing these things will also help you correctly specify what versions of other projects your project depends on. A version consists of an alternating series of release numbers and pre-release or post-release tags. A release number is a series of digits punctuated by dots, such as ``2.4`` or ``0.5``. Each series of digits is treated numerically, so releases ``2.1`` and ``2.1.0`` are different ways to spell the same release number, denoting the first subrelease of release 2. But ``2.10`` is the *tenth* subrelease of release 2, and so is a different and newer release from ``2.1`` or ``2.1.0``. Leading zeros within a series of digits are also ignored, so ``2.01`` is the same as ``2.1``, and different from ``2.0.1``. Following a release number, you can have either a pre-release or post-release tag. Pre-release tags make a version be considered *older* than the version they are appended to. So, revision ``2.4`` is *newer* than revision ``2.4c1``, which in turn is newer than ``2.4b1`` or ``2.4a1``. Postrelease tags make a version be considered *newer* than the version they are appended to. So, revisions like ``2.4-1`` and ``2.4pl3`` are newer than ``2.4``, but are *older* than ``2.4.1`` (which has a higher release number). A pre-release tag is a series of letters that are alphabetically before "final". Some examples of prerelease tags would include ``alpha``, ``beta``, ``a``, ``c``, ``dev``, and so on. You do not have to place a dot or dash before the prerelease tag if it's immediately after a number, but it's okay to do so if you prefer. Thus, ``2.4c1`` and ``2.4.c1`` and ``2.4-c1`` all represent release candidate 1 of version ``2.4``, and are treated as identical by setuptools. In addition, there are three special prerelease tags that are treated as if they were the letter ``c``: ``pre``, ``preview``, and ``rc``. So, version ``2.4rc1``, ``2.4pre1`` and ``2.4preview1`` are all the exact same version as ``2.4c1``, and are treated as identical by setuptools. A post-release tag is either a series of letters that are alphabetically greater than or equal to "final", or a dash (``-``). Post-release tags are generally used to separate patch numbers, port numbers, build numbers, revision numbers, or date stamps from the release number. For example, the version ``2.4-r1263`` might denote Subversion revision 1263 of a post-release patch of version ``2.4``. Or you might use ``2.4-20051127`` to denote a date-stamped post-release. Notice that after each pre or post-release tag, you are free to place another release number, followed again by more pre- or post-release tags. For example, ``0.6a9.dev-r41475`` could denote Subversion revision 41475 of the in- development version of the ninth alpha of release 0.6. Notice that ``dev`` is a pre-release tag, so this version is a *lower* version number than ``0.6a9``, which would be the actual ninth alpha of release 0.6. But the ``-r41475`` is a post-release tag, so this version is *newer* than ``0.6a9.dev``. For the most part, setuptools' interpretation of version numbers is intuitive, but here are a few tips that will keep you out of trouble in the corner cases: * Don't stick adjoining pre-release tags together without a dot or number between them. Version ``1.9adev`` is the ``adev`` prerelease of ``1.9``, *not* a development pre-release of ``1.9a``. Use ``.dev`` instead, as in ``1.9a.dev``, or separate the prerelease tags with a number, as in ``1.9a0dev``. ``1.9a.dev``, ``1.9a0dev``, and even ``1.9.a.dev`` are identical versions from setuptools' point of view, so you can use whatever scheme you prefer. * If you want to be certain that your chosen numbering scheme works the way you think it will, you can use the ``pkg_resources.parse_version()`` function to compare different version numbers:: >>> from pkg_resources import parse_version >>> parse_version('1.9.a.dev') == parse_version('1.9a0dev') True >>> parse_version('2.1-rc2') < parse_version('2.1') True >>> parse_version('0.6a9dev-r41475') < parse_version('0.6a9') True Once you've decided on a version numbering scheme for your project, you can have setuptools automatically tag your in-development releases with various pre- or post-release tags. See the following sections for more details: * `Tagging and "Daily Build" or "Snapshot" Releases`_ * `Managing "Continuous Releases" Using Subversion`_ * The `egg_info`_ command New and Changed ``setup()`` Keywords ==================================== The following keyword arguments to ``setup()`` are added or changed by ``setuptools``. All of them are optional; you do not have to supply them unless you need the associated ``setuptools`` feature. ``include_package_data`` If set to ``True``, this tells ``setuptools`` to automatically include any data files it finds inside your package directories that are specified by your ``MANIFEST.in`` file. For more information, see the section below on `Including Data Files`_. ``exclude_package_data`` A dictionary mapping package names to lists of glob patterns that should be *excluded* from your package directories. You can use this to trim back any excess files included by ``include_package_data``. For a complete description and examples, see the section below on `Including Data Files`_. ``package_data`` A dictionary mapping package names to lists of glob patterns. For a complete description and examples, see the section below on `Including Data Files`_. You do not need to use this option if you are using ``include_package_data``, unless you need to add e.g. files that are generated by your setup script and build process. (And are therefore not in source control or are files that you don't want to include in your source distribution.) ``zip_safe`` A boolean (True or False) flag specifying whether the project can be safely installed and run from a zip file. If this argument is not supplied, the ``bdist_egg`` command will have to analyze all of your project's contents for possible problems each time it builds an egg. ``install_requires`` A string or list of strings specifying what other distributions need to be installed when this one is. See the section below on `Declaring Dependencies`_ for details and examples of the format of this argument. ``entry_points`` A dictionary mapping entry point group names to strings or lists of strings defining the entry points. Entry points are used to support dynamic discovery of services or plugins provided by a project. See `Dynamic Discovery of Services and Plugins`_ for details and examples of the format of this argument. In addition, this keyword is used to support `Automatic Script Creation`_. ``extras_require`` A dictionary mapping names of "extras" (optional features of your project) to strings or lists of strings specifying what other distributions must be installed to support those features. See the section below on `Declaring Dependencies`_ for details and examples of the format of this argument. ``setup_requires`` A string or list of strings specifying what other distributions need to be present in order for the *setup script* to run. ``setuptools`` will attempt to obtain these (even going so far as to download them using ``EasyInstall``) before processing the rest of the setup script or commands. This argument is needed if you are using distutils extensions as part of your build process; for example, extensions that process setup() arguments and turn them into EGG-INFO metadata files. (Note: projects listed in ``setup_requires`` will NOT be automatically installed on the system where the setup script is being run. They are simply downloaded to the ./.eggs directory if they're not locally available already. If you want them to be installed, as well as being available when the setup script is run, you should add them to ``install_requires`` **and** ``setup_requires``.) ``dependency_links`` A list of strings naming URLs to be searched when satisfying dependencies. These links will be used if needed to install packages specified by ``setup_requires`` or ``tests_require``. They will also be written into the egg's metadata for use by tools like EasyInstall to use when installing an ``.egg`` file. ``namespace_packages`` A list of strings naming the project's "namespace packages". A namespace package is a package that may be split across multiple project distributions. For example, Zope 3's ``zope`` package is a namespace package, because subpackages like ``zope.interface`` and ``zope.publisher`` may be distributed separately. The egg runtime system can automatically merge such subpackages into a single parent package at runtime, as long as you declare them in each project that contains any subpackages of the namespace package, and as long as the namespace package's ``__init__.py`` does not contain any code other than a namespace declaration. See the section below on `Namespace Packages`_ for more information. ``test_suite`` A string naming a ``unittest.TestCase`` subclass (or a package or module containing one or more of them, or a method of such a subclass), or naming a function that can be called with no arguments and returns a ``unittest.TestSuite``. If the named suite is a module, and the module has an ``additional_tests()`` function, it is called and the results are added to the tests to be run. If the named suite is a package, any submodules and subpackages are recursively added to the overall test suite. Specifying this argument enables use of the `test`_ command to run the specified test suite, e.g. via ``setup.py test``. See the section on the `test`_ command below for more details. ``tests_require`` If your project's tests need one or more additional packages besides those needed to install it, you can use this option to specify them. It should be a string or list of strings specifying what other distributions need to be present for the package's tests to run. When you run the ``test`` command, ``setuptools`` will attempt to obtain these (even going so far as to download them using ``EasyInstall``). Note that these required projects will *not* be installed on the system where the tests are run, but only downloaded to the project's setup directory if they're not already installed locally. .. _test_loader: ``test_loader`` If you would like to use a different way of finding tests to run than what setuptools normally uses, you can specify a module name and class name in this argument. The named class must be instantiable with no arguments, and its instances must support the ``loadTestsFromNames()`` method as defined in the Python ``unittest`` module's ``TestLoader`` class. Setuptools will pass only one test "name" in the `names` argument: the value supplied for the ``test_suite`` argument. The loader you specify may interpret this string in any way it likes, as there are no restrictions on what may be contained in a ``test_suite`` string. The module name and class name must be separated by a ``:``. The default value of this argument is ``"setuptools.command.test:ScanningLoader"``. If you want to use the default ``unittest`` behavior, you can specify ``"unittest:TestLoader"`` as your ``test_loader`` argument instead. This will prevent automatic scanning of submodules and subpackages. The module and class you specify here may be contained in another package, as long as you use the ``tests_require`` option to ensure that the package containing the loader class is available when the ``test`` command is run. ``eager_resources`` A list of strings naming resources that should be extracted together, if any of them is needed, or if any C extensions included in the project are imported. This argument is only useful if the project will be installed as a zipfile, and there is a need to have all of the listed resources be extracted to the filesystem *as a unit*. Resources listed here should be '/'-separated paths, relative to the source root, so to list a resource ``foo.png`` in package ``bar.baz``, you would include the string ``bar/baz/foo.png`` in this argument. If you only need to obtain resources one at a time, or you don't have any C extensions that access other files in the project (such as data files or shared libraries), you probably do NOT need this argument and shouldn't mess with it. For more details on how this argument works, see the section below on `Automatic Resource Extraction`_. ``use_2to3`` Convert the source code from Python 2 to Python 3 with 2to3 during the build process. See :doc:`python3` for more details. ``convert_2to3_doctests`` List of doctest source files that need to be converted with 2to3. See :doc:`python3` for more details. ``use_2to3_fixers`` A list of modules to search for additional fixers to be used during the 2to3 conversion. See :doc:`python3` for more details. Using ``find_packages()`` ------------------------- For simple projects, it's usually easy enough to manually add packages to the ``packages`` argument of ``setup()``. However, for very large projects (Twisted, PEAK, Zope, Chandler, etc.), it can be a big burden to keep the package list updated. That's what ``setuptools.find_packages()`` is for. ``find_packages()`` takes a source directory and two lists of package name patterns to exclude and include. If omitted, the source directory defaults to the same directory as the setup script. Some projects use a ``src`` or ``lib`` directory as the root of their source tree, and those projects would of course use ``"src"`` or ``"lib"`` as the first argument to ``find_packages()``. (And such projects also need something like ``package_dir = {'':'src'}`` in their ``setup()`` arguments, but that's just a normal distutils thing.) Anyway, ``find_packages()`` walks the target directory, filtering by inclusion patterns, and finds Python packages (any directory). On Python 3.2 and earlier, packages are only recognized if they include an ``__init__.py`` file. Finally, exclusion patterns are applied to remove matching packages. Inclusion and exclusion patterns are package names, optionally including wildcards. For example, ``find_packages(exclude=["*.tests"])`` will exclude all packages whose last name part is ``tests``. Or, ``find_packages(exclude=["*.tests", "*.tests.*"])`` will also exclude any subpackages of packages named ``tests``, but it still won't exclude a top-level ``tests`` package or the children thereof. In fact, if you really want no ``tests`` packages at all, you'll need something like this:: find_packages(exclude=["*.tests", "*.tests.*", "tests.*", "tests"]) in order to cover all the bases. Really, the exclusion patterns are intended to cover simpler use cases than this, like excluding a single, specified package and its subpackages. Regardless of the parameters, the ``find_packages()`` function returns a list of package names suitable for use as the ``packages`` argument to ``setup()``, and so is usually the easiest way to set that argument in your setup script. Especially since it frees you from having to remember to modify your setup script whenever your project grows additional top-level packages or subpackages. Automatic Script Creation ========================= Packaging and installing scripts can be a bit awkward with the distutils. For one thing, there's no easy way to have a script's filename match local conventions on both Windows and POSIX platforms. For another, you often have to create a separate file just for the "main" script, when your actual "main" is a function in a module somewhere. And even in Python 2.4, using the ``-m`` option only works for actual ``.py`` files that aren't installed in a package. ``setuptools`` fixes all of these problems by automatically generating scripts for you with the correct extension, and on Windows it will even create an ``.exe`` file so that users don't have to change their ``PATHEXT`` settings. The way to use this feature is to define "entry points" in your setup script that indicate what function the generated script should import and run. For example, to create two console scripts called ``foo`` and ``bar``, and a GUI script called ``baz``, you might do something like this:: setup( # other arguments here... entry_points={ 'console_scripts': [ 'foo = my_package.some_module:main_func', 'bar = other_module:some_func', ], 'gui_scripts': [ 'baz = my_package_gui:start_func', ] } ) When this project is installed on non-Windows platforms (using "setup.py install", "setup.py develop", or by using EasyInstall), a set of ``foo``, ``bar``, and ``baz`` scripts will be installed that import ``main_func`` and ``some_func`` from the specified modules. The functions you specify are called with no arguments, and their return value is passed to ``sys.exit()``, so you can return an errorlevel or message to print to stderr. On Windows, a set of ``foo.exe``, ``bar.exe``, and ``baz.exe`` launchers are created, alongside a set of ``foo.py``, ``bar.py``, and ``baz.pyw`` files. The ``.exe`` wrappers find and execute the right version of Python to run the ``.py`` or ``.pyw`` file. You may define as many "console script" and "gui script" entry points as you like, and each one can optionally specify "extras" that it depends on, that will be added to ``sys.path`` when the script is run. For more information on "extras", see the section below on `Declaring Extras`_. For more information on "entry points" in general, see the section below on `Dynamic Discovery of Services and Plugins`_. "Eggsecutable" Scripts ---------------------- Occasionally, there are situations where it's desirable to make an ``.egg`` file directly executable. You can do this by including an entry point such as the following:: setup( # other arguments here... entry_points = { 'setuptools.installation': [ 'eggsecutable = my_package.some_module:main_func', ] } ) Any eggs built from the above setup script will include a short executable prelude that imports and calls ``main_func()`` from ``my_package.some_module``. The prelude can be run on Unix-like platforms (including Mac and Linux) by invoking the egg with ``/bin/sh``, or by enabling execute permissions on the ``.egg`` file. For the executable prelude to run, the appropriate version of Python must be available via the ``PATH`` environment variable, under its "long" name. That is, if the egg is built for Python 2.3, there must be a ``python2.3`` executable present in a directory on ``PATH``. This feature is primarily intended to support ez_setup the installation of setuptools itself on non-Windows platforms, but may also be useful for other projects as well. IMPORTANT NOTE: Eggs with an "eggsecutable" header cannot be renamed, or invoked via symlinks. They *must* be invoked using their original filename, in order to ensure that, once running, ``pkg_resources`` will know what project and version is in use. The header script will check this and exit with an error if the ``.egg`` file has been renamed or is invoked via a symlink that changes its base name. Declaring Dependencies ====================== ``setuptools`` supports automatically installing dependencies when a package is installed, and including information about dependencies in Python Eggs (so that package management tools like EasyInstall can use the information). ``setuptools`` and ``pkg_resources`` use a common syntax for specifying a project's required dependencies. This syntax consists of a project's PyPI name, optionally followed by a comma-separated list of "extras" in square brackets, optionally followed by a comma-separated list of version specifiers. A version specifier is one of the operators ``<``, ``>``, ``<=``, ``>=``, ``==`` or ``!=``, followed by a version identifier. Tokens may be separated by whitespace, but any whitespace or nonstandard characters within a project name or version identifier must be replaced with ``-``. Version specifiers for a given project are internally sorted into ascending version order, and used to establish what ranges of versions are acceptable. Adjacent redundant conditions are also consolidated (e.g. ``">1, >2"`` becomes ``">1"``, and ``"<2,<3"`` becomes ``"<3"``). ``"!="`` versions are excised from the ranges they fall within. A project's version is then checked for membership in the resulting ranges. (Note that providing conflicting conditions for the same version (e.g. "<2,>=2" or "==2,!=2") is meaningless and may therefore produce bizarre results.) Here are some example requirement specifiers:: docutils >= 0.3 # comment lines and \ continuations are allowed in requirement strings BazSpam ==1.1, ==1.2, ==1.3, ==1.4, ==1.5, \ ==1.6, ==1.7 # and so are line-end comments PEAK[FastCGI, reST]>=0.5a4 setuptools==0.5a7 The simplest way to include requirement specifiers is to use the ``install_requires`` argument to ``setup()``. It takes a string or list of strings containing requirement specifiers. If you include more than one requirement in a string, each requirement must begin on a new line. This has three effects: 1. When your project is installed, either by using EasyInstall, ``setup.py install``, or ``setup.py develop``, all of the dependencies not already installed will be located (via PyPI), downloaded, built (if necessary), and installed. 2. Any scripts in your project will be installed with wrappers that verify the availability of the specified dependencies at runtime, and ensure that the correct versions are added to ``sys.path`` (e.g. if multiple versions have been installed). 3. Python Egg distributions will include a metadata file listing the dependencies. Note, by the way, that if you declare your dependencies in ``setup.py``, you do *not* need to use the ``require()`` function in your scripts or modules, as long as you either install the project or use ``setup.py develop`` to do development work on it. (See `"Development Mode"`_ below for more details on using ``setup.py develop``.) Dependencies that aren't in PyPI -------------------------------- If your project depends on packages that aren't registered in PyPI, you may still be able to depend on them, as long as they are available for download as: - an egg, in the standard distutils ``sdist`` format, - a single ``.py`` file, or - a VCS repository (Subversion, Mercurial, or Git). You just need to add some URLs to the ``dependency_links`` argument to ``setup()``. The URLs must be either: 1. direct download URLs, 2. the URLs of web pages that contain direct download links, or 3. the repository's URL In general, it's better to link to web pages, because it is usually less complex to update a web page than to release a new version of your project. You can also use a SourceForge ``showfiles.php`` link in the case where a package you depend on is distributed via SourceForge. If you depend on a package that's distributed as a single ``.py`` file, you must include an ``"#egg=project-version"`` suffix to the URL, to give a project name and version number. (Be sure to escape any dashes in the name or version by replacing them with underscores.) EasyInstall will recognize this suffix and automatically create a trivial ``setup.py`` to wrap the single ``.py`` file as an egg. In the case of a VCS checkout, you should also append ``#egg=project-version`` in order to identify for what package that checkout should be used. You can append ``@REV`` to the URL's path (before the fragment) to specify a revision. Additionally, you can also force the VCS being used by prepending the URL with a certain prefix. Currently available are: - ``svn+URL`` for Subversion, - ``git+URL`` for Git, and - ``hg+URL`` for Mercurial A more complete example would be: ``vcs+proto://host/path@revision#egg=project-version`` Be careful with the version. It should match the one inside the project files. If you want to disregard the version, you have to omit it both in the ``requires`` and in the URL's fragment. This will do a checkout (or a clone, in Git and Mercurial parlance) to a temporary folder and run ``setup.py bdist_egg``. The ``dependency_links`` option takes the form of a list of URL strings. For example, the below will cause EasyInstall to search the specified page for eggs or source distributions, if the package's dependencies aren't already installed:: setup( ... dependency_links = [ "http://peak.telecommunity.com/snapshots/" ], ) .. _Declaring Extras: Declaring "Extras" (optional features with their own dependencies) ------------------------------------------------------------------ Sometimes a project has "recommended" dependencies, that are not required for all uses of the project. For example, a project might offer optional PDF output if ReportLab is installed, and reStructuredText support if docutils is installed. These optional features are called "extras", and setuptools allows you to define their requirements as well. In this way, other projects that require these optional features can force the additional requirements to be installed, by naming the desired extras in their ``install_requires``. For example, let's say that Project A offers optional PDF and reST support:: setup( name="Project-A", ... extras_require = { 'PDF': ["ReportLab>=1.2", "RXP"], 'reST': ["docutils>=0.3"], } ) As you can see, the ``extras_require`` argument takes a dictionary mapping names of "extra" features, to strings or lists of strings describing those features' requirements. These requirements will *not* be automatically installed unless another package depends on them (directly or indirectly) by including the desired "extras" in square brackets after the associated project name. (Or if the extras were listed in a requirement spec on the EasyInstall command line.) Extras can be used by a project's `entry points`_ to specify dynamic dependencies. For example, if Project A includes a "rst2pdf" script, it might declare it like this, so that the "PDF" requirements are only resolved if the "rst2pdf" script is run:: setup( name="Project-A", ... entry_points = { 'console_scripts': [ 'rst2pdf = project_a.tools.pdfgen [PDF]', 'rst2html = project_a.tools.htmlgen', # more script entry points ... ], } ) Projects can also use another project's extras when specifying dependencies. For example, if project B needs "project A" with PDF support installed, it might declare the dependency like this:: setup( name="Project-B", install_requires = ["Project-A[PDF]"], ... ) This will cause ReportLab to be installed along with project A, if project B is installed -- even if project A was already installed. In this way, a project can encapsulate groups of optional "downstream dependencies" under a feature name, so that packages that depend on it don't have to know what the downstream dependencies are. If a later version of Project A builds in PDF support and no longer needs ReportLab, or if it ends up needing other dependencies besides ReportLab in order to provide PDF support, Project B's setup information does not need to change, but the right packages will still be installed if needed. Note, by the way, that if a project ends up not needing any other packages to support a feature, it should keep an empty requirements list for that feature in its ``extras_require`` argument, so that packages depending on that feature don't break (due to an invalid feature name). For example, if Project A above builds in PDF support and no longer needs ReportLab, it could change its setup to this:: setup( name="Project-A", ... extras_require = { 'PDF': [], 'reST': ["docutils>=0.3"], } ) so that Package B doesn't have to remove the ``[PDF]`` from its requirement specifier. Including Data Files ==================== The distutils have traditionally allowed installation of "data files", which are placed in a platform-specific location. However, the most common use case for data files distributed with a package is for use *by* the package, usually by including the data files in the package directory. Setuptools offers three ways to specify data files to be included in your packages. First, you can simply use the ``include_package_data`` keyword, e.g.:: from setuptools import setup, find_packages setup( ... include_package_data = True ) This tells setuptools to install any data files it finds in your packages. The data files must be specified via the distutils' ``MANIFEST.in`` file. (They can also be tracked by a revision control system, using an appropriate plugin. See the section below on `Adding Support for Revision Control Systems`_ for information on how to write such plugins.) If you want finer-grained control over what files are included (for example, if you have documentation files in your package directories and want to exclude them from installation), then you can also use the ``package_data`` keyword, e.g.:: from setuptools import setup, find_packages setup( ... package_data = { # If any package contains *.txt or *.rst files, include them: '': ['*.txt', '*.rst'], # And include any *.msg files found in the 'hello' package, too: 'hello': ['*.msg'], } ) The ``package_data`` argument is a dictionary that maps from package names to lists of glob patterns. The globs may include subdirectory names, if the data files are contained in a subdirectory of the package. For example, if the package tree looks like this:: setup.py src/ mypkg/ __init__.py mypkg.txt data/ somefile.dat otherdata.dat The setuptools setup file might look like this:: from setuptools import setup, find_packages setup( ... packages = find_packages('src'), # include all packages under src package_dir = {'':'src'}, # tell distutils packages are under src package_data = { # If any package contains *.txt files, include them: '': ['*.txt'], # And include any *.dat files found in the 'data' subdirectory # of the 'mypkg' package, also: 'mypkg': ['data/*.dat'], } ) Notice that if you list patterns in ``package_data`` under the empty string, these patterns are used to find files in every package, even ones that also have their own patterns listed. Thus, in the above example, the ``mypkg.txt`` file gets included even though it's not listed in the patterns for ``mypkg``. Also notice that if you use paths, you *must* use a forward slash (``/``) as the path separator, even if you are on Windows. Setuptools automatically converts slashes to appropriate platform-specific separators at build time. (Note: although the ``package_data`` argument was previously only available in ``setuptools``, it was also added to the Python ``distutils`` package as of Python 2.4; there is `some documentation for the feature`__ available on the python.org website. If using the setuptools-specific ``include_package_data`` argument, files specified by ``package_data`` will *not* be automatically added to the manifest unless they are listed in the MANIFEST.in file.) __ http://docs.python.org/dist/node11.html Sometimes, the ``include_package_data`` or ``package_data`` options alone aren't sufficient to precisely define what files you want included. For example, you may want to include package README files in your revision control system and source distributions, but exclude them from being installed. So, setuptools offers an ``exclude_package_data`` option as well, that allows you to do things like this:: from setuptools import setup, find_packages setup( ... packages = find_packages('src'), # include all packages under src package_dir = {'':'src'}, # tell distutils packages are under src include_package_data = True, # include everything in source control # ...but exclude README.txt from all packages exclude_package_data = { '': ['README.txt'] }, ) The ``exclude_package_data`` option is a dictionary mapping package names to lists of wildcard patterns, just like the ``package_data`` option. And, just as with that option, a key of ``''`` will apply the given pattern(s) to all packages. However, any files that match these patterns will be *excluded* from installation, even if they were listed in ``package_data`` or were included as a result of using ``include_package_data``. In summary, the three options allow you to: ``include_package_data`` Accept all data files and directories matched by ``MANIFEST.in``. ``package_data`` Specify additional patterns to match files and directories that may or may not be matched by ``MANIFEST.in`` or found in source control. ``exclude_package_data`` Specify patterns for data files and directories that should *not* be included when a package is installed, even if they would otherwise have been included due to the use of the preceding options. NOTE: Due to the way the distutils build process works, a data file that you include in your project and then stop including may be "orphaned" in your project's build directories, requiring you to run ``setup.py clean --all`` to fully remove them. This may also be important for your users and contributors if they track intermediate revisions of your project using Subversion; be sure to let them know when you make changes that remove files from inclusion so they can run ``setup.py clean --all``. Accessing Data Files at Runtime ------------------------------- Typically, existing programs manipulate a package's ``__file__`` attribute in order to find the location of data files. However, this manipulation isn't compatible with PEP 302-based import hooks, including importing from zip files and Python Eggs. It is strongly recommended that, if you are using data files, you should use the `Resource Management API`_ of ``pkg_resources`` to access them. The ``pkg_resources`` module is distributed as part of setuptools, so if you're using setuptools to distribute your package, there is no reason not to use its resource management API. See also `Accessing Package Resources`_ for a quick example of converting code that uses ``__file__`` to use ``pkg_resources`` instead. .. _Resource Management API: http://peak.telecommunity.com/DevCenter/PythonEggs#resource-management .. _Accessing Package Resources: http://peak.telecommunity.com/DevCenter/PythonEggs#accessing-package-resources Non-Package Data Files ---------------------- The ``distutils`` normally install general "data files" to a platform-specific location (e.g. ``/usr/share``). This feature intended to be used for things like documentation, example configuration files, and the like. ``setuptools`` does not install these data files in a separate location, however. They are bundled inside the egg file or directory, alongside the Python modules and packages. The data files can also be accessed using the `Resource Management API`_, by specifying a ``Requirement`` instead of a package name:: from pkg_resources import Requirement, resource_filename filename = resource_filename(Requirement.parse("MyProject"),"sample.conf") The above code will obtain the filename of the "sample.conf" file in the data root of the "MyProject" distribution. Note, by the way, that this encapsulation of data files means that you can't actually install data files to some arbitrary location on a user's machine; this is a feature, not a bug. You can always include a script in your distribution that extracts and copies your the documentation or data files to a user-specified location, at their discretion. If you put related data files in a single directory, you can use ``resource_filename()`` with the directory name to get a filesystem directory that then can be copied with the ``shutil`` module. (Even if your package is installed as a zipfile, calling ``resource_filename()`` on a directory will return an actual filesystem directory, whose contents will be that entire subtree of your distribution.) (Of course, if you're writing a new package, you can just as easily place your data files or directories inside one of your packages, rather than using the distutils' approach. However, if you're updating an existing application, it may be simpler not to change the way it currently specifies these data files.) Automatic Resource Extraction ----------------------------- If you are using tools that expect your resources to be "real" files, or your project includes non-extension native libraries or other files that your C extensions expect to be able to access, you may need to list those files in the ``eager_resources`` argument to ``setup()``, so that the files will be extracted together, whenever a C extension in the project is imported. This is especially important if your project includes shared libraries *other* than distutils-built C extensions, and those shared libraries use file extensions other than ``.dll``, ``.so``, or ``.dylib``, which are the extensions that setuptools 0.6a8 and higher automatically detects as shared libraries and adds to the ``native_libs.txt`` file for you. Any shared libraries whose names do not end with one of those extensions should be listed as ``eager_resources``, because they need to be present in the filesystem when he C extensions that link to them are used. The ``pkg_resources`` runtime for compressed packages will automatically extract *all* C extensions and ``eager_resources`` at the same time, whenever *any* C extension or eager resource is requested via the ``resource_filename()`` API. (C extensions are imported using ``resource_filename()`` internally.) This ensures that C extensions will see all of the "real" files that they expect to see. Note also that you can list directory resource names in ``eager_resources`` as well, in which case the directory's contents (including subdirectories) will be extracted whenever any C extension or eager resource is requested. Please note that if you're not sure whether you need to use this argument, you don't! It's really intended to support projects with lots of non-Python dependencies and as a last resort for crufty projects that can't otherwise handle being compressed. If your package is pure Python, Python plus data files, or Python plus C, you really don't need this. You've got to be using either C or an external program that needs "real" files in your project before there's any possibility of ``eager_resources`` being relevant to your project. Extensible Applications and Frameworks ====================================== .. _Entry Points: Dynamic Discovery of Services and Plugins ----------------------------------------- ``setuptools`` supports creating libraries that "plug in" to extensible applications and frameworks, by letting you register "entry points" in your project that can be imported by the application or framework. For example, suppose that a blogging tool wants to support plugins that provide translation for various file types to the blog's output format. The framework might define an "entry point group" called ``blogtool.parsers``, and then allow plugins to register entry points for the file extensions they support. This would allow people to create distributions that contain one or more parsers for different file types, and then the blogging tool would be able to find the parsers at runtime by looking up an entry point for the file extension (or mime type, or however it wants to). Note that if the blogging tool includes parsers for certain file formats, it can register these as entry points in its own setup script, which means it doesn't have to special-case its built-in formats. They can just be treated the same as any other plugin's entry points would be. If you're creating a project that plugs in to an existing application or framework, you'll need to know what entry points or entry point groups are defined by that application or framework. Then, you can register entry points in your setup script. Here are a few examples of ways you might register an ``.rst`` file parser entry point in the ``blogtool.parsers`` entry point group, for our hypothetical blogging tool:: setup( # ... entry_points = {'blogtool.parsers': '.rst = some_module:SomeClass'} ) setup( # ... entry_points = {'blogtool.parsers': ['.rst = some_module:a_func']} ) setup( # ... entry_points = """ [blogtool.parsers] .rst = some.nested.module:SomeClass.some_classmethod [reST] """, extras_require = dict(reST = "Docutils>=0.3.5") ) The ``entry_points`` argument to ``setup()`` accepts either a string with ``.ini``-style sections, or a dictionary mapping entry point group names to either strings or lists of strings containing entry point specifiers. An entry point specifier consists of a name and value, separated by an ``=`` sign. The value consists of a dotted module name, optionally followed by a ``:`` and a dotted identifier naming an object within the module. It can also include a bracketed list of "extras" that are required for the entry point to be used. When the invoking application or framework requests loading of an entry point, any requirements implied by the associated extras will be passed to ``pkg_resources.require()``, so that an appropriate error message can be displayed if the needed package(s) are missing. (Of course, the invoking app or framework can ignore such errors if it wants to make an entry point optional if a requirement isn't installed.) Defining Additional Metadata ---------------------------- Some extensible applications and frameworks may need to define their own kinds of metadata to include in eggs, which they can then access using the ``pkg_resources`` metadata APIs. Ordinarily, this is done by having plugin developers include additional files in their ``ProjectName.egg-info`` directory. However, since it can be tedious to create such files by hand, you may want to create a distutils extension that will create the necessary files from arguments to ``setup()``, in much the same way that ``setuptools`` does for many of the ``setup()`` arguments it adds. See the section below on `Creating distutils Extensions`_ for more details, especially the subsection on `Adding new EGG-INFO Files`_. "Development Mode" ================== Under normal circumstances, the ``distutils`` assume that you are going to build a distribution of your project, not use it in its "raw" or "unbuilt" form. If you were to use the ``distutils`` that way, you would have to rebuild and reinstall your project every time you made a change to it during development. Another problem that sometimes comes up with the ``distutils`` is that you may need to do development on two related projects at the same time. You may need to put both projects' packages in the same directory to run them, but need to keep them separate for revision control purposes. How can you do this? Setuptools allows you to deploy your projects for use in a common directory or staging area, but without copying any files. Thus, you can edit each project's code in its checkout directory, and only need to run build commands when you change a project's C extensions or similarly compiled files. You can even deploy a project into another project's checkout directory, if that's your preferred way of working (as opposed to using a common independent staging area or the site-packages directory). To do this, use the ``setup.py develop`` command. It works very similarly to ``setup.py install`` or the EasyInstall tool, except that it doesn't actually install anything. Instead, it creates a special ``.egg-link`` file in the deployment directory, that links to your project's source code. And, if your deployment directory is Python's ``site-packages`` directory, it will also update the ``easy-install.pth`` file to include your project's source code, thereby making it available on ``sys.path`` for all programs using that Python installation. If you have enabled the ``use_2to3`` flag, then of course the ``.egg-link`` will not link directly to your source code when run under Python 3, since that source code would be made for Python 2 and not work under Python 3. Instead the ``setup.py develop`` will build Python 3 code under the ``build`` directory, and link there. This means that after doing code changes you will have to run ``setup.py build`` before these changes are picked up by your Python 3 installation. In addition, the ``develop`` command creates wrapper scripts in the target script directory that will run your in-development scripts after ensuring that all your ``install_requires`` packages are available on ``sys.path``. You can deploy the same project to multiple staging areas, e.g. if you have multiple projects on the same machine that are sharing the same project you're doing development work. When you're done with a given development task, you can remove the project source from a staging area using ``setup.py develop --uninstall``, specifying the desired staging area if it's not the default. There are several options to control the precise behavior of the ``develop`` command; see the section on the `develop`_ command below for more details. Note that you can also apply setuptools commands to non-setuptools projects, using commands like this:: python -c "import setuptools; execfile('setup.py')" develop That is, you can simply list the normal setup commands and options following the quoted part. Distributing a ``setuptools``-based project =========================================== Using ``setuptools``... Without bundling it! --------------------------------------------- Your users might not have ``setuptools`` installed on their machines, or even if they do, it might not be the right version. Fixing this is easy; just download `ez_setup.py`_, and put it in the same directory as your ``setup.py`` script. (Be sure to add it to your revision control system, too.) Then add these two lines to the very top of your setup script, before the script imports anything from setuptools: .. code-block:: python import ez_setup ez_setup.use_setuptools() That's it. The ``ez_setup`` module will automatically download a matching version of ``setuptools`` from PyPI, if it isn't present on the target system. Whenever you install an updated version of setuptools, you should also update your projects' ``ez_setup.py`` files, so that a matching version gets installed on the target machine(s). By the way, setuptools supports the new PyPI "upload" command, so you can use ``setup.py sdist upload`` or ``setup.py bdist_egg upload`` to upload your source or egg distributions respectively. Your project's current version must be registered with PyPI first, of course; you can use ``setup.py register`` to do that. Or you can do it all in one step, e.g. ``setup.py register sdist bdist_egg upload`` will register the package, build source and egg distributions, and then upload them both to PyPI, where they'll be easily found by other projects that depend on them. (By the way, if you need to distribute a specific version of ``setuptools``, you can specify the exact version and base download URL as parameters to the ``use_setuptools()`` function. See the function's docstring for details.) What Your Users Should Know --------------------------- In general, a setuptools-based project looks just like any distutils-based project -- as long as your users have an internet connection and are installing to ``site-packages``, that is. But for some users, these conditions don't apply, and they may become frustrated if this is their first encounter with a setuptools-based project. To keep these users happy, you should review the following topics in your project's installation instructions, if they are relevant to your project and your target audience isn't already familiar with setuptools and ``easy_install``. Network Access If your project is using ``ez_setup``, you should inform users of the need to either have network access, or to preinstall the correct version of setuptools using the `EasyInstall installation instructions`_. Those instructions also have tips for dealing with firewalls as well as how to manually download and install setuptools. Custom Installation Locations You should inform your users that if they are installing your project to somewhere other than the main ``site-packages`` directory, they should first install setuptools using the instructions for `Custom Installation Locations`_, before installing your project. Your Project's Dependencies If your project depends on other projects that may need to be downloaded from PyPI or elsewhere, you should list them in your installation instructions, or tell users how to find out what they are. While most users will not need this information, any users who don't have unrestricted internet access may have to find, download, and install the other projects manually. (Note, however, that they must still install those projects using ``easy_install``, or your project will not know they are installed, and your setup script will try to download them again.) If you want to be especially friendly to users with limited network access, you may wish to build eggs for your project and its dependencies, making them all available for download from your site, or at least create a page with links to all of the needed eggs. In this way, users with limited network access can manually download all the eggs to a single directory, then use the ``-f`` option of ``easy_install`` to specify the directory to find eggs in. Users who have full network access can just use ``-f`` with the URL of your download page, and ``easy_install`` will find all the needed eggs using your links directly. This is also useful when your target audience isn't able to compile packages (e.g. most Windows users) and your package or some of its dependencies include C code. Revision Control System Users and Co-Developers Users and co-developers who are tracking your in-development code using a revision control system should probably read this manual's sections regarding such development. Alternately, you may wish to create a quick-reference guide containing the tips from this manual that apply to your particular situation. For example, if you recommend that people use ``setup.py develop`` when tracking your in-development code, you should let them know that this needs to be run after every update or commit. Similarly, if you remove modules or data files from your project, you should remind them to run ``setup.py clean --all`` and delete any obsolete ``.pyc`` or ``.pyo``. (This tip applies to the distutils in general, not just setuptools, but not everybody knows about them; be kind to your users by spelling out your project's best practices rather than leaving them guessing.) Creating System Packages Some users want to manage all Python packages using a single package manager, and sometimes that package manager isn't ``easy_install``! Setuptools currently supports ``bdist_rpm``, ``bdist_wininst``, and ``bdist_dumb`` formats for system packaging. If a user has a locally- installed "bdist" packaging tool that internally uses the distutils ``install`` command, it should be able to work with ``setuptools``. Some examples of "bdist" formats that this should work with include the ``bdist_nsi`` and ``bdist_msi`` formats for Windows. However, packaging tools that build binary distributions by running ``setup.py install`` on the command line or as a subprocess will require modification to work with setuptools. They should use the ``--single-version-externally-managed`` option to the ``install`` command, combined with the standard ``--root`` or ``--record`` options. See the `install command`_ documentation below for more details. The ``bdist_deb`` command is an example of a command that currently requires this kind of patching to work with setuptools. If you or your users have a problem building a usable system package for your project, please report the problem via the mailing list so that either the "bdist" tool in question or setuptools can be modified to resolve the issue. Setting the ``zip_safe`` flag ----------------------------- For maximum performance, Python packages are best installed as zip files. Not all packages, however, are capable of running in compressed form, because they may expect to be able to access either source code or data files as normal operating system files. So, ``setuptools`` can install your project as a zipfile or a directory, and its default choice is determined by the project's ``zip_safe`` flag. You can pass a True or False value for the ``zip_safe`` argument to the ``setup()`` function, or you can omit it. If you omit it, the ``bdist_egg`` command will analyze your project's contents to see if it can detect any conditions that would prevent it from working in a zipfile. It will output notices to the console about any such conditions that it finds. Currently, this analysis is extremely conservative: it will consider the project unsafe if it contains any C extensions or datafiles whatsoever. This does *not* mean that the project can't or won't work as a zipfile! It just means that the ``bdist_egg`` authors aren't yet comfortable asserting that the project *will* work. If the project contains no C or data files, and does no ``__file__`` or ``__path__`` introspection or source code manipulation, then there is an extremely solid chance the project will work when installed as a zipfile. (And if the project uses ``pkg_resources`` for all its data file access, then C extensions and other data files shouldn't be a problem at all. See the `Accessing Data Files at Runtime`_ section above for more information.) However, if ``bdist_egg`` can't be *sure* that your package will work, but you've checked over all the warnings it issued, and you are either satisfied it *will* work (or if you want to try it for yourself), then you should set ``zip_safe`` to ``True`` in your ``setup()`` call. If it turns out that it doesn't work, you can always change it to ``False``, which will force ``setuptools`` to install your project as a directory rather than as a zipfile. Of course, the end-user can still override either decision, if they are using EasyInstall to install your package. And, if you want to override for testing purposes, you can just run ``setup.py easy_install --zip-ok .`` or ``setup.py easy_install --always-unzip .`` in your project directory. to install the package as a zipfile or directory, respectively. In the future, as we gain more experience with different packages and become more satisfied with the robustness of the ``pkg_resources`` runtime, the "zip safety" analysis may become less conservative. However, we strongly recommend that you determine for yourself whether your project functions correctly when installed as a zipfile, correct any problems if you can, and then make an explicit declaration of ``True`` or ``False`` for the ``zip_safe`` flag, so that it will not be necessary for ``bdist_egg`` or ``EasyInstall`` to try to guess whether your project can work as a zipfile. Namespace Packages ------------------ Sometimes, a large package is more useful if distributed as a collection of smaller eggs. However, Python does not normally allow the contents of a package to be retrieved from more than one location. "Namespace packages" are a solution for this problem. When you declare a package to be a namespace package, it means that the package has no meaningful contents in its ``__init__.py``, and that it is merely a container for modules and subpackages. The ``pkg_resources`` runtime will then automatically ensure that the contents of namespace packages that are spread over multiple eggs or directories are combined into a single "virtual" package. The ``namespace_packages`` argument to ``setup()`` lets you declare your project's namespace packages, so that they will be included in your project's metadata. The argument should list the namespace packages that the egg participates in. For example, the ZopeInterface project might do this:: setup( # ... namespace_packages = ['zope'] ) because it contains a ``zope.interface`` package that lives in the ``zope`` namespace package. Similarly, a project for a standalone ``zope.publisher`` would also declare the ``zope`` namespace package. When these projects are installed and used, Python will see them both as part of a "virtual" ``zope`` package, even though they will be installed in different locations. Namespace packages don't have to be top-level packages. For example, Zope 3's ``zope.app`` package is a namespace package, and in the future PEAK's ``peak.util`` package will be too. Note, by the way, that your project's source tree must include the namespace packages' ``__init__.py`` files (and the ``__init__.py`` of any parent packages), in a normal Python package layout. These ``__init__.py`` files *must* contain the line:: __import__('pkg_resources').declare_namespace(__name__) This code ensures that the namespace package machinery is operating and that the current package is registered as a namespace package. You must NOT include any other code and data in a namespace package's ``__init__.py``. Even though it may appear to work during development, or when projects are installed as ``.egg`` files, it will not work when the projects are installed using "system" packaging tools -- in such cases the ``__init__.py`` files will not be installed, let alone executed. You must include the ``declare_namespace()`` line in the ``__init__.py`` of *every* project that has contents for the namespace package in question, in order to ensure that the namespace will be declared regardless of which project's copy of ``__init__.py`` is loaded first. If the first loaded ``__init__.py`` doesn't declare it, it will never *be* declared, because no other copies will ever be loaded! TRANSITIONAL NOTE ~~~~~~~~~~~~~~~~~ Setuptools automatically calls ``declare_namespace()`` for you at runtime, but future versions may *not*. This is because the automatic declaration feature has some negative side effects, such as needing to import all namespace packages during the initialization of the ``pkg_resources`` runtime, and also the need for ``pkg_resources`` to be explicitly imported before any namespace packages work at all. In some future releases, you'll be responsible for including your own declaration lines, and the automatic declaration feature will be dropped to get rid of the negative side effects. During the remainder of the current development cycle, therefore, setuptools will warn you about missing ``declare_namespace()`` calls in your ``__init__.py`` files, and you should correct these as soon as possible before the compatibility support is removed. Namespace packages without declaration lines will not work correctly once a user has upgraded to a later version, so it's important that you make this change now in order to avoid having your code break in the field. Our apologies for the inconvenience, and thank you for your patience. Tagging and "Daily Build" or "Snapshot" Releases ------------------------------------------------ When a set of related projects are under development, it may be important to track finer-grained version increments than you would normally use for e.g. "stable" releases. While stable releases might be measured in dotted numbers with alpha/beta/etc. status codes, development versions of a project often need to be tracked by revision or build number or even build date. This is especially true when projects in development need to refer to one another, and therefore may literally need an up-to-the-minute version of something! To support these scenarios, ``setuptools`` allows you to "tag" your source and egg distributions by adding one or more of the following to the project's "official" version identifier: * A manually-specified pre-release tag, such as "build" or "dev", or a manually-specified post-release tag, such as a build or revision number (``--tag-build=STRING, -bSTRING``) * A "last-modified revision number" string generated automatically from Subversion's metadata (assuming your project is being built from a Subversion "working copy") (``--tag-svn-revision, -r``) * An 8-character representation of the build date (``--tag-date, -d``), as a postrelease tag You can add these tags by adding ``egg_info`` and the desired options to the command line ahead of the ``sdist`` or ``bdist`` commands that you want to generate a daily build or snapshot for. See the section below on the `egg_info`_ command for more details. (Also, before you release your project, be sure to see the section above on `Specifying Your Project's Version`_ for more information about how pre- and post-release tags affect how setuptools and EasyInstall interpret version numbers. This is important in order to make sure that dependency processing tools will know which versions of your project are newer than others.) Finally, if you are creating builds frequently, and either building them in a downloadable location or are copying them to a distribution server, you should probably also check out the `rotate`_ command, which lets you automatically delete all but the N most-recently-modified distributions matching a glob pattern. So, you can use a command line like:: setup.py egg_info -rbDEV bdist_egg rotate -m.egg -k3 to build an egg whose version info includes 'DEV-rNNNN' (where NNNN is the most recent Subversion revision that affected the source tree), and then delete any egg files from the distribution directory except for the three that were built most recently. If you have to manage automated builds for multiple packages, each with different tagging and rotation policies, you may also want to check out the `alias`_ command, which would let each package define an alias like ``daily`` that would perform the necessary tag, build, and rotate commands. Then, a simpler script or cron job could just run ``setup.py daily`` in each project directory. (And, you could also define sitewide or per-user default versions of the ``daily`` alias, so that projects that didn't define their own would use the appropriate defaults.) Generating Source Distributions ------------------------------- ``setuptools`` enhances the distutils' default algorithm for source file selection with pluggable endpoints for looking up files to include. If you are using a revision control system, and your source distributions only need to include files that you're tracking in revision control, use a corresponding plugin instead of writing a ``MANIFEST.in`` file. See the section below on `Adding Support for Revision Control Systems`_ for information on plugins. If you need to include automatically generated files, or files that are kept in an unsupported revision control system, you'll need to create a ``MANIFEST.in`` file to specify any files that the default file location algorithm doesn't catch. See the distutils documentation for more information on the format of the ``MANIFEST.in`` file. But, be sure to ignore any part of the distutils documentation that deals with ``MANIFEST`` or how it's generated from ``MANIFEST.in``; setuptools shields you from these issues and doesn't work the same way in any case. Unlike the distutils, setuptools regenerates the source distribution manifest file every time you build a source distribution, and it builds it inside the project's ``.egg-info`` directory, out of the way of your main project directory. You therefore need not worry about whether it is up-to-date or not. Indeed, because setuptools' approach to determining the contents of a source distribution is so much simpler, its ``sdist`` command omits nearly all of the options that the distutils' more complex ``sdist`` process requires. For all practical purposes, you'll probably use only the ``--formats`` option, if you use any option at all. Making your package available for EasyInstall --------------------------------------------- If you use the ``register`` command (``setup.py register``) to register your package with PyPI, that's most of the battle right there. (See the `docs for the register command`_ for more details.) .. _docs for the register command: http://docs.python.org/dist/package-index.html If you also use the `upload`_ command to upload actual distributions of your package, that's even better, because EasyInstall will be able to find and download them directly from your project's PyPI page. However, there may be reasons why you don't want to upload distributions to PyPI, and just want your existing distributions (or perhaps a Subversion checkout) to be used instead. So here's what you need to do before running the ``register`` command. There are three ``setup()`` arguments that affect EasyInstall: ``url`` and ``download_url`` These become links on your project's PyPI page. EasyInstall will examine them to see if they link to a package ("primary links"), or whether they are HTML pages. If they're HTML pages, EasyInstall scans all HREF's on the page for primary links ``long_description`` EasyInstall will check any URLs contained in this argument to see if they are primary links. A URL is considered a "primary link" if it is a link to a .tar.gz, .tgz, .zip, .egg, .egg.zip, .tar.bz2, or .exe file, or if it has an ``#egg=project`` or ``#egg=project-version`` fragment identifier attached to it. EasyInstall attempts to determine a project name and optional version number from the text of a primary link *without* downloading it. When it has found all the primary links, EasyInstall will select the best match based on requested version, platform compatibility, and other criteria. So, if your ``url`` or ``download_url`` point either directly to a downloadable source distribution, or to HTML page(s) that have direct links to such, then EasyInstall will be able to locate downloads automatically. If you want to make Subversion checkouts available, then you should create links with either ``#egg=project`` or ``#egg=project-version`` added to the URL. You should replace ``project`` and ``version`` with the values they would have in an egg filename. (Be sure to actually generate an egg and then use the initial part of the filename, rather than trying to guess what the escaped form of the project name and version number will be.) Note that Subversion checkout links are of lower precedence than other kinds of distributions, so EasyInstall will not select a Subversion checkout for downloading unless it has a version included in the ``#egg=`` suffix, and it's a higher version than EasyInstall has seen in any other links for your project. As a result, it's a common practice to use mark checkout URLs with a version of "dev" (i.e., ``#egg=projectname-dev``), so that users can do something like this:: easy_install --editable projectname==dev in order to check out the in-development version of ``projectname``. Managing "Continuous Releases" Using Subversion ----------------------------------------------- If you expect your users to track in-development versions of your project via Subversion, there are a few additional steps you should take to ensure that things work smoothly with EasyInstall. First, you should add the following to your project's ``setup.cfg`` file: .. code-block:: ini [egg_info] tag_build = .dev tag_svn_revision = 1 This will tell ``setuptools`` to generate package version numbers like ``1.0a1.dev-r1263``, which will be considered to be an *older* release than ``1.0a1``. Thus, when you actually release ``1.0a1``, the entire egg infrastructure (including ``setuptools``, ``pkg_resources`` and EasyInstall) will know that ``1.0a1`` supersedes any interim snapshots from Subversion, and handle upgrades accordingly. (Note: the project version number you specify in ``setup.py`` should always be the *next* version of your software, not the last released version. Alternately, you can leave out the ``tag_build=.dev``, and always use the *last* release as a version number, so that your post-1.0 builds are labelled ``1.0-r1263``, indicating a post-1.0 patchlevel. Most projects so far, however, seem to prefer to think of their project as being a future version still under development, rather than a past version being patched. It is of course possible for a single project to have both situations, using post-release numbering on release branches, and pre-release numbering on the trunk. But you don't have to make things this complex if you don't want to.) Commonly, projects releasing code from Subversion will include a PyPI link to their checkout URL (as described in the previous section) with an ``#egg=projectname-dev`` suffix. This allows users to request EasyInstall to download ``projectname==dev`` in order to get the latest in-development code. Note that if your project depends on such in-progress code, you may wish to specify your ``install_requires`` (or other requirements) to include ``==dev``, e.g.: .. code-block:: python install_requires = ["OtherProject>=0.2a1.dev-r143,==dev"] The above example says, "I really want at least this particular development revision number, but feel free to follow and use an ``#egg=OtherProject-dev`` link if you find one". This avoids the need to have actual source or binary distribution snapshots of in-development code available, just to be able to depend on the latest and greatest a project has to offer. A final note for Subversion development: if you are using SVN revision tags as described in this section, it's a good idea to run ``setup.py develop`` after each Subversion checkin or update, because your project's version number will be changing, and your script wrappers need to be updated accordingly. Also, if the project's requirements have changed, the ``develop`` command will take care of fetching the updated dependencies, building changed extensions, etc. Be sure to also remind any of your users who check out your project from Subversion that they need to run ``setup.py develop`` after every update in order to keep their checkout completely in sync. Making "Official" (Non-Snapshot) Releases ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you make an official release, creating source or binary distributions, you will need to override the tag settings from ``setup.cfg``, so that you don't end up registering versions like ``foobar-0.7a1.dev-r34832``. This is easy to do if you are developing on the trunk and using tags or branches for your releases - just make the change to ``setup.cfg`` after branching or tagging the release, so the trunk will still produce development snapshots. Alternately, if you are not branching for releases, you can override the default version options on the command line, using something like:: python setup.py egg_info -RDb "" sdist bdist_egg register upload The first part of this command (``egg_info -RDb ""``) will override the configured tag information, before creating source and binary eggs, registering the project with PyPI, and uploading the files. Thus, these commands will use the plain version from your ``setup.py``, without adding the Subversion revision number or build designation string. Of course, if you will be doing this a lot, you may wish to create a personal alias for this operation, e.g.:: python setup.py alias -u release egg_info -RDb "" You can then use it like this:: python setup.py release sdist bdist_egg register upload Or of course you can create more elaborate aliases that do all of the above. See the sections below on the `egg_info`_ and `alias`_ commands for more ideas. Distributing Extensions compiled with Pyrex ------------------------------------------- ``setuptools`` includes transparent support for building Pyrex extensions, as long as you define your extensions using ``setuptools.Extension``, *not* ``distutils.Extension``. You must also not import anything from Pyrex in your setup script. If you follow these rules, you can safely list ``.pyx`` files as the source of your ``Extension`` objects in the setup script. ``setuptools`` will detect at build time whether Pyrex is installed or not. If it is, then ``setuptools`` will use it. If not, then ``setuptools`` will silently change the ``Extension`` objects to refer to the ``.c`` counterparts of the ``.pyx`` files, so that the normal distutils C compilation process will occur. Of course, for this to work, your source distributions must include the C code generated by Pyrex, as well as your original ``.pyx`` files. This means that you will probably want to include current ``.c`` files in your revision control system, rebuilding them whenever you check changes in for the ``.pyx`` source files. This will ensure that people tracking your project in a revision control system will be able to build it even if they don't have Pyrex installed, and that your source releases will be similarly usable with or without Pyrex. ----------------- Command Reference ----------------- .. _alias: ``alias`` - Define shortcuts for commonly used commands ======================================================= Sometimes, you need to use the same commands over and over, but you can't necessarily set them as defaults. For example, if you produce both development snapshot releases and "stable" releases of a project, you may want to put the distributions in different places, or use different ``egg_info`` tagging options, etc. In these cases, it doesn't make sense to set the options in a distutils configuration file, because the values of the options changed based on what you're trying to do. Setuptools therefore allows you to define "aliases" - shortcut names for an arbitrary string of commands and options, using ``setup.py alias aliasname expansion``, where aliasname is the name of the new alias, and the remainder of the command line supplies its expansion. For example, this command defines a sitewide alias called "daily", that sets various ``egg_info`` tagging options:: setup.py alias --global-config daily egg_info --tag-svn-revision \ --tag-build=development Once the alias is defined, it can then be used with other setup commands, e.g.:: setup.py daily bdist_egg # generate a daily-build .egg file setup.py daily sdist # generate a daily-build source distro setup.py daily sdist bdist_egg # generate both The above commands are interpreted as if the word ``daily`` were replaced with ``egg_info --tag-svn-revision --tag-build=development``. Note that setuptools will expand each alias *at most once* in a given command line. This serves two purposes. First, if you accidentally create an alias loop, it will have no effect; you'll instead get an error message about an unknown command. Second, it allows you to define an alias for a command, that uses that command. For example, this (project-local) alias:: setup.py alias bdist_egg bdist_egg rotate -k1 -m.egg redefines the ``bdist_egg`` command so that it always runs the ``rotate`` command afterwards to delete all but the newest egg file. It doesn't loop indefinitely on ``bdist_egg`` because the alias is only expanded once when used. You can remove a defined alias with the ``--remove`` (or ``-r``) option, e.g.:: setup.py alias --global-config --remove daily would delete the "daily" alias we defined above. Aliases can be defined on a project-specific, per-user, or sitewide basis. The default is to define or remove a project-specific alias, but you can use any of the `configuration file options`_ (listed under the `saveopts`_ command, below) to determine which distutils configuration file an aliases will be added to (or removed from). Note that if you omit the "expansion" argument to the ``alias`` command, you'll get output showing that alias' current definition (and what configuration file it's defined in). If you omit the alias name as well, you'll get a listing of all current aliases along with their configuration file locations. ``bdist_egg`` - Create a Python Egg for the project =================================================== This command generates a Python Egg (``.egg`` file) for the project. Python Eggs are the preferred binary distribution format for EasyInstall, because they are cross-platform (for "pure" packages), directly importable, and contain project metadata including scripts and information about the project's dependencies. They can be simply downloaded and added to ``sys.path`` directly, or they can be placed in a directory on ``sys.path`` and then automatically discovered by the egg runtime system. This command runs the `egg_info`_ command (if it hasn't already run) to update the project's metadata (``.egg-info``) directory. If you have added any extra metadata files to the ``.egg-info`` directory, those files will be included in the new egg file's metadata directory, for use by the egg runtime system or by any applications or frameworks that use that metadata. You won't usually need to specify any special options for this command; just use ``bdist_egg`` and you're done. But there are a few options that may be occasionally useful: ``--dist-dir=DIR, -d DIR`` Set the directory where the ``.egg`` file will be placed. If you don't supply this, then the ``--dist-dir`` setting of the ``bdist`` command will be used, which is usually a directory named ``dist`` in the project directory. ``--plat-name=PLATFORM, -p PLATFORM`` Set the platform name string that will be embedded in the egg's filename (assuming the egg contains C extensions). This can be used to override the distutils default platform name with something more meaningful. Keep in mind, however, that the egg runtime system expects to see eggs with distutils platform names, so it may ignore or reject eggs with non-standard platform names. Similarly, the EasyInstall program may ignore them when searching web pages for download links. However, if you are cross-compiling or doing some other unusual things, you might find a use for this option. ``--exclude-source-files`` Don't include any modules' ``.py`` files in the egg, just compiled Python, C, and data files. (Note that this doesn't affect any ``.py`` files in the EGG-INFO directory or its subdirectories, since for example there may be scripts with a ``.py`` extension which must still be retained.) We don't recommend that you use this option except for packages that are being bundled for proprietary end-user applications, or for "embedded" scenarios where space is at an absolute premium. On the other hand, if your package is going to be installed and used in compressed form, you might as well exclude the source because Python's ``traceback`` module doesn't currently understand how to display zipped source code anyway, or how to deal with files that are in a different place from where their code was compiled. There are also some options you will probably never need, but which are there because they were copied from similar ``bdist`` commands used as an example for creating this one. They may be useful for testing and debugging, however, which is why we kept them: ``--keep-temp, -k`` Keep the contents of the ``--bdist-dir`` tree around after creating the ``.egg`` file. ``--bdist-dir=DIR, -b DIR`` Set the temporary directory for creating the distribution. The entire contents of this directory are zipped to create the ``.egg`` file, after running various installation commands to copy the package's modules, data, and extensions here. ``--skip-build`` Skip doing any "build" commands; just go straight to the install-and-compress phases. .. _develop: ``develop`` - Deploy the project source in "Development Mode" ============================================================= This command allows you to deploy your project's source for use in one or more "staging areas" where it will be available for importing. This deployment is done in such a way that changes to the project source are immediately available in the staging area(s), without needing to run a build or install step after each change. The ``develop`` command works by creating an ``.egg-link`` file (named for the project) in the given staging area. If the staging area is Python's ``site-packages`` directory, it also updates an ``easy-install.pth`` file so that the project is on ``sys.path`` by default for all programs run using that Python installation. The ``develop`` command also installs wrapper scripts in the staging area (or a separate directory, as specified) that will ensure the project's dependencies are available on ``sys.path`` before running the project's source scripts. And, it ensures that any missing project dependencies are available in the staging area, by downloading and installing them if necessary. Last, but not least, the ``develop`` command invokes the ``build_ext -i`` command to ensure any C extensions in the project have been built and are up-to-date, and the ``egg_info`` command to ensure the project's metadata is updated (so that the runtime and wrappers know what the project's dependencies are). If you make any changes to the project's setup script or C extensions, you should rerun the ``develop`` command against all relevant staging areas to keep the project's scripts, metadata and extensions up-to-date. Most other kinds of changes to your project should not require any build operations or rerunning ``develop``, but keep in mind that even minor changes to the setup script (e.g. changing an entry point definition) require you to re-run the ``develop`` or ``test`` commands to keep the distribution updated. Here are some of the options that the ``develop`` command accepts. Note that they affect the project's dependencies as well as the project itself, so if you have dependencies that need to be installed and you use ``--exclude-scripts`` (for example), the dependencies' scripts will not be installed either! For this reason, you may want to use EasyInstall to install the project's dependencies before using the ``develop`` command, if you need finer control over the installation options for dependencies. ``--uninstall, -u`` Un-deploy the current project. You may use the ``--install-dir`` or ``-d`` option to designate the staging area. The created ``.egg-link`` file will be removed, if present and it is still pointing to the project directory. The project directory will be removed from ``easy-install.pth`` if the staging area is Python's ``site-packages`` directory. Note that this option currently does *not* uninstall script wrappers! You must uninstall them yourself, or overwrite them by using EasyInstall to activate a different version of the package. You can also avoid installing script wrappers in the first place, if you use the ``--exclude-scripts`` (aka ``-x``) option when you run ``develop`` to deploy the project. ``--multi-version, -m`` "Multi-version" mode. Specifying this option prevents ``develop`` from adding an ``easy-install.pth`` entry for the project(s) being deployed, and if an entry for any version of a project already exists, the entry will be removed upon successful deployment. In multi-version mode, no specific version of the package is available for importing, unless you use ``pkg_resources.require()`` to put it on ``sys.path``, or you are running a wrapper script generated by ``setuptools`` or EasyInstall. (In which case the wrapper script calls ``require()`` for you.) Note that if you install to a directory other than ``site-packages``, this option is automatically in effect, because ``.pth`` files can only be used in ``site-packages`` (at least in Python 2.3 and 2.4). So, if you use the ``--install-dir`` or ``-d`` option (or they are set via configuration file(s)) your project and its dependencies will be deployed in multi- version mode. ``--install-dir=DIR, -d DIR`` Set the installation directory (staging area). If this option is not directly specified on the command line or in a distutils configuration file, the distutils default installation location is used. Normally, this will be the ``site-packages`` directory, but if you are using distutils configuration files, setting things like ``prefix`` or ``install_lib``, then those settings are taken into account when computing the default staging area. ``--script-dir=DIR, -s DIR`` Set the script installation directory. If you don't supply this option (via the command line or a configuration file), but you *have* supplied an ``--install-dir`` (via command line or config file), then this option defaults to the same directory, so that the scripts will be able to find their associated package installation. Otherwise, this setting defaults to the location where the distutils would normally install scripts, taking any distutils configuration file settings into account. ``--exclude-scripts, -x`` Don't deploy script wrappers. This is useful if you don't want to disturb existing versions of the scripts in the staging area. ``--always-copy, -a`` Copy all needed distributions to the staging area, even if they are already present in another directory on ``sys.path``. By default, if a requirement can be met using a distribution that is already available in a directory on ``sys.path``, it will not be copied to the staging area. ``--egg-path=DIR`` Force the generated ``.egg-link`` file to use a specified relative path to the source directory. This can be useful in circumstances where your installation directory is being shared by code running under multiple platforms (e.g. Mac and Windows) which have different absolute locations for the code under development, but the same *relative* locations with respect to the installation directory. If you use this option when installing, you must supply the same relative path when uninstalling. In addition to the above options, the ``develop`` command also accepts all of the same options accepted by ``easy_install``. If you've configured any ``easy_install`` settings in your ``setup.cfg`` (or other distutils config files), the ``develop`` command will use them as defaults, unless you override them in a ``[develop]`` section or on the command line. ``easy_install`` - Find and install packages ============================================ This command runs the `EasyInstall tool `_ for you. It is exactly equivalent to running the ``easy_install`` command. All command line arguments following this command are consumed and not processed further by the distutils, so this must be the last command listed on the command line. Please see the EasyInstall documentation for the options reference and usage examples. Normally, there is no reason to use this command via the command line, as you can just use ``easy_install`` directly. It's only listed here so that you know it's a distutils command, which means that you can: * create command aliases that use it, * create distutils extensions that invoke it as a subcommand, and * configure options for it in your ``setup.cfg`` or other distutils config files. .. _egg_info: ``egg_info`` - Create egg metadata and set build tags ===================================================== This command performs two operations: it updates a project's ``.egg-info`` metadata directory (used by the ``bdist_egg``, ``develop``, and ``test`` commands), and it allows you to temporarily change a project's version string, to support "daily builds" or "snapshot" releases. It is run automatically by the ``sdist``, ``bdist_egg``, ``develop``, ``register``, and ``test`` commands in order to update the project's metadata, but you can also specify it explicitly in order to temporarily change the project's version string while executing other commands. (It also generates the``.egg-info/SOURCES.txt`` manifest file, which is used when you are building source distributions.) In addition to writing the core egg metadata defined by ``setuptools`` and required by ``pkg_resources``, this command can be extended to write other metadata files as well, by defining entry points in the ``egg_info.writers`` group. See the section on `Adding new EGG-INFO Files`_ below for more details. Note that using additional metadata writers may require you to include a ``setup_requires`` argument to ``setup()`` in order to ensure that the desired writers are available on ``sys.path``. Release Tagging Options ----------------------- The following options can be used to modify the project's version string for all remaining commands on the setup command line. The options are processed in the order shown, so if you use more than one, the requested tags will be added in the following order: ``--tag-build=NAME, -b NAME`` Append NAME to the project's version string. Due to the way setuptools processes "pre-release" version suffixes beginning with the letters "a" through "e" (like "alpha", "beta", and "candidate"), you will usually want to use a tag like ".build" or ".dev", as this will cause the version number to be considered *lower* than the project's default version. (If you want to make the version number *higher* than the default version, you can always leave off --tag-build and then use one or both of the following options.) If you have a default build tag set in your ``setup.cfg``, you can suppress it on the command line using ``-b ""`` or ``--tag-build=""`` as an argument to the ``egg_info`` command. ``--tag-svn-revision, -r`` If the current directory is a Subversion checkout (i.e. has a ``.svn`` subdirectory, this appends a string of the form "-rNNNN" to the project's version string, where NNNN is the revision number of the most recent modification to the current directory, as obtained from the ``svn info`` command. If the current directory is not a Subversion checkout, the command will look for a ``PKG-INFO`` file instead, and try to find the revision number from that, by looking for a "-rNNNN" string at the end of the version number. (This is so that building a package from a source distribution of a Subversion snapshot will produce a binary with the correct version number.) If there is no ``PKG-INFO`` file, or the version number contained therein does not end with ``-r`` and a number, then ``-r0`` is used. ``--no-svn-revision, -R`` Don't include the Subversion revision in the version number. This option is included so you can override a default setting put in ``setup.cfg``. ``--tag-date, -d`` Add a date stamp of the form "-YYYYMMDD" (e.g. "-20050528") to the project's version number. ``--no-date, -D`` Don't include a date stamp in the version number. This option is included so you can override a default setting in ``setup.cfg``. (Note: Because these options modify the version number used for source and binary distributions of your project, you should first make sure that you know how the resulting version numbers will be interpreted by automated tools like EasyInstall. See the section above on `Specifying Your Project's Version`_ for an explanation of pre- and post-release tags, as well as tips on how to choose and verify a versioning scheme for your your project.) For advanced uses, there is one other option that can be set, to change the location of the project's ``.egg-info`` directory. Commands that need to find the project's source directory or metadata should get it from this setting: Other ``egg_info`` Options -------------------------- ``--egg-base=SOURCEDIR, -e SOURCEDIR`` Specify the directory that should contain the .egg-info directory. This should normally be the root of your project's source tree (which is not necessarily the same as your project directory; some projects use a ``src`` or ``lib`` subdirectory as the source root). You should not normally need to specify this directory, as it is normally determined from the ``package_dir`` argument to the ``setup()`` function, if any. If there is no ``package_dir`` set, this option defaults to the current directory. ``egg_info`` Examples --------------------- Creating a dated "nightly build" snapshot egg:: python setup.py egg_info --tag-date --tag-build=DEV bdist_egg Creating and uploading a release with no version tags, even if some default tags are specified in ``setup.cfg``:: python setup.py egg_info -RDb "" sdist bdist_egg register upload (Notice that ``egg_info`` must always appear on the command line *before* any commands that you want the version changes to apply to.) .. _install command: ``install`` - Run ``easy_install`` or old-style installation ============================================================ The setuptools ``install`` command is basically a shortcut to run the ``easy_install`` command on the current project. However, for convenience in creating "system packages" of setuptools-based projects, you can also use this option: ``--single-version-externally-managed`` This boolean option tells the ``install`` command to perform an "old style" installation, with the addition of an ``.egg-info`` directory so that the installed project will still have its metadata available and operate normally. If you use this option, you *must* also specify the ``--root`` or ``--record`` options (or both), because otherwise you will have no way to identify and remove the installed files. This option is automatically in effect when ``install`` is invoked by another distutils command, so that commands like ``bdist_wininst`` and ``bdist_rpm`` will create system packages of eggs. It is also automatically in effect if you specify the ``--root`` option. ``install_egg_info`` - Install an ``.egg-info`` directory in ``site-packages`` ============================================================================== Setuptools runs this command as part of ``install`` operations that use the ``--single-version-externally-managed`` options. You should not invoke it directly; it is documented here for completeness and so that distutils extensions such as system package builders can make use of it. This command has only one option: ``--install-dir=DIR, -d DIR`` The parent directory where the ``.egg-info`` directory will be placed. Defaults to the same as the ``--install-dir`` option specified for the ``install_lib`` command, which is usually the system ``site-packages`` directory. This command assumes that the ``egg_info`` command has been given valid options via the command line or ``setup.cfg``, as it will invoke the ``egg_info`` command and use its options to locate the project's source ``.egg-info`` directory. .. _rotate: ``rotate`` - Delete outdated distribution files =============================================== As you develop new versions of your project, your distribution (``dist``) directory will gradually fill up with older source and/or binary distribution files. The ``rotate`` command lets you automatically clean these up, keeping only the N most-recently modified files matching a given pattern. ``--match=PATTERNLIST, -m PATTERNLIST`` Comma-separated list of glob patterns to match. This option is *required*. The project name and ``-*`` is prepended to the supplied patterns, in order to match only distributions belonging to the current project (in case you have a shared distribution directory for multiple projects). Typically, you will use a glob pattern like ``.zip`` or ``.egg`` to match files of the specified type. Note that each supplied pattern is treated as a distinct group of files for purposes of selecting files to delete. ``--keep=COUNT, -k COUNT`` Number of matching distributions to keep. For each group of files identified by a pattern specified with the ``--match`` option, delete all but the COUNT most-recently-modified files in that group. This option is *required*. ``--dist-dir=DIR, -d DIR`` Directory where the distributions are. This defaults to the value of the ``bdist`` command's ``--dist-dir`` option, which will usually be the project's ``dist`` subdirectory. **Example 1**: Delete all .tar.gz files from the distribution directory, except for the 3 most recently modified ones:: setup.py rotate --match=.tar.gz --keep=3 **Example 2**: Delete all Python 2.3 or Python 2.4 eggs from the distribution directory, except the most recently modified one for each Python version:: setup.py rotate --match=-py2.3*.egg,-py2.4*.egg --keep=1 .. _saveopts: ``saveopts`` - Save used options to a configuration file ======================================================== Finding and editing ``distutils`` configuration files can be a pain, especially since you also have to translate the configuration options from command-line form to the proper configuration file format. You can avoid these hassles by using the ``saveopts`` command. Just add it to the command line to save the options you used. For example, this command builds the project using the ``mingw32`` C compiler, then saves the --compiler setting as the default for future builds (even those run implicitly by the ``install`` command):: setup.py build --compiler=mingw32 saveopts The ``saveopts`` command saves all options for every command specified on the command line to the project's local ``setup.cfg`` file, unless you use one of the `configuration file options`_ to change where the options are saved. For example, this command does the same as above, but saves the compiler setting to the site-wide (global) distutils configuration:: setup.py build --compiler=mingw32 saveopts -g Note that it doesn't matter where you place the ``saveopts`` command on the command line; it will still save all the options specified for all commands. For example, this is another valid way to spell the last example:: setup.py saveopts -g build --compiler=mingw32 Note, however, that all of the commands specified are always run, regardless of where ``saveopts`` is placed on the command line. Configuration File Options -------------------------- Normally, settings such as options and aliases are saved to the project's local ``setup.cfg`` file. But you can override this and save them to the global or per-user configuration files, or to a manually-specified filename. ``--global-config, -g`` Save settings to the global ``distutils.cfg`` file inside the ``distutils`` package directory. You must have write access to that directory to use this option. You also can't combine this option with ``-u`` or ``-f``. ``--user-config, -u`` Save settings to the current user's ``~/.pydistutils.cfg`` (POSIX) or ``$HOME/pydistutils.cfg`` (Windows) file. You can't combine this option with ``-g`` or ``-f``. ``--filename=FILENAME, -f FILENAME`` Save settings to the specified configuration file to use. You can't combine this option with ``-g`` or ``-u``. Note that if you specify a non-standard filename, the ``distutils`` and ``setuptools`` will not use the file's contents. This option is mainly included for use in testing. These options are used by other ``setuptools`` commands that modify configuration files, such as the `alias`_ and `setopt`_ commands. .. _setopt: ``setopt`` - Set a distutils or setuptools option in a config file ================================================================== This command is mainly for use by scripts, but it can also be used as a quick and dirty way to change a distutils configuration option without having to remember what file the options are in and then open an editor. **Example 1**. Set the default C compiler to ``mingw32`` (using long option names):: setup.py setopt --command=build --option=compiler --set-value=mingw32 **Example 2**. Remove any setting for the distutils default package installation directory (short option names):: setup.py setopt -c install -o install_lib -r Options for the ``setopt`` command: ``--command=COMMAND, -c COMMAND`` Command to set the option for. This option is required. ``--option=OPTION, -o OPTION`` The name of the option to set. This option is required. ``--set-value=VALUE, -s VALUE`` The value to set the option to. Not needed if ``-r`` or ``--remove`` is set. ``--remove, -r`` Remove (unset) the option, instead of setting it. In addition to the above options, you may use any of the `configuration file options`_ (listed under the `saveopts`_ command, above) to determine which distutils configuration file the option will be added to (or removed from). .. _test: ``test`` - Build package and run a unittest suite ================================================= When doing test-driven development, or running automated builds that need testing before they are deployed for downloading or use, it's often useful to be able to run a project's unit tests without actually deploying the project anywhere, even using the ``develop`` command. The ``test`` command runs a project's unit tests without actually deploying it, by temporarily putting the project's source on ``sys.path``, after first running ``build_ext -i`` and ``egg_info`` to ensure that any C extensions and project metadata are up-to-date. To use this command, your project's tests must be wrapped in a ``unittest`` test suite by either a function, a ``TestCase`` class or method, or a module or package containing ``TestCase`` classes. If the named suite is a module, and the module has an ``additional_tests()`` function, it is called and the result (which must be a ``unittest.TestSuite``) is added to the tests to be run. If the named suite is a package, any submodules and subpackages are recursively added to the overall test suite. (Note: if your project specifies a ``test_loader``, the rules for processing the chosen ``test_suite`` may differ; see the `test_loader`_ documentation for more details.) Note that many test systems including ``doctest`` support wrapping their non-``unittest`` tests in ``TestSuite`` objects. So, if you are using a test package that does not support this, we suggest you encourage its developers to implement test suite support, as this is a convenient and standard way to aggregate a collection of tests to be run under a common test harness. By default, tests will be run in the "verbose" mode of the ``unittest`` package's text test runner, but you can get the "quiet" mode (just dots) if you supply the ``-q`` or ``--quiet`` option, either as a global option to the setup script (e.g. ``setup.py -q test``) or as an option for the ``test`` command itself (e.g. ``setup.py test -q``). There is one other option available: ``--test-suite=NAME, -s NAME`` Specify the test suite (or module, class, or method) to be run (e.g. ``some_module.test_suite``). The default for this option can be set by giving a ``test_suite`` argument to the ``setup()`` function, e.g.:: setup( # ... test_suite = "my_package.tests.test_all" ) If you did not set a ``test_suite`` in your ``setup()`` call, and do not provide a ``--test-suite`` option, an error will occur. .. _upload: ``upload`` - Upload source and/or egg distributions to PyPI =========================================================== The ``upload`` command is implemented and `documented `_ in distutils. Setuptools augments the ``upload`` command with support for `keyring `_, allowing the password to be stored in a secure location and not in plaintext in the .pypirc file. To use keyring, first install keyring and set the password for the relevant repository, e.g.:: python -m keyring set Password for '' in '': ******** Then, in .pypirc, set the repository configuration as normal, but omit the password. Thereafter, uploads will use the password from the keyring. New in 20.1: Added keyring support. .. _upload_docs: ``upload_docs`` - Upload package documentation to PyPI ====================================================== PyPI now supports uploading project documentation to the dedicated URL https://pythonhosted.org//. The ``upload_docs`` command will create the necessary zip file out of a documentation directory and will post to the repository. Note that to upload the documentation of a project, the corresponding version must already be registered with PyPI, using the distutils ``register`` command -- just like the ``upload`` command. Assuming there is an ``Example`` project with documentation in the subdirectory ``docs``, e.g.:: Example/ |-- example.py |-- setup.cfg |-- setup.py |-- docs | |-- build | | `-- html | | | |-- index.html | | | `-- tips_tricks.html | |-- conf.py | |-- index.txt | `-- tips_tricks.txt You can simply pass the documentation directory path to the ``upload_docs`` command:: python setup.py upload_docs --upload-dir=docs/build/html If no ``--upload-dir`` is given, ``upload_docs`` will attempt to run the ``build_sphinx`` command to generate uploadable documentation. For the command to become available, `Sphinx `_ must be installed in the same environment as distribute. As with other ``setuptools``-based commands, you can define useful defaults in the ``setup.cfg`` of your Python project, e.g.: .. code-block:: ini [upload_docs] upload-dir = docs/build/html The ``upload_docs`` command has the following options: ``--upload-dir`` The directory to be uploaded to the repository. ``--show-response`` Display the full response text from server; this is useful for debugging PyPI problems. ``--repository=URL, -r URL`` The URL of the repository to upload to. Defaults to https://pypi.python.org/pypi (i.e., the main PyPI installation). -------------------------------- Extending and Reusing Setuptools -------------------------------- Creating ``distutils`` Extensions ================================= It can be hard to add new commands or setup arguments to the distutils. But the ``setuptools`` package makes it a bit easier, by allowing you to distribute a distutils extension as a separate project, and then have projects that need the extension just refer to it in their ``setup_requires`` argument. With ``setuptools``, your distutils extension projects can hook in new commands and ``setup()`` arguments just by defining "entry points". These are mappings from command or argument names to a specification of where to import a handler from. (See the section on `Dynamic Discovery of Services and Plugins`_ above for some more background on entry points.) Adding Commands --------------- You can add new ``setup`` commands by defining entry points in the ``distutils.commands`` group. For example, if you wanted to add a ``foo`` command, you might add something like this to your distutils extension project's setup script:: setup( # ... entry_points = { "distutils.commands": [ "foo = mypackage.some_module:foo", ], }, ) (Assuming, of course, that the ``foo`` class in ``mypackage.some_module`` is a ``setuptools.Command`` subclass.) Once a project containing such entry points has been activated on ``sys.path``, (e.g. by running "install" or "develop" with a site-packages installation directory) the command(s) will be available to any ``setuptools``-based setup scripts. It is not necessary to use the ``--command-packages`` option or to monkeypatch the ``distutils.command`` package to install your commands; ``setuptools`` automatically adds a wrapper to the distutils to search for entry points in the active distributions on ``sys.path``. In fact, this is how setuptools' own commands are installed: the setuptools project's setup script defines entry points for them! Adding ``setup()`` Arguments ---------------------------- Sometimes, your commands may need additional arguments to the ``setup()`` call. You can enable this by defining entry points in the ``distutils.setup_keywords`` group. For example, if you wanted a ``setup()`` argument called ``bar_baz``, you might add something like this to your distutils extension project's setup script:: setup( # ... entry_points = { "distutils.commands": [ "foo = mypackage.some_module:foo", ], "distutils.setup_keywords": [ "bar_baz = mypackage.some_module:validate_bar_baz", ], }, ) The idea here is that the entry point defines a function that will be called to validate the ``setup()`` argument, if it's supplied. The ``Distribution`` object will have the initial value of the attribute set to ``None``, and the validation function will only be called if the ``setup()`` call sets it to a non-None value. Here's an example validation function:: def assert_bool(dist, attr, value): """Verify that value is True, False, 0, or 1""" if bool(value) != value: raise DistutilsSetupError( "%r must be a boolean value (got %r)" % (attr,value) ) Your function should accept three arguments: the ``Distribution`` object, the attribute name, and the attribute value. It should raise a ``DistutilsSetupError`` (from the ``distutils.errors`` module) if the argument is invalid. Remember, your function will only be called with non-None values, and the default value of arguments defined this way is always None. So, your commands should always be prepared for the possibility that the attribute will be ``None`` when they access it later. If more than one active distribution defines an entry point for the same ``setup()`` argument, *all* of them will be called. This allows multiple distutils extensions to define a common argument, as long as they agree on what values of that argument are valid. Also note that as with commands, it is not necessary to subclass or monkeypatch the distutils ``Distribution`` class in order to add your arguments; it is sufficient to define the entry points in your extension, as long as any setup script using your extension lists your project in its ``setup_requires`` argument. Adding new EGG-INFO Files ------------------------- Some extensible applications or frameworks may want to allow third parties to develop plugins with application or framework-specific metadata included in the plugins' EGG-INFO directory, for easy access via the ``pkg_resources`` metadata API. The easiest way to allow this is to create a distutils extension to be used from the plugin projects' setup scripts (via ``setup_requires``) that defines a new setup keyword, and then uses that data to write an EGG-INFO file when the ``egg_info`` command is run. The ``egg_info`` command looks for extension points in an ``egg_info.writers`` group, and calls them to write the files. Here's a simple example of a distutils extension defining a setup argument ``foo_bar``, which is a list of lines that will be written to ``foo_bar.txt`` in the EGG-INFO directory of any project that uses the argument:: setup( # ... entry_points = { "distutils.setup_keywords": [ "foo_bar = setuptools.dist:assert_string_list", ], "egg_info.writers": [ "foo_bar.txt = setuptools.command.egg_info:write_arg", ], }, ) This simple example makes use of two utility functions defined by setuptools for its own use: a routine to validate that a setup keyword is a sequence of strings, and another one that looks up a setup argument and writes it to a file. Here's what the writer utility looks like:: def write_arg(cmd, basename, filename): argname = os.path.splitext(basename)[0] value = getattr(cmd.distribution, argname, None) if value is not None: value = '\n'.join(value)+'\n' cmd.write_or_delete_file(argname, filename, value) As you can see, ``egg_info.writers`` entry points must be a function taking three arguments: a ``egg_info`` command instance, the basename of the file to write (e.g. ``foo_bar.txt``), and the actual full filename that should be written to. In general, writer functions should honor the command object's ``dry_run`` setting when writing files, and use the ``distutils.log`` object to do any console output. The easiest way to conform to this requirement is to use the ``cmd`` object's ``write_file()``, ``delete_file()``, and ``write_or_delete_file()`` methods exclusively for your file operations. See those methods' docstrings for more details. Adding Support for Revision Control Systems ------------------------------------------------- If the files you want to include in the source distribution are tracked using Git, Mercurial or SVN, you can use the following packages to achieve that: - Git and Mercurial: `setuptools_scm `_ - SVN: `setuptools_svn `_ If you would like to create a plugin for ``setuptools`` to find files tracked by another revision control system, you can do so by adding an entry point to the ``setuptools.file_finders`` group. The entry point should be a function accepting a single directory name, and should yield all the filenames within that directory (and any subdirectories thereof) that are under revision control. For example, if you were going to create a plugin for a revision control system called "foobar", you would write a function something like this: .. code-block:: python def find_files_for_foobar(dirname): # loop to yield paths that start with `dirname` And you would register it in a setup script using something like this:: entry_points = { "setuptools.file_finders": [ "foobar = my_foobar_module:find_files_for_foobar" ] } Then, anyone who wants to use your plugin can simply install it, and their local setuptools installation will be able to find the necessary files. It is not necessary to distribute source control plugins with projects that simply use the other source control system, or to specify the plugins in ``setup_requires``. When you create a source distribution with the ``sdist`` command, setuptools automatically records what files were found in the ``SOURCES.txt`` file. That way, recipients of source distributions don't need to have revision control at all. However, if someone is working on a package by checking out with that system, they will need the same plugin(s) that the original author is using. A few important points for writing revision control file finders: * Your finder function MUST return relative paths, created by appending to the passed-in directory name. Absolute paths are NOT allowed, nor are relative paths that reference a parent directory of the passed-in directory. * Your finder function MUST accept an empty string as the directory name, meaning the current directory. You MUST NOT convert this to a dot; just yield relative paths. So, yielding a subdirectory named ``some/dir`` under the current directory should NOT be rendered as ``./some/dir`` or ``/somewhere/some/dir``, but *always* as simply ``some/dir`` * Your finder function SHOULD NOT raise any errors, and SHOULD deal gracefully with the absence of needed programs (i.e., ones belonging to the revision control system itself. It *may*, however, use ``distutils.log.warn()`` to inform the user of the missing program(s). Subclassing ``Command`` ----------------------- Sorry, this section isn't written yet, and neither is a lot of what's below this point. XXX Reusing ``setuptools`` Code =========================== ``ez_setup`` ------------ XXX ``setuptools.archive_util`` --------------------------- XXX ``setuptools.sandbox`` ---------------------- XXX ``setuptools.package_index`` ---------------------------- XXX Mailing List and Bug Tracker ============================ Please use the `distutils-sig mailing list`_ for questions and discussion about setuptools, and the `setuptools bug tracker`_ ONLY for issues you have confirmed via the list are actual bugs, and which you have reduced to a minimal set of steps to reproduce. .. _distutils-sig mailing list: http://mail.python.org/pipermail/distutils-sig/ .. _setuptools bug tracker: https://github.com/pypa/setuptools/ setuptools-20.7.0/pkg_resources/0000775000175000017500000000000012702524134017540 5ustar travistravis00000000000000setuptools-20.7.0/pkg_resources/_vendor/0000775000175000017500000000000012702524134021174 5ustar travistravis00000000000000setuptools-20.7.0/pkg_resources/_vendor/packaging/0000775000175000017500000000000012702524134023120 5ustar travistravis00000000000000setuptools-20.7.0/pkg_resources/_vendor/packaging/__about__.py0000664000175000017500000000132012702524020025366 0ustar travistravis00000000000000# This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import absolute_import, division, print_function __all__ = [ "__title__", "__summary__", "__uri__", "__version__", "__author__", "__email__", "__license__", "__copyright__", ] __title__ = "packaging" __summary__ = "Core utilities for Python packages" __uri__ = "https://github.com/pypa/packaging" __version__ = "16.6" __author__ = "Donald Stufft and individual contributors" __email__ = "donald@stufft.io" __license__ = "BSD or Apache License, Version 2.0" __copyright__ = "Copyright 2014-2016 %s" % __author__ setuptools-20.7.0/pkg_resources/_vendor/packaging/__init__.py0000664000175000017500000000100112702524020025213 0ustar travistravis00000000000000# This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import absolute_import, division, print_function from .__about__ import ( __author__, __copyright__, __email__, __license__, __summary__, __title__, __uri__, __version__ ) __all__ = [ "__title__", "__summary__", "__uri__", "__version__", "__author__", "__email__", "__license__", "__copyright__", ] setuptools-20.7.0/pkg_resources/_vendor/packaging/_compat.py0000664000175000017500000000153412702524020025111 0ustar travistravis00000000000000# This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import absolute_import, division, print_function import sys PY2 = sys.version_info[0] == 2 PY3 = sys.version_info[0] == 3 # flake8: noqa if PY3: string_types = str, else: string_types = basestring, def with_metaclass(meta, *bases): """ Create a base class with a metaclass. """ # This requires a bit of explanation: the basic idea is to make a dummy # metaclass for one level of class instantiation that replaces itself with # the actual metaclass. class metaclass(meta): def __new__(cls, name, this_bases, d): return meta(name, bases, d) return type.__new__(metaclass, 'temporary_class', (), {}) setuptools-20.7.0/pkg_resources/_vendor/packaging/_structures.py0000664000175000017500000000261012702524020026045 0ustar travistravis00000000000000# This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import absolute_import, division, print_function class Infinity(object): def __repr__(self): return "Infinity" def __hash__(self): return hash(repr(self)) def __lt__(self, other): return False def __le__(self, other): return False def __eq__(self, other): return isinstance(other, self.__class__) def __ne__(self, other): return not isinstance(other, self.__class__) def __gt__(self, other): return True def __ge__(self, other): return True def __neg__(self): return NegativeInfinity Infinity = Infinity() class NegativeInfinity(object): def __repr__(self): return "-Infinity" def __hash__(self): return hash(repr(self)) def __lt__(self, other): return True def __le__(self, other): return True def __eq__(self, other): return isinstance(other, self.__class__) def __ne__(self, other): return not isinstance(other, self.__class__) def __gt__(self, other): return False def __ge__(self, other): return False def __neg__(self): return Infinity NegativeInfinity = NegativeInfinity() setuptools-20.7.0/pkg_resources/_vendor/packaging/markers.py0000664000175000017500000001662512702524020025142 0ustar travistravis00000000000000# This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import absolute_import, division, print_function import operator import os import platform import sys from pkg_resources.extern.pyparsing import ParseException, ParseResults, stringStart, stringEnd from pkg_resources.extern.pyparsing import ZeroOrMore, Group, Forward, QuotedString from pkg_resources.extern.pyparsing import Literal as L # noqa from ._compat import string_types from .specifiers import Specifier, InvalidSpecifier __all__ = [ "InvalidMarker", "UndefinedComparison", "UndefinedEnvironmentName", "Marker", "default_environment", ] class InvalidMarker(ValueError): """ An invalid marker was found, users should refer to PEP 508. """ class UndefinedComparison(ValueError): """ An invalid operation was attempted on a value that doesn't support it. """ class UndefinedEnvironmentName(ValueError): """ A name was attempted to be used that does not exist inside of the environment. """ class Node(object): def __init__(self, value): self.value = value def __str__(self): return str(self.value) def __repr__(self): return "<{0}({1!r})>".format(self.__class__.__name__, str(self)) class Variable(Node): pass class Value(Node): pass VARIABLE = ( L("implementation_version") | L("platform_python_implementation") | L("implementation_name") | L("python_full_version") | L("platform_release") | L("platform_version") | L("platform_machine") | L("platform_system") | L("python_version") | L("sys_platform") | L("os_name") | L("os.name") | # PEP-345 L("sys.platform") | # PEP-345 L("platform.version") | # PEP-345 L("platform.machine") | # PEP-345 L("platform.python_implementation") | # PEP-345 L("extra") ) VARIABLE.setParseAction(lambda s, l, t: Variable(t[0].replace('.', '_'))) VERSION_CMP = ( L("===") | L("==") | L(">=") | L("<=") | L("!=") | L("~=") | L(">") | L("<") ) MARKER_OP = VERSION_CMP | L("not in") | L("in") MARKER_VALUE = QuotedString("'") | QuotedString('"') MARKER_VALUE.setParseAction(lambda s, l, t: Value(t[0])) BOOLOP = L("and") | L("or") MARKER_VAR = VARIABLE | MARKER_VALUE MARKER_ITEM = Group(MARKER_VAR + MARKER_OP + MARKER_VAR) MARKER_ITEM.setParseAction(lambda s, l, t: tuple(t[0])) LPAREN = L("(").suppress() RPAREN = L(")").suppress() MARKER_EXPR = Forward() MARKER_ATOM = MARKER_ITEM | Group(LPAREN + MARKER_EXPR + RPAREN) MARKER_EXPR << MARKER_ATOM + ZeroOrMore(BOOLOP + MARKER_EXPR) MARKER = stringStart + MARKER_EXPR + stringEnd def _coerce_parse_result(results): if isinstance(results, ParseResults): return [_coerce_parse_result(i) for i in results] else: return results def _format_marker(marker, first=True): assert isinstance(marker, (list, tuple, string_types)) # Sometimes we have a structure like [[...]] which is a single item list # where the single item is itself it's own list. In that case we want skip # the rest of this function so that we don't get extraneous () on the # outside. if (isinstance(marker, list) and len(marker) == 1 and isinstance(marker[0], (list, tuple))): return _format_marker(marker[0]) if isinstance(marker, list): inner = (_format_marker(m, first=False) for m in marker) if first: return " ".join(inner) else: return "(" + " ".join(inner) + ")" elif isinstance(marker, tuple): return '{0} {1} "{2}"'.format(*marker) else: return marker _operators = { "in": lambda lhs, rhs: lhs in rhs, "not in": lambda lhs, rhs: lhs not in rhs, "<": operator.lt, "<=": operator.le, "==": operator.eq, "!=": operator.ne, ">=": operator.ge, ">": operator.gt, } def _eval_op(lhs, op, rhs): try: spec = Specifier("".join([op, rhs])) except InvalidSpecifier: pass else: return spec.contains(lhs) oper = _operators.get(op) if oper is None: raise UndefinedComparison( "Undefined {0!r} on {1!r} and {2!r}.".format(op, lhs, rhs) ) return oper(lhs, rhs) _undefined = object() def _get_env(environment, name): value = environment.get(name, _undefined) if value is _undefined: raise UndefinedEnvironmentName( "{0!r} does not exist in evaluation environment.".format(name) ) return value def _evaluate_markers(markers, environment): groups = [[]] for marker in markers: assert isinstance(marker, (list, tuple, string_types)) if isinstance(marker, list): groups[-1].append(_evaluate_markers(marker, environment)) elif isinstance(marker, tuple): lhs, op, rhs = marker if isinstance(lhs, Variable): lhs_value = _get_env(environment, lhs.value) rhs_value = rhs.value else: lhs_value = lhs.value rhs_value = _get_env(environment, rhs.value) groups[-1].append(_eval_op(lhs_value, op, rhs_value)) else: assert marker in ["and", "or"] if marker == "or": groups.append([]) return any(all(item) for item in groups) def format_full_version(info): version = '{0.major}.{0.minor}.{0.micro}'.format(info) kind = info.releaselevel if kind != 'final': version += kind[0] + str(info.serial) return version def default_environment(): if hasattr(sys, 'implementation'): iver = format_full_version(sys.implementation.version) implementation_name = sys.implementation.name else: iver = '0' implementation_name = '' return { "implementation_name": implementation_name, "implementation_version": iver, "os_name": os.name, "platform_machine": platform.machine(), "platform_release": platform.release(), "platform_system": platform.system(), "platform_version": platform.version(), "python_full_version": platform.python_version(), "platform_python_implementation": platform.python_implementation(), "python_version": platform.python_version()[:3], "sys_platform": sys.platform, } class Marker(object): def __init__(self, marker): try: self._markers = _coerce_parse_result(MARKER.parseString(marker)) except ParseException as e: err_str = "Invalid marker: {0!r}, parse error at {1!r}".format( marker, marker[e.loc:e.loc + 8]) raise InvalidMarker(err_str) def __str__(self): return _format_marker(self._markers) def __repr__(self): return "".format(str(self)) def evaluate(self, environment=None): """Evaluate a marker. Return the boolean from evaluating the given marker against the environment. environment is an optional argument to override all or part of the determined environment. The environment is determined from the current Python process. """ current_environment = default_environment() if environment is not None: current_environment.update(environment) return _evaluate_markers(self._markers, current_environment) setuptools-20.7.0/pkg_resources/_vendor/packaging/requirements.py0000664000175000017500000001040312702524020026205 0ustar travistravis00000000000000# This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import absolute_import, division, print_function import string import re from pkg_resources.extern.pyparsing import stringStart, stringEnd, originalTextFor, ParseException from pkg_resources.extern.pyparsing import ZeroOrMore, Word, Optional, Regex, Combine from pkg_resources.extern.pyparsing import Literal as L # noqa from pkg_resources.extern.six.moves.urllib import parse as urlparse from .markers import MARKER_EXPR, Marker from .specifiers import LegacySpecifier, Specifier, SpecifierSet class InvalidRequirement(ValueError): """ An invalid requirement was found, users should refer to PEP 508. """ ALPHANUM = Word(string.ascii_letters + string.digits) LBRACKET = L("[").suppress() RBRACKET = L("]").suppress() LPAREN = L("(").suppress() RPAREN = L(")").suppress() COMMA = L(",").suppress() SEMICOLON = L(";").suppress() AT = L("@").suppress() PUNCTUATION = Word("-_.") IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM) IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END)) NAME = IDENTIFIER("name") EXTRA = IDENTIFIER URI = Regex(r'[^ ]+')("url") URL = (AT + URI) EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA) EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras") VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE) VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE) VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY VERSION_MANY = Combine(VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE), joinString=",", adjacent=False)("_raw_spec") _VERSION_SPEC = Optional(((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY)) _VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or '') VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier") VERSION_SPEC.setParseAction(lambda s, l, t: t[1]) MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker") MARKER_EXPR.setParseAction( lambda s, l, t: Marker(s[t._original_start:t._original_end]) ) MARKER_SEPERATOR = SEMICOLON MARKER = MARKER_SEPERATOR + MARKER_EXPR VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER) URL_AND_MARKER = URL + Optional(MARKER) NAMED_REQUIREMENT = \ NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER) REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd class Requirement(object): """Parse a requirement. Parse a given requirement string into its parts, such as name, specifier, URL, and extras. Raises InvalidRequirement on a badly-formed requirement string. """ # TODO: Can we test whether something is contained within a requirement? # If so how do we do that? Do we need to test against the _name_ of # the thing as well as the version? What about the markers? # TODO: Can we normalize the name and extra name? def __init__(self, requirement_string): try: req = REQUIREMENT.parseString(requirement_string) except ParseException as e: raise InvalidRequirement( "Invalid requirement, parse error at \"{0!r}\"".format( requirement_string[e.loc:e.loc + 8])) self.name = req.name if req.url: parsed_url = urlparse.urlparse(req.url) if not (parsed_url.scheme and parsed_url.netloc) or ( not parsed_url.scheme and not parsed_url.netloc): raise InvalidRequirement("Invalid URL given") self.url = req.url else: self.url = None self.extras = set(req.extras.asList() if req.extras else []) self.specifier = SpecifierSet(req.specifier) self.marker = req.marker if req.marker else None def __str__(self): parts = [self.name] if self.extras: parts.append("[{0}]".format(",".join(sorted(self.extras)))) if self.specifier: parts.append(str(self.specifier)) if self.url: parts.append("@ {0}".format(self.url)) if self.marker: parts.append("; {0}".format(self.marker)) return "".join(parts) def __repr__(self): return "".format(str(self)) setuptools-20.7.0/pkg_resources/_vendor/packaging/specifiers.py0000664000175000017500000006657112702524020025637 0ustar travistravis00000000000000# This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import absolute_import, division, print_function import abc import functools import itertools import re from ._compat import string_types, with_metaclass from .version import Version, LegacyVersion, parse class InvalidSpecifier(ValueError): """ An invalid specifier was found, users should refer to PEP 440. """ class BaseSpecifier(with_metaclass(abc.ABCMeta, object)): @abc.abstractmethod def __str__(self): """ Returns the str representation of this Specifier like object. This should be representative of the Specifier itself. """ @abc.abstractmethod def __hash__(self): """ Returns a hash value for this Specifier like object. """ @abc.abstractmethod def __eq__(self, other): """ Returns a boolean representing whether or not the two Specifier like objects are equal. """ @abc.abstractmethod def __ne__(self, other): """ Returns a boolean representing whether or not the two Specifier like objects are not equal. """ @abc.abstractproperty def prereleases(self): """ Returns whether or not pre-releases as a whole are allowed by this specifier. """ @prereleases.setter def prereleases(self, value): """ Sets whether or not pre-releases as a whole are allowed by this specifier. """ @abc.abstractmethod def contains(self, item, prereleases=None): """ Determines if the given item is contained within this specifier. """ @abc.abstractmethod def filter(self, iterable, prereleases=None): """ Takes an iterable of items and filters them so that only items which are contained within this specifier are allowed in it. """ class _IndividualSpecifier(BaseSpecifier): _operators = {} def __init__(self, spec="", prereleases=None): match = self._regex.search(spec) if not match: raise InvalidSpecifier("Invalid specifier: '{0}'".format(spec)) self._spec = ( match.group("operator").strip(), match.group("version").strip(), ) # Store whether or not this Specifier should accept prereleases self._prereleases = prereleases def __repr__(self): pre = ( ", prereleases={0!r}".format(self.prereleases) if self._prereleases is not None else "" ) return "<{0}({1!r}{2})>".format( self.__class__.__name__, str(self), pre, ) def __str__(self): return "{0}{1}".format(*self._spec) def __hash__(self): return hash(self._spec) def __eq__(self, other): if isinstance(other, string_types): try: other = self.__class__(other) except InvalidSpecifier: return NotImplemented elif not isinstance(other, self.__class__): return NotImplemented return self._spec == other._spec def __ne__(self, other): if isinstance(other, string_types): try: other = self.__class__(other) except InvalidSpecifier: return NotImplemented elif not isinstance(other, self.__class__): return NotImplemented return self._spec != other._spec def _get_operator(self, op): return getattr(self, "_compare_{0}".format(self._operators[op])) def _coerce_version(self, version): if not isinstance(version, (LegacyVersion, Version)): version = parse(version) return version @property def operator(self): return self._spec[0] @property def version(self): return self._spec[1] @property def prereleases(self): return self._prereleases @prereleases.setter def prereleases(self, value): self._prereleases = value def __contains__(self, item): return self.contains(item) def contains(self, item, prereleases=None): # Determine if prereleases are to be allowed or not. if prereleases is None: prereleases = self.prereleases # Normalize item to a Version or LegacyVersion, this allows us to have # a shortcut for ``"2.0" in Specifier(">=2") item = self._coerce_version(item) # Determine if we should be supporting prereleases in this specifier # or not, if we do not support prereleases than we can short circuit # logic if this version is a prereleases. if item.is_prerelease and not prereleases: return False # Actually do the comparison to determine if this item is contained # within this Specifier or not. return self._get_operator(self.operator)(item, self.version) def filter(self, iterable, prereleases=None): yielded = False found_prereleases = [] kw = {"prereleases": prereleases if prereleases is not None else True} # Attempt to iterate over all the values in the iterable and if any of # them match, yield them. for version in iterable: parsed_version = self._coerce_version(version) if self.contains(parsed_version, **kw): # If our version is a prerelease, and we were not set to allow # prereleases, then we'll store it for later incase nothing # else matches this specifier. if (parsed_version.is_prerelease and not (prereleases or self.prereleases)): found_prereleases.append(version) # Either this is not a prerelease, or we should have been # accepting prereleases from the begining. else: yielded = True yield version # Now that we've iterated over everything, determine if we've yielded # any values, and if we have not and we have any prereleases stored up # then we will go ahead and yield the prereleases. if not yielded and found_prereleases: for version in found_prereleases: yield version class LegacySpecifier(_IndividualSpecifier): _regex_str = ( r""" (?P(==|!=|<=|>=|<|>)) \s* (?P [^,;\s)]* # Since this is a "legacy" specifier, and the version # string can be just about anything, we match everything # except for whitespace, a semi-colon for marker support, # a closing paren since versions can be enclosed in # them, and a comma since it's a version separator. ) """ ) _regex = re.compile( r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE) _operators = { "==": "equal", "!=": "not_equal", "<=": "less_than_equal", ">=": "greater_than_equal", "<": "less_than", ">": "greater_than", } def _coerce_version(self, version): if not isinstance(version, LegacyVersion): version = LegacyVersion(str(version)) return version def _compare_equal(self, prospective, spec): return prospective == self._coerce_version(spec) def _compare_not_equal(self, prospective, spec): return prospective != self._coerce_version(spec) def _compare_less_than_equal(self, prospective, spec): return prospective <= self._coerce_version(spec) def _compare_greater_than_equal(self, prospective, spec): return prospective >= self._coerce_version(spec) def _compare_less_than(self, prospective, spec): return prospective < self._coerce_version(spec) def _compare_greater_than(self, prospective, spec): return prospective > self._coerce_version(spec) def _require_version_compare(fn): @functools.wraps(fn) def wrapped(self, prospective, spec): if not isinstance(prospective, Version): return False return fn(self, prospective, spec) return wrapped class Specifier(_IndividualSpecifier): _regex_str = ( r""" (?P(~=|==|!=|<=|>=|<|>|===)) (?P (?: # The identity operators allow for an escape hatch that will # do an exact string match of the version you wish to install. # This will not be parsed by PEP 440 and we cannot determine # any semantic meaning from it. This operator is discouraged # but included entirely as an escape hatch. (?<====) # Only match for the identity operator \s* [^\s]* # We just match everything, except for whitespace # since we are only testing for strict identity. ) | (?: # The (non)equality operators allow for wild card and local # versions to be specified so we have to define these two # operators separately to enable that. (?<===|!=) # Only match for equals and not equals \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release (?: # pre release [-_\.]? (a|b|c|rc|alpha|beta|pre|preview) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? # You cannot use a wild card and a dev or local version # together so group them with a | and make them optional. (?: (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local | \.\* # Wild card syntax of .* )? ) | (?: # The compatible operator requires at least two digits in the # release segment. (?<=~=) # Only match for the compatible operator \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *) (?: # pre release [-_\.]? (a|b|c|rc|alpha|beta|pre|preview) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) | (?: # All other operators only allow a sub set of what the # (non)equality operators do. Specifically they do not allow # local versions to be specified nor do they allow the prefix # matching wild cards. (?=": "greater_than_equal", "<": "less_than", ">": "greater_than", "===": "arbitrary", } @_require_version_compare def _compare_compatible(self, prospective, spec): # Compatible releases have an equivalent combination of >= and ==. That # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to # implement this in terms of the other specifiers instead of # implementing it ourselves. The only thing we need to do is construct # the other specifiers. # We want everything but the last item in the version, but we want to # ignore post and dev releases and we want to treat the pre-release as # it's own separate segment. prefix = ".".join( list( itertools.takewhile( lambda x: (not x.startswith("post") and not x.startswith("dev")), _version_split(spec), ) )[:-1] ) # Add the prefix notation to the end of our string prefix += ".*" return (self._get_operator(">=")(prospective, spec) and self._get_operator("==")(prospective, prefix)) @_require_version_compare def _compare_equal(self, prospective, spec): # We need special logic to handle prefix matching if spec.endswith(".*"): # In the case of prefix matching we want to ignore local segment. prospective = Version(prospective.public) # Split the spec out by dots, and pretend that there is an implicit # dot in between a release segment and a pre-release segment. spec = _version_split(spec[:-2]) # Remove the trailing .* # Split the prospective version out by dots, and pretend that there # is an implicit dot in between a release segment and a pre-release # segment. prospective = _version_split(str(prospective)) # Shorten the prospective version to be the same length as the spec # so that we can determine if the specifier is a prefix of the # prospective version or not. prospective = prospective[:len(spec)] # Pad out our two sides with zeros so that they both equal the same # length. spec, prospective = _pad_version(spec, prospective) else: # Convert our spec string into a Version spec = Version(spec) # If the specifier does not have a local segment, then we want to # act as if the prospective version also does not have a local # segment. if not spec.local: prospective = Version(prospective.public) return prospective == spec @_require_version_compare def _compare_not_equal(self, prospective, spec): return not self._compare_equal(prospective, spec) @_require_version_compare def _compare_less_than_equal(self, prospective, spec): return prospective <= Version(spec) @_require_version_compare def _compare_greater_than_equal(self, prospective, spec): return prospective >= Version(spec) @_require_version_compare def _compare_less_than(self, prospective, spec): # Convert our spec to a Version instance, since we'll want to work with # it as a version. spec = Version(spec) # Check to see if the prospective version is less than the spec # version. If it's not we can short circuit and just return False now # instead of doing extra unneeded work. if not prospective < spec: return False # This special case is here so that, unless the specifier itself # includes is a pre-release version, that we do not accept pre-release # versions for the version mentioned in the specifier (e.g. <3.1 should # not match 3.1.dev0, but should match 3.0.dev0). if not spec.is_prerelease and prospective.is_prerelease: if Version(prospective.base_version) == Version(spec.base_version): return False # If we've gotten to here, it means that prospective version is both # less than the spec version *and* it's not a pre-release of the same # version in the spec. return True @_require_version_compare def _compare_greater_than(self, prospective, spec): # Convert our spec to a Version instance, since we'll want to work with # it as a version. spec = Version(spec) # Check to see if the prospective version is greater than the spec # version. If it's not we can short circuit and just return False now # instead of doing extra unneeded work. if not prospective > spec: return False # This special case is here so that, unless the specifier itself # includes is a post-release version, that we do not accept # post-release versions for the version mentioned in the specifier # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0). if not spec.is_postrelease and prospective.is_postrelease: if Version(prospective.base_version) == Version(spec.base_version): return False # Ensure that we do not allow a local version of the version mentioned # in the specifier, which is techincally greater than, to match. if prospective.local is not None: if Version(prospective.base_version) == Version(spec.base_version): return False # If we've gotten to here, it means that prospective version is both # greater than the spec version *and* it's not a pre-release of the # same version in the spec. return True def _compare_arbitrary(self, prospective, spec): return str(prospective).lower() == str(spec).lower() @property def prereleases(self): # If there is an explicit prereleases set for this, then we'll just # blindly use that. if self._prereleases is not None: return self._prereleases # Look at all of our specifiers and determine if they are inclusive # operators, and if they are if they are including an explicit # prerelease. operator, version = self._spec if operator in ["==", ">=", "<=", "~=", "==="]: # The == specifier can include a trailing .*, if it does we # want to remove before parsing. if operator == "==" and version.endswith(".*"): version = version[:-2] # Parse the version, and if it is a pre-release than this # specifier allows pre-releases. if parse(version).is_prerelease: return True return False @prereleases.setter def prereleases(self, value): self._prereleases = value _prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$") def _version_split(version): result = [] for item in version.split("."): match = _prefix_regex.search(item) if match: result.extend(match.groups()) else: result.append(item) return result def _pad_version(left, right): left_split, right_split = [], [] # Get the release segment of our versions left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left))) right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right))) # Get the rest of our versions left_split.append(left[len(left_split[0]):]) right_split.append(right[len(right_split[0]):]) # Insert our padding left_split.insert( 1, ["0"] * max(0, len(right_split[0]) - len(left_split[0])), ) right_split.insert( 1, ["0"] * max(0, len(left_split[0]) - len(right_split[0])), ) return ( list(itertools.chain(*left_split)), list(itertools.chain(*right_split)), ) class SpecifierSet(BaseSpecifier): def __init__(self, specifiers="", prereleases=None): # Split on , to break each indidivual specifier into it's own item, and # strip each item to remove leading/trailing whitespace. specifiers = [s.strip() for s in specifiers.split(",") if s.strip()] # Parsed each individual specifier, attempting first to make it a # Specifier and falling back to a LegacySpecifier. parsed = set() for specifier in specifiers: try: parsed.add(Specifier(specifier)) except InvalidSpecifier: parsed.add(LegacySpecifier(specifier)) # Turn our parsed specifiers into a frozen set and save them for later. self._specs = frozenset(parsed) # Store our prereleases value so we can use it later to determine if # we accept prereleases or not. self._prereleases = prereleases def __repr__(self): pre = ( ", prereleases={0!r}".format(self.prereleases) if self._prereleases is not None else "" ) return "".format(str(self), pre) def __str__(self): return ",".join(sorted(str(s) for s in self._specs)) def __hash__(self): return hash(self._specs) def __and__(self, other): if isinstance(other, string_types): other = SpecifierSet(other) elif not isinstance(other, SpecifierSet): return NotImplemented specifier = SpecifierSet() specifier._specs = frozenset(self._specs | other._specs) if self._prereleases is None and other._prereleases is not None: specifier._prereleases = other._prereleases elif self._prereleases is not None and other._prereleases is None: specifier._prereleases = self._prereleases elif self._prereleases == other._prereleases: specifier._prereleases = self._prereleases else: raise ValueError( "Cannot combine SpecifierSets with True and False prerelease " "overrides." ) return specifier def __eq__(self, other): if isinstance(other, string_types): other = SpecifierSet(other) elif isinstance(other, _IndividualSpecifier): other = SpecifierSet(str(other)) elif not isinstance(other, SpecifierSet): return NotImplemented return self._specs == other._specs def __ne__(self, other): if isinstance(other, string_types): other = SpecifierSet(other) elif isinstance(other, _IndividualSpecifier): other = SpecifierSet(str(other)) elif not isinstance(other, SpecifierSet): return NotImplemented return self._specs != other._specs def __len__(self): return len(self._specs) def __iter__(self): return iter(self._specs) @property def prereleases(self): # If we have been given an explicit prerelease modifier, then we'll # pass that through here. if self._prereleases is not None: return self._prereleases # If we don't have any specifiers, and we don't have a forced value, # then we'll just return None since we don't know if this should have # pre-releases or not. if not self._specs: return None # Otherwise we'll see if any of the given specifiers accept # prereleases, if any of them do we'll return True, otherwise False. return any(s.prereleases for s in self._specs) @prereleases.setter def prereleases(self, value): self._prereleases = value def __contains__(self, item): return self.contains(item) def contains(self, item, prereleases=None): # Ensure that our item is a Version or LegacyVersion instance. if not isinstance(item, (LegacyVersion, Version)): item = parse(item) # Determine if we're forcing a prerelease or not, if we're not forcing # one for this particular filter call, then we'll use whatever the # SpecifierSet thinks for whether or not we should support prereleases. if prereleases is None: prereleases = self.prereleases # We can determine if we're going to allow pre-releases by looking to # see if any of the underlying items supports them. If none of them do # and this item is a pre-release then we do not allow it and we can # short circuit that here. # Note: This means that 1.0.dev1 would not be contained in something # like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0 if not prereleases and item.is_prerelease: return False # We simply dispatch to the underlying specs here to make sure that the # given version is contained within all of them. # Note: This use of all() here means that an empty set of specifiers # will always return True, this is an explicit design decision. return all( s.contains(item, prereleases=prereleases) for s in self._specs ) def filter(self, iterable, prereleases=None): # Determine if we're forcing a prerelease or not, if we're not forcing # one for this particular filter call, then we'll use whatever the # SpecifierSet thinks for whether or not we should support prereleases. if prereleases is None: prereleases = self.prereleases # If we have any specifiers, then we want to wrap our iterable in the # filter method for each one, this will act as a logical AND amongst # each specifier. if self._specs: for spec in self._specs: iterable = spec.filter(iterable, prereleases=bool(prereleases)) return iterable # If we do not have any specifiers, then we need to have a rough filter # which will filter out any pre-releases, unless there are no final # releases, and which will filter out LegacyVersion in general. else: filtered = [] found_prereleases = [] for item in iterable: # Ensure that we some kind of Version class for this item. if not isinstance(item, (LegacyVersion, Version)): parsed_version = parse(item) else: parsed_version = item # Filter out any item which is parsed as a LegacyVersion if isinstance(parsed_version, LegacyVersion): continue # Store any item which is a pre-release for later unless we've # already found a final version or we are accepting prereleases if parsed_version.is_prerelease and not prereleases: if not filtered: found_prereleases.append(item) else: filtered.append(item) # If we've found no items except for pre-releases, then we'll go # ahead and use the pre-releases if not filtered and found_prereleases and prereleases is None: return found_prereleases return filtered setuptools-20.7.0/pkg_resources/_vendor/packaging/utils.py0000664000175000017500000000064512702524020024631 0ustar travistravis00000000000000# This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import absolute_import, division, print_function import re _canonicalize_regex = re.compile(r"[-_.]+") def canonicalize_name(name): # This is taken from PEP 503. return _canonicalize_regex.sub("-", name).lower() setuptools-20.7.0/pkg_resources/_vendor/packaging/version.py0000664000175000017500000002644412702524020025163 0ustar travistravis00000000000000# This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import absolute_import, division, print_function import collections import itertools import re from ._structures import Infinity __all__ = [ "parse", "Version", "LegacyVersion", "InvalidVersion", "VERSION_PATTERN" ] _Version = collections.namedtuple( "_Version", ["epoch", "release", "dev", "pre", "post", "local"], ) def parse(version): """ Parse the given version string and return either a :class:`Version` object or a :class:`LegacyVersion` object depending on if the given version is a valid PEP 440 version or a legacy version. """ try: return Version(version) except InvalidVersion: return LegacyVersion(version) class InvalidVersion(ValueError): """ An invalid version was found, users should refer to PEP 440. """ class _BaseVersion(object): def __hash__(self): return hash(self._key) def __lt__(self, other): return self._compare(other, lambda s, o: s < o) def __le__(self, other): return self._compare(other, lambda s, o: s <= o) def __eq__(self, other): return self._compare(other, lambda s, o: s == o) def __ge__(self, other): return self._compare(other, lambda s, o: s >= o) def __gt__(self, other): return self._compare(other, lambda s, o: s > o) def __ne__(self, other): return self._compare(other, lambda s, o: s != o) def _compare(self, other, method): if not isinstance(other, _BaseVersion): return NotImplemented return method(self._key, other._key) class LegacyVersion(_BaseVersion): def __init__(self, version): self._version = str(version) self._key = _legacy_cmpkey(self._version) def __str__(self): return self._version def __repr__(self): return "".format(repr(str(self))) @property def public(self): return self._version @property def base_version(self): return self._version @property def local(self): return None @property def is_prerelease(self): return False @property def is_postrelease(self): return False _legacy_version_component_re = re.compile( r"(\d+ | [a-z]+ | \.| -)", re.VERBOSE, ) _legacy_version_replacement_map = { "pre": "c", "preview": "c", "-": "final-", "rc": "c", "dev": "@", } def _parse_version_parts(s): for part in _legacy_version_component_re.split(s): part = _legacy_version_replacement_map.get(part, part) if not part or part == ".": continue if part[:1] in "0123456789": # pad for numeric comparison yield part.zfill(8) else: yield "*" + part # ensure that alpha/beta/candidate are before final yield "*final" def _legacy_cmpkey(version): # We hardcode an epoch of -1 here. A PEP 440 version can only have a epoch # greater than or equal to 0. This will effectively put the LegacyVersion, # which uses the defacto standard originally implemented by setuptools, # as before all PEP 440 versions. epoch = -1 # This scheme is taken from pkg_resources.parse_version setuptools prior to # it's adoption of the packaging library. parts = [] for part in _parse_version_parts(version.lower()): if part.startswith("*"): # remove "-" before a prerelease tag if part < "*final": while parts and parts[-1] == "*final-": parts.pop() # remove trailing zeros from each series of numeric parts while parts and parts[-1] == "00000000": parts.pop() parts.append(part) parts = tuple(parts) return epoch, parts # Deliberately not anchored to the start and end of the string, to make it # easier for 3rd party code to reuse VERSION_PATTERN = r""" v? (?: (?:(?P[0-9]+)!)? # epoch (?P[0-9]+(?:\.[0-9]+)*) # release segment (?P
                                              # pre-release
                [-_\.]?
                (?P(a|b|c|rc|alpha|beta|pre|preview))
                [-_\.]?
                (?P[0-9]+)?
            )?
            (?P                                         # post release
                (?:-(?P[0-9]+))
                |
                (?:
                    [-_\.]?
                    (?Ppost|rev|r)
                    [-_\.]?
                    (?P[0-9]+)?
                )
            )?
            (?P                                          # dev release
                [-_\.]?
                (?Pdev)
                [-_\.]?
                (?P[0-9]+)?
            )?
        )
        (?:\+(?P[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
    """
    
    
    class Version(_BaseVersion):
    
        _regex = re.compile(
            r"^\s*" + VERSION_PATTERN + r"\s*$",
            re.VERBOSE | re.IGNORECASE,
        )
    
        def __init__(self, version):
            # Validate the version and parse it into pieces
            match = self._regex.search(version)
            if not match:
                raise InvalidVersion("Invalid version: '{0}'".format(version))
    
            # Store the parsed out pieces of the version
            self._version = _Version(
                epoch=int(match.group("epoch")) if match.group("epoch") else 0,
                release=tuple(int(i) for i in match.group("release").split(".")),
                pre=_parse_letter_version(
                    match.group("pre_l"),
                    match.group("pre_n"),
                ),
                post=_parse_letter_version(
                    match.group("post_l"),
                    match.group("post_n1") or match.group("post_n2"),
                ),
                dev=_parse_letter_version(
                    match.group("dev_l"),
                    match.group("dev_n"),
                ),
                local=_parse_local_version(match.group("local")),
            )
    
            # Generate a key which will be used for sorting
            self._key = _cmpkey(
                self._version.epoch,
                self._version.release,
                self._version.pre,
                self._version.post,
                self._version.dev,
                self._version.local,
            )
    
        def __repr__(self):
            return "".format(repr(str(self)))
    
        def __str__(self):
            parts = []
    
            # Epoch
            if self._version.epoch != 0:
                parts.append("{0}!".format(self._version.epoch))
    
            # Release segment
            parts.append(".".join(str(x) for x in self._version.release))
    
            # Pre-release
            if self._version.pre is not None:
                parts.append("".join(str(x) for x in self._version.pre))
    
            # Post-release
            if self._version.post is not None:
                parts.append(".post{0}".format(self._version.post[1]))
    
            # Development release
            if self._version.dev is not None:
                parts.append(".dev{0}".format(self._version.dev[1]))
    
            # Local version segment
            if self._version.local is not None:
                parts.append(
                    "+{0}".format(".".join(str(x) for x in self._version.local))
                )
    
            return "".join(parts)
    
        @property
        def public(self):
            return str(self).split("+", 1)[0]
    
        @property
        def base_version(self):
            parts = []
    
            # Epoch
            if self._version.epoch != 0:
                parts.append("{0}!".format(self._version.epoch))
    
            # Release segment
            parts.append(".".join(str(x) for x in self._version.release))
    
            return "".join(parts)
    
        @property
        def local(self):
            version_string = str(self)
            if "+" in version_string:
                return version_string.split("+", 1)[1]
    
        @property
        def is_prerelease(self):
            return bool(self._version.dev or self._version.pre)
    
        @property
        def is_postrelease(self):
            return bool(self._version.post)
    
    
    def _parse_letter_version(letter, number):
        if letter:
            # We consider there to be an implicit 0 in a pre-release if there is
            # not a numeral associated with it.
            if number is None:
                number = 0
    
            # We normalize any letters to their lower case form
            letter = letter.lower()
    
            # We consider some words to be alternate spellings of other words and
            # in those cases we want to normalize the spellings to our preferred
            # spelling.
            if letter == "alpha":
                letter = "a"
            elif letter == "beta":
                letter = "b"
            elif letter in ["c", "pre", "preview"]:
                letter = "rc"
            elif letter in ["rev", "r"]:
                letter = "post"
    
            return letter, int(number)
        if not letter and number:
            # We assume if we are given a number, but we are not given a letter
            # then this is using the implicit post release syntax (e.g. 1.0-1)
            letter = "post"
    
            return letter, int(number)
    
    
    _local_version_seperators = re.compile(r"[\._-]")
    
    
    def _parse_local_version(local):
        """
        Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
        """
        if local is not None:
            return tuple(
                part.lower() if not part.isdigit() else int(part)
                for part in _local_version_seperators.split(local)
            )
    
    
    def _cmpkey(epoch, release, pre, post, dev, local):
        # When we compare a release version, we want to compare it with all of the
        # trailing zeros removed. So we'll use a reverse the list, drop all the now
        # leading zeros until we come to something non zero, then take the rest
        # re-reverse it back into the correct order and make it a tuple and use
        # that for our sorting key.
        release = tuple(
            reversed(list(
                itertools.dropwhile(
                    lambda x: x == 0,
                    reversed(release),
                )
            ))
        )
    
        # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
        # We'll do this by abusing the pre segment, but we _only_ want to do this
        # if there is not a pre or a post segment. If we have one of those then
        # the normal sorting rules will handle this case correctly.
        if pre is None and post is None and dev is not None:
            pre = -Infinity
        # Versions without a pre-release (except as noted above) should sort after
        # those with one.
        elif pre is None:
            pre = Infinity
    
        # Versions without a post segment should sort before those with one.
        if post is None:
            post = -Infinity
    
        # Versions without a development segment should sort after those with one.
        if dev is None:
            dev = Infinity
    
        if local is None:
            # Versions without a local segment should sort before those with one.
            local = -Infinity
        else:
            # Versions with a local segment need that segment parsed to implement
            # the sorting rules in PEP440.
            # - Alpha numeric segments sort before numeric segments
            # - Alpha numeric segments sort lexicographically
            # - Numeric segments sort numerically
            # - Shorter versions sort before longer versions when the prefixes
            #   match exactly
            local = tuple(
                (i, "") if isinstance(i, int) else (-Infinity, i)
                for i in local
            )
    
        return epoch, release, pre, post, dev, local
    setuptools-20.7.0/pkg_resources/_vendor/__init__.py0000664000175000017500000000000012702524020023265 0ustar  travistravis00000000000000setuptools-20.7.0/pkg_resources/_vendor/pyparsing.py0000664000175000017500000047125112702524020023566 0ustar  travistravis00000000000000# module pyparsing.py
    #
    # Copyright (c) 2003-2015  Paul T. McGuire
    #
    # Permission is hereby granted, free of charge, to any person obtaining
    # a copy of this software and associated documentation files (the
    # "Software"), to deal in the Software without restriction, including
    # without limitation the rights to use, copy, modify, merge, publish,
    # distribute, sublicense, and/or sell copies of the Software, and to
    # permit persons to whom the Software is furnished to do so, subject to
    # the following conditions:
    #
    # The above copyright notice and this permission notice shall be
    # included in all copies or substantial portions of the Software.
    #
    # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
    # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
    # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
    # IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
    # CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
    # TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
    # SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
    #
    
    __doc__ = \
    """
    pyparsing module - Classes and methods to define and execute parsing grammars
    
    The pyparsing module is an alternative approach to creating and executing simple grammars,
    vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
    don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
    provides a library of classes that you use to construct the grammar directly in Python.
    
    Here is a program to parse "Hello, World!" (or any greeting of the form C{", !"})::
    
        from pyparsing import Word, alphas
    
        # define grammar of a greeting
        greet = Word( alphas ) + "," + Word( alphas ) + "!"
    
        hello = "Hello, World!"
        print (hello, "->", greet.parseString( hello ))
    
    The program outputs the following::
    
        Hello, World! -> ['Hello', ',', 'World', '!']
    
    The Python representation of the grammar is quite readable, owing to the self-explanatory
    class names, and the use of '+', '|' and '^' operators.
    
    The parsed results returned from C{parseString()} can be accessed as a nested list, a dictionary, or an
    object with named attributes.
    
    The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
     - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
     - quoted strings
     - embedded comments
    """
    
    __version__ = "2.0.6"
    __versionTime__ = "9 Nov 2015 19:03"
    __author__ = "Paul McGuire "
    
    import string
    from weakref import ref as wkref
    import copy
    import sys
    import warnings
    import re
    import sre_constants
    import collections
    import pprint
    import functools
    import itertools
    
    #~ sys.stderr.write( "testing pyparsing module, version %s, %s\n" % (__version__,__versionTime__ ) )
    
    __all__ = [
    'And', 'CaselessKeyword', 'CaselessLiteral', 'CharsNotIn', 'Combine', 'Dict', 'Each', 'Empty',
    'FollowedBy', 'Forward', 'GoToColumn', 'Group', 'Keyword', 'LineEnd', 'LineStart', 'Literal',
    'MatchFirst', 'NoMatch', 'NotAny', 'OneOrMore', 'OnlyOnce', 'Optional', 'Or',
    'ParseBaseException', 'ParseElementEnhance', 'ParseException', 'ParseExpression', 'ParseFatalException',
    'ParseResults', 'ParseSyntaxException', 'ParserElement', 'QuotedString', 'RecursiveGrammarException',
    'Regex', 'SkipTo', 'StringEnd', 'StringStart', 'Suppress', 'Token', 'TokenConverter', 'Upcase',
    'White', 'Word', 'WordEnd', 'WordStart', 'ZeroOrMore',
    'alphanums', 'alphas', 'alphas8bit', 'anyCloseTag', 'anyOpenTag', 'cStyleComment', 'col',
    'commaSeparatedList', 'commonHTMLEntity', 'countedArray', 'cppStyleComment', 'dblQuotedString',
    'dblSlashComment', 'delimitedList', 'dictOf', 'downcaseTokens', 'empty', 'hexnums',
    'htmlComment', 'javaStyleComment', 'keepOriginalText', 'line', 'lineEnd', 'lineStart', 'lineno',
    'makeHTMLTags', 'makeXMLTags', 'matchOnlyAtCol', 'matchPreviousExpr', 'matchPreviousLiteral',
    'nestedExpr', 'nullDebugAction', 'nums', 'oneOf', 'opAssoc', 'operatorPrecedence', 'printables',
    'punc8bit', 'pythonStyleComment', 'quotedString', 'removeQuotes', 'replaceHTMLEntity', 
    'replaceWith', 'restOfLine', 'sglQuotedString', 'srange', 'stringEnd',
    'stringStart', 'traceParseAction', 'unicodeString', 'upcaseTokens', 'withAttribute',
    'indentedBlock', 'originalTextFor', 'ungroup', 'infixNotation','locatedExpr', 'withClass',
    ]
    
    PY_3 = sys.version.startswith('3')
    if PY_3:
        _MAX_INT = sys.maxsize
        basestring = str
        unichr = chr
        _ustr = str
    
        # build list of single arg builtins, that can be used as parse actions
        singleArgBuiltins = [sum, len, sorted, reversed, list, tuple, set, any, all, min, max]
    
    else:
        _MAX_INT = sys.maxint
        range = xrange
    
        def _ustr(obj):
            """Drop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
               str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
               then < returns the unicode object | encodes it with the default encoding | ... >.
            """
            if isinstance(obj,unicode):
                return obj
    
            try:
                # If this works, then _ustr(obj) has the same behaviour as str(obj), so
                # it won't break any existing code.
                return str(obj)
    
            except UnicodeEncodeError:
                # The Python docs (http://docs.python.org/ref/customization.html#l2h-182)
                # state that "The return value must be a string object". However, does a
                # unicode object (being a subclass of basestring) count as a "string
                # object"?
                # If so, then return a unicode object:
                return unicode(obj)
                # Else encode it... but how? There are many choices... :)
                # Replace unprintables with escape codes?
                #return unicode(obj).encode(sys.getdefaultencoding(), 'backslashreplace_errors')
                # Replace unprintables with question marks?
                #return unicode(obj).encode(sys.getdefaultencoding(), 'replace')
                # ...
    
        # build list of single arg builtins, tolerant of Python version, that can be used as parse actions
        singleArgBuiltins = []
        import __builtin__
        for fname in "sum len sorted reversed list tuple set any all min max".split():
            try:
                singleArgBuiltins.append(getattr(__builtin__,fname))
            except AttributeError:
                continue
                
    _generatorType = type((y for y in range(1)))
     
    def _xml_escape(data):
        """Escape &, <, >, ", ', etc. in a string of data."""
    
        # ampersand must be replaced first
        from_symbols = '&><"\''
        to_symbols = ('&'+s+';' for s in "amp gt lt quot apos".split())
        for from_,to_ in zip(from_symbols, to_symbols):
            data = data.replace(from_, to_)
        return data
    
    class _Constants(object):
        pass
    
    alphas = string.ascii_lowercase + string.ascii_uppercase
    nums       = "0123456789"
    hexnums    = nums + "ABCDEFabcdef"
    alphanums  = alphas + nums
    _bslash    = chr(92)
    printables = "".join(c for c in string.printable if c not in string.whitespace)
    
    class ParseBaseException(Exception):
        """base exception class for all parsing runtime exceptions"""
        # Performance tuning: we construct a *lot* of these, so keep this
        # constructor as small and fast as possible
        def __init__( self, pstr, loc=0, msg=None, elem=None ):
            self.loc = loc
            if msg is None:
                self.msg = pstr
                self.pstr = ""
            else:
                self.msg = msg
                self.pstr = pstr
            self.parserElement = elem
    
        def __getattr__( self, aname ):
            """supported attributes by name are:
                - lineno - returns the line number of the exception text
                - col - returns the column number of the exception text
                - line - returns the line containing the exception text
            """
            if( aname == "lineno" ):
                return lineno( self.loc, self.pstr )
            elif( aname in ("col", "column") ):
                return col( self.loc, self.pstr )
            elif( aname == "line" ):
                return line( self.loc, self.pstr )
            else:
                raise AttributeError(aname)
    
        def __str__( self ):
            return "%s (at char %d), (line:%d, col:%d)" % \
                    ( self.msg, self.loc, self.lineno, self.column )
        def __repr__( self ):
            return _ustr(self)
        def markInputline( self, markerString = ">!<" ):
            """Extracts the exception line from the input string, and marks
               the location of the exception with a special symbol.
            """
            line_str = self.line
            line_column = self.column - 1
            if markerString:
                line_str = "".join((line_str[:line_column],
                                    markerString, line_str[line_column:]))
            return line_str.strip()
        def __dir__(self):
            return "loc msg pstr parserElement lineno col line " \
                   "markInputline __str__ __repr__".split()
    
    class ParseException(ParseBaseException):
        """exception thrown when parse expressions don't match class;
           supported attributes by name are:
            - lineno - returns the line number of the exception text
            - col - returns the column number of the exception text
            - line - returns the line containing the exception text
        """
        pass
    
    class ParseFatalException(ParseBaseException):
        """user-throwable exception thrown when inconsistent parse content
           is found; stops all parsing immediately"""
        pass
    
    class ParseSyntaxException(ParseFatalException):
        """just like C{L{ParseFatalException}}, but thrown internally when an
           C{L{ErrorStop}} ('-' operator) indicates that parsing is to stop immediately because
           an unbacktrackable syntax error has been found"""
        def __init__(self, pe):
            super(ParseSyntaxException, self).__init__(
                                        pe.pstr, pe.loc, pe.msg, pe.parserElement)
    
    #~ class ReparseException(ParseBaseException):
        #~ """Experimental class - parse actions can raise this exception to cause
           #~ pyparsing to reparse the input string:
            #~ - with a modified input string, and/or
            #~ - with a modified start location
           #~ Set the values of the ReparseException in the constructor, and raise the
           #~ exception in a parse action to cause pyparsing to use the new string/location.
           #~ Setting the values as None causes no change to be made.
           #~ """
        #~ def __init_( self, newstring, restartLoc ):
            #~ self.newParseText = newstring
            #~ self.reparseLoc = restartLoc
    
    class RecursiveGrammarException(Exception):
        """exception thrown by C{validate()} if the grammar could be improperly recursive"""
        def __init__( self, parseElementList ):
            self.parseElementTrace = parseElementList
    
        def __str__( self ):
            return "RecursiveGrammarException: %s" % self.parseElementTrace
    
    class _ParseResultsWithOffset(object):
        def __init__(self,p1,p2):
            self.tup = (p1,p2)
        def __getitem__(self,i):
            return self.tup[i]
        def __repr__(self):
            return repr(self.tup)
        def setOffset(self,i):
            self.tup = (self.tup[0],i)
    
    class ParseResults(object):
        """Structured parse results, to provide multiple means of access to the parsed data:
           - as a list (C{len(results)})
           - by list index (C{results[0], results[1]}, etc.)
           - by attribute (C{results.})
           """
        def __new__(cls, toklist, name=None, asList=True, modal=True ):
            if isinstance(toklist, cls):
                return toklist
            retobj = object.__new__(cls)
            retobj.__doinit = True
            return retobj
    
        # Performance tuning: we construct a *lot* of these, so keep this
        # constructor as small and fast as possible
        def __init__( self, toklist, name=None, asList=True, modal=True, isinstance=isinstance ):
            if self.__doinit:
                self.__doinit = False
                self.__name = None
                self.__parent = None
                self.__accumNames = {}
                if isinstance(toklist, list):
                    self.__toklist = toklist[:]
                elif isinstance(toklist, _generatorType):
                    self.__toklist = list(toklist)
                else:
                    self.__toklist = [toklist]
                self.__tokdict = dict()
    
            if name is not None and name:
                if not modal:
                    self.__accumNames[name] = 0
                if isinstance(name,int):
                    name = _ustr(name) # will always return a str, but use _ustr for consistency
                self.__name = name
                if not (isinstance(toklist, (type(None), basestring, list)) and toklist in (None,'',[])):
                    if isinstance(toklist,basestring):
                        toklist = [ toklist ]
                    if asList:
                        if isinstance(toklist,ParseResults):
                            self[name] = _ParseResultsWithOffset(toklist.copy(),0)
                        else:
                            self[name] = _ParseResultsWithOffset(ParseResults(toklist[0]),0)
                        self[name].__name = name
                    else:
                        try:
                            self[name] = toklist[0]
                        except (KeyError,TypeError,IndexError):
                            self[name] = toklist
    
        def __getitem__( self, i ):
            if isinstance( i, (int,slice) ):
                return self.__toklist[i]
            else:
                if i not in self.__accumNames:
                    return self.__tokdict[i][-1][0]
                else:
                    return ParseResults([ v[0] for v in self.__tokdict[i] ])
    
        def __setitem__( self, k, v, isinstance=isinstance ):
            if isinstance(v,_ParseResultsWithOffset):
                self.__tokdict[k] = self.__tokdict.get(k,list()) + [v]
                sub = v[0]
            elif isinstance(k,int):
                self.__toklist[k] = v
                sub = v
            else:
                self.__tokdict[k] = self.__tokdict.get(k,list()) + [_ParseResultsWithOffset(v,0)]
                sub = v
            if isinstance(sub,ParseResults):
                sub.__parent = wkref(self)
    
        def __delitem__( self, i ):
            if isinstance(i,(int,slice)):
                mylen = len( self.__toklist )
                del self.__toklist[i]
    
                # convert int to slice
                if isinstance(i, int):
                    if i < 0:
                        i += mylen
                    i = slice(i, i+1)
                # get removed indices
                removed = list(range(*i.indices(mylen)))
                removed.reverse()
                # fixup indices in token dictionary
                #~ for name in self.__tokdict:
                    #~ occurrences = self.__tokdict[name]
                    #~ for j in removed:
                        #~ for k, (value, position) in enumerate(occurrences):
                            #~ occurrences[k] = _ParseResultsWithOffset(value, position - (position > j))
                for name,occurrences in self.__tokdict.items():
                    for j in removed:
                        for k, (value, position) in enumerate(occurrences):
                            occurrences[k] = _ParseResultsWithOffset(value, position - (position > j))
            else:
                del self.__tokdict[i]
    
        def __contains__( self, k ):
            return k in self.__tokdict
    
        def __len__( self ): return len( self.__toklist )
        def __bool__(self): return len( self.__toklist ) > 0
        __nonzero__ = __bool__
        def __iter__( self ): return iter( self.__toklist )
        def __reversed__( self ): return iter( self.__toklist[::-1] )
        def iterkeys( self ):
            """Returns all named result keys."""
            if hasattr(self.__tokdict, "iterkeys"):
                return self.__tokdict.iterkeys()
            else:
                return iter(self.__tokdict)
    
        def itervalues( self ):
            """Returns all named result values."""
            return (self[k] for k in self.iterkeys())
                
        def iteritems( self ):
            return ((k, self[k]) for k in self.iterkeys())
    
        if PY_3:
            keys = iterkeys
            values = itervalues
            items = iteritems
        else:
            def keys( self ):
                """Returns all named result keys."""
                return list(self.iterkeys())
    
            def values( self ):
                """Returns all named result values."""
                return list(self.itervalues())
                    
            def items( self ):
                """Returns all named result keys and values as a list of tuples."""
                return list(self.iteritems())
    
        def haskeys( self ):
            """Since keys() returns an iterator, this method is helpful in bypassing
               code that looks for the existence of any defined results names."""
            return bool(self.__tokdict)
            
        def pop( self, *args, **kwargs):
            """Removes and returns item at specified index (default=last).
               Supports both list and dict semantics for pop(). If passed no
               argument or an integer argument, it will use list semantics
               and pop tokens from the list of parsed tokens. If passed a 
               non-integer argument (most likely a string), it will use dict
               semantics and pop the corresponding value from any defined 
               results names. A second default return value argument is 
               supported, just as in dict.pop()."""
            if not args:
                args = [-1]
            for k,v in kwargs.items():
                if k == 'default':
                    args = (args[0], v)
                else:
                    raise TypeError("pop() got an unexpected keyword argument '%s'" % k)
            if (isinstance(args[0], int) or 
                            len(args) == 1 or 
                            args[0] in self):
                index = args[0]
                ret = self[index]
                del self[index]
                return ret
            else:
                defaultvalue = args[1]
                return defaultvalue
    
        def get(self, key, defaultValue=None):
            """Returns named result matching the given key, or if there is no
               such name, then returns the given C{defaultValue} or C{None} if no
               C{defaultValue} is specified."""
            if key in self:
                return self[key]
            else:
                return defaultValue
    
        def insert( self, index, insStr ):
            """Inserts new element at location index in the list of parsed tokens."""
            self.__toklist.insert(index, insStr)
            # fixup indices in token dictionary
            #~ for name in self.__tokdict:
                #~ occurrences = self.__tokdict[name]
                #~ for k, (value, position) in enumerate(occurrences):
                    #~ occurrences[k] = _ParseResultsWithOffset(value, position + (position > index))
            for name,occurrences in self.__tokdict.items():
                for k, (value, position) in enumerate(occurrences):
                    occurrences[k] = _ParseResultsWithOffset(value, position + (position > index))
    
        def append( self, item ):
            """Add single element to end of ParseResults list of elements."""
            self.__toklist.append(item)
    
        def extend( self, itemseq ):
            """Add sequence of elements to end of ParseResults list of elements."""
            if isinstance(itemseq, ParseResults):
                self += itemseq
            else:
                self.__toklist.extend(itemseq)
    
        def clear( self ):
            """Clear all elements and results names."""
            del self.__toklist[:]
            self.__tokdict.clear()
    
        def __getattr__( self, name ):
            try:
                return self[name]
            except KeyError:
                return ""
                
            if name in self.__tokdict:
                if name not in self.__accumNames:
                    return self.__tokdict[name][-1][0]
                else:
                    return ParseResults([ v[0] for v in self.__tokdict[name] ])
            else:
                return ""
    
        def __add__( self, other ):
            ret = self.copy()
            ret += other
            return ret
    
        def __iadd__( self, other ):
            if other.__tokdict:
                offset = len(self.__toklist)
                addoffset = lambda a: offset if a<0 else a+offset
                otheritems = other.__tokdict.items()
                otherdictitems = [(k, _ParseResultsWithOffset(v[0],addoffset(v[1])) )
                                    for (k,vlist) in otheritems for v in vlist]
                for k,v in otherdictitems:
                    self[k] = v
                    if isinstance(v[0],ParseResults):
                        v[0].__parent = wkref(self)
                
            self.__toklist += other.__toklist
            self.__accumNames.update( other.__accumNames )
            return self
    
        def __radd__(self, other):
            if isinstance(other,int) and other == 0:
                return self.copy()
            
        def __repr__( self ):
            return "(%s, %s)" % ( repr( self.__toklist ), repr( self.__tokdict ) )
    
        def __str__( self ):
            return '[' + ', '.join(_ustr(i) if isinstance(i, ParseResults) else repr(i) for i in self.__toklist) + ']'
    
        def _asStringList( self, sep='' ):
            out = []
            for item in self.__toklist:
                if out and sep:
                    out.append(sep)
                if isinstance( item, ParseResults ):
                    out += item._asStringList()
                else:
                    out.append( _ustr(item) )
            return out
    
        def asList( self ):
            """Returns the parse results as a nested list of matching tokens, all converted to strings."""
            return [res.asList() if isinstance(res,ParseResults) else res for res in self.__toklist]
    
        def asDict( self ):
            """Returns the named parse results as dictionary."""
            if PY_3:
                return dict( self.items() )
            else:
                return dict( self.iteritems() )
    
        def copy( self ):
            """Returns a new copy of a C{ParseResults} object."""
            ret = ParseResults( self.__toklist )
            ret.__tokdict = self.__tokdict.copy()
            ret.__parent = self.__parent
            ret.__accumNames.update( self.__accumNames )
            ret.__name = self.__name
            return ret
    
        def asXML( self, doctag=None, namedItemsOnly=False, indent="", formatted=True ):
            """Returns the parse results as XML. Tags are created for tokens and lists that have defined results names."""
            nl = "\n"
            out = []
            namedItems = dict((v[1],k) for (k,vlist) in self.__tokdict.items()
                                                                for v in vlist)
            nextLevelIndent = indent + "  "
    
            # collapse out indents if formatting is not desired
            if not formatted:
                indent = ""
                nextLevelIndent = ""
                nl = ""
    
            selfTag = None
            if doctag is not None:
                selfTag = doctag
            else:
                if self.__name:
                    selfTag = self.__name
    
            if not selfTag:
                if namedItemsOnly:
                    return ""
                else:
                    selfTag = "ITEM"
    
            out += [ nl, indent, "<", selfTag, ">" ]
    
            for i,res in enumerate(self.__toklist):
                if isinstance(res,ParseResults):
                    if i in namedItems:
                        out += [ res.asXML(namedItems[i],
                                            namedItemsOnly and doctag is None,
                                            nextLevelIndent,
                                            formatted)]
                    else:
                        out += [ res.asXML(None,
                                            namedItemsOnly and doctag is None,
                                            nextLevelIndent,
                                            formatted)]
                else:
                    # individual token, see if there is a name for it
                    resTag = None
                    if i in namedItems:
                        resTag = namedItems[i]
                    if not resTag:
                        if namedItemsOnly:
                            continue
                        else:
                            resTag = "ITEM"
                    xmlBodyText = _xml_escape(_ustr(res))
                    out += [ nl, nextLevelIndent, "<", resTag, ">",
                                                    xmlBodyText,
                                                    "" ]
    
            out += [ nl, indent, "" ]
            return "".join(out)
    
        def __lookup(self,sub):
            for k,vlist in self.__tokdict.items():
                for v,loc in vlist:
                    if sub is v:
                        return k
            return None
    
        def getName(self):
            """Returns the results name for this token expression."""
            if self.__name:
                return self.__name
            elif self.__parent:
                par = self.__parent()
                if par:
                    return par.__lookup(self)
                else:
                    return None
            elif (len(self) == 1 and
                   len(self.__tokdict) == 1 and
                   self.__tokdict.values()[0][0][1] in (0,-1)):
                return self.__tokdict.keys()[0]
            else:
                return None
    
        def dump(self,indent='',depth=0):
            """Diagnostic method for listing out the contents of a C{ParseResults}.
               Accepts an optional C{indent} argument so that this string can be embedded
               in a nested display of other data."""
            out = []
            NL = '\n'
            out.append( indent+_ustr(self.asList()) )
            if self.haskeys():
                items = sorted(self.items())
                for k,v in items:
                    if out:
                        out.append(NL)
                    out.append( "%s%s- %s: " % (indent,('  '*depth), k) )
                    if isinstance(v,ParseResults):
                        if v:
                            out.append( v.dump(indent,depth+1) )
                        else:
                            out.append(_ustr(v))
                    else:
                        out.append(_ustr(v))
            elif any(isinstance(vv,ParseResults) for vv in self):
                v = self
                for i,vv in enumerate(v):
                    if isinstance(vv,ParseResults):
                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),vv.dump(indent,depth+1) ))
                    else:
                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),_ustr(vv)))
                
            return "".join(out)
    
        def pprint(self, *args, **kwargs):
            """Pretty-printer for parsed results as a list, using the C{pprint} module.
               Accepts additional positional or keyword args as defined for the 
               C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})"""
            pprint.pprint(self.asList(), *args, **kwargs)
    
        # add support for pickle protocol
        def __getstate__(self):
            return ( self.__toklist,
                     ( self.__tokdict.copy(),
                       self.__parent is not None and self.__parent() or None,
                       self.__accumNames,
                       self.__name ) )
    
        def __setstate__(self,state):
            self.__toklist = state[0]
            (self.__tokdict,
             par,
             inAccumNames,
             self.__name) = state[1]
            self.__accumNames = {}
            self.__accumNames.update(inAccumNames)
            if par is not None:
                self.__parent = wkref(par)
            else:
                self.__parent = None
    
        def __dir__(self):
            return dir(super(ParseResults,self)) + list(self.keys())
    
    collections.MutableMapping.register(ParseResults)
    
    def col (loc,strg):
        """Returns current column within a string, counting newlines as line separators.
       The first column is number 1.
    
       Note: the default parsing behavior is to expand tabs in the input string
       before starting the parsing process.  See L{I{ParserElement.parseString}} for more information
       on parsing strings containing C{}s, and suggested methods to maintain a
       consistent view of the parsed string, the parse location, and line and column
       positions within the parsed string.
       """
        s = strg
        return 1 if loc} for more information
       on parsing strings containing C{}s, and suggested methods to maintain a
       consistent view of the parsed string, the parse location, and line and column
       positions within the parsed string.
       """
        return strg.count("\n",0,loc) + 1
    
    def line( loc, strg ):
        """Returns the line of text containing loc within a string, counting newlines as line separators.
           """
        lastCR = strg.rfind("\n", 0, loc)
        nextCR = strg.find("\n", loc)
        if nextCR >= 0:
            return strg[lastCR+1:nextCR]
        else:
            return strg[lastCR+1:]
    
    def _defaultStartDebugAction( instring, loc, expr ):
        print (("Match " + _ustr(expr) + " at loc " + _ustr(loc) + "(%d,%d)" % ( lineno(loc,instring), col(loc,instring) )))
    
    def _defaultSuccessDebugAction( instring, startloc, endloc, expr, toks ):
        print ("Matched " + _ustr(expr) + " -> " + str(toks.asList()))
    
    def _defaultExceptionDebugAction( instring, loc, expr, exc ):
        print ("Exception raised:" + _ustr(exc))
    
    def nullDebugAction(*args):
        """'Do-nothing' debug action, to suppress debugging output during parsing."""
        pass
    
    # Only works on Python 3.x - nonlocal is toxic to Python 2 installs
    #~ 'decorator to trim function calls to match the arity of the target'
    #~ def _trim_arity(func, maxargs=3):
        #~ if func in singleArgBuiltins:
            #~ return lambda s,l,t: func(t)
        #~ limit = 0
        #~ foundArity = False
        #~ def wrapper(*args):
            #~ nonlocal limit,foundArity
            #~ while 1:
                #~ try:
                    #~ ret = func(*args[limit:])
                    #~ foundArity = True
                    #~ return ret
                #~ except TypeError:
                    #~ if limit == maxargs or foundArity:
                        #~ raise
                    #~ limit += 1
                    #~ continue
        #~ return wrapper
    
    # this version is Python 2.x-3.x cross-compatible
    'decorator to trim function calls to match the arity of the target'
    def _trim_arity(func, maxargs=2):
        if func in singleArgBuiltins:
            return lambda s,l,t: func(t)
        limit = [0]
        foundArity = [False]
        def wrapper(*args):
            while 1:
                try:
                    ret = func(*args[limit[0]:])
                    foundArity[0] = True
                    return ret
                except TypeError:
                    if limit[0] <= maxargs and not foundArity[0]:
                        limit[0] += 1
                        continue
                    raise
        return wrapper
     
    class ParserElement(object):
        """Abstract base level parser element class."""
        DEFAULT_WHITE_CHARS = " \n\t\r"
        verbose_stacktrace = False
    
        @staticmethod
        def setDefaultWhitespaceChars( chars ):
            """Overrides the default whitespace chars
            """
            ParserElement.DEFAULT_WHITE_CHARS = chars
    
        @staticmethod
        def inlineLiteralsUsing(cls):
            """
            Set class to be used for inclusion of string literals into a parser.
            """
            ParserElement.literalStringClass = cls
    
        def __init__( self, savelist=False ):
            self.parseAction = list()
            self.failAction = None
            #~ self.name = ""  # don't define self.name, let subclasses try/except upcall
            self.strRepr = None
            self.resultsName = None
            self.saveAsList = savelist
            self.skipWhitespace = True
            self.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
            self.copyDefaultWhiteChars = True
            self.mayReturnEmpty = False # used when checking for left-recursion
            self.keepTabs = False
            self.ignoreExprs = list()
            self.debug = False
            self.streamlined = False
            self.mayIndexError = True # used to optimize exception handling for subclasses that don't advance parse index
            self.errmsg = ""
            self.modalResults = True # used to mark results names as modal (report only last) or cumulative (list all)
            self.debugActions = ( None, None, None ) #custom debug actions
            self.re = None
            self.callPreparse = True # used to avoid redundant calls to preParse
            self.callDuringTry = False
    
        def copy( self ):
            """Make a copy of this C{ParserElement}.  Useful for defining different parse actions
               for the same parsing pattern, using copies of the original parse element."""
            cpy = copy.copy( self )
            cpy.parseAction = self.parseAction[:]
            cpy.ignoreExprs = self.ignoreExprs[:]
            if self.copyDefaultWhiteChars:
                cpy.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
            return cpy
    
        def setName( self, name ):
            """Define name for this expression, for use in debugging."""
            self.name = name
            self.errmsg = "Expected " + self.name
            if hasattr(self,"exception"):
                self.exception.msg = self.errmsg
            return self
    
        def setResultsName( self, name, listAllMatches=False ):
            """Define name for referencing matching tokens as a nested attribute
               of the returned parse results.
               NOTE: this returns a *copy* of the original C{ParserElement} object;
               this is so that the client can define a basic element, such as an
               integer, and reference it in multiple places with different names.
               
               You can also set results names using the abbreviated syntax,
               C{expr("name")} in place of C{expr.setResultsName("name")} - 
               see L{I{__call__}<__call__>}.
            """
            newself = self.copy()
            if name.endswith("*"):
                name = name[:-1]
                listAllMatches=True
            newself.resultsName = name
            newself.modalResults = not listAllMatches
            return newself
    
        def setBreak(self,breakFlag = True):
            """Method to invoke the Python pdb debugger when this element is
               about to be parsed. Set C{breakFlag} to True to enable, False to
               disable.
            """
            if breakFlag:
                _parseMethod = self._parse
                def breaker(instring, loc, doActions=True, callPreParse=True):
                    import pdb
                    pdb.set_trace()
                    return _parseMethod( instring, loc, doActions, callPreParse )
                breaker._originalParseMethod = _parseMethod
                self._parse = breaker
            else:
                if hasattr(self._parse,"_originalParseMethod"):
                    self._parse = self._parse._originalParseMethod
            return self
    
        def setParseAction( self, *fns, **kwargs ):
            """Define action to perform when successfully matching parse element definition.
               Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
               C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
                - s   = the original string being parsed (see note below)
                - loc = the location of the matching substring
                - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
               If the functions in fns modify the tokens, they can return them as the return
               value from fn, and the modified list of tokens will replace the original.
               Otherwise, fn does not need to return any value.
    
               Note: the default parsing behavior is to expand tabs in the input string
               before starting the parsing process.  See L{I{parseString}} for more information
               on parsing strings containing C{}s, and suggested methods to maintain a
               consistent view of the parsed string, the parse location, and line and column
               positions within the parsed string.
               """
            self.parseAction = list(map(_trim_arity, list(fns)))
            self.callDuringTry = kwargs.get("callDuringTry", False)
            return self
    
        def addParseAction( self, *fns, **kwargs ):
            """Add parse action to expression's list of parse actions. See L{I{setParseAction}}."""
            self.parseAction += list(map(_trim_arity, list(fns)))
            self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
            return self
    
        def addCondition(self, *fns, **kwargs):
            """Add a boolean predicate function to expression's list of parse actions. See 
            L{I{setParseAction}}. Optional keyword argument C{message} can
            be used to define a custom message to be used in the raised exception."""
            msg = kwargs.get("message") or "failed user-defined condition"
            for fn in fns:
                def pa(s,l,t):
                    if not bool(_trim_arity(fn)(s,l,t)):
                        raise ParseException(s,l,msg)
                    return t
                self.parseAction.append(pa)
            self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
            return self
    
        def setFailAction( self, fn ):
            """Define action to perform if parsing fails at this expression.
               Fail acton fn is a callable function that takes the arguments
               C{fn(s,loc,expr,err)} where:
                - s = string being parsed
                - loc = location where expression match was attempted and failed
                - expr = the parse expression that failed
                - err = the exception thrown
               The function returns no value.  It may throw C{L{ParseFatalException}}
               if it is desired to stop parsing immediately."""
            self.failAction = fn
            return self
    
        def _skipIgnorables( self, instring, loc ):
            exprsFound = True
            while exprsFound:
                exprsFound = False
                for e in self.ignoreExprs:
                    try:
                        while 1:
                            loc,dummy = e._parse( instring, loc )
                            exprsFound = True
                    except ParseException:
                        pass
            return loc
    
        def preParse( self, instring, loc ):
            if self.ignoreExprs:
                loc = self._skipIgnorables( instring, loc )
    
            if self.skipWhitespace:
                wt = self.whiteChars
                instrlen = len(instring)
                while loc < instrlen and instring[loc] in wt:
                    loc += 1
    
            return loc
    
        def parseImpl( self, instring, loc, doActions=True ):
            return loc, []
    
        def postParse( self, instring, loc, tokenlist ):
            return tokenlist
    
        #~ @profile
        def _parseNoCache( self, instring, loc, doActions=True, callPreParse=True ):
            debugging = ( self.debug ) #and doActions )
    
            if debugging or self.failAction:
                #~ print ("Match",self,"at loc",loc,"(%d,%d)" % ( lineno(loc,instring), col(loc,instring) ))
                if (self.debugActions[0] ):
                    self.debugActions[0]( instring, loc, self )
                if callPreParse and self.callPreparse:
                    preloc = self.preParse( instring, loc )
                else:
                    preloc = loc
                tokensStart = preloc
                try:
                    try:
                        loc,tokens = self.parseImpl( instring, preloc, doActions )
                    except IndexError:
                        raise ParseException( instring, len(instring), self.errmsg, self )
                except ParseBaseException as err:
                    #~ print ("Exception raised:", err)
                    if self.debugActions[2]:
                        self.debugActions[2]( instring, tokensStart, self, err )
                    if self.failAction:
                        self.failAction( instring, tokensStart, self, err )
                    raise
            else:
                if callPreParse and self.callPreparse:
                    preloc = self.preParse( instring, loc )
                else:
                    preloc = loc
                tokensStart = preloc
                if self.mayIndexError or loc >= len(instring):
                    try:
                        loc,tokens = self.parseImpl( instring, preloc, doActions )
                    except IndexError:
                        raise ParseException( instring, len(instring), self.errmsg, self )
                else:
                    loc,tokens = self.parseImpl( instring, preloc, doActions )
    
            tokens = self.postParse( instring, loc, tokens )
    
            retTokens = ParseResults( tokens, self.resultsName, asList=self.saveAsList, modal=self.modalResults )
            if self.parseAction and (doActions or self.callDuringTry):
                if debugging:
                    try:
                        for fn in self.parseAction:
                            tokens = fn( instring, tokensStart, retTokens )
                            if tokens is not None:
                                retTokens = ParseResults( tokens,
                                                          self.resultsName,
                                                          asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
                                                          modal=self.modalResults )
                    except ParseBaseException as err:
                        #~ print "Exception raised in user parse action:", err
                        if (self.debugActions[2] ):
                            self.debugActions[2]( instring, tokensStart, self, err )
                        raise
                else:
                    for fn in self.parseAction:
                        tokens = fn( instring, tokensStart, retTokens )
                        if tokens is not None:
                            retTokens = ParseResults( tokens,
                                                      self.resultsName,
                                                      asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
                                                      modal=self.modalResults )
    
            if debugging:
                #~ print ("Matched",self,"->",retTokens.asList())
                if (self.debugActions[1] ):
                    self.debugActions[1]( instring, tokensStart, loc, self, retTokens )
    
            return loc, retTokens
    
        def tryParse( self, instring, loc ):
            try:
                return self._parse( instring, loc, doActions=False )[0]
            except ParseFatalException:
                raise ParseException( instring, loc, self.errmsg, self)
    
        # this method gets repeatedly called during backtracking with the same arguments -
        # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
        def _parseCache( self, instring, loc, doActions=True, callPreParse=True ):
            lookup = (self,instring,loc,callPreParse,doActions)
            if lookup in ParserElement._exprArgCache:
                value = ParserElement._exprArgCache[ lookup ]
                if isinstance(value, Exception):
                    raise value
                return (value[0],value[1].copy())
            else:
                try:
                    value = self._parseNoCache( instring, loc, doActions, callPreParse )
                    ParserElement._exprArgCache[ lookup ] = (value[0],value[1].copy())
                    return value
                except ParseBaseException as pe:
                    pe.__traceback__ = None
                    ParserElement._exprArgCache[ lookup ] = pe
                    raise
    
        _parse = _parseNoCache
    
        # argument cache for optimizing repeated calls when backtracking through recursive expressions
        _exprArgCache = {}
        @staticmethod
        def resetCache():
            ParserElement._exprArgCache.clear()
    
        _packratEnabled = False
        @staticmethod
        def enablePackrat():
            """Enables "packrat" parsing, which adds memoizing to the parsing logic.
               Repeated parse attempts at the same string location (which happens
               often in many complex grammars) can immediately return a cached value,
               instead of re-executing parsing/validating code.  Memoizing is done of
               both valid results and parsing exceptions.
    
               This speedup may break existing programs that use parse actions that
               have side-effects.  For this reason, packrat parsing is disabled when
               you first import pyparsing.  To activate the packrat feature, your
               program must call the class method C{ParserElement.enablePackrat()}.  If
               your program uses C{psyco} to "compile as you go", you must call
               C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
               Python will crash.  For best results, call C{enablePackrat()} immediately
               after importing pyparsing.
            """
            if not ParserElement._packratEnabled:
                ParserElement._packratEnabled = True
                ParserElement._parse = ParserElement._parseCache
    
        def parseString( self, instring, parseAll=False ):
            """Execute the parse expression with the given string.
               This is the main interface to the client code, once the complete
               expression has been built.
    
               If you want the grammar to require that the entire input string be
               successfully parsed, then set C{parseAll} to True (equivalent to ending
               the grammar with C{L{StringEnd()}}).
    
               Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
               in order to report proper column numbers in parse actions.
               If the input string contains tabs and
               the grammar uses parse actions that use the C{loc} argument to index into the
               string being parsed, you can ensure you have a consistent view of the input
               string by:
                - calling C{parseWithTabs} on your grammar before calling C{parseString}
                  (see L{I{parseWithTabs}})
                - define your parse action using the full C{(s,loc,toks)} signature, and
                  reference the input string using the parse action's C{s} argument
                - explictly expand the tabs in your input string before calling
                  C{parseString}
            """
            ParserElement.resetCache()
            if not self.streamlined:
                self.streamline()
                #~ self.saveAsList = True
            for e in self.ignoreExprs:
                e.streamline()
            if not self.keepTabs:
                instring = instring.expandtabs()
            try:
                loc, tokens = self._parse( instring, 0 )
                if parseAll:
                    loc = self.preParse( instring, loc )
                    se = Empty() + StringEnd()
                    se._parse( instring, loc )
            except ParseBaseException as exc:
                if ParserElement.verbose_stacktrace:
                    raise
                else:
                    # catch and re-raise exception from here, clears out pyparsing internal stack trace
                    raise exc
            else:
                return tokens
    
        def scanString( self, instring, maxMatches=_MAX_INT, overlap=False ):
            """Scan the input string for expression matches.  Each match will return the
               matching tokens, start location, and end location.  May be called with optional
               C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
               C{overlap} is specified, then overlapping matches will be reported.
    
               Note that the start and end locations are reported relative to the string
               being parsed.  See L{I{parseString}} for more information on parsing
               strings with embedded tabs."""
            if not self.streamlined:
                self.streamline()
            for e in self.ignoreExprs:
                e.streamline()
    
            if not self.keepTabs:
                instring = _ustr(instring).expandtabs()
            instrlen = len(instring)
            loc = 0
            preparseFn = self.preParse
            parseFn = self._parse
            ParserElement.resetCache()
            matches = 0
            try:
                while loc <= instrlen and matches < maxMatches:
                    try:
                        preloc = preparseFn( instring, loc )
                        nextLoc,tokens = parseFn( instring, preloc, callPreParse=False )
                    except ParseException:
                        loc = preloc+1
                    else:
                        if nextLoc > loc:
                            matches += 1
                            yield tokens, preloc, nextLoc
                            if overlap:
                                nextloc = preparseFn( instring, loc )
                                if nextloc > loc:
                                    loc = nextLoc
                                else:
                                    loc += 1
                            else:
                                loc = nextLoc
                        else:
                            loc = preloc+1
            except ParseBaseException as exc:
                if ParserElement.verbose_stacktrace:
                    raise
                else:
                    # catch and re-raise exception from here, clears out pyparsing internal stack trace
                    raise exc
    
        def transformString( self, instring ):
            """Extension to C{L{scanString}}, to modify matching text with modified tokens that may
               be returned from a parse action.  To use C{transformString}, define a grammar and
               attach a parse action to it that modifies the returned token list.
               Invoking C{transformString()} on a target string will then scan for matches,
               and replace the matched text patterns according to the logic in the parse
               action.  C{transformString()} returns the resulting transformed string."""
            out = []
            lastE = 0
            # force preservation of s, to minimize unwanted transformation of string, and to
            # keep string locs straight between transformString and scanString
            self.keepTabs = True
            try:
                for t,s,e in self.scanString( instring ):
                    out.append( instring[lastE:s] )
                    if t:
                        if isinstance(t,ParseResults):
                            out += t.asList()
                        elif isinstance(t,list):
                            out += t
                        else:
                            out.append(t)
                    lastE = e
                out.append(instring[lastE:])
                out = [o for o in out if o]
                return "".join(map(_ustr,_flatten(out)))
            except ParseBaseException as exc:
                if ParserElement.verbose_stacktrace:
                    raise
                else:
                    # catch and re-raise exception from here, clears out pyparsing internal stack trace
                    raise exc
    
        def searchString( self, instring, maxMatches=_MAX_INT ):
            """Another extension to C{L{scanString}}, simplifying the access to the tokens found
               to match the given parse expression.  May be called with optional
               C{maxMatches} argument, to clip searching after 'n' matches are found.
            """
            try:
                return ParseResults([ t for t,s,e in self.scanString( instring, maxMatches ) ])
            except ParseBaseException as exc:
                if ParserElement.verbose_stacktrace:
                    raise
                else:
                    # catch and re-raise exception from here, clears out pyparsing internal stack trace
                    raise exc
    
        def __add__(self, other ):
            """Implementation of + operator - returns C{L{And}}"""
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            if not isinstance( other, ParserElement ):
                warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                        SyntaxWarning, stacklevel=2)
                return None
            return And( [ self, other ] )
    
        def __radd__(self, other ):
            """Implementation of + operator when left operand is not a C{L{ParserElement}}"""
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            if not isinstance( other, ParserElement ):
                warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                        SyntaxWarning, stacklevel=2)
                return None
            return other + self
    
        def __sub__(self, other):
            """Implementation of - operator, returns C{L{And}} with error stop"""
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            if not isinstance( other, ParserElement ):
                warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                        SyntaxWarning, stacklevel=2)
                return None
            return And( [ self, And._ErrorStop(), other ] )
    
        def __rsub__(self, other ):
            """Implementation of - operator when left operand is not a C{L{ParserElement}}"""
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            if not isinstance( other, ParserElement ):
                warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                        SyntaxWarning, stacklevel=2)
                return None
            return other - self
    
        def __mul__(self,other):
            """Implementation of * operator, allows use of C{expr * 3} in place of
               C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
               tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
               may also include C{None} as in:
                - C{expr*(n,None)} or C{expr*(n,)} is equivalent
                  to C{expr*n + L{ZeroOrMore}(expr)}
                  (read as "at least n instances of C{expr}")
                - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
                  (read as "0 to n instances of C{expr}")
                - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
                - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}
    
               Note that C{expr*(None,n)} does not raise an exception if
               more than n exprs exist in the input stream; that is,
               C{expr*(None,n)} does not enforce a maximum number of expr
               occurrences.  If this behavior is desired, then write
               C{expr*(None,n) + ~expr}
    
            """
            if isinstance(other,int):
                minElements, optElements = other,0
            elif isinstance(other,tuple):
                other = (other + (None, None))[:2]
                if other[0] is None:
                    other = (0, other[1])
                if isinstance(other[0],int) and other[1] is None:
                    if other[0] == 0:
                        return ZeroOrMore(self)
                    if other[0] == 1:
                        return OneOrMore(self)
                    else:
                        return self*other[0] + ZeroOrMore(self)
                elif isinstance(other[0],int) and isinstance(other[1],int):
                    minElements, optElements = other
                    optElements -= minElements
                else:
                    raise TypeError("cannot multiply 'ParserElement' and ('%s','%s') objects", type(other[0]),type(other[1]))
            else:
                raise TypeError("cannot multiply 'ParserElement' and '%s' objects", type(other))
    
            if minElements < 0:
                raise ValueError("cannot multiply ParserElement by negative value")
            if optElements < 0:
                raise ValueError("second tuple value must be greater or equal to first tuple value")
            if minElements == optElements == 0:
                raise ValueError("cannot multiply ParserElement by 0 or (0,0)")
    
            if (optElements):
                def makeOptionalList(n):
                    if n>1:
                        return Optional(self + makeOptionalList(n-1))
                    else:
                        return Optional(self)
                if minElements:
                    if minElements == 1:
                        ret = self + makeOptionalList(optElements)
                    else:
                        ret = And([self]*minElements) + makeOptionalList(optElements)
                else:
                    ret = makeOptionalList(optElements)
            else:
                if minElements == 1:
                    ret = self
                else:
                    ret = And([self]*minElements)
            return ret
    
        def __rmul__(self, other):
            return self.__mul__(other)
    
        def __or__(self, other ):
            """Implementation of | operator - returns C{L{MatchFirst}}"""
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            if not isinstance( other, ParserElement ):
                warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                        SyntaxWarning, stacklevel=2)
                return None
            return MatchFirst( [ self, other ] )
    
        def __ror__(self, other ):
            """Implementation of | operator when left operand is not a C{L{ParserElement}}"""
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            if not isinstance( other, ParserElement ):
                warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                        SyntaxWarning, stacklevel=2)
                return None
            return other | self
    
        def __xor__(self, other ):
            """Implementation of ^ operator - returns C{L{Or}}"""
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            if not isinstance( other, ParserElement ):
                warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                        SyntaxWarning, stacklevel=2)
                return None
            return Or( [ self, other ] )
    
        def __rxor__(self, other ):
            """Implementation of ^ operator when left operand is not a C{L{ParserElement}}"""
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            if not isinstance( other, ParserElement ):
                warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                        SyntaxWarning, stacklevel=2)
                return None
            return other ^ self
    
        def __and__(self, other ):
            """Implementation of & operator - returns C{L{Each}}"""
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            if not isinstance( other, ParserElement ):
                warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                        SyntaxWarning, stacklevel=2)
                return None
            return Each( [ self, other ] )
    
        def __rand__(self, other ):
            """Implementation of & operator when left operand is not a C{L{ParserElement}}"""
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            if not isinstance( other, ParserElement ):
                warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                        SyntaxWarning, stacklevel=2)
                return None
            return other & self
    
        def __invert__( self ):
            """Implementation of ~ operator - returns C{L{NotAny}}"""
            return NotAny( self )
    
        def __call__(self, name=None):
            """Shortcut for C{L{setResultsName}}, with C{listAllMatches=default}::
                 userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
               could be written as::
                 userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")
                 
               If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
               passed as C{True}.
               
               If C{name} is omitted, same as calling C{L{copy}}.
               """
            if name is not None:
                return self.setResultsName(name)
            else:
                return self.copy()
    
        def suppress( self ):
            """Suppresses the output of this C{ParserElement}; useful to keep punctuation from
               cluttering up returned output.
            """
            return Suppress( self )
    
        def leaveWhitespace( self ):
            """Disables the skipping of whitespace before matching the characters in the
               C{ParserElement}'s defined pattern.  This is normally only used internally by
               the pyparsing module, but may be needed in some whitespace-sensitive grammars.
            """
            self.skipWhitespace = False
            return self
    
        def setWhitespaceChars( self, chars ):
            """Overrides the default whitespace chars
            """
            self.skipWhitespace = True
            self.whiteChars = chars
            self.copyDefaultWhiteChars = False
            return self
    
        def parseWithTabs( self ):
            """Overrides default behavior to expand C{}s to spaces before parsing the input string.
               Must be called before C{parseString} when the input grammar contains elements that
               match C{} characters."""
            self.keepTabs = True
            return self
    
        def ignore( self, other ):
            """Define expression to be ignored (e.g., comments) while doing pattern
               matching; may be called repeatedly, to define multiple comment or other
               ignorable patterns.
            """
            if isinstance( other, Suppress ):
                if other not in self.ignoreExprs:
                    self.ignoreExprs.append( other.copy() )
            else:
                self.ignoreExprs.append( Suppress( other.copy() ) )
            return self
    
        def setDebugActions( self, startAction, successAction, exceptionAction ):
            """Enable display of debugging messages while doing pattern matching."""
            self.debugActions = (startAction or _defaultStartDebugAction,
                                 successAction or _defaultSuccessDebugAction,
                                 exceptionAction or _defaultExceptionDebugAction)
            self.debug = True
            return self
    
        def setDebug( self, flag=True ):
            """Enable display of debugging messages while doing pattern matching.
               Set C{flag} to True to enable, False to disable."""
            if flag:
                self.setDebugActions( _defaultStartDebugAction, _defaultSuccessDebugAction, _defaultExceptionDebugAction )
            else:
                self.debug = False
            return self
    
        def __str__( self ):
            return self.name
    
        def __repr__( self ):
            return _ustr(self)
    
        def streamline( self ):
            self.streamlined = True
            self.strRepr = None
            return self
    
        def checkRecursion( self, parseElementList ):
            pass
    
        def validate( self, validateTrace=[] ):
            """Check defined expressions for valid structure, check for infinite recursive definitions."""
            self.checkRecursion( [] )
    
        def parseFile( self, file_or_filename, parseAll=False ):
            """Execute the parse expression on the given file or filename.
               If a filename is specified (instead of a file object),
               the entire file is opened, read, and closed before parsing.
            """
            try:
                file_contents = file_or_filename.read()
            except AttributeError:
                f = open(file_or_filename, "r")
                file_contents = f.read()
                f.close()
            try:
                return self.parseString(file_contents, parseAll)
            except ParseBaseException as exc:
                if ParserElement.verbose_stacktrace:
                    raise
                else:
                    # catch and re-raise exception from here, clears out pyparsing internal stack trace
                    raise exc
    
        def __eq__(self,other):
            if isinstance(other, ParserElement):
                return self is other or self.__dict__ == other.__dict__
            elif isinstance(other, basestring):
                try:
                    self.parseString(_ustr(other), parseAll=True)
                    return True
                except ParseBaseException:
                    return False
            else:
                return super(ParserElement,self)==other
    
        def __ne__(self,other):
            return not (self == other)
    
        def __hash__(self):
            return hash(id(self))
    
        def __req__(self,other):
            return self == other
    
        def __rne__(self,other):
            return not (self == other)
    
        def runTests(self, tests, parseAll=False):
            """Execute the parse expression on a series of test strings, showing each
               test, the parsed results or where the parse failed. Quick and easy way to
               run a parse expression against a list of sample strings.
               
               Parameters:
                - tests - a list of separate test strings, or a multiline string of test strings
                - parseAll - (default=False) - flag to pass to C{L{parseString}} when running tests           
            """
            if isinstance(tests, basestring):
                tests = map(str.strip, tests.splitlines())
            for t in tests:
                out = [t]
                try:
                    out.append(self.parseString(t, parseAll=parseAll).dump())
                except ParseException as pe:
                    if '\n' in t:
                        out.append(line(pe.loc, t))
                        out.append(' '*(col(pe.loc,t)-1) + '^')
                    else:
                        out.append(' '*pe.loc + '^')
                    out.append(str(pe))
                out.append('')
                print('\n'.join(out))
    
            
    class Token(ParserElement):
        """Abstract C{ParserElement} subclass, for defining atomic matching patterns."""
        def __init__( self ):
            super(Token,self).__init__( savelist=False )
    
    
    class Empty(Token):
        """An empty token, will always match."""
        def __init__( self ):
            super(Empty,self).__init__()
            self.name = "Empty"
            self.mayReturnEmpty = True
            self.mayIndexError = False
    
    
    class NoMatch(Token):
        """A token that will never match."""
        def __init__( self ):
            super(NoMatch,self).__init__()
            self.name = "NoMatch"
            self.mayReturnEmpty = True
            self.mayIndexError = False
            self.errmsg = "Unmatchable token"
    
        def parseImpl( self, instring, loc, doActions=True ):
            raise ParseException(instring, loc, self.errmsg, self)
    
    
    class Literal(Token):
        """Token to exactly match a specified string."""
        def __init__( self, matchString ):
            super(Literal,self).__init__()
            self.match = matchString
            self.matchLen = len(matchString)
            try:
                self.firstMatchChar = matchString[0]
            except IndexError:
                warnings.warn("null string passed to Literal; use Empty() instead",
                                SyntaxWarning, stacklevel=2)
                self.__class__ = Empty
            self.name = '"%s"' % _ustr(self.match)
            self.errmsg = "Expected " + self.name
            self.mayReturnEmpty = False
            self.mayIndexError = False
    
        # Performance tuning: this routine gets called a *lot*
        # if this is a single character match string  and the first character matches,
        # short-circuit as quickly as possible, and avoid calling startswith
        #~ @profile
        def parseImpl( self, instring, loc, doActions=True ):
            if (instring[loc] == self.firstMatchChar and
                (self.matchLen==1 or instring.startswith(self.match,loc)) ):
                return loc+self.matchLen, self.match
            raise ParseException(instring, loc, self.errmsg, self)
    _L = Literal
    ParserElement.literalStringClass = Literal
    
    class Keyword(Token):
        """Token to exactly match a specified string as a keyword, that is, it must be
           immediately followed by a non-keyword character.  Compare with C{L{Literal}}::
             Literal("if") will match the leading C{'if'} in C{'ifAndOnlyIf'}.
             Keyword("if") will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
           Accepts two optional constructor arguments in addition to the keyword string:
           C{identChars} is a string of characters that would be valid identifier characters,
           defaulting to all alphanumerics + "_" and "$"; C{caseless} allows case-insensitive
           matching, default is C{False}.
        """
        DEFAULT_KEYWORD_CHARS = alphanums+"_$"
    
        def __init__( self, matchString, identChars=DEFAULT_KEYWORD_CHARS, caseless=False ):
            super(Keyword,self).__init__()
            self.match = matchString
            self.matchLen = len(matchString)
            try:
                self.firstMatchChar = matchString[0]
            except IndexError:
                warnings.warn("null string passed to Keyword; use Empty() instead",
                                SyntaxWarning, stacklevel=2)
            self.name = '"%s"' % self.match
            self.errmsg = "Expected " + self.name
            self.mayReturnEmpty = False
            self.mayIndexError = False
            self.caseless = caseless
            if caseless:
                self.caselessmatch = matchString.upper()
                identChars = identChars.upper()
            self.identChars = set(identChars)
    
        def parseImpl( self, instring, loc, doActions=True ):
            if self.caseless:
                if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
                     (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) and
                     (loc == 0 or instring[loc-1].upper() not in self.identChars) ):
                    return loc+self.matchLen, self.match
            else:
                if (instring[loc] == self.firstMatchChar and
                    (self.matchLen==1 or instring.startswith(self.match,loc)) and
                    (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen] not in self.identChars) and
                    (loc == 0 or instring[loc-1] not in self.identChars) ):
                    return loc+self.matchLen, self.match
            raise ParseException(instring, loc, self.errmsg, self)
    
        def copy(self):
            c = super(Keyword,self).copy()
            c.identChars = Keyword.DEFAULT_KEYWORD_CHARS
            return c
    
        @staticmethod
        def setDefaultKeywordChars( chars ):
            """Overrides the default Keyword chars
            """
            Keyword.DEFAULT_KEYWORD_CHARS = chars
    
    class CaselessLiteral(Literal):
        """Token to match a specified string, ignoring case of letters.
           Note: the matched results will always be in the case of the given
           match string, NOT the case of the input text.
        """
        def __init__( self, matchString ):
            super(CaselessLiteral,self).__init__( matchString.upper() )
            # Preserve the defining literal.
            self.returnString = matchString
            self.name = "'%s'" % self.returnString
            self.errmsg = "Expected " + self.name
    
        def parseImpl( self, instring, loc, doActions=True ):
            if instring[ loc:loc+self.matchLen ].upper() == self.match:
                return loc+self.matchLen, self.returnString
            raise ParseException(instring, loc, self.errmsg, self)
    
    class CaselessKeyword(Keyword):
        def __init__( self, matchString, identChars=Keyword.DEFAULT_KEYWORD_CHARS ):
            super(CaselessKeyword,self).__init__( matchString, identChars, caseless=True )
    
        def parseImpl( self, instring, loc, doActions=True ):
            if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
                 (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) ):
                return loc+self.matchLen, self.match
            raise ParseException(instring, loc, self.errmsg, self)
    
    class Word(Token):
        """Token for matching words composed of allowed character sets.
           Defined with string containing all allowed initial characters,
           an optional string containing allowed body characters (if omitted,
           defaults to the initial character set), and an optional minimum,
           maximum, and/or exact length.  The default value for C{min} is 1 (a
           minimum value < 1 is not valid); the default values for C{max} and C{exact}
           are 0, meaning no maximum or exact length restriction. An optional
           C{exclude} parameter can list characters that might be found in 
           the input C{bodyChars} string; useful to define a word of all printables
           except for one or two characters, for instance.
        """
        def __init__( self, initChars, bodyChars=None, min=1, max=0, exact=0, asKeyword=False, excludeChars=None ):
            super(Word,self).__init__()
            if excludeChars:
                initChars = ''.join(c for c in initChars if c not in excludeChars)
                if bodyChars:
                    bodyChars = ''.join(c for c in bodyChars if c not in excludeChars)
            self.initCharsOrig = initChars
            self.initChars = set(initChars)
            if bodyChars :
                self.bodyCharsOrig = bodyChars
                self.bodyChars = set(bodyChars)
            else:
                self.bodyCharsOrig = initChars
                self.bodyChars = set(initChars)
    
            self.maxSpecified = max > 0
    
            if min < 1:
                raise ValueError("cannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permitted")
    
            self.minLen = min
    
            if max > 0:
                self.maxLen = max
            else:
                self.maxLen = _MAX_INT
    
            if exact > 0:
                self.maxLen = exact
                self.minLen = exact
    
            self.name = _ustr(self)
            self.errmsg = "Expected " + self.name
            self.mayIndexError = False
            self.asKeyword = asKeyword
    
            if ' ' not in self.initCharsOrig+self.bodyCharsOrig and (min==1 and max==0 and exact==0):
                if self.bodyCharsOrig == self.initCharsOrig:
                    self.reString = "[%s]+" % _escapeRegexRangeChars(self.initCharsOrig)
                elif len(self.initCharsOrig) == 1:
                    self.reString = "%s[%s]*" % \
                                          (re.escape(self.initCharsOrig),
                                          _escapeRegexRangeChars(self.bodyCharsOrig),)
                else:
                    self.reString = "[%s][%s]*" % \
                                          (_escapeRegexRangeChars(self.initCharsOrig),
                                          _escapeRegexRangeChars(self.bodyCharsOrig),)
                if self.asKeyword:
                    self.reString = r"\b"+self.reString+r"\b"
                try:
                    self.re = re.compile( self.reString )
                except:
                    self.re = None
    
        def parseImpl( self, instring, loc, doActions=True ):
            if self.re:
                result = self.re.match(instring,loc)
                if not result:
                    raise ParseException(instring, loc, self.errmsg, self)
    
                loc = result.end()
                return loc, result.group()
    
            if not(instring[ loc ] in self.initChars):
                raise ParseException(instring, loc, self.errmsg, self)
    
            start = loc
            loc += 1
            instrlen = len(instring)
            bodychars = self.bodyChars
            maxloc = start + self.maxLen
            maxloc = min( maxloc, instrlen )
            while loc < maxloc and instring[loc] in bodychars:
                loc += 1
    
            throwException = False
            if loc - start < self.minLen:
                throwException = True
            if self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
                throwException = True
            if self.asKeyword:
                if (start>0 and instring[start-1] in bodychars) or (loc4:
                        return s[:4]+"..."
                    else:
                        return s
    
                if ( self.initCharsOrig != self.bodyCharsOrig ):
                    self.strRepr = "W:(%s,%s)" % ( charsAsStr(self.initCharsOrig), charsAsStr(self.bodyCharsOrig) )
                else:
                    self.strRepr = "W:(%s)" % charsAsStr(self.initCharsOrig)
    
            return self.strRepr
    
    
    class Regex(Token):
        """Token for matching strings that match a given regular expression.
           Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
        """
        compiledREtype = type(re.compile("[A-Z]"))
        def __init__( self, pattern, flags=0):
            """The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags."""
            super(Regex,self).__init__()
    
            if isinstance(pattern, basestring):
                if len(pattern) == 0:
                    warnings.warn("null string passed to Regex; use Empty() instead",
                            SyntaxWarning, stacklevel=2)
    
                self.pattern = pattern
                self.flags = flags
    
                try:
                    self.re = re.compile(self.pattern, self.flags)
                    self.reString = self.pattern
                except sre_constants.error:
                    warnings.warn("invalid pattern (%s) passed to Regex" % pattern,
                        SyntaxWarning, stacklevel=2)
                    raise
    
            elif isinstance(pattern, Regex.compiledREtype):
                self.re = pattern
                self.pattern = \
                self.reString = str(pattern)
                self.flags = flags
                
            else:
                raise ValueError("Regex may only be constructed with a string or a compiled RE object")
    
            self.name = _ustr(self)
            self.errmsg = "Expected " + self.name
            self.mayIndexError = False
            self.mayReturnEmpty = True
    
        def parseImpl( self, instring, loc, doActions=True ):
            result = self.re.match(instring,loc)
            if not result:
                raise ParseException(instring, loc, self.errmsg, self)
    
            loc = result.end()
            d = result.groupdict()
            ret = ParseResults(result.group())
            if d:
                for k in d:
                    ret[k] = d[k]
            return loc,ret
    
        def __str__( self ):
            try:
                return super(Regex,self).__str__()
            except:
                pass
    
            if self.strRepr is None:
                self.strRepr = "Re:(%s)" % repr(self.pattern)
    
            return self.strRepr
    
    
    class QuotedString(Token):
        """Token for matching strings that are delimited by quoting characters.
        """
        def __init__( self, quoteChar, escChar=None, escQuote=None, multiline=False, unquoteResults=True, endQuoteChar=None):
            """
               Defined with the following parameters:
                - quoteChar - string of one or more characters defining the quote delimiting string
                - escChar - character to escape quotes, typically backslash (default=None)
                - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=None)
                - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
                - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
                - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
            """
            super(QuotedString,self).__init__()
    
            # remove white space from quote chars - wont work anyway
            quoteChar = quoteChar.strip()
            if len(quoteChar) == 0:
                warnings.warn("quoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
                raise SyntaxError()
    
            if endQuoteChar is None:
                endQuoteChar = quoteChar
            else:
                endQuoteChar = endQuoteChar.strip()
                if len(endQuoteChar) == 0:
                    warnings.warn("endQuoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
                    raise SyntaxError()
    
            self.quoteChar = quoteChar
            self.quoteCharLen = len(quoteChar)
            self.firstQuoteChar = quoteChar[0]
            self.endQuoteChar = endQuoteChar
            self.endQuoteCharLen = len(endQuoteChar)
            self.escChar = escChar
            self.escQuote = escQuote
            self.unquoteResults = unquoteResults
    
            if multiline:
                self.flags = re.MULTILINE | re.DOTALL
                self.pattern = r'%s(?:[^%s%s]' % \
                    ( re.escape(self.quoteChar),
                      _escapeRegexRangeChars(self.endQuoteChar[0]),
                      (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
            else:
                self.flags = 0
                self.pattern = r'%s(?:[^%s\n\r%s]' % \
                    ( re.escape(self.quoteChar),
                      _escapeRegexRangeChars(self.endQuoteChar[0]),
                      (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
            if len(self.endQuoteChar) > 1:
                self.pattern += (
                    '|(?:' + ')|(?:'.join("%s[^%s]" % (re.escape(self.endQuoteChar[:i]),
                                                   _escapeRegexRangeChars(self.endQuoteChar[i]))
                                        for i in range(len(self.endQuoteChar)-1,0,-1)) + ')'
                    )
            if escQuote:
                self.pattern += (r'|(?:%s)' % re.escape(escQuote))
            if escChar:
                self.pattern += (r'|(?:%s.)' % re.escape(escChar))
                self.escCharReplacePattern = re.escape(self.escChar)+"(.)"
            self.pattern += (r')*%s' % re.escape(self.endQuoteChar))
    
            try:
                self.re = re.compile(self.pattern, self.flags)
                self.reString = self.pattern
            except sre_constants.error:
                warnings.warn("invalid pattern (%s) passed to Regex" % self.pattern,
                    SyntaxWarning, stacklevel=2)
                raise
    
            self.name = _ustr(self)
            self.errmsg = "Expected " + self.name
            self.mayIndexError = False
            self.mayReturnEmpty = True
    
        def parseImpl( self, instring, loc, doActions=True ):
            result = instring[loc] == self.firstQuoteChar and self.re.match(instring,loc) or None
            if not result:
                raise ParseException(instring, loc, self.errmsg, self)
    
            loc = result.end()
            ret = result.group()
    
            if self.unquoteResults:
    
                # strip off quotes
                ret = ret[self.quoteCharLen:-self.endQuoteCharLen]
    
                if isinstance(ret,basestring):
                    # replace escaped characters
                    if self.escChar:
                        ret = re.sub(self.escCharReplacePattern,"\g<1>",ret)
    
                    # replace escaped quotes
                    if self.escQuote:
                        ret = ret.replace(self.escQuote, self.endQuoteChar)
    
            return loc, ret
    
        def __str__( self ):
            try:
                return super(QuotedString,self).__str__()
            except:
                pass
    
            if self.strRepr is None:
                self.strRepr = "quoted string, starting with %s ending with %s" % (self.quoteChar, self.endQuoteChar)
    
            return self.strRepr
    
    
    class CharsNotIn(Token):
        """Token for matching words composed of characters *not* in a given set.
           Defined with string containing all disallowed characters, and an optional
           minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
           minimum value < 1 is not valid); the default values for C{max} and C{exact}
           are 0, meaning no maximum or exact length restriction.
        """
        def __init__( self, notChars, min=1, max=0, exact=0 ):
            super(CharsNotIn,self).__init__()
            self.skipWhitespace = False
            self.notChars = notChars
    
            if min < 1:
                raise ValueError("cannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permitted")
    
            self.minLen = min
    
            if max > 0:
                self.maxLen = max
            else:
                self.maxLen = _MAX_INT
    
            if exact > 0:
                self.maxLen = exact
                self.minLen = exact
    
            self.name = _ustr(self)
            self.errmsg = "Expected " + self.name
            self.mayReturnEmpty = ( self.minLen == 0 )
            self.mayIndexError = False
    
        def parseImpl( self, instring, loc, doActions=True ):
            if instring[loc] in self.notChars:
                raise ParseException(instring, loc, self.errmsg, self)
    
            start = loc
            loc += 1
            notchars = self.notChars
            maxlen = min( start+self.maxLen, len(instring) )
            while loc < maxlen and \
                  (instring[loc] not in notchars):
                loc += 1
    
            if loc - start < self.minLen:
                raise ParseException(instring, loc, self.errmsg, self)
    
            return loc, instring[start:loc]
    
        def __str__( self ):
            try:
                return super(CharsNotIn, self).__str__()
            except:
                pass
    
            if self.strRepr is None:
                if len(self.notChars) > 4:
                    self.strRepr = "!W:(%s...)" % self.notChars[:4]
                else:
                    self.strRepr = "!W:(%s)" % self.notChars
    
            return self.strRepr
    
    class White(Token):
        """Special matching class for matching whitespace.  Normally, whitespace is ignored
           by pyparsing grammars.  This class is included when some whitespace structures
           are significant.  Define with a string containing the whitespace characters to be
           matched; default is C{" \\t\\r\\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
           as defined for the C{L{Word}} class."""
        whiteStrs = {
            " " : "",
            "\t": "",
            "\n": "",
            "\r": "",
            "\f": "",
            }
        def __init__(self, ws=" \t\r\n", min=1, max=0, exact=0):
            super(White,self).__init__()
            self.matchWhite = ws
            self.setWhitespaceChars( "".join(c for c in self.whiteChars if c not in self.matchWhite) )
            #~ self.leaveWhitespace()
            self.name = ("".join(White.whiteStrs[c] for c in self.matchWhite))
            self.mayReturnEmpty = True
            self.errmsg = "Expected " + self.name
    
            self.minLen = min
    
            if max > 0:
                self.maxLen = max
            else:
                self.maxLen = _MAX_INT
    
            if exact > 0:
                self.maxLen = exact
                self.minLen = exact
    
        def parseImpl( self, instring, loc, doActions=True ):
            if not(instring[ loc ] in self.matchWhite):
                raise ParseException(instring, loc, self.errmsg, self)
            start = loc
            loc += 1
            maxloc = start + self.maxLen
            maxloc = min( maxloc, len(instring) )
            while loc < maxloc and instring[loc] in self.matchWhite:
                loc += 1
    
            if loc - start < self.minLen:
                raise ParseException(instring, loc, self.errmsg, self)
    
            return loc, instring[start:loc]
    
    
    class _PositionToken(Token):
        def __init__( self ):
            super(_PositionToken,self).__init__()
            self.name=self.__class__.__name__
            self.mayReturnEmpty = True
            self.mayIndexError = False
    
    class GoToColumn(_PositionToken):
        """Token to advance to a specific column of input text; useful for tabular report scraping."""
        def __init__( self, colno ):
            super(GoToColumn,self).__init__()
            self.col = colno
    
        def preParse( self, instring, loc ):
            if col(loc,instring) != self.col:
                instrlen = len(instring)
                if self.ignoreExprs:
                    loc = self._skipIgnorables( instring, loc )
                while loc < instrlen and instring[loc].isspace() and col( loc, instring ) != self.col :
                    loc += 1
            return loc
    
        def parseImpl( self, instring, loc, doActions=True ):
            thiscol = col( loc, instring )
            if thiscol > self.col:
                raise ParseException( instring, loc, "Text not in expected column", self )
            newloc = loc + self.col - thiscol
            ret = instring[ loc: newloc ]
            return newloc, ret
    
    class LineStart(_PositionToken):
        """Matches if current position is at the beginning of a line within the parse string"""
        def __init__( self ):
            super(LineStart,self).__init__()
            self.setWhitespaceChars( ParserElement.DEFAULT_WHITE_CHARS.replace("\n","") )
            self.errmsg = "Expected start of line"
    
        def preParse( self, instring, loc ):
            preloc = super(LineStart,self).preParse(instring,loc)
            if instring[preloc] == "\n":
                loc += 1
            return loc
    
        def parseImpl( self, instring, loc, doActions=True ):
            if not( loc==0 or
                (loc == self.preParse( instring, 0 )) or
                (instring[loc-1] == "\n") ): #col(loc, instring) != 1:
                raise ParseException(instring, loc, self.errmsg, self)
            return loc, []
    
    class LineEnd(_PositionToken):
        """Matches if current position is at the end of a line within the parse string"""
        def __init__( self ):
            super(LineEnd,self).__init__()
            self.setWhitespaceChars( ParserElement.DEFAULT_WHITE_CHARS.replace("\n","") )
            self.errmsg = "Expected end of line"
    
        def parseImpl( self, instring, loc, doActions=True ):
            if loc len(instring):
                return loc, []
            else:
                raise ParseException(instring, loc, self.errmsg, self)
    
    class WordStart(_PositionToken):
        """Matches if the current position is at the beginning of a Word, and
           is not preceded by any character in a given set of C{wordChars}
           (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
           use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
           the string being parsed, or at the beginning of a line.
        """
        def __init__(self, wordChars = printables):
            super(WordStart,self).__init__()
            self.wordChars = set(wordChars)
            self.errmsg = "Not at the start of a word"
    
        def parseImpl(self, instring, loc, doActions=True ):
            if loc != 0:
                if (instring[loc-1] in self.wordChars or
                    instring[loc] not in self.wordChars):
                    raise ParseException(instring, loc, self.errmsg, self)
            return loc, []
    
    class WordEnd(_PositionToken):
        """Matches if the current position is at the end of a Word, and
           is not followed by any character in a given set of C{wordChars}
           (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
           use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
           the string being parsed, or at the end of a line.
        """
        def __init__(self, wordChars = printables):
            super(WordEnd,self).__init__()
            self.wordChars = set(wordChars)
            self.skipWhitespace = False
            self.errmsg = "Not at the end of a word"
    
        def parseImpl(self, instring, loc, doActions=True ):
            instrlen = len(instring)
            if instrlen>0 and loc maxExcLoc:
                        maxException = err
                        maxExcLoc = err.loc
                except IndexError:
                    if len(instring) > maxExcLoc:
                        maxException = ParseException(instring,len(instring),e.errmsg,self)
                        maxExcLoc = len(instring)
                else:
                    # save match among all matches, to retry longest to shortest
                    matches.append((loc2, e))
    
            if matches:
                matches.sort(key=lambda x: -x[0])
                for _,e in matches:
                    try:
                        return e._parse( instring, loc, doActions )
                    except ParseException as err:
                        err.__traceback__ = None
                        if err.loc > maxExcLoc:
                            maxException = err
                            maxExcLoc = err.loc
    
            if maxException is not None:
                maxException.msg = self.errmsg
                raise maxException
            else:
                raise ParseException(instring, loc, "no defined alternatives to match", self)
    
    
        def __ixor__(self, other ):
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            return self.append( other ) #Or( [ self, other ] )
    
        def __str__( self ):
            if hasattr(self,"name"):
                return self.name
    
            if self.strRepr is None:
                self.strRepr = "{" + " ^ ".join(_ustr(e) for e in self.exprs) + "}"
    
            return self.strRepr
    
        def checkRecursion( self, parseElementList ):
            subRecCheckList = parseElementList[:] + [ self ]
            for e in self.exprs:
                e.checkRecursion( subRecCheckList )
    
    
    class MatchFirst(ParseExpression):
        """Requires that at least one C{ParseExpression} is found.
           If two expressions match, the first one listed is the one that will match.
           May be constructed using the C{'|'} operator.
        """
        def __init__( self, exprs, savelist = False ):
            super(MatchFirst,self).__init__(exprs, savelist)
            if self.exprs:
                self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
            else:
                self.mayReturnEmpty = True
    
        def parseImpl( self, instring, loc, doActions=True ):
            maxExcLoc = -1
            maxException = None
            for e in self.exprs:
                try:
                    ret = e._parse( instring, loc, doActions )
                    return ret
                except ParseException as err:
                    if err.loc > maxExcLoc:
                        maxException = err
                        maxExcLoc = err.loc
                except IndexError:
                    if len(instring) > maxExcLoc:
                        maxException = ParseException(instring,len(instring),e.errmsg,self)
                        maxExcLoc = len(instring)
    
            # only got here if no expression matched, raise exception for match that made it the furthest
            else:
                if maxException is not None:
                    maxException.msg = self.errmsg
                    raise maxException
                else:
                    raise ParseException(instring, loc, "no defined alternatives to match", self)
    
        def __ior__(self, other ):
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass( other )
            return self.append( other ) #MatchFirst( [ self, other ] )
    
        def __str__( self ):
            if hasattr(self,"name"):
                return self.name
    
            if self.strRepr is None:
                self.strRepr = "{" + " | ".join(_ustr(e) for e in self.exprs) + "}"
    
            return self.strRepr
    
        def checkRecursion( self, parseElementList ):
            subRecCheckList = parseElementList[:] + [ self ]
            for e in self.exprs:
                e.checkRecursion( subRecCheckList )
    
    
    class Each(ParseExpression):
        """Requires all given C{ParseExpression}s to be found, but in any order.
           Expressions may be separated by whitespace.
           May be constructed using the C{'&'} operator.
        """
        def __init__( self, exprs, savelist = True ):
            super(Each,self).__init__(exprs, savelist)
            self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
            self.skipWhitespace = True
            self.initExprGroups = True
    
        def parseImpl( self, instring, loc, doActions=True ):
            if self.initExprGroups:
                self.opt1map = dict((id(e.expr),e) for e in self.exprs if isinstance(e,Optional))
                opt1 = [ e.expr for e in self.exprs if isinstance(e,Optional) ]
                opt2 = [ e for e in self.exprs if e.mayReturnEmpty and not isinstance(e,Optional)]
                self.optionals = opt1 + opt2
                self.multioptionals = [ e.expr for e in self.exprs if isinstance(e,ZeroOrMore) ]
                self.multirequired = [ e.expr for e in self.exprs if isinstance(e,OneOrMore) ]
                self.required = [ e for e in self.exprs if not isinstance(e,(Optional,ZeroOrMore,OneOrMore)) ]
                self.required += self.multirequired
                self.initExprGroups = False
            tmpLoc = loc
            tmpReqd = self.required[:]
            tmpOpt  = self.optionals[:]
            matchOrder = []
    
            keepMatching = True
            while keepMatching:
                tmpExprs = tmpReqd + tmpOpt + self.multioptionals + self.multirequired
                failed = []
                for e in tmpExprs:
                    try:
                        tmpLoc = e.tryParse( instring, tmpLoc )
                    except ParseException:
                        failed.append(e)
                    else:
                        matchOrder.append(self.opt1map.get(id(e),e))
                        if e in tmpReqd:
                            tmpReqd.remove(e)
                        elif e in tmpOpt:
                            tmpOpt.remove(e)
                if len(failed) == len(tmpExprs):
                    keepMatching = False
    
            if tmpReqd:
                missing = ", ".join(_ustr(e) for e in tmpReqd)
                raise ParseException(instring,loc,"Missing one or more required elements (%s)" % missing )
    
            # add any unmatched Optionals, in case they have default values defined
            matchOrder += [e for e in self.exprs if isinstance(e,Optional) and e.expr in tmpOpt]
    
            resultlist = []
            for e in matchOrder:
                loc,results = e._parse(instring,loc,doActions)
                resultlist.append(results)
    
            finalResults = ParseResults([])
            for r in resultlist:
                dups = {}
                for k in r.keys():
                    if k in finalResults:
                        tmp = ParseResults(finalResults[k])
                        tmp += ParseResults(r[k])
                        dups[k] = tmp
                finalResults += ParseResults(r)
                for k,v in dups.items():
                    finalResults[k] = v
            return loc, finalResults
    
        def __str__( self ):
            if hasattr(self,"name"):
                return self.name
    
            if self.strRepr is None:
                self.strRepr = "{" + " & ".join(_ustr(e) for e in self.exprs) + "}"
    
            return self.strRepr
    
        def checkRecursion( self, parseElementList ):
            subRecCheckList = parseElementList[:] + [ self ]
            for e in self.exprs:
                e.checkRecursion( subRecCheckList )
    
    
    class ParseElementEnhance(ParserElement):
        """Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens."""
        def __init__( self, expr, savelist=False ):
            super(ParseElementEnhance,self).__init__(savelist)
            if isinstance( expr, basestring ):
                expr = Literal(expr)
            self.expr = expr
            self.strRepr = None
            if expr is not None:
                self.mayIndexError = expr.mayIndexError
                self.mayReturnEmpty = expr.mayReturnEmpty
                self.setWhitespaceChars( expr.whiteChars )
                self.skipWhitespace = expr.skipWhitespace
                self.saveAsList = expr.saveAsList
                self.callPreparse = expr.callPreparse
                self.ignoreExprs.extend(expr.ignoreExprs)
    
        def parseImpl( self, instring, loc, doActions=True ):
            if self.expr is not None:
                return self.expr._parse( instring, loc, doActions, callPreParse=False )
            else:
                raise ParseException("",loc,self.errmsg,self)
    
        def leaveWhitespace( self ):
            self.skipWhitespace = False
            self.expr = self.expr.copy()
            if self.expr is not None:
                self.expr.leaveWhitespace()
            return self
    
        def ignore( self, other ):
            if isinstance( other, Suppress ):
                if other not in self.ignoreExprs:
                    super( ParseElementEnhance, self).ignore( other )
                    if self.expr is not None:
                        self.expr.ignore( self.ignoreExprs[-1] )
            else:
                super( ParseElementEnhance, self).ignore( other )
                if self.expr is not None:
                    self.expr.ignore( self.ignoreExprs[-1] )
            return self
    
        def streamline( self ):
            super(ParseElementEnhance,self).streamline()
            if self.expr is not None:
                self.expr.streamline()
            return self
    
        def checkRecursion( self, parseElementList ):
            if self in parseElementList:
                raise RecursiveGrammarException( parseElementList+[self] )
            subRecCheckList = parseElementList[:] + [ self ]
            if self.expr is not None:
                self.expr.checkRecursion( subRecCheckList )
    
        def validate( self, validateTrace=[] ):
            tmp = validateTrace[:]+[self]
            if self.expr is not None:
                self.expr.validate(tmp)
            self.checkRecursion( [] )
    
        def __str__( self ):
            try:
                return super(ParseElementEnhance,self).__str__()
            except:
                pass
    
            if self.strRepr is None and self.expr is not None:
                self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.expr) )
            return self.strRepr
    
    
    class FollowedBy(ParseElementEnhance):
        """Lookahead matching of the given parse expression.  C{FollowedBy}
        does *not* advance the parsing position within the input string, it only
        verifies that the specified parse expression matches at the current
        position.  C{FollowedBy} always returns a null token list."""
        def __init__( self, expr ):
            super(FollowedBy,self).__init__(expr)
            self.mayReturnEmpty = True
    
        def parseImpl( self, instring, loc, doActions=True ):
            self.expr.tryParse( instring, loc )
            return loc, []
    
    
    class NotAny(ParseElementEnhance):
        """Lookahead to disallow matching with the given parse expression.  C{NotAny}
        does *not* advance the parsing position within the input string, it only
        verifies that the specified parse expression does *not* match at the current
        position.  Also, C{NotAny} does *not* skip over leading whitespace. C{NotAny}
        always returns a null token list.  May be constructed using the '~' operator."""
        def __init__( self, expr ):
            super(NotAny,self).__init__(expr)
            #~ self.leaveWhitespace()
            self.skipWhitespace = False  # do NOT use self.leaveWhitespace(), don't want to propagate to exprs
            self.mayReturnEmpty = True
            self.errmsg = "Found unwanted token, "+_ustr(self.expr)
    
        def parseImpl( self, instring, loc, doActions=True ):
            try:
                self.expr.tryParse( instring, loc )
            except (ParseException,IndexError):
                pass
            else:
                raise ParseException(instring, loc, self.errmsg, self)
            return loc, []
    
        def __str__( self ):
            if hasattr(self,"name"):
                return self.name
    
            if self.strRepr is None:
                self.strRepr = "~{" + _ustr(self.expr) + "}"
    
            return self.strRepr
    
    
    class ZeroOrMore(ParseElementEnhance):
        """Optional repetition of zero or more of the given expression."""
        def __init__( self, expr ):
            super(ZeroOrMore,self).__init__(expr)
            self.mayReturnEmpty = True
    
        def parseImpl( self, instring, loc, doActions=True ):
            tokens = []
            try:
                loc, tokens = self.expr._parse( instring, loc, doActions, callPreParse=False )
                hasIgnoreExprs = ( len(self.ignoreExprs) > 0 )
                while 1:
                    if hasIgnoreExprs:
                        preloc = self._skipIgnorables( instring, loc )
                    else:
                        preloc = loc
                    loc, tmptokens = self.expr._parse( instring, preloc, doActions )
                    if tmptokens or tmptokens.haskeys():
                        tokens += tmptokens
            except (ParseException,IndexError):
                pass
    
            return loc, tokens
    
        def __str__( self ):
            if hasattr(self,"name"):
                return self.name
    
            if self.strRepr is None:
                self.strRepr = "[" + _ustr(self.expr) + "]..."
    
            return self.strRepr
    
        def setResultsName( self, name, listAllMatches=False ):
            ret = super(ZeroOrMore,self).setResultsName(name,listAllMatches)
            ret.saveAsList = True
            return ret
    
    
    class OneOrMore(ParseElementEnhance):
        """Repetition of one or more of the given expression."""
        def parseImpl( self, instring, loc, doActions=True ):
            # must be at least one
            loc, tokens = self.expr._parse( instring, loc, doActions, callPreParse=False )
            try:
                hasIgnoreExprs = ( len(self.ignoreExprs) > 0 )
                while 1:
                    if hasIgnoreExprs:
                        preloc = self._skipIgnorables( instring, loc )
                    else:
                        preloc = loc
                    loc, tmptokens = self.expr._parse( instring, preloc, doActions )
                    if tmptokens or tmptokens.haskeys():
                        tokens += tmptokens
            except (ParseException,IndexError):
                pass
    
            return loc, tokens
    
        def __str__( self ):
            if hasattr(self,"name"):
                return self.name
    
            if self.strRepr is None:
                self.strRepr = "{" + _ustr(self.expr) + "}..."
    
            return self.strRepr
    
        def setResultsName( self, name, listAllMatches=False ):
            ret = super(OneOrMore,self).setResultsName(name,listAllMatches)
            ret.saveAsList = True
            return ret
    
    class _NullToken(object):
        def __bool__(self):
            return False
        __nonzero__ = __bool__
        def __str__(self):
            return ""
    
    _optionalNotMatched = _NullToken()
    class Optional(ParseElementEnhance):
        """Optional matching of the given expression.
           A default return string can also be specified, if the optional expression
           is not found.
        """
        def __init__( self, expr, default=_optionalNotMatched ):
            super(Optional,self).__init__( expr, savelist=False )
            self.defaultValue = default
            self.mayReturnEmpty = True
    
        def parseImpl( self, instring, loc, doActions=True ):
            try:
                loc, tokens = self.expr._parse( instring, loc, doActions, callPreParse=False )
            except (ParseException,IndexError):
                if self.defaultValue is not _optionalNotMatched:
                    if self.expr.resultsName:
                        tokens = ParseResults([ self.defaultValue ])
                        tokens[self.expr.resultsName] = self.defaultValue
                    else:
                        tokens = [ self.defaultValue ]
                else:
                    tokens = []
            return loc, tokens
    
        def __str__( self ):
            if hasattr(self,"name"):
                return self.name
    
            if self.strRepr is None:
                self.strRepr = "[" + _ustr(self.expr) + "]"
    
            return self.strRepr
    
    
    class SkipTo(ParseElementEnhance):
        """Token for skipping over all undefined text until the matched expression is found.
           If C{include} is set to true, the matched expression is also parsed (the skipped text
           and matched expression are returned as a 2-element list).  The C{ignore}
           argument is used to define grammars (typically quoted strings and comments) that
           might contain false matches.
        """
        def __init__( self, other, include=False, ignore=None, failOn=None ):
            super( SkipTo, self ).__init__( other )
            self.ignoreExpr = ignore
            self.mayReturnEmpty = True
            self.mayIndexError = False
            self.includeMatch = include
            self.asList = False
            if failOn is not None and isinstance(failOn, basestring):
                self.failOn = Literal(failOn)
            else:
                self.failOn = failOn
            self.errmsg = "No match found for "+_ustr(self.expr)
    
        def parseImpl( self, instring, loc, doActions=True ):
            startLoc = loc
            instrlen = len(instring)
            expr = self.expr
            failParse = False
            while loc <= instrlen:
                try:
                    if self.failOn:
                        try:
                            self.failOn.tryParse(instring, loc)
                        except ParseBaseException:
                            pass
                        else:
                            failParse = True
                            raise ParseException(instring, loc, "Found expression " + str(self.failOn))
                        failParse = False
                    if self.ignoreExpr is not None:
                        while 1:
                            try:
                                loc = self.ignoreExpr.tryParse(instring,loc)
                                # print("found ignoreExpr, advance to", loc)
                            except ParseBaseException:
                                break
                    expr._parse( instring, loc, doActions=False, callPreParse=False )
                    skipText = instring[startLoc:loc]
                    if self.includeMatch:
                        loc,mat = expr._parse(instring,loc,doActions,callPreParse=False)
                        if mat:
                            skipRes = ParseResults( skipText )
                            skipRes += mat
                            return loc, [ skipRes ]
                        else:
                            return loc, [ skipText ]
                    else:
                        return loc, [ skipText ]
                except (ParseException,IndexError):
                    if failParse:
                        raise
                    else:
                        loc += 1
            raise ParseException(instring, loc, self.errmsg, self)
    
    class Forward(ParseElementEnhance):
        """Forward declaration of an expression to be defined later -
           used for recursive grammars, such as algebraic infix notation.
           When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.
    
           Note: take care when assigning to C{Forward} not to overlook precedence of operators.
           Specifically, '|' has a lower precedence than '<<', so that::
              fwdExpr << a | b | c
           will actually be evaluated as::
              (fwdExpr << a) | b | c
           thereby leaving b and c out as parseable alternatives.  It is recommended that you
           explicitly group the values inserted into the C{Forward}::
              fwdExpr << (a | b | c)
           Converting to use the '<<=' operator instead will avoid this problem.
        """
        def __init__( self, other=None ):
            super(Forward,self).__init__( other, savelist=False )
    
        def __lshift__( self, other ):
            if isinstance( other, basestring ):
                other = ParserElement.literalStringClass(other)
            self.expr = other
            self.mayReturnEmpty = other.mayReturnEmpty
            self.strRepr = None
            self.mayIndexError = self.expr.mayIndexError
            self.mayReturnEmpty = self.expr.mayReturnEmpty
            self.setWhitespaceChars( self.expr.whiteChars )
            self.skipWhitespace = self.expr.skipWhitespace
            self.saveAsList = self.expr.saveAsList
            self.ignoreExprs.extend(self.expr.ignoreExprs)
            return self
            
        def __ilshift__(self, other):
            return self << other
        
        def leaveWhitespace( self ):
            self.skipWhitespace = False
            return self
    
        def streamline( self ):
            if not self.streamlined:
                self.streamlined = True
                if self.expr is not None:
                    self.expr.streamline()
            return self
    
        def validate( self, validateTrace=[] ):
            if self not in validateTrace:
                tmp = validateTrace[:]+[self]
                if self.expr is not None:
                    self.expr.validate(tmp)
            self.checkRecursion([])
    
        def __str__( self ):
            if hasattr(self,"name"):
                return self.name
    
            self._revertClass = self.__class__
            self.__class__ = _ForwardNoRecurse
            try:
                if self.expr is not None:
                    retString = _ustr(self.expr)
                else:
                    retString = "None"
            finally:
                self.__class__ = self._revertClass
            return self.__class__.__name__ + ": " + retString
    
        def copy(self):
            if self.expr is not None:
                return super(Forward,self).copy()
            else:
                ret = Forward()
                ret <<= self
                return ret
    
    class _ForwardNoRecurse(Forward):
        def __str__( self ):
            return "..."
    
    class TokenConverter(ParseElementEnhance):
        """Abstract subclass of C{ParseExpression}, for converting parsed results."""
        def __init__( self, expr, savelist=False ):
            super(TokenConverter,self).__init__( expr )#, savelist )
            self.saveAsList = False
    
    class Upcase(TokenConverter):
        """Converter to upper case all matching tokens."""
        def __init__(self, *args):
            super(Upcase,self).__init__(*args)
            warnings.warn("Upcase class is deprecated, use upcaseTokens parse action instead",
                           DeprecationWarning,stacklevel=2)
    
        def postParse( self, instring, loc, tokenlist ):
            return list(map( str.upper, tokenlist ))
    
    
    class Combine(TokenConverter):
        """Converter to concatenate all matching tokens to a single string.
           By default, the matching patterns must also be contiguous in the input string;
           this can be disabled by specifying C{'adjacent=False'} in the constructor.
        """
        def __init__( self, expr, joinString="", adjacent=True ):
            super(Combine,self).__init__( expr )
            # suppress whitespace-stripping in contained parse expressions, but re-enable it on the Combine itself
            if adjacent:
                self.leaveWhitespace()
            self.adjacent = adjacent
            self.skipWhitespace = True
            self.joinString = joinString
            self.callPreparse = True
    
        def ignore( self, other ):
            if self.adjacent:
                ParserElement.ignore(self, other)
            else:
                super( Combine, self).ignore( other )
            return self
    
        def postParse( self, instring, loc, tokenlist ):
            retToks = tokenlist.copy()
            del retToks[:]
            retToks += ParseResults([ "".join(tokenlist._asStringList(self.joinString)) ], modal=self.modalResults)
    
            if self.resultsName and retToks.haskeys():
                return [ retToks ]
            else:
                return retToks
    
    class Group(TokenConverter):
        """Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions."""
        def __init__( self, expr ):
            super(Group,self).__init__( expr )
            self.saveAsList = True
    
        def postParse( self, instring, loc, tokenlist ):
            return [ tokenlist ]
    
    class Dict(TokenConverter):
        """Converter to return a repetitive expression as a list, but also as a dictionary.
           Each element can also be referenced using the first token in the expression as its key.
           Useful for tabular report scraping when the first column can be used as a item key.
        """
        def __init__( self, expr ):
            super(Dict,self).__init__( expr )
            self.saveAsList = True
    
        def postParse( self, instring, loc, tokenlist ):
            for i,tok in enumerate(tokenlist):
                if len(tok) == 0:
                    continue
                ikey = tok[0]
                if isinstance(ikey,int):
                    ikey = _ustr(tok[0]).strip()
                if len(tok)==1:
                    tokenlist[ikey] = _ParseResultsWithOffset("",i)
                elif len(tok)==2 and not isinstance(tok[1],ParseResults):
                    tokenlist[ikey] = _ParseResultsWithOffset(tok[1],i)
                else:
                    dictvalue = tok.copy() #ParseResults(i)
                    del dictvalue[0]
                    if len(dictvalue)!= 1 or (isinstance(dictvalue,ParseResults) and dictvalue.haskeys()):
                        tokenlist[ikey] = _ParseResultsWithOffset(dictvalue,i)
                    else:
                        tokenlist[ikey] = _ParseResultsWithOffset(dictvalue[0],i)
    
            if self.resultsName:
                return [ tokenlist ]
            else:
                return tokenlist
    
    
    class Suppress(TokenConverter):
        """Converter for ignoring the results of a parsed expression."""
        def postParse( self, instring, loc, tokenlist ):
            return []
    
        def suppress( self ):
            return self
    
    
    class OnlyOnce(object):
        """Wrapper for parse actions, to ensure they are only called once."""
        def __init__(self, methodCall):
            self.callable = _trim_arity(methodCall)
            self.called = False
        def __call__(self,s,l,t):
            if not self.called:
                results = self.callable(s,l,t)
                self.called = True
                return results
            raise ParseException(s,l,"")
        def reset(self):
            self.called = False
    
    def traceParseAction(f):
        """Decorator for debugging parse actions."""
        f = _trim_arity(f)
        def z(*paArgs):
            thisFunc = f.func_name
            s,l,t = paArgs[-3:]
            if len(paArgs)>3:
                thisFunc = paArgs[0].__class__.__name__ + '.' + thisFunc
            sys.stderr.write( ">>entering %s(line: '%s', %d, %s)\n" % (thisFunc,line(l,s),l,t) )
            try:
                ret = f(*paArgs)
            except Exception as exc:
                sys.stderr.write( "<", "|".join( [ _escapeRegexChars(sym) for sym in symbols] ))
            try:
                if len(symbols)==len("".join(symbols)):
                    return Regex( "[%s]" % "".join(_escapeRegexRangeChars(sym) for sym in symbols) )
                else:
                    return Regex( "|".join(re.escape(sym) for sym in symbols) )
            except:
                warnings.warn("Exception creating Regex for oneOf, building MatchFirst",
                        SyntaxWarning, stacklevel=2)
    
    
        # last resort, just use MatchFirst
        return MatchFirst( [ parseElementClass(sym) for sym in symbols ] )
    
    def dictOf( key, value ):
        """Helper to easily and clearly define a dictionary by specifying the respective patterns
           for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
           in the proper order.  The key pattern can include delimiting markers or punctuation,
           as long as they are suppressed, thereby leaving the significant key text.  The value
           pattern can include named results, so that the C{Dict} results can include named token
           fields.
        """
        return Dict( ZeroOrMore( Group ( key + value ) ) )
    
    def originalTextFor(expr, asString=True):
        """Helper to return the original, untokenized text for a given expression.  Useful to
           restore the parsed fields of an HTML start tag into the raw tag text itself, or to
           revert separate tokens with intervening whitespace back to the original matching
           input text. Simpler to use than the parse action C{L{keepOriginalText}}, and does not
           require the inspect module to chase up the call stack.  By default, returns a 
           string containing the original parsed text.  
           
           If the optional C{asString} argument is passed as C{False}, then the return value is a 
           C{L{ParseResults}} containing any results names that were originally matched, and a 
           single token containing the original matched text from the input string.  So if 
           the expression passed to C{L{originalTextFor}} contains expressions with defined
           results names, you must set C{asString} to C{False} if you want to preserve those
           results name values."""
        locMarker = Empty().setParseAction(lambda s,loc,t: loc)
        endlocMarker = locMarker.copy()
        endlocMarker.callPreparse = False
        matchExpr = locMarker("_original_start") + expr + endlocMarker("_original_end")
        if asString:
            extractText = lambda s,l,t: s[t._original_start:t._original_end]
        else:
            def extractText(s,l,t):
                del t[:]
                t.insert(0, s[t._original_start:t._original_end])
                del t["_original_start"]
                del t["_original_end"]
        matchExpr.setParseAction(extractText)
        return matchExpr
    
    def ungroup(expr): 
        """Helper to undo pyparsing's default grouping of And expressions, even
           if all but one are non-empty."""
        return TokenConverter(expr).setParseAction(lambda t:t[0])
    
    def locatedExpr(expr):
        """Helper to decorate a returned token with its starting and ending locations in the input string.
           This helper adds the following results names:
            - locn_start = location where matched expression begins
            - locn_end = location where matched expression ends
            - value = the actual parsed results
    
           Be careful if the input text contains C{} characters, you may want to call
           C{L{ParserElement.parseWithTabs}}
        """
        locator = Empty().setParseAction(lambda s,l,t: l)
        return Group(locator("locn_start") + expr("value") + locator.copy().leaveWhitespace()("locn_end"))
    
    
    # convenience constants for positional expressions
    empty       = Empty().setName("empty")
    lineStart   = LineStart().setName("lineStart")
    lineEnd     = LineEnd().setName("lineEnd")
    stringStart = StringStart().setName("stringStart")
    stringEnd   = StringEnd().setName("stringEnd")
    
    _escapedPunc = Word( _bslash, r"\[]-*.$+^?()~ ", exact=2 ).setParseAction(lambda s,l,t:t[0][1])
    _escapedHexChar = Regex(r"\\0?[xX][0-9a-fA-F]+").setParseAction(lambda s,l,t:unichr(int(t[0].lstrip(r'\0x'),16)))
    _escapedOctChar = Regex(r"\\0[0-7]+").setParseAction(lambda s,l,t:unichr(int(t[0][1:],8)))
    _singleChar = _escapedPunc | _escapedHexChar | _escapedOctChar | Word(printables, excludeChars=r'\]', exact=1) | Regex(r"\w", re.UNICODE)
    _charRange = Group(_singleChar + Suppress("-") + _singleChar)
    _reBracketExpr = Literal("[") + Optional("^").setResultsName("negate") + Group( OneOrMore( _charRange | _singleChar ) ).setResultsName("body") + "]"
    
    def srange(s):
        r"""Helper to easily define string ranges for use in Word construction.  Borrows
           syntax from regexp '[]' string range definitions::
              srange("[0-9]")   -> "0123456789"
              srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
              srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
           The input string must be enclosed in []'s, and the returned string is the expanded
           character set joined into a single string.
           The values enclosed in the []'s may be::
              a single character
              an escaped character with a leading backslash (such as \- or \])
              an escaped hex character with a leading '\x' (\x21, which is a '!' character) 
                (\0x## is also supported for backwards compatibility) 
              an escaped octal character with a leading '\0' (\041, which is a '!' character)
              a range of any of the above, separated by a dash ('a-z', etc.)
              any combination of the above ('aeiouy', 'a-zA-Z0-9_$', etc.)
        """
        _expanded = lambda p: p if not isinstance(p,ParseResults) else ''.join(unichr(c) for c in range(ord(p[0]),ord(p[1])+1))
        try:
            return "".join(_expanded(part) for part in _reBracketExpr.parseString(s).body)
        except:
            return ""
    
    def matchOnlyAtCol(n):
        """Helper method for defining parse actions that require matching at a specific
           column in the input text.
        """
        def verifyCol(strg,locn,toks):
            if col(locn,strg) != n:
                raise ParseException(strg,locn,"matched token not at column %d" % n)
        return verifyCol
    
    def replaceWith(replStr):
        """Helper method for common parse actions that simply return a literal value.  Especially
           useful when used with C{L{transformString}()}.
        """
        #def _replFunc(*args):
        #    return [replStr]
        #return _replFunc
        return functools.partial(next, itertools.repeat([replStr]))
    
    def removeQuotes(s,l,t):
        """Helper parse action for removing quotation marks from parsed quoted strings.
           To use, add this parse action to quoted string using::
             quotedString.setParseAction( removeQuotes )
        """
        return t[0][1:-1]
    
    def upcaseTokens(s,l,t):
        """Helper parse action to convert tokens to upper case."""
        return [ tt.upper() for tt in map(_ustr,t) ]
    
    def downcaseTokens(s,l,t):
        """Helper parse action to convert tokens to lower case."""
        return [ tt.lower() for tt in map(_ustr,t) ]
    
    def keepOriginalText(s,startLoc,t):
        """DEPRECATED - use new helper method C{L{originalTextFor}}.
           Helper parse action to preserve original parsed text,
           overriding any nested parse actions."""
        try:
            endloc = getTokensEndLoc()
        except ParseException:
            raise ParseFatalException("incorrect usage of keepOriginalText - may only be called as a parse action")
        del t[:]
        t += ParseResults(s[startLoc:endloc])
        return t
    
    def getTokensEndLoc():
        """Method to be called from within a parse action to determine the end
           location of the parsed tokens."""
        import inspect
        fstack = inspect.stack()
        try:
            # search up the stack (through intervening argument normalizers) for correct calling routine
            for f in fstack[2:]:
                if f[3] == "_parseNoCache":
                    endloc = f[0].f_locals["loc"]
                    return endloc
            else:
                raise ParseFatalException("incorrect usage of getTokensEndLoc - may only be called from within a parse action")
        finally:
            del fstack
    
    def _makeTags(tagStr, xml):
        """Internal helper to construct opening and closing tag expressions, given a tag name"""
        if isinstance(tagStr,basestring):
            resname = tagStr
            tagStr = Keyword(tagStr, caseless=not xml)
        else:
            resname = tagStr.name
    
        tagAttrName = Word(alphas,alphanums+"_-:")
        if (xml):
            tagAttrValue = dblQuotedString.copy().setParseAction( removeQuotes )
            openTag = Suppress("<") + tagStr("tag") + \
                    Dict(ZeroOrMore(Group( tagAttrName + Suppress("=") + tagAttrValue ))) + \
                    Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
        else:
            printablesLessRAbrack = "".join(c for c in printables if c not in ">")
            tagAttrValue = quotedString.copy().setParseAction( removeQuotes ) | Word(printablesLessRAbrack)
            openTag = Suppress("<") + tagStr("tag") + \
                    Dict(ZeroOrMore(Group( tagAttrName.setParseAction(downcaseTokens) + \
                    Optional( Suppress("=") + tagAttrValue ) ))) + \
                    Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
        closeTag = Combine(_L("")
    
        openTag = openTag.setResultsName("start"+"".join(resname.replace(":"," ").title().split())).setName("<%s>" % tagStr)
        closeTag = closeTag.setResultsName("end"+"".join(resname.replace(":"," ").title().split())).setName("" % tagStr)
        openTag.tag = resname
        closeTag.tag = resname
        return openTag, closeTag
    
    def makeHTMLTags(tagStr):
        """Helper to construct opening and closing tag expressions for HTML, given a tag name"""
        return _makeTags( tagStr, False )
    
    def makeXMLTags(tagStr):
        """Helper to construct opening and closing tag expressions for XML, given a tag name"""
        return _makeTags( tagStr, True )
    
    def withAttribute(*args,**attrDict):
        """Helper to create a validating parse action to be used with start tags created
           with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
           with a required attribute value, to avoid false matches on common tags such as
           C{} or C{
    }. Call C{withAttribute} with a series of attribute names and values. Specify the list of filter attributes names and values as: - keyword arguments, as in C{(align="right")}, or - as an explicit dict with C{**} operator, when an attribute name is also a Python reserved word, as in C{**{"class":"Customer", "align":"right"}} - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") ) For attribute names with a namespace prefix, you must use the second form. Attribute names are matched insensitive to upper/lower case. If just testing for C{class} (with or without a namespace), use C{L{withClass}}. To verify that the attribute exists, but without specifying a value, pass C{withAttribute.ANY_VALUE} as the value. """ if args: attrs = args[:] else: attrs = attrDict.items() attrs = [(k,v) for k,v in attrs] def pa(s,l,tokens): for attrName,attrValue in attrs: if attrName not in tokens: raise ParseException(s,l,"no matching attribute " + attrName) if attrValue != withAttribute.ANY_VALUE and tokens[attrName] != attrValue: raise ParseException(s,l,"attribute '%s' has value '%s', must be '%s'" % (attrName, tokens[attrName], attrValue)) return pa withAttribute.ANY_VALUE = object() def withClass(classname, namespace=''): """Simplified version of C{L{withAttribute}} when matching on a div class - made difficult because C{class} is a reserved word in Python. """ classattr = "%s:class" % namespace if namespace else "class" return withAttribute(**{classattr : classname}) opAssoc = _Constants() opAssoc.LEFT = object() opAssoc.RIGHT = object() def infixNotation( baseExpr, opList, lpar=Suppress('('), rpar=Suppress(')') ): """Helper method for constructing grammars of expressions made up of operators working in a precedence hierarchy. Operators may be unary or binary, left- or right-associative. Parse actions can also be attached to operator expressions. Parameters: - baseExpr - expression representing the most basic element for the nested - opList - list of tuples, one for each operator precedence level in the expression grammar; each tuple is of the form (opExpr, numTerms, rightLeftAssoc, parseAction), where: - opExpr is the pyparsing expression for the operator; may also be a string, which will be converted to a Literal; if numTerms is 3, opExpr is a tuple of two expressions, for the two operators separating the 3 terms - numTerms is the number of terms for this operator (must be 1, 2, or 3) - rightLeftAssoc is the indicator whether the operator is right or left associative, using the pyparsing-defined constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}. - parseAction is the parse action to be associated with expressions matching this operator expression (the parse action tuple member may be omitted) - lpar - expression for matching left-parentheses (default=Suppress('(')) - rpar - expression for matching right-parentheses (default=Suppress(')')) """ ret = Forward() lastExpr = baseExpr | ( lpar + ret + rpar ) for i,operDef in enumerate(opList): opExpr,arity,rightLeftAssoc,pa = (operDef + (None,))[:4] if arity == 3: if opExpr is None or len(opExpr) != 2: raise ValueError("if numterms=3, opExpr must be a tuple or list of two expressions") opExpr1, opExpr2 = opExpr thisExpr = Forward()#.setName("expr%d" % i) if rightLeftAssoc == opAssoc.LEFT: if arity == 1: matchExpr = FollowedBy(lastExpr + opExpr) + Group( lastExpr + OneOrMore( opExpr ) ) elif arity == 2: if opExpr is not None: matchExpr = FollowedBy(lastExpr + opExpr + lastExpr) + Group( lastExpr + OneOrMore( opExpr + lastExpr ) ) else: matchExpr = FollowedBy(lastExpr+lastExpr) + Group( lastExpr + OneOrMore(lastExpr) ) elif arity == 3: matchExpr = FollowedBy(lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr) + \ Group( lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr ) else: raise ValueError("operator must be unary (1), binary (2), or ternary (3)") elif rightLeftAssoc == opAssoc.RIGHT: if arity == 1: # try to avoid LR with this extra test if not isinstance(opExpr, Optional): opExpr = Optional(opExpr) matchExpr = FollowedBy(opExpr.expr + thisExpr) + Group( opExpr + thisExpr ) elif arity == 2: if opExpr is not None: matchExpr = FollowedBy(lastExpr + opExpr + thisExpr) + Group( lastExpr + OneOrMore( opExpr + thisExpr ) ) else: matchExpr = FollowedBy(lastExpr + thisExpr) + Group( lastExpr + OneOrMore( thisExpr ) ) elif arity == 3: matchExpr = FollowedBy(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr) + \ Group( lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr ) else: raise ValueError("operator must be unary (1), binary (2), or ternary (3)") else: raise ValueError("operator must indicate right or left associativity") if pa: matchExpr.setParseAction( pa ) thisExpr <<= ( matchExpr | lastExpr ) lastExpr = thisExpr ret <<= lastExpr return ret operatorPrecedence = infixNotation dblQuotedString = Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\x[0-9a-fA-F]+)|(?:\\.))*"').setName("string enclosed in double quotes") sglQuotedString = Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\x[0-9a-fA-F]+)|(?:\\.))*'").setName("string enclosed in single quotes") quotedString = Regex(r'''(?:"(?:[^"\n\r\\]|(?:"")|(?:\\x[0-9a-fA-F]+)|(?:\\.))*")|(?:'(?:[^'\n\r\\]|(?:'')|(?:\\x[0-9a-fA-F]+)|(?:\\.))*')''').setName("quotedString using single or double quotes") unicodeString = Combine(_L('u') + quotedString.copy()) def nestedExpr(opener="(", closer=")", content=None, ignoreExpr=quotedString.copy()): """Helper method for defining nested lists enclosed in opening and closing delimiters ("(" and ")" are the default). Parameters: - opener - opening character for a nested list (default="("); can also be a pyparsing expression - closer - closing character for a nested list (default=")"); can also be a pyparsing expression - content - expression for items within the nested lists (default=None) - ignoreExpr - expression for ignoring opening and closing delimiters (default=quotedString) If an expression is not provided for the content argument, the nested expression will capture all whitespace-delimited content between delimiters as a list of separate values. Use the C{ignoreExpr} argument to define expressions that may contain opening or closing characters that should not be treated as opening or closing characters for nesting, such as quotedString or a comment expression. Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}. The default is L{quotedString}, but if no expressions are to be ignored, then pass C{None} for this argument. """ if opener == closer: raise ValueError("opening and closing strings cannot be the same") if content is None: if isinstance(opener,basestring) and isinstance(closer,basestring): if len(opener) == 1 and len(closer)==1: if ignoreExpr is not None: content = (Combine(OneOrMore(~ignoreExpr + CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS,exact=1)) ).setParseAction(lambda t:t[0].strip())) else: content = (empty.copy()+CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS ).setParseAction(lambda t:t[0].strip())) else: if ignoreExpr is not None: content = (Combine(OneOrMore(~ignoreExpr + ~Literal(opener) + ~Literal(closer) + CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1)) ).setParseAction(lambda t:t[0].strip())) else: content = (Combine(OneOrMore(~Literal(opener) + ~Literal(closer) + CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1)) ).setParseAction(lambda t:t[0].strip())) else: raise ValueError("opening and closing arguments must be strings if no content expression is given") ret = Forward() if ignoreExpr is not None: ret <<= Group( Suppress(opener) + ZeroOrMore( ignoreExpr | ret | content ) + Suppress(closer) ) else: ret <<= Group( Suppress(opener) + ZeroOrMore( ret | content ) + Suppress(closer) ) return ret def indentedBlock(blockStatementExpr, indentStack, indent=True): """Helper method for defining space-delimited indentation blocks, such as those used to define block statements in Python source code. Parameters: - blockStatementExpr - expression defining syntax of statement that is repeated within the indented block - indentStack - list created by caller to manage indentation stack (multiple statementWithIndentedBlock expressions within a single grammar should share a common indentStack) - indent - boolean indicating whether block must be indented beyond the the current level; set to False for block of left-most statements (default=True) A valid block must contain at least one C{blockStatement}. """ def checkPeerIndent(s,l,t): if l >= len(s): return curCol = col(l,s) if curCol != indentStack[-1]: if curCol > indentStack[-1]: raise ParseFatalException(s,l,"illegal nesting") raise ParseException(s,l,"not a peer entry") def checkSubIndent(s,l,t): curCol = col(l,s) if curCol > indentStack[-1]: indentStack.append( curCol ) else: raise ParseException(s,l,"not a subentry") def checkUnindent(s,l,t): if l >= len(s): return curCol = col(l,s) if not(indentStack and curCol < indentStack[-1] and curCol <= indentStack[-2]): raise ParseException(s,l,"not an unindent") indentStack.pop() NL = OneOrMore(LineEnd().setWhitespaceChars("\t ").suppress()) INDENT = Empty() + Empty().setParseAction(checkSubIndent) PEER = Empty().setParseAction(checkPeerIndent) UNDENT = Empty().setParseAction(checkUnindent) if indent: smExpr = Group( Optional(NL) + #~ FollowedBy(blockStatementExpr) + INDENT + (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) + UNDENT) else: smExpr = Group( Optional(NL) + (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) ) blockStatementExpr.ignore(_bslash + LineEnd()) return smExpr alphas8bit = srange(r"[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]") punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]") anyOpenTag,anyCloseTag = makeHTMLTags(Word(alphas,alphanums+"_:")) commonHTMLEntity = Combine(_L("&") + oneOf("gt lt amp nbsp quot").setResultsName("entity") +";").streamline() _htmlEntityMap = dict(zip("gt lt amp nbsp quot".split(),'><& "')) replaceHTMLEntity = lambda t : t.entity in _htmlEntityMap and _htmlEntityMap[t.entity] or None # it's easy to get these comment structures wrong - they're very common, so may as well make them available cStyleComment = Regex(r"/\*(?:[^*]*\*+)+?/").setName("C style comment") htmlComment = Regex(r"") restOfLine = Regex(r".*").leaveWhitespace() dblSlashComment = Regex(r"\/\/(\\\n|.)*").setName("// comment") cppStyleComment = Regex(r"/(?:\*(?:[^*]*\*+)+?/|/[^\n]*(?:\n[^\n]*)*?(?:(?" __version__ = "1.10.0" # Useful for very coarse version differentiation. PY2 = sys.version_info[0] == 2 PY3 = sys.version_info[0] == 3 PY34 = sys.version_info[0:2] >= (3, 4) if PY3: string_types = str, integer_types = int, class_types = type, text_type = str binary_type = bytes MAXSIZE = sys.maxsize else: string_types = basestring, integer_types = (int, long) class_types = (type, types.ClassType) text_type = unicode binary_type = str if sys.platform.startswith("java"): # Jython always uses 32 bits. MAXSIZE = int((1 << 31) - 1) else: # It's possible to have sizeof(long) != sizeof(Py_ssize_t). class X(object): def __len__(self): return 1 << 31 try: len(X()) except OverflowError: # 32-bit MAXSIZE = int((1 << 31) - 1) else: # 64-bit MAXSIZE = int((1 << 63) - 1) del X def _add_doc(func, doc): """Add documentation to a function.""" func.__doc__ = doc def _import_module(name): """Import module, returning the module after the last dot.""" __import__(name) return sys.modules[name] class _LazyDescr(object): def __init__(self, name): self.name = name def __get__(self, obj, tp): result = self._resolve() setattr(obj, self.name, result) # Invokes __set__. try: # This is a bit ugly, but it avoids running this again by # removing this descriptor. delattr(obj.__class__, self.name) except AttributeError: pass return result class MovedModule(_LazyDescr): def __init__(self, name, old, new=None): super(MovedModule, self).__init__(name) if PY3: if new is None: new = name self.mod = new else: self.mod = old def _resolve(self): return _import_module(self.mod) def __getattr__(self, attr): _module = self._resolve() value = getattr(_module, attr) setattr(self, attr, value) return value class _LazyModule(types.ModuleType): def __init__(self, name): super(_LazyModule, self).__init__(name) self.__doc__ = self.__class__.__doc__ def __dir__(self): attrs = ["__doc__", "__name__"] attrs += [attr.name for attr in self._moved_attributes] return attrs # Subclasses should override this _moved_attributes = [] class MovedAttribute(_LazyDescr): def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None): super(MovedAttribute, self).__init__(name) if PY3: if new_mod is None: new_mod = name self.mod = new_mod if new_attr is None: if old_attr is None: new_attr = name else: new_attr = old_attr self.attr = new_attr else: self.mod = old_mod if old_attr is None: old_attr = name self.attr = old_attr def _resolve(self): module = _import_module(self.mod) return getattr(module, self.attr) class _SixMetaPathImporter(object): """ A meta path importer to import six.moves and its submodules. This class implements a PEP302 finder and loader. It should be compatible with Python 2.5 and all existing versions of Python3 """ def __init__(self, six_module_name): self.name = six_module_name self.known_modules = {} def _add_module(self, mod, *fullnames): for fullname in fullnames: self.known_modules[self.name + "." + fullname] = mod def _get_module(self, fullname): return self.known_modules[self.name + "." + fullname] def find_module(self, fullname, path=None): if fullname in self.known_modules: return self return None def __get_module(self, fullname): try: return self.known_modules[fullname] except KeyError: raise ImportError("This loader does not know module " + fullname) def load_module(self, fullname): try: # in case of a reload return sys.modules[fullname] except KeyError: pass mod = self.__get_module(fullname) if isinstance(mod, MovedModule): mod = mod._resolve() else: mod.__loader__ = self sys.modules[fullname] = mod return mod def is_package(self, fullname): """ Return true, if the named module is a package. We need this method to get correct spec objects with Python 3.4 (see PEP451) """ return hasattr(self.__get_module(fullname), "__path__") def get_code(self, fullname): """Return None Required, if is_package is implemented""" self.__get_module(fullname) # eventually raises ImportError return None get_source = get_code # same as get_code _importer = _SixMetaPathImporter(__name__) class _MovedItems(_LazyModule): """Lazy loading of moved objects""" __path__ = [] # mark as package _moved_attributes = [ MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"), MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"), MovedAttribute("filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"), MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"), MovedAttribute("intern", "__builtin__", "sys"), MovedAttribute("map", "itertools", "builtins", "imap", "map"), MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"), MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"), MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"), MovedAttribute("reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"), MovedAttribute("reduce", "__builtin__", "functools"), MovedAttribute("shlex_quote", "pipes", "shlex", "quote"), MovedAttribute("StringIO", "StringIO", "io"), MovedAttribute("UserDict", "UserDict", "collections"), MovedAttribute("UserList", "UserList", "collections"), MovedAttribute("UserString", "UserString", "collections"), MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"), MovedAttribute("zip", "itertools", "builtins", "izip", "zip"), MovedAttribute("zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"), MovedModule("builtins", "__builtin__"), MovedModule("configparser", "ConfigParser"), MovedModule("copyreg", "copy_reg"), MovedModule("dbm_gnu", "gdbm", "dbm.gnu"), MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread"), MovedModule("http_cookiejar", "cookielib", "http.cookiejar"), MovedModule("http_cookies", "Cookie", "http.cookies"), MovedModule("html_entities", "htmlentitydefs", "html.entities"), MovedModule("html_parser", "HTMLParser", "html.parser"), MovedModule("http_client", "httplib", "http.client"), MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"), MovedModule("email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"), MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"), MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"), MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"), MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"), MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"), MovedModule("cPickle", "cPickle", "pickle"), MovedModule("queue", "Queue"), MovedModule("reprlib", "repr"), MovedModule("socketserver", "SocketServer"), MovedModule("_thread", "thread", "_thread"), MovedModule("tkinter", "Tkinter"), MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"), MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"), MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"), MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"), MovedModule("tkinter_tix", "Tix", "tkinter.tix"), MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"), MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"), MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"), MovedModule("tkinter_colorchooser", "tkColorChooser", "tkinter.colorchooser"), MovedModule("tkinter_commondialog", "tkCommonDialog", "tkinter.commondialog"), MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"), MovedModule("tkinter_font", "tkFont", "tkinter.font"), MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"), MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", "tkinter.simpledialog"), MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"), MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"), MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"), MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"), MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"), MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"), ] # Add windows specific modules. if sys.platform == "win32": _moved_attributes += [ MovedModule("winreg", "_winreg"), ] for attr in _moved_attributes: setattr(_MovedItems, attr.name, attr) if isinstance(attr, MovedModule): _importer._add_module(attr, "moves." + attr.name) del attr _MovedItems._moved_attributes = _moved_attributes moves = _MovedItems(__name__ + ".moves") _importer._add_module(moves, "moves") class Module_six_moves_urllib_parse(_LazyModule): """Lazy loading of moved objects in six.moves.urllib_parse""" _urllib_parse_moved_attributes = [ MovedAttribute("ParseResult", "urlparse", "urllib.parse"), MovedAttribute("SplitResult", "urlparse", "urllib.parse"), MovedAttribute("parse_qs", "urlparse", "urllib.parse"), MovedAttribute("parse_qsl", "urlparse", "urllib.parse"), MovedAttribute("urldefrag", "urlparse", "urllib.parse"), MovedAttribute("urljoin", "urlparse", "urllib.parse"), MovedAttribute("urlparse", "urlparse", "urllib.parse"), MovedAttribute("urlsplit", "urlparse", "urllib.parse"), MovedAttribute("urlunparse", "urlparse", "urllib.parse"), MovedAttribute("urlunsplit", "urlparse", "urllib.parse"), MovedAttribute("quote", "urllib", "urllib.parse"), MovedAttribute("quote_plus", "urllib", "urllib.parse"), MovedAttribute("unquote", "urllib", "urllib.parse"), MovedAttribute("unquote_plus", "urllib", "urllib.parse"), MovedAttribute("urlencode", "urllib", "urllib.parse"), MovedAttribute("splitquery", "urllib", "urllib.parse"), MovedAttribute("splittag", "urllib", "urllib.parse"), MovedAttribute("splituser", "urllib", "urllib.parse"), MovedAttribute("uses_fragment", "urlparse", "urllib.parse"), MovedAttribute("uses_netloc", "urlparse", "urllib.parse"), MovedAttribute("uses_params", "urlparse", "urllib.parse"), MovedAttribute("uses_query", "urlparse", "urllib.parse"), MovedAttribute("uses_relative", "urlparse", "urllib.parse"), ] for attr in _urllib_parse_moved_attributes: setattr(Module_six_moves_urllib_parse, attr.name, attr) del attr Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes _importer._add_module(Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"), "moves.urllib_parse", "moves.urllib.parse") class Module_six_moves_urllib_error(_LazyModule): """Lazy loading of moved objects in six.moves.urllib_error""" _urllib_error_moved_attributes = [ MovedAttribute("URLError", "urllib2", "urllib.error"), MovedAttribute("HTTPError", "urllib2", "urllib.error"), MovedAttribute("ContentTooShortError", "urllib", "urllib.error"), ] for attr in _urllib_error_moved_attributes: setattr(Module_six_moves_urllib_error, attr.name, attr) del attr Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes _importer._add_module(Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"), "moves.urllib_error", "moves.urllib.error") class Module_six_moves_urllib_request(_LazyModule): """Lazy loading of moved objects in six.moves.urllib_request""" _urllib_request_moved_attributes = [ MovedAttribute("urlopen", "urllib2", "urllib.request"), MovedAttribute("install_opener", "urllib2", "urllib.request"), MovedAttribute("build_opener", "urllib2", "urllib.request"), MovedAttribute("pathname2url", "urllib", "urllib.request"), MovedAttribute("url2pathname", "urllib", "urllib.request"), MovedAttribute("getproxies", "urllib", "urllib.request"), MovedAttribute("Request", "urllib2", "urllib.request"), MovedAttribute("OpenerDirector", "urllib2", "urllib.request"), MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"), MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"), MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"), MovedAttribute("ProxyHandler", "urllib2", "urllib.request"), MovedAttribute("BaseHandler", "urllib2", "urllib.request"), MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"), MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"), MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"), MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"), MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"), MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"), MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"), MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"), MovedAttribute("HTTPHandler", "urllib2", "urllib.request"), MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"), MovedAttribute("FileHandler", "urllib2", "urllib.request"), MovedAttribute("FTPHandler", "urllib2", "urllib.request"), MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"), MovedAttribute("UnknownHandler", "urllib2", "urllib.request"), MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"), MovedAttribute("urlretrieve", "urllib", "urllib.request"), MovedAttribute("urlcleanup", "urllib", "urllib.request"), MovedAttribute("URLopener", "urllib", "urllib.request"), MovedAttribute("FancyURLopener", "urllib", "urllib.request"), MovedAttribute("proxy_bypass", "urllib", "urllib.request"), ] for attr in _urllib_request_moved_attributes: setattr(Module_six_moves_urllib_request, attr.name, attr) del attr Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes _importer._add_module(Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"), "moves.urllib_request", "moves.urllib.request") class Module_six_moves_urllib_response(_LazyModule): """Lazy loading of moved objects in six.moves.urllib_response""" _urllib_response_moved_attributes = [ MovedAttribute("addbase", "urllib", "urllib.response"), MovedAttribute("addclosehook", "urllib", "urllib.response"), MovedAttribute("addinfo", "urllib", "urllib.response"), MovedAttribute("addinfourl", "urllib", "urllib.response"), ] for attr in _urllib_response_moved_attributes: setattr(Module_six_moves_urllib_response, attr.name, attr) del attr Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes _importer._add_module(Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"), "moves.urllib_response", "moves.urllib.response") class Module_six_moves_urllib_robotparser(_LazyModule): """Lazy loading of moved objects in six.moves.urllib_robotparser""" _urllib_robotparser_moved_attributes = [ MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"), ] for attr in _urllib_robotparser_moved_attributes: setattr(Module_six_moves_urllib_robotparser, attr.name, attr) del attr Module_six_moves_urllib_robotparser._moved_attributes = _urllib_robotparser_moved_attributes _importer._add_module(Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"), "moves.urllib_robotparser", "moves.urllib.robotparser") class Module_six_moves_urllib(types.ModuleType): """Create a six.moves.urllib namespace that resembles the Python 3 namespace""" __path__ = [] # mark as package parse = _importer._get_module("moves.urllib_parse") error = _importer._get_module("moves.urllib_error") request = _importer._get_module("moves.urllib_request") response = _importer._get_module("moves.urllib_response") robotparser = _importer._get_module("moves.urllib_robotparser") def __dir__(self): return ['parse', 'error', 'request', 'response', 'robotparser'] _importer._add_module(Module_six_moves_urllib(__name__ + ".moves.urllib"), "moves.urllib") def add_move(move): """Add an item to six.moves.""" setattr(_MovedItems, move.name, move) def remove_move(name): """Remove item from six.moves.""" try: delattr(_MovedItems, name) except AttributeError: try: del moves.__dict__[name] except KeyError: raise AttributeError("no such move, %r" % (name,)) if PY3: _meth_func = "__func__" _meth_self = "__self__" _func_closure = "__closure__" _func_code = "__code__" _func_defaults = "__defaults__" _func_globals = "__globals__" else: _meth_func = "im_func" _meth_self = "im_self" _func_closure = "func_closure" _func_code = "func_code" _func_defaults = "func_defaults" _func_globals = "func_globals" try: advance_iterator = next except NameError: def advance_iterator(it): return it.next() next = advance_iterator try: callable = callable except NameError: def callable(obj): return any("__call__" in klass.__dict__ for klass in type(obj).__mro__) if PY3: def get_unbound_function(unbound): return unbound create_bound_method = types.MethodType def create_unbound_method(func, cls): return func Iterator = object else: def get_unbound_function(unbound): return unbound.im_func def create_bound_method(func, obj): return types.MethodType(func, obj, obj.__class__) def create_unbound_method(func, cls): return types.MethodType(func, None, cls) class Iterator(object): def next(self): return type(self).__next__(self) callable = callable _add_doc(get_unbound_function, """Get the function out of a possibly unbound function""") get_method_function = operator.attrgetter(_meth_func) get_method_self = operator.attrgetter(_meth_self) get_function_closure = operator.attrgetter(_func_closure) get_function_code = operator.attrgetter(_func_code) get_function_defaults = operator.attrgetter(_func_defaults) get_function_globals = operator.attrgetter(_func_globals) if PY3: def iterkeys(d, **kw): return iter(d.keys(**kw)) def itervalues(d, **kw): return iter(d.values(**kw)) def iteritems(d, **kw): return iter(d.items(**kw)) def iterlists(d, **kw): return iter(d.lists(**kw)) viewkeys = operator.methodcaller("keys") viewvalues = operator.methodcaller("values") viewitems = operator.methodcaller("items") else: def iterkeys(d, **kw): return d.iterkeys(**kw) def itervalues(d, **kw): return d.itervalues(**kw) def iteritems(d, **kw): return d.iteritems(**kw) def iterlists(d, **kw): return d.iterlists(**kw) viewkeys = operator.methodcaller("viewkeys") viewvalues = operator.methodcaller("viewvalues") viewitems = operator.methodcaller("viewitems") _add_doc(iterkeys, "Return an iterator over the keys of a dictionary.") _add_doc(itervalues, "Return an iterator over the values of a dictionary.") _add_doc(iteritems, "Return an iterator over the (key, value) pairs of a dictionary.") _add_doc(iterlists, "Return an iterator over the (key, [values]) pairs of a dictionary.") if PY3: def b(s): return s.encode("latin-1") def u(s): return s unichr = chr import struct int2byte = struct.Struct(">B").pack del struct byte2int = operator.itemgetter(0) indexbytes = operator.getitem iterbytes = iter import io StringIO = io.StringIO BytesIO = io.BytesIO _assertCountEqual = "assertCountEqual" if sys.version_info[1] <= 1: _assertRaisesRegex = "assertRaisesRegexp" _assertRegex = "assertRegexpMatches" else: _assertRaisesRegex = "assertRaisesRegex" _assertRegex = "assertRegex" else: def b(s): return s # Workaround for standalone backslash def u(s): return unicode(s.replace(r'\\', r'\\\\'), "unicode_escape") unichr = unichr int2byte = chr def byte2int(bs): return ord(bs[0]) def indexbytes(buf, i): return ord(buf[i]) iterbytes = functools.partial(itertools.imap, ord) import StringIO StringIO = BytesIO = StringIO.StringIO _assertCountEqual = "assertItemsEqual" _assertRaisesRegex = "assertRaisesRegexp" _assertRegex = "assertRegexpMatches" _add_doc(b, """Byte literal""") _add_doc(u, """Text literal""") def assertCountEqual(self, *args, **kwargs): return getattr(self, _assertCountEqual)(*args, **kwargs) def assertRaisesRegex(self, *args, **kwargs): return getattr(self, _assertRaisesRegex)(*args, **kwargs) def assertRegex(self, *args, **kwargs): return getattr(self, _assertRegex)(*args, **kwargs) if PY3: exec_ = getattr(moves.builtins, "exec") def reraise(tp, value, tb=None): if value is None: value = tp() if value.__traceback__ is not tb: raise value.with_traceback(tb) raise value else: def exec_(_code_, _globs_=None, _locs_=None): """Execute code in a namespace.""" if _globs_ is None: frame = sys._getframe(1) _globs_ = frame.f_globals if _locs_ is None: _locs_ = frame.f_locals del frame elif _locs_ is None: _locs_ = _globs_ exec("""exec _code_ in _globs_, _locs_""") exec_("""def reraise(tp, value, tb=None): raise tp, value, tb """) if sys.version_info[:2] == (3, 2): exec_("""def raise_from(value, from_value): if from_value is None: raise value raise value from from_value """) elif sys.version_info[:2] > (3, 2): exec_("""def raise_from(value, from_value): raise value from from_value """) else: def raise_from(value, from_value): raise value print_ = getattr(moves.builtins, "print", None) if print_ is None: def print_(*args, **kwargs): """The new-style print function for Python 2.4 and 2.5.""" fp = kwargs.pop("file", sys.stdout) if fp is None: return def write(data): if not isinstance(data, basestring): data = str(data) # If the file has an encoding, encode unicode with it. if (isinstance(fp, file) and isinstance(data, unicode) and fp.encoding is not None): errors = getattr(fp, "errors", None) if errors is None: errors = "strict" data = data.encode(fp.encoding, errors) fp.write(data) want_unicode = False sep = kwargs.pop("sep", None) if sep is not None: if isinstance(sep, unicode): want_unicode = True elif not isinstance(sep, str): raise TypeError("sep must be None or a string") end = kwargs.pop("end", None) if end is not None: if isinstance(end, unicode): want_unicode = True elif not isinstance(end, str): raise TypeError("end must be None or a string") if kwargs: raise TypeError("invalid keyword arguments to print()") if not want_unicode: for arg in args: if isinstance(arg, unicode): want_unicode = True break if want_unicode: newline = unicode("\n") space = unicode(" ") else: newline = "\n" space = " " if sep is None: sep = space if end is None: end = newline for i, arg in enumerate(args): if i: write(sep) write(arg) write(end) if sys.version_info[:2] < (3, 3): _print = print_ def print_(*args, **kwargs): fp = kwargs.get("file", sys.stdout) flush = kwargs.pop("flush", False) _print(*args, **kwargs) if flush and fp is not None: fp.flush() _add_doc(reraise, """Reraise an exception.""") if sys.version_info[0:2] < (3, 4): def wraps(wrapped, assigned=functools.WRAPPER_ASSIGNMENTS, updated=functools.WRAPPER_UPDATES): def wrapper(f): f = functools.wraps(wrapped, assigned, updated)(f) f.__wrapped__ = wrapped return f return wrapper else: wraps = functools.wraps def with_metaclass(meta, *bases): """Create a base class with a metaclass.""" # This requires a bit of explanation: the basic idea is to make a dummy # metaclass for one level of class instantiation that replaces itself with # the actual metaclass. class metaclass(meta): def __new__(cls, name, this_bases, d): return meta(name, bases, d) return type.__new__(metaclass, 'temporary_class', (), {}) def add_metaclass(metaclass): """Class decorator for creating a class with a metaclass.""" def wrapper(cls): orig_vars = cls.__dict__.copy() slots = orig_vars.get('__slots__') if slots is not None: if isinstance(slots, str): slots = [slots] for slots_var in slots: orig_vars.pop(slots_var) orig_vars.pop('__dict__', None) orig_vars.pop('__weakref__', None) return metaclass(cls.__name__, cls.__bases__, orig_vars) return wrapper def python_2_unicode_compatible(klass): """ A decorator that defines __unicode__ and __str__ methods under Python 2. Under Python 3 it does nothing. To support Python 2 and 3 with a single code base, define a __str__ method returning text and apply this decorator to the class. """ if PY2: if '__str__' not in klass.__dict__: raise ValueError("@python_2_unicode_compatible cannot be applied " "to %s because it doesn't define __str__()." % klass.__name__) klass.__unicode__ = klass.__str__ klass.__str__ = lambda self: self.__unicode__().encode('utf-8') return klass # Complete the moves implementation. # This code is at the end of this module to speed up module loading. # Turn this module into a package. __path__ = [] # required for PEP 302 and PEP 451 __package__ = __name__ # see PEP 366 @ReservedAssignment if globals().get("__spec__") is not None: __spec__.submodule_search_locations = [] # PEP 451 @UndefinedVariable # Remove other six meta path importers, since they cause problems. This can # happen if six is removed from sys.modules and then reloaded. (Setuptools does # this for some reason.) if sys.meta_path: for i, importer in enumerate(sys.meta_path): # Here's some real nastiness: Another "instance" of the six module might # be floating around. Therefore, we can't use isinstance() to check for # the six meta path importer, since the other six instance will have # inserted an importer with different class. if (type(importer).__name__ == "_SixMetaPathImporter" and importer.name == __name__): del sys.meta_path[i] break del i, importer # Finally, add the importer to the meta path import hook. sys.meta_path.append(_importer) setuptools-20.7.0/pkg_resources/_vendor/vendored.txt0000664000175000017500000000005512702524020023535 0ustar travistravis00000000000000packaging==16.6 pyparsing==2.0.6 six==1.10.0 setuptools-20.7.0/pkg_resources/extern/0000775000175000017500000000000012702524134021045 5ustar travistravis00000000000000setuptools-20.7.0/pkg_resources/extern/__init__.py0000664000175000017500000000465212702524020023157 0ustar travistravis00000000000000import sys class VendorImporter: """ A PEP 302 meta path importer for finding optionally-vendored or otherwise naturally-installed packages from root_name. """ def __init__(self, root_name, vendored_names=(), vendor_pkg=None): self.root_name = root_name self.vendored_names = set(vendored_names) self.vendor_pkg = vendor_pkg or root_name.replace('extern', '_vendor') @property def search_path(self): """ Search first the vendor package then as a natural package. """ yield self.vendor_pkg + '.' yield '' def find_module(self, fullname, path=None): """ Return self when fullname starts with root_name and the target module is one vendored through this importer. """ root, base, target = fullname.partition(self.root_name + '.') if root: return if not any(map(target.startswith, self.vendored_names)): return return self def load_module(self, fullname): """ Iterate over the search path to locate and load fullname. """ root, base, target = fullname.partition(self.root_name + '.') for prefix in self.search_path: try: extant = prefix + target __import__(extant) mod = sys.modules[extant] sys.modules[fullname] = mod # mysterious hack: # Remove the reference to the extant package/module # on later Python versions to cause relative imports # in the vendor package to resolve the same modules # as those going through this importer. if sys.version_info > (3, 3): del sys.modules[extant] return mod except ImportError: pass else: raise ImportError( "The '{target}' package is required; " "normally this is bundled with this package so if you get " "this warning, consult the packager of your " "distribution.".format(**locals()) ) def install(self): """ Install this importer into sys.meta_path if not already present. """ if self not in sys.meta_path: sys.meta_path.append(self) names = 'packaging', 'pyparsing', 'six' VendorImporter(__name__, names).install() setuptools-20.7.0/pkg_resources/tests/0000775000175000017500000000000012702524134020702 5ustar travistravis00000000000000setuptools-20.7.0/pkg_resources/tests/__init__.py0000664000175000017500000000000012702524020022773 0ustar travistravis00000000000000setuptools-20.7.0/pkg_resources/tests/test_markers.py0000664000175000017500000000044012702524020023747 0ustar travistravis00000000000000try: import unittest.mock as mock except ImportError: import mock from pkg_resources import evaluate_marker @mock.patch('platform.python_version', return_value='2.7.10') def test_ordering(python_version_mock): assert evaluate_marker("python_full_version > '2.7.3'") is True setuptools-20.7.0/pkg_resources/tests/test_pkg_resources.py0000664000175000017500000001215312702524020025162 0ustar travistravis00000000000000# coding: utf-8 from __future__ import unicode_literals import sys import tempfile import os import zipfile import datetime import time import subprocess import stat import distutils.dist import distutils.command.install_egg_info from pkg_resources.extern.six.moves import map import pytest import pkg_resources try: unicode except NameError: unicode = str def timestamp(dt): """ Return a timestamp for a local, naive datetime instance. """ try: return dt.timestamp() except AttributeError: # Python 3.2 and earlier return time.mktime(dt.timetuple()) class EggRemover(unicode): def __call__(self): if self in sys.path: sys.path.remove(self) if os.path.exists(self): os.remove(self) class TestZipProvider(object): finalizers = [] ref_time = datetime.datetime(2013, 5, 12, 13, 25, 0) "A reference time for a file modification" @classmethod def setup_class(cls): "create a zip egg and add it to sys.path" egg = tempfile.NamedTemporaryFile(suffix='.egg', delete=False) zip_egg = zipfile.ZipFile(egg, 'w') zip_info = zipfile.ZipInfo() zip_info.filename = 'mod.py' zip_info.date_time = cls.ref_time.timetuple() zip_egg.writestr(zip_info, 'x = 3\n') zip_info = zipfile.ZipInfo() zip_info.filename = 'data.dat' zip_info.date_time = cls.ref_time.timetuple() zip_egg.writestr(zip_info, 'hello, world!') zip_egg.close() egg.close() sys.path.append(egg.name) cls.finalizers.append(EggRemover(egg.name)) @classmethod def teardown_class(cls): for finalizer in cls.finalizers: finalizer() def test_resource_filename_rewrites_on_change(self): """ If a previous call to get_resource_filename has saved the file, but the file has been subsequently mutated with different file of the same size and modification time, it should not be overwritten on a subsequent call to get_resource_filename. """ import mod manager = pkg_resources.ResourceManager() zp = pkg_resources.ZipProvider(mod) filename = zp.get_resource_filename(manager, 'data.dat') actual = datetime.datetime.fromtimestamp(os.stat(filename).st_mtime) assert actual == self.ref_time f = open(filename, 'w') f.write('hello, world?') f.close() ts = timestamp(self.ref_time) os.utime(filename, (ts, ts)) filename = zp.get_resource_filename(manager, 'data.dat') f = open(filename) assert f.read() == 'hello, world!' manager.cleanup_resources() class TestResourceManager(object): def test_get_cache_path(self): mgr = pkg_resources.ResourceManager() path = mgr.get_cache_path('foo') type_ = str(type(path)) message = "Unexpected type from get_cache_path: " + type_ assert isinstance(path, (unicode, str)), message class TestIndependence: """ Tests to ensure that pkg_resources runs independently from setuptools. """ def test_setuptools_not_imported(self): """ In a separate Python environment, import pkg_resources and assert that action doesn't cause setuptools to be imported. """ lines = ( 'import pkg_resources', 'import sys', 'assert "setuptools" not in sys.modules, ' '"setuptools was imported"', ) cmd = [sys.executable, '-c', '; '.join(lines)] subprocess.check_call(cmd) class TestDeepVersionLookupDistutils(object): @pytest.fixture def env(self, tmpdir): """ Create a package environment, similar to a virtualenv, in which packages are installed. """ class Environment(str): pass env = Environment(tmpdir) tmpdir.chmod(stat.S_IRWXU) subs = 'home', 'lib', 'scripts', 'data', 'egg-base' env.paths = dict( (dirname, str(tmpdir / dirname)) for dirname in subs ) list(map(os.mkdir, env.paths.values())) return env def create_foo_pkg(self, env, version): """ Create a foo package installed (distutils-style) to env.paths['lib'] as version. """ ld = "This package has unicode metadata! â„" attrs = dict(name='foo', version=version, long_description=ld) dist = distutils.dist.Distribution(attrs) iei_cmd = distutils.command.install_egg_info.install_egg_info(dist) iei_cmd.initialize_options() iei_cmd.install_dir = env.paths['lib'] iei_cmd.finalize_options() iei_cmd.run() def test_version_resolved_from_egg_info(self, env): version = '1.11.0.dev0+2329eae' self.create_foo_pkg(env, version) # this requirement parsing will raise a VersionConflict unless the # .egg-info file is parsed (see #419 on BitBucket) req = pkg_resources.Requirement.parse('foo>=1.9') dist = pkg_resources.WorkingSet([env.paths['lib']]).find(req) assert dist.version == version setuptools-20.7.0/pkg_resources/tests/test_resources.py0000664000175000017500000007317312702524020024332 0ustar travistravis00000000000000from __future__ import unicode_literals import os import sys import string from pkg_resources.extern.six.moves import map import pytest from pkg_resources.extern import packaging import pkg_resources from pkg_resources import (parse_requirements, VersionConflict, parse_version, Distribution, EntryPoint, Requirement, safe_version, safe_name, WorkingSet) class Metadata(pkg_resources.EmptyProvider): """Mock object to return metadata as if from an on-disk distribution""" def __init__(self, *pairs): self.metadata = dict(pairs) def has_metadata(self, name): return name in self.metadata def get_metadata(self, name): return self.metadata[name] def get_metadata_lines(self, name): return pkg_resources.yield_lines(self.get_metadata(name)) dist_from_fn = pkg_resources.Distribution.from_filename class TestDistro: def testCollection(self): # empty path should produce no distributions ad = pkg_resources.Environment([], platform=None, python=None) assert list(ad) == [] assert ad['FooPkg'] == [] ad.add(dist_from_fn("FooPkg-1.3_1.egg")) ad.add(dist_from_fn("FooPkg-1.4-py2.4-win32.egg")) ad.add(dist_from_fn("FooPkg-1.2-py2.4.egg")) # Name is in there now assert ad['FooPkg'] # But only 1 package assert list(ad) == ['foopkg'] # Distributions sort by version assert [dist.version for dist in ad['FooPkg']] == ['1.4','1.3-1','1.2'] # Removing a distribution leaves sequence alone ad.remove(ad['FooPkg'][1]) assert [dist.version for dist in ad['FooPkg']] == ['1.4','1.2'] # And inserting adds them in order ad.add(dist_from_fn("FooPkg-1.9.egg")) assert [dist.version for dist in ad['FooPkg']] == ['1.9','1.4','1.2'] ws = WorkingSet([]) foo12 = dist_from_fn("FooPkg-1.2-py2.4.egg") foo14 = dist_from_fn("FooPkg-1.4-py2.4-win32.egg") req, = parse_requirements("FooPkg>=1.3") # Nominal case: no distros on path, should yield all applicable assert ad.best_match(req, ws).version == '1.9' # If a matching distro is already installed, should return only that ws.add(foo14) assert ad.best_match(req, ws).version == '1.4' # If the first matching distro is unsuitable, it's a version conflict ws = WorkingSet([]) ws.add(foo12) ws.add(foo14) with pytest.raises(VersionConflict): ad.best_match(req, ws) # If more than one match on the path, the first one takes precedence ws = WorkingSet([]) ws.add(foo14) ws.add(foo12) ws.add(foo14) assert ad.best_match(req, ws).version == '1.4' def checkFooPkg(self,d): assert d.project_name == "FooPkg" assert d.key == "foopkg" assert d.version == "1.3.post1" assert d.py_version == "2.4" assert d.platform == "win32" assert d.parsed_version == parse_version("1.3-1") def testDistroBasics(self): d = Distribution( "/some/path", project_name="FooPkg",version="1.3-1",py_version="2.4",platform="win32" ) self.checkFooPkg(d) d = Distribution("/some/path") assert d.py_version == sys.version[:3] assert d.platform == None def testDistroParse(self): d = dist_from_fn("FooPkg-1.3.post1-py2.4-win32.egg") self.checkFooPkg(d) d = dist_from_fn("FooPkg-1.3.post1-py2.4-win32.egg-info") self.checkFooPkg(d) def testDistroMetadata(self): d = Distribution( "/some/path", project_name="FooPkg", py_version="2.4", platform="win32", metadata = Metadata( ('PKG-INFO',"Metadata-Version: 1.0\nVersion: 1.3-1\n") ) ) self.checkFooPkg(d) def distRequires(self, txt): return Distribution("/foo", metadata=Metadata(('depends.txt', txt))) def checkRequires(self, dist, txt, extras=()): assert list(dist.requires(extras)) == list(parse_requirements(txt)) def testDistroDependsSimple(self): for v in "Twisted>=1.5", "Twisted>=1.5\nZConfig>=2.0": self.checkRequires(self.distRequires(v), v) def testResolve(self): ad = pkg_resources.Environment([]) ws = WorkingSet([]) # Resolving no requirements -> nothing to install assert list(ws.resolve([], ad)) == [] # Request something not in the collection -> DistributionNotFound with pytest.raises(pkg_resources.DistributionNotFound): ws.resolve(parse_requirements("Foo"), ad) Foo = Distribution.from_filename( "/foo_dir/Foo-1.2.egg", metadata=Metadata(('depends.txt', "[bar]\nBaz>=2.0")) ) ad.add(Foo) ad.add(Distribution.from_filename("Foo-0.9.egg")) # Request thing(s) that are available -> list to activate for i in range(3): targets = list(ws.resolve(parse_requirements("Foo"), ad)) assert targets == [Foo] list(map(ws.add, targets)) with pytest.raises(VersionConflict): ws.resolve(parse_requirements("Foo==0.9"), ad) ws = WorkingSet([]) # reset # Request an extra that causes an unresolved dependency for "Baz" with pytest.raises(pkg_resources.DistributionNotFound): ws.resolve(parse_requirements("Foo[bar]"), ad) Baz = Distribution.from_filename( "/foo_dir/Baz-2.1.egg", metadata=Metadata(('depends.txt', "Foo")) ) ad.add(Baz) # Activation list now includes resolved dependency assert list(ws.resolve(parse_requirements("Foo[bar]"), ad)) ==[Foo,Baz] # Requests for conflicting versions produce VersionConflict with pytest.raises(VersionConflict) as vc: ws.resolve(parse_requirements("Foo==1.2\nFoo!=1.2"), ad) msg = 'Foo 0.9 is installed but Foo==1.2 is required' assert vc.value.report() == msg def test_environment_marker_evaluation_negative(self): """Environment markers are evaluated at resolution time.""" ad = pkg_resources.Environment([]) ws = WorkingSet([]) res = ws.resolve(parse_requirements("Foo;python_version<'2'"), ad) assert list(res) == [] def test_environment_marker_evaluation_positive(self): ad = pkg_resources.Environment([]) ws = WorkingSet([]) Foo = Distribution.from_filename("/foo_dir/Foo-1.2.dist-info") ad.add(Foo) res = ws.resolve(parse_requirements("Foo;python_version>='2'"), ad) assert list(res) == [Foo] def test_environment_marker_evaluation_called(self): """ If one package foo requires bar without any extras, markers should pass for bar. """ parent_req, = parse_requirements("foo") req, = parse_requirements("bar;python_version>='2'") req_extras = pkg_resources._ReqExtras({req: parent_req.extras}) assert req_extras.markers_pass(req) parent_req, = parse_requirements("foo[]") req, = parse_requirements("bar;python_version>='2'") req_extras = pkg_resources._ReqExtras({req: parent_req.extras}) assert req_extras.markers_pass(req) # extra should not be present in the marker namespace if # no markers were supplied parent_req, = parse_requirements("foo") req, = parse_requirements("bar;extra==''") req_extras = pkg_resources._ReqExtras({req: parent_req.extras}) with pytest.raises(packaging.markers.UndefinedEnvironmentName): req_extras.markers_pass(req) def test_marker_evaluation_with_extras(self): """Extras are also evaluated as markers at resolution time.""" ad = pkg_resources.Environment([]) ws = WorkingSet([]) # Metadata needs to be native strings due to cStringIO behaviour in # 2.6, so use str(). Foo = Distribution.from_filename( "/foo_dir/Foo-1.2.dist-info", metadata=Metadata(("METADATA", str("Provides-Extra: baz\n" "Requires-Dist: quux; extra=='baz'"))) ) ad.add(Foo) assert list(ws.resolve(parse_requirements("Foo"), ad)) == [Foo] quux = Distribution.from_filename("/foo_dir/quux-1.0.dist-info") ad.add(quux) res = list(ws.resolve(parse_requirements("Foo[baz]"), ad)) assert res == [Foo,quux] def test_marker_evaluation_with_multiple_extras(self): ad = pkg_resources.Environment([]) ws = WorkingSet([]) # Metadata needs to be native strings due to cStringIO behaviour in # 2.6, so use str(). Foo = Distribution.from_filename( "/foo_dir/Foo-1.2.dist-info", metadata=Metadata(("METADATA", str("Provides-Extra: baz\n" "Requires-Dist: quux; extra=='baz'\n" "Provides-Extra: bar\n" "Requires-Dist: fred; extra=='bar'\n"))) ) ad.add(Foo) quux = Distribution.from_filename("/foo_dir/quux-1.0.dist-info") ad.add(quux) fred = Distribution.from_filename("/foo_dir/fred-0.1.dist-info") ad.add(fred) res = list(ws.resolve(parse_requirements("Foo[baz,bar]"), ad)) assert sorted(res) == [fred,quux,Foo] def test_marker_evaluation_with_extras_loop(self): ad = pkg_resources.Environment([]) ws = WorkingSet([]) # Metadata needs to be native strings due to cStringIO behaviour in # 2.6, so use str(). a = Distribution.from_filename( "/foo_dir/a-0.2.dist-info", metadata=Metadata(("METADATA", str("Requires-Dist: c[a]"))) ) b = Distribution.from_filename( "/foo_dir/b-0.3.dist-info", metadata=Metadata(("METADATA", str("Requires-Dist: c[b]"))) ) c = Distribution.from_filename( "/foo_dir/c-1.0.dist-info", metadata=Metadata(("METADATA", str("Provides-Extra: a\n" "Requires-Dist: b;extra=='a'\n" "Provides-Extra: b\n" "Requires-Dist: foo;extra=='b'"))) ) foo = Distribution.from_filename("/foo_dir/foo-0.1.dist-info") for dist in (a, b, c, foo): ad.add(dist) res = list(ws.resolve(parse_requirements("a"), ad)) assert res == [a, c, b, foo] def testDistroDependsOptions(self): d = self.distRequires(""" Twisted>=1.5 [docgen] ZConfig>=2.0 docutils>=0.3 [fastcgi] fcgiapp>=0.1""") self.checkRequires(d,"Twisted>=1.5") self.checkRequires( d,"Twisted>=1.5 ZConfig>=2.0 docutils>=0.3".split(), ["docgen"] ) self.checkRequires( d,"Twisted>=1.5 fcgiapp>=0.1".split(), ["fastcgi"] ) self.checkRequires( d,"Twisted>=1.5 ZConfig>=2.0 docutils>=0.3 fcgiapp>=0.1".split(), ["docgen","fastcgi"] ) self.checkRequires( d,"Twisted>=1.5 fcgiapp>=0.1 ZConfig>=2.0 docutils>=0.3".split(), ["fastcgi", "docgen"] ) with pytest.raises(pkg_resources.UnknownExtra): d.requires(["foo"]) class TestWorkingSet: def test_find_conflicting(self): ws = WorkingSet([]) Foo = Distribution.from_filename("/foo_dir/Foo-1.2.egg") ws.add(Foo) # create a requirement that conflicts with Foo 1.2 req = next(parse_requirements("Foo<1.2")) with pytest.raises(VersionConflict) as vc: ws.find(req) msg = 'Foo 1.2 is installed but Foo<1.2 is required' assert vc.value.report() == msg def test_resolve_conflicts_with_prior(self): """ A ContextualVersionConflict should be raised when a requirement conflicts with a prior requirement for a different package. """ # Create installation where Foo depends on Baz 1.0 and Bar depends on # Baz 2.0. ws = WorkingSet([]) md = Metadata(('depends.txt', "Baz==1.0")) Foo = Distribution.from_filename("/foo_dir/Foo-1.0.egg", metadata=md) ws.add(Foo) md = Metadata(('depends.txt', "Baz==2.0")) Bar = Distribution.from_filename("/foo_dir/Bar-1.0.egg", metadata=md) ws.add(Bar) Baz = Distribution.from_filename("/foo_dir/Baz-1.0.egg") ws.add(Baz) Baz = Distribution.from_filename("/foo_dir/Baz-2.0.egg") ws.add(Baz) with pytest.raises(VersionConflict) as vc: ws.resolve(parse_requirements("Foo\nBar\n")) msg = "Baz 1.0 is installed but Baz==2.0 is required by " msg += repr(set(['Bar'])) assert vc.value.report() == msg class TestEntryPoints: def assertfields(self, ep): assert ep.name == "foo" assert ep.module_name == "pkg_resources.tests.test_resources" assert ep.attrs == ("TestEntryPoints",) assert ep.extras == ("x",) assert ep.load() is TestEntryPoints expect = "foo = pkg_resources.tests.test_resources:TestEntryPoints [x]" assert str(ep) == expect def setup_method(self, method): self.dist = Distribution.from_filename( "FooPkg-1.2-py2.4.egg", metadata=Metadata(('requires.txt','[x]'))) def testBasics(self): ep = EntryPoint( "foo", "pkg_resources.tests.test_resources", ["TestEntryPoints"], ["x"], self.dist ) self.assertfields(ep) def testParse(self): s = "foo = pkg_resources.tests.test_resources:TestEntryPoints [x]" ep = EntryPoint.parse(s, self.dist) self.assertfields(ep) ep = EntryPoint.parse("bar baz= spammity[PING]") assert ep.name == "bar baz" assert ep.module_name == "spammity" assert ep.attrs == () assert ep.extras == ("ping",) ep = EntryPoint.parse(" fizzly = wocka:foo") assert ep.name == "fizzly" assert ep.module_name == "wocka" assert ep.attrs == ("foo",) assert ep.extras == () # plus in the name spec = "html+mako = mako.ext.pygmentplugin:MakoHtmlLexer" ep = EntryPoint.parse(spec) assert ep.name == 'html+mako' reject_specs = "foo", "x=a:b:c", "q=x/na", "fez=pish:tush-z", "x=f[a]>2" @pytest.mark.parametrize("reject_spec", reject_specs) def test_reject_spec(self, reject_spec): with pytest.raises(ValueError): EntryPoint.parse(reject_spec) def test_printable_name(self): """ Allow any printable character in the name. """ # Create a name with all printable characters; strip the whitespace. name = string.printable.strip() spec = "{name} = module:attr".format(**locals()) ep = EntryPoint.parse(spec) assert ep.name == name def checkSubMap(self, m): assert len(m) == len(self.submap_expect) for key, ep in self.submap_expect.items(): assert m.get(key).name == ep.name assert m.get(key).module_name == ep.module_name assert sorted(m.get(key).attrs) == sorted(ep.attrs) assert sorted(m.get(key).extras) == sorted(ep.extras) submap_expect = dict( feature1=EntryPoint('feature1', 'somemodule', ['somefunction']), feature2=EntryPoint('feature2', 'another.module', ['SomeClass'], ['extra1','extra2']), feature3=EntryPoint('feature3', 'this.module', extras=['something']) ) submap_str = """ # define features for blah blah feature1 = somemodule:somefunction feature2 = another.module:SomeClass [extra1,extra2] feature3 = this.module [something] """ def testParseList(self): self.checkSubMap(EntryPoint.parse_group("xyz", self.submap_str)) with pytest.raises(ValueError): EntryPoint.parse_group("x a", "foo=bar") with pytest.raises(ValueError): EntryPoint.parse_group("x", ["foo=baz", "foo=bar"]) def testParseMap(self): m = EntryPoint.parse_map({'xyz':self.submap_str}) self.checkSubMap(m['xyz']) assert list(m.keys()) == ['xyz'] m = EntryPoint.parse_map("[xyz]\n"+self.submap_str) self.checkSubMap(m['xyz']) assert list(m.keys()) == ['xyz'] with pytest.raises(ValueError): EntryPoint.parse_map(["[xyz]", "[xyz]"]) with pytest.raises(ValueError): EntryPoint.parse_map(self.submap_str) class TestRequirements: def testBasics(self): r = Requirement.parse("Twisted>=1.2") assert str(r) == "Twisted>=1.2" assert repr(r) == "Requirement.parse('Twisted>=1.2')" assert r == Requirement("Twisted>=1.2") assert r == Requirement("twisTed>=1.2") assert r != Requirement("Twisted>=2.0") assert r != Requirement("Zope>=1.2") assert r != Requirement("Zope>=3.0") assert r != Requirement("Twisted[extras]>=1.2") def testOrdering(self): r1 = Requirement("Twisted==1.2c1,>=1.2") r2 = Requirement("Twisted>=1.2,==1.2c1") assert r1 == r2 assert str(r1) == str(r2) assert str(r2) == "Twisted==1.2c1,>=1.2" def testBasicContains(self): r = Requirement("Twisted>=1.2") foo_dist = Distribution.from_filename("FooPkg-1.3_1.egg") twist11 = Distribution.from_filename("Twisted-1.1.egg") twist12 = Distribution.from_filename("Twisted-1.2.egg") assert parse_version('1.2') in r assert parse_version('1.1') not in r assert '1.2' in r assert '1.1' not in r assert foo_dist not in r assert twist11 not in r assert twist12 in r def testOptionsAndHashing(self): r1 = Requirement.parse("Twisted[foo,bar]>=1.2") r2 = Requirement.parse("Twisted[bar,FOO]>=1.2") assert r1 == r2 assert set(r1.extras) == set(("foo", "bar")) assert set(r2.extras) == set(("foo", "bar")) assert hash(r1) == hash(r2) assert ( hash(r1) == hash(( "twisted", packaging.specifiers.SpecifierSet(">=1.2"), frozenset(["foo","bar"]), None )) ) def testVersionEquality(self): r1 = Requirement.parse("foo==0.3a2") r2 = Requirement.parse("foo!=0.3a4") d = Distribution.from_filename assert d("foo-0.3a4.egg") not in r1 assert d("foo-0.3a1.egg") not in r1 assert d("foo-0.3a4.egg") not in r2 assert d("foo-0.3a2.egg") in r1 assert d("foo-0.3a2.egg") in r2 assert d("foo-0.3a3.egg") in r2 assert d("foo-0.3a5.egg") in r2 def testSetuptoolsProjectName(self): """ The setuptools project should implement the setuptools package. """ assert ( Requirement.parse('setuptools').project_name == 'setuptools') # setuptools 0.7 and higher means setuptools. assert ( Requirement.parse('setuptools == 0.7').project_name == 'setuptools') assert ( Requirement.parse('setuptools == 0.7a1').project_name == 'setuptools') assert ( Requirement.parse('setuptools >= 0.7').project_name == 'setuptools') class TestParsing: def testEmptyParse(self): assert list(parse_requirements('')) == [] def testYielding(self): for inp,out in [ ([], []), ('x',['x']), ([[]],[]), (' x\n y', ['x','y']), (['x\n\n','y'], ['x','y']), ]: assert list(pkg_resources.yield_lines(inp)) == out def testSplitting(self): sample = """ x [Y] z a [b ] # foo c [ d] [q] v """ assert ( list(pkg_resources.split_sections(sample)) == [ (None, ["x"]), ("Y", ["z", "a"]), ("b", ["c"]), ("d", []), ("q", ["v"]), ] ) with pytest.raises(ValueError): list(pkg_resources.split_sections("[foo")) def testSafeName(self): assert safe_name("adns-python") == "adns-python" assert safe_name("WSGI Utils") == "WSGI-Utils" assert safe_name("WSGI Utils") == "WSGI-Utils" assert safe_name("Money$$$Maker") == "Money-Maker" assert safe_name("peak.web") != "peak-web" def testSafeVersion(self): assert safe_version("1.2-1") == "1.2.post1" assert safe_version("1.2 alpha") == "1.2.alpha" assert safe_version("2.3.4 20050521") == "2.3.4.20050521" assert safe_version("Money$$$Maker") == "Money-Maker" assert safe_version("peak.web") == "peak.web" def testSimpleRequirements(self): assert ( list(parse_requirements('Twis-Ted>=1.2-1')) == [Requirement('Twis-Ted>=1.2-1')] ) assert ( list(parse_requirements('Twisted >=1.2, \ # more\n<2.0')) == [Requirement('Twisted>=1.2,<2.0')] ) assert ( Requirement.parse("FooBar==1.99a3") == Requirement("FooBar==1.99a3") ) with pytest.raises(ValueError): Requirement.parse(">=2.3") with pytest.raises(ValueError): Requirement.parse("x\\") with pytest.raises(ValueError): Requirement.parse("x==2 q") with pytest.raises(ValueError): Requirement.parse("X==1\nY==2") with pytest.raises(ValueError): Requirement.parse("#") def test_requirements_with_markers(self): assert ( Requirement.parse("foobar;os_name=='a'") == Requirement.parse("foobar;os_name=='a'") ) assert ( Requirement.parse("name==1.1;python_version=='2.7'") != Requirement.parse("name==1.1;python_version=='3.3'") ) assert ( Requirement.parse("name==1.0;python_version=='2.7'") != Requirement.parse("name==1.2;python_version=='2.7'") ) assert ( Requirement.parse("name[foo]==1.0;python_version=='3.3'") != Requirement.parse("name[foo,bar]==1.0;python_version=='3.3'") ) def test_local_version(self): req, = parse_requirements('foo==1.0.org1') def test_spaces_between_multiple_versions(self): req, = parse_requirements('foo>=1.0, <3') req, = parse_requirements('foo >= 1.0, < 3') def testVersionEquality(self): def c(s1,s2): p1, p2 = parse_version(s1),parse_version(s2) assert p1 == p2, (s1,s2,p1,p2) c('1.2-rc1', '1.2rc1') c('0.4', '0.4.0') c('0.4.0.0', '0.4.0') c('0.4.0-0', '0.4-0') c('0post1', '0.0post1') c('0pre1', '0.0c1') c('0.0.0preview1', '0c1') c('0.0c1', '0-rc1') c('1.2a1', '1.2.a.1') c('1.2.a', '1.2a') def testVersionOrdering(self): def c(s1,s2): p1, p2 = parse_version(s1),parse_version(s2) assert p1 tuple(parse_version("2.0")) assert parse_version("3.0") >= tuple(parse_version("2.0")) assert parse_version("3.0") != tuple(parse_version("2.0")) assert not (parse_version("3.0") != tuple(parse_version("3.0"))) def testVersionHashable(self): """ Ensure that our versions stay hashable even though we've subclassed them and added some shim code to them. """ assert ( hash(parse_version("1.0")) == hash(parse_version("1.0")) ) class TestNamespaces: ns_str = "__import__('pkg_resources').declare_namespace(__name__)\n" @pytest.yield_fixture def symlinked_tmpdir(self, tmpdir): """ Where available, return the tempdir as a symlink, which as revealed in #231 is more fragile than a natural tempdir. """ if not hasattr(os, 'symlink'): yield str(tmpdir) return link_name = str(tmpdir) + '-linked' os.symlink(str(tmpdir), link_name) try: yield type(tmpdir)(link_name) finally: os.unlink(link_name) @pytest.yield_fixture(autouse=True) def patched_path(self, tmpdir): """ Patch sys.path to include the 'site-pkgs' dir. Also restore pkg_resources._namespace_packages to its former state. """ saved_ns_pkgs = pkg_resources._namespace_packages.copy() saved_sys_path = sys.path[:] site_pkgs = tmpdir.mkdir('site-pkgs') sys.path.append(str(site_pkgs)) try: yield finally: pkg_resources._namespace_packages = saved_ns_pkgs sys.path = saved_sys_path def test_two_levels_deep(self, symlinked_tmpdir): """ Test nested namespace packages Create namespace packages in the following tree : site-packages-1/pkg1/pkg2 site-packages-2/pkg1/pkg2 Check both are in the _namespace_packages dict and that their __path__ is correct """ real_tmpdir = symlinked_tmpdir.realpath() tmpdir = symlinked_tmpdir sys.path.append(str(tmpdir / 'site-pkgs2')) site_dirs = tmpdir / 'site-pkgs', tmpdir / 'site-pkgs2' for site in site_dirs: pkg1 = site / 'pkg1' pkg2 = pkg1 / 'pkg2' pkg2.ensure_dir() (pkg1 / '__init__.py').write_text(self.ns_str, encoding='utf-8') (pkg2 / '__init__.py').write_text(self.ns_str, encoding='utf-8') import pkg1 assert "pkg1" in pkg_resources._namespace_packages # attempt to import pkg2 from site-pkgs2 import pkg1.pkg2 # check the _namespace_packages dict assert "pkg1.pkg2" in pkg_resources._namespace_packages assert pkg_resources._namespace_packages["pkg1"] == ["pkg1.pkg2"] # check the __path__ attribute contains both paths expected = [ str(real_tmpdir / "site-pkgs" / "pkg1" / "pkg2"), str(real_tmpdir / "site-pkgs2" / "pkg1" / "pkg2"), ] assert pkg1.pkg2.__path__ == expected def test_path_order(self, symlinked_tmpdir): """ Test that if multiple versions of the same namespace package subpackage are on different sys.path entries, that only the one earliest on sys.path is imported, and that the namespace package's __path__ is in the correct order. Regression test for https://github.com/pypa/setuptools/issues/207 """ tmpdir = symlinked_tmpdir site_dirs = ( tmpdir / "site-pkgs", tmpdir / "site-pkgs2", tmpdir / "site-pkgs3", ) vers_str = "__version__ = %r" for number, site in enumerate(site_dirs, 1): if number > 1: sys.path.append(str(site)) nspkg = site / 'nspkg' subpkg = nspkg / 'subpkg' subpkg.ensure_dir() (nspkg / '__init__.py').write_text(self.ns_str, encoding='utf-8') (subpkg / '__init__.py').write_text(vers_str % number, encoding='utf-8') import nspkg.subpkg import nspkg expected = [ str(site.realpath() / 'nspkg') for site in site_dirs ] assert nspkg.__path__ == expected assert nspkg.subpkg.__version__ == 1 setuptools-20.7.0/pkg_resources/__init__.py0000664000175000017500000030577512702524020021664 0ustar travistravis00000000000000""" Package resource API -------------------- A resource is a logical file contained within a package, or a logical subdirectory thereof. The package resource API expects resource names to have their path parts separated with ``/``, *not* whatever the local path separator is. Do not use os.path operations to manipulate resource names being passed into the API. The package resource API is designed to work with normal filesystem packages, .egg files, and unpacked .egg files. It can also work in a limited way with .zip files and with custom PEP 302 loaders that support the ``get_data()`` method. """ from __future__ import absolute_import import sys import os import io import time import re import types import zipfile import zipimport import warnings import stat import functools import pkgutil import operator import platform import collections import plistlib import email.parser import tempfile import textwrap from pkgutil import get_importer try: import _imp except ImportError: # Python 3.2 compatibility import imp as _imp from pkg_resources.extern import six from pkg_resources.extern.six.moves import urllib, map, filter # capture these to bypass sandboxing from os import utime try: from os import mkdir, rename, unlink WRITE_SUPPORT = True except ImportError: # no write support, probably under GAE WRITE_SUPPORT = False from os import open as os_open from os.path import isdir, split try: import importlib.machinery as importlib_machinery # access attribute to force import under delayed import mechanisms. importlib_machinery.__name__ except ImportError: importlib_machinery = None from pkg_resources.extern import packaging __import__('pkg_resources.extern.packaging.version') __import__('pkg_resources.extern.packaging.specifiers') __import__('pkg_resources.extern.packaging.requirements') __import__('pkg_resources.extern.packaging.markers') if (3, 0) < sys.version_info < (3, 3): msg = ( "Support for Python 3.0-3.2 has been dropped. Future versions " "will fail here." ) warnings.warn(msg) # declare some globals that will be defined later to # satisfy the linters. require = None working_set = None class PEP440Warning(RuntimeWarning): """ Used when there is an issue with a version or specifier not complying with PEP 440. """ class _SetuptoolsVersionMixin(object): def __hash__(self): return super(_SetuptoolsVersionMixin, self).__hash__() def __lt__(self, other): if isinstance(other, tuple): return tuple(self) < other else: return super(_SetuptoolsVersionMixin, self).__lt__(other) def __le__(self, other): if isinstance(other, tuple): return tuple(self) <= other else: return super(_SetuptoolsVersionMixin, self).__le__(other) def __eq__(self, other): if isinstance(other, tuple): return tuple(self) == other else: return super(_SetuptoolsVersionMixin, self).__eq__(other) def __ge__(self, other): if isinstance(other, tuple): return tuple(self) >= other else: return super(_SetuptoolsVersionMixin, self).__ge__(other) def __gt__(self, other): if isinstance(other, tuple): return tuple(self) > other else: return super(_SetuptoolsVersionMixin, self).__gt__(other) def __ne__(self, other): if isinstance(other, tuple): return tuple(self) != other else: return super(_SetuptoolsVersionMixin, self).__ne__(other) def __getitem__(self, key): return tuple(self)[key] def __iter__(self): component_re = re.compile(r'(\d+ | [a-z]+ | \.| -)', re.VERBOSE) replace = { 'pre': 'c', 'preview': 'c', '-': 'final-', 'rc': 'c', 'dev': '@', }.get def _parse_version_parts(s): for part in component_re.split(s): part = replace(part, part) if not part or part == '.': continue if part[:1] in '0123456789': # pad for numeric comparison yield part.zfill(8) else: yield '*'+part # ensure that alpha/beta/candidate are before final yield '*final' def old_parse_version(s): parts = [] for part in _parse_version_parts(s.lower()): if part.startswith('*'): # remove '-' before a prerelease tag if part < '*final': while parts and parts[-1] == '*final-': parts.pop() # remove trailing zeros from each series of numeric parts while parts and parts[-1] == '00000000': parts.pop() parts.append(part) return tuple(parts) # Warn for use of this function warnings.warn( "You have iterated over the result of " "pkg_resources.parse_version. This is a legacy behavior which is " "inconsistent with the new version class introduced in setuptools " "8.0. In most cases, conversion to a tuple is unnecessary. For " "comparison of versions, sort the Version instances directly. If " "you have another use case requiring the tuple, please file a " "bug with the setuptools project describing that need.", RuntimeWarning, stacklevel=1, ) for part in old_parse_version(str(self)): yield part class SetuptoolsVersion(_SetuptoolsVersionMixin, packaging.version.Version): pass class SetuptoolsLegacyVersion(_SetuptoolsVersionMixin, packaging.version.LegacyVersion): pass def parse_version(v): try: return SetuptoolsVersion(v) except packaging.version.InvalidVersion: return SetuptoolsLegacyVersion(v) _state_vars = {} def _declare_state(vartype, **kw): globals().update(kw) _state_vars.update(dict.fromkeys(kw, vartype)) def __getstate__(): state = {} g = globals() for k, v in _state_vars.items(): state[k] = g['_sget_'+v](g[k]) return state def __setstate__(state): g = globals() for k, v in state.items(): g['_sset_'+_state_vars[k]](k, g[k], v) return state def _sget_dict(val): return val.copy() def _sset_dict(key, ob, state): ob.clear() ob.update(state) def _sget_object(val): return val.__getstate__() def _sset_object(key, ob, state): ob.__setstate__(state) _sget_none = _sset_none = lambda *args: None def get_supported_platform(): """Return this platform's maximum compatible version. distutils.util.get_platform() normally reports the minimum version of Mac OS X that would be required to *use* extensions produced by distutils. But what we want when checking compatibility is to know the version of Mac OS X that we are *running*. To allow usage of packages that explicitly require a newer version of Mac OS X, we must also know the current version of the OS. If this condition occurs for any other platform with a version in its platform strings, this function should be extended accordingly. """ plat = get_build_platform() m = macosVersionString.match(plat) if m is not None and sys.platform == "darwin": try: plat = 'macosx-%s-%s' % ('.'.join(_macosx_vers()[:2]), m.group(3)) except ValueError: # not Mac OS X pass return plat __all__ = [ # Basic resource access and distribution/entry point discovery 'require', 'run_script', 'get_provider', 'get_distribution', 'load_entry_point', 'get_entry_map', 'get_entry_info', 'iter_entry_points', 'resource_string', 'resource_stream', 'resource_filename', 'resource_listdir', 'resource_exists', 'resource_isdir', # Environmental control 'declare_namespace', 'working_set', 'add_activation_listener', 'find_distributions', 'set_extraction_path', 'cleanup_resources', 'get_default_cache', # Primary implementation classes 'Environment', 'WorkingSet', 'ResourceManager', 'Distribution', 'Requirement', 'EntryPoint', # Exceptions 'ResolutionError', 'VersionConflict', 'DistributionNotFound', 'UnknownExtra', 'ExtractionError', # Warnings 'PEP440Warning', # Parsing functions and string utilities 'parse_requirements', 'parse_version', 'safe_name', 'safe_version', 'get_platform', 'compatible_platforms', 'yield_lines', 'split_sections', 'safe_extra', 'to_filename', 'invalid_marker', 'evaluate_marker', # filesystem utilities 'ensure_directory', 'normalize_path', # Distribution "precedence" constants 'EGG_DIST', 'BINARY_DIST', 'SOURCE_DIST', 'CHECKOUT_DIST', 'DEVELOP_DIST', # "Provider" interfaces, implementations, and registration/lookup APIs 'IMetadataProvider', 'IResourceProvider', 'FileMetadata', 'PathMetadata', 'EggMetadata', 'EmptyProvider', 'empty_provider', 'NullProvider', 'EggProvider', 'DefaultProvider', 'ZipProvider', 'register_finder', 'register_namespace_handler', 'register_loader_type', 'fixup_namespace_packages', 'get_importer', # Deprecated/backward compatibility only 'run_main', 'AvailableDistributions', ] class ResolutionError(Exception): """Abstract base for dependency resolution errors""" def __repr__(self): return self.__class__.__name__+repr(self.args) class VersionConflict(ResolutionError): """ An already-installed version conflicts with the requested version. Should be initialized with the installed Distribution and the requested Requirement. """ _template = "{self.dist} is installed but {self.req} is required" @property def dist(self): return self.args[0] @property def req(self): return self.args[1] def report(self): return self._template.format(**locals()) def with_context(self, required_by): """ If required_by is non-empty, return a version of self that is a ContextualVersionConflict. """ if not required_by: return self args = self.args + (required_by,) return ContextualVersionConflict(*args) class ContextualVersionConflict(VersionConflict): """ A VersionConflict that accepts a third parameter, the set of the requirements that required the installed Distribution. """ _template = VersionConflict._template + ' by {self.required_by}' @property def required_by(self): return self.args[2] class DistributionNotFound(ResolutionError): """A requested distribution was not found""" _template = ("The '{self.req}' distribution was not found " "and is required by {self.requirers_str}") @property def req(self): return self.args[0] @property def requirers(self): return self.args[1] @property def requirers_str(self): if not self.requirers: return 'the application' return ', '.join(self.requirers) def report(self): return self._template.format(**locals()) def __str__(self): return self.report() class UnknownExtra(ResolutionError): """Distribution doesn't have an "extra feature" of the given name""" _provider_factories = {} PY_MAJOR = sys.version[:3] EGG_DIST = 3 BINARY_DIST = 2 SOURCE_DIST = 1 CHECKOUT_DIST = 0 DEVELOP_DIST = -1 def register_loader_type(loader_type, provider_factory): """Register `provider_factory` to make providers for `loader_type` `loader_type` is the type or class of a PEP 302 ``module.__loader__``, and `provider_factory` is a function that, passed a *module* object, returns an ``IResourceProvider`` for that module. """ _provider_factories[loader_type] = provider_factory def get_provider(moduleOrReq): """Return an IResourceProvider for the named module or requirement""" if isinstance(moduleOrReq, Requirement): return working_set.find(moduleOrReq) or require(str(moduleOrReq))[0] try: module = sys.modules[moduleOrReq] except KeyError: __import__(moduleOrReq) module = sys.modules[moduleOrReq] loader = getattr(module, '__loader__', None) return _find_adapter(_provider_factories, loader)(module) def _macosx_vers(_cache=[]): if not _cache: version = platform.mac_ver()[0] # fallback for MacPorts if version == '': plist = '/System/Library/CoreServices/SystemVersion.plist' if os.path.exists(plist): if hasattr(plistlib, 'readPlist'): plist_content = plistlib.readPlist(plist) if 'ProductVersion' in plist_content: version = plist_content['ProductVersion'] _cache.append(version.split('.')) return _cache[0] def _macosx_arch(machine): return {'PowerPC': 'ppc', 'Power_Macintosh': 'ppc'}.get(machine, machine) def get_build_platform(): """Return this platform's string for platform-specific distributions XXX Currently this is the same as ``distutils.util.get_platform()``, but it needs some hacks for Linux and Mac OS X. """ try: # Python 2.7 or >=3.2 from sysconfig import get_platform except ImportError: from distutils.util import get_platform plat = get_platform() if sys.platform == "darwin" and not plat.startswith('macosx-'): try: version = _macosx_vers() machine = os.uname()[4].replace(" ", "_") return "macosx-%d.%d-%s" % (int(version[0]), int(version[1]), _macosx_arch(machine)) except ValueError: # if someone is running a non-Mac darwin system, this will fall # through to the default implementation pass return plat macosVersionString = re.compile(r"macosx-(\d+)\.(\d+)-(.*)") darwinVersionString = re.compile(r"darwin-(\d+)\.(\d+)\.(\d+)-(.*)") # XXX backward compat get_platform = get_build_platform def compatible_platforms(provided, required): """Can code for the `provided` platform run on the `required` platform? Returns true if either platform is ``None``, or the platforms are equal. XXX Needs compatibility checks for Linux and other unixy OSes. """ if provided is None or required is None or provided==required: # easy case return True # Mac OS X special cases reqMac = macosVersionString.match(required) if reqMac: provMac = macosVersionString.match(provided) # is this a Mac package? if not provMac: # this is backwards compatibility for packages built before # setuptools 0.6. All packages built after this point will # use the new macosx designation. provDarwin = darwinVersionString.match(provided) if provDarwin: dversion = int(provDarwin.group(1)) macosversion = "%s.%s" % (reqMac.group(1), reqMac.group(2)) if dversion == 7 and macosversion >= "10.3" or \ dversion == 8 and macosversion >= "10.4": return True # egg isn't macosx or legacy darwin return False # are they the same major version and machine type? if provMac.group(1) != reqMac.group(1) or \ provMac.group(3) != reqMac.group(3): return False # is the required OS major update >= the provided one? if int(provMac.group(2)) > int(reqMac.group(2)): return False return True # XXX Linux and other platforms' special cases should go here return False def run_script(dist_spec, script_name): """Locate distribution `dist_spec` and run its `script_name` script""" ns = sys._getframe(1).f_globals name = ns['__name__'] ns.clear() ns['__name__'] = name require(dist_spec)[0].run_script(script_name, ns) # backward compatibility run_main = run_script def get_distribution(dist): """Return a current distribution object for a Requirement or string""" if isinstance(dist, six.string_types): dist = Requirement.parse(dist) if isinstance(dist, Requirement): dist = get_provider(dist) if not isinstance(dist, Distribution): raise TypeError("Expected string, Requirement, or Distribution", dist) return dist def load_entry_point(dist, group, name): """Return `name` entry point of `group` for `dist` or raise ImportError""" return get_distribution(dist).load_entry_point(group, name) def get_entry_map(dist, group=None): """Return the entry point map for `group`, or the full entry map""" return get_distribution(dist).get_entry_map(group) def get_entry_info(dist, group, name): """Return the EntryPoint object for `group`+`name`, or ``None``""" return get_distribution(dist).get_entry_info(group, name) class IMetadataProvider: def has_metadata(name): """Does the package's distribution contain the named metadata?""" def get_metadata(name): """The named metadata resource as a string""" def get_metadata_lines(name): """Yield named metadata resource as list of non-blank non-comment lines Leading and trailing whitespace is stripped from each line, and lines with ``#`` as the first non-blank character are omitted.""" def metadata_isdir(name): """Is the named metadata a directory? (like ``os.path.isdir()``)""" def metadata_listdir(name): """List of metadata names in the directory (like ``os.listdir()``)""" def run_script(script_name, namespace): """Execute the named script in the supplied namespace dictionary""" class IResourceProvider(IMetadataProvider): """An object that provides access to package resources""" def get_resource_filename(manager, resource_name): """Return a true filesystem path for `resource_name` `manager` must be an ``IResourceManager``""" def get_resource_stream(manager, resource_name): """Return a readable file-like object for `resource_name` `manager` must be an ``IResourceManager``""" def get_resource_string(manager, resource_name): """Return a string containing the contents of `resource_name` `manager` must be an ``IResourceManager``""" def has_resource(resource_name): """Does the package contain the named resource?""" def resource_isdir(resource_name): """Is the named resource a directory? (like ``os.path.isdir()``)""" def resource_listdir(resource_name): """List of resource names in the directory (like ``os.listdir()``)""" class WorkingSet(object): """A collection of active distributions on sys.path (or a similar list)""" def __init__(self, entries=None): """Create working set from list of path entries (default=sys.path)""" self.entries = [] self.entry_keys = {} self.by_key = {} self.callbacks = [] if entries is None: entries = sys.path for entry in entries: self.add_entry(entry) @classmethod def _build_master(cls): """ Prepare the master working set. """ ws = cls() try: from __main__ import __requires__ except ImportError: # The main program does not list any requirements return ws # ensure the requirements are met try: ws.require(__requires__) except VersionConflict: return cls._build_from_requirements(__requires__) return ws @classmethod def _build_from_requirements(cls, req_spec): """ Build a working set from a requirement spec. Rewrites sys.path. """ # try it without defaults already on sys.path # by starting with an empty path ws = cls([]) reqs = parse_requirements(req_spec) dists = ws.resolve(reqs, Environment()) for dist in dists: ws.add(dist) # add any missing entries from sys.path for entry in sys.path: if entry not in ws.entries: ws.add_entry(entry) # then copy back to sys.path sys.path[:] = ws.entries return ws def add_entry(self, entry): """Add a path item to ``.entries``, finding any distributions on it ``find_distributions(entry, True)`` is used to find distributions corresponding to the path entry, and they are added. `entry` is always appended to ``.entries``, even if it is already present. (This is because ``sys.path`` can contain the same value more than once, and the ``.entries`` of the ``sys.path`` WorkingSet should always equal ``sys.path``.) """ self.entry_keys.setdefault(entry, []) self.entries.append(entry) for dist in find_distributions(entry, True): self.add(dist, entry, False) def __contains__(self, dist): """True if `dist` is the active distribution for its project""" return self.by_key.get(dist.key) == dist def find(self, req): """Find a distribution matching requirement `req` If there is an active distribution for the requested project, this returns it as long as it meets the version requirement specified by `req`. But, if there is an active distribution for the project and it does *not* meet the `req` requirement, ``VersionConflict`` is raised. If there is no active distribution for the requested project, ``None`` is returned. """ dist = self.by_key.get(req.key) if dist is not None and dist not in req: # XXX add more info raise VersionConflict(dist, req) return dist def iter_entry_points(self, group, name=None): """Yield entry point objects from `group` matching `name` If `name` is None, yields all entry points in `group` from all distributions in the working set, otherwise only ones matching both `group` and `name` are yielded (in distribution order). """ for dist in self: entries = dist.get_entry_map(group) if name is None: for ep in entries.values(): yield ep elif name in entries: yield entries[name] def run_script(self, requires, script_name): """Locate distribution for `requires` and run `script_name` script""" ns = sys._getframe(1).f_globals name = ns['__name__'] ns.clear() ns['__name__'] = name self.require(requires)[0].run_script(script_name, ns) def __iter__(self): """Yield distributions for non-duplicate projects in the working set The yield order is the order in which the items' path entries were added to the working set. """ seen = {} for item in self.entries: if item not in self.entry_keys: # workaround a cache issue continue for key in self.entry_keys[item]: if key not in seen: seen[key]=1 yield self.by_key[key] def add(self, dist, entry=None, insert=True, replace=False): """Add `dist` to working set, associated with `entry` If `entry` is unspecified, it defaults to the ``.location`` of `dist`. On exit from this routine, `entry` is added to the end of the working set's ``.entries`` (if it wasn't already present). `dist` is only added to the working set if it's for a project that doesn't already have a distribution in the set, unless `replace=True`. If it's added, any callbacks registered with the ``subscribe()`` method will be called. """ if insert: dist.insert_on(self.entries, entry, replace=replace) if entry is None: entry = dist.location keys = self.entry_keys.setdefault(entry,[]) keys2 = self.entry_keys.setdefault(dist.location,[]) if not replace and dist.key in self.by_key: # ignore hidden distros return self.by_key[dist.key] = dist if dist.key not in keys: keys.append(dist.key) if dist.key not in keys2: keys2.append(dist.key) self._added_new(dist) def resolve(self, requirements, env=None, installer=None, replace_conflicting=False): """List all distributions needed to (recursively) meet `requirements` `requirements` must be a sequence of ``Requirement`` objects. `env`, if supplied, should be an ``Environment`` instance. If not supplied, it defaults to all distributions available within any entry or distribution in the working set. `installer`, if supplied, will be invoked with each requirement that cannot be met by an already-installed distribution; it should return a ``Distribution`` or ``None``. Unless `replace_conflicting=True`, raises a VersionConflict exception if any requirements are found on the path that have the correct name but the wrong version. Otherwise, if an `installer` is supplied it will be invoked to obtain the correct version of the requirement and activate it. """ # set up the stack requirements = list(requirements)[::-1] # set of processed requirements processed = {} # key -> dist best = {} to_activate = [] req_extras = _ReqExtras() # Mapping of requirement to set of distributions that required it; # useful for reporting info about conflicts. required_by = collections.defaultdict(set) while requirements: # process dependencies breadth-first req = requirements.pop(0) if req in processed: # Ignore cyclic or redundant dependencies continue if not req_extras.markers_pass(req): continue dist = best.get(req.key) if dist is None: # Find the best distribution and add it to the map dist = self.by_key.get(req.key) if dist is None or (dist not in req and replace_conflicting): ws = self if env is None: if dist is None: env = Environment(self.entries) else: # Use an empty environment and workingset to avoid # any further conflicts with the conflicting # distribution env = Environment([]) ws = WorkingSet([]) dist = best[req.key] = env.best_match(req, ws, installer) if dist is None: requirers = required_by.get(req, None) raise DistributionNotFound(req, requirers) to_activate.append(dist) if dist not in req: # Oops, the "best" so far conflicts with a dependency dependent_req = required_by[req] raise VersionConflict(dist, req).with_context(dependent_req) # push the new requirements onto the stack new_requirements = dist.requires(req.extras)[::-1] requirements.extend(new_requirements) # Register the new requirements needed by req for new_requirement in new_requirements: required_by[new_requirement].add(req.project_name) req_extras[new_requirement] = req.extras processed[req] = True # return list of distros to activate return to_activate def find_plugins(self, plugin_env, full_env=None, installer=None, fallback=True): """Find all activatable distributions in `plugin_env` Example usage:: distributions, errors = working_set.find_plugins( Environment(plugin_dirlist) ) # add plugins+libs to sys.path map(working_set.add, distributions) # display errors print('Could not load', errors) The `plugin_env` should be an ``Environment`` instance that contains only distributions that are in the project's "plugin directory" or directories. The `full_env`, if supplied, should be an ``Environment`` contains all currently-available distributions. If `full_env` is not supplied, one is created automatically from the ``WorkingSet`` this method is called on, which will typically mean that every directory on ``sys.path`` will be scanned for distributions. `installer` is a standard installer callback as used by the ``resolve()`` method. The `fallback` flag indicates whether we should attempt to resolve older versions of a plugin if the newest version cannot be resolved. This method returns a 2-tuple: (`distributions`, `error_info`), where `distributions` is a list of the distributions found in `plugin_env` that were loadable, along with any other distributions that are needed to resolve their dependencies. `error_info` is a dictionary mapping unloadable plugin distributions to an exception instance describing the error that occurred. Usually this will be a ``DistributionNotFound`` or ``VersionConflict`` instance. """ plugin_projects = list(plugin_env) # scan project names in alphabetic order plugin_projects.sort() error_info = {} distributions = {} if full_env is None: env = Environment(self.entries) env += plugin_env else: env = full_env + plugin_env shadow_set = self.__class__([]) # put all our entries in shadow_set list(map(shadow_set.add, self)) for project_name in plugin_projects: for dist in plugin_env[project_name]: req = [dist.as_requirement()] try: resolvees = shadow_set.resolve(req, env, installer) except ResolutionError as v: # save error info error_info[dist] = v if fallback: # try the next older version of project continue else: # give up on this project, keep going break else: list(map(shadow_set.add, resolvees)) distributions.update(dict.fromkeys(resolvees)) # success, no need to try any more versions of this project break distributions = list(distributions) distributions.sort() return distributions, error_info def require(self, *requirements): """Ensure that distributions matching `requirements` are activated `requirements` must be a string or a (possibly-nested) sequence thereof, specifying the distributions and versions required. The return value is a sequence of the distributions that needed to be activated to fulfill the requirements; all relevant distributions are included, even if they were already activated in this working set. """ needed = self.resolve(parse_requirements(requirements)) for dist in needed: self.add(dist) return needed def subscribe(self, callback): """Invoke `callback` for all distributions (including existing ones)""" if callback in self.callbacks: return self.callbacks.append(callback) for dist in self: callback(dist) def _added_new(self, dist): for callback in self.callbacks: callback(dist) def __getstate__(self): return ( self.entries[:], self.entry_keys.copy(), self.by_key.copy(), self.callbacks[:] ) def __setstate__(self, e_k_b_c): entries, keys, by_key, callbacks = e_k_b_c self.entries = entries[:] self.entry_keys = keys.copy() self.by_key = by_key.copy() self.callbacks = callbacks[:] class _ReqExtras(dict): """ Map each requirement to the extras that demanded it. """ def markers_pass(self, req): """ Evaluate markers for req against each extra that demanded it. Return False if the req has a marker and fails evaluation. Otherwise, return True. """ extra_evals = ( req.marker.evaluate({'extra': extra}) for extra in self.get(req, ()) ) return not req.marker or any(extra_evals) or req.marker.evaluate() class Environment(object): """Searchable snapshot of distributions on a search path""" def __init__(self, search_path=None, platform=get_supported_platform(), python=PY_MAJOR): """Snapshot distributions available on a search path Any distributions found on `search_path` are added to the environment. `search_path` should be a sequence of ``sys.path`` items. If not supplied, ``sys.path`` is used. `platform` is an optional string specifying the name of the platform that platform-specific distributions must be compatible with. If unspecified, it defaults to the current platform. `python` is an optional string naming the desired version of Python (e.g. ``'3.3'``); it defaults to the current version. You may explicitly set `platform` (and/or `python`) to ``None`` if you wish to map *all* distributions, not just those compatible with the running platform or Python version. """ self._distmap = {} self.platform = platform self.python = python self.scan(search_path) def can_add(self, dist): """Is distribution `dist` acceptable for this environment? The distribution must match the platform and python version requirements specified when this environment was created, or False is returned. """ return (self.python is None or dist.py_version is None or dist.py_version==self.python) \ and compatible_platforms(dist.platform, self.platform) def remove(self, dist): """Remove `dist` from the environment""" self._distmap[dist.key].remove(dist) def scan(self, search_path=None): """Scan `search_path` for distributions usable in this environment Any distributions found are added to the environment. `search_path` should be a sequence of ``sys.path`` items. If not supplied, ``sys.path`` is used. Only distributions conforming to the platform/python version defined at initialization are added. """ if search_path is None: search_path = sys.path for item in search_path: for dist in find_distributions(item): self.add(dist) def __getitem__(self, project_name): """Return a newest-to-oldest list of distributions for `project_name` Uses case-insensitive `project_name` comparison, assuming all the project's distributions use their project's name converted to all lowercase as their key. """ distribution_key = project_name.lower() return self._distmap.get(distribution_key, []) def add(self, dist): """Add `dist` if we ``can_add()`` it and it has not already been added """ if self.can_add(dist) and dist.has_version(): dists = self._distmap.setdefault(dist.key, []) if dist not in dists: dists.append(dist) dists.sort(key=operator.attrgetter('hashcmp'), reverse=True) def best_match(self, req, working_set, installer=None): """Find distribution best matching `req` and usable on `working_set` This calls the ``find(req)`` method of the `working_set` to see if a suitable distribution is already active. (This may raise ``VersionConflict`` if an unsuitable version of the project is already active in the specified `working_set`.) If a suitable distribution isn't active, this method returns the newest distribution in the environment that meets the ``Requirement`` in `req`. If no suitable distribution is found, and `installer` is supplied, then the result of calling the environment's ``obtain(req, installer)`` method will be returned. """ dist = working_set.find(req) if dist is not None: return dist for dist in self[req.key]: if dist in req: return dist # try to download/install return self.obtain(req, installer) def obtain(self, requirement, installer=None): """Obtain a distribution matching `requirement` (e.g. via download) Obtain a distro that matches requirement (e.g. via download). In the base ``Environment`` class, this routine just returns ``installer(requirement)``, unless `installer` is None, in which case None is returned instead. This method is a hook that allows subclasses to attempt other ways of obtaining a distribution before falling back to the `installer` argument.""" if installer is not None: return installer(requirement) def __iter__(self): """Yield the unique project names of the available distributions""" for key in self._distmap.keys(): if self[key]: yield key def __iadd__(self, other): """In-place addition of a distribution or environment""" if isinstance(other, Distribution): self.add(other) elif isinstance(other, Environment): for project in other: for dist in other[project]: self.add(dist) else: raise TypeError("Can't add %r to environment" % (other,)) return self def __add__(self, other): """Add an environment or distribution to an environment""" new = self.__class__([], platform=None, python=None) for env in self, other: new += env return new # XXX backward compatibility AvailableDistributions = Environment class ExtractionError(RuntimeError): """An error occurred extracting a resource The following attributes are available from instances of this exception: manager The resource manager that raised this exception cache_path The base directory for resource extraction original_error The exception instance that caused extraction to fail """ class ResourceManager: """Manage resource extraction and packages""" extraction_path = None def __init__(self): self.cached_files = {} def resource_exists(self, package_or_requirement, resource_name): """Does the named resource exist?""" return get_provider(package_or_requirement).has_resource(resource_name) def resource_isdir(self, package_or_requirement, resource_name): """Is the named resource an existing directory?""" return get_provider(package_or_requirement).resource_isdir( resource_name ) def resource_filename(self, package_or_requirement, resource_name): """Return a true filesystem path for specified resource""" return get_provider(package_or_requirement).get_resource_filename( self, resource_name ) def resource_stream(self, package_or_requirement, resource_name): """Return a readable file-like object for specified resource""" return get_provider(package_or_requirement).get_resource_stream( self, resource_name ) def resource_string(self, package_or_requirement, resource_name): """Return specified resource as a string""" return get_provider(package_or_requirement).get_resource_string( self, resource_name ) def resource_listdir(self, package_or_requirement, resource_name): """List the contents of the named resource directory""" return get_provider(package_or_requirement).resource_listdir( resource_name ) def extraction_error(self): """Give an error message for problems extracting file(s)""" old_exc = sys.exc_info()[1] cache_path = self.extraction_path or get_default_cache() tmpl = textwrap.dedent(""" Can't extract file(s) to egg cache The following error occurred while trying to extract file(s) to the Python egg cache: {old_exc} The Python egg cache directory is currently set to: {cache_path} Perhaps your account does not have write access to this directory? You can change the cache directory by setting the PYTHON_EGG_CACHE environment variable to point to an accessible directory. """).lstrip() err = ExtractionError(tmpl.format(**locals())) err.manager = self err.cache_path = cache_path err.original_error = old_exc raise err def get_cache_path(self, archive_name, names=()): """Return absolute location in cache for `archive_name` and `names` The parent directory of the resulting path will be created if it does not already exist. `archive_name` should be the base filename of the enclosing egg (which may not be the name of the enclosing zipfile!), including its ".egg" extension. `names`, if provided, should be a sequence of path name parts "under" the egg's extraction location. This method should only be called by resource providers that need to obtain an extraction location, and only for names they intend to extract, as it tracks the generated names for possible cleanup later. """ extract_path = self.extraction_path or get_default_cache() target_path = os.path.join(extract_path, archive_name+'-tmp', *names) try: _bypass_ensure_directory(target_path) except: self.extraction_error() self._warn_unsafe_extraction_path(extract_path) self.cached_files[target_path] = 1 return target_path @staticmethod def _warn_unsafe_extraction_path(path): """ If the default extraction path is overridden and set to an insecure location, such as /tmp, it opens up an opportunity for an attacker to replace an extracted file with an unauthorized payload. Warn the user if a known insecure location is used. See Distribute #375 for more details. """ if os.name == 'nt' and not path.startswith(os.environ['windir']): # On Windows, permissions are generally restrictive by default # and temp directories are not writable by other users, so # bypass the warning. return mode = os.stat(path).st_mode if mode & stat.S_IWOTH or mode & stat.S_IWGRP: msg = ("%s is writable by group/others and vulnerable to attack " "when " "used with get_resource_filename. Consider a more secure " "location (set with .set_extraction_path or the " "PYTHON_EGG_CACHE environment variable)." % path) warnings.warn(msg, UserWarning) def postprocess(self, tempname, filename): """Perform any platform-specific postprocessing of `tempname` This is where Mac header rewrites should be done; other platforms don't have anything special they should do. Resource providers should call this method ONLY after successfully extracting a compressed resource. They must NOT call it on resources that are already in the filesystem. `tempname` is the current (temporary) name of the file, and `filename` is the name it will be renamed to by the caller after this routine returns. """ if os.name == 'posix': # Make the resource executable mode = ((os.stat(tempname).st_mode) | 0o555) & 0o7777 os.chmod(tempname, mode) def set_extraction_path(self, path): """Set the base path where resources will be extracted to, if needed. If you do not call this routine before any extractions take place, the path defaults to the return value of ``get_default_cache()``. (Which is based on the ``PYTHON_EGG_CACHE`` environment variable, with various platform-specific fallbacks. See that routine's documentation for more details.) Resources are extracted to subdirectories of this path based upon information given by the ``IResourceProvider``. You may set this to a temporary directory, but then you must call ``cleanup_resources()`` to delete the extracted files when done. There is no guarantee that ``cleanup_resources()`` will be able to remove all extracted files. (Note: you may not change the extraction path for a given resource manager once resources have been extracted, unless you first call ``cleanup_resources()``.) """ if self.cached_files: raise ValueError( "Can't change extraction path, files already extracted" ) self.extraction_path = path def cleanup_resources(self, force=False): """ Delete all extracted resource files and directories, returning a list of the file and directory names that could not be successfully removed. This function does not have any concurrency protection, so it should generally only be called when the extraction path is a temporary directory exclusive to a single process. This method is not automatically called; you must call it explicitly or register it as an ``atexit`` function if you wish to ensure cleanup of a temporary directory used for extractions. """ # XXX def get_default_cache(): """Determine the default cache location This returns the ``PYTHON_EGG_CACHE`` environment variable, if set. Otherwise, on Windows, it returns a "Python-Eggs" subdirectory of the "Application Data" directory. On all other systems, it's "~/.python-eggs". """ try: return os.environ['PYTHON_EGG_CACHE'] except KeyError: pass if os.name!='nt': return os.path.expanduser('~/.python-eggs') # XXX this may be locale-specific! app_data = 'Application Data' app_homes = [ # best option, should be locale-safe (('APPDATA',), None), (('USERPROFILE',), app_data), (('HOMEDRIVE','HOMEPATH'), app_data), (('HOMEPATH',), app_data), (('HOME',), None), # 95/98/ME (('WINDIR',), app_data), ] for keys, subdir in app_homes: dirname = '' for key in keys: if key in os.environ: dirname = os.path.join(dirname, os.environ[key]) else: break else: if subdir: dirname = os.path.join(dirname, subdir) return os.path.join(dirname, 'Python-Eggs') else: raise RuntimeError( "Please set the PYTHON_EGG_CACHE enviroment variable" ) def safe_name(name): """Convert an arbitrary string to a standard distribution name Any runs of non-alphanumeric/. characters are replaced with a single '-'. """ return re.sub('[^A-Za-z0-9.]+', '-', name) def safe_version(version): """ Convert an arbitrary string to a standard version string """ try: # normalize the version return str(packaging.version.Version(version)) except packaging.version.InvalidVersion: version = version.replace(' ','.') return re.sub('[^A-Za-z0-9.]+', '-', version) def safe_extra(extra): """Convert an arbitrary string to a standard 'extra' name Any runs of non-alphanumeric characters are replaced with a single '_', and the result is always lowercased. """ return re.sub('[^A-Za-z0-9.]+', '_', extra).lower() def to_filename(name): """Convert a project or version name to its filename-escaped form Any '-' characters are currently replaced with '_'. """ return name.replace('-','_') def invalid_marker(text): """ Validate text as a PEP 508 environment marker; return an exception if invalid or False otherwise. """ try: evaluate_marker(text) except SyntaxError as e: e.filename = None e.lineno = None return e return False def evaluate_marker(text, extra=None): """ Evaluate a PEP 508 environment marker. Return a boolean indicating the marker result in this environment. Raise SyntaxError if marker is invalid. This implementation uses the 'pyparsing' module. """ try: marker = packaging.markers.Marker(text) return marker.evaluate() except packaging.markers.InvalidMarker as e: raise SyntaxError(e) class NullProvider: """Try to implement resources and metadata for arbitrary PEP 302 loaders""" egg_name = None egg_info = None loader = None def __init__(self, module): self.loader = getattr(module, '__loader__', None) self.module_path = os.path.dirname(getattr(module, '__file__', '')) def get_resource_filename(self, manager, resource_name): return self._fn(self.module_path, resource_name) def get_resource_stream(self, manager, resource_name): return io.BytesIO(self.get_resource_string(manager, resource_name)) def get_resource_string(self, manager, resource_name): return self._get(self._fn(self.module_path, resource_name)) def has_resource(self, resource_name): return self._has(self._fn(self.module_path, resource_name)) def has_metadata(self, name): return self.egg_info and self._has(self._fn(self.egg_info, name)) if sys.version_info <= (3,): def get_metadata(self, name): if not self.egg_info: return "" return self._get(self._fn(self.egg_info, name)) else: def get_metadata(self, name): if not self.egg_info: return "" return self._get(self._fn(self.egg_info, name)).decode("utf-8") def get_metadata_lines(self, name): return yield_lines(self.get_metadata(name)) def resource_isdir(self, resource_name): return self._isdir(self._fn(self.module_path, resource_name)) def metadata_isdir(self, name): return self.egg_info and self._isdir(self._fn(self.egg_info, name)) def resource_listdir(self, resource_name): return self._listdir(self._fn(self.module_path, resource_name)) def metadata_listdir(self, name): if self.egg_info: return self._listdir(self._fn(self.egg_info, name)) return [] def run_script(self, script_name, namespace): script = 'scripts/'+script_name if not self.has_metadata(script): raise ResolutionError("No script named %r" % script_name) script_text = self.get_metadata(script).replace('\r\n', '\n') script_text = script_text.replace('\r', '\n') script_filename = self._fn(self.egg_info, script) namespace['__file__'] = script_filename if os.path.exists(script_filename): source = open(script_filename).read() code = compile(source, script_filename, 'exec') exec(code, namespace, namespace) else: from linecache import cache cache[script_filename] = ( len(script_text), 0, script_text.split('\n'), script_filename ) script_code = compile(script_text, script_filename,'exec') exec(script_code, namespace, namespace) def _has(self, path): raise NotImplementedError( "Can't perform this operation for unregistered loader type" ) def _isdir(self, path): raise NotImplementedError( "Can't perform this operation for unregistered loader type" ) def _listdir(self, path): raise NotImplementedError( "Can't perform this operation for unregistered loader type" ) def _fn(self, base, resource_name): if resource_name: return os.path.join(base, *resource_name.split('/')) return base def _get(self, path): if hasattr(self.loader, 'get_data'): return self.loader.get_data(path) raise NotImplementedError( "Can't perform this operation for loaders without 'get_data()'" ) register_loader_type(object, NullProvider) class EggProvider(NullProvider): """Provider based on a virtual filesystem""" def __init__(self, module): NullProvider.__init__(self, module) self._setup_prefix() def _setup_prefix(self): # we assume here that our metadata may be nested inside a "basket" # of multiple eggs; that's why we use module_path instead of .archive path = self.module_path old = None while path!=old: if _is_unpacked_egg(path): self.egg_name = os.path.basename(path) self.egg_info = os.path.join(path, 'EGG-INFO') self.egg_root = path break old = path path, base = os.path.split(path) class DefaultProvider(EggProvider): """Provides access to package resources in the filesystem""" def _has(self, path): return os.path.exists(path) def _isdir(self, path): return os.path.isdir(path) def _listdir(self, path): return os.listdir(path) def get_resource_stream(self, manager, resource_name): return open(self._fn(self.module_path, resource_name), 'rb') def _get(self, path): with open(path, 'rb') as stream: return stream.read() @classmethod def _register(cls): loader_cls = getattr(importlib_machinery, 'SourceFileLoader', type(None)) register_loader_type(loader_cls, cls) DefaultProvider._register() class EmptyProvider(NullProvider): """Provider that returns nothing for all requests""" _isdir = _has = lambda self, path: False _get = lambda self, path: '' _listdir = lambda self, path: [] module_path = None def __init__(self): pass empty_provider = EmptyProvider() class ZipManifests(dict): """ zip manifest builder """ @classmethod def build(cls, path): """ Build a dictionary similar to the zipimport directory caches, except instead of tuples, store ZipInfo objects. Use a platform-specific path separator (os.sep) for the path keys for compatibility with pypy on Windows. """ with ContextualZipFile(path) as zfile: items = ( ( name.replace('/', os.sep), zfile.getinfo(name), ) for name in zfile.namelist() ) return dict(items) load = build class MemoizedZipManifests(ZipManifests): """ Memoized zipfile manifests. """ manifest_mod = collections.namedtuple('manifest_mod', 'manifest mtime') def load(self, path): """ Load a manifest at path or return a suitable manifest already loaded. """ path = os.path.normpath(path) mtime = os.stat(path).st_mtime if path not in self or self[path].mtime != mtime: manifest = self.build(path) self[path] = self.manifest_mod(manifest, mtime) return self[path].manifest class ContextualZipFile(zipfile.ZipFile): """ Supplement ZipFile class to support context manager for Python 2.6 """ def __enter__(self): return self def __exit__(self, type, value, traceback): self.close() def __new__(cls, *args, **kwargs): """ Construct a ZipFile or ContextualZipFile as appropriate """ if hasattr(zipfile.ZipFile, '__exit__'): return zipfile.ZipFile(*args, **kwargs) return super(ContextualZipFile, cls).__new__(cls) class ZipProvider(EggProvider): """Resource support for zips and eggs""" eagers = None _zip_manifests = MemoizedZipManifests() def __init__(self, module): EggProvider.__init__(self, module) self.zip_pre = self.loader.archive+os.sep def _zipinfo_name(self, fspath): # Convert a virtual filename (full path to file) into a zipfile subpath # usable with the zipimport directory cache for our target archive if fspath.startswith(self.zip_pre): return fspath[len(self.zip_pre):] raise AssertionError( "%s is not a subpath of %s" % (fspath, self.zip_pre) ) def _parts(self, zip_path): # Convert a zipfile subpath into an egg-relative path part list. # pseudo-fs path fspath = self.zip_pre+zip_path if fspath.startswith(self.egg_root+os.sep): return fspath[len(self.egg_root)+1:].split(os.sep) raise AssertionError( "%s is not a subpath of %s" % (fspath, self.egg_root) ) @property def zipinfo(self): return self._zip_manifests.load(self.loader.archive) def get_resource_filename(self, manager, resource_name): if not self.egg_name: raise NotImplementedError( "resource_filename() only supported for .egg, not .zip" ) # no need to lock for extraction, since we use temp names zip_path = self._resource_to_zip(resource_name) eagers = self._get_eager_resources() if '/'.join(self._parts(zip_path)) in eagers: for name in eagers: self._extract_resource(manager, self._eager_to_zip(name)) return self._extract_resource(manager, zip_path) @staticmethod def _get_date_and_size(zip_stat): size = zip_stat.file_size # ymdhms+wday, yday, dst date_time = zip_stat.date_time + (0, 0, -1) # 1980 offset already done timestamp = time.mktime(date_time) return timestamp, size def _extract_resource(self, manager, zip_path): if zip_path in self._index(): for name in self._index()[zip_path]: last = self._extract_resource( manager, os.path.join(zip_path, name) ) # return the extracted directory name return os.path.dirname(last) timestamp, size = self._get_date_and_size(self.zipinfo[zip_path]) if not WRITE_SUPPORT: raise IOError('"os.rename" and "os.unlink" are not supported ' 'on this platform') try: real_path = manager.get_cache_path( self.egg_name, self._parts(zip_path) ) if self._is_current(real_path, zip_path): return real_path outf, tmpnam = _mkstemp(".$extract", dir=os.path.dirname(real_path)) os.write(outf, self.loader.get_data(zip_path)) os.close(outf) utime(tmpnam, (timestamp, timestamp)) manager.postprocess(tmpnam, real_path) try: rename(tmpnam, real_path) except os.error: if os.path.isfile(real_path): if self._is_current(real_path, zip_path): # the file became current since it was checked above, # so proceed. return real_path # Windows, del old file and retry elif os.name=='nt': unlink(real_path) rename(tmpnam, real_path) return real_path raise except os.error: # report a user-friendly error manager.extraction_error() return real_path def _is_current(self, file_path, zip_path): """ Return True if the file_path is current for this zip_path """ timestamp, size = self._get_date_and_size(self.zipinfo[zip_path]) if not os.path.isfile(file_path): return False stat = os.stat(file_path) if stat.st_size!=size or stat.st_mtime!=timestamp: return False # check that the contents match zip_contents = self.loader.get_data(zip_path) with open(file_path, 'rb') as f: file_contents = f.read() return zip_contents == file_contents def _get_eager_resources(self): if self.eagers is None: eagers = [] for name in ('native_libs.txt', 'eager_resources.txt'): if self.has_metadata(name): eagers.extend(self.get_metadata_lines(name)) self.eagers = eagers return self.eagers def _index(self): try: return self._dirindex except AttributeError: ind = {} for path in self.zipinfo: parts = path.split(os.sep) while parts: parent = os.sep.join(parts[:-1]) if parent in ind: ind[parent].append(parts[-1]) break else: ind[parent] = [parts.pop()] self._dirindex = ind return ind def _has(self, fspath): zip_path = self._zipinfo_name(fspath) return zip_path in self.zipinfo or zip_path in self._index() def _isdir(self, fspath): return self._zipinfo_name(fspath) in self._index() def _listdir(self, fspath): return list(self._index().get(self._zipinfo_name(fspath), ())) def _eager_to_zip(self, resource_name): return self._zipinfo_name(self._fn(self.egg_root, resource_name)) def _resource_to_zip(self, resource_name): return self._zipinfo_name(self._fn(self.module_path, resource_name)) register_loader_type(zipimport.zipimporter, ZipProvider) class FileMetadata(EmptyProvider): """Metadata handler for standalone PKG-INFO files Usage:: metadata = FileMetadata("/path/to/PKG-INFO") This provider rejects all data and metadata requests except for PKG-INFO, which is treated as existing, and will be the contents of the file at the provided location. """ def __init__(self, path): self.path = path def has_metadata(self, name): return name=='PKG-INFO' and os.path.isfile(self.path) def get_metadata(self, name): if name=='PKG-INFO': with io.open(self.path, encoding='utf-8') as f: try: metadata = f.read() except UnicodeDecodeError as exc: # add path context to error message tmpl = " in {self.path}" exc.reason += tmpl.format(self=self) raise return metadata raise KeyError("No metadata except PKG-INFO is available") def get_metadata_lines(self, name): return yield_lines(self.get_metadata(name)) class PathMetadata(DefaultProvider): """Metadata provider for egg directories Usage:: # Development eggs: egg_info = "/path/to/PackageName.egg-info" base_dir = os.path.dirname(egg_info) metadata = PathMetadata(base_dir, egg_info) dist_name = os.path.splitext(os.path.basename(egg_info))[0] dist = Distribution(basedir, project_name=dist_name, metadata=metadata) # Unpacked egg directories: egg_path = "/path/to/PackageName-ver-pyver-etc.egg" metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO')) dist = Distribution.from_filename(egg_path, metadata=metadata) """ def __init__(self, path, egg_info): self.module_path = path self.egg_info = egg_info class EggMetadata(ZipProvider): """Metadata provider for .egg files""" def __init__(self, importer): """Create a metadata provider from a zipimporter""" self.zip_pre = importer.archive+os.sep self.loader = importer if importer.prefix: self.module_path = os.path.join(importer.archive, importer.prefix) else: self.module_path = importer.archive self._setup_prefix() _declare_state('dict', _distribution_finders = {}) def register_finder(importer_type, distribution_finder): """Register `distribution_finder` to find distributions in sys.path items `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item handler), and `distribution_finder` is a callable that, passed a path item and the importer instance, yields ``Distribution`` instances found on that path item. See ``pkg_resources.find_on_path`` for an example.""" _distribution_finders[importer_type] = distribution_finder def find_distributions(path_item, only=False): """Yield distributions accessible via `path_item`""" importer = get_importer(path_item) finder = _find_adapter(_distribution_finders, importer) return finder(importer, path_item, only) def find_eggs_in_zip(importer, path_item, only=False): """ Find eggs in zip files; possibly multiple nested eggs. """ if importer.archive.endswith('.whl'): # wheels are not supported with this finder # they don't have PKG-INFO metadata, and won't ever contain eggs return metadata = EggMetadata(importer) if metadata.has_metadata('PKG-INFO'): yield Distribution.from_filename(path_item, metadata=metadata) if only: # don't yield nested distros return for subitem in metadata.resource_listdir('/'): if _is_unpacked_egg(subitem): subpath = os.path.join(path_item, subitem) for dist in find_eggs_in_zip(zipimport.zipimporter(subpath), subpath): yield dist register_finder(zipimport.zipimporter, find_eggs_in_zip) def find_nothing(importer, path_item, only=False): return () register_finder(object, find_nothing) def find_on_path(importer, path_item, only=False): """Yield distributions accessible on a sys.path directory""" path_item = _normalize_cached(path_item) if os.path.isdir(path_item) and os.access(path_item, os.R_OK): if _is_unpacked_egg(path_item): yield Distribution.from_filename( path_item, metadata=PathMetadata( path_item, os.path.join(path_item,'EGG-INFO') ) ) else: # scan for .egg and .egg-info in directory for entry in os.listdir(path_item): lower = entry.lower() if lower.endswith('.egg-info') or lower.endswith('.dist-info'): fullpath = os.path.join(path_item, entry) if os.path.isdir(fullpath): # egg-info directory, allow getting metadata metadata = PathMetadata(path_item, fullpath) else: metadata = FileMetadata(fullpath) yield Distribution.from_location( path_item, entry, metadata, precedence=DEVELOP_DIST ) elif not only and _is_unpacked_egg(entry): dists = find_distributions(os.path.join(path_item, entry)) for dist in dists: yield dist elif not only and lower.endswith('.egg-link'): with open(os.path.join(path_item, entry)) as entry_file: entry_lines = entry_file.readlines() for line in entry_lines: if not line.strip(): continue path = os.path.join(path_item, line.rstrip()) dists = find_distributions(path) for item in dists: yield item break register_finder(pkgutil.ImpImporter, find_on_path) if hasattr(importlib_machinery, 'FileFinder'): register_finder(importlib_machinery.FileFinder, find_on_path) _declare_state('dict', _namespace_handlers={}) _declare_state('dict', _namespace_packages={}) def register_namespace_handler(importer_type, namespace_handler): """Register `namespace_handler` to declare namespace packages `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item handler), and `namespace_handler` is a callable like this:: def namespace_handler(importer, path_entry, moduleName, module): # return a path_entry to use for child packages Namespace handlers are only called if the importer object has already agreed that it can handle the relevant path item, and they should only return a subpath if the module __path__ does not already contain an equivalent subpath. For an example namespace handler, see ``pkg_resources.file_ns_handler``. """ _namespace_handlers[importer_type] = namespace_handler def _handle_ns(packageName, path_item): """Ensure that named package includes a subpath of path_item (if needed)""" importer = get_importer(path_item) if importer is None: return None loader = importer.find_module(packageName) if loader is None: return None module = sys.modules.get(packageName) if module is None: module = sys.modules[packageName] = types.ModuleType(packageName) module.__path__ = [] _set_parent_ns(packageName) elif not hasattr(module,'__path__'): raise TypeError("Not a package:", packageName) handler = _find_adapter(_namespace_handlers, importer) subpath = handler(importer, path_item, packageName, module) if subpath is not None: path = module.__path__ path.append(subpath) loader.load_module(packageName) _rebuild_mod_path(path, packageName, module) return subpath def _rebuild_mod_path(orig_path, package_name, module): """ Rebuild module.__path__ ensuring that all entries are ordered corresponding to their sys.path order """ sys_path = [_normalize_cached(p) for p in sys.path] def position_in_sys_path(path): """ Return the ordinal of the path based on its position in sys.path """ path_parts = path.split(os.sep) module_parts = package_name.count('.') + 1 parts = path_parts[:-module_parts] return sys_path.index(_normalize_cached(os.sep.join(parts))) orig_path.sort(key=position_in_sys_path) module.__path__[:] = [_normalize_cached(p) for p in orig_path] def declare_namespace(packageName): """Declare that package 'packageName' is a namespace package""" _imp.acquire_lock() try: if packageName in _namespace_packages: return path, parent = sys.path, None if '.' in packageName: parent = '.'.join(packageName.split('.')[:-1]) declare_namespace(parent) if parent not in _namespace_packages: __import__(parent) try: path = sys.modules[parent].__path__ except AttributeError: raise TypeError("Not a package:", parent) # Track what packages are namespaces, so when new path items are added, # they can be updated _namespace_packages.setdefault(parent,[]).append(packageName) _namespace_packages.setdefault(packageName,[]) for path_item in path: # Ensure all the parent's path items are reflected in the child, # if they apply _handle_ns(packageName, path_item) finally: _imp.release_lock() def fixup_namespace_packages(path_item, parent=None): """Ensure that previously-declared namespace packages include path_item""" _imp.acquire_lock() try: for package in _namespace_packages.get(parent,()): subpath = _handle_ns(package, path_item) if subpath: fixup_namespace_packages(subpath, package) finally: _imp.release_lock() def file_ns_handler(importer, path_item, packageName, module): """Compute an ns-package subpath for a filesystem or zipfile importer""" subpath = os.path.join(path_item, packageName.split('.')[-1]) normalized = _normalize_cached(subpath) for item in module.__path__: if _normalize_cached(item)==normalized: break else: # Only return the path if it's not already there return subpath register_namespace_handler(pkgutil.ImpImporter, file_ns_handler) register_namespace_handler(zipimport.zipimporter, file_ns_handler) if hasattr(importlib_machinery, 'FileFinder'): register_namespace_handler(importlib_machinery.FileFinder, file_ns_handler) def null_ns_handler(importer, path_item, packageName, module): return None register_namespace_handler(object, null_ns_handler) def normalize_path(filename): """Normalize a file/dir name for comparison purposes""" return os.path.normcase(os.path.realpath(filename)) def _normalize_cached(filename, _cache={}): try: return _cache[filename] except KeyError: _cache[filename] = result = normalize_path(filename) return result def _is_unpacked_egg(path): """ Determine if given path appears to be an unpacked egg. """ return ( path.lower().endswith('.egg') ) def _set_parent_ns(packageName): parts = packageName.split('.') name = parts.pop() if parts: parent = '.'.join(parts) setattr(sys.modules[parent], name, sys.modules[packageName]) def yield_lines(strs): """Yield non-empty/non-comment lines of a string or sequence""" if isinstance(strs, six.string_types): for s in strs.splitlines(): s = s.strip() # skip blank lines/comments if s and not s.startswith('#'): yield s else: for ss in strs: for s in yield_lines(ss): yield s MODULE = re.compile(r"\w+(\.\w+)*$").match EGG_NAME = re.compile( r""" (?P[^-]+) ( -(?P[^-]+) ( -py(?P[^-]+) ( -(?P.+) )? )? )? """, re.VERBOSE | re.IGNORECASE, ).match class EntryPoint(object): """Object representing an advertised importable object""" def __init__(self, name, module_name, attrs=(), extras=(), dist=None): if not MODULE(module_name): raise ValueError("Invalid module name", module_name) self.name = name self.module_name = module_name self.attrs = tuple(attrs) self.extras = Requirement.parse(("x[%s]" % ','.join(extras))).extras self.dist = dist def __str__(self): s = "%s = %s" % (self.name, self.module_name) if self.attrs: s += ':' + '.'.join(self.attrs) if self.extras: s += ' [%s]' % ','.join(self.extras) return s def __repr__(self): return "EntryPoint.parse(%r)" % str(self) def load(self, require=True, *args, **kwargs): """ Require packages for this EntryPoint, then resolve it. """ if not require or args or kwargs: warnings.warn( "Parameters to load are deprecated. Call .resolve and " ".require separately.", DeprecationWarning, stacklevel=2, ) if require: self.require(*args, **kwargs) return self.resolve() def resolve(self): """ Resolve the entry point from its module and attrs. """ module = __import__(self.module_name, fromlist=['__name__'], level=0) try: return functools.reduce(getattr, self.attrs, module) except AttributeError as exc: raise ImportError(str(exc)) def require(self, env=None, installer=None): if self.extras and not self.dist: raise UnknownExtra("Can't require() without a distribution", self) reqs = self.dist.requires(self.extras) items = working_set.resolve(reqs, env, installer) list(map(working_set.add, items)) pattern = re.compile( r'\s*' r'(?P.+?)\s*' r'=\s*' r'(?P[\w.]+)\s*' r'(:\s*(?P[\w.]+))?\s*' r'(?P\[.*\])?\s*$' ) @classmethod def parse(cls, src, dist=None): """Parse a single entry point from string `src` Entry point syntax follows the form:: name = some.module:some.attr [extra1, extra2] The entry name and module name are required, but the ``:attrs`` and ``[extras]`` parts are optional """ m = cls.pattern.match(src) if not m: msg = "EntryPoint must be in 'name=module:attrs [extras]' format" raise ValueError(msg, src) res = m.groupdict() extras = cls._parse_extras(res['extras']) attrs = res['attr'].split('.') if res['attr'] else () return cls(res['name'], res['module'], attrs, extras, dist) @classmethod def _parse_extras(cls, extras_spec): if not extras_spec: return () req = Requirement.parse('x' + extras_spec) if req.specs: raise ValueError() return req.extras @classmethod def parse_group(cls, group, lines, dist=None): """Parse an entry point group""" if not MODULE(group): raise ValueError("Invalid group name", group) this = {} for line in yield_lines(lines): ep = cls.parse(line, dist) if ep.name in this: raise ValueError("Duplicate entry point", group, ep.name) this[ep.name]=ep return this @classmethod def parse_map(cls, data, dist=None): """Parse a map of entry point groups""" if isinstance(data, dict): data = data.items() else: data = split_sections(data) maps = {} for group, lines in data: if group is None: if not lines: continue raise ValueError("Entry points must be listed in groups") group = group.strip() if group in maps: raise ValueError("Duplicate group name", group) maps[group] = cls.parse_group(group, lines, dist) return maps def _remove_md5_fragment(location): if not location: return '' parsed = urllib.parse.urlparse(location) if parsed[-1].startswith('md5='): return urllib.parse.urlunparse(parsed[:-1] + ('',)) return location def _version_from_file(lines): """ Given an iterable of lines from a Metadata file, return the value of the Version field, if present, or None otherwise. """ is_version_line = lambda line: line.lower().startswith('version:') version_lines = filter(is_version_line, lines) line = next(iter(version_lines), '') _, _, value = line.partition(':') return safe_version(value.strip()) or None class Distribution(object): """Wrap an actual or potential sys.path entry w/metadata""" PKG_INFO = 'PKG-INFO' def __init__(self, location=None, metadata=None, project_name=None, version=None, py_version=PY_MAJOR, platform=None, precedence=EGG_DIST): self.project_name = safe_name(project_name or 'Unknown') if version is not None: self._version = safe_version(version) self.py_version = py_version self.platform = platform self.location = location self.precedence = precedence self._provider = metadata or empty_provider @classmethod def from_location(cls, location, basename, metadata=None, **kw): project_name, version, py_version, platform = [None]*4 basename, ext = os.path.splitext(basename) if ext.lower() in _distributionImpl: cls = _distributionImpl[ext.lower()] match = EGG_NAME(basename) if match: project_name, version, py_version, platform = match.group( 'name', 'ver', 'pyver', 'plat' ) return cls( location, metadata, project_name=project_name, version=version, py_version=py_version, platform=platform, **kw )._reload_version() def _reload_version(self): return self @property def hashcmp(self): return ( self.parsed_version, self.precedence, self.key, _remove_md5_fragment(self.location), self.py_version or '', self.platform or '', ) def __hash__(self): return hash(self.hashcmp) def __lt__(self, other): return self.hashcmp < other.hashcmp def __le__(self, other): return self.hashcmp <= other.hashcmp def __gt__(self, other): return self.hashcmp > other.hashcmp def __ge__(self, other): return self.hashcmp >= other.hashcmp def __eq__(self, other): if not isinstance(other, self.__class__): # It's not a Distribution, so they are not equal return False return self.hashcmp == other.hashcmp def __ne__(self, other): return not self == other # These properties have to be lazy so that we don't have to load any # metadata until/unless it's actually needed. (i.e., some distributions # may not know their name or version without loading PKG-INFO) @property def key(self): try: return self._key except AttributeError: self._key = key = self.project_name.lower() return key @property def parsed_version(self): if not hasattr(self, "_parsed_version"): self._parsed_version = parse_version(self.version) return self._parsed_version def _warn_legacy_version(self): LV = packaging.version.LegacyVersion is_legacy = isinstance(self._parsed_version, LV) if not is_legacy: return # While an empty version is technically a legacy version and # is not a valid PEP 440 version, it's also unlikely to # actually come from someone and instead it is more likely that # it comes from setuptools attempting to parse a filename and # including it in the list. So for that we'll gate this warning # on if the version is anything at all or not. if not self.version: return tmpl = textwrap.dedent(""" '{project_name} ({version})' is being parsed as a legacy, non PEP 440, version. You may find odd behavior and sort order. In particular it will be sorted as less than 0.0. It is recommended to migrate to PEP 440 compatible versions. """).strip().replace('\n', ' ') warnings.warn(tmpl.format(**vars(self)), PEP440Warning) @property def version(self): try: return self._version except AttributeError: version = _version_from_file(self._get_metadata(self.PKG_INFO)) if version is None: tmpl = "Missing 'Version:' header and/or %s file" raise ValueError(tmpl % self.PKG_INFO, self) return version @property def _dep_map(self): try: return self.__dep_map except AttributeError: dm = self.__dep_map = {None: []} for name in 'requires.txt', 'depends.txt': for extra, reqs in split_sections(self._get_metadata(name)): if extra: if ':' in extra: extra, marker = extra.split(':', 1) if invalid_marker(marker): # XXX warn reqs=[] elif not evaluate_marker(marker): reqs=[] extra = safe_extra(extra) or None dm.setdefault(extra,[]).extend(parse_requirements(reqs)) return dm def requires(self, extras=()): """List of Requirements needed for this distro if `extras` are used""" dm = self._dep_map deps = [] deps.extend(dm.get(None, ())) for ext in extras: try: deps.extend(dm[safe_extra(ext)]) except KeyError: raise UnknownExtra( "%s has no such extra feature %r" % (self, ext) ) return deps def _get_metadata(self, name): if self.has_metadata(name): for line in self.get_metadata_lines(name): yield line def activate(self, path=None): """Ensure distribution is importable on `path` (default=sys.path)""" if path is None: path = sys.path self.insert_on(path, replace=True) if path is sys.path: fixup_namespace_packages(self.location) for pkg in self._get_metadata('namespace_packages.txt'): if pkg in sys.modules: declare_namespace(pkg) def egg_name(self): """Return what this distribution's standard .egg filename should be""" filename = "%s-%s-py%s" % ( to_filename(self.project_name), to_filename(self.version), self.py_version or PY_MAJOR ) if self.platform: filename += '-' + self.platform return filename def __repr__(self): if self.location: return "%s (%s)" % (self, self.location) else: return str(self) def __str__(self): try: version = getattr(self, 'version', None) except ValueError: version = None version = version or "[unknown version]" return "%s %s" % (self.project_name, version) def __getattr__(self, attr): """Delegate all unrecognized public attributes to .metadata provider""" if attr.startswith('_'): raise AttributeError(attr) return getattr(self._provider, attr) @classmethod def from_filename(cls, filename, metadata=None, **kw): return cls.from_location( _normalize_cached(filename), os.path.basename(filename), metadata, **kw ) def as_requirement(self): """Return a ``Requirement`` that matches this distribution exactly""" if isinstance(self.parsed_version, packaging.version.Version): spec = "%s==%s" % (self.project_name, self.parsed_version) else: spec = "%s===%s" % (self.project_name, self.parsed_version) return Requirement.parse(spec) def load_entry_point(self, group, name): """Return the `name` entry point of `group` or raise ImportError""" ep = self.get_entry_info(group, name) if ep is None: raise ImportError("Entry point %r not found" % ((group, name),)) return ep.load() def get_entry_map(self, group=None): """Return the entry point map for `group`, or the full entry map""" try: ep_map = self._ep_map except AttributeError: ep_map = self._ep_map = EntryPoint.parse_map( self._get_metadata('entry_points.txt'), self ) if group is not None: return ep_map.get(group,{}) return ep_map def get_entry_info(self, group, name): """Return the EntryPoint object for `group`+`name`, or ``None``""" return self.get_entry_map(group).get(name) def insert_on(self, path, loc=None, replace=False): """Insert self.location in path before its nearest parent directory""" loc = loc or self.location if not loc: return nloc = _normalize_cached(loc) bdir = os.path.dirname(nloc) npath= [(p and _normalize_cached(p) or p) for p in path] for p, item in enumerate(npath): if item == nloc: break elif item == bdir and self.precedence == EGG_DIST: # if it's an .egg, give it precedence over its directory if path is sys.path: self.check_version_conflict() path.insert(p, loc) npath.insert(p, nloc) break else: if path is sys.path: self.check_version_conflict() if replace: path.insert(0, loc) else: path.append(loc) return # p is the spot where we found or inserted loc; now remove duplicates while True: try: np = npath.index(nloc, p+1) except ValueError: break else: del npath[np], path[np] # ha! p = np return def check_version_conflict(self): if self.key == 'setuptools': # ignore the inevitable setuptools self-conflicts :( return nsp = dict.fromkeys(self._get_metadata('namespace_packages.txt')) loc = normalize_path(self.location) for modname in self._get_metadata('top_level.txt'): if (modname not in sys.modules or modname in nsp or modname in _namespace_packages): continue if modname in ('pkg_resources', 'setuptools', 'site'): continue fn = getattr(sys.modules[modname], '__file__', None) if fn and (normalize_path(fn).startswith(loc) or fn.startswith(self.location)): continue issue_warning( "Module %s was already imported from %s, but %s is being added" " to sys.path" % (modname, fn, self.location), ) def has_version(self): try: self.version except ValueError: issue_warning("Unbuilt egg for " + repr(self)) return False return True def clone(self,**kw): """Copy this distribution, substituting in any changed keyword args""" names = 'project_name version py_version platform location precedence' for attr in names.split(): kw.setdefault(attr, getattr(self, attr, None)) kw.setdefault('metadata', self._provider) return self.__class__(**kw) @property def extras(self): return [dep for dep in self._dep_map if dep] class EggInfoDistribution(Distribution): def _reload_version(self): """ Packages installed by distutils (e.g. numpy or scipy), which uses an old safe_version, and so their version numbers can get mangled when converted to filenames (e.g., 1.11.0.dev0+2329eae to 1.11.0.dev0_2329eae). These distributions will not be parsed properly downstream by Distribution and safe_version, so take an extra step and try to get the version number from the metadata file itself instead of the filename. """ md_version = _version_from_file(self._get_metadata(self.PKG_INFO)) if md_version: self._version = md_version return self class DistInfoDistribution(Distribution): """Wrap an actual or potential sys.path entry w/metadata, .dist-info style""" PKG_INFO = 'METADATA' EQEQ = re.compile(r"([\(,])\s*(\d.*?)\s*([,\)])") @property def _parsed_pkg_info(self): """Parse and cache metadata""" try: return self._pkg_info except AttributeError: metadata = self.get_metadata(self.PKG_INFO) self._pkg_info = email.parser.Parser().parsestr(metadata) return self._pkg_info @property def _dep_map(self): try: return self.__dep_map except AttributeError: self.__dep_map = self._compute_dependencies() return self.__dep_map def _compute_dependencies(self): """Recompute this distribution's dependencies.""" dm = self.__dep_map = {None: []} reqs = [] # Including any condition expressions for req in self._parsed_pkg_info.get_all('Requires-Dist') or []: reqs.extend(parse_requirements(req)) def reqs_for_extra(extra): for req in reqs: if not req.marker or req.marker.evaluate({'extra': extra}): yield req common = frozenset(reqs_for_extra(None)) dm[None].extend(common) for extra in self._parsed_pkg_info.get_all('Provides-Extra') or []: extra = safe_extra(extra.strip()) dm[extra] = list(frozenset(reqs_for_extra(extra)) - common) return dm _distributionImpl = { '.egg': Distribution, '.egg-info': EggInfoDistribution, '.dist-info': DistInfoDistribution, } def issue_warning(*args,**kw): level = 1 g = globals() try: # find the first stack frame that is *not* code in # the pkg_resources module, to use for the warning while sys._getframe(level).f_globals is g: level += 1 except ValueError: pass warnings.warn(stacklevel=level + 1, *args, **kw) class RequirementParseError(ValueError): def __str__(self): return ' '.join(self.args) def parse_requirements(strs): """Yield ``Requirement`` objects for each specification in `strs` `strs` must be a string, or a (possibly-nested) iterable thereof. """ # create a steppable iterator, so we can handle \-continuations lines = iter(yield_lines(strs)) for line in lines: # Drop comments -- a hash without a space may be in a URL. if ' #' in line: line = line[:line.find(' #')] # If there is a line continuation, drop it, and append the next line. if line.endswith('\\'): line = line[:-2].strip() line += next(lines) yield Requirement(line) class Requirement(packaging.requirements.Requirement): def __init__(self, requirement_string): """DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!""" try: super(Requirement, self).__init__(requirement_string) except packaging.requirements.InvalidRequirement as e: raise RequirementParseError(str(e)) self.unsafe_name = self.name project_name = safe_name(self.name) self.project_name, self.key = project_name, project_name.lower() self.specs = [ (spec.operator, spec.version) for spec in self.specifier] self.extras = tuple(map(safe_extra, self.extras)) self.hashCmp = ( self.key, self.specifier, frozenset(self.extras), str(self.marker) if self.marker else None, ) self.__hash = hash(self.hashCmp) def __eq__(self, other): return ( isinstance(other, Requirement) and self.hashCmp == other.hashCmp ) def __ne__(self, other): return not self == other def __contains__(self, item): if isinstance(item, Distribution): if item.key != self.key: return False item = item.version # Allow prereleases always in order to match the previous behavior of # this method. In the future this should be smarter and follow PEP 440 # more accurately. return self.specifier.contains(item, prereleases=True) def __hash__(self): return self.__hash def __repr__(self): return "Requirement.parse(%r)" % str(self) @staticmethod def parse(s): req, = parse_requirements(s) return req def _get_mro(cls): """Get an mro for a type or classic class""" if not isinstance(cls, type): class cls(cls, object): pass return cls.__mro__[1:] return cls.__mro__ def _find_adapter(registry, ob): """Return an adapter factory for `ob` from `registry`""" for t in _get_mro(getattr(ob, '__class__', type(ob))): if t in registry: return registry[t] def ensure_directory(path): """Ensure that the parent directory of `path` exists""" dirname = os.path.dirname(path) if not os.path.isdir(dirname): os.makedirs(dirname) def _bypass_ensure_directory(path): """Sandbox-bypassing version of ensure_directory()""" if not WRITE_SUPPORT: raise IOError('"os.mkdir" not supported on this platform.') dirname, filename = split(path) if dirname and filename and not isdir(dirname): _bypass_ensure_directory(dirname) mkdir(dirname, 0o755) def split_sections(s): """Split a string or iterable thereof into (section, content) pairs Each ``section`` is a stripped version of the section header ("[section]") and each ``content`` is a list of stripped lines excluding blank lines and comment-only lines. If there are any such lines before the first section header, they're returned in a first ``section`` of ``None``. """ section = None content = [] for line in yield_lines(s): if line.startswith("["): if line.endswith("]"): if section or content: yield section, content section = line[1:-1].strip() content = [] else: raise ValueError("Invalid section heading", line) else: content.append(line) # wrap up last segment yield section, content def _mkstemp(*args,**kw): old_open = os.open try: # temporarily bypass sandboxing os.open = os_open return tempfile.mkstemp(*args,**kw) finally: # and then put it back os.open = old_open # Silence the PEP440Warning by default, so that end users don't get hit by it # randomly just because they use pkg_resources. We want to append the rule # because we want earlier uses of filterwarnings to take precedence over this # one. warnings.filterwarnings("ignore", category=PEP440Warning, append=True) # from jaraco.functools 1.3 def _call_aside(f, *args, **kwargs): f(*args, **kwargs) return f @_call_aside def _initialize(g=globals()): "Set up global resource manager (deliberately not state-saved)" manager = ResourceManager() g['_manager'] = manager for name in dir(manager): if not name.startswith('_'): g[name] = getattr(manager, name) @_call_aside def _initialize_master_working_set(): """ Prepare the master working set and make the ``require()`` API available. This function has explicit effects on the global state of pkg_resources. It is intended to be invoked once at the initialization of this module. Invocation by other packages is unsupported and done at their own risk. """ working_set = WorkingSet._build_master() _declare_state('object', working_set=working_set) require = working_set.require iter_entry_points = working_set.iter_entry_points add_activation_listener = working_set.subscribe run_script = working_set.run_script # backward compatibility run_main = run_script # Activate all distributions already on sys.path, and ensure that # all distributions added to the working set in the future (e.g. by # calling ``require()``) will get activated as well. add_activation_listener(lambda dist: dist.activate()) working_set.entries=[] # match order list(map(working_set.add_entry, sys.path)) globals().update(locals()) setuptools-20.7.0/pkg_resources/api_tests.txt0000664000175000017500000002766312702524020022304 0ustar travistravis00000000000000Pluggable Distributions of Python Software ========================================== Distributions ------------- A "Distribution" is a collection of files that represent a "Release" of a "Project" as of a particular point in time, denoted by a "Version":: >>> import sys, pkg_resources >>> from pkg_resources import Distribution >>> Distribution(project_name="Foo", version="1.2") Foo 1.2 Distributions have a location, which can be a filename, URL, or really anything else you care to use:: >>> dist = Distribution( ... location="http://example.com/something", ... project_name="Bar", version="0.9" ... ) >>> dist Bar 0.9 (http://example.com/something) Distributions have various introspectable attributes:: >>> dist.location 'http://example.com/something' >>> dist.project_name 'Bar' >>> dist.version '0.9' >>> dist.py_version == sys.version[:3] True >>> print(dist.platform) None Including various computed attributes:: >>> from pkg_resources import parse_version >>> dist.parsed_version == parse_version(dist.version) True >>> dist.key # case-insensitive form of the project name 'bar' Distributions are compared (and hashed) by version first:: >>> Distribution(version='1.0') == Distribution(version='1.0') True >>> Distribution(version='1.0') == Distribution(version='1.1') False >>> Distribution(version='1.0') < Distribution(version='1.1') True but also by project name (case-insensitive), platform, Python version, location, etc.:: >>> Distribution(project_name="Foo",version="1.0") == \ ... Distribution(project_name="Foo",version="1.0") True >>> Distribution(project_name="Foo",version="1.0") == \ ... Distribution(project_name="foo",version="1.0") True >>> Distribution(project_name="Foo",version="1.0") == \ ... Distribution(project_name="Foo",version="1.1") False >>> Distribution(project_name="Foo",py_version="2.3",version="1.0") == \ ... Distribution(project_name="Foo",py_version="2.4",version="1.0") False >>> Distribution(location="spam",version="1.0") == \ ... Distribution(location="spam",version="1.0") True >>> Distribution(location="spam",version="1.0") == \ ... Distribution(location="baz",version="1.0") False Hash and compare distribution by prio/plat Get version from metadata provider capabilities egg_name() as_requirement() from_location, from_filename (w/path normalization) Releases may have zero or more "Requirements", which indicate what releases of another project the release requires in order to function. A Requirement names the other project, expresses some criteria as to what releases of that project are acceptable, and lists any "Extras" that the requiring release may need from that project. (An Extra is an optional feature of a Release, that can only be used if its additional Requirements are satisfied.) The Working Set --------------- A collection of active distributions is called a Working Set. Note that a Working Set can contain any importable distribution, not just pluggable ones. For example, the Python standard library is an importable distribution that will usually be part of the Working Set, even though it is not pluggable. Similarly, when you are doing development work on a project, the files you are editing are also a Distribution. (And, with a little attention to the directory names used, and including some additional metadata, such a "development distribution" can be made pluggable as well.) >>> from pkg_resources import WorkingSet A working set's entries are the sys.path entries that correspond to the active distributions. By default, the working set's entries are the items on ``sys.path``:: >>> ws = WorkingSet() >>> ws.entries == sys.path True But you can also create an empty working set explicitly, and add distributions to it:: >>> ws = WorkingSet([]) >>> ws.add(dist) >>> ws.entries ['http://example.com/something'] >>> dist in ws True >>> Distribution('foo',version="") in ws False And you can iterate over its distributions:: >>> list(ws) [Bar 0.9 (http://example.com/something)] Adding the same distribution more than once is a no-op:: >>> ws.add(dist) >>> list(ws) [Bar 0.9 (http://example.com/something)] For that matter, adding multiple distributions for the same project also does nothing, because a working set can only hold one active distribution per project -- the first one added to it:: >>> ws.add( ... Distribution( ... 'http://example.com/something', project_name="Bar", ... version="7.2" ... ) ... ) >>> list(ws) [Bar 0.9 (http://example.com/something)] You can append a path entry to a working set using ``add_entry()``:: >>> ws.entries ['http://example.com/something'] >>> ws.add_entry(pkg_resources.__file__) >>> ws.entries ['http://example.com/something', '...pkg_resources...'] Multiple additions result in multiple entries, even if the entry is already in the working set (because ``sys.path`` can contain the same entry more than once):: >>> ws.add_entry(pkg_resources.__file__) >>> ws.entries ['...example.com...', '...pkg_resources...', '...pkg_resources...'] And you can specify the path entry a distribution was found under, using the optional second parameter to ``add()``:: >>> ws = WorkingSet([]) >>> ws.add(dist,"foo") >>> ws.entries ['foo'] But even if a distribution is found under multiple path entries, it still only shows up once when iterating the working set: >>> ws.add_entry(ws.entries[0]) >>> list(ws) [Bar 0.9 (http://example.com/something)] You can ask a WorkingSet to ``find()`` a distribution matching a requirement:: >>> from pkg_resources import Requirement >>> print(ws.find(Requirement.parse("Foo==1.0"))) # no match, return None None >>> ws.find(Requirement.parse("Bar==0.9")) # match, return distribution Bar 0.9 (http://example.com/something) Note that asking for a conflicting version of a distribution already in a working set triggers a ``pkg_resources.VersionConflict`` error: >>> try: ... ws.find(Requirement.parse("Bar==1.0")) ... except pkg_resources.VersionConflict as exc: ... print(str(exc)) ... else: ... raise AssertionError("VersionConflict was not raised") (Bar 0.9 (http://example.com/something), Requirement.parse('Bar==1.0')) You can subscribe a callback function to receive notifications whenever a new distribution is added to a working set. The callback is immediately invoked once for each existing distribution in the working set, and then is called again for new distributions added thereafter:: >>> def added(dist): print("Added %s" % dist) >>> ws.subscribe(added) Added Bar 0.9 >>> foo12 = Distribution(project_name="Foo", version="1.2", location="f12") >>> ws.add(foo12) Added Foo 1.2 Note, however, that only the first distribution added for a given project name will trigger a callback, even during the initial ``subscribe()`` callback:: >>> foo14 = Distribution(project_name="Foo", version="1.4", location="f14") >>> ws.add(foo14) # no callback, because Foo 1.2 is already active >>> ws = WorkingSet([]) >>> ws.add(foo12) >>> ws.add(foo14) >>> ws.subscribe(added) Added Foo 1.2 And adding a callback more than once has no effect, either:: >>> ws.subscribe(added) # no callbacks # and no double-callbacks on subsequent additions, either >>> just_a_test = Distribution(project_name="JustATest", version="0.99") >>> ws.add(just_a_test) Added JustATest 0.99 Finding Plugins --------------- ``WorkingSet`` objects can be used to figure out what plugins in an ``Environment`` can be loaded without any resolution errors:: >>> from pkg_resources import Environment >>> plugins = Environment([]) # normally, a list of plugin directories >>> plugins.add(foo12) >>> plugins.add(foo14) >>> plugins.add(just_a_test) In the simplest case, we just get the newest version of each distribution in the plugin environment:: >>> ws = WorkingSet([]) >>> ws.find_plugins(plugins) ([JustATest 0.99, Foo 1.4 (f14)], {}) But if there's a problem with a version conflict or missing requirements, the method falls back to older versions, and the error info dict will contain an exception instance for each unloadable plugin:: >>> ws.add(foo12) # this will conflict with Foo 1.4 >>> ws.find_plugins(plugins) ([JustATest 0.99, Foo 1.2 (f12)], {Foo 1.4 (f14): VersionConflict(...)}) But if you disallow fallbacks, the failed plugin will be skipped instead of trying older versions:: >>> ws.find_plugins(plugins, fallback=False) ([JustATest 0.99], {Foo 1.4 (f14): VersionConflict(...)}) Platform Compatibility Rules ---------------------------- On the Mac, there are potential compatibility issues for modules compiled on newer versions of Mac OS X than what the user is running. Additionally, Mac OS X will soon have two platforms to contend with: Intel and PowerPC. Basic equality works as on other platforms:: >>> from pkg_resources import compatible_platforms as cp >>> reqd = 'macosx-10.4-ppc' >>> cp(reqd, reqd) True >>> cp("win32", reqd) False Distributions made on other machine types are not compatible:: >>> cp("macosx-10.4-i386", reqd) False Distributions made on earlier versions of the OS are compatible, as long as they are from the same top-level version. The patchlevel version number does not matter:: >>> cp("macosx-10.4-ppc", reqd) True >>> cp("macosx-10.3-ppc", reqd) True >>> cp("macosx-10.5-ppc", reqd) False >>> cp("macosx-9.5-ppc", reqd) False Backwards compatibility for packages made via earlier versions of setuptools is provided as well:: >>> cp("darwin-8.2.0-Power_Macintosh", reqd) True >>> cp("darwin-7.2.0-Power_Macintosh", reqd) True >>> cp("darwin-8.2.0-Power_Macintosh", "macosx-10.3-ppc") False Environment Markers ------------------- >>> from pkg_resources import invalid_marker as im, evaluate_marker as em >>> import os >>> print(im("sys_platform")) Invalid marker: 'sys_platform', parse error at '' >>> print(im("sys_platform==")) Invalid marker: 'sys_platform==', parse error at '' >>> print(im("sys_platform=='win32'")) False >>> print(im("sys=='x'")) Invalid marker: "sys=='x'", parse error at "sys=='x'" >>> print(im("(extra)")) Invalid marker: '(extra)', parse error at ')' >>> print(im("(extra")) Invalid marker: '(extra', parse error at '' >>> print(im("os.open('foo')=='y'")) Invalid marker: "os.open('foo')=='y'", parse error at 'os.open(' >>> print(im("'x'=='y' and os.open('foo')=='y'")) # no short-circuit! Invalid marker: "'x'=='y' and os.open('foo')=='y'", parse error at 'and os.o' >>> print(im("'x'=='x' or os.open('foo')=='y'")) # no short-circuit! Invalid marker: "'x'=='x' or os.open('foo')=='y'", parse error at 'or os.op' >>> print(im("'x' < 'y' < 'z'")) Invalid marker: "'x' < 'y' < 'z'", parse error at "< 'z'" >>> print(im("r'x'=='x'")) Invalid marker: "r'x'=='x'", parse error at "r'x'=='x" >>> print(im("'''x'''=='x'")) Invalid marker: "'''x'''=='x'", parse error at "'x'''=='" >>> print(im('"""x"""=="x"')) Invalid marker: '"""x"""=="x"', parse error at '"x"""=="' >>> print(im(r"x\n=='x'")) Invalid marker: "x\\n=='x'", parse error at "x\\n=='x'" >>> print(im("os.open=='y'")) Invalid marker: "os.open=='y'", parse error at 'os.open=' >>> em("sys_platform=='win32'") == (sys.platform=='win32') True >>> em("python_version >= '2.6'") True >>> em("python_version > '2.5'") True >>> im("implementation_name=='cpython'") False >>> im("platform_python_implementation=='CPython'") False >>> im("implementation_version=='3.5.1'") False setuptools-20.7.0/setuptools/0000775000175000017500000000000012702524134017106 5ustar travistravis00000000000000setuptools-20.7.0/setuptools/command/0000775000175000017500000000000012702524134020524 5ustar travistravis00000000000000setuptools-20.7.0/setuptools/command/__init__.py0000664000175000017500000000106412702524020022630 0ustar travistravis00000000000000__all__ = [ 'alias', 'bdist_egg', 'bdist_rpm', 'build_ext', 'build_py', 'develop', 'easy_install', 'egg_info', 'install', 'install_lib', 'rotate', 'saveopts', 'sdist', 'setopt', 'test', 'install_egg_info', 'install_scripts', 'register', 'bdist_wininst', 'upload_docs', 'upload', ] from distutils.command.bdist import bdist import sys from setuptools.command import install_scripts if 'egg' not in bdist.format_commands: bdist.format_command['egg'] = ('bdist_egg', "Python .egg file") bdist.format_commands.append('egg') del bdist, sys setuptools-20.7.0/setuptools/command/alias.py0000775000175000017500000000457212702524020022174 0ustar travistravis00000000000000from distutils.errors import DistutilsOptionError from setuptools.extern.six.moves import map from setuptools.command.setopt import edit_config, option_base, config_file def shquote(arg): """Quote an argument for later parsing by shlex.split()""" for c in '"', "'", "\\", "#": if c in arg: return repr(arg) if arg.split() != [arg]: return repr(arg) return arg class alias(option_base): """Define a shortcut that invokes one or more commands""" description = "define a shortcut to invoke one or more commands" command_consumes_arguments = True user_options = [ ('remove', 'r', 'remove (unset) the alias'), ] + option_base.user_options boolean_options = option_base.boolean_options + ['remove'] def initialize_options(self): option_base.initialize_options(self) self.args = None self.remove = None def finalize_options(self): option_base.finalize_options(self) if self.remove and len(self.args) != 1: raise DistutilsOptionError( "Must specify exactly one argument (the alias name) when " "using --remove" ) def run(self): aliases = self.distribution.get_option_dict('aliases') if not self.args: print("Command Aliases") print("---------------") for alias in aliases: print("setup.py alias", format_alias(alias, aliases)) return elif len(self.args) == 1: alias, = self.args if self.remove: command = None elif alias in aliases: print("setup.py alias", format_alias(alias, aliases)) return else: print("No alias definition found for %r" % alias) return else: alias = self.args[0] command = ' '.join(map(shquote, self.args[1:])) edit_config(self.filename, {'aliases': {alias: command}}, self.dry_run) def format_alias(name, aliases): source, command = aliases[name] if source == config_file('global'): source = '--global-config ' elif source == config_file('user'): source = '--user-config ' elif source == config_file('local'): source = '' else: source = '--filename=%r' % source return source + name + ' ' + command setuptools-20.7.0/setuptools/command/bdist_egg.py0000664000175000017500000004144012702524020023022 0ustar travistravis00000000000000"""setuptools.command.bdist_egg Build .egg distributions""" from distutils.errors import DistutilsSetupError from distutils.dir_util import remove_tree, mkpath from distutils import log from types import CodeType import sys import os import marshal import textwrap from setuptools.extern import six from pkg_resources import get_build_platform, Distribution, ensure_directory from pkg_resources import EntryPoint from setuptools.extension import Library from setuptools import Command try: # Python 2.7 or >=3.2 from sysconfig import get_path, get_python_version def _get_purelib(): return get_path("purelib") except ImportError: from distutils.sysconfig import get_python_lib, get_python_version def _get_purelib(): return get_python_lib(False) def strip_module(filename): if '.' in filename: filename = os.path.splitext(filename)[0] if filename.endswith('module'): filename = filename[:-6] return filename def write_stub(resource, pyfile): _stub_template = textwrap.dedent(""" def __bootstrap__(): global __bootstrap__, __loader__, __file__ import sys, pkg_resources, imp __file__ = pkg_resources.resource_filename(__name__, %r) __loader__ = None; del __bootstrap__, __loader__ imp.load_dynamic(__name__,__file__) __bootstrap__() """).lstrip() with open(pyfile, 'w') as f: f.write(_stub_template % resource) class bdist_egg(Command): description = "create an \"egg\" distribution" user_options = [ ('bdist-dir=', 'b', "temporary directory for creating the distribution"), ('plat-name=', 'p', "platform name to embed in generated filenames " "(default: %s)" % get_build_platform()), ('exclude-source-files', None, "remove all .py files from the generated egg"), ('keep-temp', 'k', "keep the pseudo-installation tree around after " + "creating the distribution archive"), ('dist-dir=', 'd', "directory to put final built distributions in"), ('skip-build', None, "skip rebuilding everything (for testing/debugging)"), ] boolean_options = [ 'keep-temp', 'skip-build', 'exclude-source-files' ] def initialize_options(self): self.bdist_dir = None self.plat_name = None self.keep_temp = 0 self.dist_dir = None self.skip_build = 0 self.egg_output = None self.exclude_source_files = None def finalize_options(self): ei_cmd = self.ei_cmd = self.get_finalized_command("egg_info") self.egg_info = ei_cmd.egg_info if self.bdist_dir is None: bdist_base = self.get_finalized_command('bdist').bdist_base self.bdist_dir = os.path.join(bdist_base, 'egg') if self.plat_name is None: self.plat_name = get_build_platform() self.set_undefined_options('bdist', ('dist_dir', 'dist_dir')) if self.egg_output is None: # Compute filename of the output egg basename = Distribution( None, None, ei_cmd.egg_name, ei_cmd.egg_version, get_python_version(), self.distribution.has_ext_modules() and self.plat_name ).egg_name() self.egg_output = os.path.join(self.dist_dir, basename + '.egg') def do_install_data(self): # Hack for packages that install data to install's --install-lib self.get_finalized_command('install').install_lib = self.bdist_dir site_packages = os.path.normcase(os.path.realpath(_get_purelib())) old, self.distribution.data_files = self.distribution.data_files, [] for item in old: if isinstance(item, tuple) and len(item) == 2: if os.path.isabs(item[0]): realpath = os.path.realpath(item[0]) normalized = os.path.normcase(realpath) if normalized == site_packages or normalized.startswith( site_packages + os.sep ): item = realpath[len(site_packages) + 1:], item[1] # XXX else: raise ??? self.distribution.data_files.append(item) try: log.info("installing package data to %s" % self.bdist_dir) self.call_command('install_data', force=0, root=None) finally: self.distribution.data_files = old def get_outputs(self): return [self.egg_output] def call_command(self, cmdname, **kw): """Invoke reinitialized command `cmdname` with keyword args""" for dirname in INSTALL_DIRECTORY_ATTRS: kw.setdefault(dirname, self.bdist_dir) kw.setdefault('skip_build', self.skip_build) kw.setdefault('dry_run', self.dry_run) cmd = self.reinitialize_command(cmdname, **kw) self.run_command(cmdname) return cmd def run(self): # Generate metadata first self.run_command("egg_info") # We run install_lib before install_data, because some data hacks # pull their data path from the install_lib command. log.info("installing library code to %s" % self.bdist_dir) instcmd = self.get_finalized_command('install') old_root = instcmd.root instcmd.root = None if self.distribution.has_c_libraries() and not self.skip_build: self.run_command('build_clib') cmd = self.call_command('install_lib', warn_dir=0) instcmd.root = old_root all_outputs, ext_outputs = self.get_ext_outputs() self.stubs = [] to_compile = [] for (p, ext_name) in enumerate(ext_outputs): filename, ext = os.path.splitext(ext_name) pyfile = os.path.join(self.bdist_dir, strip_module(filename) + '.py') self.stubs.append(pyfile) log.info("creating stub loader for %s" % ext_name) if not self.dry_run: write_stub(os.path.basename(ext_name), pyfile) to_compile.append(pyfile) ext_outputs[p] = ext_name.replace(os.sep, '/') if to_compile: cmd.byte_compile(to_compile) if self.distribution.data_files: self.do_install_data() # Make the EGG-INFO directory archive_root = self.bdist_dir egg_info = os.path.join(archive_root, 'EGG-INFO') self.mkpath(egg_info) if self.distribution.scripts: script_dir = os.path.join(egg_info, 'scripts') log.info("installing scripts to %s" % script_dir) self.call_command('install_scripts', install_dir=script_dir, no_ep=1) self.copy_metadata_to(egg_info) native_libs = os.path.join(egg_info, "native_libs.txt") if all_outputs: log.info("writing %s" % native_libs) if not self.dry_run: ensure_directory(native_libs) libs_file = open(native_libs, 'wt') libs_file.write('\n'.join(all_outputs)) libs_file.write('\n') libs_file.close() elif os.path.isfile(native_libs): log.info("removing %s" % native_libs) if not self.dry_run: os.unlink(native_libs) write_safety_flag( os.path.join(archive_root, 'EGG-INFO'), self.zip_safe() ) if os.path.exists(os.path.join(self.egg_info, 'depends.txt')): log.warn( "WARNING: 'depends.txt' will not be used by setuptools 0.6!\n" "Use the install_requires/extras_require setup() args instead." ) if self.exclude_source_files: self.zap_pyfiles() # Make the archive make_zipfile(self.egg_output, archive_root, verbose=self.verbose, dry_run=self.dry_run, mode=self.gen_header()) if not self.keep_temp: remove_tree(self.bdist_dir, dry_run=self.dry_run) # Add to 'Distribution.dist_files' so that the "upload" command works getattr(self.distribution, 'dist_files', []).append( ('bdist_egg', get_python_version(), self.egg_output)) def zap_pyfiles(self): log.info("Removing .py files from temporary directory") for base, dirs, files in walk_egg(self.bdist_dir): for name in files: if name.endswith('.py'): path = os.path.join(base, name) log.debug("Deleting %s", path) os.unlink(path) def zip_safe(self): safe = getattr(self.distribution, 'zip_safe', None) if safe is not None: return safe log.warn("zip_safe flag not set; analyzing archive contents...") return analyze_egg(self.bdist_dir, self.stubs) def gen_header(self): epm = EntryPoint.parse_map(self.distribution.entry_points or '') ep = epm.get('setuptools.installation', {}).get('eggsecutable') if ep is None: return 'w' # not an eggsecutable, do it the usual way. if not ep.attrs or ep.extras: raise DistutilsSetupError( "eggsecutable entry point (%r) cannot have 'extras' " "or refer to a module" % (ep,) ) pyver = sys.version[:3] pkg = ep.module_name full = '.'.join(ep.attrs) base = ep.attrs[0] basename = os.path.basename(self.egg_output) header = ( "#!/bin/sh\n" 'if [ `basename $0` = "%(basename)s" ]\n' 'then exec python%(pyver)s -c "' "import sys, os; sys.path.insert(0, os.path.abspath('$0')); " "from %(pkg)s import %(base)s; sys.exit(%(full)s())" '" "$@"\n' 'else\n' ' echo $0 is not the correct name for this egg file.\n' ' echo Please rename it back to %(basename)s and try again.\n' ' exec false\n' 'fi\n' ) % locals() if not self.dry_run: mkpath(os.path.dirname(self.egg_output), dry_run=self.dry_run) f = open(self.egg_output, 'w') f.write(header) f.close() return 'a' def copy_metadata_to(self, target_dir): "Copy metadata (egg info) to the target_dir" # normalize the path (so that a forward-slash in egg_info will # match using startswith below) norm_egg_info = os.path.normpath(self.egg_info) prefix = os.path.join(norm_egg_info, '') for path in self.ei_cmd.filelist.files: if path.startswith(prefix): target = os.path.join(target_dir, path[len(prefix):]) ensure_directory(target) self.copy_file(path, target) def get_ext_outputs(self): """Get a list of relative paths to C extensions in the output distro""" all_outputs = [] ext_outputs = [] paths = {self.bdist_dir: ''} for base, dirs, files in os.walk(self.bdist_dir): for filename in files: if os.path.splitext(filename)[1].lower() in NATIVE_EXTENSIONS: all_outputs.append(paths[base] + filename) for filename in dirs: paths[os.path.join(base, filename)] = (paths[base] + filename + '/') if self.distribution.has_ext_modules(): build_cmd = self.get_finalized_command('build_ext') for ext in build_cmd.extensions: if isinstance(ext, Library): continue fullname = build_cmd.get_ext_fullname(ext.name) filename = build_cmd.get_ext_filename(fullname) if not os.path.basename(filename).startswith('dl-'): if os.path.exists(os.path.join(self.bdist_dir, filename)): ext_outputs.append(filename) return all_outputs, ext_outputs NATIVE_EXTENSIONS = dict.fromkeys('.dll .so .dylib .pyd'.split()) def walk_egg(egg_dir): """Walk an unpacked egg's contents, skipping the metadata directory""" walker = os.walk(egg_dir) base, dirs, files = next(walker) if 'EGG-INFO' in dirs: dirs.remove('EGG-INFO') yield base, dirs, files for bdf in walker: yield bdf def analyze_egg(egg_dir, stubs): # check for existing flag in EGG-INFO for flag, fn in safety_flags.items(): if os.path.exists(os.path.join(egg_dir, 'EGG-INFO', fn)): return flag if not can_scan(): return False safe = True for base, dirs, files in walk_egg(egg_dir): for name in files: if name.endswith('.py') or name.endswith('.pyw'): continue elif name.endswith('.pyc') or name.endswith('.pyo'): # always scan, even if we already know we're not safe safe = scan_module(egg_dir, base, name, stubs) and safe return safe def write_safety_flag(egg_dir, safe): # Write or remove zip safety flag file(s) for flag, fn in safety_flags.items(): fn = os.path.join(egg_dir, fn) if os.path.exists(fn): if safe is None or bool(safe) != flag: os.unlink(fn) elif safe is not None and bool(safe) == flag: f = open(fn, 'wt') f.write('\n') f.close() safety_flags = { True: 'zip-safe', False: 'not-zip-safe', } def scan_module(egg_dir, base, name, stubs): """Check whether module possibly uses unsafe-for-zipfile stuff""" filename = os.path.join(base, name) if filename[:-1] in stubs: return True # Extension module pkg = base[len(egg_dir) + 1:].replace(os.sep, '.') module = pkg + (pkg and '.' or '') + os.path.splitext(name)[0] if sys.version_info < (3, 3): skip = 8 # skip magic & date else: skip = 12 # skip magic & date & file size f = open(filename, 'rb') f.read(skip) code = marshal.load(f) f.close() safe = True symbols = dict.fromkeys(iter_symbols(code)) for bad in ['__file__', '__path__']: if bad in symbols: log.warn("%s: module references %s", module, bad) safe = False if 'inspect' in symbols: for bad in [ 'getsource', 'getabsfile', 'getsourcefile', 'getfile' 'getsourcelines', 'findsource', 'getcomments', 'getframeinfo', 'getinnerframes', 'getouterframes', 'stack', 'trace' ]: if bad in symbols: log.warn("%s: module MAY be using inspect.%s", module, bad) safe = False return safe def iter_symbols(code): """Yield names and strings used by `code` and its nested code objects""" for name in code.co_names: yield name for const in code.co_consts: if isinstance(const, six.string_types): yield const elif isinstance(const, CodeType): for name in iter_symbols(const): yield name def can_scan(): if not sys.platform.startswith('java') and sys.platform != 'cli': # CPython, PyPy, etc. return True log.warn("Unable to analyze compiled code on this platform.") log.warn("Please ask the author to include a 'zip_safe'" " setting (either True or False) in the package's setup.py") # Attribute names of options for commands that might need to be convinced to # install to the egg build directory INSTALL_DIRECTORY_ATTRS = [ 'install_lib', 'install_dir', 'install_data', 'install_base' ] def make_zipfile(zip_filename, base_dir, verbose=0, dry_run=0, compress=True, mode='w'): """Create a zip file from all the files under 'base_dir'. The output zip file will be named 'base_dir' + ".zip". Uses either the "zipfile" Python module (if available) or the InfoZIP "zip" utility (if installed and found on the default search path). If neither tool is available, raises DistutilsExecError. Returns the name of the output zip file. """ import zipfile mkpath(os.path.dirname(zip_filename), dry_run=dry_run) log.info("creating '%s' and adding '%s' to it", zip_filename, base_dir) def visit(z, dirname, names): for name in names: path = os.path.normpath(os.path.join(dirname, name)) if os.path.isfile(path): p = path[len(base_dir) + 1:] if not dry_run: z.write(path, p) log.debug("adding '%s'" % p) compression = zipfile.ZIP_DEFLATED if compress else zipfile.ZIP_STORED if not dry_run: z = zipfile.ZipFile(zip_filename, mode, compression=compression) for dirname, dirs, files in os.walk(base_dir): visit(z, dirname, files) z.close() else: for dirname, dirs, files in os.walk(base_dir): visit(None, dirname, files) return zip_filename setuptools-20.7.0/setuptools/command/bdist_rpm.py0000775000175000017500000000274412702524020023065 0ustar travistravis00000000000000import distutils.command.bdist_rpm as orig class bdist_rpm(orig.bdist_rpm): """ Override the default bdist_rpm behavior to do the following: 1. Run egg_info to ensure the name and version are properly calculated. 2. Always run 'install' using --single-version-externally-managed to disable eggs in RPM distributions. 3. Replace dash with underscore in the version numbers for better RPM compatibility. """ def run(self): # ensure distro name is up-to-date self.run_command('egg_info') orig.bdist_rpm.run(self) def _make_spec_file(self): version = self.distribution.get_version() rpmversion = version.replace('-', '_') spec = orig.bdist_rpm._make_spec_file(self) line23 = '%define version ' + version line24 = '%define version ' + rpmversion spec = [ line.replace( "Source0: %{name}-%{version}.tar", "Source0: %{name}-%{unmangled_version}.tar" ).replace( "setup.py install ", "setup.py install --single-version-externally-managed " ).replace( "%setup", "%setup -n %{name}-%{unmangled_version}" ).replace(line23, line24) for line in spec ] insert_loc = spec.index(line24) + 1 unmangled_version = "%define unmangled_version " + version spec.insert(insert_loc, unmangled_version) return spec setuptools-20.7.0/setuptools/command/bdist_wininst.py0000775000175000017500000000117512702524020023757 0ustar travistravis00000000000000import distutils.command.bdist_wininst as orig class bdist_wininst(orig.bdist_wininst): def reinitialize_command(self, command, reinit_subcommands=0): """ Supplement reinitialize_command to work around http://bugs.python.org/issue20819 """ cmd = self.distribution.reinitialize_command( command, reinit_subcommands) if command in ('install', 'install_lib'): cmd.install_lib = None return cmd def run(self): self._is_running = True try: orig.bdist_wininst.run(self) finally: self._is_running = False setuptools-20.7.0/setuptools/command/build_ext.py0000664000175000017500000002727412702524020023063 0ustar travistravis00000000000000from distutils.command.build_ext import build_ext as _du_build_ext from distutils.file_util import copy_file from distutils.ccompiler import new_compiler from distutils.sysconfig import customize_compiler from distutils.errors import DistutilsError from distutils import log import os import sys import itertools from setuptools.extension import Library try: # Attempt to use Cython for building extensions, if available from Cython.Distutils.build_ext import build_ext as _build_ext except ImportError: _build_ext = _du_build_ext try: # Python 2.7 or >=3.2 from sysconfig import _CONFIG_VARS except ImportError: from distutils.sysconfig import get_config_var get_config_var("LDSHARED") # make sure _config_vars is initialized del get_config_var from distutils.sysconfig import _config_vars as _CONFIG_VARS have_rtld = False use_stubs = False libtype = 'shared' if sys.platform == "darwin": use_stubs = True elif os.name != 'nt': try: import dl use_stubs = have_rtld = hasattr(dl, 'RTLD_NOW') except ImportError: pass if_dl = lambda s: s if have_rtld else '' class build_ext(_build_ext): def run(self): """Build extensions in build directory, then copy if --inplace""" old_inplace, self.inplace = self.inplace, 0 _build_ext.run(self) self.inplace = old_inplace if old_inplace: self.copy_extensions_to_source() def copy_extensions_to_source(self): build_py = self.get_finalized_command('build_py') for ext in self.extensions: fullname = self.get_ext_fullname(ext.name) filename = self.get_ext_filename(fullname) modpath = fullname.split('.') package = '.'.join(modpath[:-1]) package_dir = build_py.get_package_dir(package) dest_filename = os.path.join(package_dir, os.path.basename(filename)) src_filename = os.path.join(self.build_lib, filename) # Always copy, even if source is older than destination, to ensure # that the right extensions for the current Python/platform are # used. copy_file( src_filename, dest_filename, verbose=self.verbose, dry_run=self.dry_run ) if ext._needs_stub: self.write_stub(package_dir or os.curdir, ext, True) def get_ext_filename(self, fullname): filename = _build_ext.get_ext_filename(self, fullname) if fullname in self.ext_map: ext = self.ext_map[fullname] if isinstance(ext, Library): fn, ext = os.path.splitext(filename) return self.shlib_compiler.library_filename(fn, libtype) elif use_stubs and ext._links_to_dynamic: d, fn = os.path.split(filename) return os.path.join(d, 'dl-' + fn) return filename def initialize_options(self): _build_ext.initialize_options(self) self.shlib_compiler = None self.shlibs = [] self.ext_map = {} def finalize_options(self): _build_ext.finalize_options(self) self.extensions = self.extensions or [] self.check_extensions_list(self.extensions) self.shlibs = [ext for ext in self.extensions if isinstance(ext, Library)] if self.shlibs: self.setup_shlib_compiler() for ext in self.extensions: ext._full_name = self.get_ext_fullname(ext.name) for ext in self.extensions: fullname = ext._full_name self.ext_map[fullname] = ext # distutils 3.1 will also ask for module names # XXX what to do with conflicts? self.ext_map[fullname.split('.')[-1]] = ext ltd = self.shlibs and self.links_to_dynamic(ext) or False ns = ltd and use_stubs and not isinstance(ext, Library) ext._links_to_dynamic = ltd ext._needs_stub = ns filename = ext._file_name = self.get_ext_filename(fullname) libdir = os.path.dirname(os.path.join(self.build_lib, filename)) if ltd and libdir not in ext.library_dirs: ext.library_dirs.append(libdir) if ltd and use_stubs and os.curdir not in ext.runtime_library_dirs: ext.runtime_library_dirs.append(os.curdir) def setup_shlib_compiler(self): compiler = self.shlib_compiler = new_compiler( compiler=self.compiler, dry_run=self.dry_run, force=self.force ) if sys.platform == "darwin": tmp = _CONFIG_VARS.copy() try: # XXX Help! I don't have any idea whether these are right... _CONFIG_VARS['LDSHARED'] = ( "gcc -Wl,-x -dynamiclib -undefined dynamic_lookup") _CONFIG_VARS['CCSHARED'] = " -dynamiclib" _CONFIG_VARS['SO'] = ".dylib" customize_compiler(compiler) finally: _CONFIG_VARS.clear() _CONFIG_VARS.update(tmp) else: customize_compiler(compiler) if self.include_dirs is not None: compiler.set_include_dirs(self.include_dirs) if self.define is not None: # 'define' option is a list of (name,value) tuples for (name, value) in self.define: compiler.define_macro(name, value) if self.undef is not None: for macro in self.undef: compiler.undefine_macro(macro) if self.libraries is not None: compiler.set_libraries(self.libraries) if self.library_dirs is not None: compiler.set_library_dirs(self.library_dirs) if self.rpath is not None: compiler.set_runtime_library_dirs(self.rpath) if self.link_objects is not None: compiler.set_link_objects(self.link_objects) # hack so distutils' build_extension() builds a library instead compiler.link_shared_object = link_shared_object.__get__(compiler) def get_export_symbols(self, ext): if isinstance(ext, Library): return ext.export_symbols return _build_ext.get_export_symbols(self, ext) def build_extension(self, ext): ext._convert_pyx_sources_to_lang() _compiler = self.compiler try: if isinstance(ext, Library): self.compiler = self.shlib_compiler _build_ext.build_extension(self, ext) if ext._needs_stub: cmd = self.get_finalized_command('build_py').build_lib self.write_stub(cmd, ext) finally: self.compiler = _compiler def links_to_dynamic(self, ext): """Return true if 'ext' links to a dynamic lib in the same package""" # XXX this should check to ensure the lib is actually being built # XXX as dynamic, and not just using a locally-found version or a # XXX static-compiled version libnames = dict.fromkeys([lib._full_name for lib in self.shlibs]) pkg = '.'.join(ext._full_name.split('.')[:-1] + ['']) return any(pkg + libname in libnames for libname in ext.libraries) def get_outputs(self): return _build_ext.get_outputs(self) + self.__get_stubs_outputs() def __get_stubs_outputs(self): # assemble the base name for each extension that needs a stub ns_ext_bases = ( os.path.join(self.build_lib, *ext._full_name.split('.')) for ext in self.extensions if ext._needs_stub ) # pair each base with the extension pairs = itertools.product(ns_ext_bases, self.__get_output_extensions()) return list(base + fnext for base, fnext in pairs) def __get_output_extensions(self): yield '.py' yield '.pyc' if self.get_finalized_command('build_py').optimize: yield '.pyo' def write_stub(self, output_dir, ext, compile=False): log.info("writing stub loader for %s to %s", ext._full_name, output_dir) stub_file = (os.path.join(output_dir, *ext._full_name.split('.')) + '.py') if compile and os.path.exists(stub_file): raise DistutilsError(stub_file + " already exists! Please delete.") if not self.dry_run: f = open(stub_file, 'w') f.write( '\n'.join([ "def __bootstrap__():", " global __bootstrap__, __file__, __loader__", " import sys, os, pkg_resources, imp" + if_dl(", dl"), " __file__ = pkg_resources.resource_filename" "(__name__,%r)" % os.path.basename(ext._file_name), " del __bootstrap__", " if '__loader__' in globals():", " del __loader__", if_dl(" old_flags = sys.getdlopenflags()"), " old_dir = os.getcwd()", " try:", " os.chdir(os.path.dirname(__file__))", if_dl(" sys.setdlopenflags(dl.RTLD_NOW)"), " imp.load_dynamic(__name__,__file__)", " finally:", if_dl(" sys.setdlopenflags(old_flags)"), " os.chdir(old_dir)", "__bootstrap__()", "" # terminal \n ]) ) f.close() if compile: from distutils.util import byte_compile byte_compile([stub_file], optimize=0, force=True, dry_run=self.dry_run) optimize = self.get_finalized_command('install_lib').optimize if optimize > 0: byte_compile([stub_file], optimize=optimize, force=True, dry_run=self.dry_run) if os.path.exists(stub_file) and not self.dry_run: os.unlink(stub_file) if use_stubs or os.name == 'nt': # Build shared libraries # def link_shared_object( self, objects, output_libname, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None): self.link( self.SHARED_LIBRARY, objects, output_libname, output_dir, libraries, library_dirs, runtime_library_dirs, export_symbols, debug, extra_preargs, extra_postargs, build_temp, target_lang ) else: # Build static libraries everywhere else libtype = 'static' def link_shared_object( self, objects, output_libname, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None): # XXX we need to either disallow these attrs on Library instances, # or warn/abort here if set, or something... # libraries=None, library_dirs=None, runtime_library_dirs=None, # export_symbols=None, extra_preargs=None, extra_postargs=None, # build_temp=None assert output_dir is None # distutils build_ext doesn't pass this output_dir, filename = os.path.split(output_libname) basename, ext = os.path.splitext(filename) if self.library_filename("x").startswith('lib'): # strip 'lib' prefix; this is kludgy if some platform uses # a different prefix basename = basename[3:] self.create_static_lib( objects, basename, output_dir, debug, target_lang ) setuptools-20.7.0/setuptools/command/build_py.py0000664000175000017500000001745712702524020022715 0ustar travistravis00000000000000from glob import glob from distutils.util import convert_path import distutils.command.build_py as orig import os import fnmatch import textwrap import io import distutils.errors import collections import itertools from setuptools.extern.six.moves import map try: from setuptools.lib2to3_ex import Mixin2to3 except ImportError: class Mixin2to3: def run_2to3(self, files, doctests=True): "do nothing" class build_py(orig.build_py, Mixin2to3): """Enhanced 'build_py' command that includes data files with packages The data files are specified via a 'package_data' argument to 'setup()'. See 'setuptools.dist.Distribution' for more details. Also, this version of the 'build_py' command allows you to specify both 'py_modules' and 'packages' in the same setup operation. """ def finalize_options(self): orig.build_py.finalize_options(self) self.package_data = self.distribution.package_data self.exclude_package_data = (self.distribution.exclude_package_data or {}) if 'data_files' in self.__dict__: del self.__dict__['data_files'] self.__updated_files = [] self.__doctests_2to3 = [] def run(self): """Build modules, packages, and copy data files to build directory""" if not self.py_modules and not self.packages: return if self.py_modules: self.build_modules() if self.packages: self.build_packages() self.build_package_data() self.run_2to3(self.__updated_files, False) self.run_2to3(self.__updated_files, True) self.run_2to3(self.__doctests_2to3, True) # Only compile actual .py files, using our base class' idea of what our # output files are. self.byte_compile(orig.build_py.get_outputs(self, include_bytecode=0)) def __getattr__(self, attr): "lazily compute data files" if attr == 'data_files': self.data_files = self._get_data_files() return self.data_files return orig.build_py.__getattr__(self, attr) def build_module(self, module, module_file, package): outfile, copied = orig.build_py.build_module(self, module, module_file, package) if copied: self.__updated_files.append(outfile) return outfile, copied def _get_data_files(self): """Generate list of '(package,src_dir,build_dir,filenames)' tuples""" self.analyze_manifest() return list(map(self._get_pkg_data_files, self.packages or ())) def _get_pkg_data_files(self, package): # Locate package source directory src_dir = self.get_package_dir(package) # Compute package build directory build_dir = os.path.join(*([self.build_lib] + package.split('.'))) # Strip directory from globbed filenames filenames = [ os.path.relpath(file, src_dir) for file in self.find_data_files(package, src_dir) ] return package, src_dir, build_dir, filenames def find_data_files(self, package, src_dir): """Return filenames for package's data files in 'src_dir'""" globs = (self.package_data.get('', []) + self.package_data.get(package, [])) files = self.manifest_files.get(package, [])[:] for pattern in globs: # Each pattern has to be converted to a platform-specific path files.extend(glob(os.path.join(src_dir, convert_path(pattern)))) return self.exclude_data_files(package, src_dir, files) def build_package_data(self): """Copy data files into build directory""" for package, src_dir, build_dir, filenames in self.data_files: for filename in filenames: target = os.path.join(build_dir, filename) self.mkpath(os.path.dirname(target)) srcfile = os.path.join(src_dir, filename) outf, copied = self.copy_file(srcfile, target) srcfile = os.path.abspath(srcfile) if (copied and srcfile in self.distribution.convert_2to3_doctests): self.__doctests_2to3.append(outf) def analyze_manifest(self): self.manifest_files = mf = {} if not self.distribution.include_package_data: return src_dirs = {} for package in self.packages or (): # Locate package source directory src_dirs[assert_relative(self.get_package_dir(package))] = package self.run_command('egg_info') ei_cmd = self.get_finalized_command('egg_info') for path in ei_cmd.filelist.files: d, f = os.path.split(assert_relative(path)) prev = None oldf = f while d and d != prev and d not in src_dirs: prev = d d, df = os.path.split(d) f = os.path.join(df, f) if d in src_dirs: if path.endswith('.py') and f == oldf: continue # it's a module, not data mf.setdefault(src_dirs[d], []).append(path) def get_data_files(self): pass # Lazily compute data files in _get_data_files() function. def check_package(self, package, package_dir): """Check namespace packages' __init__ for declare_namespace""" try: return self.packages_checked[package] except KeyError: pass init_py = orig.build_py.check_package(self, package, package_dir) self.packages_checked[package] = init_py if not init_py or not self.distribution.namespace_packages: return init_py for pkg in self.distribution.namespace_packages: if pkg == package or pkg.startswith(package + '.'): break else: return init_py with io.open(init_py, 'rb') as f: contents = f.read() if b'declare_namespace' not in contents: raise distutils.errors.DistutilsError( "Namespace package problem: %s is a namespace package, but " "its\n__init__.py does not call declare_namespace()! Please " 'fix it.\n(See the setuptools manual under ' '"Namespace Packages" for details.)\n"' % (package,) ) return init_py def initialize_options(self): self.packages_checked = {} orig.build_py.initialize_options(self) def get_package_dir(self, package): res = orig.build_py.get_package_dir(self, package) if self.distribution.src_root is not None: return os.path.join(self.distribution.src_root, res) return res def exclude_data_files(self, package, src_dir, files): """Filter filenames for package's data files in 'src_dir'""" globs = ( self.exclude_package_data.get('', []) + self.exclude_package_data.get(package, []) ) bad = set( item for pattern in globs for item in fnmatch.filter( files, os.path.join(src_dir, convert_path(pattern)), ) ) seen = collections.defaultdict(itertools.count) return [ fn for fn in files if fn not in bad # ditch dupes and not next(seen[fn]) ] def assert_relative(path): if not os.path.isabs(path): return path from distutils.errors import DistutilsSetupError msg = textwrap.dedent(""" Error: setup script specifies an absolute path: %s setup() arguments must *always* be /-separated paths relative to the setup.py directory, *never* absolute paths. """).lstrip() % path raise DistutilsSetupError(msg) setuptools-20.7.0/setuptools/command/develop.py0000775000175000017500000001632712702524020022542 0ustar travistravis00000000000000from distutils.util import convert_path from distutils import log from distutils.errors import DistutilsError, DistutilsOptionError import os import glob import io from setuptools.extern import six from pkg_resources import Distribution, PathMetadata, normalize_path from setuptools.command.easy_install import easy_install import setuptools class develop(easy_install): """Set up package for development""" description = "install package in 'development mode'" user_options = easy_install.user_options + [ ("uninstall", "u", "Uninstall this source package"), ("egg-path=", None, "Set the path to be used in the .egg-link file"), ] boolean_options = easy_install.boolean_options + ['uninstall'] command_consumes_arguments = False # override base def run(self): if self.uninstall: self.multi_version = True self.uninstall_link() else: self.install_for_development() self.warn_deprecated_options() def initialize_options(self): self.uninstall = None self.egg_path = None easy_install.initialize_options(self) self.setup_path = None self.always_copy_from = '.' # always copy eggs installed in curdir def finalize_options(self): ei = self.get_finalized_command("egg_info") if ei.broken_egg_info: template = "Please rename %r to %r before using 'develop'" args = ei.egg_info, ei.broken_egg_info raise DistutilsError(template % args) self.args = [ei.egg_name] easy_install.finalize_options(self) self.expand_basedirs() self.expand_dirs() # pick up setup-dir .egg files only: no .egg-info self.package_index.scan(glob.glob('*.egg')) egg_link_fn = ei.egg_name + '.egg-link' self.egg_link = os.path.join(self.install_dir, egg_link_fn) self.egg_base = ei.egg_base if self.egg_path is None: self.egg_path = os.path.abspath(ei.egg_base) target = normalize_path(self.egg_base) egg_path = normalize_path(os.path.join(self.install_dir, self.egg_path)) if egg_path != target: raise DistutilsOptionError( "--egg-path must be a relative path from the install" " directory to " + target ) # Make a distribution for the package's source self.dist = Distribution( target, PathMetadata(target, os.path.abspath(ei.egg_info)), project_name=ei.egg_name ) p = self.egg_base.replace(os.sep, '/') if p != os.curdir: p = '../' * (p.count('/') + 1) self.setup_path = p p = normalize_path(os.path.join(self.install_dir, self.egg_path, p)) if p != normalize_path(os.curdir): raise DistutilsOptionError( "Can't get a consistent path to setup script from" " installation directory", p, normalize_path(os.curdir)) def install_for_development(self): if six.PY3 and getattr(self.distribution, 'use_2to3', False): # If we run 2to3 we can not do this inplace: # Ensure metadata is up-to-date self.reinitialize_command('build_py', inplace=0) self.run_command('build_py') bpy_cmd = self.get_finalized_command("build_py") build_path = normalize_path(bpy_cmd.build_lib) # Build extensions self.reinitialize_command('egg_info', egg_base=build_path) self.run_command('egg_info') self.reinitialize_command('build_ext', inplace=0) self.run_command('build_ext') # Fixup egg-link and easy-install.pth ei_cmd = self.get_finalized_command("egg_info") self.egg_path = build_path self.dist.location = build_path # XXX self.dist._provider = PathMetadata(build_path, ei_cmd.egg_info) else: # Without 2to3 inplace works fine: self.run_command('egg_info') # Build extensions in-place self.reinitialize_command('build_ext', inplace=1) self.run_command('build_ext') self.install_site_py() # ensure that target dir is site-safe if setuptools.bootstrap_install_from: self.easy_install(setuptools.bootstrap_install_from) setuptools.bootstrap_install_from = None # create an .egg-link in the installation dir, pointing to our egg log.info("Creating %s (link to %s)", self.egg_link, self.egg_base) if not self.dry_run: with open(self.egg_link, "w") as f: f.write(self.egg_path + "\n" + self.setup_path) # postprocess the installed distro, fixing up .pth, installing scripts, # and handling requirements self.process_distribution(None, self.dist, not self.no_deps) def uninstall_link(self): if os.path.exists(self.egg_link): log.info("Removing %s (link to %s)", self.egg_link, self.egg_base) egg_link_file = open(self.egg_link) contents = [line.rstrip() for line in egg_link_file] egg_link_file.close() if contents not in ([self.egg_path], [self.egg_path, self.setup_path]): log.warn("Link points to %s: uninstall aborted", contents) return if not self.dry_run: os.unlink(self.egg_link) if not self.dry_run: self.update_pth(self.dist) # remove any .pth link to us if self.distribution.scripts: # XXX should also check for entry point scripts! log.warn("Note: you must uninstall or replace scripts manually!") def install_egg_scripts(self, dist): if dist is not self.dist: # Installing a dependency, so fall back to normal behavior return easy_install.install_egg_scripts(self, dist) # create wrapper scripts in the script dir, pointing to dist.scripts # new-style... self.install_wrapper_scripts(dist) # ...and old-style for script_name in self.distribution.scripts or []: script_path = os.path.abspath(convert_path(script_name)) script_name = os.path.basename(script_path) with io.open(script_path) as strm: script_text = strm.read() self.install_script(dist, script_name, script_text, script_path) def install_wrapper_scripts(self, dist): dist = VersionlessRequirement(dist) return easy_install.install_wrapper_scripts(self, dist) class VersionlessRequirement(object): """ Adapt a pkg_resources.Distribution to simply return the project name as the 'requirement' so that scripts will work across multiple versions. >>> dist = Distribution(project_name='foo', version='1.0') >>> str(dist.as_requirement()) 'foo==1.0' >>> adapted_dist = VersionlessRequirement(dist) >>> str(adapted_dist.as_requirement()) 'foo' """ def __init__(self, dist): self.__dist = dist def __getattr__(self, name): return getattr(self.__dist, name) def as_requirement(self): return self.project_name setuptools-20.7.0/setuptools/command/easy_install.py0000775000175000017500000024756012702524020023600 0ustar travistravis00000000000000#!/usr/bin/env python """ Easy Install ------------ A tool for doing automatic download/extract/build of distutils-based Python packages. For detailed documentation, see the accompanying EasyInstall.txt file, or visit the `EasyInstall home page`__. __ https://pythonhosted.org/setuptools/easy_install.html """ from glob import glob from distutils.util import get_platform from distutils.util import convert_path, subst_vars from distutils.errors import DistutilsArgError, DistutilsOptionError, \ DistutilsError, DistutilsPlatformError from distutils.command.install import INSTALL_SCHEMES, SCHEME_KEYS from distutils import log, dir_util from distutils.command.build_scripts import first_line_re from distutils.spawn import find_executable import sys import os import zipimport import shutil import tempfile import zipfile import re import stat import random import platform import textwrap import warnings import site import struct import contextlib import subprocess import shlex import io from setuptools.extern import six from setuptools.extern.six.moves import configparser, map from setuptools import Command from setuptools.sandbox import run_setup from setuptools.py31compat import get_path, get_config_vars from setuptools.command import setopt from setuptools.archive_util import unpack_archive from setuptools.package_index import PackageIndex from setuptools.package_index import URL_SCHEME from setuptools.command import bdist_egg, egg_info from pkg_resources import ( yield_lines, normalize_path, resource_string, ensure_directory, get_distribution, find_distributions, Environment, Requirement, Distribution, PathMetadata, EggMetadata, WorkingSet, DistributionNotFound, VersionConflict, DEVELOP_DIST, ) import pkg_resources # Turn on PEP440Warnings warnings.filterwarnings("default", category=pkg_resources.PEP440Warning) __all__ = [ 'samefile', 'easy_install', 'PthDistributions', 'extract_wininst_cfg', 'main', 'get_exe_prefixes', ] def is_64bit(): return struct.calcsize("P") == 8 def samefile(p1, p2): both_exist = os.path.exists(p1) and os.path.exists(p2) use_samefile = hasattr(os.path, 'samefile') and both_exist if use_samefile: return os.path.samefile(p1, p2) norm_p1 = os.path.normpath(os.path.normcase(p1)) norm_p2 = os.path.normpath(os.path.normcase(p2)) return norm_p1 == norm_p2 if six.PY2: def _to_ascii(s): return s def isascii(s): try: six.text_type(s, 'ascii') return True except UnicodeError: return False else: def _to_ascii(s): return s.encode('ascii') def isascii(s): try: s.encode('ascii') return True except UnicodeError: return False class easy_install(Command): """Manage a download/build/install process""" description = "Find/get/install Python packages" command_consumes_arguments = True user_options = [ ('prefix=', None, "installation prefix"), ("zip-ok", "z", "install package as a zipfile"), ("multi-version", "m", "make apps have to require() a version"), ("upgrade", "U", "force upgrade (searches PyPI for latest versions)"), ("install-dir=", "d", "install package to DIR"), ("script-dir=", "s", "install scripts to DIR"), ("exclude-scripts", "x", "Don't install scripts"), ("always-copy", "a", "Copy all needed packages to install dir"), ("index-url=", "i", "base URL of Python Package Index"), ("find-links=", "f", "additional URL(s) to search for packages"), ("build-directory=", "b", "download/extract/build in DIR; keep the results"), ('optimize=', 'O', "also compile with optimization: -O1 for \"python -O\", " "-O2 for \"python -OO\", and -O0 to disable [default: -O0]"), ('record=', None, "filename in which to record list of installed files"), ('always-unzip', 'Z', "don't install as a zipfile, no matter what"), ('site-dirs=', 'S', "list of directories where .pth files work"), ('editable', 'e', "Install specified packages in editable form"), ('no-deps', 'N', "don't install dependencies"), ('allow-hosts=', 'H', "pattern(s) that hostnames must match"), ('local-snapshots-ok', 'l', "allow building eggs from local checkouts"), ('version', None, "print version information and exit"), ('no-find-links', None, "Don't load find-links defined in packages being installed") ] boolean_options = [ 'zip-ok', 'multi-version', 'exclude-scripts', 'upgrade', 'always-copy', 'editable', 'no-deps', 'local-snapshots-ok', 'version' ] if site.ENABLE_USER_SITE: help_msg = "install in user site-package '%s'" % site.USER_SITE user_options.append(('user', None, help_msg)) boolean_options.append('user') negative_opt = {'always-unzip': 'zip-ok'} create_index = PackageIndex def initialize_options(self): # the --user option seems to be an opt-in one, # so the default should be False. self.user = 0 self.zip_ok = self.local_snapshots_ok = None self.install_dir = self.script_dir = self.exclude_scripts = None self.index_url = None self.find_links = None self.build_directory = None self.args = None self.optimize = self.record = None self.upgrade = self.always_copy = self.multi_version = None self.editable = self.no_deps = self.allow_hosts = None self.root = self.prefix = self.no_report = None self.version = None self.install_purelib = None # for pure module distributions self.install_platlib = None # non-pure (dists w/ extensions) self.install_headers = None # for C/C++ headers self.install_lib = None # set to either purelib or platlib self.install_scripts = None self.install_data = None self.install_base = None self.install_platbase = None if site.ENABLE_USER_SITE: self.install_userbase = site.USER_BASE self.install_usersite = site.USER_SITE else: self.install_userbase = None self.install_usersite = None self.no_find_links = None # Options not specifiable via command line self.package_index = None self.pth_file = self.always_copy_from = None self.site_dirs = None self.installed_projects = {} self.sitepy_installed = False # Always read easy_install options, even if we are subclassed, or have # an independent instance created. This ensures that defaults will # always come from the standard configuration file(s)' "easy_install" # section, even if this is a "develop" or "install" command, or some # other embedding. self._dry_run = None self.verbose = self.distribution.verbose self.distribution._set_command_options( self, self.distribution.get_option_dict('easy_install') ) def delete_blockers(self, blockers): extant_blockers = ( filename for filename in blockers if os.path.exists(filename) or os.path.islink(filename) ) list(map(self._delete_path, extant_blockers)) def _delete_path(self, path): log.info("Deleting %s", path) if self.dry_run: return is_tree = os.path.isdir(path) and not os.path.islink(path) remover = rmtree if is_tree else os.unlink remover(path) @staticmethod def _render_version(): """ Render the Setuptools version and installation details, then exit. """ ver = sys.version[:3] dist = get_distribution('setuptools') tmpl = 'setuptools {dist.version} from {dist.location} (Python {ver})' print(tmpl.format(**locals())) raise SystemExit() def finalize_options(self): self.version and self._render_version() py_version = sys.version.split()[0] prefix, exec_prefix = get_config_vars('prefix', 'exec_prefix') self.config_vars = { 'dist_name': self.distribution.get_name(), 'dist_version': self.distribution.get_version(), 'dist_fullname': self.distribution.get_fullname(), 'py_version': py_version, 'py_version_short': py_version[0:3], 'py_version_nodot': py_version[0] + py_version[2], 'sys_prefix': prefix, 'prefix': prefix, 'sys_exec_prefix': exec_prefix, 'exec_prefix': exec_prefix, # Only python 3.2+ has abiflags 'abiflags': getattr(sys, 'abiflags', ''), } if site.ENABLE_USER_SITE: self.config_vars['userbase'] = self.install_userbase self.config_vars['usersite'] = self.install_usersite self._fix_install_dir_for_user_site() self.expand_basedirs() self.expand_dirs() self._expand('install_dir', 'script_dir', 'build_directory', 'site_dirs') # If a non-default installation directory was specified, default the # script directory to match it. if self.script_dir is None: self.script_dir = self.install_dir if self.no_find_links is None: self.no_find_links = False # Let install_dir get set by install_lib command, which in turn # gets its info from the install command, and takes into account # --prefix and --home and all that other crud. self.set_undefined_options( 'install_lib', ('install_dir', 'install_dir') ) # Likewise, set default script_dir from 'install_scripts.install_dir' self.set_undefined_options( 'install_scripts', ('install_dir', 'script_dir') ) if self.user and self.install_purelib: self.install_dir = self.install_purelib self.script_dir = self.install_scripts # default --record from the install command self.set_undefined_options('install', ('record', 'record')) # Should this be moved to the if statement below? It's not used # elsewhere normpath = map(normalize_path, sys.path) self.all_site_dirs = get_site_dirs() if self.site_dirs is not None: site_dirs = [ os.path.expanduser(s.strip()) for s in self.site_dirs.split(',') ] for d in site_dirs: if not os.path.isdir(d): log.warn("%s (in --site-dirs) does not exist", d) elif normalize_path(d) not in normpath: raise DistutilsOptionError( d + " (in --site-dirs) is not on sys.path" ) else: self.all_site_dirs.append(normalize_path(d)) if not self.editable: self.check_site_dir() self.index_url = self.index_url or "https://pypi.python.org/simple" self.shadow_path = self.all_site_dirs[:] for path_item in self.install_dir, normalize_path(self.script_dir): if path_item not in self.shadow_path: self.shadow_path.insert(0, path_item) if self.allow_hosts is not None: hosts = [s.strip() for s in self.allow_hosts.split(',')] else: hosts = ['*'] if self.package_index is None: self.package_index = self.create_index( self.index_url, search_path=self.shadow_path, hosts=hosts, ) self.local_index = Environment(self.shadow_path + sys.path) if self.find_links is not None: if isinstance(self.find_links, six.string_types): self.find_links = self.find_links.split() else: self.find_links = [] if self.local_snapshots_ok: self.package_index.scan_egg_links(self.shadow_path + sys.path) if not self.no_find_links: self.package_index.add_find_links(self.find_links) self.set_undefined_options('install_lib', ('optimize', 'optimize')) if not isinstance(self.optimize, int): try: self.optimize = int(self.optimize) if not (0 <= self.optimize <= 2): raise ValueError except ValueError: raise DistutilsOptionError("--optimize must be 0, 1, or 2") if self.editable and not self.build_directory: raise DistutilsArgError( "Must specify a build directory (-b) when using --editable" ) if not self.args: raise DistutilsArgError( "No urls, filenames, or requirements specified (see --help)") self.outputs = [] def _fix_install_dir_for_user_site(self): """ Fix the install_dir if "--user" was used. """ if not self.user or not site.ENABLE_USER_SITE: return self.create_home_path() if self.install_userbase is None: msg = "User base directory is not specified" raise DistutilsPlatformError(msg) self.install_base = self.install_platbase = self.install_userbase scheme_name = os.name.replace('posix', 'unix') + '_user' self.select_scheme(scheme_name) def _expand_attrs(self, attrs): for attr in attrs: val = getattr(self, attr) if val is not None: if os.name == 'posix' or os.name == 'nt': val = os.path.expanduser(val) val = subst_vars(val, self.config_vars) setattr(self, attr, val) def expand_basedirs(self): """Calls `os.path.expanduser` on install_base, install_platbase and root.""" self._expand_attrs(['install_base', 'install_platbase', 'root']) def expand_dirs(self): """Calls `os.path.expanduser` on install dirs.""" self._expand_attrs(['install_purelib', 'install_platlib', 'install_lib', 'install_headers', 'install_scripts', 'install_data', ]) def run(self): if self.verbose != self.distribution.verbose: log.set_verbosity(self.verbose) try: for spec in self.args: self.easy_install(spec, not self.no_deps) if self.record: outputs = self.outputs if self.root: # strip any package prefix root_len = len(self.root) for counter in range(len(outputs)): outputs[counter] = outputs[counter][root_len:] from distutils import file_util self.execute( file_util.write_file, (self.record, outputs), "writing list of installed files to '%s'" % self.record ) self.warn_deprecated_options() finally: log.set_verbosity(self.distribution.verbose) def pseudo_tempname(self): """Return a pseudo-tempname base in the install directory. This code is intentionally naive; if a malicious party can write to the target directory you're already in deep doodoo. """ try: pid = os.getpid() except: pid = random.randint(0, sys.maxsize) return os.path.join(self.install_dir, "test-easy-install-%s" % pid) def warn_deprecated_options(self): pass def check_site_dir(self): """Verify that self.install_dir is .pth-capable dir, if needed""" instdir = normalize_path(self.install_dir) pth_file = os.path.join(instdir, 'easy-install.pth') # Is it a configured, PYTHONPATH, implicit, or explicit site dir? is_site_dir = instdir in self.all_site_dirs if not is_site_dir and not self.multi_version: # No? Then directly test whether it does .pth file processing is_site_dir = self.check_pth_processing() else: # make sure we can write to target dir testfile = self.pseudo_tempname() + '.write-test' test_exists = os.path.exists(testfile) try: if test_exists: os.unlink(testfile) open(testfile, 'w').close() os.unlink(testfile) except (OSError, IOError): self.cant_write_to_target() if not is_site_dir and not self.multi_version: # Can't install non-multi to non-site dir raise DistutilsError(self.no_default_version_msg()) if is_site_dir: if self.pth_file is None: self.pth_file = PthDistributions(pth_file, self.all_site_dirs) else: self.pth_file = None PYTHONPATH = os.environ.get('PYTHONPATH', '').split(os.pathsep) if instdir not in map(normalize_path, filter(None, PYTHONPATH)): # only PYTHONPATH dirs need a site.py, so pretend it's there self.sitepy_installed = True elif self.multi_version and not os.path.exists(pth_file): self.sitepy_installed = True # don't need site.py in this case self.pth_file = None # and don't create a .pth file self.install_dir = instdir __cant_write_msg = textwrap.dedent(""" can't create or remove files in install directory The following error occurred while trying to add or remove files in the installation directory: %s The installation directory you specified (via --install-dir, --prefix, or the distutils default setting) was: %s """).lstrip() __not_exists_id = textwrap.dedent(""" This directory does not currently exist. Please create it and try again, or choose a different installation directory (using the -d or --install-dir option). """).lstrip() __access_msg = textwrap.dedent(""" Perhaps your account does not have write access to this directory? If the installation directory is a system-owned directory, you may need to sign in as the administrator or "root" account. If you do not have administrative access to this machine, you may wish to choose a different installation directory, preferably one that is listed in your PYTHONPATH environment variable. For information on other options, you may wish to consult the documentation at: https://pythonhosted.org/setuptools/easy_install.html Please make the appropriate changes for your system and try again. """).lstrip() def cant_write_to_target(self): msg = self.__cant_write_msg % (sys.exc_info()[1], self.install_dir,) if not os.path.exists(self.install_dir): msg += '\n' + self.__not_exists_id else: msg += '\n' + self.__access_msg raise DistutilsError(msg) def check_pth_processing(self): """Empirically verify whether .pth files are supported in inst. dir""" instdir = self.install_dir log.info("Checking .pth file support in %s", instdir) pth_file = self.pseudo_tempname() + ".pth" ok_file = pth_file + '.ok' ok_exists = os.path.exists(ok_file) try: if ok_exists: os.unlink(ok_file) dirname = os.path.dirname(ok_file) if not os.path.exists(dirname): os.makedirs(dirname) f = open(pth_file, 'w') except (OSError, IOError): self.cant_write_to_target() else: try: f.write("import os; f = open(%r, 'w'); f.write('OK'); " "f.close()\n" % (ok_file,)) f.close() f = None executable = sys.executable if os.name == 'nt': dirname, basename = os.path.split(executable) alt = os.path.join(dirname, 'pythonw.exe') if (basename.lower() == 'python.exe' and os.path.exists(alt)): # use pythonw.exe to avoid opening a console window executable = alt from distutils.spawn import spawn spawn([executable, '-E', '-c', 'pass'], 0) if os.path.exists(ok_file): log.info( "TEST PASSED: %s appears to support .pth files", instdir ) return True finally: if f: f.close() if os.path.exists(ok_file): os.unlink(ok_file) if os.path.exists(pth_file): os.unlink(pth_file) if not self.multi_version: log.warn("TEST FAILED: %s does NOT support .pth files", instdir) return False def install_egg_scripts(self, dist): """Write all the scripts for `dist`, unless scripts are excluded""" if not self.exclude_scripts and dist.metadata_isdir('scripts'): for script_name in dist.metadata_listdir('scripts'): if dist.metadata_isdir('scripts/' + script_name): # The "script" is a directory, likely a Python 3 # __pycache__ directory, so skip it. continue self.install_script( dist, script_name, dist.get_metadata('scripts/' + script_name) ) self.install_wrapper_scripts(dist) def add_output(self, path): if os.path.isdir(path): for base, dirs, files in os.walk(path): for filename in files: self.outputs.append(os.path.join(base, filename)) else: self.outputs.append(path) def not_editable(self, spec): if self.editable: raise DistutilsArgError( "Invalid argument %r: you can't use filenames or URLs " "with --editable (except via the --find-links option)." % (spec,) ) def check_editable(self, spec): if not self.editable: return if os.path.exists(os.path.join(self.build_directory, spec.key)): raise DistutilsArgError( "%r already exists in %s; can't do a checkout there" % (spec.key, self.build_directory) ) def easy_install(self, spec, deps=False): tmpdir = tempfile.mkdtemp(prefix="easy_install-") download = None if not self.editable: self.install_site_py() try: if not isinstance(spec, Requirement): if URL_SCHEME(spec): # It's a url, download it to tmpdir and process self.not_editable(spec) download = self.package_index.download(spec, tmpdir) return self.install_item(None, download, tmpdir, deps, True) elif os.path.exists(spec): # Existing file or directory, just process it directly self.not_editable(spec) return self.install_item(None, spec, tmpdir, deps, True) else: spec = parse_requirement_arg(spec) self.check_editable(spec) dist = self.package_index.fetch_distribution( spec, tmpdir, self.upgrade, self.editable, not self.always_copy, self.local_index ) if dist is None: msg = "Could not find suitable distribution for %r" % spec if self.always_copy: msg += " (--always-copy skips system and development eggs)" raise DistutilsError(msg) elif dist.precedence == DEVELOP_DIST: # .egg-info dists don't need installing, just process deps self.process_distribution(spec, dist, deps, "Using") return dist else: return self.install_item(spec, dist.location, tmpdir, deps) finally: if os.path.exists(tmpdir): rmtree(tmpdir) def install_item(self, spec, download, tmpdir, deps, install_needed=False): # Installation is also needed if file in tmpdir or is not an egg install_needed = install_needed or self.always_copy install_needed = install_needed or os.path.dirname(download) == tmpdir install_needed = install_needed or not download.endswith('.egg') install_needed = install_needed or ( self.always_copy_from is not None and os.path.dirname(normalize_path(download)) == normalize_path(self.always_copy_from) ) if spec and not install_needed: # at this point, we know it's a local .egg, we just don't know if # it's already installed. for dist in self.local_index[spec.project_name]: if dist.location == download: break else: install_needed = True # it's not in the local index log.info("Processing %s", os.path.basename(download)) if install_needed: dists = self.install_eggs(spec, download, tmpdir) for dist in dists: self.process_distribution(spec, dist, deps) else: dists = [self.egg_distribution(download)] self.process_distribution(spec, dists[0], deps, "Using") if spec is not None: for dist in dists: if dist in spec: return dist def select_scheme(self, name): """Sets the install directories by applying the install schemes.""" # it's the caller's problem if they supply a bad name! scheme = INSTALL_SCHEMES[name] for key in SCHEME_KEYS: attrname = 'install_' + key if getattr(self, attrname) is None: setattr(self, attrname, scheme[key]) def process_distribution(self, requirement, dist, deps=True, *info): self.update_pth(dist) self.package_index.add(dist) if dist in self.local_index[dist.key]: self.local_index.remove(dist) self.local_index.add(dist) self.install_egg_scripts(dist) self.installed_projects[dist.key] = dist log.info(self.installation_report(requirement, dist, *info)) if (dist.has_metadata('dependency_links.txt') and not self.no_find_links): self.package_index.add_find_links( dist.get_metadata_lines('dependency_links.txt') ) if not deps and not self.always_copy: return elif requirement is not None and dist.key != requirement.key: log.warn("Skipping dependencies for %s", dist) return # XXX this is not the distribution we were looking for elif requirement is None or dist not in requirement: # if we wound up with a different version, resolve what we've got distreq = dist.as_requirement() requirement = Requirement(str(distreq)) log.info("Processing dependencies for %s", requirement) try: distros = WorkingSet([]).resolve( [requirement], self.local_index, self.easy_install ) except DistributionNotFound as e: raise DistutilsError(str(e)) except VersionConflict as e: raise DistutilsError(e.report()) if self.always_copy or self.always_copy_from: # Force all the relevant distros to be copied or activated for dist in distros: if dist.key not in self.installed_projects: self.easy_install(dist.as_requirement()) log.info("Finished processing dependencies for %s", requirement) def should_unzip(self, dist): if self.zip_ok is not None: return not self.zip_ok if dist.has_metadata('not-zip-safe'): return True if not dist.has_metadata('zip-safe'): return True return False def maybe_move(self, spec, dist_filename, setup_base): dst = os.path.join(self.build_directory, spec.key) if os.path.exists(dst): msg = ("%r already exists in %s; build directory %s will not be " "kept") log.warn(msg, spec.key, self.build_directory, setup_base) return setup_base if os.path.isdir(dist_filename): setup_base = dist_filename else: if os.path.dirname(dist_filename) == setup_base: os.unlink(dist_filename) # get it out of the tmp dir contents = os.listdir(setup_base) if len(contents) == 1: dist_filename = os.path.join(setup_base, contents[0]) if os.path.isdir(dist_filename): # if the only thing there is a directory, move it instead setup_base = dist_filename ensure_directory(dst) shutil.move(setup_base, dst) return dst def install_wrapper_scripts(self, dist): if self.exclude_scripts: return for args in ScriptWriter.best().get_args(dist): self.write_script(*args) def install_script(self, dist, script_name, script_text, dev_path=None): """Generate a legacy script wrapper and install it""" spec = str(dist.as_requirement()) is_script = is_python_script(script_text, script_name) if is_script: body = self._load_template(dev_path) % locals() script_text = ScriptWriter.get_header(script_text) + body self.write_script(script_name, _to_ascii(script_text), 'b') @staticmethod def _load_template(dev_path): """ There are a couple of template scripts in the package. This function loads one of them and prepares it for use. """ # See https://github.com/pypa/setuptools/issues/134 for info # on script file naming and downstream issues with SVR4 name = 'script.tmpl' if dev_path: name = name.replace('.tmpl', ' (dev).tmpl') raw_bytes = resource_string('setuptools', name) return raw_bytes.decode('utf-8') def write_script(self, script_name, contents, mode="t", blockers=()): """Write an executable file to the scripts directory""" self.delete_blockers( # clean up old .py/.pyw w/o a script [os.path.join(self.script_dir, x) for x in blockers] ) log.info("Installing %s script to %s", script_name, self.script_dir) target = os.path.join(self.script_dir, script_name) self.add_output(target) mask = current_umask() if not self.dry_run: ensure_directory(target) if os.path.exists(target): os.unlink(target) with open(target, "w" + mode) as f: f.write(contents) chmod(target, 0o777 - mask) def install_eggs(self, spec, dist_filename, tmpdir): # .egg dirs or files are already built, so just return them if dist_filename.lower().endswith('.egg'): return [self.install_egg(dist_filename, tmpdir)] elif dist_filename.lower().endswith('.exe'): return [self.install_exe(dist_filename, tmpdir)] # Anything else, try to extract and build setup_base = tmpdir if os.path.isfile(dist_filename) and not dist_filename.endswith('.py'): unpack_archive(dist_filename, tmpdir, self.unpack_progress) elif os.path.isdir(dist_filename): setup_base = os.path.abspath(dist_filename) if (setup_base.startswith(tmpdir) # something we downloaded and self.build_directory and spec is not None): setup_base = self.maybe_move(spec, dist_filename, setup_base) # Find the setup.py file setup_script = os.path.join(setup_base, 'setup.py') if not os.path.exists(setup_script): setups = glob(os.path.join(setup_base, '*', 'setup.py')) if not setups: raise DistutilsError( "Couldn't find a setup script in %s" % os.path.abspath(dist_filename) ) if len(setups) > 1: raise DistutilsError( "Multiple setup scripts in %s" % os.path.abspath(dist_filename) ) setup_script = setups[0] # Now run it, and return the result if self.editable: log.info(self.report_editable(spec, setup_script)) return [] else: return self.build_and_install(setup_script, setup_base) def egg_distribution(self, egg_path): if os.path.isdir(egg_path): metadata = PathMetadata(egg_path, os.path.join(egg_path, 'EGG-INFO')) else: metadata = EggMetadata(zipimport.zipimporter(egg_path)) return Distribution.from_filename(egg_path, metadata=metadata) def install_egg(self, egg_path, tmpdir): destination = os.path.join(self.install_dir, os.path.basename(egg_path)) destination = os.path.abspath(destination) if not self.dry_run: ensure_directory(destination) dist = self.egg_distribution(egg_path) if not samefile(egg_path, destination): if os.path.isdir(destination) and not os.path.islink(destination): dir_util.remove_tree(destination, dry_run=self.dry_run) elif os.path.exists(destination): self.execute(os.unlink, (destination,), "Removing " + destination) try: new_dist_is_zipped = False if os.path.isdir(egg_path): if egg_path.startswith(tmpdir): f, m = shutil.move, "Moving" else: f, m = shutil.copytree, "Copying" elif self.should_unzip(dist): self.mkpath(destination) f, m = self.unpack_and_compile, "Extracting" else: new_dist_is_zipped = True if egg_path.startswith(tmpdir): f, m = shutil.move, "Moving" else: f, m = shutil.copy2, "Copying" self.execute(f, (egg_path, destination), (m + " %s to %s") % (os.path.basename(egg_path), os.path.dirname(destination))) update_dist_caches(destination, fix_zipimporter_caches=new_dist_is_zipped) except: update_dist_caches(destination, fix_zipimporter_caches=False) raise self.add_output(destination) return self.egg_distribution(destination) def install_exe(self, dist_filename, tmpdir): # See if it's valid, get data cfg = extract_wininst_cfg(dist_filename) if cfg is None: raise DistutilsError( "%s is not a valid distutils Windows .exe" % dist_filename ) # Create a dummy distribution object until we build the real distro dist = Distribution( None, project_name=cfg.get('metadata', 'name'), version=cfg.get('metadata', 'version'), platform=get_platform(), ) # Convert the .exe to an unpacked egg egg_path = dist.location = os.path.join(tmpdir, dist.egg_name() + '.egg') egg_tmp = egg_path + '.tmp' _egg_info = os.path.join(egg_tmp, 'EGG-INFO') pkg_inf = os.path.join(_egg_info, 'PKG-INFO') ensure_directory(pkg_inf) # make sure EGG-INFO dir exists dist._provider = PathMetadata(egg_tmp, _egg_info) # XXX self.exe_to_egg(dist_filename, egg_tmp) # Write EGG-INFO/PKG-INFO if not os.path.exists(pkg_inf): f = open(pkg_inf, 'w') f.write('Metadata-Version: 1.0\n') for k, v in cfg.items('metadata'): if k != 'target_version': f.write('%s: %s\n' % (k.replace('_', '-').title(), v)) f.close() script_dir = os.path.join(_egg_info, 'scripts') # delete entry-point scripts to avoid duping self.delete_blockers( [os.path.join(script_dir, args[0]) for args in ScriptWriter.get_args(dist)] ) # Build .egg file from tmpdir bdist_egg.make_zipfile( egg_path, egg_tmp, verbose=self.verbose, dry_run=self.dry_run ) # install the .egg return self.install_egg(egg_path, tmpdir) def exe_to_egg(self, dist_filename, egg_tmp): """Extract a bdist_wininst to the directories an egg would use""" # Check for .pth file and set up prefix translations prefixes = get_exe_prefixes(dist_filename) to_compile = [] native_libs = [] top_level = {} def process(src, dst): s = src.lower() for old, new in prefixes: if s.startswith(old): src = new + src[len(old):] parts = src.split('/') dst = os.path.join(egg_tmp, *parts) dl = dst.lower() if dl.endswith('.pyd') or dl.endswith('.dll'): parts[-1] = bdist_egg.strip_module(parts[-1]) top_level[os.path.splitext(parts[0])[0]] = 1 native_libs.append(src) elif dl.endswith('.py') and old != 'SCRIPTS/': top_level[os.path.splitext(parts[0])[0]] = 1 to_compile.append(dst) return dst if not src.endswith('.pth'): log.warn("WARNING: can't process %s", src) return None # extract, tracking .pyd/.dll->native_libs and .py -> to_compile unpack_archive(dist_filename, egg_tmp, process) stubs = [] for res in native_libs: if res.lower().endswith('.pyd'): # create stubs for .pyd's parts = res.split('/') resource = parts[-1] parts[-1] = bdist_egg.strip_module(parts[-1]) + '.py' pyfile = os.path.join(egg_tmp, *parts) to_compile.append(pyfile) stubs.append(pyfile) bdist_egg.write_stub(resource, pyfile) self.byte_compile(to_compile) # compile .py's bdist_egg.write_safety_flag( os.path.join(egg_tmp, 'EGG-INFO'), bdist_egg.analyze_egg(egg_tmp, stubs)) # write zip-safety flag for name in 'top_level', 'native_libs': if locals()[name]: txt = os.path.join(egg_tmp, 'EGG-INFO', name + '.txt') if not os.path.exists(txt): f = open(txt, 'w') f.write('\n'.join(locals()[name]) + '\n') f.close() __mv_warning = textwrap.dedent(""" Because this distribution was installed --multi-version, before you can import modules from this package in an application, you will need to 'import pkg_resources' and then use a 'require()' call similar to one of these examples, in order to select the desired version: pkg_resources.require("%(name)s") # latest installed version pkg_resources.require("%(name)s==%(version)s") # this exact version pkg_resources.require("%(name)s>=%(version)s") # this version or higher """).lstrip() __id_warning = textwrap.dedent(""" Note also that the installation directory must be on sys.path at runtime for this to work. (e.g. by being the application's script directory, by being on PYTHONPATH, or by being added to sys.path by your code.) """) def installation_report(self, req, dist, what="Installed"): """Helpful installation message for display to package users""" msg = "\n%(what)s %(eggloc)s%(extras)s" if self.multi_version and not self.no_report: msg += '\n' + self.__mv_warning if self.install_dir not in map(normalize_path, sys.path): msg += '\n' + self.__id_warning eggloc = dist.location name = dist.project_name version = dist.version extras = '' # TODO: self.report_extras(req, dist) return msg % locals() __editable_msg = textwrap.dedent(""" Extracted editable version of %(spec)s to %(dirname)s If it uses setuptools in its setup script, you can activate it in "development" mode by going to that directory and running:: %(python)s setup.py develop See the setuptools documentation for the "develop" command for more info. """).lstrip() def report_editable(self, spec, setup_script): dirname = os.path.dirname(setup_script) python = sys.executable return '\n' + self.__editable_msg % locals() def run_setup(self, setup_script, setup_base, args): sys.modules.setdefault('distutils.command.bdist_egg', bdist_egg) sys.modules.setdefault('distutils.command.egg_info', egg_info) args = list(args) if self.verbose > 2: v = 'v' * (self.verbose - 1) args.insert(0, '-' + v) elif self.verbose < 2: args.insert(0, '-q') if self.dry_run: args.insert(0, '-n') log.info( "Running %s %s", setup_script[len(setup_base) + 1:], ' '.join(args) ) try: run_setup(setup_script, args) except SystemExit as v: raise DistutilsError("Setup script exited with %s" % (v.args[0],)) def build_and_install(self, setup_script, setup_base): args = ['bdist_egg', '--dist-dir'] dist_dir = tempfile.mkdtemp( prefix='egg-dist-tmp-', dir=os.path.dirname(setup_script) ) try: self._set_fetcher_options(os.path.dirname(setup_script)) args.append(dist_dir) self.run_setup(setup_script, setup_base, args) all_eggs = Environment([dist_dir]) eggs = [] for key in all_eggs: for dist in all_eggs[key]: eggs.append(self.install_egg(dist.location, setup_base)) if not eggs and not self.dry_run: log.warn("No eggs found in %s (setup script problem?)", dist_dir) return eggs finally: rmtree(dist_dir) log.set_verbosity(self.verbose) # restore our log verbosity def _set_fetcher_options(self, base): """ When easy_install is about to run bdist_egg on a source dist, that source dist might have 'setup_requires' directives, requiring additional fetching. Ensure the fetcher options given to easy_install are available to that command as well. """ # find the fetch options from easy_install and write them out # to the setup.cfg file. ei_opts = self.distribution.get_option_dict('easy_install').copy() fetch_directives = ( 'find_links', 'site_dirs', 'index_url', 'optimize', 'site_dirs', 'allow_hosts', ) fetch_options = {} for key, val in ei_opts.items(): if key not in fetch_directives: continue fetch_options[key.replace('_', '-')] = val[1] # create a settings dictionary suitable for `edit_config` settings = dict(easy_install=fetch_options) cfg_filename = os.path.join(base, 'setup.cfg') setopt.edit_config(cfg_filename, settings) def update_pth(self, dist): if self.pth_file is None: return for d in self.pth_file[dist.key]: # drop old entries if self.multi_version or d.location != dist.location: log.info("Removing %s from easy-install.pth file", d) self.pth_file.remove(d) if d.location in self.shadow_path: self.shadow_path.remove(d.location) if not self.multi_version: if dist.location in self.pth_file.paths: log.info( "%s is already the active version in easy-install.pth", dist ) else: log.info("Adding %s to easy-install.pth file", dist) self.pth_file.add(dist) # add new entry if dist.location not in self.shadow_path: self.shadow_path.append(dist.location) if not self.dry_run: self.pth_file.save() if dist.key == 'setuptools': # Ensure that setuptools itself never becomes unavailable! # XXX should this check for latest version? filename = os.path.join(self.install_dir, 'setuptools.pth') if os.path.islink(filename): os.unlink(filename) f = open(filename, 'wt') f.write(self.pth_file.make_relative(dist.location) + '\n') f.close() def unpack_progress(self, src, dst): # Progress filter for unpacking log.debug("Unpacking %s to %s", src, dst) return dst # only unpack-and-compile skips files for dry run def unpack_and_compile(self, egg_path, destination): to_compile = [] to_chmod = [] def pf(src, dst): if dst.endswith('.py') and not src.startswith('EGG-INFO/'): to_compile.append(dst) elif dst.endswith('.dll') or dst.endswith('.so'): to_chmod.append(dst) self.unpack_progress(src, dst) return not self.dry_run and dst or None unpack_archive(egg_path, destination, pf) self.byte_compile(to_compile) if not self.dry_run: for f in to_chmod: mode = ((os.stat(f)[stat.ST_MODE]) | 0o555) & 0o7755 chmod(f, mode) def byte_compile(self, to_compile): if sys.dont_write_bytecode: self.warn('byte-compiling is disabled, skipping.') return from distutils.util import byte_compile try: # try to make the byte compile messages quieter log.set_verbosity(self.verbose - 1) byte_compile(to_compile, optimize=0, force=1, dry_run=self.dry_run) if self.optimize: byte_compile( to_compile, optimize=self.optimize, force=1, dry_run=self.dry_run ) finally: log.set_verbosity(self.verbose) # restore original verbosity __no_default_msg = textwrap.dedent(""" bad install directory or PYTHONPATH You are attempting to install a package to a directory that is not on PYTHONPATH and which Python does not read ".pth" files from. The installation directory you specified (via --install-dir, --prefix, or the distutils default setting) was: %s and your PYTHONPATH environment variable currently contains: %r Here are some of your options for correcting the problem: * You can choose a different installation directory, i.e., one that is on PYTHONPATH or supports .pth files * You can add the installation directory to the PYTHONPATH environment variable. (It must then also be on PYTHONPATH whenever you run Python and want to use the package(s) you are installing.) * You can set up the installation directory to support ".pth" files by using one of the approaches described here: https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations Please make the appropriate changes for your system and try again.""").lstrip() def no_default_version_msg(self): template = self.__no_default_msg return template % (self.install_dir, os.environ.get('PYTHONPATH', '')) def install_site_py(self): """Make sure there's a site.py in the target dir, if needed""" if self.sitepy_installed: return # already did it, or don't need to sitepy = os.path.join(self.install_dir, "site.py") source = resource_string("setuptools", "site-patch.py") source = source.decode('utf-8') current = "" if os.path.exists(sitepy): log.debug("Checking existing site.py in %s", self.install_dir) with io.open(sitepy) as strm: current = strm.read() if not current.startswith('def __boot():'): raise DistutilsError( "%s is not a setuptools-generated site.py; please" " remove it." % sitepy ) if current != source: log.info("Creating %s", sitepy) if not self.dry_run: ensure_directory(sitepy) with io.open(sitepy, 'w', encoding='utf-8') as strm: strm.write(source) self.byte_compile([sitepy]) self.sitepy_installed = True def create_home_path(self): """Create directories under ~.""" if not self.user: return home = convert_path(os.path.expanduser("~")) for name, path in six.iteritems(self.config_vars): if path.startswith(home) and not os.path.isdir(path): self.debug_print("os.makedirs('%s', 0o700)" % path) os.makedirs(path, 0o700) INSTALL_SCHEMES = dict( posix=dict( install_dir='$base/lib/python$py_version_short/site-packages', script_dir='$base/bin', ), ) DEFAULT_SCHEME = dict( install_dir='$base/Lib/site-packages', script_dir='$base/Scripts', ) def _expand(self, *attrs): config_vars = self.get_finalized_command('install').config_vars if self.prefix: # Set default install_dir/scripts from --prefix config_vars = config_vars.copy() config_vars['base'] = self.prefix scheme = self.INSTALL_SCHEMES.get(os.name, self.DEFAULT_SCHEME) for attr, val in scheme.items(): if getattr(self, attr, None) is None: setattr(self, attr, val) from distutils.util import subst_vars for attr in attrs: val = getattr(self, attr) if val is not None: val = subst_vars(val, config_vars) if os.name == 'posix': val = os.path.expanduser(val) setattr(self, attr, val) def get_site_dirs(): # return a list of 'site' dirs sitedirs = [_f for _f in os.environ.get('PYTHONPATH', '').split(os.pathsep) if _f] prefixes = [sys.prefix] if sys.exec_prefix != sys.prefix: prefixes.append(sys.exec_prefix) for prefix in prefixes: if prefix: if sys.platform in ('os2emx', 'riscos'): sitedirs.append(os.path.join(prefix, "Lib", "site-packages")) elif os.sep == '/': sitedirs.extend([os.path.join(prefix, "lib", "python" + sys.version[:3], "site-packages"), os.path.join(prefix, "lib", "site-python")]) else: sitedirs.extend( [prefix, os.path.join(prefix, "lib", "site-packages")] ) if sys.platform == 'darwin': # for framework builds *only* we add the standard Apple # locations. Currently only per-user, but /Library and # /Network/Library could be added too if 'Python.framework' in prefix: home = os.environ.get('HOME') if home: sitedirs.append( os.path.join(home, 'Library', 'Python', sys.version[:3], 'site-packages')) lib_paths = get_path('purelib'), get_path('platlib') for site_lib in lib_paths: if site_lib not in sitedirs: sitedirs.append(site_lib) if site.ENABLE_USER_SITE: sitedirs.append(site.USER_SITE) sitedirs = list(map(normalize_path, sitedirs)) return sitedirs def expand_paths(inputs): """Yield sys.path directories that might contain "old-style" packages""" seen = {} for dirname in inputs: dirname = normalize_path(dirname) if dirname in seen: continue seen[dirname] = 1 if not os.path.isdir(dirname): continue files = os.listdir(dirname) yield dirname, files for name in files: if not name.endswith('.pth'): # We only care about the .pth files continue if name in ('easy-install.pth', 'setuptools.pth'): # Ignore .pth files that we control continue # Read the .pth file f = open(os.path.join(dirname, name)) lines = list(yield_lines(f)) f.close() # Yield existing non-dupe, non-import directory lines from it for line in lines: if not line.startswith("import"): line = normalize_path(line.rstrip()) if line not in seen: seen[line] = 1 if not os.path.isdir(line): continue yield line, os.listdir(line) def extract_wininst_cfg(dist_filename): """Extract configuration data from a bdist_wininst .exe Returns a configparser.RawConfigParser, or None """ f = open(dist_filename, 'rb') try: endrec = zipfile._EndRecData(f) if endrec is None: return None prepended = (endrec[9] - endrec[5]) - endrec[6] if prepended < 12: # no wininst data here return None f.seek(prepended - 12) tag, cfglen, bmlen = struct.unpack("egg path translations for a given .exe file""" prefixes = [ ('PURELIB/', ''), ('PLATLIB/pywin32_system32', ''), ('PLATLIB/', ''), ('SCRIPTS/', 'EGG-INFO/scripts/'), ('DATA/lib/site-packages', ''), ] z = zipfile.ZipFile(exe_filename) try: for info in z.infolist(): name = info.filename parts = name.split('/') if len(parts) == 3 and parts[2] == 'PKG-INFO': if parts[1].endswith('.egg-info'): prefixes.insert(0, ('/'.join(parts[:2]), 'EGG-INFO/')) break if len(parts) != 2 or not name.endswith('.pth'): continue if name.endswith('-nspkg.pth'): continue if parts[0].upper() in ('PURELIB', 'PLATLIB'): contents = z.read(name) if six.PY3: contents = contents.decode() for pth in yield_lines(contents): pth = pth.strip().replace('\\', '/') if not pth.startswith('import'): prefixes.append((('%s/%s/' % (parts[0], pth)), '')) finally: z.close() prefixes = [(x.lower(), y) for x, y in prefixes] prefixes.sort() prefixes.reverse() return prefixes def parse_requirement_arg(spec): try: return Requirement.parse(spec) except ValueError: raise DistutilsError( "Not a URL, existing file, or requirement spec: %r" % (spec,) ) class PthDistributions(Environment): """A .pth file with Distribution paths in it""" dirty = False def __init__(self, filename, sitedirs=()): self.filename = filename self.sitedirs = list(map(normalize_path, sitedirs)) self.basedir = normalize_path(os.path.dirname(self.filename)) self._load() Environment.__init__(self, [], None, None) for path in yield_lines(self.paths): list(map(self.add, find_distributions(path, True))) def _load(self): self.paths = [] saw_import = False seen = dict.fromkeys(self.sitedirs) if os.path.isfile(self.filename): f = open(self.filename, 'rt') for line in f: if line.startswith('import'): saw_import = True continue path = line.rstrip() self.paths.append(path) if not path.strip() or path.strip().startswith('#'): continue # skip non-existent paths, in case somebody deleted a package # manually, and duplicate paths as well path = self.paths[-1] = normalize_path( os.path.join(self.basedir, path) ) if not os.path.exists(path) or path in seen: self.paths.pop() # skip it self.dirty = True # we cleaned up, so we're dirty now :) continue seen[path] = 1 f.close() if self.paths and not saw_import: self.dirty = True # ensure anything we touch has import wrappers while self.paths and not self.paths[-1].strip(): self.paths.pop() def save(self): """Write changed .pth file back to disk""" if not self.dirty: return rel_paths = list(map(self.make_relative, self.paths)) if rel_paths: log.debug("Saving %s", self.filename) lines = self._wrap_lines(rel_paths) data = '\n'.join(lines) + '\n' if os.path.islink(self.filename): os.unlink(self.filename) with open(self.filename, 'wt') as f: f.write(data) elif os.path.exists(self.filename): log.debug("Deleting empty %s", self.filename) os.unlink(self.filename) self.dirty = False @staticmethod def _wrap_lines(lines): return lines def add(self, dist): """Add `dist` to the distribution map""" new_path = ( dist.location not in self.paths and ( dist.location not in self.sitedirs or # account for '.' being in PYTHONPATH dist.location == os.getcwd() ) ) if new_path: self.paths.append(dist.location) self.dirty = True Environment.add(self, dist) def remove(self, dist): """Remove `dist` from the distribution map""" while dist.location in self.paths: self.paths.remove(dist.location) self.dirty = True Environment.remove(self, dist) def make_relative(self, path): npath, last = os.path.split(normalize_path(path)) baselen = len(self.basedir) parts = [last] sep = os.altsep == '/' and '/' or os.sep while len(npath) >= baselen: if npath == self.basedir: parts.append(os.curdir) parts.reverse() return sep.join(parts) npath, last = os.path.split(npath) parts.append(last) else: return path class RewritePthDistributions(PthDistributions): @classmethod def _wrap_lines(cls, lines): yield cls.prelude for line in lines: yield line yield cls.postlude _inline = lambda text: textwrap.dedent(text).strip().replace('\n', '; ') prelude = _inline(""" import sys sys.__plen = len(sys.path) """) postlude = _inline(""" import sys new = sys.path[sys.__plen:] del sys.path[sys.__plen:] p = getattr(sys, '__egginsert', 0) sys.path[p:p] = new sys.__egginsert = p + len(new) """) if os.environ.get('SETUPTOOLS_SYS_PATH_TECHNIQUE', 'rewrite') == 'rewrite': PthDistributions = RewritePthDistributions def _first_line_re(): """ Return a regular expression based on first_line_re suitable for matching strings. """ if isinstance(first_line_re.pattern, str): return first_line_re # first_line_re in Python >=3.1.4 and >=3.2.1 is a bytes pattern. return re.compile(first_line_re.pattern.decode()) def auto_chmod(func, arg, exc): if func is os.remove and os.name == 'nt': chmod(arg, stat.S_IWRITE) return func(arg) et, ev, _ = sys.exc_info() six.reraise(et, (ev[0], ev[1] + (" %s %s" % (func, arg)))) def update_dist_caches(dist_path, fix_zipimporter_caches): """ Fix any globally cached `dist_path` related data `dist_path` should be a path of a newly installed egg distribution (zipped or unzipped). sys.path_importer_cache contains finder objects that have been cached when importing data from the original distribution. Any such finders need to be cleared since the replacement distribution might be packaged differently, e.g. a zipped egg distribution might get replaced with an unzipped egg folder or vice versa. Having the old finders cached may then cause Python to attempt loading modules from the replacement distribution using an incorrect loader. zipimport.zipimporter objects are Python loaders charged with importing data packaged inside zip archives. If stale loaders referencing the original distribution, are left behind, they can fail to load modules from the replacement distribution. E.g. if an old zipimport.zipimporter instance is used to load data from a new zipped egg archive, it may cause the operation to attempt to locate the requested data in the wrong location - one indicated by the original distribution's zip archive directory information. Such an operation may then fail outright, e.g. report having read a 'bad local file header', or even worse, it may fail silently & return invalid data. zipimport._zip_directory_cache contains cached zip archive directory information for all existing zipimport.zipimporter instances and all such instances connected to the same archive share the same cached directory information. If asked, and the underlying Python implementation allows it, we can fix all existing zipimport.zipimporter instances instead of having to track them down and remove them one by one, by updating their shared cached zip archive directory information. This, of course, assumes that the replacement distribution is packaged as a zipped egg. If not asked to fix existing zipimport.zipimporter instances, we still do our best to clear any remaining zipimport.zipimporter related cached data that might somehow later get used when attempting to load data from the new distribution and thus cause such load operations to fail. Note that when tracking down such remaining stale data, we can not catch every conceivable usage from here, and we clear only those that we know of and have found to cause problems if left alive. Any remaining caches should be updated by whomever is in charge of maintaining them, i.e. they should be ready to handle us replacing their zip archives with new distributions at runtime. """ # There are several other known sources of stale zipimport.zipimporter # instances that we do not clear here, but might if ever given a reason to # do so: # * Global setuptools pkg_resources.working_set (a.k.a. 'master working # set') may contain distributions which may in turn contain their # zipimport.zipimporter loaders. # * Several zipimport.zipimporter loaders held by local variables further # up the function call stack when running the setuptools installation. # * Already loaded modules may have their __loader__ attribute set to the # exact loader instance used when importing them. Python 3.4 docs state # that this information is intended mostly for introspection and so is # not expected to cause us problems. normalized_path = normalize_path(dist_path) _uncache(normalized_path, sys.path_importer_cache) if fix_zipimporter_caches: _replace_zip_directory_cache_data(normalized_path) else: # Here, even though we do not want to fix existing and now stale # zipimporter cache information, we still want to remove it. Related to # Python's zip archive directory information cache, we clear each of # its stale entries in two phases: # 1. Clear the entry so attempting to access zip archive information # via any existing stale zipimport.zipimporter instances fails. # 2. Remove the entry from the cache so any newly constructed # zipimport.zipimporter instances do not end up using old stale # zip archive directory information. # This whole stale data removal step does not seem strictly necessary, # but has been left in because it was done before we started replacing # the zip archive directory information cache content if possible, and # there are no relevant unit tests that we can depend on to tell us if # this is really needed. _remove_and_clear_zip_directory_cache_data(normalized_path) def _collect_zipimporter_cache_entries(normalized_path, cache): """ Return zipimporter cache entry keys related to a given normalized path. Alternative path spellings (e.g. those using different character case or those using alternative path separators) related to the same path are included. Any sub-path entries are included as well, i.e. those corresponding to zip archives embedded in other zip archives. """ result = [] prefix_len = len(normalized_path) for p in cache: np = normalize_path(p) if (np.startswith(normalized_path) and np[prefix_len:prefix_len + 1] in (os.sep, '')): result.append(p) return result def _update_zipimporter_cache(normalized_path, cache, updater=None): """ Update zipimporter cache data for a given normalized path. Any sub-path entries are processed as well, i.e. those corresponding to zip archives embedded in other zip archives. Given updater is a callable taking a cache entry key and the original entry (after already removing the entry from the cache), and expected to update the entry and possibly return a new one to be inserted in its place. Returning None indicates that the entry should not be replaced with a new one. If no updater is given, the cache entries are simply removed without any additional processing, the same as if the updater simply returned None. """ for p in _collect_zipimporter_cache_entries(normalized_path, cache): # N.B. pypy's custom zipimport._zip_directory_cache implementation does # not support the complete dict interface: # * Does not support item assignment, thus not allowing this function # to be used only for removing existing cache entries. # * Does not support the dict.pop() method, forcing us to use the # get/del patterns instead. For more detailed information see the # following links: # https://github.com/pypa/setuptools/issues/202#issuecomment-202913420 # https://bitbucket.org/pypy/pypy/src/dd07756a34a41f674c0cacfbc8ae1d4cc9ea2ae4/pypy/module/zipimport/interp_zipimport.py#cl-99 old_entry = cache[p] del cache[p] new_entry = updater and updater(p, old_entry) if new_entry is not None: cache[p] = new_entry def _uncache(normalized_path, cache): _update_zipimporter_cache(normalized_path, cache) def _remove_and_clear_zip_directory_cache_data(normalized_path): def clear_and_remove_cached_zip_archive_directory_data(path, old_entry): old_entry.clear() _update_zipimporter_cache( normalized_path, zipimport._zip_directory_cache, updater=clear_and_remove_cached_zip_archive_directory_data) # PyPy Python implementation does not allow directly writing to the # zipimport._zip_directory_cache and so prevents us from attempting to correct # its content. The best we can do there is clear the problematic cache content # and have PyPy repopulate it as needed. The downside is that if there are any # stale zipimport.zipimporter instances laying around, attempting to use them # will fail due to not having its zip archive directory information available # instead of being automatically corrected to use the new correct zip archive # directory information. if '__pypy__' in sys.builtin_module_names: _replace_zip_directory_cache_data = \ _remove_and_clear_zip_directory_cache_data else: def _replace_zip_directory_cache_data(normalized_path): def replace_cached_zip_archive_directory_data(path, old_entry): # N.B. In theory, we could load the zip directory information just # once for all updated path spellings, and then copy it locally and # update its contained path strings to contain the correct # spelling, but that seems like a way too invasive move (this cache # structure is not officially documented anywhere and could in # theory change with new Python releases) for no significant # benefit. old_entry.clear() zipimport.zipimporter(path) old_entry.update(zipimport._zip_directory_cache[path]) return old_entry _update_zipimporter_cache( normalized_path, zipimport._zip_directory_cache, updater=replace_cached_zip_archive_directory_data) def is_python(text, filename=''): "Is this string a valid Python script?" try: compile(text, filename, 'exec') except (SyntaxError, TypeError): return False else: return True def is_sh(executable): """Determine if the specified executable is a .sh (contains a #! line)""" try: with io.open(executable, encoding='latin-1') as fp: magic = fp.read(2) except (OSError, IOError): return executable return magic == '#!' def nt_quote_arg(arg): """Quote a command line argument according to Windows parsing rules""" return subprocess.list2cmdline([arg]) def is_python_script(script_text, filename): """Is this text, as a whole, a Python script? (as opposed to shell/bat/etc. """ if filename.endswith('.py') or filename.endswith('.pyw'): return True # extension says it's Python if is_python(script_text, filename): return True # it's syntactically valid Python if script_text.startswith('#!'): # It begins with a '#!' line, so check if 'python' is in it somewhere return 'python' in script_text.splitlines()[0].lower() return False # Not any Python I can recognize try: from os import chmod as _chmod except ImportError: # Jython compatibility def _chmod(*args): pass def chmod(path, mode): log.debug("changing mode of %s to %o", path, mode) try: _chmod(path, mode) except os.error as e: log.debug("chmod failed: %s", e) class CommandSpec(list): """ A command spec for a #! header, specified as a list of arguments akin to those passed to Popen. """ options = [] split_args = dict() @classmethod def best(cls): """ Choose the best CommandSpec class based on environmental conditions. """ return cls @classmethod def _sys_executable(cls): _default = os.path.normpath(sys.executable) return os.environ.get('__PYVENV_LAUNCHER__', _default) @classmethod def from_param(cls, param): """ Construct a CommandSpec from a parameter to build_scripts, which may be None. """ if isinstance(param, cls): return param if isinstance(param, list): return cls(param) if param is None: return cls.from_environment() # otherwise, assume it's a string. return cls.from_string(param) @classmethod def from_environment(cls): return cls([cls._sys_executable()]) @classmethod def from_string(cls, string): """ Construct a command spec from a simple string representing a command line parseable by shlex.split. """ items = shlex.split(string, **cls.split_args) return cls(items) def install_options(self, script_text): self.options = shlex.split(self._extract_options(script_text)) cmdline = subprocess.list2cmdline(self) if not isascii(cmdline): self.options[:0] = ['-x'] @staticmethod def _extract_options(orig_script): """ Extract any options from the first line of the script. """ first = (orig_script + '\n').splitlines()[0] match = _first_line_re().match(first) options = match.group(1) or '' if match else '' return options.strip() def as_header(self): return self._render(self + list(self.options)) @staticmethod def _render(items): cmdline = subprocess.list2cmdline(items) return '#!' + cmdline + '\n' # For pbr compat; will be removed in a future version. sys_executable = CommandSpec._sys_executable() class WindowsCommandSpec(CommandSpec): split_args = dict(posix=False) class ScriptWriter(object): """ Encapsulates behavior around writing entry point scripts for console and gui apps. """ template = textwrap.dedent(""" # EASY-INSTALL-ENTRY-SCRIPT: %(spec)r,%(group)r,%(name)r __requires__ = %(spec)r import sys from pkg_resources import load_entry_point if __name__ == '__main__': sys.exit( load_entry_point(%(spec)r, %(group)r, %(name)r)() ) """).lstrip() command_spec_class = CommandSpec @classmethod def get_script_args(cls, dist, executable=None, wininst=False): # for backward compatibility warnings.warn("Use get_args", DeprecationWarning) writer = (WindowsScriptWriter if wininst else ScriptWriter).best() header = cls.get_script_header("", executable, wininst) return writer.get_args(dist, header) @classmethod def get_script_header(cls, script_text, executable=None, wininst=False): # for backward compatibility warnings.warn("Use get_header", DeprecationWarning) if wininst: executable = "python.exe" cmd = cls.command_spec_class.best().from_param(executable) cmd.install_options(script_text) return cmd.as_header() @classmethod def get_args(cls, dist, header=None): """ Yield write_script() argument tuples for a distribution's console_scripts and gui_scripts entry points. """ if header is None: header = cls.get_header() spec = str(dist.as_requirement()) for type_ in 'console', 'gui': group = type_ + '_scripts' for name, ep in dist.get_entry_map(group).items(): cls._ensure_safe_name(name) script_text = cls.template % locals() args = cls._get_script_args(type_, name, header, script_text) for res in args: yield res @staticmethod def _ensure_safe_name(name): """ Prevent paths in *_scripts entry point names. """ has_path_sep = re.search(r'[\\/]', name) if has_path_sep: raise ValueError("Path separators not allowed in script names") @classmethod def get_writer(cls, force_windows): # for backward compatibility warnings.warn("Use best", DeprecationWarning) return WindowsScriptWriter.best() if force_windows else cls.best() @classmethod def best(cls): """ Select the best ScriptWriter for this environment. """ if sys.platform == 'win32' or (os.name == 'java' and os._name == 'nt'): return WindowsScriptWriter.best() else: return cls @classmethod def _get_script_args(cls, type_, name, header, script_text): # Simply write the stub with no extension. yield (name, header + script_text) @classmethod def get_header(cls, script_text="", executable=None): """Create a #! line, getting options (if any) from script_text""" cmd = cls.command_spec_class.best().from_param(executable) cmd.install_options(script_text) return cmd.as_header() class WindowsScriptWriter(ScriptWriter): command_spec_class = WindowsCommandSpec @classmethod def get_writer(cls): # for backward compatibility warnings.warn("Use best", DeprecationWarning) return cls.best() @classmethod def best(cls): """ Select the best ScriptWriter suitable for Windows """ writer_lookup = dict( executable=WindowsExecutableLauncherWriter, natural=cls, ) # for compatibility, use the executable launcher by default launcher = os.environ.get('SETUPTOOLS_LAUNCHER', 'executable') return writer_lookup[launcher] @classmethod def _get_script_args(cls, type_, name, header, script_text): "For Windows, add a .py extension" ext = dict(console='.pya', gui='.pyw')[type_] if ext not in os.environ['PATHEXT'].lower().split(';'): warnings.warn("%s not listed in PATHEXT; scripts will not be " "recognized as executables." % ext, UserWarning) old = ['.pya', '.py', '-script.py', '.pyc', '.pyo', '.pyw', '.exe'] old.remove(ext) header = cls._adjust_header(type_, header) blockers = [name + x for x in old] yield name + ext, header + script_text, 't', blockers @classmethod def _adjust_header(cls, type_, orig_header): """ Make sure 'pythonw' is used for gui and and 'python' is used for console (regardless of what sys.executable is). """ pattern = 'pythonw.exe' repl = 'python.exe' if type_ == 'gui': pattern, repl = repl, pattern pattern_ob = re.compile(re.escape(pattern), re.IGNORECASE) new_header = pattern_ob.sub(string=orig_header, repl=repl) return new_header if cls._use_header(new_header) else orig_header @staticmethod def _use_header(new_header): """ Should _adjust_header use the replaced header? On non-windows systems, always use. On Windows systems, only use the replaced header if it resolves to an executable on the system. """ clean_header = new_header[2:-1].strip('"') return sys.platform != 'win32' or find_executable(clean_header) class WindowsExecutableLauncherWriter(WindowsScriptWriter): @classmethod def _get_script_args(cls, type_, name, header, script_text): """ For Windows, add a .py extension and an .exe launcher """ if type_ == 'gui': launcher_type = 'gui' ext = '-script.pyw' old = ['.pyw'] else: launcher_type = 'cli' ext = '-script.py' old = ['.py', '.pyc', '.pyo'] hdr = cls._adjust_header(type_, header) blockers = [name + x for x in old] yield (name + ext, hdr + script_text, 't', blockers) yield ( name + '.exe', get_win_launcher(launcher_type), 'b' # write in binary mode ) if not is_64bit(): # install a manifest for the launcher to prevent Windows # from detecting it as an installer (which it will for # launchers like easy_install.exe). Consider only # adding a manifest for launchers detected as installers. # See Distribute #143 for details. m_name = name + '.exe.manifest' yield (m_name, load_launcher_manifest(name), 't') # for backward-compatibility get_script_args = ScriptWriter.get_script_args get_script_header = ScriptWriter.get_script_header def get_win_launcher(type): """ Load the Windows launcher (executable) suitable for launching a script. `type` should be either 'cli' or 'gui' Returns the executable as a byte string. """ launcher_fn = '%s.exe' % type if platform.machine().lower() == 'arm': launcher_fn = launcher_fn.replace(".", "-arm.") if is_64bit(): launcher_fn = launcher_fn.replace(".", "-64.") else: launcher_fn = launcher_fn.replace(".", "-32.") return resource_string('setuptools', launcher_fn) def load_launcher_manifest(name): manifest = pkg_resources.resource_string(__name__, 'launcher manifest.xml') if six.PY2: return manifest % vars() else: return manifest.decode('utf-8') % vars() def rmtree(path, ignore_errors=False, onerror=auto_chmod): """Recursively delete a directory tree. This code is taken from the Python 2.4 version of 'shutil', because the 2.3 version doesn't really work right. """ if ignore_errors: def onerror(*args): pass elif onerror is None: def onerror(*args): raise names = [] try: names = os.listdir(path) except os.error: onerror(os.listdir, path, sys.exc_info()) for name in names: fullname = os.path.join(path, name) try: mode = os.lstat(fullname).st_mode except os.error: mode = 0 if stat.S_ISDIR(mode): rmtree(fullname, ignore_errors, onerror) else: try: os.remove(fullname) except os.error: onerror(os.remove, fullname, sys.exc_info()) try: os.rmdir(path) except os.error: onerror(os.rmdir, path, sys.exc_info()) def current_umask(): tmp = os.umask(0o022) os.umask(tmp) return tmp def bootstrap(): # This function is called when setuptools*.egg is run using /bin/sh import setuptools argv0 = os.path.dirname(setuptools.__path__[0]) sys.argv[0] = argv0 sys.argv.append(argv0) main() def main(argv=None, **kw): from setuptools import setup from setuptools.dist import Distribution class DistributionWithoutHelpCommands(Distribution): common_usage = "" def _show_help(self, *args, **kw): with _patch_usage(): Distribution._show_help(self, *args, **kw) if argv is None: argv = sys.argv[1:] with _patch_usage(): setup( script_args=['-q', 'easy_install', '-v'] + argv, script_name=sys.argv[0] or 'easy_install', distclass=DistributionWithoutHelpCommands, **kw ) @contextlib.contextmanager def _patch_usage(): import distutils.core USAGE = textwrap.dedent(""" usage: %(script)s [options] requirement_or_url ... or: %(script)s --help """).lstrip() def gen_usage(script_name): return USAGE % dict( script=os.path.basename(script_name), ) saved = distutils.core.gen_usage distutils.core.gen_usage = gen_usage try: yield finally: distutils.core.gen_usage = saved setuptools-20.7.0/setuptools/command/egg_info.py0000775000175000017500000004077212702524020022662 0ustar travistravis00000000000000"""setuptools.command.egg_info Create a distribution's .egg-info directory and contents""" from distutils.filelist import FileList as _FileList from distutils.util import convert_path from distutils import log import distutils.errors import distutils.filelist import os import re import sys import io import warnings import time from setuptools.extern import six from setuptools.extern.six.moves import map from setuptools import Command from setuptools.command.sdist import sdist from setuptools.command.sdist import walk_revctrl from setuptools.command.setopt import edit_config from setuptools.command import bdist_egg from pkg_resources import ( parse_requirements, safe_name, parse_version, safe_version, yield_lines, EntryPoint, iter_entry_points, to_filename) import setuptools.unicode_utils as unicode_utils from pkg_resources.extern import packaging try: from setuptools_svn import svn_utils except ImportError: pass class egg_info(Command): description = "create a distribution's .egg-info directory" user_options = [ ('egg-base=', 'e', "directory containing .egg-info directories" " (default: top of the source tree)"), ('tag-svn-revision', 'r', "Add subversion revision ID to version number"), ('tag-date', 'd', "Add date stamp (e.g. 20050528) to version number"), ('tag-build=', 'b', "Specify explicit tag to add to version number"), ('no-svn-revision', 'R', "Don't add subversion revision ID [default]"), ('no-date', 'D', "Don't include date stamp [default]"), ] boolean_options = ['tag-date', 'tag-svn-revision'] negative_opt = {'no-svn-revision': 'tag-svn-revision', 'no-date': 'tag-date'} def initialize_options(self): self.egg_name = None self.egg_version = None self.egg_base = None self.egg_info = None self.tag_build = None self.tag_svn_revision = 0 self.tag_date = 0 self.broken_egg_info = False self.vtags = None def save_version_info(self, filename): values = dict( egg_info=dict( tag_svn_revision=0, tag_date=0, tag_build=self.tags(), ) ) edit_config(filename, values) def finalize_options(self): self.egg_name = safe_name(self.distribution.get_name()) self.vtags = self.tags() self.egg_version = self.tagged_version() parsed_version = parse_version(self.egg_version) try: is_version = isinstance(parsed_version, packaging.version.Version) spec = ( "%s==%s" if is_version else "%s===%s" ) list( parse_requirements(spec % (self.egg_name, self.egg_version)) ) except ValueError: raise distutils.errors.DistutilsOptionError( "Invalid distribution name or version syntax: %s-%s" % (self.egg_name, self.egg_version) ) if self.egg_base is None: dirs = self.distribution.package_dir self.egg_base = (dirs or {}).get('', os.curdir) self.ensure_dirname('egg_base') self.egg_info = to_filename(self.egg_name) + '.egg-info' if self.egg_base != os.curdir: self.egg_info = os.path.join(self.egg_base, self.egg_info) if '-' in self.egg_name: self.check_broken_egg_info() # Set package version for the benefit of dumber commands # (e.g. sdist, bdist_wininst, etc.) # self.distribution.metadata.version = self.egg_version # If we bootstrapped around the lack of a PKG-INFO, as might be the # case in a fresh checkout, make sure that any special tags get added # to the version info # pd = self.distribution._patched_dist if pd is not None and pd.key == self.egg_name.lower(): pd._version = self.egg_version pd._parsed_version = parse_version(self.egg_version) self.distribution._patched_dist = None def write_or_delete_file(self, what, filename, data, force=False): """Write `data` to `filename` or delete if empty If `data` is non-empty, this routine is the same as ``write_file()``. If `data` is empty but not ``None``, this is the same as calling ``delete_file(filename)`. If `data` is ``None``, then this is a no-op unless `filename` exists, in which case a warning is issued about the orphaned file (if `force` is false), or deleted (if `force` is true). """ if data: self.write_file(what, filename, data) elif os.path.exists(filename): if data is None and not force: log.warn( "%s not set in setup(), but %s exists", what, filename ) return else: self.delete_file(filename) def write_file(self, what, filename, data): """Write `data` to `filename` (if not a dry run) after announcing it `what` is used in a log message to identify what is being written to the file. """ log.info("writing %s to %s", what, filename) if six.PY3: data = data.encode("utf-8") if not self.dry_run: f = open(filename, 'wb') f.write(data) f.close() def delete_file(self, filename): """Delete `filename` (if not a dry run) after announcing it""" log.info("deleting %s", filename) if not self.dry_run: os.unlink(filename) def tagged_version(self): version = self.distribution.get_version() # egg_info may be called more than once for a distribution, # in which case the version string already contains all tags. if self.vtags and version.endswith(self.vtags): return safe_version(version) return safe_version(version + self.vtags) def run(self): self.mkpath(self.egg_info) installer = self.distribution.fetch_build_egg for ep in iter_entry_points('egg_info.writers'): ep.require(installer=installer) writer = ep.resolve() writer(self, ep.name, os.path.join(self.egg_info, ep.name)) # Get rid of native_libs.txt if it was put there by older bdist_egg nl = os.path.join(self.egg_info, "native_libs.txt") if os.path.exists(nl): self.delete_file(nl) self.find_sources() def tags(self): version = '' if self.tag_build: version += self.tag_build if self.tag_svn_revision: version += '-r%s' % self.get_svn_revision() if self.tag_date: version += time.strftime("-%Y%m%d") return version @staticmethod def get_svn_revision(): if 'svn_utils' not in globals(): return "0" return str(svn_utils.SvnInfo.load(os.curdir).get_revision()) def find_sources(self): """Generate SOURCES.txt manifest file""" manifest_filename = os.path.join(self.egg_info, "SOURCES.txt") mm = manifest_maker(self.distribution) mm.manifest = manifest_filename mm.run() self.filelist = mm.filelist def check_broken_egg_info(self): bei = self.egg_name + '.egg-info' if self.egg_base != os.curdir: bei = os.path.join(self.egg_base, bei) if os.path.exists(bei): log.warn( "-" * 78 + '\n' "Note: Your current .egg-info directory has a '-' in its name;" '\nthis will not work correctly with "setup.py develop".\n\n' 'Please rename %s to %s to correct this problem.\n' + '-' * 78, bei, self.egg_info ) self.broken_egg_info = self.egg_info self.egg_info = bei # make it work for now class FileList(_FileList): """File list that accepts only existing, platform-independent paths""" def append(self, item): if item.endswith('\r'): # Fix older sdists built on Windows item = item[:-1] path = convert_path(item) if self._safe_path(path): self.files.append(path) def extend(self, paths): self.files.extend(filter(self._safe_path, paths)) def _repair(self): """ Replace self.files with only safe paths Because some owners of FileList manipulate the underlying ``files`` attribute directly, this method must be called to repair those paths. """ self.files = list(filter(self._safe_path, self.files)) def _safe_path(self, path): enc_warn = "'%s' not %s encodable -- skipping" # To avoid accidental trans-codings errors, first to unicode u_path = unicode_utils.filesys_decode(path) if u_path is None: log.warn("'%s' in unexpected encoding -- skipping" % path) return False # Must ensure utf-8 encodability utf8_path = unicode_utils.try_encode(u_path, "utf-8") if utf8_path is None: log.warn(enc_warn, path, 'utf-8') return False try: # accept is either way checks out if os.path.exists(u_path) or os.path.exists(utf8_path): return True # this will catch any encode errors decoding u_path except UnicodeEncodeError: log.warn(enc_warn, path, sys.getfilesystemencoding()) class manifest_maker(sdist): template = "MANIFEST.in" def initialize_options(self): self.use_defaults = 1 self.prune = 1 self.manifest_only = 1 self.force_manifest = 1 def finalize_options(self): pass def run(self): self.filelist = FileList() if not os.path.exists(self.manifest): self.write_manifest() # it must exist so it'll get in the list self.filelist.findall() self.add_defaults() if os.path.exists(self.template): self.read_template() self.prune_file_list() self.filelist.sort() self.filelist.remove_duplicates() self.write_manifest() def _manifest_normalize(self, path): path = unicode_utils.filesys_decode(path) return path.replace(os.sep, '/') def write_manifest(self): """ Write the file list in 'self.filelist' to the manifest file named by 'self.manifest'. """ self.filelist._repair() # Now _repairs should encodability, but not unicode files = [self._manifest_normalize(f) for f in self.filelist.files] msg = "writing manifest file '%s'" % self.manifest self.execute(write_file, (self.manifest, files), msg) def warn(self, msg): # suppress missing-file warnings from sdist if not msg.startswith("standard file not found:"): sdist.warn(self, msg) def add_defaults(self): sdist.add_defaults(self) self.filelist.append(self.template) self.filelist.append(self.manifest) rcfiles = list(walk_revctrl()) if rcfiles: self.filelist.extend(rcfiles) elif os.path.exists(self.manifest): self.read_manifest() ei_cmd = self.get_finalized_command('egg_info') self._add_egg_info(cmd=ei_cmd) self.filelist.include_pattern("*", prefix=ei_cmd.egg_info) def _add_egg_info(self, cmd): """ Add paths for egg-info files for an external egg-base. The egg-info files are written to egg-base. If egg-base is outside the current working directory, this method searchs the egg-base directory for files to include in the manifest. Uses distutils.filelist.findall (which is really the version monkeypatched in by setuptools/__init__.py) to perform the search. Since findall records relative paths, prefix the returned paths with cmd.egg_base, so add_default's include_pattern call (which is looking for the absolute cmd.egg_info) will match them. """ if cmd.egg_base == os.curdir: # egg-info files were already added by something else return discovered = distutils.filelist.findall(cmd.egg_base) resolved = (os.path.join(cmd.egg_base, path) for path in discovered) self.filelist.allfiles.extend(resolved) def prune_file_list(self): build = self.get_finalized_command('build') base_dir = self.distribution.get_fullname() self.filelist.exclude_pattern(None, prefix=build.build_base) self.filelist.exclude_pattern(None, prefix=base_dir) sep = re.escape(os.sep) self.filelist.exclude_pattern(r'(^|' + sep + r')(RCS|CVS|\.svn)' + sep, is_regex=1) def write_file(filename, contents): """Create a file with the specified name and write 'contents' (a sequence of strings without line terminators) to it. """ contents = "\n".join(contents) # assuming the contents has been vetted for utf-8 encoding contents = contents.encode("utf-8") with open(filename, "wb") as f: # always write POSIX-style manifest f.write(contents) def write_pkg_info(cmd, basename, filename): log.info("writing %s", filename) if not cmd.dry_run: metadata = cmd.distribution.metadata metadata.version, oldver = cmd.egg_version, metadata.version metadata.name, oldname = cmd.egg_name, metadata.name try: # write unescaped data to PKG-INFO, so older pkg_resources # can still parse it metadata.write_pkg_info(cmd.egg_info) finally: metadata.name, metadata.version = oldname, oldver safe = getattr(cmd.distribution, 'zip_safe', None) bdist_egg.write_safety_flag(cmd.egg_info, safe) def warn_depends_obsolete(cmd, basename, filename): if os.path.exists(filename): log.warn( "WARNING: 'depends.txt' is not used by setuptools 0.6!\n" "Use the install_requires/extras_require setup() args instead." ) def _write_requirements(stream, reqs): lines = yield_lines(reqs or ()) append_cr = lambda line: line + '\n' lines = map(append_cr, lines) stream.writelines(lines) def write_requirements(cmd, basename, filename): dist = cmd.distribution data = six.StringIO() _write_requirements(data, dist.install_requires) extras_require = dist.extras_require or {} for extra in sorted(extras_require): data.write('\n[{extra}]\n'.format(**vars())) _write_requirements(data, extras_require[extra]) cmd.write_or_delete_file("requirements", filename, data.getvalue()) def write_setup_requirements(cmd, basename, filename): data = StringIO() _write_requirements(data, cmd.distribution.setup_requires) cmd.write_or_delete_file("setup-requirements", filename, data.getvalue()) def write_toplevel_names(cmd, basename, filename): pkgs = dict.fromkeys( [ k.split('.', 1)[0] for k in cmd.distribution.iter_distribution_names() ] ) cmd.write_file("top-level names", filename, '\n'.join(sorted(pkgs)) + '\n') def overwrite_arg(cmd, basename, filename): write_arg(cmd, basename, filename, True) def write_arg(cmd, basename, filename, force=False): argname = os.path.splitext(basename)[0] value = getattr(cmd.distribution, argname, None) if value is not None: value = '\n'.join(value) + '\n' cmd.write_or_delete_file(argname, filename, value, force) def write_entries(cmd, basename, filename): ep = cmd.distribution.entry_points if isinstance(ep, six.string_types) or ep is None: data = ep elif ep is not None: data = [] for section, contents in sorted(ep.items()): if not isinstance(contents, six.string_types): contents = EntryPoint.parse_group(section, contents) contents = '\n'.join(sorted(map(str, contents.values()))) data.append('[%s]\n%s\n\n' % (section, contents)) data = ''.join(data) cmd.write_or_delete_file('entry points', filename, data, True) def get_pkg_info_revision(): """ Get a -r### off of PKG-INFO Version in case this is an sdist of a subversion revision. """ warnings.warn("get_pkg_info_revision is deprecated.", DeprecationWarning) if os.path.exists('PKG-INFO'): with io.open('PKG-INFO') as f: for line in f: match = re.match(r"Version:.*-r(\d+)\s*$", line) if match: return int(match.group(1)) return 0 setuptools-20.7.0/setuptools/command/install.py0000664000175000017500000001111312702524020022533 0ustar travistravis00000000000000from distutils.errors import DistutilsArgError import inspect import glob import warnings import platform import distutils.command.install as orig import setuptools # Prior to numpy 1.9, NumPy relies on the '_install' name, so provide it for # now. See https://github.com/pypa/setuptools/issues/199/ _install = orig.install class install(orig.install): """Use easy_install to install the package, w/dependencies""" user_options = orig.install.user_options + [ ('old-and-unmanageable', None, "Try not to use this!"), ('single-version-externally-managed', None, "used by system package builders to create 'flat' eggs"), ] boolean_options = orig.install.boolean_options + [ 'old-and-unmanageable', 'single-version-externally-managed', ] new_commands = [ ('install_egg_info', lambda self: True), ('install_scripts', lambda self: True), ] _nc = dict(new_commands) def initialize_options(self): orig.install.initialize_options(self) self.old_and_unmanageable = None self.single_version_externally_managed = None def finalize_options(self): orig.install.finalize_options(self) if self.root: self.single_version_externally_managed = True elif self.single_version_externally_managed: if not self.root and not self.record: raise DistutilsArgError( "You must specify --record or --root when building system" " packages" ) def handle_extra_path(self): if self.root or self.single_version_externally_managed: # explicit backward-compatibility mode, allow extra_path to work return orig.install.handle_extra_path(self) # Ignore extra_path when installing an egg (or being run by another # command without --root or --single-version-externally-managed self.path_file = None self.extra_dirs = '' def run(self): # Explicit request for old-style install? Just do it if self.old_and_unmanageable or self.single_version_externally_managed: return orig.install.run(self) if not self._called_from_setup(inspect.currentframe()): # Run in backward-compatibility mode to support bdist_* commands. orig.install.run(self) else: self.do_egg_install() @staticmethod def _called_from_setup(run_frame): """ Attempt to detect whether run() was called from setup() or by another command. If called by setup(), the parent caller will be the 'run_command' method in 'distutils.dist', and *its* caller will be the 'run_commands' method. If called any other way, the immediate caller *might* be 'run_command', but it won't have been called by 'run_commands'. Return True in that case or if a call stack is unavailable. Return False otherwise. """ if run_frame is None: msg = "Call stack not available. bdist_* commands may fail." warnings.warn(msg) if platform.python_implementation() == 'IronPython': msg = "For best results, pass -X:Frames to enable call stack." warnings.warn(msg) return True res = inspect.getouterframes(run_frame)[2] caller, = res[:1] info = inspect.getframeinfo(caller) caller_module = caller.f_globals.get('__name__', '') return ( caller_module == 'distutils.dist' and info.function == 'run_commands' ) def do_egg_install(self): easy_install = self.distribution.get_command_class('easy_install') cmd = easy_install( self.distribution, args="x", root=self.root, record=self.record, ) cmd.ensure_finalized() # finalize before bdist_egg munges install cmd cmd.always_copy_from = '.' # make sure local-dir eggs get installed # pick up setup-dir .egg files only: no .egg-info cmd.package_index.scan(glob.glob('*.egg')) self.run_command('bdist_egg') args = [self.distribution.get_command_obj('bdist_egg').egg_output] if setuptools.bootstrap_install_from: # Bootstrap self-installation of setuptools args.insert(0, setuptools.bootstrap_install_from) cmd.args = args cmd.run() setuptools.bootstrap_install_from = None # XXX Python 3.1 doesn't see _nc if this is inside the class install.sub_commands = ( [cmd for cmd in orig.install.sub_commands if cmd[0] not in install._nc] + install.new_commands ) setuptools-20.7.0/setuptools/command/install_egg_info.py0000775000175000017500000000770312702524020024405 0ustar travistravis00000000000000from distutils import log, dir_util import os from setuptools.extern.six.moves import map from setuptools import Command from setuptools.archive_util import unpack_archive import pkg_resources class install_egg_info(Command): """Install an .egg-info directory for the package""" description = "Install an .egg-info directory for the package" user_options = [ ('install-dir=', 'd', "directory to install to"), ] def initialize_options(self): self.install_dir = None def finalize_options(self): self.set_undefined_options('install_lib', ('install_dir', 'install_dir')) ei_cmd = self.get_finalized_command("egg_info") basename = pkg_resources.Distribution( None, None, ei_cmd.egg_name, ei_cmd.egg_version ).egg_name() + '.egg-info' self.source = ei_cmd.egg_info self.target = os.path.join(self.install_dir, basename) self.outputs = [] def run(self): self.run_command('egg_info') if os.path.isdir(self.target) and not os.path.islink(self.target): dir_util.remove_tree(self.target, dry_run=self.dry_run) elif os.path.exists(self.target): self.execute(os.unlink, (self.target,), "Removing " + self.target) if not self.dry_run: pkg_resources.ensure_directory(self.target) self.execute( self.copytree, (), "Copying %s to %s" % (self.source, self.target) ) self.install_namespaces() def get_outputs(self): return self.outputs def copytree(self): # Copy the .egg-info tree to site-packages def skimmer(src, dst): # filter out source-control directories; note that 'src' is always # a '/'-separated path, regardless of platform. 'dst' is a # platform-specific path. for skip in '.svn/', 'CVS/': if src.startswith(skip) or '/' + skip in src: return None self.outputs.append(dst) log.debug("Copying %s to %s", src, dst) return dst unpack_archive(self.source, self.target, skimmer) def install_namespaces(self): nsp = self._get_all_ns_packages() if not nsp: return filename, ext = os.path.splitext(self.target) filename += '-nspkg.pth' self.outputs.append(filename) log.info("Installing %s", filename) lines = map(self._gen_nspkg_line, nsp) if self.dry_run: # always generate the lines, even in dry run list(lines) return with open(filename, 'wt') as f: f.writelines(lines) _nspkg_tmpl = ( "import sys, types, os", "p = os.path.join(sys._getframe(1).f_locals['sitedir'], *%(pth)r)", "ie = os.path.exists(os.path.join(p,'__init__.py'))", "m = not ie and " "sys.modules.setdefault(%(pkg)r, types.ModuleType(%(pkg)r))", "mp = (m or []) and m.__dict__.setdefault('__path__',[])", "(p not in mp) and mp.append(p)", ) "lines for the namespace installer" _nspkg_tmpl_multi = ( 'm and setattr(sys.modules[%(parent)r], %(child)r, m)', ) "additional line(s) when a parent package is indicated" @classmethod def _gen_nspkg_line(cls, pkg): # ensure pkg is not a unicode string under Python 2.7 pkg = str(pkg) pth = tuple(pkg.split('.')) tmpl_lines = cls._nspkg_tmpl parent, sep, child = pkg.rpartition('.') if parent: tmpl_lines += cls._nspkg_tmpl_multi return ';'.join(tmpl_lines) % locals() + '\n' def _get_all_ns_packages(self): """Return sorted list of all package namespaces""" nsp = set() for pkg in self.distribution.namespace_packages or []: pkg = pkg.split('.') while pkg: nsp.add('.'.join(pkg)) pkg.pop() return sorted(nsp) setuptools-20.7.0/setuptools/command/install_lib.py0000664000175000017500000000737712702524020023402 0ustar travistravis00000000000000import os import imp from itertools import product, starmap import distutils.command.install_lib as orig class install_lib(orig.install_lib): """Don't add compiled flags to filenames of non-Python files""" def run(self): self.build() outfiles = self.install() if outfiles is not None: # always compile, in case we have any extension stubs to deal with self.byte_compile(outfiles) def get_exclusions(self): """ Return a collections.Sized collections.Container of paths to be excluded for single_version_externally_managed installations. """ all_packages = ( pkg for ns_pkg in self._get_SVEM_NSPs() for pkg in self._all_packages(ns_pkg) ) excl_specs = product(all_packages, self._gen_exclusion_paths()) return set(starmap(self._exclude_pkg_path, excl_specs)) def _exclude_pkg_path(self, pkg, exclusion_path): """ Given a package name and exclusion path within that package, compute the full exclusion path. """ parts = pkg.split('.') + [exclusion_path] return os.path.join(self.install_dir, *parts) @staticmethod def _all_packages(pkg_name): """ >>> list(install_lib._all_packages('foo.bar.baz')) ['foo.bar.baz', 'foo.bar', 'foo'] """ while pkg_name: yield pkg_name pkg_name, sep, child = pkg_name.rpartition('.') def _get_SVEM_NSPs(self): """ Get namespace packages (list) but only for single_version_externally_managed installations and empty otherwise. """ # TODO: is it necessary to short-circuit here? i.e. what's the cost # if get_finalized_command is called even when namespace_packages is # False? if not self.distribution.namespace_packages: return [] install_cmd = self.get_finalized_command('install') svem = install_cmd.single_version_externally_managed return self.distribution.namespace_packages if svem else [] @staticmethod def _gen_exclusion_paths(): """ Generate file paths to be excluded for namespace packages (bytecode cache files). """ # always exclude the package module itself yield '__init__.py' yield '__init__.pyc' yield '__init__.pyo' if not hasattr(imp, 'get_tag'): return base = os.path.join('__pycache__', '__init__.' + imp.get_tag()) yield base + '.pyc' yield base + '.pyo' yield base + '.opt-1.pyc' yield base + '.opt-2.pyc' def copy_tree( self, infile, outfile, preserve_mode=1, preserve_times=1, preserve_symlinks=0, level=1 ): assert preserve_mode and preserve_times and not preserve_symlinks exclude = self.get_exclusions() if not exclude: return orig.install_lib.copy_tree(self, infile, outfile) # Exclude namespace package __init__.py* files from the output from setuptools.archive_util import unpack_directory from distutils import log outfiles = [] def pf(src, dst): if dst in exclude: log.warn("Skipping installation of %s (namespace package)", dst) return False log.info("copying %s -> %s", src, os.path.dirname(dst)) outfiles.append(dst) return dst unpack_directory(infile, outfile, pf) return outfiles def get_outputs(self): outputs = orig.install_lib.get_outputs(self) exclude = self.get_exclusions() if exclude: return [f for f in outputs if f not in exclude] return outputs setuptools-20.7.0/setuptools/command/install_scripts.py0000775000175000017500000000426712702524020024321 0ustar travistravis00000000000000from distutils import log import distutils.command.install_scripts as orig import os from pkg_resources import Distribution, PathMetadata, ensure_directory class install_scripts(orig.install_scripts): """Do normal script install, plus any egg_info wrapper scripts""" def initialize_options(self): orig.install_scripts.initialize_options(self) self.no_ep = False def run(self): import setuptools.command.easy_install as ei self.run_command("egg_info") if self.distribution.scripts: orig.install_scripts.run(self) # run first to set up self.outfiles else: self.outfiles = [] if self.no_ep: # don't install entry point scripts into .egg file! return ei_cmd = self.get_finalized_command("egg_info") dist = Distribution( ei_cmd.egg_base, PathMetadata(ei_cmd.egg_base, ei_cmd.egg_info), ei_cmd.egg_name, ei_cmd.egg_version, ) bs_cmd = self.get_finalized_command('build_scripts') exec_param = getattr(bs_cmd, 'executable', None) bw_cmd = self.get_finalized_command("bdist_wininst") is_wininst = getattr(bw_cmd, '_is_running', False) writer = ei.ScriptWriter if is_wininst: exec_param = "python.exe" writer = ei.WindowsScriptWriter # resolve the writer to the environment writer = writer.best() cmd = writer.command_spec_class.best().from_param(exec_param) for args in writer.get_args(dist, cmd.as_header()): self.write_script(*args) def write_script(self, script_name, contents, mode="t", *ignored): """Write an executable file to the scripts directory""" from setuptools.command.easy_install import chmod, current_umask log.info("Installing %s script to %s", script_name, self.install_dir) target = os.path.join(self.install_dir, script_name) self.outfiles.append(target) mask = current_umask() if not self.dry_run: ensure_directory(target) f = open(target, "w" + mode) f.write(contents) f.close() chmod(target, 0o777 - mask) setuptools-20.7.0/setuptools/command/launcher manifest.xml0000664000175000017500000000116412702524020024632 0ustar travistravis00000000000000 setuptools-20.7.0/setuptools/command/register.py0000775000175000017500000000041612702524020022720 0ustar travistravis00000000000000import distutils.command.register as orig class register(orig.register): __doc__ = orig.register.__doc__ def run(self): # Make sure that we are using valid current name/version info self.run_command('egg_info') orig.register.run(self) setuptools-20.7.0/setuptools/command/rotate.py0000775000175000017500000000376612702524020022405 0ustar travistravis00000000000000from distutils.util import convert_path from distutils import log from distutils.errors import DistutilsOptionError import os from setuptools.extern import six from setuptools import Command class rotate(Command): """Delete older distributions""" description = "delete older distributions, keeping N newest files" user_options = [ ('match=', 'm', "patterns to match (required)"), ('dist-dir=', 'd', "directory where the distributions are"), ('keep=', 'k', "number of matching distributions to keep"), ] boolean_options = [] def initialize_options(self): self.match = None self.dist_dir = None self.keep = None def finalize_options(self): if self.match is None: raise DistutilsOptionError( "Must specify one or more (comma-separated) match patterns " "(e.g. '.zip' or '.egg')" ) if self.keep is None: raise DistutilsOptionError("Must specify number of files to keep") try: self.keep = int(self.keep) except ValueError: raise DistutilsOptionError("--keep must be an integer") if isinstance(self.match, six.string_types): self.match = [ convert_path(p.strip()) for p in self.match.split(',') ] self.set_undefined_options('bdist', ('dist_dir', 'dist_dir')) def run(self): self.run_command("egg_info") from glob import glob for pattern in self.match: pattern = self.distribution.get_name() + '*' + pattern files = glob(os.path.join(self.dist_dir, pattern)) files = [(os.path.getmtime(f), f) for f in files] files.sort() files.reverse() log.info("%d file(s) matching %s", len(files), pattern) files = files[self.keep:] for (t, f) in files: log.info("Deleting %s", f) if not self.dry_run: os.unlink(f) setuptools-20.7.0/setuptools/command/saveopts.py0000775000175000017500000000122212702524020022734 0ustar travistravis00000000000000from setuptools.command.setopt import edit_config, option_base class saveopts(option_base): """Save command-line options to a file""" description = "save supplied options to setup.cfg or other config file" def run(self): dist = self.distribution settings = {} for cmd in dist.command_options: if cmd == 'saveopts': continue # don't save our own options! for opt, (src, val) in dist.get_option_dict(cmd).items(): if src == "command line": settings.setdefault(cmd, {})[opt] = val edit_config(self.filename, settings, self.dry_run) setuptools-20.7.0/setuptools/command/sdist.py0000775000175000017500000001561212702524020022226 0ustar travistravis00000000000000from glob import glob from distutils import log import distutils.command.sdist as orig import os import sys import io from setuptools.extern import six from setuptools.utils import cs_path_exists import pkg_resources READMES = 'README', 'README.rst', 'README.txt' _default_revctrl = list def walk_revctrl(dirname=''): """Find all files under revision control""" for ep in pkg_resources.iter_entry_points('setuptools.file_finders'): for item in ep.load()(dirname): yield item class sdist(orig.sdist): """Smart sdist that finds anything supported by revision control""" user_options = [ ('formats=', None, "formats for source distribution (comma-separated list)"), ('keep-temp', 'k', "keep the distribution tree around after creating " + "archive file(s)"), ('dist-dir=', 'd', "directory to put the source distribution archive(s) in " "[default: dist]"), ] negative_opt = {} def run(self): self.run_command('egg_info') ei_cmd = self.get_finalized_command('egg_info') self.filelist = ei_cmd.filelist self.filelist.append(os.path.join(ei_cmd.egg_info, 'SOURCES.txt')) self.check_readme() # Run sub commands for cmd_name in self.get_sub_commands(): self.run_command(cmd_name) # Call check_metadata only if no 'check' command # (distutils <= 2.6) import distutils.command if 'check' not in distutils.command.__all__: self.check_metadata() self.make_distribution() dist_files = getattr(self.distribution, 'dist_files', []) for file in self.archive_files: data = ('sdist', '', file) if data not in dist_files: dist_files.append(data) def __read_template_hack(self): # This grody hack closes the template file (MANIFEST.in) if an # exception occurs during read_template. # Doing so prevents an error when easy_install attempts to delete the # file. try: orig.sdist.read_template(self) except: _, _, tb = sys.exc_info() tb.tb_next.tb_frame.f_locals['template'].close() raise # Beginning with Python 2.7.2, 3.1.4, and 3.2.1, this leaky file handle # has been fixed, so only override the method if we're using an earlier # Python. has_leaky_handle = ( sys.version_info < (2, 7, 2) or (3, 0) <= sys.version_info < (3, 1, 4) or (3, 2) <= sys.version_info < (3, 2, 1) ) if has_leaky_handle: read_template = __read_template_hack def add_defaults(self): standards = [READMES, self.distribution.script_name] for fn in standards: if isinstance(fn, tuple): alts = fn got_it = 0 for fn in alts: if cs_path_exists(fn): got_it = 1 self.filelist.append(fn) break if not got_it: self.warn("standard file not found: should have one of " + ', '.join(alts)) else: if cs_path_exists(fn): self.filelist.append(fn) else: self.warn("standard file '%s' not found" % fn) optional = ['test/test*.py', 'setup.cfg'] for pattern in optional: files = list(filter(cs_path_exists, glob(pattern))) if files: self.filelist.extend(files) # getting python files if self.distribution.has_pure_modules(): build_py = self.get_finalized_command('build_py') self.filelist.extend(build_py.get_source_files()) # This functionality is incompatible with include_package_data, and # will in fact create an infinite recursion if include_package_data # is True. Use of include_package_data will imply that # distutils-style automatic handling of package_data is disabled if not self.distribution.include_package_data: for _, src_dir, _, filenames in build_py.data_files: self.filelist.extend([os.path.join(src_dir, filename) for filename in filenames]) if self.distribution.has_ext_modules(): build_ext = self.get_finalized_command('build_ext') self.filelist.extend(build_ext.get_source_files()) if self.distribution.has_c_libraries(): build_clib = self.get_finalized_command('build_clib') self.filelist.extend(build_clib.get_source_files()) if self.distribution.has_scripts(): build_scripts = self.get_finalized_command('build_scripts') self.filelist.extend(build_scripts.get_source_files()) def check_readme(self): for f in READMES: if os.path.exists(f): return else: self.warn( "standard file not found: should have one of " + ', '.join(READMES) ) def make_release_tree(self, base_dir, files): orig.sdist.make_release_tree(self, base_dir, files) # Save any egg_info command line options used to create this sdist dest = os.path.join(base_dir, 'setup.cfg') if hasattr(os, 'link') and os.path.exists(dest): # unlink and re-copy, since it might be hard-linked, and # we don't want to change the source version os.unlink(dest) self.copy_file('setup.cfg', dest) self.get_finalized_command('egg_info').save_version_info(dest) def _manifest_is_not_generated(self): # check for special comment used in 2.7.1 and higher if not os.path.isfile(self.manifest): return False with io.open(self.manifest, 'rb') as fp: first_line = fp.readline() return (first_line != '# file GENERATED by distutils, do NOT edit\n'.encode()) def read_manifest(self): """Read the manifest file (named by 'self.manifest') and use it to fill in 'self.filelist', the list of files to include in the source distribution. """ log.info("reading manifest file '%s'", self.manifest) manifest = open(self.manifest, 'rbU') for line in manifest: # The manifest must contain UTF-8. See #303. if six.PY3: try: line = line.decode('UTF-8') except UnicodeDecodeError: log.warn("%r not UTF-8 decodable -- skipping" % line) continue # ignore comments and blank lines line = line.strip() if line.startswith('#') or not line: continue self.filelist.append(line) manifest.close() setuptools-20.7.0/setuptools/command/setopt.py0000775000175000017500000001173612702524020022421 0ustar travistravis00000000000000from distutils.util import convert_path from distutils import log from distutils.errors import DistutilsOptionError import distutils import os from setuptools.extern.six.moves import configparser from setuptools import Command __all__ = ['config_file', 'edit_config', 'option_base', 'setopt'] def config_file(kind="local"): """Get the filename of the distutils, local, global, or per-user config `kind` must be one of "local", "global", or "user" """ if kind == 'local': return 'setup.cfg' if kind == 'global': return os.path.join( os.path.dirname(distutils.__file__), 'distutils.cfg' ) if kind == 'user': dot = os.name == 'posix' and '.' or '' return os.path.expanduser(convert_path("~/%spydistutils.cfg" % dot)) raise ValueError( "config_file() type must be 'local', 'global', or 'user'", kind ) def edit_config(filename, settings, dry_run=False): """Edit a configuration file to include `settings` `settings` is a dictionary of dictionaries or ``None`` values, keyed by command/section name. A ``None`` value means to delete the entire section, while a dictionary lists settings to be changed or deleted in that section. A setting of ``None`` means to delete that setting. """ log.debug("Reading configuration from %s", filename) opts = configparser.RawConfigParser() opts.read([filename]) for section, options in settings.items(): if options is None: log.info("Deleting section [%s] from %s", section, filename) opts.remove_section(section) else: if not opts.has_section(section): log.debug("Adding new section [%s] to %s", section, filename) opts.add_section(section) for option, value in options.items(): if value is None: log.debug( "Deleting %s.%s from %s", section, option, filename ) opts.remove_option(section, option) if not opts.options(section): log.info("Deleting empty [%s] section from %s", section, filename) opts.remove_section(section) else: log.debug( "Setting %s.%s to %r in %s", section, option, value, filename ) opts.set(section, option, value) log.info("Writing %s", filename) if not dry_run: with open(filename, 'w') as f: opts.write(f) class option_base(Command): """Abstract base class for commands that mess with config files""" user_options = [ ('global-config', 'g', "save options to the site-wide distutils.cfg file"), ('user-config', 'u', "save options to the current user's pydistutils.cfg file"), ('filename=', 'f', "configuration file to use (default=setup.cfg)"), ] boolean_options = [ 'global-config', 'user-config', ] def initialize_options(self): self.global_config = None self.user_config = None self.filename = None def finalize_options(self): filenames = [] if self.global_config: filenames.append(config_file('global')) if self.user_config: filenames.append(config_file('user')) if self.filename is not None: filenames.append(self.filename) if not filenames: filenames.append(config_file('local')) if len(filenames) > 1: raise DistutilsOptionError( "Must specify only one configuration file option", filenames ) self.filename, = filenames class setopt(option_base): """Save command-line options to a file""" description = "set an option in setup.cfg or another config file" user_options = [ ('command=', 'c', 'command to set an option for'), ('option=', 'o', 'option to set'), ('set-value=', 's', 'value of the option'), ('remove', 'r', 'remove (unset) the value'), ] + option_base.user_options boolean_options = option_base.boolean_options + ['remove'] def initialize_options(self): option_base.initialize_options(self) self.command = None self.option = None self.set_value = None self.remove = None def finalize_options(self): option_base.finalize_options(self) if self.command is None or self.option is None: raise DistutilsOptionError("Must specify --command *and* --option") if self.set_value is None and not self.remove: raise DistutilsOptionError("Must specify --set-value or --remove") def run(self): edit_config( self.filename, { self.command: {self.option.replace('-', '_'): self.set_value} }, self.dry_run ) setuptools-20.7.0/setuptools/command/test.py0000664000175000017500000001535012702524020022053 0ustar travistravis00000000000000from distutils.errors import DistutilsOptionError from unittest import TestLoader import sys from setuptools.extern import six from setuptools.extern.six.moves import map from pkg_resources import (resource_listdir, resource_exists, normalize_path, working_set, _namespace_packages, add_activation_listener, require, EntryPoint) from setuptools import Command from setuptools.py31compat import unittest_main class ScanningLoader(TestLoader): def loadTestsFromModule(self, module, pattern=None): """Return a suite of all tests cases contained in the given module If the module is a package, load tests from all the modules in it. If the module has an ``additional_tests`` function, call it and add the return value to the tests. """ tests = [] tests.append(TestLoader.loadTestsFromModule(self, module)) if hasattr(module, "additional_tests"): tests.append(module.additional_tests()) if hasattr(module, '__path__'): for file in resource_listdir(module.__name__, ''): if file.endswith('.py') and file != '__init__.py': submodule = module.__name__ + '.' + file[:-3] else: if resource_exists(module.__name__, file + '/__init__.py'): submodule = module.__name__ + '.' + file else: continue tests.append(self.loadTestsFromName(submodule)) if len(tests) != 1: return self.suiteClass(tests) else: return tests[0] # don't create a nested suite for only one return # adapted from jaraco.classes.properties:NonDataProperty class NonDataProperty(object): def __init__(self, fget): self.fget = fget def __get__(self, obj, objtype=None): if obj is None: return self return self.fget(obj) class test(Command): """Command to run unit tests after in-place build""" description = "run unit tests after in-place build" user_options = [ ('test-module=', 'm', "Run 'test_suite' in specified module"), ('test-suite=', 's', "Test suite to run (e.g. 'some_module.test_suite')"), ('test-runner=', 'r', "Test runner to use"), ] def initialize_options(self): self.test_suite = None self.test_module = None self.test_loader = None self.test_runner = None def finalize_options(self): if self.test_suite and self.test_module: msg = "You may specify a module or a suite, but not both" raise DistutilsOptionError(msg) if self.test_suite is None: if self.test_module is None: self.test_suite = self.distribution.test_suite else: self.test_suite = self.test_module + ".test_suite" if self.test_loader is None: self.test_loader = getattr(self.distribution, 'test_loader', None) if self.test_loader is None: self.test_loader = "setuptools.command.test:ScanningLoader" if self.test_runner is None: self.test_runner = getattr(self.distribution, 'test_runner', None) @NonDataProperty def test_args(self): return list(self._test_args()) def _test_args(self): if self.verbose: yield '--verbose' if self.test_suite: yield self.test_suite def with_project_on_sys_path(self, func): with_2to3 = six.PY3 and getattr(self.distribution, 'use_2to3', False) if with_2to3: # If we run 2to3 we can not do this inplace: # Ensure metadata is up-to-date self.reinitialize_command('build_py', inplace=0) self.run_command('build_py') bpy_cmd = self.get_finalized_command("build_py") build_path = normalize_path(bpy_cmd.build_lib) # Build extensions self.reinitialize_command('egg_info', egg_base=build_path) self.run_command('egg_info') self.reinitialize_command('build_ext', inplace=0) self.run_command('build_ext') else: # Without 2to3 inplace works fine: self.run_command('egg_info') # Build extensions in-place self.reinitialize_command('build_ext', inplace=1) self.run_command('build_ext') ei_cmd = self.get_finalized_command("egg_info") old_path = sys.path[:] old_modules = sys.modules.copy() try: sys.path.insert(0, normalize_path(ei_cmd.egg_base)) working_set.__init__() add_activation_listener(lambda dist: dist.activate()) require('%s==%s' % (ei_cmd.egg_name, ei_cmd.egg_version)) func() finally: sys.path[:] = old_path sys.modules.clear() sys.modules.update(old_modules) working_set.__init__() def run(self): if self.distribution.install_requires: self.distribution.fetch_build_eggs( self.distribution.install_requires) if self.distribution.tests_require: self.distribution.fetch_build_eggs(self.distribution.tests_require) cmd = ' '.join(self._argv) if self.dry_run: self.announce('skipping "%s" (dry run)' % cmd) else: self.announce('running "%s"' % cmd) self.with_project_on_sys_path(self.run_tests) def run_tests(self): # Purge modules under test from sys.modules. The test loader will # re-import them from the build location. Required when 2to3 is used # with namespace packages. if six.PY3 and getattr(self.distribution, 'use_2to3', False): module = self.test_suite.split('.')[0] if module in _namespace_packages: del_modules = [] if module in sys.modules: del_modules.append(module) module += '.' for name in sys.modules: if name.startswith(module): del_modules.append(name) list(map(sys.modules.__delitem__, del_modules)) unittest_main( None, None, self._argv, testLoader=self._resolve_as_ep(self.test_loader), testRunner=self._resolve_as_ep(self.test_runner), ) @property def _argv(self): return ['unittest'] + self.test_args @staticmethod def _resolve_as_ep(val): """ Load the indicated attribute value, called, as a as if it were specified as an entry point. """ if val is None: return parsed = EntryPoint.parse("x=" + val) return parsed.resolve()() setuptools-20.7.0/setuptools/command/upload.py0000664000175000017500000000121112702524020022347 0ustar travistravis00000000000000from distutils.command import upload as orig class upload(orig.upload): """ Override default upload behavior to look up password in the keyring if available. """ def finalize_options(self): orig.upload.finalize_options(self) self.password or self._load_password_from_keyring() def _load_password_from_keyring(self): """ Attempt to load password from keyring. Suppress Exceptions. """ try: keyring = __import__('keyring') self.password = keyring.get_password(self.repository, self.username) except Exception: pass setuptools-20.7.0/setuptools/command/upload_docs.py0000664000175000017500000001523712702524020023374 0ustar travistravis00000000000000# -*- coding: utf-8 -*- """upload_docs Implements a Distutils 'upload_docs' subcommand (upload documentation to PyPI's pythonhosted.org). """ from base64 import standard_b64encode from distutils import log from distutils.errors import DistutilsOptionError import os import socket import zipfile import tempfile import shutil from setuptools.extern import six from setuptools.extern.six.moves import http_client, urllib from pkg_resources import iter_entry_points from .upload import upload errors = 'surrogateescape' if six.PY3 else 'strict' # This is not just a replacement for byte literals # but works as a general purpose encoder def b(s, encoding='utf-8'): if isinstance(s, six.text_type): return s.encode(encoding, errors) return s class upload_docs(upload): description = 'Upload documentation to PyPI' user_options = [ ('repository=', 'r', "url of repository [default: %s]" % upload.DEFAULT_REPOSITORY), ('show-response', None, 'display full response text from server'), ('upload-dir=', None, 'directory to upload'), ] boolean_options = upload.boolean_options def has_sphinx(self): if self.upload_dir is None: for ep in iter_entry_points('distutils.commands', 'build_sphinx'): return True sub_commands = [('build_sphinx', has_sphinx)] def initialize_options(self): upload.initialize_options(self) self.upload_dir = None self.target_dir = None def finalize_options(self): upload.finalize_options(self) if self.upload_dir is None: if self.has_sphinx(): build_sphinx = self.get_finalized_command('build_sphinx') self.target_dir = build_sphinx.builder_target_dir else: build = self.get_finalized_command('build') self.target_dir = os.path.join(build.build_base, 'docs') else: self.ensure_dirname('upload_dir') self.target_dir = self.upload_dir self.announce('Using upload directory %s' % self.target_dir) def create_zipfile(self, filename): zip_file = zipfile.ZipFile(filename, "w") try: self.mkpath(self.target_dir) # just in case for root, dirs, files in os.walk(self.target_dir): if root == self.target_dir and not files: raise DistutilsOptionError( "no files found in upload directory '%s'" % self.target_dir) for name in files: full = os.path.join(root, name) relative = root[len(self.target_dir):].lstrip(os.path.sep) dest = os.path.join(relative, name) zip_file.write(full, dest) finally: zip_file.close() def run(self): # Run sub commands for cmd_name in self.get_sub_commands(): self.run_command(cmd_name) tmp_dir = tempfile.mkdtemp() name = self.distribution.metadata.get_name() zip_file = os.path.join(tmp_dir, "%s.zip" % name) try: self.create_zipfile(zip_file) self.upload_file(zip_file) finally: shutil.rmtree(tmp_dir) def upload_file(self, filename): f = open(filename, 'rb') content = f.read() f.close() meta = self.distribution.metadata data = { ':action': 'doc_upload', 'name': meta.get_name(), 'content': (os.path.basename(filename), content), } # set up the authentication credentials = b(self.username + ':' + self.password) credentials = standard_b64encode(credentials) if six.PY3: credentials = credentials.decode('ascii') auth = "Basic " + credentials # Build up the MIME payload for the POST data boundary = '--------------GHSKFJDLGDS7543FJKLFHRE75642756743254' sep_boundary = b('\n--') + b(boundary) end_boundary = sep_boundary + b('--') body = [] for key, values in six.iteritems(data): title = '\nContent-Disposition: form-data; name="%s"' % key # handle multiple entries for the same name if not isinstance(values, list): values = [values] for value in values: if type(value) is tuple: title += '; filename="%s"' % value[0] value = value[1] else: value = b(value) body.append(sep_boundary) body.append(b(title)) body.append(b("\n\n")) body.append(value) if value and value[-1:] == b('\r'): body.append(b('\n')) # write an extra newline (lurve Macs) body.append(end_boundary) body.append(b("\n")) body = b('').join(body) self.announce("Submitting documentation to %s" % (self.repository), log.INFO) # build the Request # We can't use urllib2 since we need to send the Basic # auth right with the first request schema, netloc, url, params, query, fragments = \ urllib.parse.urlparse(self.repository) assert not params and not query and not fragments if schema == 'http': conn = http_client.HTTPConnection(netloc) elif schema == 'https': conn = http_client.HTTPSConnection(netloc) else: raise AssertionError("unsupported schema " + schema) data = '' try: conn.connect() conn.putrequest("POST", url) content_type = 'multipart/form-data; boundary=%s' % boundary conn.putheader('Content-type', content_type) conn.putheader('Content-length', str(len(body))) conn.putheader('Authorization', auth) conn.endheaders() conn.send(body) except socket.error as e: self.announce(str(e), log.ERROR) return r = conn.getresponse() if r.status == 200: self.announce('Server response (%s): %s' % (r.status, r.reason), log.INFO) elif r.status == 301: location = r.getheader('Location') if location is None: location = 'https://pythonhosted.org/%s/' % meta.get_name() self.announce('Upload successful. Visit %s' % location, log.INFO) else: self.announce('Upload failed (%s): %s' % (r.status, r.reason), log.ERROR) if self.show_response: print('-' * 75, r.read(), '-' * 75) setuptools-20.7.0/setuptools/extern/0000775000175000017500000000000012702524134020413 5ustar travistravis00000000000000setuptools-20.7.0/setuptools/extern/__init__.py0000664000175000017500000000020412702524020022512 0ustar travistravis00000000000000from pkg_resources.extern import VendorImporter names = 'six', VendorImporter(__name__, names, 'pkg_resources._vendor').install() setuptools-20.7.0/setuptools/tests/0000775000175000017500000000000012702524134020250 5ustar travistravis00000000000000setuptools-20.7.0/setuptools/tests/indexes/0000775000175000017500000000000012702524134021707 5ustar travistravis00000000000000setuptools-20.7.0/setuptools/tests/indexes/test_links_priority/0000775000175000017500000000000012702524134026027 5ustar travistravis00000000000000setuptools-20.7.0/setuptools/tests/indexes/test_links_priority/simple/0000775000175000017500000000000012702524134027320 5ustar travistravis00000000000000setuptools-20.7.0/setuptools/tests/indexes/test_links_priority/simple/foobar/0000775000175000017500000000000012702524134030570 5ustar travistravis00000000000000setuptools-20.7.0/setuptools/tests/indexes/test_links_priority/simple/foobar/index.html0000664000175000017500000000025612702524020032562 0ustar travistravis00000000000000 foobar-0.1.tar.gz
    external homepage
    setuptools-20.7.0/setuptools/tests/indexes/test_links_priority/external.html0000664000175000017500000000013412702524020030527 0ustar travistravis00000000000000 bad old link setuptools-20.7.0/setuptools/tests/__init__.py0000664000175000017500000002612212702524020022356 0ustar travistravis00000000000000"""Tests for the 'setuptools' package""" import sys import os import distutils.core import distutils.cmd from distutils.errors import DistutilsOptionError, DistutilsPlatformError from distutils.errors import DistutilsSetupError from distutils.core import Extension from distutils.version import LooseVersion from setuptools.extern import six import pytest import setuptools.dist import setuptools.depends as dep from setuptools import Feature from setuptools.depends import Require c_type = os.environ.get("LC_CTYPE", os.environ.get("LC_ALL")) is_ascii = c_type in ("C", "POSIX") fail_on_ascii = pytest.mark.xfail(is_ascii, reason="Test fails in this locale") def makeSetup(**args): """Return distribution from 'setup(**args)', without executing commands""" distutils.core._setup_stop_after = "commandline" # Don't let system command line leak into tests! args.setdefault('script_args',['install']) try: return setuptools.setup(**args) finally: distutils.core._setup_stop_after = None needs_bytecode = pytest.mark.skipif( not hasattr(dep, 'get_module_constant'), reason="bytecode support not available", ) class TestDepends: def testExtractConst(self): if not hasattr(dep, 'extract_constant'): # skip on non-bytecode platforms return def f1(): global x, y, z x = "test" y = z fc = six.get_function_code(f1) # unrecognized name assert dep.extract_constant(fc,'q', -1) is None # constant assigned dep.extract_constant(fc,'x', -1) == "test" # expression assigned dep.extract_constant(fc,'y', -1) == -1 # recognized name, not assigned dep.extract_constant(fc,'z', -1) is None def testFindModule(self): with pytest.raises(ImportError): dep.find_module('no-such.-thing') with pytest.raises(ImportError): dep.find_module('setuptools.non-existent') f,p,i = dep.find_module('setuptools.tests') f.close() @needs_bytecode def testModuleExtract(self): from email import __version__ assert dep.get_module_constant('email','__version__') == __version__ assert dep.get_module_constant('sys','version') == sys.version assert dep.get_module_constant('setuptools.tests','__doc__') == __doc__ @needs_bytecode def testRequire(self): req = Require('Email','1.0.3','email') assert req.name == 'Email' assert req.module == 'email' assert req.requested_version == '1.0.3' assert req.attribute == '__version__' assert req.full_name() == 'Email-1.0.3' from email import __version__ assert req.get_version() == __version__ assert req.version_ok('1.0.9') assert not req.version_ok('0.9.1') assert not req.version_ok('unknown') assert req.is_present() assert req.is_current() req = Require('Email 3000','03000','email',format=LooseVersion) assert req.is_present() assert not req.is_current() assert not req.version_ok('unknown') req = Require('Do-what-I-mean','1.0','d-w-i-m') assert not req.is_present() assert not req.is_current() req = Require('Tests', None, 'tests', homepage="http://example.com") assert req.format is None assert req.attribute is None assert req.requested_version is None assert req.full_name() == 'Tests' assert req.homepage == 'http://example.com' paths = [os.path.dirname(p) for p in __path__] assert req.is_present(paths) assert req.is_current(paths) class TestDistro: def setup_method(self, method): self.e1 = Extension('bar.ext',['bar.c']) self.e2 = Extension('c.y', ['y.c']) self.dist = makeSetup( packages=['a', 'a.b', 'a.b.c', 'b', 'c'], py_modules=['b.d','x'], ext_modules = (self.e1, self.e2), package_dir = {}, ) def testDistroType(self): assert isinstance(self.dist,setuptools.dist.Distribution) def testExcludePackage(self): self.dist.exclude_package('a') assert self.dist.packages == ['b','c'] self.dist.exclude_package('b') assert self.dist.packages == ['c'] assert self.dist.py_modules == ['x'] assert self.dist.ext_modules == [self.e1, self.e2] self.dist.exclude_package('c') assert self.dist.packages == [] assert self.dist.py_modules == ['x'] assert self.dist.ext_modules == [self.e1] # test removals from unspecified options makeSetup().exclude_package('x') def testIncludeExclude(self): # remove an extension self.dist.exclude(ext_modules=[self.e1]) assert self.dist.ext_modules == [self.e2] # add it back in self.dist.include(ext_modules=[self.e1]) assert self.dist.ext_modules == [self.e2, self.e1] # should not add duplicate self.dist.include(ext_modules=[self.e1]) assert self.dist.ext_modules == [self.e2, self.e1] def testExcludePackages(self): self.dist.exclude(packages=['c','b','a']) assert self.dist.packages == [] assert self.dist.py_modules == ['x'] assert self.dist.ext_modules == [self.e1] def testEmpty(self): dist = makeSetup() dist.include(packages=['a'], py_modules=['b'], ext_modules=[self.e2]) dist = makeSetup() dist.exclude(packages=['a'], py_modules=['b'], ext_modules=[self.e2]) def testContents(self): assert self.dist.has_contents_for('a') self.dist.exclude_package('a') assert not self.dist.has_contents_for('a') assert self.dist.has_contents_for('b') self.dist.exclude_package('b') assert not self.dist.has_contents_for('b') assert self.dist.has_contents_for('c') self.dist.exclude_package('c') assert not self.dist.has_contents_for('c') def testInvalidIncludeExclude(self): with pytest.raises(DistutilsSetupError): self.dist.include(nonexistent_option='x') with pytest.raises(DistutilsSetupError): self.dist.exclude(nonexistent_option='x') with pytest.raises(DistutilsSetupError): self.dist.include(packages={'x':'y'}) with pytest.raises(DistutilsSetupError): self.dist.exclude(packages={'x':'y'}) with pytest.raises(DistutilsSetupError): self.dist.include(ext_modules={'x':'y'}) with pytest.raises(DistutilsSetupError): self.dist.exclude(ext_modules={'x':'y'}) with pytest.raises(DistutilsSetupError): self.dist.include(package_dir=['q']) with pytest.raises(DistutilsSetupError): self.dist.exclude(package_dir=['q']) class TestFeatures: def setup_method(self, method): self.req = Require('Distutils','1.0.3','distutils') self.dist = makeSetup( features={ 'foo': Feature("foo",standard=True,require_features=['baz',self.req]), 'bar': Feature("bar", standard=True, packages=['pkg.bar'], py_modules=['bar_et'], remove=['bar.ext'], ), 'baz': Feature( "baz", optional=False, packages=['pkg.baz'], scripts = ['scripts/baz_it'], libraries=[('libfoo','foo/foofoo.c')] ), 'dwim': Feature("DWIM", available=False, remove='bazish'), }, script_args=['--without-bar', 'install'], packages = ['pkg.bar', 'pkg.foo'], py_modules = ['bar_et', 'bazish'], ext_modules = [Extension('bar.ext',['bar.c'])] ) def testDefaults(self): assert not Feature( "test",standard=True,remove='x',available=False ).include_by_default() assert Feature("test",standard=True,remove='x').include_by_default() # Feature must have either kwargs, removes, or require_features with pytest.raises(DistutilsSetupError): Feature("test") def testAvailability(self): with pytest.raises(DistutilsPlatformError): self.dist.features['dwim'].include_in(self.dist) def testFeatureOptions(self): dist = self.dist assert ( ('with-dwim',None,'include DWIM') in dist.feature_options ) assert ( ('without-dwim',None,'exclude DWIM (default)') in dist.feature_options ) assert ( ('with-bar',None,'include bar (default)') in dist.feature_options ) assert ( ('without-bar',None,'exclude bar') in dist.feature_options ) assert dist.feature_negopt['without-foo'] == 'with-foo' assert dist.feature_negopt['without-bar'] == 'with-bar' assert dist.feature_negopt['without-dwim'] == 'with-dwim' assert (not 'without-baz' in dist.feature_negopt) def testUseFeatures(self): dist = self.dist assert dist.with_foo == 1 assert dist.with_bar == 0 assert dist.with_baz == 1 assert (not 'bar_et' in dist.py_modules) assert (not 'pkg.bar' in dist.packages) assert ('pkg.baz' in dist.packages) assert ('scripts/baz_it' in dist.scripts) assert (('libfoo','foo/foofoo.c') in dist.libraries) assert dist.ext_modules == [] assert dist.require_features == [self.req] # If we ask for bar, it should fail because we explicitly disabled # it on the command line with pytest.raises(DistutilsOptionError): dist.include_feature('bar') def testFeatureWithInvalidRemove(self): with pytest.raises(SystemExit): makeSetup(features={'x':Feature('x', remove='y')}) class TestCommandTests: def testTestIsCommand(self): test_cmd = makeSetup().get_command_obj('test') assert (isinstance(test_cmd, distutils.cmd.Command)) def testLongOptSuiteWNoDefault(self): ts1 = makeSetup(script_args=['test','--test-suite=foo.tests.suite']) ts1 = ts1.get_command_obj('test') ts1.ensure_finalized() assert ts1.test_suite == 'foo.tests.suite' def testDefaultSuite(self): ts2 = makeSetup(test_suite='bar.tests.suite').get_command_obj('test') ts2.ensure_finalized() assert ts2.test_suite == 'bar.tests.suite' def testDefaultWModuleOnCmdLine(self): ts3 = makeSetup( test_suite='bar.tests', script_args=['test','-m','foo.tests'] ).get_command_obj('test') ts3.ensure_finalized() assert ts3.test_module == 'foo.tests' assert ts3.test_suite == 'foo.tests.test_suite' def testConflictingOptions(self): ts4 = makeSetup( script_args=['test','-m','bar.tests', '-s','foo.tests.suite'] ).get_command_obj('test') with pytest.raises(DistutilsOptionError): ts4.ensure_finalized() def testNoSuite(self): ts5 = makeSetup().get_command_obj('test') ts5.ensure_finalized() assert ts5.test_suite == None setuptools-20.7.0/setuptools/tests/contexts.py0000664000175000017500000000413412702524020022465 0ustar travistravis00000000000000import tempfile import os import shutil import sys import contextlib import site from setuptools.extern import six import pkg_resources @contextlib.contextmanager def tempdir(cd=lambda dir:None, **kwargs): temp_dir = tempfile.mkdtemp(**kwargs) orig_dir = os.getcwd() try: cd(temp_dir) yield temp_dir finally: cd(orig_dir) shutil.rmtree(temp_dir) @contextlib.contextmanager def environment(**replacements): """ In a context, patch the environment with replacements. Pass None values to clear the values. """ saved = dict( (key, os.environ[key]) for key in replacements if key in os.environ ) # remove values that are null remove = (key for (key, value) in replacements.items() if value is None) for key in list(remove): os.environ.pop(key, None) replacements.pop(key) os.environ.update(replacements) try: yield saved finally: for key in replacements: os.environ.pop(key, None) os.environ.update(saved) @contextlib.contextmanager def quiet(): """ Redirect stdout/stderr to StringIO objects to prevent console output from distutils commands. """ old_stdout = sys.stdout old_stderr = sys.stderr new_stdout = sys.stdout = six.StringIO() new_stderr = sys.stderr = six.StringIO() try: yield new_stdout, new_stderr finally: new_stdout.seek(0) new_stderr.seek(0) sys.stdout = old_stdout sys.stderr = old_stderr @contextlib.contextmanager def save_user_site_setting(): saved = site.ENABLE_USER_SITE try: yield saved finally: site.ENABLE_USER_SITE = saved @contextlib.contextmanager def save_pkg_resources_state(): pr_state = pkg_resources.__getstate__() # also save sys.path sys_path = sys.path[:] try: yield pr_state, sys_path finally: sys.path[:] = sys_path pkg_resources.__setstate__(pr_state) @contextlib.contextmanager def suppress_exceptions(*excs): try: yield except excs: pass setuptools-20.7.0/setuptools/tests/environment.py0000664000175000017500000000311312702524020023156 0ustar travistravis00000000000000import os import sys import unicodedata from subprocess import Popen as _Popen, PIPE as _PIPE def _which_dirs(cmd): result = set() for path in os.environ.get('PATH', '').split(os.pathsep): filename = os.path.join(path, cmd) if os.access(filename, os.X_OK): result.add(path) return result def run_setup_py(cmd, pypath=None, path=None, data_stream=0, env=None): """ Execution command for tests, separate from those used by the code directly to prevent accidental behavior issues """ if env is None: env = dict() for envname in os.environ: env[envname] = os.environ[envname] #override the python path if needed if pypath is not None: env["PYTHONPATH"] = pypath #overide the execution path if needed if path is not None: env["PATH"] = path if not env.get("PATH", ""): env["PATH"] = _which_dirs("tar").union(_which_dirs("gzip")) env["PATH"] = os.pathsep.join(env["PATH"]) cmd = [sys.executable, "setup.py"] + list(cmd) # http://bugs.python.org/issue8557 shell = sys.platform == 'win32' try: proc = _Popen( cmd, stdout=_PIPE, stderr=_PIPE, shell=shell, env=env, ) data = proc.communicate()[data_stream] except OSError: return 1, '' #decode the console string if needed if hasattr(data, "decode"): # use the default encoding data = data.decode() data = unicodedata.normalize('NFC', data) #communciate calls wait() return proc.returncode, data setuptools-20.7.0/setuptools/tests/files.py0000664000175000017500000000164612702524020021725 0ustar travistravis00000000000000import os def build_files(file_defs, prefix=""): """ Build a set of files/directories, as described by the file_defs dictionary. Each key/value pair in the dictionary is interpreted as a filename/contents pair. If the contents value is a dictionary, a directory is created, and the dictionary interpreted as the files within it, recursively. For example: {"README.txt": "A README file", "foo": { "__init__.py": "", "bar": { "__init__.py": "", }, "baz.py": "# Some code", } } """ for name, contents in file_defs.items(): full_name = os.path.join(prefix, name) if isinstance(contents, dict): if not os.path.exists(full_name): os.makedirs(full_name) build_files(contents, prefix=full_name) else: with open(full_name, 'w') as f: f.write(contents) setuptools-20.7.0/setuptools/tests/fixtures.py0000664000175000017500000000122512702524020022465 0ustar travistravis00000000000000try: from unittest import mock except ImportError: import mock import pytest from . import contexts @pytest.yield_fixture def user_override(): """ Override site.USER_BASE and site.USER_SITE with temporary directories in a context. """ with contexts.tempdir() as user_base: with mock.patch('site.USER_BASE', user_base): with contexts.tempdir() as user_site: with mock.patch('site.USER_SITE', user_site): with contexts.save_user_site_setting(): yield @pytest.yield_fixture def tmpdir_cwd(tmpdir): with tmpdir.as_cwd() as orig: yield orig setuptools-20.7.0/setuptools/tests/py26compat.py0000664000175000017500000000052512702524020022622 0ustar travistravis00000000000000import sys import tarfile import contextlib def _tarfile_open_ex(*args, **kwargs): """ Extend result as a context manager. """ return contextlib.closing(tarfile.open(*args, **kwargs)) if sys.version_info[:2] < (2, 7) or (3, 0) <= sys.version_info[:2] < (3, 2): tarfile_open = _tarfile_open_ex else: tarfile_open = tarfile.open setuptools-20.7.0/setuptools/tests/script-with-bom.py0000664000175000017500000000005612702524020023645 0ustar travistravis00000000000000# -*- coding: utf-8 -*- result = 'passed' setuptools-20.7.0/setuptools/tests/server.py0000664000175000017500000000405212702524020022123 0ustar travistravis00000000000000"""Basic http server for tests to simulate PyPI or custom indexes """ import time import threading from setuptools.extern.six.moves import BaseHTTPServer, SimpleHTTPServer class IndexServer(BaseHTTPServer.HTTPServer): """Basic single-threaded http server simulating a package index You can use this server in unittest like this:: s = IndexServer() s.start() index_url = s.base_url() + 'mytestindex' # do some test requests to the index # The index files should be located in setuptools/tests/indexes s.stop() """ def __init__(self, server_address=('', 0), RequestHandlerClass=SimpleHTTPServer.SimpleHTTPRequestHandler): BaseHTTPServer.HTTPServer.__init__(self, server_address, RequestHandlerClass) self._run = True def start(self): self.thread = threading.Thread(target=self.serve_forever) self.thread.start() def stop(self): "Stop the server" # Let the server finish the last request and wait for a new one. time.sleep(0.1) self.shutdown() self.thread.join() self.socket.close() def base_url(self): port = self.server_port return 'http://127.0.0.1:%s/setuptools/tests/indexes/' % port class RequestRecorder(BaseHTTPServer.BaseHTTPRequestHandler): def do_GET(self): requests = vars(self.server).setdefault('requests', []) requests.append(self) self.send_response(200, 'OK') class MockServer(BaseHTTPServer.HTTPServer, threading.Thread): """ A simple HTTP Server that records the requests made to it. """ def __init__(self, server_address=('', 0), RequestHandlerClass=RequestRecorder): BaseHTTPServer.HTTPServer.__init__(self, server_address, RequestHandlerClass) threading.Thread.__init__(self) self.setDaemon(True) self.requests = [] def run(self): self.serve_forever() @property def url(self): return 'http://localhost:%(server_port)s/' % vars(self) setuptools-20.7.0/setuptools/tests/test_bdist_egg.py0000664000175000017500000000176112702524020023607 0ustar travistravis00000000000000"""develop tests """ import os import re import pytest from setuptools.dist import Distribution from . import contexts SETUP_PY = """\ from setuptools import setup setup(name='foo', py_modules=['hi']) """ @pytest.yield_fixture def setup_context(tmpdir): with (tmpdir/'setup.py').open('w') as f: f.write(SETUP_PY) with (tmpdir/'hi.py').open('w') as f: f.write('1\n') with tmpdir.as_cwd(): yield tmpdir class Test: def test_bdist_egg(self, setup_context, user_override): dist = Distribution(dict( script_name='setup.py', script_args=['bdist_egg'], name='foo', py_modules=['hi'] )) os.makedirs(os.path.join('build', 'src')) with contexts.quiet(): dist.parse_command_line() dist.run_commands() # let's see if we got our egg link at the right place [content] = os.listdir('dist') assert re.match('foo-0.0.0-py[23].\d.egg$', content) setuptools-20.7.0/setuptools/tests/test_build_ext.py0000664000175000017500000000107212702524020023632 0ustar travistravis00000000000000import distutils.command.build_ext as orig from setuptools.command.build_ext import build_ext from setuptools.dist import Distribution class TestBuildExt: def test_get_ext_filename(self): """ Setuptools needs to give back the same result as distutils, even if the fullname is not in ext_map. """ dist = Distribution() cmd = build_ext(dist) cmd.ext_map['foo/bar'] = '' res = cmd.get_ext_filename('foo') wanted = orig.build_ext.get_ext_filename(cmd, 'foo') assert res == wanted setuptools-20.7.0/setuptools/tests/test_develop.py0000664000175000017500000000620412702524020023313 0ustar travistravis00000000000000"""develop tests """ import os import site import sys import io from setuptools.extern import six import pytest from setuptools.command.develop import develop from setuptools.dist import Distribution from . import contexts SETUP_PY = """\ from setuptools import setup setup(name='foo', packages=['foo'], use_2to3=True, ) """ INIT_PY = """print "foo" """ @pytest.yield_fixture def temp_user(monkeypatch): with contexts.tempdir() as user_base: with contexts.tempdir() as user_site: monkeypatch.setattr('site.USER_BASE', user_base) monkeypatch.setattr('site.USER_SITE', user_site) yield @pytest.yield_fixture def test_env(tmpdir, temp_user): target = tmpdir foo = target.mkdir('foo') setup = target / 'setup.py' if setup.isfile(): raise ValueError(dir(target)) with setup.open('w') as f: f.write(SETUP_PY) init = foo / '__init__.py' with init.open('w') as f: f.write(INIT_PY) with target.as_cwd(): yield target class TestDevelop: in_virtualenv = hasattr(sys, 'real_prefix') in_venv = hasattr(sys, 'base_prefix') and sys.base_prefix != sys.prefix @pytest.mark.skipif(in_virtualenv or in_venv, reason="Cannot run when invoked in a virtualenv or venv") def test_2to3_user_mode(self, test_env): settings = dict( name='foo', packages=['foo'], use_2to3=True, version='0.0', ) dist = Distribution(settings) dist.script_name = 'setup.py' cmd = develop(dist) cmd.user = 1 cmd.ensure_finalized() cmd.install_dir = site.USER_SITE cmd.user = 1 with contexts.quiet(): cmd.run() # let's see if we got our egg link at the right place content = os.listdir(site.USER_SITE) content.sort() assert content == ['easy-install.pth', 'foo.egg-link'] # Check that we are using the right code. fn = os.path.join(site.USER_SITE, 'foo.egg-link') with io.open(fn) as egg_link_file: path = egg_link_file.read().split()[0].strip() fn = os.path.join(path, 'foo', '__init__.py') with io.open(fn) as init_file: init = init_file.read().strip() expected = 'print("foo")' if six.PY3 else 'print "foo"' assert init == expected def test_console_scripts(self, tmpdir): """ Test that console scripts are installed and that they reference only the project by name and not the current version. """ pytest.skip("TODO: needs a fixture to cause 'develop' " "to be invoked without mutating environment.") settings = dict( name='foo', packages=['foo'], version='0.0', entry_points={ 'console_scripts': [ 'foocmd = foo:foo', ], }, ) dist = Distribution(settings) dist.script_name = 'setup.py' cmd = develop(dist) cmd.ensure_finalized() cmd.install_dir = tmpdir cmd.run() #assert '0.0' not in foocmd_text setuptools-20.7.0/setuptools/tests/test_dist_info.py0000664000175000017500000000447612702524020023644 0ustar travistravis00000000000000"""Test .dist-info style distributions. """ import os import shutil import tempfile from setuptools.extern.six.moves import map import pytest import pkg_resources from .textwrap import DALS class TestDistInfo: def test_distinfo(self): dists = dict( (d.project_name, d) for d in pkg_resources.find_distributions(self.tmpdir) ) assert len(dists) == 2, dists unversioned = dists['UnversionedDistribution'] versioned = dists['VersionedDistribution'] assert versioned.version == '2.718' # from filename assert unversioned.version == '0.3' # from METADATA def test_conditional_dependencies(self): specs = 'splort==4', 'quux>=1.1' requires = list(map(pkg_resources.Requirement.parse, specs)) for d in pkg_resources.find_distributions(self.tmpdir): assert d.requires() == requires[:1] assert d.requires(extras=('baz',)) == [ requires[0], pkg_resources.Requirement.parse('quux>=1.1;extra=="baz"')] assert d.extras == ['baz'] metadata_template = DALS(""" Metadata-Version: 1.2 Name: {name} {version} Requires-Dist: splort (==4) Provides-Extra: baz Requires-Dist: quux (>=1.1); extra == 'baz' """) def setup_method(self, method): self.tmpdir = tempfile.mkdtemp() dist_info_name = 'VersionedDistribution-2.718.dist-info' versioned = os.path.join(self.tmpdir, dist_info_name) os.mkdir(versioned) with open(os.path.join(versioned, 'METADATA'), 'w+') as metadata_file: metadata = self.metadata_template.format( name='VersionedDistribution', version='', ).replace('\n\n', '\n') metadata_file.write(metadata) dist_info_name = 'UnversionedDistribution.dist-info' unversioned = os.path.join(self.tmpdir, dist_info_name) os.mkdir(unversioned) with open(os.path.join(unversioned, 'METADATA'), 'w+') as metadata_file: metadata = self.metadata_template.format( name='UnversionedDistribution', version='Version: 0.3', ) metadata_file.write(metadata) def teardown_method(self, method): shutil.rmtree(self.tmpdir) setuptools-20.7.0/setuptools/tests/test_easy_install.py0000664000175000017500000005110412702524020024343 0ustar travistravis00000000000000# -*- coding: utf-8 -*- """Easy install Tests """ from __future__ import absolute_import import sys import os import shutil import tempfile import site import contextlib import tarfile import logging import itertools import distutils.errors import io from setuptools.extern.six.moves import urllib import time import pytest try: from unittest import mock except ImportError: import mock from setuptools import sandbox from setuptools.sandbox import run_setup import setuptools.command.easy_install as ei from setuptools.command.easy_install import PthDistributions from setuptools.command import easy_install as easy_install_pkg from setuptools.dist import Distribution from pkg_resources import working_set from pkg_resources import Distribution as PRDistribution import setuptools.tests.server import pkg_resources from .py26compat import tarfile_open from . import contexts from .textwrap import DALS class FakeDist(object): def get_entry_map(self, group): if group != 'console_scripts': return {} return {'name': 'ep'} def as_requirement(self): return 'spec' SETUP_PY = DALS(""" from setuptools import setup setup(name='foo') """) class TestEasyInstallTest: def test_install_site_py(self, tmpdir): dist = Distribution() cmd = ei.easy_install(dist) cmd.sitepy_installed = False cmd.install_dir = str(tmpdir) cmd.install_site_py() assert (tmpdir / 'site.py').exists() def test_get_script_args(self): header = ei.CommandSpec.best().from_environment().as_header() expected = header + DALS(""" # EASY-INSTALL-ENTRY-SCRIPT: 'spec','console_scripts','name' __requires__ = 'spec' import sys from pkg_resources import load_entry_point if __name__ == '__main__': sys.exit( load_entry_point('spec', 'console_scripts', 'name')() ) """) dist = FakeDist() args = next(ei.ScriptWriter.get_args(dist)) name, script = itertools.islice(args, 2) assert script == expected def test_no_find_links(self): # new option '--no-find-links', that blocks find-links added at # the project level dist = Distribution() cmd = ei.easy_install(dist) cmd.check_pth_processing = lambda: True cmd.no_find_links = True cmd.find_links = ['link1', 'link2'] cmd.install_dir = os.path.join(tempfile.mkdtemp(), 'ok') cmd.args = ['ok'] cmd.ensure_finalized() assert cmd.package_index.scanned_urls == {} # let's try without it (default behavior) cmd = ei.easy_install(dist) cmd.check_pth_processing = lambda: True cmd.find_links = ['link1', 'link2'] cmd.install_dir = os.path.join(tempfile.mkdtemp(), 'ok') cmd.args = ['ok'] cmd.ensure_finalized() keys = sorted(cmd.package_index.scanned_urls.keys()) assert keys == ['link1', 'link2'] def test_write_exception(self): """ Test that `cant_write_to_target` is rendered as a DistutilsError. """ dist = Distribution() cmd = ei.easy_install(dist) cmd.install_dir = os.getcwd() with pytest.raises(distutils.errors.DistutilsError): cmd.cant_write_to_target() class TestPTHFileWriter: def test_add_from_cwd_site_sets_dirty(self): '''a pth file manager should set dirty if a distribution is in site but also the cwd ''' pth = PthDistributions('does-not_exist', [os.getcwd()]) assert not pth.dirty pth.add(PRDistribution(os.getcwd())) assert pth.dirty def test_add_from_site_is_ignored(self): location = '/test/location/does-not-have-to-exist' # PthDistributions expects all locations to be normalized location = pkg_resources.normalize_path(location) pth = PthDistributions('does-not_exist', [location, ]) assert not pth.dirty pth.add(PRDistribution(location)) assert not pth.dirty @pytest.yield_fixture def setup_context(tmpdir): with (tmpdir/'setup.py').open('w') as f: f.write(SETUP_PY) with tmpdir.as_cwd(): yield tmpdir @pytest.mark.usefixtures("user_override") @pytest.mark.usefixtures("setup_context") class TestUserInstallTest: # prevent check that site-packages is writable. easy_install # shouldn't be writing to system site-packages during finalize # options, but while it does, bypass the behavior. prev_sp_write = mock.patch( 'setuptools.command.easy_install.easy_install.check_site_dir', mock.Mock(), ) # simulate setuptools installed in user site packages @mock.patch('setuptools.command.easy_install.__file__', site.USER_SITE) @mock.patch('site.ENABLE_USER_SITE', True) @prev_sp_write def test_user_install_not_implied_user_site_enabled(self): self.assert_not_user_site() @mock.patch('site.ENABLE_USER_SITE', False) @prev_sp_write def test_user_install_not_implied_user_site_disabled(self): self.assert_not_user_site() @staticmethod def assert_not_user_site(): # create a finalized easy_install command dist = Distribution() dist.script_name = 'setup.py' cmd = ei.easy_install(dist) cmd.args = ['py'] cmd.ensure_finalized() assert not cmd.user, 'user should not be implied' def test_multiproc_atexit(self): pytest.importorskip('multiprocessing') log = logging.getLogger('test_easy_install') logging.basicConfig(level=logging.INFO, stream=sys.stderr) log.info('this should not break') @pytest.fixture() def foo_package(self, tmpdir): egg_file = tmpdir / 'foo-1.0.egg-info' with egg_file.open('w') as f: f.write('Name: foo\n') return str(tmpdir) @pytest.yield_fixture() def install_target(self, tmpdir): target = str(tmpdir) with mock.patch('sys.path', sys.path + [target]): python_path = os.path.pathsep.join(sys.path) with mock.patch.dict(os.environ, PYTHONPATH=python_path): yield target def test_local_index(self, foo_package, install_target): """ The local index must be used when easy_install locates installed packages. """ dist = Distribution() dist.script_name = 'setup.py' cmd = ei.easy_install(dist) cmd.install_dir = install_target cmd.args = ['foo'] cmd.ensure_finalized() cmd.local_index.scan([foo_package]) res = cmd.easy_install('foo') actual = os.path.normcase(os.path.realpath(res.location)) expected = os.path.normcase(os.path.realpath(foo_package)) assert actual == expected @contextlib.contextmanager def user_install_setup_context(self, *args, **kwargs): """ Wrap sandbox.setup_context to patch easy_install in that context to appear as user-installed. """ with self.orig_context(*args, **kwargs): import setuptools.command.easy_install as ei ei.__file__ = site.USER_SITE yield def patched_setup_context(self): self.orig_context = sandbox.setup_context return mock.patch( 'setuptools.sandbox.setup_context', self.user_install_setup_context, ) @pytest.yield_fixture def distutils_package(): distutils_setup_py = SETUP_PY.replace( 'from setuptools import setup', 'from distutils.core import setup', ) with contexts.tempdir(cd=os.chdir): with open('setup.py', 'w') as f: f.write(distutils_setup_py) yield class TestDistutilsPackage: def test_bdist_egg_available_on_distutils_pkg(self, distutils_package): run_setup('setup.py', ['bdist_egg']) class TestSetupRequires: def test_setup_requires_honors_fetch_params(self): """ When easy_install installs a source distribution which specifies setup_requires, it should honor the fetch parameters (such as allow-hosts, index-url, and find-links). """ # set up a server which will simulate an alternate package index. p_index = setuptools.tests.server.MockServer() p_index.start() netloc = 1 p_index_loc = urllib.parse.urlparse(p_index.url)[netloc] if p_index_loc.endswith(':0'): # Some platforms (Jython) don't find a port to which to bind, # so skip this test for them. return with contexts.quiet(): # create an sdist that has a build-time dependency. with TestSetupRequires.create_sdist() as dist_file: with contexts.tempdir() as temp_install_dir: with contexts.environment(PYTHONPATH=temp_install_dir): ei_params = [ '--index-url', p_index.url, '--allow-hosts', p_index_loc, '--exclude-scripts', '--install-dir', temp_install_dir, dist_file, ] with sandbox.save_argv(['easy_install']): # attempt to install the dist. It should fail because # it doesn't exist. with pytest.raises(SystemExit): easy_install_pkg.main(ei_params) # there should have been two or three requests to the server # (three happens on Python 3.3a) assert 2 <= len(p_index.requests) <= 3 assert p_index.requests[0].path == '/does-not-exist/' @staticmethod @contextlib.contextmanager def create_sdist(): """ Return an sdist with a setup_requires dependency (of something that doesn't exist) """ with contexts.tempdir() as dir: dist_path = os.path.join(dir, 'setuptools-test-fetcher-1.0.tar.gz') make_sdist(dist_path, [ ('setup.py', DALS(""" import setuptools setuptools.setup( name="setuptools-test-fetcher", version="1.0", setup_requires = ['does-not-exist'], ) """))]) yield dist_path def test_setup_requires_overrides_version_conflict(self): """ Regression test for distribution issue 323: https://bitbucket.org/tarek/distribute/issues/323 Ensures that a distribution's setup_requires requirements can still be installed and used locally even if a conflicting version of that requirement is already on the path. """ fake_dist = PRDistribution('does-not-matter', project_name='foobar', version='0.0') working_set.add(fake_dist) with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: test_pkg = create_setup_requires_package(temp_dir) test_setup_py = os.path.join(test_pkg, 'setup.py') with contexts.quiet() as (stdout, stderr): # Don't even need to install the package, just # running the setup.py at all is sufficient run_setup(test_setup_py, ['--name']) lines = stdout.readlines() assert len(lines) > 0 assert lines[-1].strip(), 'test_pkg' def test_setup_requires_override_nspkg(self): """ Like ``test_setup_requires_overrides_version_conflict`` but where the ``setup_requires`` package is part of a namespace package that has *already* been imported. """ with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: foobar_1_archive = os.path.join(temp_dir, 'foo.bar-0.1.tar.gz') make_nspkg_sdist(foobar_1_archive, 'foo.bar', '0.1') # Now actually go ahead an extract to the temp dir and add the # extracted path to sys.path so foo.bar v0.1 is importable foobar_1_dir = os.path.join(temp_dir, 'foo.bar-0.1') os.mkdir(foobar_1_dir) with tarfile_open(foobar_1_archive) as tf: tf.extractall(foobar_1_dir) sys.path.insert(1, foobar_1_dir) dist = PRDistribution(foobar_1_dir, project_name='foo.bar', version='0.1') working_set.add(dist) template = DALS("""\ import foo # Even with foo imported first the # setup_requires package should override import setuptools setuptools.setup(**%r) if not (hasattr(foo, '__path__') and len(foo.__path__) == 2): print('FAIL') if 'foo.bar-0.2' not in foo.__path__[0]: print('FAIL') """) test_pkg = create_setup_requires_package( temp_dir, 'foo.bar', '0.2', make_nspkg_sdist, template) test_setup_py = os.path.join(test_pkg, 'setup.py') with contexts.quiet() as (stdout, stderr): try: # Don't even need to install the package, just # running the setup.py at all is sufficient run_setup(test_setup_py, ['--name']) except pkg_resources.VersionConflict: self.fail('Installing setup.py requirements ' 'caused a VersionConflict') assert 'FAIL' not in stdout.getvalue() lines = stdout.readlines() assert len(lines) > 0 assert lines[-1].strip() == 'test_pkg' def make_trivial_sdist(dist_path, distname, version): """ Create a simple sdist tarball at dist_path, containing just a simple setup.py. """ make_sdist(dist_path, [ ('setup.py', DALS("""\ import setuptools setuptools.setup( name=%r, version=%r ) """ % (distname, version)))]) def make_nspkg_sdist(dist_path, distname, version): """ Make an sdist tarball with distname and version which also contains one package with the same name as distname. The top-level package is designated a namespace package). """ parts = distname.split('.') nspackage = parts[0] packages = ['.'.join(parts[:idx]) for idx in range(1, len(parts) + 1)] setup_py = DALS("""\ import setuptools setuptools.setup( name=%r, version=%r, packages=%r, namespace_packages=[%r] ) """ % (distname, version, packages, nspackage)) init = "__import__('pkg_resources').declare_namespace(__name__)" files = [('setup.py', setup_py), (os.path.join(nspackage, '__init__.py'), init)] for package in packages[1:]: filename = os.path.join(*(package.split('.') + ['__init__.py'])) files.append((filename, '')) make_sdist(dist_path, files) def make_sdist(dist_path, files): """ Create a simple sdist tarball at dist_path, containing the files listed in ``files`` as ``(filename, content)`` tuples. """ with tarfile_open(dist_path, 'w:gz') as dist: for filename, content in files: file_bytes = io.BytesIO(content.encode('utf-8')) file_info = tarfile.TarInfo(name=filename) file_info.size = len(file_bytes.getvalue()) file_info.mtime = int(time.time()) dist.addfile(file_info, fileobj=file_bytes) def create_setup_requires_package(path, distname='foobar', version='0.1', make_package=make_trivial_sdist, setup_py_template=None): """Creates a source tree under path for a trivial test package that has a single requirement in setup_requires--a tarball for that requirement is also created and added to the dependency_links argument. ``distname`` and ``version`` refer to the name/version of the package that the test package requires via ``setup_requires``. The name of the test package itself is just 'test_pkg'. """ test_setup_attrs = { 'name': 'test_pkg', 'version': '0.0', 'setup_requires': ['%s==%s' % (distname, version)], 'dependency_links': [os.path.abspath(path)] } test_pkg = os.path.join(path, 'test_pkg') test_setup_py = os.path.join(test_pkg, 'setup.py') os.mkdir(test_pkg) if setup_py_template is None: setup_py_template = DALS("""\ import setuptools setuptools.setup(**%r) """) with open(test_setup_py, 'w') as f: f.write(setup_py_template % test_setup_attrs) foobar_path = os.path.join(path, '%s-%s.tar.gz' % (distname, version)) make_package(foobar_path, distname, version) return test_pkg def make_trivial_sdist(dist_path, setup_py): """Create a simple sdist tarball at dist_path, containing just a setup.py, the contents of which are provided by the setup_py string. """ setup_py_file = tarfile.TarInfo(name='setup.py') setup_py_bytes = io.BytesIO(setup_py.encode('utf-8')) setup_py_file.size = len(setup_py_bytes.getvalue()) with tarfile_open(dist_path, 'w:gz') as dist: dist.addfile(setup_py_file, fileobj=setup_py_bytes) class TestScriptHeader: non_ascii_exe = '/Users/José/bin/python' exe_with_spaces = r'C:\Program Files\Python33\python.exe' @pytest.mark.skipif( sys.platform.startswith('java') and ei.is_sh(sys.executable), reason="Test cannot run under java when executable is sh" ) def test_get_script_header(self): expected = '#!%s\n' % ei.nt_quote_arg(os.path.normpath(sys.executable)) actual = ei.ScriptWriter.get_script_header('#!/usr/local/bin/python') assert actual == expected expected = '#!%s -x\n' % ei.nt_quote_arg(os.path.normpath (sys.executable)) actual = ei.ScriptWriter.get_script_header('#!/usr/bin/python -x') assert actual == expected actual = ei.ScriptWriter.get_script_header('#!/usr/bin/python', executable=self.non_ascii_exe) expected = '#!%s -x\n' % self.non_ascii_exe assert actual == expected actual = ei.ScriptWriter.get_script_header('#!/usr/bin/python', executable='"'+self.exe_with_spaces+'"') expected = '#!"%s"\n' % self.exe_with_spaces assert actual == expected class TestCommandSpec: def test_custom_launch_command(self): """ Show how a custom CommandSpec could be used to specify a #! executable which takes parameters. """ cmd = ei.CommandSpec(['/usr/bin/env', 'python3']) assert cmd.as_header() == '#!/usr/bin/env python3\n' def test_from_param_for_CommandSpec_is_passthrough(self): """ from_param should return an instance of a CommandSpec """ cmd = ei.CommandSpec(['python']) cmd_new = ei.CommandSpec.from_param(cmd) assert cmd is cmd_new @mock.patch('sys.executable', TestScriptHeader.exe_with_spaces) @mock.patch.dict(os.environ) def test_from_environment_with_spaces_in_executable(self): os.environ.pop('__PYVENV_LAUNCHER__', None) cmd = ei.CommandSpec.from_environment() assert len(cmd) == 1 assert cmd.as_header().startswith('#!"') def test_from_simple_string_uses_shlex(self): """ In order to support `executable = /usr/bin/env my-python`, make sure from_param invokes shlex on that input. """ cmd = ei.CommandSpec.from_param('/usr/bin/env my-python') assert len(cmd) == 2 assert '"' not in cmd.as_header() def test_sys_executable(self): """ CommandSpec.from_string(sys.executable) should contain just that param. """ writer = ei.ScriptWriter.best() cmd = writer.command_spec_class.from_string(sys.executable) assert len(cmd) == 1 assert cmd[0] == sys.executable class TestWindowsScriptWriter: def test_header(self): hdr = ei.WindowsScriptWriter.get_script_header('') assert hdr.startswith('#!') assert hdr.endswith('\n') hdr = hdr.lstrip('#!') hdr = hdr.rstrip('\n') # header should not start with an escaped quote assert not hdr.startswith('\\"') setuptools-20.7.0/setuptools/tests/test_egg_info.py0000664000175000017500000001277012702524020023437 0ustar travistravis00000000000000import os import glob import stat from setuptools.extern.six.moves import map import pytest from . import environment from .files import build_files from .textwrap import DALS from . import contexts class Environment(str): pass class TestEggInfo(object): setup_script = DALS(""" from setuptools import setup setup( name='foo', py_modules=['hello'], entry_points={'console_scripts': ['hi = hello.run']}, zip_safe=False, ) """) def _create_project(self): build_files({ 'setup.py': self.setup_script, 'hello.py': DALS(""" def run(): print('hello') """) }) @pytest.yield_fixture def env(self): with contexts.tempdir(prefix='setuptools-test.') as env_dir: env = Environment(env_dir) os.chmod(env_dir, stat.S_IRWXU) subs = 'home', 'lib', 'scripts', 'data', 'egg-base' env.paths = dict( (dirname, os.path.join(env_dir, dirname)) for dirname in subs ) list(map(os.mkdir, env.paths.values())) build_files({ env.paths['home']: { '.pydistutils.cfg': DALS(""" [egg_info] egg-base = %(egg-base)s """ % env.paths) } }) yield env def test_egg_base_installed_egg_info(self, tmpdir_cwd, env): self._create_project() self._run_install_command(tmpdir_cwd, env) actual = self._find_egg_info_files(env.paths['lib']) expected = [ 'PKG-INFO', 'SOURCES.txt', 'dependency_links.txt', 'entry_points.txt', 'not-zip-safe', 'top_level.txt', ] assert sorted(actual) == expected def test_manifest_template_is_read(self, tmpdir_cwd, env): self._create_project() build_files({ 'MANIFEST.in': DALS(""" recursive-include docs *.rst """), 'docs': { 'usage.rst': "Run 'hi'", } }) self._run_install_command(tmpdir_cwd, env) egg_info_dir = self._find_egg_info_files(env.paths['lib']).base sources_txt = os.path.join(egg_info_dir, 'SOURCES.txt') assert 'docs/usage.rst' in open(sources_txt).read().split('\n') def _setup_script_with_requires(self, requires_line): setup_script = DALS(""" from setuptools import setup setup( name='foo', %s zip_safe=False, ) """ % requires_line) build_files({ 'setup.py': setup_script, }) def test_install_requires_with_markers(self, tmpdir_cwd, env): self._setup_script_with_requires( """install_requires=["barbazquux;python_version<'2'"],""") self._run_install_command(tmpdir_cwd, env) egg_info_dir = self._find_egg_info_files(env.paths['lib']).base requires_txt = os.path.join(egg_info_dir, 'requires.txt') assert "barbazquux;python_version<'2'" in open( requires_txt).read().split('\n') assert glob.glob(os.path.join(env.paths['lib'], 'barbazquux*')) == [] def test_setup_requires_with_markers(self, tmpdir_cwd, env): self._setup_script_with_requires( """setup_requires=["barbazquux;python_version<'2'"],""") self._run_install_command(tmpdir_cwd, env) assert glob.glob(os.path.join(env.paths['lib'], 'barbazquux*')) == [] def test_tests_require_with_markers(self, tmpdir_cwd, env): self._setup_script_with_requires( """tests_require=["barbazquux;python_version<'2'"],""") self._run_install_command( tmpdir_cwd, env, cmd=['test'], output="Ran 0 tests in") assert glob.glob(os.path.join(env.paths['lib'], 'barbazquux*')) == [] def test_extra_requires_with_markers(self, tmpdir_cwd, env): self._setup_script_with_requires( """extra_requires={":python_version<'2'": ["barbazquux"]},""") self._run_install_command(tmpdir_cwd, env) assert glob.glob(os.path.join(env.paths['lib'], 'barbazquux*')) == [] def _run_install_command(self, tmpdir_cwd, env, cmd=None, output=None): environ = os.environ.copy().update( HOME=env.paths['home'], ) if cmd is None: cmd = [ 'install', '--home', env.paths['home'], '--install-lib', env.paths['lib'], '--install-scripts', env.paths['scripts'], '--install-data', env.paths['data'], ] code, data = environment.run_setup_py( cmd=cmd, pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, env=environ, ) if code: raise AssertionError(data) if output: assert output in data def _find_egg_info_files(self, root): class DirList(list): def __init__(self, files, base): super(DirList, self).__init__(files) self.base = base results = ( DirList(filenames, dirpath) for dirpath, dirnames, filenames in os.walk(root) if os.path.basename(dirpath) == 'EGG-INFO' ) # expect exactly one result result, = results return result setuptools-20.7.0/setuptools/tests/test_find_packages.py0000664000175000017500000001345212702524020024436 0ustar travistravis00000000000000"""Tests for setuptools.find_packages().""" import os import sys import shutil import tempfile import platform import pytest import setuptools from setuptools import find_packages find_420_packages = setuptools.PEP420PackageFinder.find # modeled after CPython's test.support.can_symlink def can_symlink(): TESTFN = tempfile.mktemp() symlink_path = TESTFN + "can_symlink" try: os.symlink(TESTFN, symlink_path) can = True except (OSError, NotImplementedError, AttributeError): can = False else: os.remove(symlink_path) globals().update(can_symlink=lambda: can) return can def has_symlink(): bad_symlink = ( # Windows symlink directory detection is broken on Python 3.2 platform.system() == 'Windows' and sys.version_info[:2] == (3,2) ) return can_symlink() and not bad_symlink class TestFindPackages: def setup_method(self, method): self.dist_dir = tempfile.mkdtemp() self._make_pkg_structure() def teardown_method(self, method): shutil.rmtree(self.dist_dir) def _make_pkg_structure(self): """Make basic package structure. dist/ docs/ conf.py pkg/ __pycache__/ nspkg/ mod.py subpkg/ assets/ asset __init__.py setup.py """ self.docs_dir = self._mkdir('docs', self.dist_dir) self._touch('conf.py', self.docs_dir) self.pkg_dir = self._mkdir('pkg', self.dist_dir) self._mkdir('__pycache__', self.pkg_dir) self.ns_pkg_dir = self._mkdir('nspkg', self.pkg_dir) self._touch('mod.py', self.ns_pkg_dir) self.sub_pkg_dir = self._mkdir('subpkg', self.pkg_dir) self.asset_dir = self._mkdir('assets', self.sub_pkg_dir) self._touch('asset', self.asset_dir) self._touch('__init__.py', self.sub_pkg_dir) self._touch('setup.py', self.dist_dir) def _mkdir(self, path, parent_dir=None): if parent_dir: path = os.path.join(parent_dir, path) os.mkdir(path) return path def _touch(self, path, dir_=None): if dir_: path = os.path.join(dir_, path) fp = open(path, 'w') fp.close() return path def test_regular_package(self): self._touch('__init__.py', self.pkg_dir) packages = find_packages(self.dist_dir) assert packages == ['pkg', 'pkg.subpkg'] def test_exclude(self): self._touch('__init__.py', self.pkg_dir) packages = find_packages(self.dist_dir, exclude=('pkg.*',)) assert packages == ['pkg'] def test_include_excludes_other(self): """ If include is specified, other packages should be excluded. """ self._touch('__init__.py', self.pkg_dir) alt_dir = self._mkdir('other_pkg', self.dist_dir) self._touch('__init__.py', alt_dir) packages = find_packages(self.dist_dir, include=['other_pkg']) assert packages == ['other_pkg'] def test_dir_with_dot_is_skipped(self): shutil.rmtree(os.path.join(self.dist_dir, 'pkg/subpkg/assets')) data_dir = self._mkdir('some.data', self.pkg_dir) self._touch('__init__.py', data_dir) self._touch('file.dat', data_dir) packages = find_packages(self.dist_dir) assert 'pkg.some.data' not in packages def test_dir_with_packages_in_subdir_is_excluded(self): """ Ensure that a package in a non-package such as build/pkg/__init__.py is excluded. """ build_dir = self._mkdir('build', self.dist_dir) build_pkg_dir = self._mkdir('pkg', build_dir) self._touch('__init__.py', build_pkg_dir) packages = find_packages(self.dist_dir) assert 'build.pkg' not in packages @pytest.mark.skipif(not has_symlink(), reason='Symlink support required') def test_symlinked_packages_are_included(self): """ A symbolically-linked directory should be treated like any other directory when matched as a package. Create a link from lpkg -> pkg. """ self._touch('__init__.py', self.pkg_dir) linked_pkg = os.path.join(self.dist_dir, 'lpkg') os.symlink('pkg', linked_pkg) assert os.path.isdir(linked_pkg) packages = find_packages(self.dist_dir) assert 'lpkg' in packages def _assert_packages(self, actual, expected): assert set(actual) == set(expected) def test_pep420_ns_package(self): packages = find_420_packages( self.dist_dir, include=['pkg*'], exclude=['pkg.subpkg.assets']) self._assert_packages(packages, ['pkg', 'pkg.nspkg', 'pkg.subpkg']) def test_pep420_ns_package_no_includes(self): packages = find_420_packages( self.dist_dir, exclude=['pkg.subpkg.assets']) self._assert_packages(packages, ['docs', 'pkg', 'pkg.nspkg', 'pkg.subpkg']) def test_pep420_ns_package_no_includes_or_excludes(self): packages = find_420_packages(self.dist_dir) expected = [ 'docs', 'pkg', 'pkg.nspkg', 'pkg.subpkg', 'pkg.subpkg.assets'] self._assert_packages(packages, expected) def test_regular_package_with_nested_pep420_ns_packages(self): self._touch('__init__.py', self.pkg_dir) packages = find_420_packages( self.dist_dir, exclude=['docs', 'pkg.subpkg.assets']) self._assert_packages(packages, ['pkg', 'pkg.nspkg', 'pkg.subpkg']) def test_pep420_ns_package_no_non_package_dirs(self): shutil.rmtree(self.docs_dir) shutil.rmtree(os.path.join(self.dist_dir, 'pkg/subpkg/assets')) packages = find_420_packages(self.dist_dir) self._assert_packages(packages, ['pkg', 'pkg.nspkg', 'pkg.subpkg']) setuptools-20.7.0/setuptools/tests/test_integration.py0000664000175000017500000000566412702524020024211 0ustar travistravis00000000000000"""Run some integration tests. Try to install a few packages. """ import glob import os import sys from setuptools.extern.six.moves import urllib import pytest from setuptools.command.easy_install import easy_install from setuptools.command import easy_install as easy_install_pkg from setuptools.dist import Distribution def setup_module(module): packages = 'stevedore', 'virtualenvwrapper', 'pbr', 'novaclient' for pkg in packages: try: __import__(pkg) tmpl = "Integration tests cannot run when {pkg} is installed" pytest.skip(tmpl.format(**locals())) except ImportError: pass try: urllib.request.urlopen('https://pypi.python.org/pypi') except Exception as exc: pytest.skip(str(exc)) @pytest.fixture def install_context(request, tmpdir, monkeypatch): """Fixture to set up temporary installation directory. """ # Save old values so we can restore them. new_cwd = tmpdir.mkdir('cwd') user_base = tmpdir.mkdir('user_base') user_site = tmpdir.mkdir('user_site') install_dir = tmpdir.mkdir('install_dir') def fin(): # undo the monkeypatch, particularly needed under # windows because of kept handle on cwd monkeypatch.undo() new_cwd.remove() user_base.remove() user_site.remove() install_dir.remove() request.addfinalizer(fin) # Change the environment and site settings to control where the # files are installed and ensure we do not overwrite anything. monkeypatch.chdir(new_cwd) monkeypatch.setattr(easy_install_pkg, '__file__', user_site.strpath) monkeypatch.setattr('site.USER_BASE', user_base.strpath) monkeypatch.setattr('site.USER_SITE', user_site.strpath) monkeypatch.setattr('sys.path', sys.path + [install_dir.strpath]) monkeypatch.setenv('PYTHONPATH', os.path.pathsep.join(sys.path)) # Set up the command for performing the installation. dist = Distribution() cmd = easy_install(dist) cmd.install_dir = install_dir.strpath return cmd def _install_one(requirement, cmd, pkgname, modulename): cmd.args = [requirement] cmd.ensure_finalized() cmd.run() target = cmd.install_dir dest_path = glob.glob(os.path.join(target, pkgname + '*.egg')) assert dest_path assert os.path.exists(os.path.join(dest_path[0], pkgname, modulename)) def test_stevedore(install_context): _install_one('stevedore', install_context, 'stevedore', 'extension.py') @pytest.mark.xfail def test_virtualenvwrapper(install_context): _install_one('virtualenvwrapper', install_context, 'virtualenvwrapper', 'hook_loader.py') def test_pbr(install_context): _install_one('pbr', install_context, 'pbr', 'core.py') @pytest.mark.xfail def test_python_novaclient(install_context): _install_one('python-novaclient', install_context, 'novaclient', 'base.py') setuptools-20.7.0/setuptools/tests/test_msvc9compiler.py0000664000175000017500000001340512702524020024452 0ustar travistravis00000000000000""" Tests for msvc9compiler. """ import os import contextlib import distutils.errors import pytest try: from unittest import mock except ImportError: import mock from . import contexts # importing only setuptools should apply the patch __import__('setuptools') pytest.importorskip("distutils.msvc9compiler") def mock_reg(hkcu=None, hklm=None): """ Return a mock for distutils.msvc9compiler.Reg, patched to mock out the functions that access the registry. """ _winreg = getattr(distutils.msvc9compiler, '_winreg', None) winreg = getattr(distutils.msvc9compiler, 'winreg', _winreg) hives = { winreg.HKEY_CURRENT_USER: hkcu or {}, winreg.HKEY_LOCAL_MACHINE: hklm or {}, } @classmethod def read_keys(cls, base, key): """Return list of registry keys.""" hive = hives.get(base, {}) return [ k.rpartition('\\')[2] for k in hive if k.startswith(key.lower()) ] @classmethod def read_values(cls, base, key): """Return dict of registry keys and values.""" hive = hives.get(base, {}) return dict( (k.rpartition('\\')[2], hive[k]) for k in hive if k.startswith(key.lower()) ) return mock.patch.multiple(distutils.msvc9compiler.Reg, read_keys=read_keys, read_values=read_values) class TestModulePatch: """ Ensure that importing setuptools is sufficient to replace the standard find_vcvarsall function with a version that recognizes the "Visual C++ for Python" package. """ key_32 = r'software\microsoft\devdiv\vcforpython\9.0\installdir' key_64 = r'software\wow6432node\microsoft\devdiv\vcforpython\9.0\installdir' def test_patched(self): "Test the module is actually patched" mod_name = distutils.msvc9compiler.find_vcvarsall.__module__ assert mod_name == "setuptools.msvc9_support", "find_vcvarsall unpatched" def test_no_registry_entryies_means_nothing_found(self): """ No registry entries or environment variable should lead to an error directing the user to download vcpython27. """ find_vcvarsall = distutils.msvc9compiler.find_vcvarsall query_vcvarsall = distutils.msvc9compiler.query_vcvarsall with contexts.environment(VS90COMNTOOLS=None): with mock_reg(): assert find_vcvarsall(9.0) is None expected = distutils.errors.DistutilsPlatformError with pytest.raises(expected) as exc: query_vcvarsall(9.0) assert 'aka.ms/vcpython27' in str(exc) @pytest.yield_fixture def user_preferred_setting(self): """ Set up environment with different install dirs for user vs. system and yield the user_install_dir for the expected result. """ with self.mock_install_dir() as user_install_dir: with self.mock_install_dir() as system_install_dir: reg = mock_reg( hkcu={ self.key_32: user_install_dir, }, hklm={ self.key_32: system_install_dir, self.key_64: system_install_dir, }, ) with reg: yield user_install_dir def test_prefer_current_user(self, user_preferred_setting): """ Ensure user's settings are preferred. """ result = distutils.msvc9compiler.find_vcvarsall(9.0) expected = os.path.join(user_preferred_setting, 'vcvarsall.bat') assert expected == result @pytest.yield_fixture def local_machine_setting(self): """ Set up environment with only the system environment configured. """ with self.mock_install_dir() as system_install_dir: reg = mock_reg( hklm={ self.key_32: system_install_dir, }, ) with reg: yield system_install_dir def test_local_machine_recognized(self, local_machine_setting): """ Ensure machine setting is honored if user settings are not present. """ result = distutils.msvc9compiler.find_vcvarsall(9.0) expected = os.path.join(local_machine_setting, 'vcvarsall.bat') assert expected == result @pytest.yield_fixture def x64_preferred_setting(self): """ Set up environment with 64-bit and 32-bit system settings configured and yield the canonical location. """ with self.mock_install_dir() as x32_dir: with self.mock_install_dir() as x64_dir: reg = mock_reg( hklm={ # This *should* only exist on 32-bit machines self.key_32: x32_dir, # This *should* only exist on 64-bit machines self.key_64: x64_dir, }, ) with reg: yield x32_dir def test_ensure_64_bit_preferred(self, x64_preferred_setting): """ Ensure 64-bit system key is preferred. """ result = distutils.msvc9compiler.find_vcvarsall(9.0) expected = os.path.join(x64_preferred_setting, 'vcvarsall.bat') assert expected == result @staticmethod @contextlib.contextmanager def mock_install_dir(): """ Make a mock install dir in a unique location so that tests can distinguish which dir was detected in a given scenario. """ with contexts.tempdir() as result: vcvarsall = os.path.join(result, 'vcvarsall.bat') with open(vcvarsall, 'w'): pass yield result setuptools-20.7.0/setuptools/tests/test_packageindex.py0000664000175000017500000001745412702524020024311 0ustar travistravis00000000000000from __future__ import absolute_import import sys import os import distutils.errors from setuptools.extern import six from setuptools.extern.six.moves import urllib, http_client from .textwrap import DALS import pkg_resources import setuptools.package_index from setuptools.tests.server import IndexServer class TestPackageIndex: def test_bad_url_bad_port(self): index = setuptools.package_index.PackageIndex() url = 'http://127.0.0.1:0/nonesuch/test_package_index' try: v = index.open_url(url) except Exception as v: assert url in str(v) else: assert isinstance(v, urllib.error.HTTPError) def test_bad_url_typo(self): # issue 16 # easy_install inquant.contentmirror.plone breaks because of a typo # in its home URL index = setuptools.package_index.PackageIndex( hosts=('www.example.com',) ) url = 'url:%20https://svn.plone.org/svn/collective/inquant.contentmirror.plone/trunk' try: v = index.open_url(url) except Exception as v: assert url in str(v) else: assert isinstance(v, urllib.error.HTTPError) def test_bad_url_bad_status_line(self): index = setuptools.package_index.PackageIndex( hosts=('www.example.com',) ) def _urlopen(*args): raise http_client.BadStatusLine('line') index.opener = _urlopen url = 'http://example.com' try: v = index.open_url(url) except Exception as v: assert 'line' in str(v) else: raise AssertionError('Should have raise here!') def test_bad_url_double_scheme(self): """ A bad URL with a double scheme should raise a DistutilsError. """ index = setuptools.package_index.PackageIndex( hosts=('www.example.com',) ) # issue 20 url = 'http://http://svn.pythonpaste.org/Paste/wphp/trunk' try: index.open_url(url) except distutils.errors.DistutilsError as error: msg = six.text_type(error) assert 'nonnumeric port' in msg or 'getaddrinfo failed' in msg or 'Name or service not known' in msg return raise RuntimeError("Did not raise") def test_bad_url_screwy_href(self): index = setuptools.package_index.PackageIndex( hosts=('www.example.com',) ) # issue #160 if sys.version_info[0] == 2 and sys.version_info[1] == 7: # this should not fail url = 'http://example.com' page = ('') index.process_index(url, page) def test_url_ok(self): index = setuptools.package_index.PackageIndex( hosts=('www.example.com',) ) url = 'file:///tmp/test_package_index' assert index.url_ok(url, True) def test_links_priority(self): """ Download links from the pypi simple index should be used before external download links. https://bitbucket.org/tarek/distribute/issue/163 Usecase : - someone uploads a package on pypi, a md5 is generated - someone manually copies this link (with the md5 in the url) onto an external page accessible from the package page. - someone reuploads the package (with a different md5) - while easy_installing, an MD5 error occurs because the external link is used -> Setuptools should use the link from pypi, not the external one. """ if sys.platform.startswith('java'): # Skip this test on jython because binding to :0 fails return # start an index server server = IndexServer() server.start() index_url = server.base_url() + 'test_links_priority/simple/' # scan a test index pi = setuptools.package_index.PackageIndex(index_url) requirement = pkg_resources.Requirement.parse('foobar') pi.find_packages(requirement) server.stop() # the distribution has been found assert 'foobar' in pi # we have only one link, because links are compared without md5 assert len(pi['foobar'])==1 # the link should be from the index assert 'correct_md5' in pi['foobar'][0].location def test_parse_bdist_wininst(self): parse = setuptools.package_index.parse_bdist_wininst actual = parse('reportlab-2.5.win32-py2.4.exe') expected = 'reportlab-2.5', '2.4', 'win32' assert actual == expected actual = parse('reportlab-2.5.win32.exe') expected = 'reportlab-2.5', None, 'win32' assert actual == expected actual = parse('reportlab-2.5.win-amd64-py2.7.exe') expected = 'reportlab-2.5', '2.7', 'win-amd64' assert actual == expected actual = parse('reportlab-2.5.win-amd64.exe') expected = 'reportlab-2.5', None, 'win-amd64' assert actual == expected def test__vcs_split_rev_from_url(self): """ Test the basic usage of _vcs_split_rev_from_url """ vsrfu = setuptools.package_index.PackageIndex._vcs_split_rev_from_url url, rev = vsrfu('https://example.com/bar@2995') assert url == 'https://example.com/bar' assert rev == '2995' def test_local_index(self, tmpdir): """ local_open should be able to read an index from the file system. """ index_file = tmpdir / 'index.html' with index_file.open('w') as f: f.write('
    content
    ') url = 'file:' + urllib.request.pathname2url(str(tmpdir)) + '/' res = setuptools.package_index.local_open(url) assert 'content' in res.read() class TestContentCheckers: def test_md5(self): checker = setuptools.package_index.HashChecker.from_url( 'http://foo/bar#md5=f12895fdffbd45007040d2e44df98478') checker.feed('You should probably not be using MD5'.encode('ascii')) assert checker.hash.hexdigest() == 'f12895fdffbd45007040d2e44df98478' assert checker.is_valid() def test_other_fragment(self): "Content checks should succeed silently if no hash is present" checker = setuptools.package_index.HashChecker.from_url( 'http://foo/bar#something%20completely%20different') checker.feed('anything'.encode('ascii')) assert checker.is_valid() def test_blank_md5(self): "Content checks should succeed if a hash is empty" checker = setuptools.package_index.HashChecker.from_url( 'http://foo/bar#md5=') checker.feed('anything'.encode('ascii')) assert checker.is_valid() def test_get_hash_name_md5(self): checker = setuptools.package_index.HashChecker.from_url( 'http://foo/bar#md5=f12895fdffbd45007040d2e44df98478') assert checker.hash_name == 'md5' def test_report(self): checker = setuptools.package_index.HashChecker.from_url( 'http://foo/bar#md5=f12895fdffbd45007040d2e44df98478') rep = checker.report(lambda x: x, 'My message about %s') assert rep == 'My message about md5' class TestPyPIConfig: def test_percent_in_password(self, tmpdir, monkeypatch): monkeypatch.setitem(os.environ, 'HOME', str(tmpdir)) pypirc = tmpdir / '.pypirc' with pypirc.open('w') as strm: strm.write(DALS(""" [pypi] repository=https://pypi.python.org username=jaraco password=pity% """)) cfg = setuptools.package_index.PyPIConfig() cred = cfg.creds_by_repository['https://pypi.python.org'] assert cred.username == 'jaraco' assert cred.password == 'pity%' setuptools-20.7.0/setuptools/tests/test_sandbox.py0000664000175000017500000001077412702524020023322 0ustar travistravis00000000000000"""develop tests """ import os import types import pytest import pkg_resources import setuptools.sandbox from setuptools.sandbox import DirectorySandbox class TestSandbox: def test_devnull(self, tmpdir): sandbox = DirectorySandbox(str(tmpdir)) sandbox.run(self._file_writer(os.devnull)) @staticmethod def _file_writer(path): def do_write(): with open(path, 'w') as f: f.write('xxx') return do_write def test_win32com(self, tmpdir): """ win32com should not be prevented from caching COM interfaces in gen_py. """ win32com = pytest.importorskip('win32com') gen_py = win32com.__gen_path__ target = os.path.join(gen_py, 'test_write') sandbox = DirectorySandbox(str(tmpdir)) try: # attempt to create gen_py file sandbox.run(self._file_writer(target)) finally: if os.path.exists(target): os.remove(target) def test_setup_py_with_BOM(self): """ It should be possible to execute a setup.py with a Byte Order Mark """ target = pkg_resources.resource_filename(__name__, 'script-with-bom.py') namespace = types.ModuleType('namespace') setuptools.sandbox._execfile(target, vars(namespace)) assert namespace.result == 'passed' def test_setup_py_with_CRLF(self, tmpdir): setup_py = tmpdir / 'setup.py' with setup_py.open('wb') as stream: stream.write(b'"degenerate script"\r\n') setuptools.sandbox._execfile(str(setup_py), globals()) class TestExceptionSaver: def test_exception_trapped(self): with setuptools.sandbox.ExceptionSaver(): raise ValueError("details") def test_exception_resumed(self): with setuptools.sandbox.ExceptionSaver() as saved_exc: raise ValueError("details") with pytest.raises(ValueError) as caught: saved_exc.resume() assert isinstance(caught.value, ValueError) assert str(caught.value) == 'details' def test_exception_reconstructed(self): orig_exc = ValueError("details") with setuptools.sandbox.ExceptionSaver() as saved_exc: raise orig_exc with pytest.raises(ValueError) as caught: saved_exc.resume() assert isinstance(caught.value, ValueError) assert caught.value is not orig_exc def test_no_exception_passes_quietly(self): with setuptools.sandbox.ExceptionSaver() as saved_exc: pass saved_exc.resume() def test_unpickleable_exception(self): class CantPickleThis(Exception): "This Exception is unpickleable because it's not in globals" with setuptools.sandbox.ExceptionSaver() as saved_exc: raise CantPickleThis('detail') with pytest.raises(setuptools.sandbox.UnpickleableException) as caught: saved_exc.resume() assert str(caught.value) == "CantPickleThis('detail',)" def test_unpickleable_exception_when_hiding_setuptools(self): """ As revealed in #440, an infinite recursion can occur if an unpickleable exception while setuptools is hidden. Ensure this doesn't happen. """ class ExceptionUnderTest(Exception): """ An unpickleable exception (not in globals). """ with pytest.raises(setuptools.sandbox.UnpickleableException) as caught: with setuptools.sandbox.save_modules(): setuptools.sandbox.hide_setuptools() raise ExceptionUnderTest() msg, = caught.value.args assert msg == 'ExceptionUnderTest()' def test_sandbox_violation_raised_hiding_setuptools(self, tmpdir): """ When in a sandbox with setuptools hidden, a SandboxViolation should reflect a proper exception and not be wrapped in an UnpickleableException. """ def write_file(): "Trigger a SandboxViolation by writing outside the sandbox" with open('/etc/foo', 'w'): pass sandbox = DirectorySandbox(str(tmpdir)) with pytest.raises(setuptools.sandbox.SandboxViolation) as caught: with setuptools.sandbox.save_modules(): setuptools.sandbox.hide_setuptools() sandbox.run(write_file) cmd, args, kwargs = caught.value.args assert cmd == 'open' assert args == ('/etc/foo', 'w') assert kwargs == {} setuptools-20.7.0/setuptools/tests/test_sdist.py0000664000175000017500000003222712702524020023007 0ustar travistravis00000000000000# -*- coding: utf-8 -*- """sdist tests""" import os import shutil import sys import tempfile import unicodedata import contextlib import io from setuptools.extern import six from setuptools.extern.six.moves import map import pytest import pkg_resources from setuptools.command.sdist import sdist from setuptools.command.egg_info import manifest_maker from setuptools.dist import Distribution from setuptools.tests import fail_on_ascii py3_only = pytest.mark.xfail(six.PY2, reason="Test runs on Python 3 only") SETUP_ATTRS = { 'name': 'sdist_test', 'version': '0.0', 'packages': ['sdist_test'], 'package_data': {'sdist_test': ['*.txt']} } SETUP_PY = """\ from setuptools import setup setup(**%r) """ % SETUP_ATTRS if six.PY3: LATIN1_FILENAME = 'smörbröd.py'.encode('latin-1') else: LATIN1_FILENAME = 'sm\xf6rbr\xf6d.py' # Cannot use context manager because of Python 2.4 @contextlib.contextmanager def quiet(): old_stdout, old_stderr = sys.stdout, sys.stderr sys.stdout, sys.stderr = six.StringIO(), six.StringIO() try: yield finally: sys.stdout, sys.stderr = old_stdout, old_stderr # Fake byte literals for Python <= 2.5 def b(s, encoding='utf-8'): if six.PY3: return s.encode(encoding) return s # Convert to POSIX path def posix(path): if six.PY3 and not isinstance(path, str): return path.replace(os.sep.encode('ascii'), b('/')) else: return path.replace(os.sep, '/') # HFS Plus uses decomposed UTF-8 def decompose(path): if isinstance(path, six.text_type): return unicodedata.normalize('NFD', path) try: path = path.decode('utf-8') path = unicodedata.normalize('NFD', path) path = path.encode('utf-8') except UnicodeError: pass # Not UTF-8 return path def read_all_bytes(filename): with io.open(filename, 'rb') as fp: return fp.read() class TestSdistTest: def setup_method(self, method): self.temp_dir = tempfile.mkdtemp() f = open(os.path.join(self.temp_dir, 'setup.py'), 'w') f.write(SETUP_PY) f.close() # Set up the rest of the test package test_pkg = os.path.join(self.temp_dir, 'sdist_test') os.mkdir(test_pkg) # *.rst was not included in package_data, so c.rst should not be # automatically added to the manifest when not under version control for fname in ['__init__.py', 'a.txt', 'b.txt', 'c.rst']: # Just touch the files; their contents are irrelevant open(os.path.join(test_pkg, fname), 'w').close() self.old_cwd = os.getcwd() os.chdir(self.temp_dir) def teardown_method(self, method): os.chdir(self.old_cwd) shutil.rmtree(self.temp_dir) def test_package_data_in_sdist(self): """Regression test for pull request #4: ensures that files listed in package_data are included in the manifest even if they're not added to version control. """ dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() manifest = cmd.filelist.files assert os.path.join('sdist_test', 'a.txt') in manifest assert os.path.join('sdist_test', 'b.txt') in manifest assert os.path.join('sdist_test', 'c.rst') not in manifest def test_defaults_case_sensitivity(self): """ Make sure default files (README.*, etc.) are added in a case-sensitive way to avoid problems with packages built on Windows. """ open(os.path.join(self.temp_dir, 'readme.rst'), 'w').close() open(os.path.join(self.temp_dir, 'SETUP.cfg'), 'w').close() dist = Distribution(SETUP_ATTRS) # the extension deliberately capitalized for this test # to make sure the actual filename (not capitalized) gets added # to the manifest dist.script_name = 'setup.PY' cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() # lowercase all names so we can test in a case-insensitive way to make sure the files are not included manifest = map(lambda x: x.lower(), cmd.filelist.files) assert 'readme.rst' not in manifest, manifest assert 'setup.py' not in manifest, manifest assert 'setup.cfg' not in manifest, manifest @fail_on_ascii def test_manifest_is_written_with_utf8_encoding(self): # Test for #303. dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' mm = manifest_maker(dist) mm.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') os.mkdir('sdist_test.egg-info') # UTF-8 filename filename = os.path.join('sdist_test', 'smörbröd.py') # Must create the file or it will get stripped. open(filename, 'w').close() # Add UTF-8 filename and write manifest with quiet(): mm.run() mm.filelist.append(filename) mm.write_manifest() contents = read_all_bytes(mm.manifest) # The manifest should be UTF-8 encoded u_contents = contents.decode('UTF-8') # The manifest should contain the UTF-8 filename if six.PY2: fs_enc = sys.getfilesystemencoding() filename = filename.decode(fs_enc) assert posix(filename) in u_contents @py3_only @fail_on_ascii def test_write_manifest_allows_utf8_filenames(self): # Test for #303. dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' mm = manifest_maker(dist) mm.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') os.mkdir('sdist_test.egg-info') # UTF-8 filename filename = os.path.join(b('sdist_test'), b('smörbröd.py')) # Must touch the file or risk removal open(filename, "w").close() # Add filename and write manifest with quiet(): mm.run() u_filename = filename.decode('utf-8') mm.filelist.files.append(u_filename) # Re-write manifest mm.write_manifest() contents = read_all_bytes(mm.manifest) # The manifest should be UTF-8 encoded contents.decode('UTF-8') # The manifest should contain the UTF-8 filename assert posix(filename) in contents # The filelist should have been updated as well assert u_filename in mm.filelist.files @py3_only def test_write_manifest_skips_non_utf8_filenames(self): """ Files that cannot be encoded to UTF-8 (specifically, those that weren't originally successfully decoded and have surrogate escapes) should be omitted from the manifest. See https://bitbucket.org/tarek/distribute/issue/303 for history. """ dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' mm = manifest_maker(dist) mm.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') os.mkdir('sdist_test.egg-info') # Latin-1 filename filename = os.path.join(b('sdist_test'), LATIN1_FILENAME) # Add filename with surrogates and write manifest with quiet(): mm.run() u_filename = filename.decode('utf-8', 'surrogateescape') mm.filelist.append(u_filename) # Re-write manifest mm.write_manifest() contents = read_all_bytes(mm.manifest) # The manifest should be UTF-8 encoded contents.decode('UTF-8') # The Latin-1 filename should have been skipped assert posix(filename) not in contents # The filelist should have been updated as well assert u_filename not in mm.filelist.files @fail_on_ascii def test_manifest_is_read_with_utf8_encoding(self): # Test for #303. dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() # Create manifest with quiet(): cmd.run() # Add UTF-8 filename to manifest filename = os.path.join(b('sdist_test'), b('smörbröd.py')) cmd.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') manifest = open(cmd.manifest, 'ab') manifest.write(b('\n') + filename) manifest.close() # The file must exist to be included in the filelist open(filename, 'w').close() # Re-read manifest cmd.filelist.files = [] with quiet(): cmd.read_manifest() # The filelist should contain the UTF-8 filename if six.PY3: filename = filename.decode('utf-8') assert filename in cmd.filelist.files @py3_only def test_read_manifest_skips_non_utf8_filenames(self): # Test for #303. dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() # Create manifest with quiet(): cmd.run() # Add Latin-1 filename to manifest filename = os.path.join(b('sdist_test'), LATIN1_FILENAME) cmd.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') manifest = open(cmd.manifest, 'ab') manifest.write(b('\n') + filename) manifest.close() # The file must exist to be included in the filelist open(filename, 'w').close() # Re-read manifest cmd.filelist.files = [] with quiet(): cmd.read_manifest() # The Latin-1 filename should have been skipped filename = filename.decode('latin-1') assert filename not in cmd.filelist.files @fail_on_ascii def test_sdist_with_utf8_encoded_filename(self): # Test for #303. dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() # UTF-8 filename filename = os.path.join(b('sdist_test'), b('smörbröd.py')) open(filename, 'w').close() with quiet(): cmd.run() if sys.platform == 'darwin': filename = decompose(filename) if six.PY3: fs_enc = sys.getfilesystemencoding() if sys.platform == 'win32': if fs_enc == 'cp1252': # Python 3 mangles the UTF-8 filename filename = filename.decode('cp1252') assert filename in cmd.filelist.files else: filename = filename.decode('mbcs') assert filename in cmd.filelist.files else: filename = filename.decode('utf-8') assert filename in cmd.filelist.files else: assert filename in cmd.filelist.files def test_sdist_with_latin1_encoded_filename(self): # Test for #303. dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() # Latin-1 filename filename = os.path.join(b('sdist_test'), LATIN1_FILENAME) open(filename, 'w').close() assert os.path.isfile(filename) with quiet(): cmd.run() if six.PY3: # not all windows systems have a default FS encoding of cp1252 if sys.platform == 'win32': # Latin-1 is similar to Windows-1252 however # on mbcs filesys it is not in latin-1 encoding fs_enc = sys.getfilesystemencoding() if fs_enc == 'mbcs': filename = filename.decode('mbcs') else: filename = filename.decode('latin-1') assert filename in cmd.filelist.files else: # The Latin-1 filename should have been skipped filename = filename.decode('latin-1') filename not in cmd.filelist.files else: # Under Python 2 there seems to be no decoded string in the # filelist. However, due to decode and encoding of the # file name to get utf-8 Manifest the latin1 maybe excluded try: # fs_enc should match how one is expect the decoding to # be proformed for the manifest output. fs_enc = sys.getfilesystemencoding() filename.decode(fs_enc) assert filename in cmd.filelist.files except UnicodeDecodeError: filename not in cmd.filelist.files def test_default_revctrl(): """ When _default_revctrl was removed from the `setuptools.command.sdist` module in 10.0, it broke some systems which keep an old install of setuptools (Distribute) around. Those old versions require that the setuptools package continue to implement that interface, so this function provides that interface, stubbed. See #320 for details. This interface must be maintained until Ubuntu 12.04 is no longer supported (by Setuptools). """ ep_def = 'svn_cvs = setuptools.command.sdist:_default_revctrl' ep = pkg_resources.EntryPoint.parse(ep_def) res = ep.resolve() assert hasattr(res, '__iter__') setuptools-20.7.0/setuptools/tests/test_setuptools.py0000664000175000017500000000221012702524020024067 0ustar travistravis00000000000000import os import pytest import setuptools @pytest.fixture def example_source(tmpdir): tmpdir.mkdir('foo') (tmpdir / 'foo/bar.py').write('') (tmpdir / 'readme.txt').write('') return tmpdir def test_findall(example_source): found = list(setuptools.findall(str(example_source))) expected = ['readme.txt', 'foo/bar.py'] expected = [example_source.join(fn) for fn in expected] assert found == expected def test_findall_curdir(example_source): with example_source.as_cwd(): found = list(setuptools.findall()) expected = ['readme.txt', os.path.join('foo', 'bar.py')] assert found == expected @pytest.fixture def can_symlink(tmpdir): """ Skip if cannot create a symbolic link """ link_fn = 'link' target_fn = 'target' try: os.symlink(target_fn, link_fn) except (OSError, NotImplementedError, AttributeError): pytest.skip("Cannot create symbolic links") os.remove(link_fn) def test_findall_missing_symlink(tmpdir, can_symlink): with tmpdir.as_cwd(): os.symlink('foo', 'bar') found = list(setuptools.findall()) assert found == [] setuptools-20.7.0/setuptools/tests/test_test.py0000664000175000017500000000450512702524020022636 0ustar travistravis00000000000000# -*- coding: UTF-8 -*- from __future__ import unicode_literals import os import site from distutils.errors import DistutilsError import pytest from setuptools.command.test import test from setuptools.dist import Distribution from .textwrap import DALS from . import contexts SETUP_PY = DALS(""" from setuptools import setup setup(name='foo', packages=['name', 'name.space', 'name.space.tests'], namespace_packages=['name'], test_suite='name.space.tests.test_suite', ) """) NS_INIT = DALS(""" # -*- coding: Latin-1 -*- # Söme Arbiträry Ünicode to test Distribute Issüé 310 try: __import__('pkg_resources').declare_namespace(__name__) except ImportError: from pkgutil import extend_path __path__ = extend_path(__path__, __name__) """) TEST_PY = DALS(""" import unittest class TestTest(unittest.TestCase): def test_test(self): print "Foo" # Should fail under Python 3 unless 2to3 is used test_suite = unittest.makeSuite(TestTest) """) @pytest.fixture def sample_test(tmpdir_cwd): os.makedirs('name/space/tests') # setup.py with open('setup.py', 'wt') as f: f.write(SETUP_PY) # name/__init__.py with open('name/__init__.py', 'wb') as f: f.write(NS_INIT.encode('Latin-1')) # name/space/__init__.py with open('name/space/__init__.py', 'wt') as f: f.write('#empty\n') # name/space/tests/__init__.py with open('name/space/tests/__init__.py', 'wt') as f: f.write(TEST_PY) @pytest.mark.skipif('hasattr(sys, "real_prefix")') @pytest.mark.usefixtures('user_override') @pytest.mark.usefixtures('sample_test') class TestTestTest: def test_test(self): params = dict( name='foo', packages=['name', 'name.space', 'name.space.tests'], namespace_packages=['name'], test_suite='name.space.tests.test_suite', use_2to3=True, ) dist = Distribution(params) dist.script_name = 'setup.py' cmd = test(dist) cmd.user = 1 cmd.ensure_finalized() cmd.install_dir = site.USER_SITE cmd.user = 1 with contexts.quiet(): # The test runner calls sys.exit with contexts.suppress_exceptions(SystemExit): cmd.run() setuptools-20.7.0/setuptools/tests/test_unicode_utils.py0000664000175000017500000000047412702524020024526 0ustar travistravis00000000000000from setuptools import unicode_utils def test_filesys_decode_fs_encoding_is_None(monkeypatch): """ Test filesys_decode does not raise TypeError when getfilesystemencoding returns None. """ monkeypatch.setattr('sys.getfilesystemencoding', lambda: None) unicode_utils.filesys_decode(b'test') setuptools-20.7.0/setuptools/tests/test_upload_docs.py0000664000175000017500000000247212702524020024154 0ustar travistravis00000000000000import os import zipfile import contextlib import pytest from setuptools.command.upload_docs import upload_docs from setuptools.dist import Distribution from .textwrap import DALS from . import contexts SETUP_PY = DALS( """ from setuptools import setup setup(name='foo') """) @pytest.fixture def sample_project(tmpdir_cwd): # setup.py with open('setup.py', 'wt') as f: f.write(SETUP_PY) os.mkdir('build') # A test document. with open('build/index.html', 'w') as f: f.write("Hello world.") # An empty folder. os.mkdir('build/empty') @pytest.mark.usefixtures('sample_project') @pytest.mark.usefixtures('user_override') class TestUploadDocsTest: def test_create_zipfile(self): """ Ensure zipfile creation handles common cases, including a folder containing an empty folder. """ dist = Distribution() cmd = upload_docs(dist) cmd.target_dir = cmd.upload_dir = 'build' with contexts.tempdir() as tmp_dir: tmp_file = os.path.join(tmp_dir, 'foo.zip') zip_file = cmd.create_zipfile(tmp_file) assert zipfile.is_zipfile(tmp_file) with contextlib.closing(zipfile.ZipFile(tmp_file)) as zip_file: assert zip_file.namelist() == ['index.html'] setuptools-20.7.0/setuptools/tests/test_windows_wrappers.py0000664000175000017500000001401212702524020025266 0ustar travistravis00000000000000""" Python Script Wrapper for Windows ================================= setuptools includes wrappers for Python scripts that allows them to be executed like regular windows programs. There are 2 wrappers, one for command-line programs, cli.exe, and one for graphical programs, gui.exe. These programs are almost identical, function pretty much the same way, and are generated from the same source file. The wrapper programs are used by copying them to the directory containing the script they are to wrap and with the same name as the script they are to wrap. """ from __future__ import absolute_import import sys import textwrap import subprocess import pytest from setuptools.command.easy_install import nt_quote_arg import pkg_resources pytestmark = pytest.mark.skipif(sys.platform != 'win32', reason="Windows only") class WrapperTester: @classmethod def prep_script(cls, template): python_exe = nt_quote_arg(sys.executable) return template % locals() @classmethod def create_script(cls, tmpdir): """ Create a simple script, foo-script.py Note that the script starts with a Unix-style '#!' line saying which Python executable to run. The wrapper will use this line to find the correct Python executable. """ script = cls.prep_script(cls.script_tmpl) with (tmpdir / cls.script_name).open('w') as f: f.write(script) # also copy cli.exe to the sample directory with (tmpdir / cls.wrapper_name).open('wb') as f: w = pkg_resources.resource_string('setuptools', cls.wrapper_source) f.write(w) class TestCLI(WrapperTester): script_name = 'foo-script.py' wrapper_source = 'cli-32.exe' wrapper_name = 'foo.exe' script_tmpl = textwrap.dedent(""" #!%(python_exe)s import sys input = repr(sys.stdin.read()) print(sys.argv[0][-14:]) print(sys.argv[1:]) print(input) if __debug__: print('non-optimized') """).lstrip() def test_basic(self, tmpdir): """ When the copy of cli.exe, foo.exe in this example, runs, it examines the path name it was run with and computes a Python script path name by removing the '.exe' suffix and adding the '-script.py' suffix. (For GUI programs, the suffix '-script.pyw' is added.) This is why we named out script the way we did. Now we can run out script by running the wrapper: This example was a little pathological in that it exercised windows (MS C runtime) quoting rules: - Strings containing spaces are surrounded by double quotes. - Double quotes in strings need to be escaped by preceding them with back slashes. - One or more backslashes preceding double quotes need to be escaped by preceding each of them with back slashes. """ self.create_script(tmpdir) cmd = [ str(tmpdir / 'foo.exe'), 'arg1', 'arg 2', 'arg "2\\"', 'arg 4\\', 'arg5 a\\\\b', ] proc = subprocess.Popen(cmd, stdout=subprocess.PIPE, stdin=subprocess.PIPE) stdout, stderr = proc.communicate('hello\nworld\n'.encode('ascii')) actual = stdout.decode('ascii').replace('\r\n', '\n') expected = textwrap.dedent(r""" \foo-script.py ['arg1', 'arg 2', 'arg "2\\"', 'arg 4\\', 'arg5 a\\\\b'] 'hello\nworld\n' non-optimized """).lstrip() assert actual == expected def test_with_options(self, tmpdir): """ Specifying Python Command-line Options -------------------------------------- You can specify a single argument on the '#!' line. This can be used to specify Python options like -O, to run in optimized mode or -i to start the interactive interpreter. You can combine multiple options as usual. For example, to run in optimized mode and enter the interpreter after running the script, you could use -Oi: """ self.create_script(tmpdir) tmpl = textwrap.dedent(""" #!%(python_exe)s -Oi import sys input = repr(sys.stdin.read()) print(sys.argv[0][-14:]) print(sys.argv[1:]) print(input) if __debug__: print('non-optimized') sys.ps1 = '---' """).lstrip() with (tmpdir / 'foo-script.py').open('w') as f: f.write(self.prep_script(tmpl)) cmd = [str(tmpdir / 'foo.exe')] proc = subprocess.Popen(cmd, stdout=subprocess.PIPE, stdin=subprocess.PIPE, stderr=subprocess.STDOUT) stdout, stderr = proc.communicate() actual = stdout.decode('ascii').replace('\r\n', '\n') expected = textwrap.dedent(r""" \foo-script.py [] '' --- """).lstrip() assert actual == expected class TestGUI(WrapperTester): """ Testing the GUI Version ----------------------- """ script_name = 'bar-script.pyw' wrapper_source = 'gui-32.exe' wrapper_name = 'bar.exe' script_tmpl = textwrap.dedent(""" #!%(python_exe)s import sys f = open(sys.argv[1], 'wb') bytes_written = f.write(repr(sys.argv[2]).encode('utf-8')) f.close() """).strip() def test_basic(self, tmpdir): """Test the GUI version with the simple scipt, bar-script.py""" self.create_script(tmpdir) cmd = [ str(tmpdir / 'bar.exe'), str(tmpdir / 'test_output.txt'), 'Test Argument', ] proc = subprocess.Popen(cmd, stdout=subprocess.PIPE, stdin=subprocess.PIPE, stderr=subprocess.STDOUT) stdout, stderr = proc.communicate() assert not stdout assert not stderr with (tmpdir / 'test_output.txt').open('rb') as f_out: actual = f_out.read().decode('ascii') assert actual == repr('Test Argument') setuptools-20.7.0/setuptools/tests/textwrap.py0000664000175000017500000000021212702524020022465 0ustar travistravis00000000000000from __future__ import absolute_import import textwrap def DALS(s): "dedent and left-strip" return textwrap.dedent(s).lstrip() setuptools-20.7.0/setuptools/__init__.py0000664000175000017500000001250012702524020021207 0ustar travistravis00000000000000"""Extensions to the 'distutils' for large or complex distributions""" import os import functools import distutils.core import distutils.filelist from distutils.core import Command as _Command from distutils.util import convert_path from fnmatch import fnmatchcase from setuptools.extern.six.moves import filterfalse, map import setuptools.version from setuptools.extension import Extension from setuptools.dist import Distribution, Feature, _get_unpatched from setuptools.depends import Require __all__ = [ 'setup', 'Distribution', 'Feature', 'Command', 'Extension', 'Require', 'find_packages' ] __version__ = setuptools.version.__version__ bootstrap_install_from = None # If we run 2to3 on .py files, should we also convert docstrings? # Default: yes; assume that we can detect doctests reliably run_2to3_on_doctests = True # Standard package names for fixer packages lib2to3_fixer_packages = ['lib2to3.fixes'] class PackageFinder(object): @classmethod def find(cls, where='.', exclude=(), include=('*',)): """Return a list all Python packages found within directory 'where' 'where' should be supplied as a "cross-platform" (i.e. URL-style) path; it will be converted to the appropriate local path syntax. 'exclude' is a sequence of package names to exclude; '*' can be used as a wildcard in the names, such that 'foo.*' will exclude all subpackages of 'foo' (but not 'foo' itself). 'include' is a sequence of package names to include. If it's specified, only the named packages will be included. If it's not specified, all found packages will be included. 'include' can contain shell style wildcard patterns just like 'exclude'. The list of included packages is built up first and then any explicitly excluded packages are removed from it. """ out = cls._find_packages_iter(convert_path(where)) out = cls.require_parents(out) includes = cls._build_filter(*include) excludes = cls._build_filter('ez_setup', '*__pycache__', *exclude) out = filter(includes, out) out = filterfalse(excludes, out) return list(out) @staticmethod def require_parents(packages): """ Exclude any apparent package that apparently doesn't include its parent. For example, exclude 'foo.bar' if 'foo' is not present. """ found = [] for pkg in packages: base, sep, child = pkg.rpartition('.') if base and base not in found: continue found.append(pkg) yield pkg @staticmethod def _candidate_dirs(base_path): """ Return all dirs in base_path that might be packages. """ has_dot = lambda name: '.' in name for root, dirs, files in os.walk(base_path, followlinks=True): # Exclude directories that contain a period, as they cannot be # packages. Mutate the list to avoid traversal. dirs[:] = filterfalse(has_dot, dirs) for dir in dirs: yield os.path.relpath(os.path.join(root, dir), base_path) @classmethod def _find_packages_iter(cls, base_path): candidates = cls._candidate_dirs(base_path) return ( path.replace(os.path.sep, '.') for path in candidates if cls._looks_like_package(os.path.join(base_path, path)) ) @staticmethod def _looks_like_package(path): return os.path.isfile(os.path.join(path, '__init__.py')) @staticmethod def _build_filter(*patterns): """ Given a list of patterns, return a callable that will be true only if the input matches one of the patterns. """ return lambda name: any(fnmatchcase(name, pat=pat) for pat in patterns) class PEP420PackageFinder(PackageFinder): @staticmethod def _looks_like_package(path): return True find_packages = PackageFinder.find setup = distutils.core.setup _Command = _get_unpatched(_Command) class Command(_Command): __doc__ = _Command.__doc__ command_consumes_arguments = False def __init__(self, dist, **kw): """ Construct the command for dist, updating vars(self) with any keyword parameters. """ _Command.__init__(self, dist) vars(self).update(kw) def reinitialize_command(self, command, reinit_subcommands=0, **kw): cmd = _Command.reinitialize_command(self, command, reinit_subcommands) vars(cmd).update(kw) return cmd # we can't patch distutils.cmd, alas distutils.core.Command = Command def _find_all_simple(path): """ Find all files under 'path' """ results = ( os.path.join(base, file) for base, dirs, files in os.walk(path, followlinks=True) for file in files ) return filter(os.path.isfile, results) def findall(dir=os.curdir): """ Find all files under 'dir' and return the list of full filenames. Unless dir is '.', return full filenames with dir prepended. """ files = _find_all_simple(dir) if dir == os.curdir: make_rel = functools.partial(os.path.relpath, start=dir) files = map(make_rel, files) return list(files) # fix findall bug in distutils (http://bugs.python.org/issue12885) distutils.filelist.findall = findall setuptools-20.7.0/setuptools/archive_util.py0000775000175000017500000001472112702524020022140 0ustar travistravis00000000000000"""Utilities for extracting common archive formats""" __all__ = [ "unpack_archive", "unpack_zipfile", "unpack_tarfile", "default_filter", "UnrecognizedFormat", "extraction_drivers", "unpack_directory", ] import zipfile import tarfile import os import shutil import posixpath import contextlib from pkg_resources import ensure_directory, ContextualZipFile from distutils.errors import DistutilsError class UnrecognizedFormat(DistutilsError): """Couldn't recognize the archive type""" def default_filter(src,dst): """The default progress/filter callback; returns True for all files""" return dst def unpack_archive(filename, extract_dir, progress_filter=default_filter, drivers=None): """Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat`` `progress_filter` is a function taking two arguments: a source path internal to the archive ('/'-separated), and a filesystem path where it will be extracted. The callback must return the desired extract path (which may be the same as the one passed in), or else ``None`` to skip that file or directory. The callback can thus be used to report on the progress of the extraction, as well as to filter the items extracted or alter their extraction paths. `drivers`, if supplied, must be a non-empty sequence of functions with the same signature as this function (minus the `drivers` argument), that raise ``UnrecognizedFormat`` if they do not support extracting the designated archive type. The `drivers` are tried in sequence until one is found that does not raise an error, or until all are exhausted (in which case ``UnrecognizedFormat`` is raised). If you do not supply a sequence of drivers, the module's ``extraction_drivers`` constant will be used, which means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that order. """ for driver in drivers or extraction_drivers: try: driver(filename, extract_dir, progress_filter) except UnrecognizedFormat: continue else: return else: raise UnrecognizedFormat( "Not a recognized archive type: %s" % filename ) def unpack_directory(filename, extract_dir, progress_filter=default_filter): """"Unpack" a directory, using the same interface as for archives Raises ``UnrecognizedFormat`` if `filename` is not a directory """ if not os.path.isdir(filename): raise UnrecognizedFormat("%s is not a directory" % filename) paths = { filename: ('', extract_dir), } for base, dirs, files in os.walk(filename): src, dst = paths[base] for d in dirs: paths[os.path.join(base, d)] = src + d + '/', os.path.join(dst, d) for f in files: target = os.path.join(dst, f) target = progress_filter(src + f, target) if not target: # skip non-files continue ensure_directory(target) f = os.path.join(base, f) shutil.copyfile(f, target) shutil.copystat(f, target) def unpack_zipfile(filename, extract_dir, progress_filter=default_filter): """Unpack zip `filename` to `extract_dir` Raises ``UnrecognizedFormat`` if `filename` is not a zipfile (as determined by ``zipfile.is_zipfile()``). See ``unpack_archive()`` for an explanation of the `progress_filter` argument. """ if not zipfile.is_zipfile(filename): raise UnrecognizedFormat("%s is not a zip file" % (filename,)) with ContextualZipFile(filename) as z: for info in z.infolist(): name = info.filename # don't extract absolute paths or ones with .. in them if name.startswith('/') or '..' in name.split('/'): continue target = os.path.join(extract_dir, *name.split('/')) target = progress_filter(name, target) if not target: continue if name.endswith('/'): # directory ensure_directory(target) else: # file ensure_directory(target) data = z.read(info.filename) with open(target, 'wb') as f: f.write(data) unix_attributes = info.external_attr >> 16 if unix_attributes: os.chmod(target, unix_attributes) def unpack_tarfile(filename, extract_dir, progress_filter=default_filter): """Unpack tar/tar.gz/tar.bz2 `filename` to `extract_dir` Raises ``UnrecognizedFormat`` if `filename` is not a tarfile (as determined by ``tarfile.open()``). See ``unpack_archive()`` for an explanation of the `progress_filter` argument. """ try: tarobj = tarfile.open(filename) except tarfile.TarError: raise UnrecognizedFormat( "%s is not a compressed or uncompressed tar file" % (filename,) ) with contextlib.closing(tarobj): # don't do any chowning! tarobj.chown = lambda *args: None for member in tarobj: name = member.name # don't extract absolute paths or ones with .. in them if not name.startswith('/') and '..' not in name.split('/'): prelim_dst = os.path.join(extract_dir, *name.split('/')) # resolve any links and to extract the link targets as normal # files while member is not None and (member.islnk() or member.issym()): linkpath = member.linkname if member.issym(): base = posixpath.dirname(member.name) linkpath = posixpath.join(base, linkpath) linkpath = posixpath.normpath(linkpath) member = tarobj._getmember(linkpath) if member is not None and (member.isfile() or member.isdir()): final_dst = progress_filter(name, prelim_dst) if final_dst: if final_dst.endswith(os.sep): final_dst = final_dst[:-1] try: # XXX Ugh tarobj._extract_member(member, final_dst) except tarfile.ExtractError: # chown/chmod/mkfifo/mknode/makedev failed pass return True extraction_drivers = unpack_directory, unpack_zipfile, unpack_tarfile setuptools-20.7.0/setuptools/cli-32.exe0000664000175000017500000020000012702524020020564 0ustar travistravis00000000000000MZÿÿ¸@ິ Í!¸LÍ!This program cannot be run in DOS mode. $YSþj292929:ôë9292‘9F29 }929`9929`929`9m29`929Rich29PELø°‹Qà  ÊNç%à@@€,ù(ˆô@à@.text]ÉÊ `.rdata` à"Î@@.dataÄ+ð@ÀQ‹D$PŠ@„ÉuùSUV+ÂW‹èD-jPès ƒÄ3ÿ3Û‰D$Æ"p…í~W뛋L$Š <\uGë <"u…ÿ~Wj\Vè ƒÄ ÷3ÿÆ\Fë3ÿ‹T$ŠˆCF;Ý|Ã…ÿ~Wj\VèV ƒÄ ÷‹D$_Æ"ÆF^][YÃì ¡€A3ĉ„$V‹´$W‹¼$Š‹Ï„Àtd$AƒÀ@PèƒÄ F^‹Œ$3Ìè! ÄÃWhŒ$ QV虫V¼,訊„$,ƒÄH@;ÇsŠ„Ét €ù t€ù uëj”$ hâ@RÆèT ƒÄ …Àt2¡â@‹ â@‹ â@‰„$ â@‰Œ$ ‰”$$ˆ„$(L$Q”$"Rè…ûÿÿ‹0‰D$ D$$PVè$úÿÿ‹øƒÄ‰|$ …ÿu Vhàá@éµS‹\$ U‹¬$,+‰D$@jPèå‹ðW‰t$èCùÿÿ‰¿ƒÄ ƒÆ;ß~‹ÿ‹L$ ‹¹Rè#ùÿÿ‰GƒÄƒÆ;û|æD$$Pè ùÿÿ‰¿ƒÄƒÆ;ï~‹L$‹¹Rèîøÿÿ‰GƒÄƒÆ;ý|惼$4]Ç[tE‹D$‹t$ PVè$¤ƒÄVhÌá@蓃À@PènƒÄ _¸^‹Œ$3ÌèsÄËL$‹T$‹D$ QRPè†üÿÿPèÀûÿÿ‹Œ$,ƒÄ_^3Ìè?ÄÃÌÌÌÌÌÌ‹D$‹L$jPQèýÿÿƒÄ Ãj hðô@èŸ3ö‰uä3À‹];Þ•À;Æu è;ÇVVVVVèÃăÈÿéÍ3À9u •À;ÆtÔ‰]SèŸY‰uüöC @uwSè*Yƒøÿtƒøþt‹ÐÁú‹ÈƒáÁá • *A빘AöA$u)ƒøÿtƒøþt‹ÈÁùƒàÁà *A븘Aö@$€tè¡ÇVVVVVè)ƒÄƒMäÿ9uäu#SèL ‹øEPVÿu S貉EäSWèÎ ƒÄÇEüþÿÿÿè ‹EäèßÃÿuèLYøAáÀ;AVj^…Àu¸ë;Æ}‹Æ£À;AjPè“ YY£¼+A…ÀujV‰5À;Aèz YY£¼+A…ÀujX^Ã3Ò¹A롼+A‰ ƒÁ ƒÂù€A|êjþ^3Ò¹AW‹ÂÁø‹… *A‹úƒçÁ狃øÿt;Æt…Àu‰1ƒÁ BùpA|Î_3À^Ãè§#€=0 Atèp!ÿ5¼+Aè× YËÿU‹ìV‹u¸A;ðr"þ`Aw‹Î+ÈÁùƒÁQèç$N €Yë ƒÆ Vÿà@^]ËÿU‹ì‹Eƒø}ƒÀPèº$‹E H €Y]ËE ƒÀ Pÿà@]ËÿU‹ì‹E¹A;Ár=`Aw` ÿÿÿ+ÁÁøƒÀPè—#Y]ÃÀ Pÿà@]ËÿU‹ì‹Mƒù‹E }` ÿÿÿƒÁQèh#Y]ÃÀ Pÿà@]ËÿU‹ìQƒeüVEüPÿu ÿuèL$‹ðƒÄ …öu9Eütèa…Àt èX‹Mü‰‹Æ^ÉÃÌÌÌÌÌÌÌÌÌÌ‹T$ ‹L$…Òti3ÀŠD$„Àuúrƒ=ˆ*Atée%W‹ùƒúr1÷Ùƒát +шƒÇƒéuö‹ÈÁàÁ‹ÈÁàÁ‹ÊƒâÁétó«…Òt ˆƒÇƒêuö‹D$_ËD$ÃÌÌÌÌÌÌ‹L$ W…É„’VS‹Ù‹t$÷Æ‹|$u Áé……ë'ŠƒÆˆƒÇƒét+„Àt/÷Æuå‹ÙÁéuaƒãtŠƒÆˆƒÇ„Àt7ƒëuí‹D$[^_Ã÷ÇtˆƒÇƒé„˜÷Çuê‹ÙÁéutˆƒÇƒëuö[^‹D$_ɃǃétŸºÿþþ~‹Ѓðÿ3‹ƒÆ©tÜ„Òt,„öt÷Âÿt ÷Âÿuĉëâÿÿ‰ëâÿ‰ë3Ò‰ƒÇ3Àƒét 3À‰ƒÇƒéuöƒã…wÿÿÿ‹D$[^_ËÿU‹ìÿuÿuÿuÿu jÿÿuè %ƒÄ]ËÿU‹ìQQS3ÛVW‰]ø9]t}‹M ;Ëu9]uqë9]tj9]u9]u`ë9]tY9]u9] uOë9] tH9]$u>9](u>‹u3À@8tHF;Ãwö€>:u5;Ëtƒ}‚õjÿujÿQè%&ƒÄF‰uë9](uÂÇEøéÎ;Ëtˆ‹u3ÿ‰]ü8tU¾PèØ%Y…ÀtFëŠé¤þÿÿ‹ÿU‹ìV‹uVèSPè?YY…Àt|èÐòÿÿƒÀ ;ðu3ÀëèÀòÿÿƒÀ@;ðu`3À@ÿ A÷F uNSW<…H Aƒ?»u Sè Y‰…ÀuFj‰F‰X‰F‰Fë ‹?‰~‰>‰^‰^N 3À_@[ë3À^]ËÿU‹ìƒ}t'V‹u ÷F tVèf ÿîÿÿƒfƒ&ƒfY^]ÃöA @tƒyt$ÿIx ‹ˆÿ¶Àë ¾ÀQPèå-YYƒøÿu ÃÿËÿU‹ìV‹ðë‹MŠEÿM èµÿÿÿƒ>ÿtƒ} ç^]ËÿU‹ìöG @SV‹ð‹Ùt2ƒu,‹Eë+ŠÿM‹Ïè}ÿÿÿCƒ>ÿuèÕƒ8*u‹Ï°?èdÿÿÿƒ}Õ^[]ËÿU‹ììx¡€A3ʼnEüS‹] V‹u3ÀW‹}ÿu¤ýÿÿ‰µ´ýÿÿ‰½Üýÿÿ‰…¸ýÿÿ‰…ðýÿÿ‰…Ìýÿÿ‰…èýÿÿ‰…Ðýÿÿ‰…Àýÿÿ‰…Èýÿÿè#÷ÿÿ…öu5èMÇ3ÀPPPPPèӃ½°ýÿÿt ‹…¬ýÿÿƒ`pýƒÈÿéÈ öF @u^Vè@ Yº˜Aƒøÿtƒøþt‹Èƒá‹ðÁþÁá µ *Aë‹ÊöA$u‘ƒøÿtƒøþt‹ÈƒàÁùÁà *Aë‹Âö@$€…gÿÿÿ3É;Ù„]ÿÿÿЉØýÿÿ‰àýÿÿ‰¼ýÿÿˆ•ïýÿÿ„Ò„ Cƒ½Øýÿÿ‰ÄýÿÿŒ ŠÂ, If90t@@;Îuô+…äýÿÿÑøë(;þu ¡A‰…äýÿÿ‹…äýÿÿëI€8t@;Îuõ+…äýÿÿ‰…àýÿÿƒ½Àýÿÿ…\‹…ðýÿÿ¨@t2©t Æ…Ôýÿÿ-ë¨t Æ…Ôýÿÿ+ë ¨tÆ…Ôýÿÿ Ç…Ðýÿÿ‹Ìýÿÿ+àýÿÿ+Ðýÿÿö…ðýÿÿ uÿµ´ýÿÿ…ØýÿÿSj èpõÿÿƒÄ ÿµÐýÿÿ‹½´ýÿÿ…ØýÿÿÔýÿÿèvõÿÿö…ðýÿÿYtö…ðýÿÿuWSj0…Øýÿÿè.õÿÿƒÄ ƒ½Èýÿÿ‹…àýÿÿtf…À~b‹µäýÿÿ‰… ýÿÿ·ÿ ýÿÿPjEôP…˜ýÿÿFPFè5ƒÄ…Àu(9…˜ýÿÿt ÿµ˜ýÿÿ…ØýÿÿMôèñôÿÿƒ½ ýÿÿYuµëƒØýÿÿÿë‹äýÿÿP…ØýÿÿèÊôÿÿYƒ½Øýÿÿ|ö…ðýÿÿtWSj …Øýÿÿè‚ôÿÿƒÄ ƒ½¼ýÿÿtÿµ¼ýÿÿ胥¼ýÿÿY‹ÄýÿÿŠˆ…ïýÿÿ„Àt‹”ýÿÿ‹½ÜýÿÿŠÐéáõÿÿ€½°ýÿÿt ‹…¬ýÿÿƒ`pý‹…Øýÿÿ‹Mü_^3Í[èìÿÿÉÃê*@ë(@)@y)@Å)@Ð)@*@D+@jThPõ@èe3ÿ‰}üEœPÿ@à@ÇEüþÿÿÿj@j ^VèuYY;Ç„£ *A‰5*Aˆë0Æ@ƒÿÆ@ ‰xÆ@$Æ@% Æ@& ‰x8Æ@4ƒÀ@‹  *AÁ;ÁrÌf9}΄ ‹EÐ;Ç„ÿ‹8X;‰Eä¾;þ|‹þÇEàë[j@j èçYY…ÀtV‹Mà  *A‰ƒ*A ë*Æ@ƒÿÆ@ ƒ`€`$€Æ@% Æ@& ƒ`8Æ@4ƒÀ@‹Ö;ÂrÒÿEà9=*A|ë‹=*Aƒeà…ÿ~m‹E䋃ùÿtVƒùþtQЍtK¨u Qÿ<à@…Àt<‹uà‹ÆÁøƒæÁæ4… *A‹E䋉ŠˆFh F Pè€*YY…À„ÉÿFÿEàCƒEä9}à|“3Û‹óÁæ5 *A‹ƒøÿt ƒøþt€N€ërÆF…ÛujöXë ‹ÃH÷ØÀƒÀõPÿ8à@‹øƒÿÿtC…ÿt?Wÿ<à@…Àt4‰>%ÿƒøu€N@ë ƒøu€Nh F Pèê)YY…Àt7ÿFë €N@ÇþÿÿÿCƒûŒgÿÿÿÿ5*Aÿ4à@3Àë3À@ËeèÇEüþÿÿÿƒÈÿècËÿU‹ì‹EV3ö;Æuè½VVVVVÇèEƒÄƒÈÿë‹@^]ËÿU‹ì‹E£P A]ËÿU‹ìì(¡€A3ʼnEüƒ¥ØüÿÿSjL…ÜüÿÿjPèåÿÿ…Øüÿÿ‰…(ýÿÿ…0ýÿÿƒÄ ‰…,ýÿÿ‰…àýÿÿ‰Üýÿÿ‰•Øýÿÿ‰Ôýÿÿ‰µÐýÿÿ‰½ÌýÿÿfŒ•øýÿÿfŒìýÿÿfŒÈýÿÿfŒ…ÄýÿÿfŒ¥ÀýÿÿfŒ­¼ýÿÿœ…ðýÿÿ‹EMÇ…0ýÿÿ‰…èýÿÿ‰ôýÿÿ‹Iü‰äýÿÿÇ…ØüÿÿÀÇ…Üüÿÿ‰…äüÿÿÿXà@j‹ØÿTà@…(ýÿÿPÿPà@…Àu …Ûujèé1YhÀÿLà@PÿHà@‹Mü3Í[è(èÿÿÉËÿU‹ìÿ5P Aè&Y…Àt]ÿàjèª1Y]é²þÿÿ‹ÿU‹ì‹E3É;ÍØAtAƒù-rñHíƒùwj X]ËÍÜA]ÃDÿÿÿjY;ÈÀ#ÁƒÀ]Ã蜅Àu¸@AÃÀÃ艅Àu¸DAÃÀ ËÿU‹ìVèâÿÿÿ‹MQ‰è‚ÿÿÿY‹ðè¼ÿÿÿ‰0^]ÃÌÌÌhÐ7@dÿ5‹D$‰l$l$+àSVW¡€A1Eü3ÅP‰eèÿuø‹EüÇEüþÿÿÿ‰EøEðd£Ã‹Mðd‰ Y__^[‹å]QÃÌÌÌÌÌÌÌ‹ÿU‹ìƒìS‹] V‹s35€AW‹ÆEÿÇEô{ƒøþt ‹NÏ3 8èÙæÿÿ‹N ‹FÏ3 8èÉæÿÿ‹Eö@f…‹MUè‰Sü‹[ ‰Eè‰Mìƒûþt_I[‹L†D†‰Eð‹‰Eø…Ét‹×è$1ÆEÿ…À|@G‹Eø‹Øƒøþu΀}ÿt$‹ƒøþt ‹NÏ3 8èVæÿÿ‹N ‹VÏ3 :èFæÿÿ‹Eô_^[‹å]ÃÇEôëÉ‹M9csmàu)ƒ=Œ*At hŒ*Aèƒ!ƒÄ…Àt‹UjRÿŒ*AƒÄ‹M èÇ0‹E 9X th€AW‹Ó‹ÈèÊ0‹E ‹Mø‰H ‹ƒøþt ‹NÏ3 8èÃåÿÿ‹N ‹VÏ3 :è³åÿÿ‹Eð‹H‹×è]0ºþÿÿÿ9S „Rÿÿÿh€AW‹Ëèu0éÿÿÿ‹ÿU‹ìVW3öÿuèÅ0‹øY…ÿu'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuÊ‹Ç_^]ËÿU‹ìVW3öjÿu ÿuèE‹øƒÄ …ÿu'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuËÇ_^]ËÿU‹ìVW3öÿu ÿuèû0‹øYY…ÿu,9E t'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuÁ‹Ç_^]ËÿU‹ìVW3öÿuÿu ÿuèÅ2‹øƒÄ …ÿu,9Et'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿu½‹Ç_^]Ãj hpõ@è×üÿÿ‹u…ötuƒ=„*AuCjèYƒeüVè×2Y‰Eä…Àt VPèø2YYÇEüþÿÿÿè ƒ}äu7ÿuë jèYÃVjÿ5t)Aÿ`à@…Àuè üÿÿ‹ðÿ\à@PèÐûÿÿ‰Yè›üÿÿÃjhõ@èIüÿÿ3Û‰]äjè–Y‰]üj_‰}à;=À;A}W‹÷Á桼+AÆ9tD‹ö@ ƒtPèj=YƒøÿtÿEäƒÿ|(¡¼+A‹ƒÀ PÿDà@¡¼+Aÿ4èýþÿÿY¡¼+A‰GëžÇEüþÿÿÿè ‹EäèüÿÿÃjè7YËÿU‹ìSV‹u‹F ‹È€á3Û€ùu@©t9‹FW‹>+ø…ÿ~,WPVèeùÿÿYPè‡DƒÄ ;Çu‹F „Àyƒàý‰F ëƒN ƒËÿ_‹Fƒf‰^‹Ã[]ËÿU‹ìV‹u…öu Vè5Yë/Vè|ÿÿÿY…ÀtƒÈÿë÷F @tVèüøÿÿPèûDY÷ØYÀë3À^]Ãjh°õ@èúúÿÿ3ÿ‰}ä‰}ÜjèDY‰}ü3ö‰uà;5À;Aƒ¡¼+A°98t^‹ö@ ƒtVPVèDÝÿÿYY3ÒB‰Uü¡¼+A‹°‹H öÁƒt/9UuPèJÿÿÿYƒøÿtÿEäë9}uöÁtPè/ÿÿÿYƒøÿu E܉}üèFë„3ÿ‹uࡼ+Aÿ4°VèMÝÿÿYYÃÇEüþÿÿÿèƒ}‹Eät‹EÜè{úÿÿÃjè­YÃjèÿÿÿYËÿVW3ö¿X Aƒ<õLAuõHA‰8h ÿ0ƒÇè}!YY…Àt Fƒþ$|Ò3À@_^Ã$õHA3Àëñ‹ÿS‹Dà@V¾HAW‹>…ÿtƒ~t WÿÓWèÐüÿÿƒ&YƒÆþhA|ܾHA_‹…Àt ƒ~uPÿÓƒÆþhA|æ^[ËÿU‹ì‹Eÿ4ÅHAÿà@]Ãj hØõ@è^ùÿÿ3ÿG‰}ä3Û9t)Auè´jèhÿè€ãÿÿYY‹u4õHA9t‹Çënjè ûÿÿY‹ø;ûuèÅøÿÿÇ 3ÀëQj èYY‰]ü9u,h Wèt YY…ÀuWèþûÿÿYèøÿÿÇ ‰]äë ‰>ëWèãûÿÿYÇEüþÿÿÿè ‹EäèöøÿÿÃj è(ÿÿÿYËÿU‹ì‹EV4ÅHAƒ>uPè"ÿÿÿY…ÀujètâÿÿYÿ6ÿà@^]Ãj høõ@èhøÿÿ‹M3ÿ;Ïv.jàX3Ò÷ñ;E À@uèÿ÷ÿÿÇ WWWWWè‡÷ÿÿƒÄ3ÀéÕ¯M ‹ñ‰u;÷u3öF3Û‰]äƒþàwiƒ=„*AuKƒÆƒæð‰u ‹E;p*Aw7jèLÿÿÿY‰}üÿuèè5Y‰EäÇEüþÿÿÿè_‹]ä;ßtÿuWSè6ÛÿÿƒÄ ;ßuaVjÿ5t)Aÿdà@‹Ø;ßuL9=€)At3Vè’Y…À…rÿÿÿ‹E;Ç„PÿÿÿÇ éEÿÿÿ3ÿ‹u jèðýÿÿYÃ;ßu ‹E;ÇtÇ ‹Ãèœ÷ÿÿÃU‹ìƒì‰}ü‹}‹M ÁéfïÀë¤$ffGfG fG0fG@fGPfG`fGp¿€IuЋ}ü‹å]ÃU‹ìƒì‰}ü‹E™‹ø3ú+úƒç3ú+ú…ÿu<‹M‹Ñƒâ‰Uô;Êt+ÊQPèsÿÿÿƒÄ‹E‹Uô…ÒtEE+‰Eø3À‹}ø‹Môóª‹Eë.÷߃lj}ð3À‹}‹Mðóª‹Eð‹M‹UÈ+ÐRjQè~ÿÿÿƒÄ ‹E‹}ü‹å]Ãj hö@èdöÿÿƒeüf(ÁÇEäë#‹Eì‹‹=Àt =Àt3ÀÃ3À@ËeèƒeäÇEüþÿÿÿ‹EäèföÿÿËÿU‹ìƒì3ÀS‰Eü‰Eô‰EøSœX‹È5 PœZ+ÑtQ3À¢‰Eô‰]è‰Uì‰M𸢉Uü‰Eø[÷Eütè\ÿÿÿ…Àt3À@ë3À[ÉÃè™ÿÿÿ£ˆ*A3ÀËÿU‹ìQSV‹u3ÛW;ót9] w èIõÿÿjYSSSSS‹ñ‰èÐôÿÿƒÄ‹ÆéÍ‹E3ÿ;ÃtŠ:Ãtj_9} †ˆFÆ:F‹M‹Á;Ët@8t<ë‹}ü‹U G‰}ü;úsyŠˆF@8uèPQèŒ@ŠYYŠˆF@8uð‹E;Ãt'Š:Ët!€ù.tG;} sÆ.Fë G;} sŠˆF@8uðG;} v‹Eˆèlôÿÿj"éÿÿÿˆ3À_^[ÉËÿU‹ìƒìÿuMðèÜÿÿ¶E ‹MôŠU„Tuƒ}t‹Mð‹‰È·A#Eë3À…Àt3À@€}üt‹MøƒapýÉËÿU‹ìjjÿuÿu è™ÿÿÿƒÄ]ËÿU‹ìjjÿujèÿÿÿƒÄ]ËÿU‹ìjÿuÿuÿu ÿuè…?ƒÄ]ËÿU‹ìì(£°"A‰ ¬"A‰¨"A‰¤"A‰5 "A‰=œ"AfŒÈ"AfŒ ¼"AfŒ˜"AfŒ”"AfŒ%"AfŒ-Œ"AœÀ"A‹E£´"A‹E£¸"AE£Ä"A‹…àüÿÿÇ"A¡¸"A£´!AǨ!A ÀǬ!A¡€A‰…Øüÿÿ¡„A‰…ÜüÿÿÿXà@£ø!AjèO$YjÿTà@hÔâ@ÿPà@ƒ=ø!Aujè+$Yh ÀÿLà@PÿHà@ÉÃ-¤t"ƒètƒè t Ht3ÀøøøøËÿVW‹ðh3ÿFWPè+Öÿÿ3À·È‹Á‰~‰~‰~ Áá Á~«««¹hAƒÄ F+οŠˆ@Ou÷†¾Šˆ@Nu÷_^ËÿU‹ìì¡€A3ʼnEüSW…èúÿÿPÿvÿhà@¿…À„û3Àˆ„üþÿÿ@;ÇrôŠ…îúÿÿÆ…üþÿÿ „Àt.ïúÿÿ¶È¶;Èw+Á@P” üþÿÿj RèhÕÿÿƒÄ CŠC„ÀuØjÿv …üúÿÿÿvPW…üþÿÿPjjèE3ÛSÿv…üýÿÿWPW…üþÿÿPWÿv SèúBƒÄDSÿv…üüÿÿWPW…üþÿÿPhÿv SèÕBƒÄ$3À·ŒEüúÿÿöÁt€LŠŒüýÿÿëöÁt€L ŠŒüüÿÿˆŒëÆ„@;Çr¾ëV†Ç…äúÿÿŸÿÿÿ3É)…äúÿÿ‹•äúÿÿ„ÐZ ƒûw €LŠÑ€Â ëƒúw€L ŠÑ€ê ˆëÆA;Ïr‹Mü_3Í[èOØÿÿÉÃj h8ö@èÏðÿÿè˜ ‹ø¡ŒA…Gptƒlt‹wh…öuj èžÚÿÿY‹ÆèçðÿÿÃj èó÷ÿÿYƒeü‹wh‰uä;5At6…ötVÿpà@…ÀuþhAtVè‡óÿÿY¡A‰Gh‹5A‰uäVÿlà@ÇEüþÿÿÿè뎋uäj è¸öÿÿYËÿU‹ìƒìS3ÛSMðè¤×ÿÿ‰Ì$AƒþþuÇÌ$Aÿxà@8]ütE‹Møƒapýë<ƒþýuÇÌ$Aÿtà@ëÛƒþüu‹Eð‹@ÇÌ$AëÄ8]üt‹Eøƒ`pý‹Æ[ÉËÿU‹ìƒì ¡€A3ʼnEüS‹] V‹uWèdÿÿÿ‹ø3ö‰};þu‹Ãè·üÿÿ3Àé‰uä3À9¸˜A„‘ÿEäƒÀ0=ðrçÿèý„pÿéý„d·ÇPÿ|à@…À„REèPWÿhà@…À„3hCVPèˆÒÿÿ3ÒBƒÄ ‰{‰s 9Uè†ø€}î„ÏuɄ¶Fÿ¶Éé¦hCVPèAÒÿÿ‹MäƒÄ kÉ0‰u౨A‰uäë*ŠF„Àt(¶>¶Àë‹EàŠ€”AD;¶FG;øvê‹}FF€>uÑ‹uäÿEàƒÆƒ}à‰uäré‹Ç‰{ÇCègûÿÿj‰C C‰œAZf‹1Af‰0A@@Juó‹óè×ûÿÿé·þÿÿ€L@;ÁvöFF€~ÿ…4ÿÿÿC¹þ€@Iuù‹Cèûÿÿ‰C ‰Së‰s3À·È‹ÁÁá Á{«««ë¨95Ì$A…XþÿÿƒÈÿ‹Mü_^3Í[èJÕÿÿÉÃjhXö@èÊíÿÿƒMàÿè‹ø‰}ÜèÜüÿÿ‹_h‹uèuýÿÿ‰E;C„Wh è‚ïÿÿY‹Ø…Û„F¹ˆ‹wh‹ûó¥ƒ#Sÿuè¸ýÿÿYY‰Eà…À…ü‹uÜÿvhÿpà@…Àu‹Fh=hAtPècðÿÿY‰^hS‹=là@ÿ×öFp…êöŒA…Ýj ètôÿÿYƒeü‹C£Ü$A‹C£à$A‹C £ä$A3À‰Eäƒø}f‹LCf‰ EÐ$A@ëè3À‰Eä=} ŠLˆˆˆA@ëé3À‰Eä=}ŠŒˆˆA@ëæÿ5Aÿpà@…Àu¡A=hAtPèªïÿÿY‰ASÿ×ÇEüþÿÿÿèë0j èíòÿÿYÃë%ƒøÿu ûhAtSètïÿÿYèìÿÿÇëƒeà‹Eàè‚ìÿÿÃ=°+AujýèVþÿÿYǰ+A3ÀËÿU‹ìSV‹u‹†¼3ÛW;Ãto=HAth‹†°;Ãt^9uZ‹†¸;Ãt9uPèûîÿÿÿ¶¼è;AYY‹†´;Ãt9uPèÚîÿÿÿ¶¼èÕ@YYÿ¶°èÂîÿÿÿ¶¼è·îÿÿYY‹†À;ÃtD9u@‹†Ä-þPè–îÿÿ‹†Ì¿€+ÇPèƒîÿÿ‹†Ð+ÇPèuîÿÿÿ¶ÀèjîÿÿƒÄ¾Ô‹=ˆAt9˜´uPè»>ÿ7èCîÿÿYY~PÇEøAt‹;Ãt 9uPèîÿÿY9_üt‹G;Ãt 9uPèîÿÿYƒÇÿMuÇVèøíÿÿY_^[]ËÿU‹ìSV‹5là@W‹}WÿÖ‹‡°…ÀtPÿÖ‹‡¸…ÀtPÿÖ‹‡´…ÀtPÿÖ‹‡À…ÀtPÿÖ_PÇE{øAt ‹…ÀtPÿÖƒ{üt ‹C…ÀtPÿÖƒÃÿMuÖ‹‡Ô´PÿÖ_^[]ËÿU‹ìW‹}…ÿ„ƒSV‹5pà@WÿÖ‹‡°…ÀtPÿÖ‹‡¸…ÀtPÿÖ‹‡´…ÀtPÿÖ‹‡À…ÀtPÿÖ_PÇE{øAt ‹…ÀtPÿÖƒ{üt ‹C…ÀtPÿÖƒÃÿMuÖ‹‡Ô´PÿÖ^[‹Ç_]Ã…ÿt7…Àt3V‹0;÷t(W‰8èÁþÿÿY…ötVèEÿÿÿƒ>Yuþ˜AtVèYýÿÿY‹Ç^Ã3ÀÃj hxö@ècéÿÿè,‹ð¡ŒA…Fpt"ƒ~ltè‹pl…öuj è-ÓÿÿY‹ÆèvéÿÿÃj è‚ðÿÿYƒeüFl‹=pAèiÿÿÿ‰EäÇEüþÿÿÿèëÁj è}ïÿÿY‹uäËÿU‹ìVÿ5„A‹5€à@ÿÖ…Àt!¡€AƒøÿtPÿ5„AÿÖÿÐ…Àt‹€øë'¾tã@Vÿ à@…Àu VènÒÿÿY…Àthdã@Pÿ(à@…ÀtÿuÿЉE‹E^]Ãjè‡ÿÿÿYËÿU‹ìVÿ5„A‹5€à@ÿÖ…Àt!¡€AƒøÿtPÿ5„AÿÖÿÐ…Àt‹€üë'¾tã@Vÿ à@…Àu VèóÑÿÿY…Àthã@Pÿ(à@…ÀtÿuÿЉE‹E^]Ãÿ„à@‹ÿVÿ5„Aÿ€à@‹ð…öuÿ5%AèeÿÿÿY‹ðVÿ5„Aÿˆà@‹Æ^á€AƒøÿtPÿ5%Aè;ÿÿÿYÿЃ €Aÿ¡„AƒøÿtPÿŒà@ƒ „Aÿéºíÿÿj h˜ö@è†çÿÿ¾tã@Vÿ à@…ÀuVè4ÑÿÿY‰Eä‹uÇF\é@3ÿG‰~…Àt$hdã@P‹(à@ÿÓ‰†øhã@ÿuäÿÓ‰†ü‰~pƆÈCƆKCÇFhhAj ènîÿÿYƒeüÿvhÿlà@ÇEüþÿÿÿè>j èMîÿÿY‰}ü‹E ‰Fl…Àu¡pA‰FlÿvlèüÿÿYÇEüþÿÿÿèè çÿÿÃ3ÿG‹uj è5íÿÿYÃj è,íÿÿYËÿVWÿ\à@ÿ5€A‹øè‘þÿÿÿЋð…öuNhjè±èÿÿ‹ðYY…öt:Vÿ5€Aÿ5%AèèýÿÿYÿÐ…ÀtjVèÅþÿÿYYÿ”à@ƒNÿ‰ë Vè^éÿÿY3öWÿà@_‹Æ^ËÿVèÿÿÿ‹ð…öujèÐÿÿY‹Æ^ÃjhÀö@è æÿÿ‹u…ö„ø‹F$…ÀtPèéÿÿY‹F,…ÀtPèéÿÿY‹F4…ÀtPèõèÿÿY‹F<…ÀtPèçèÿÿY‹F@…ÀtPèÙèÿÿY‹FD…ÀtPèËèÿÿY‹FH…ÀtPè½èÿÿY‹F\=é@tPè¬èÿÿYj èàìÿÿYƒeü‹~h…ÿtWÿpà@…ÀuÿhAtWèèÿÿYÇEüþÿÿÿèWj è§ìÿÿYÇEü‹~l…ÿt#WèóúÿÿY;=pAtÿ˜At ƒ?uWèÿøÿÿYÇEüþÿÿÿèVè'èÿÿYèIåÿÿ‹uj èvëÿÿYËuj èjëÿÿYËÿVW¾tã@Vÿ à@…ÀuVè“ÎÿÿY‹ø…ÿ„^‹5(à@hÀã@WÿÖh´ã@W£ %AÿÖh¨ã@W£%AÿÖh ã@W£%AÿÖƒ= %A‹5ˆà@£%Atƒ=%At ƒ=%At…Àu$¡€à@£%A¡Œà@Ç %AdO@‰5%A£%Aÿ„à@£„Aƒøÿ„Ìÿ5%APÿÖ…À„»èÅÐÿÿÿ5 %Aèûÿÿÿ5%A£ %Aèûÿÿÿ5%A£%Aèóúÿÿÿ5%A£%AèãúÿÿƒÄ£%Aè¬éÿÿ…ÀtehXQ@ÿ5 %Aè=ûÿÿYÿУ€AƒøÿtHhjèÓåÿÿ‹ðYY…öt4Vÿ5€Aÿ5%Aè ûÿÿYÿÐ…ÀtjVèçûÿÿYYÿ”à@ƒNÿ‰3À@ëè’ûÿÿ3À_^ËÿU‹ìƒìSÿuMèèÉÊÿÿ‹]C=w‹E苀ȷXëu‰]Á}EèP‹E%ÿPèGYY…ÀtŠEjˆEøˆ]ùÆEúYë 3Ɉ]øÆEùA‹EèjÿpÿpEüPQEøPEèjPè6ƒÄ …Àu8Eôt‹Eðƒ`pý3Àë·Eü#E €}ôt‹Mðƒapý[ÉËÿU‹ìQV‹u Vèwàÿÿ‰E ‹F Y¨‚uè8âÿÿÇ ƒN ƒÈÿé/¨@t èâÿÿÇ"ëãS3Û¨t‰^¨„‡‹Nƒàþ‰‰F ‹F ƒàïƒÈ‰F ‰^‰]ü© u,è—ÃÿÿƒÀ ;ðt è‹ÃÿÿƒÀ@;ðu ÿu è©Y…ÀuVè¾?Y÷F W„€‹F‹>H‰‹N+øI;û‰N~WPÿu èÜ*ƒÄ ‰EüëMƒÈ ‰F ƒÈÿëy‹M ƒùÿtƒùþt‹Áƒà‹ÑÁúÁà• *A븘Aö@ tjSSQè*>#ƒÄƒøÿt%‹FŠMˆë3ÿGWEPÿu èm*ƒÄ ‰Eü9}üt ƒN ƒÈÿë‹E%ÿ_[^ÉËÿU‹ìQQS‹]VW3ö3ÿ‰}ü;ýˆAt G‰}üƒÿrîƒÿƒwjèz@Yƒø„4jèi@Y…Àu ƒ=ŒA„ûü„Ahpé@»S¿ %AWè08ƒÄ …Àt VVVVVèØÞÿÿƒÄh¾9%AVjÆ=&Aÿà@…Àu&hXé@hûVèî7ƒÄ …Àt3ÀPPPPPè”ÞÿÿƒÄVè‡@YƒøYƒøtjèñ>Y…Àuƒ=ŒAuhüè)þÿÿhÿèþÿÿYYËÿU‹ìQSVWÿ5¬+AèÊöÿÿÿ5¨+A‹ø‰}üèºöÿÿ‹ðYY;÷‚ƒ‹Þ+ßCƒørwWèÕ>‹øCY;øsH¸;øs‹ÇÇ;ÇrPÿuüèsáÿÿYY…ÀuG;Çr@Pÿuüè]áÿÿYY…Àt1ÁûP4˜èÕõÿÿY£¬+AÿuèÇõÿÿ‰ƒÆVè¼õÿÿY£¨+A‹EYë3À_^[ÉËÿVjj èÇàÿÿ‹ðVè•õÿÿƒÄ £¬+A£¨+A…öujX^Ã&3À^Ãj hèö@èeÞÿÿèÀÈÿÿƒeüÿuèøþÿÿY‰EäÇEüþÿÿÿè ‹EäèÞÿÿÃèŸÈÿÿËÿU‹ìÿuè·ÿÿÿ÷ØÀ÷ØYH]ËÿV¸àô@¾àô@W‹ø;Æs‹…ÀtÿЃÇ;þrñ_^ËÿV¸èô@¾èô@W‹ø;Æs‹…ÀtÿЃÇ;þrñ_^ËÿVW3ÿ·@Aÿ6èÆôÿÿƒÇY‰ƒÿ(rè_^ÃÌ‹ÿU‹ì‹M¸MZf9t3À]ËA<Á8PEuï3Ò¹ f9H”‹Â]ÃÌÌÌÌÌÌÌÌÌÌÌ‹ÿU‹ì‹E‹H<È·ASV·q3ÒWD…öv‹} ‹H ;ùr ‹XÙ;ûr BƒÀ(;Örè3À_^[]ÃÌÌÌÌÌÌÌÌÌÌÌÌ‹ÿU‹ìjþh÷@hÐ7@d¡PƒìSVW¡€A1Eø3ÅPEðd£‰eèÇEüh@è*ÿÿÿƒÄ…ÀtU‹E-@Ph@èPÿÿÿƒÄ…Àt;‹@$Áè÷ЃàÇEüþÿÿÿ‹Mðd‰ Y_^[‹å]ËEì‹‹3Ò=À”‹ÂËeèÇEüþÿÿÿ3À‹Mðd‰ Y_^[‹å]Ãjh(÷@èWÜÿÿè öÿÿ‹@x…ÀtƒeüÿÐë3À@ËeèÇEüþÿÿÿè—<èpÜÿÿÃh [@è'óÿÿY£4(AÃËÿU‹ìQQVè`õÿÿ‹ð…ö„F‹V\¡tAW‹}‹ÊS99t‹ØkÛ ƒÁ Ú;ËrîkÀ Â;Ès99u‹Áë3À…Àt ‹X‰]ü…Ûu3Àéûƒûu ƒ`3À@éêƒû„Þ‹N`‰Mø‹M ‰N`‹Hƒù…¸‹ hA‹=lA‹Ñù;×}$kÉ ‹~\ƒd9‹=hA‹lAB߃Á ;Ó|â‹]ü‹‹~d=ŽÀu ÇFdƒë^=Àu ÇFdëN=‘Àu ÇFd„ë>=“Àu ÇFd…ë.=Àu ÇFd‚ë=Àu ÇFd†ë=’ÀuÇFdŠÿvdjÿÓY‰~dëƒ`QÿÓ‹EøY‰F`ƒÈÿ[_^ÉËÿU‹ì‹E£8(A£<(A£@(A£D(A]ËÿU‹ì‹E‹ tAV9Pt‹ñkö uƒÀ ;ÆrìkÉ M^;Ás9Pt3À]Ãÿ5@(AèÚñÿÿYÃj hH÷@èJÚÿÿ3ÿ‰}ä‰}Ø‹]ƒû Lt‹ÃjY+Át"+Át+Átd+ÁuDèsóÿÿ‹ø‰}Ø…ÿuƒÈÿéa¾8(A¡8(Aë`ÿw\‹Óè]ÿÿÿ‹ðƒÆ‹ëZ‹Ãƒèt<ƒèt+HtèŽÙÿÿÇ3ÀPPPPPèÙÿÿƒÄ뮾@(A¡@(Aë¾<(A¡<(Aë ¾D(A¡D(AÇEäPèñÿÿ‰EàY3Àƒ}à„Ø9EàujèòÅÿÿ9EätPèÆàÿÿY3À‰Eüƒût ƒû tƒûu‹O`‰MÔ‰G`ƒûu@‹Od‰MÐÇGdŒƒûu.‹ hA‰MÜ‹ lA‹hAÊ9MÜ}‹MÜkÉ ‹W\‰DÿEÜëÛè~ðÿÿ‰ÇEüþÿÿÿèƒûuÿwdSÿUàYë‹]‹}؃}ätjèTßÿÿYÃSÿUàYƒût ƒû tƒûu‹EÔ‰G`ƒûu‹EЉGd3ÀèìØÿÿËÿU‹ì‹E£L(A]ËÿU‹ì‹E£X(A]ËÿU‹ì‹E£\(A]Ãjhh÷@èmØÿÿƒeüÿu ÿuÿ à@‰Eäë/‹Eì‹‹‰Eà3É=À”Á‹ÁËeè}àÀujÿà@ƒeäÇEüþÿÿÿ‹Eäè_ØÿÿËÿU‹ì‹E£`(A]ËÿU‹ìÿ5`(Aè|ïÿÿY…ÀtÿuÿÐY…Àt3À@]Ã3À]ËÿU‹ì‹E‹8csmàu*ƒxu$‹@= “t=!“t="“t=@™uèCûÿÿ3À]ÂhŽ_@ÿTà@3ÀÃ=°+AuèHëÿÿV‹5< AW3ÿ…öuƒÈÿé <=tGVèƒYtŠ„ÀuêjGWè€Ùÿÿ‹øYY‰= A…ÿtË‹5< ASëBVèR‹ØC€>=Yt1jSèRÙÿÿYY‰…ÀtNVSPè|.ƒÄ …Àt3ÀPPPPPè"ÕÿÿƒÄƒÇó€>u¹ÿ5< AèÚÿÿƒ%< Aƒ'Ǥ+A3ÀY[_^Ãÿ5 AèÝÙÿÿƒ% AƒÈÿëä‹ÿU‹ìQ‹MS3ÀV‰‹ò‹U Ç9Et ‹]ƒE‰‰Eü€>"u3À9Eü³"”ÀF‰Eüë<ÿ…ÒtŠˆB‰U жÃPFèâÿÿY…Àtÿƒ} t ‹M ŠÿE ˆF‹U ‹M„Ût2ƒ}üu©€û t€û uŸ…ÒtÆBÿƒeü€>„éŠ< t< uFëóNëã€>„Ѓ}t ‹EƒE‰ÿ3ÛC3ÉëFA€>\tù€>"u&öÁuƒ}üt F€8"u‹ðë 3À3Û9Eü”À‰EüÑé…ÉtI…ÒtÆ\Bÿ…Éuñ‰U Š„ÀtUƒ}üu< tK< tG…Ût=¾ÀP…Òt#è9áÿÿY…Àt Š‹M ÿE ˆFÿ‹M ŠÿE ˆë èáÿÿY…ÀtFÿÿ‹U FéVÿÿÿ…ÒtÆB‰U ÿ‹Méÿÿÿ‹E^[…Àtƒ ÿÉËÿU‹ìƒì S3ÛVW9°+AuèÄèÿÿh¾h(AVSˆl)Aÿà@¡ +A‰5( A;Ãt‰Eü8u‰uü‹UüEøPSS}ôè þÿÿ‹EøƒÄ =ÿÿÿ?sJ‹MôƒùÿsB‹øÁç;Ár6PèƒÖÿÿ‹ðY;ót)‹UüEøPþWV}ôèÉýÿÿ‹EøƒÄ H£ A‰5 A3ÀëƒÈÿ_^[ÉËÿU‹ì¡p)Aƒì SV‹5´à@W3Û3ÿ;Ãu.ÿÖ‹ø;ût Çp)Aë#ÿ\à@ƒøxu jX£p)Aë¡p)Aƒø…;ûuÿÖ‹ø;ûu3ÀéÊ‹Çf9t@@f9uù@@f9uò‹5°à@SSS+ÇSÑø@PWSS‰EôÿÖ‰Eø;Ãt/Pè©ÕÿÿY‰Eü;Ãt!SSÿuøPÿuôWSSÿÖ…Àu ÿuüè¸ÖÿÿY‰]ü‹]üWÿ¬à@‹Ãë\ƒøt;Ãu‚ÿ¨à@‹ð;ó„rÿÿÿ8t @8uû@8uö+Æ@P‰EøèBÕÿÿ‹øY;ûu Vÿ¤à@éEÿÿÿÿuøVWè©+ƒÄ Vÿ¤à@‹Ç_^[ÉËÿU‹ì3À9Ej”ÀhPÿ¸à@£t)A…Àu]Ã3À@£„*A]ËÿU‹ìƒì¡€AƒeøƒeüSW¿Næ@»»ÿÿ;Çt …Ãt ÷У„Aë`VEøPÿÌà@‹uü3uøÿÈà@3ðÿ”à@3ðÿÄà@3ðEðPÿÀà@‹Eô3Eð3ð;÷u¾Oæ@»ë …óu‹ÆÁà ð‰5€A÷Ö‰5„A^_[ÉËÿU‹ì‹EƒøþuèÒÿÿÇ 3À]ÃV3ö;Æ|;*ArèæÑÿÿVVVVVÇ ènÑÿÿƒÄ3Àë‹ÈƒàÁù‹  *AÁà¾Dƒà@^]á€AƒÈ3É9x)A”Á‹ÁÃÌÌÌÌÌÌÌÌ‹L$÷Át$ŠƒÁ„ÀtN÷Áuï¤$¤$‹ºÿþþ~Ѓðÿ3ƒÁ©tè‹Aü„Àt2„ät$©ÿt©ÿtëÍAÿ‹L$+ÁÃAþ‹L$+ÁÃAý‹L$+ÁÃAü‹L$+ÁËÿU‹ìƒìSV‹u 3ÛW‹};óu;ûv‹E;Ãt‰3À郋E;ÃtƒÿÿÿÿÿvèÇÐÿÿj^SSSSS‰0èPÐÿÿƒÄ‹ÆëVÿuMðès¸ÿÿ‹Eð9X…œf‹E¹ÿf;Áv6;ót;ûv WSVè8´ÿÿƒÄ ètÐÿÿÇ*èiÐÿÿ‹8]üt‹Møƒapý_^[ÉÃ;ót2;ûw,èIÐÿÿj"^SSSSS‰0èÒÏÿÿƒÄ8]ü„yÿÿÿ‹Eøƒ`pýémÿÿÿˆ‹E;ÃtÇ8]ü„%ÿÿÿ‹Eøƒ`pýéÿÿÿM QSWVjMQS‰] ÿpÿ°à@;Ãt9] …^ÿÿÿ‹M;Ët½‰ë¹ÿ\à@ƒøz…Dÿÿÿ;ó„gÿÿÿ;û†_ÿÿÿWSVèa³ÿÿƒÄ éOÿÿÿ‹ÿU‹ìjÿuÿuÿu ÿuè|þÿÿƒÄ]ËÿU‹ìƒìÿu Mðè:·ÿÿ¶E‹Mð‹‰È·A%€€}üt‹MøƒapýÉËÿU‹ìjÿuè¹ÿÿÿYY]ÃÌV‹D$ Àu(‹L$‹D$ 3Ò÷ñ‹Ø‹D$÷ñ‹ð‹Ã÷d$‹È‹Æ÷d$ÑëG‹È‹\$‹T$ ‹D$ÑéÑÛÑêÑØ Éuô÷ó‹ð÷d$‹È‹D$÷æÑr;T$ wr;D$v N+D$T$3Û+D$T$ ÷Ú÷؃ڋʋӋًȋÆ^ƒ%€*AÃÌÌÌSVW‹T$‹D$‹L$URPQQh i@dÿ5¡€A3ĉD$d‰%‹D$0‹X‹L$,3‹p ƒþþt;‹T$4ƒúþt;òv.4v\³‹ ‰H ƒ{uÌh‹Cè1¹‹Cè1ë°dƒÄ_^[ËL$÷A¸t3‹D$‹H3È袵ÿÿU‹hÿp ÿpÿpè>ÿÿÿƒÄ ]‹D$‹T$‰¸ÃU‹L$‹)ÿqÿqÿq(èÿÿÿƒÄ ]ÂUVWS‹ê3À3Û3Ò3ö3ÿÿÑ[_^]Ëê‹ñ‹Ájè_03À3Û3É3Ò3ÿÿæU‹ìSVWjjhÇi@Qè—Q_^[]ÃU‹l$RQÿt$è´þÿÿƒÄ ]Âj hˆ÷@èÍÿÿƒeä‹u;5p*Aw"jèÄÔÿÿYƒeüVèa Y‰EäÇEüþÿÿÿè ‹EäèÍÿÿÃjè¿ÓÿÿYËÿU‹ìV‹uƒþà‡¡SW‹=dà@ƒ=t)AuèíÿÿjèÏëÿÿhÿèM·ÿÿYY¡„*Aƒøu…öt‹Æë3À@Pëƒøu VèSÿÿÿY…Àu…öuFƒÆƒæðVjÿ5t)Aÿ׋؅Ûu.j ^9€)Atÿuè¢ôÿÿY…Àt‹ué{ÿÿÿèNÌÿÿ‰0èGÌÿÿ‰0_‹Ã[ëVè{ôÿÿYè3ÌÿÿÇ 3À^]Ãjh¨÷@èhÌÿÿ‹]…Ûuÿu èÿÿÿYéÌ‹u …öu SècÏÿÿYé·ƒ=„*A…“3ÿ‰}äƒþà‡ŠjèwÓÿÿY‰}üSè6Y‰Eà;Ç„ž;5p*AwIVSPèƒÄ …Àt‰]äë5Vèç Y‰Eä;Çt'‹CüH;Ær‹ÆPSÿuäè:$Sèæ‰EàSPè ƒÄ9}äuH;÷u3öF‰u ƒÆƒæð‰u VWÿ5t)Aÿdà@‰Eä;Çt ‹CüH;Ær‹ÆPSÿuäèæ#Sÿuà迃ÄÇEüþÿÿÿè.ƒ}àu1…öuFƒÆƒæð‰u VSjÿ5t)AÿÔà@‹øë‹u ‹]jè¨ÑÿÿYË}ä…ÿ…¿9=€)At,VèóÿÿY…À…Òþÿÿè´Êÿÿ9}àul‹ðÿ\à@Pè_ÊÿÿY‰ë_…ÿ…ƒèÊÿÿ9}àthÇ ëq…öuFVSjÿ5t)AÿÔà@‹ø…ÿuV9€)At4Vè›òÿÿY…ÀtƒþàvÍVè‹òÿÿYèCÊÿÿÇ 3ÀèÇÊÿÿÃè0Êÿÿé|ÿÿÿ…ÿuè"Êÿÿ‹ðÿ\à@PèÒÉÿÿ‰Y‹ÇëÒ‹ÿU‹ì‹M S3Û;Ëv(jà3ÒX÷ñ;EsèíÉÿÿSSSSSÇ èuÉÿÿƒÄ3ÀëA¯MVW‹ñ9]t ÿuèÈ)Y‹ØVÿuèýÿÿ‹øYY…ÿt;Þs+óVjßSèX­ÿÿƒÄ ‹Ç_^[]ËÿU‹ì‹ h*A¡l*AkÉÈë‹U+P úr ƒÀ;Árë3À]ËÿU‹ìƒì‹M‹AV‹u W‹þ+y ƒÆüÁï‹ÏiÉŒD‰Mð‹I‰MüöÁ…ÓS1‹‰Uô‹Vü‰Uø‹Uô‰] öÂutÁúJƒú?vj?Z‹K;KuB»€ƒú s‹ÊÓëL÷Ó!\¸Dþ u#‹M!ëJàÓëL÷Ó!œ¸Äþ u‹M!Y‹] ‹S‹[‹MüMô‰Z‹U ‹Z‹R‰S‰Mü‹ÑÁúJƒú?vj?Z‹]øƒã‰]ô…+uø‹]øÁûj?‰u K^;Þv‹ÞMø‹ÑÁúJ‰Mü;Öv‹Ö;Út^‹M ‹q;qu;¾€ƒû s‹ËÓî÷Ö!t¸DþLu!‹M!1ëKàÓî÷Ö!´¸ÄþLu‹M!q‹M ‹q‹I‰N‹M ‹q‹I‰N‹u ë‹]ƒ}ôu;Ú„€‹Mð Ñ‹Y‰N‰^‰q‹N‰q‹N;Nu`ŠLˆMþÁˆLƒú s%€}u‹Ê»€Óë‹M »€‹ÊÓëD¸D ë)€}uJເÓë‹M YJ຀Óê„¸Ä ‹Eü‰‰D0ü‹Eðÿ…ó¡|)A…À„Ø‹ |*A‹5¼à@h@ÁáH »€SQÿÖ‹ |*A¡|)Aº€Óê P¡|)A‹@‹ |*Aƒ¤ˆÄ¡|)A‹@þHC¡|)A‹H€yCu ƒ`þ¡|)AƒxÿueSjÿp ÿÖ¡|)Aÿpjÿ5t)Aÿ`à@‹ h*A¡|)AkÉ‹l*A+ÈLìQHQPèí+‹EƒÄ ÿ h*A;|)Avƒm¡l*A£t*A‹E£|)A‰=|*A[_^Éáx*AV‹5h*AW3ÿ;ðu4ƒÀkÀPÿ5l*AWÿ5t)AÿÔà@;Çu3Àëxƒx*A‹5h*A£l*Akö5l*AhÄAjÿ5t)Aÿdà@‰F;ÇtÇjh hWÿØà@‰F ;ÇuÿvWÿ5t)Aÿ`à@뛃Nÿ‰>‰~ÿh*A‹Fƒÿ‹Æ_^ËÿU‹ìQQ‹M‹ASV‹qW3ÛëÀC…À}ù‹ÃiÀ„0Dj?‰EøZ‰@‰@ƒÀJuôj‹ûhÁçy h€WÿØà@…ÀuƒÈÿé—p‰Uü;úwC‹Ê+ÏÁé GAƒHøÿƒˆìÿü‰üïÿÿÇ@üð‰PÇ€èðIuË‹Uü‹EøøO ‰H‰AJ ‰H‰AƒdžD3ÿG‰¼žÄŠFCŠÈþÁ„À‹EˆNCu xº€‹ËÓê÷Ò!P‹Ã_^[ÉËÿU‹ìƒì ‹M‹ASV‹uW‹} ‹×+Q ƒÆÁê‹ÊiÉŒD‰Mô‹OüƒæðI;ñ|9ü‹‰M‰]üŽUöÃ…EÙ;ó;‹MüÁùI‰Møƒù?vj?Y‰Mø‹_;_uC»€ƒù sÓë‹MøL÷Ó!\Dþ u&‹M!ëƒÁàÓë‹MøL÷Ó!œÄþ u‹M!Y‹O‹_‰Y‹O‹‰y‹M+ÎMüƒ}üŽ¥‹}ü‹M ÁÿOL1üƒÿ?vj?_‹]ôû‰]‹[‰Y‹]‰Y‰K‹Y‰K‹Y;YuWŠLˆMþÁˆLƒÿ s€}u‹Ï»€Óë‹M DD‹Ïë €}uOເÓë‹M Y„ÄO຀Óê ‹U ‹MüD2ü‰‰Lüë‹U F‰Bü‰D2øé<3Àé8/‹] )uN‰Kü\3ü‹uÁþN‰] ‰Küƒþ?vj?^öEü…€‹uüÁþNƒþ?vj?^‹O;OuB»€ƒþ s‹ÎÓët÷Ó!\Dþu#‹M!ëNàÓëL÷Ó!œÄþ u‹M!Y‹] ‹O‹w‰q‹w‹O‰q‹uuü‰uÁþNƒþ?vj?^‹Mô ñ‹y‰K‰{‰Y‹K‰Y‹K;KuWŠLˆMþÁˆLƒþ s€}u‹Î¿€Óï‹M 9DD‹Îë €}uNà¿€Óï‹M y„ÄN຀Óê ‹E‰‰Dü3À@_^[ÉËÿU‹ìƒì¡h*A‹MkÀl*AƒÁƒáð‰MðÁùSIƒù VW} ƒÎÿÓîƒMøÿë ƒÁàƒÊÿ3öÓê‰Uø‹ t*A‹Ùë‹S‹;#Uø#þ ×u ƒÃ‰];Ørè;Øu‹l*Aë‹S‹;#Uø#þ ×u ƒÃ‰];Ùrè;Ùu[ë ƒ{u ƒÃ‰];Ørð;Øu1‹l*Aë ƒ{u ƒÃ‰];Ùrð;Ùuè úÿÿ‹Ø‰]…Ûu3Àé Sè:ûÿÿY‹K‰‹Cƒ8ÿtå‰t*A‹C‹‰Uüƒúÿt‹ŒÄ‹|D#Mø#þ Ïu)ƒeü‹ÄHD‹9#Uø#þ ×uÿEü‹‘„ƒÁëç‹Uü‹ÊiÉŒD‰Mô‹LD3ÿ#Îu‹ŒÄ#Møj _ëÉG…É}ù‹Mô‹Tù‹ +Mð‹ñÁþNƒþ?‰Mø~j?^;÷„‹J;Ju\ƒÿ »€}&‹ÏÓë‹Mü|8÷Ó‰]ì#\ˆD‰\ˆDþu3‹Mì‹]! ë,OàÓë‹MüŒˆÄ|8÷Ó!þ‰]ìu ‹]‹Mì!Kë‹]ƒ}ø‹J‹z‰y‹J‹z‰y„‹Mô ñ‹y‰J‰z‰Q‹J‰Q‹J;Ju^ŠLˆM þÁƒþ ˆL}#€} u ¿€‹ÎÓï ;‹Î¿€Óï‹Mü |ˆDë)€} u Nà¿€Óï {‹Mü¼ˆÄNྀÓî 7‹Mø…Ét ‰ ‰Lüë‹Mø‹uðÑN‰ ‰L2ü‹uô‹y‰>…Éu;|)Au‹Mü; |*Auƒ%|)A‹Mü‰B_^[ÉËÿU‹ìSV‹uW3ÿƒËÿ;÷uèµ¾ÿÿWWWWWÇè=¾ÿÿƒÄ ÃëBöF ƒt7Vè(ÃÿÿV‹ØèÄ(Vè³¼ÿÿPèë'ƒÄ…À}ƒËÿë‹F;Çt PèÎÁÿÿY‰~‰~ ‹Ã_^[]Ãj hÈ÷@è—¾ÿÿƒMäÿ3À‹u3ÿ;÷•À;Çuè2¾ÿÿÇWWWWW躽ÿÿƒÄƒÈÿë öF @t ‰~ ‹Eäèš¾ÿÿÃVè– ÿÿY‰}üVè*ÿÿÿY‰EäÇEüþÿÿÿèëÕ‹uVèä ÿÿYËÿU‹ì¸äè8*¡€A3ʼnEü‹E V3ö‰…4åÿÿ‰µ8åÿÿ‰µ0åÿÿ9uu3Àéé;Æu'訽ÿÿ‰0莽ÿÿVVVVVÇè½ÿÿƒÄƒÈÿé¾SW‹}‹ÇÁø4… *A‹ƒçÁçÇŠX$ÛÐû‰µ(åÿÿˆ'åÿÿ€ût€ûu0‹M÷ÑöÁu&è?½ÿÿ3ö‰0è#½ÿÿVVVVVÇ諼ÿÿƒÄéCö@ tjjjÿuècƒÄÿuèÖêÿÿY…À„‹öD€„èëÖÿÿ‹@l3É9H…åÿÿ”ÁP‹ÿ4‰ åÿÿÿàà@…À„`3É9 åÿÿt„Û„PÿÜà@‹4åÿÿ‰…åÿÿ3À‰…<åÿÿ9E†B‰…DåÿÿŠ…'åÿÿ„À…gŠ ‹µ(åÿÿ3À€ù ”À‰… åÿÿ‹ǃx8tŠP4ˆUôˆMõƒ`8jEôPëK¾ÁPè×ìÿÿY…Àt:‹4åÿÿ+ËM3À@;Ȇ¥j…@åÿÿSPè<(ƒÄ ƒøÿ„±Cÿ…DåÿÿëjS…@åÿÿPè(ƒÄ ƒøÿ„3ÀPPjMôQj@åÿÿQPÿµåÿÿCÿ…Dåÿÿÿ°à@‹ð…ö„\j…<åÿÿPVEôP‹…(åÿÿ‹ÿ4ÿ˜à@…À„)‹…Dåÿÿ‹0åÿÿÁ9µ<åÿÿ‰…8åÿÿŒƒ½ åÿÿ„Íj…<åÿÿPjEôP‹…(åÿÿ‹ÆEô ÿ4ÿ˜à@…À„Ѓ½<åÿÿŒÏÿ…0åÿÿÿ…8åÿÿéƒ<t<u!·33Éfƒþ ”ÁCCƒ…Dåÿÿ‰µ@åÿÿ‰ åÿÿ<t<uRÿµ@åÿÿè%%Yf;…@åÿÿ…hƒ…8åÿÿƒ½ åÿÿt)j XP‰…@åÿÿèø$Yf;…@åÿÿ…;ÿ…8åÿÿÿ…0åÿÿ‹E9…Dåÿÿ‚ùýÿÿé'‹Šÿ…8åÿÿˆT4‹‰D8é3É‹Çö@€„¿‹…4åÿÿ‰@åÿÿ„Û…ʉ…<åÿÿ9M† 답(åÿÿ‹<åÿÿƒ¥Dåÿÿ+4åÿÿ…Håÿÿ;Ms9‹•<åÿÿÿ…<åÿÿŠA€ú uÿ…0åÿÿÆ @ÿ…Dåÿÿˆ@ÿ…Dåÿÿ½Dåÿÿÿr‹؅Håÿÿ+Øj…,åÿÿPS…HåÿÿP‹ÿ4ÿ˜à@…À„B‹…,åÿÿ…8åÿÿ;ÃŒ:‹…<åÿÿ+…4åÿÿ;E‚Lÿÿÿé ‰…Dåÿÿ€û…Ñ9M†M답(åÿÿ‹Dåÿÿƒ¥<åÿÿ+4åÿÿ…Håÿÿ;MsF‹•Dåÿÿƒ…Dåÿÿ·AAfƒú uƒ…0åÿÿj [f‰@@ƒ…<åÿÿƒ…<åÿÿf‰@@½<åÿÿþrµ‹Ø…Håÿÿ+Øj…,åÿÿPS…HåÿÿP‹ÿ4ÿ˜à@…À„b‹…,åÿÿ…8åÿÿ;ÃŒZ‹…Dåÿÿ+…4åÿÿ;E‚?ÿÿÿé@9M†|‹Dåÿÿƒ¥<åÿÿ+4åÿÿj…Hùÿÿ^;Ms<‹•Dåÿÿ·µDåÿÿÎfƒú uj [f‰Æµ<åÿÿµ<åÿÿf‰ƽ<åÿÿ¨r¿3öVVhU ðëÿÿQHùÿÿ+Á™+ÂÑøP‹ÁPVhéýÿ°à@‹Ø;Þ„—j…,åÿÿP‹Ã+ÆP„5ðëÿÿP‹…(åÿÿ‹ÿ4ÿ˜à@…Àt µ,åÿÿ;ÞËë ÿ\à@‰…@åÿÿ;Þ\‹…Dåÿÿ+…4åÿÿ‰…8åÿÿ;E‚ ÿÿÿë?j,åÿÿQÿuÿµ4åÿÿÿ0ÿ˜à@…Àt‹…,åÿÿƒ¥@åÿÿ‰…8åÿÿë ÿ\à@‰…@åÿÿƒ½8åÿÿulƒ½@åÿÿt-j^9µ@åÿÿuè·ÿÿÇ è·ÿÿ‰0ë?ÿµ@åÿÿè"·ÿÿYë1‹µ(åÿÿ‹öD@t‹…4åÿÿ€8u3Àë$èÖ¶ÿÿÇèÞ¶ÿÿƒ ƒÈÿë ‹…8åÿÿ+…0åÿÿ_[‹Mü3Í^èhžÿÿÉÃjhè÷@èè¶ÿÿ‹Eƒøþu袶ÿÿƒ 臶ÿÿÇ ƒÈÿé3ÿ;Ç|;*Ar!èy¶ÿÿ‰8è_¶ÿÿÇ WWWWWèçµÿÿƒÄëÉ‹ÈÁù *A‹ðƒæÁæ‹ ¾L1ƒát¿Pè9$Y‰}ü‹öD0tÿuÿu ÿuè.øÿÿƒÄ ‰EäëèüµÿÿÇ è¶ÿÿ‰8ƒMäÿÇEüþÿÿÿè ‹Eäèh¶ÿÿÃÿuèƒ$YÃjhø@è ¶ÿÿ‹Eƒøþuè³µÿÿÇ ƒÈÿéª3Û;Ã|;*Arè’µÿÿÇ SSSSSèµÿÿƒÄëЋÈÁù< *A‹ðƒæÁ拾LƒátÆPèl#Y‰]ü‹öDt1ÿuèà"YPÿäà@…Àu ÿ\à@‰Eäë‰]ä9]ätè1µÿÿ‹Mä‰èµÿÿÇ ƒMäÿÇEüþÿÿÿè ‹Eä臵ÿÿÃÿuè¢#YËÿU‹ìƒìS3Û9]uèÖ´ÿÿSSSSSÇè^´ÿÿƒÄ3ÀëjV‹u ;óuè²´ÿÿSSSSSÇè:´ÿÿƒÄë9ur3Àë>ÿuMðèVœÿÿ‹MôFÿ9YtH9Ew ¶öD uð‹Î+ȃá+ñN‹Æ8]üt‹Møƒapý^[ÉËÿU‹ìjÿu ÿuèUÿÿÿƒÄ ]ËÿU‹ìƒìS3ÛV‹u9]u;óu9] u3Àéç;ót9] wè ´ÿÿj^SSSSS‰0è’³ÿÿƒÄ‹ÆéÀ9]uˆëÉW‹};ûuˆèسÿÿj^SSSSS‰0èa³ÿÿƒÄé(ÿuMì胛ÿÿ‹Eð9XuÿuWÿu Vè£ ƒÄéLƒ}ÿ‹U ‹ÆuŠˆ@G:ËtJuó늈@G:ËtJtÿMuî9]uˆ@;Ó…È8tƒ}u5xÿ‰}ü;þrEìP‹Eü¶Pè0¿ÿÿYY…ÀtÿMü9uüsâ‹Ç+Eü¨…Ã}ÿuZ‹E ƒøv:|þ‰};þr!EìP‹E¶Pèì¾ÿÿYY…ÀtÿM9usâ‹E ‹Ï+MöÁtˆëˆ\ÿ8]øt‹Eôƒ`pýjPXéˆè·²ÿÿj"^SSSSS‰0è@²ÿÿƒÄ8]øt‹Eôƒ`pý‹Æëd‹È+΃ù|Mxþ‰};þrEìP‹E¶Pèi¾ÿÿYY…ÀtÿM9usâ‹Ç+E¨tˆèT²ÿÿ‹Èj*X‰8]øt‹Môƒapýë8]øt‹Eôƒ`pý3À_^[ÉËÿU‹ì‹E…Àtƒè8ÝÝuPèxµÿÿY]ËÿU‹ìƒì¡€A3ʼnEüSV3ÛW‹ñ9„)Au8SS3ÿGWhdê@hSÿðà@…Àt‰=„)Aëÿ\à@ƒøxu Ç„)A9]~"‹M‹EI8t@;ËuöƒÉÿ‹E+ÁH;E}@‰E¡„)Aƒø„¬;Ĥƒø…̉]ø9] u‹‹@‰E ‹5ìà@3À9]$SSÿu•ÀÿuÅPÿu ÿÖ‹ø;û„~Cjà3ÒX÷÷ƒør7D?=wèŽ#‹Ä;ÃtÇÌÌëPè äÿÿY;Ãt ÇÝ݃À‰Eôë‰]ô9]ô„>Wÿuôÿuÿujÿu ÿÖ…À„ã‹5ðà@SSWÿuôÿu ÿuÿ֋ȉMø;Ë„Â÷E t)9]„°;M§ÿuÿuWÿuôÿu ÿuÿÖé;Ë~Ejà3ÒX÷ñƒør9D =wèÏ"‹ô;ótjÇÌ̃ÆëPèJãÿÿY;Ãt ÇÝ݃À‹ðë3ö;ótAÿuøVWÿuôÿu ÿuÿðà@…Àt"SS9]uSSëÿuÿuÿuøVSÿu ÿ°à@‰EøVè¸ýÿÿYÿuôè¯ýÿÿ‹EøYéY‰]ô‰]ð9]u‹‹@‰E9] u‹‹@‰E ÿuè Y‰Eìƒøÿu3Àé!;E „ÛSSMQÿuPÿu è> ƒÄ‰Eô;ÃtÔ‹5èà@SSÿuPÿu ÿuÿÖ‰Eø;Ãu3öé·~=ƒøàw8ƒÀ=wè¹!‹ü;ûtÝÇÌ̃ÇëPè4âÿÿY;Ãt ÇÝ݃À‹øë3ÿ;ût´ÿuøSWèÀ’ÿÿƒÄ ÿuøWÿuÿuôÿu ÿuÿÖ‰Eø;Ãu3öë%ÿuEøÿuPWÿu ÿuìè‹ð‰uðƒÄ÷Þö#uøWèüÿÿYëÿuÿuÿuÿuÿu ÿuÿèà@‹ð9]ôt ÿuôèø±ÿÿY‹Eð;Ãt 9EtPèå±ÿÿY‹Æeà_^[‹Mü3Íè'–ÿÿÉËÿU‹ìƒìÿuMðè!–ÿÿÿu(Mðÿu$ÿu ÿuÿuÿuÿuÿu è(üÿÿƒÄ €}üt‹MøƒapýÉËÿU‹ìQQ¡€A3ʼnEü¡ˆ)ASV3ÛW‹ù;Ãu:EøP3öFVhdê@Vÿøà@…Àt‰5ˆ)Aë4ÿ\à@ƒøxu jX£ˆ)A롈)Aƒø„Ï;Äǃø…è‰]ø9]u‹‹@‰E‹5ìà@3À9] SSÿu•Àÿu ÅPÿuÿÖ‹ø;û„«~<ÿðÿÿw4D?=wèÒ‹Ä;ÃtÇÌÌëPèPàÿÿY;Ãt ÇÝ݃À‹Ø…Ûti?PjSèÞÿÿƒÄ WSÿuÿu jÿuÿÖ…ÀtÿuPSÿuÿøà@‰EøSèÉúÿÿ‹EøYëu3ö9]u‹‹@‰E9]u‹‹@‰EÿuèAYƒøÿu3ÀëG;EtSSMQÿu Pÿuèi‹ðƒÄ;ót܉u ÿuÿuÿu ÿuÿuÿôà@‹ø;ótVèæ¯ÿÿY‹Çeì_^[‹Mü3Íè(”ÿÿÉËÿU‹ìƒìÿuMðè"”ÿÿÿu$Mðÿu ÿuÿuÿuÿuÿu èþÿÿƒÄ€}üt‹MøƒapýÉËÿU‹ìV‹u…ö„ÿvèv¯ÿÿÿvèn¯ÿÿÿv èf¯ÿÿÿvè^¯ÿÿÿvèV¯ÿÿÿvèN¯ÿÿÿ6èG¯ÿÿÿv è?¯ÿÿÿv$è7¯ÿÿÿv(è/¯ÿÿÿv,è'¯ÿÿÿv0è¯ÿÿÿv4è¯ÿÿÿvè¯ÿÿÿv8è¯ÿÿÿv<èÿ®ÿÿƒÄ@ÿv@èô®ÿÿÿvDèì®ÿÿÿvHèä®ÿÿÿvLèÜ®ÿÿÿvPèÔ®ÿÿÿvTèÌ®ÿÿÿvXèÄ®ÿÿÿv\è¼®ÿÿÿv`è´®ÿÿÿvd謮ÿÿÿvh褮ÿÿÿvl蜮ÿÿÿvpè”®ÿÿÿvt茮ÿÿÿvxè„®ÿÿÿv|è|®ÿÿƒÄ@ÿ¶€èn®ÿÿÿ¶„èc®ÿÿÿ¶ˆèX®ÿÿÿ¶ŒèM®ÿÿÿ¶èB®ÿÿÿ¶”è7®ÿÿÿ¶˜è,®ÿÿÿ¶œè!®ÿÿÿ¶ è®ÿÿÿ¶¤è ®ÿÿÿ¶¨è®ÿÿƒÄ,^]ËÿU‹ìV‹u…öt5‹;HAtPèÝ­ÿÿY‹F;LAtPèË­ÿÿY‹v;5PAtVè¹­ÿÿY^]ËÿU‹ìV‹u…öt~‹F ;TAtPè—­ÿÿY‹F;XAtPè…­ÿÿY‹F;\AtPès­ÿÿY‹F;`AtPèa­ÿÿY‹F;dAtPèO­ÿÿY‹F ;hAtPè=­ÿÿY‹v$;5lAtVè+­ÿÿY^]ËÿU‹ì‹ES3ÛVW;Ãt‹} ;ûwè¡©ÿÿj^‰0SSSSSè*©ÿÿƒÄ‹Æë<‹u;óuˆëÚ‹Ð8tBOuø;ût BF:ËtOuó;ûuˆèZ©ÿÿj"Y‰‹ñëµ3À_^[]ÃÌÌÌÌÌÌU‹ìV3ÀPPPPPPPP‹U IŠ Àt ƒÂ«$ëñ‹uƒÉÿIƒÁŠ Àt ƒÆ£$sî‹ÁƒÄ ^ÉËÿU‹ìSV‹u3ÛW9]u;óu9] u3À_^[]Ã;ót‹} ;ûwę̀ÿÿj^‰0SSSSSèU¨ÿÿƒÄ‹ÆëÕ9]uˆëÊ‹U;Óuˆëу}ÿ‹ÆuŠ ˆ@B:ËtOuóëŠ ˆ@B:ËtOtÿMuî9]uˆ;ûu‹ƒ}ÿu‹E jPˆ\ÿXéxÿÿÿˆèR¨ÿÿj"Y‰‹ñë‚‹ÿU‹ì‹MS3ÛVW;Ët‹} ;ûwè,¨ÿÿj^‰0SSSSSèµ§ÿÿƒÄ‹Æë0‹u;óuˆëÚ‹ÑŠˆBF:ÃtOuó;ûuˆèñ§ÿÿj"Y‰‹ñëÁ3À_^[]ÃÌÌÌÌÌÌÌÌÌÌÌÌÌ‹T$‹L$÷Âu<‹:u. Àt&:au% ätÁè:Au Àt:auƒÁƒÂ äuÒ‹ÿ3ÀÃÀÑàƒÀÃ÷ÂtŠƒÂ:uçƒÁ ÀtÜ÷Ât¤f‹ƒÂ:uÎ ÀtÆ:auÅ ät½ƒÁëˆÌÌÌÌÌÌÌÌU‹ìWV‹u ‹M‹}‹Á‹ÑÆ;þv;ø‚¤ùrƒ=ˆ*AtWVƒçƒæ;þ^_u^_]é,÷ÇuÁéƒâƒùr*ó¥ÿ$•T‘@‹Çºƒér ƒàÈÿ$…h@ÿ$d‘@ÿ$è@x@¤@È@#ÑŠˆŠFˆGŠFÁéˆGƒÆƒÇƒùrÌó¥ÿ$•T‘@I#ÑŠˆŠFÁéˆGƒÆƒÇƒùr¦ó¥ÿ$•T‘@#ÑŠˆƒÆÁéƒÇƒùrˆó¥ÿ$•T‘@IK‘@8‘@0‘@(‘@ ‘@‘@‘@‘@‹DŽä‰Dä‹DŽè‰Dè‹DŽì‰Dì‹DŽð‰Dð‹DŽô‰Dô‹DŽø‰Dø‹DŽü‰Düðøÿ$•T‘@‹ÿd‘@l‘@x‘@Œ‘@‹E^_Éʈ‹E^_ÉʈŠFˆG‹E^_ÉÃIŠˆŠFˆGŠFˆG‹E^_ÉÃt1ü|9ü÷Çu$Áéƒâƒùr ýó¥üÿ$•ð’@‹ÿ÷Ùÿ$ ’@I‹Çºƒùr ƒà+Èÿ$…ô‘@ÿ$ð’@’@(’@P’@ŠF#шGƒîÁéƒïƒùr²ýó¥üÿ$•ð’@IŠF#шGŠFÁéˆGƒîƒïƒùrˆýó¥üÿ$•ð’@ŠF#шGŠFˆGŠFÁéˆGƒîƒïƒù‚Vÿÿÿýó¥üÿ$•ð’@I¤’@¬’@´’@¼’@Ä’@Ì’@Ô’@ç’@‹DމD‹DމD‹DމD‹DމD‹DŽ ‰D ‹DމD‹DމDðøÿ$•ð’@‹ÿ“@“@“@,“@‹E^_ÉÊFˆG‹E^_ÉÃIŠFˆGŠFˆG‹E^_ÉÊFˆGŠFˆGŠFˆG‹E^_ÉÃÌÌÌÌÌÌÌÌÌÌÌU‹ìV3ÀPPPPPPPP‹U IŠ Àt ƒÂ«$ëñ‹u‹ÿŠ Àt ƒÆ£$sñFÿƒÄ ^ÉËÿU‹ìQQ‹E V‹u‰Eø‹EWV‰EüèƒÏÿY;Çuèi£ÿÿÇ ‹Ç‹×ëJÿuMüQÿuøPÿá@‰Eø;Çuÿ\à@…Àt Pè[£ÿÿYëÏ‹ÆÁø‹… *AƒæÁæD0€ ý‹Eø‹Uü_^ÉÃjh(ø@èO£ÿÿƒÎÿ‰u܉uà‹Eƒøþuè£ÿÿƒ èå¢ÿÿÇ ‹Æ‹ÖéÐ3ÿ;Ç|;*Ar!èÖ¢ÿÿ‰8è¼¢ÿÿÇ WWWWWèD¢ÿÿƒÄëÈ‹ÈÁù *A‹ðƒæÁæ‹ ¾L1ƒáu&è•¢ÿÿ‰8è{¢ÿÿÇ WWWWWè¢ÿÿƒÄƒÊÿ‹Âë[PèpY‰}ü‹öD0tÿuÿuÿu ÿuè©þÿÿƒÄ‰E܉Uàëè-¢ÿÿÇ è5¢ÿÿ‰8ƒMÜÿƒMàÿÇEüþÿÿÿè ‹EÜ‹Uàè’¢ÿÿÃÿuè­YËÿU‹ìÿ Ahè¤ÿÿY‹M‰A…Àt ƒI ÇAëƒI A‰AÇA‹Aƒa‰]ËÿU‹ìƒìSVWèb¹ÿÿƒeüƒ=)A‹Ø…Žhô@ÿœà@‹ø…ÿ„*‹5(à@hôó@WÿÖ…À„P謸ÿÿÇ$äó@W£)AÿÖPè—¸ÿÿÇ$Ðó@W£”)AÿÖP肸ÿÿÇ$´ó@W£˜)AÿÖPèm¸ÿÿY£ )A…Àthœó@WÿÖPèU¸ÿÿY£œ)A¡œ)A;ÃtO9 )AtGP賸ÿÿÿ5 )A‹ð覸ÿÿYY‹ø…öt,…ÿt(ÿÖ…ÀtMøQj MìQjPÿ×…ÀtöEôu M ë9¡”)A;Ãt0Pèc¸ÿÿY…Àt%ÿЉEü…Àt¡˜)A;ÃtPèF¸ÿÿY…ÀtÿuüÿЉEüÿ5)Aè.¸ÿÿY…Àtÿuÿu ÿuÿuüÿÐë3À_^[ÉËÿU‹ì‹MV3ö;Î|ƒù~ ƒùu¡D Aë(¡D A‰ D Aëè ÿÿVVVVVÇ蚟ÿÿƒÄƒÈÿ^]ÃjhHø@è9 ÿÿ3À‹]3ÿ;ß•À;ÇuèØŸÿÿÇWWWWWè`ŸÿÿƒÄƒÈÿëSƒ=„*Au8jèU§ÿÿY‰}üSèÖÿÿY‰Eà;Çt ‹süƒî ‰uäë‹uäÇEüþÿÿÿè%9}àuSWÿ5t)Aÿá@‹ð‹ÆèùŸÿÿÃ3ÿ‹]‹uäjè#¦ÿÿYÃjè‰ÿÿYËÿU‹ìì(¡€A3ʼnEüöAVtj è3¾ÿÿYè Åÿÿ…Àtjè ÅÿÿYöA„ʉ…àýÿÿ‰Üýÿÿ‰•Øýÿÿ‰Ôýÿÿ‰µÐýÿÿ‰½ÌýÿÿfŒ•øýÿÿfŒìýÿÿfŒÈýÿÿfŒ…ÄýÿÿfŒ¥ÀýÿÿfŒ­¼ýÿÿœ…ðýÿÿ‹uE‰…ôýÿÿÇ…0ýÿÿ‰µèýÿÿ‹@üjP‰…äýÿÿ…ØüÿÿjPè:‚ÿÿ…ØüÿÿƒÄ ‰…(ýÿÿ…0ýÿÿjÇ…Øüÿÿ@‰µäüÿÿ‰…,ýÿÿÿTà@…(ýÿÿPÿPà@jèýŠÿÿÌÌÌU‹ìSVWUjjh™@ÿuèV"]_^[‹å]ËL$÷A¸t2‹D$‹Hü3Èè²…ÿÿU‹h‹P(R‹P$RèƒÄ]‹D$‹T$‰¸ÃSVW‹D$UPjþh™@dÿ5¡€A3ÄPD$d£‹D$(‹X‹p ƒþÿt:ƒ|$,ÿt;t$,v-4v‹ ³‰L$ ‰H ƒ|³uh‹D³èI‹D³è_ë·‹L$d‰ ƒÄ_^[Ã3Àd‹ y™@u‹Q ‹R 9Qu¸ÃSQ»”Aë SQ»”A‹L$ ‰K‰C‰k UQPXY]Y[ÂÿÐËÿU‹ìƒìVWÿuMì资ÿÿ‹E‹u 3ÿ;Çt‰0;÷u,èÑœÿÿWWWWWÇèYœÿÿƒÄ€}øt‹Eôƒ`pý3ÀéØ9}t ƒ}|Ƀ}$ËMìSЉ}ü~ƒ¹¬~EìP¶ÃjPèe¹ÿÿ‹MìƒÄ 닑ȶ÷Bƒà…ÀtŠGëÇ€û-uƒMë€û+uŠG‹E…ÀŒKƒø„Bƒø$9…Àu*€û0t ÇE ë4зɶÒÁá Ê9M u Hë·Ñ9U t @f¶·Éf;ËuÇ·É9M u8]üt‹Møƒapýë8]üt‹Eøƒ`pý3À^[ÉËÿU‹ìjÿu ÿuè2ÿÿÿƒÄ ]ÃÌÌÌBÿ[ä$d$3ÀŠD$S‹ØÁà‹T$÷ÂtŠ ƒÂ:ËtÏ„ÉtQ÷Âuë ØW‹ÃÁãV Ø‹ ¿ÿþþ~‹Á‹÷3Ëðùƒñÿƒðÿ3Ï3ƃÂáu%tÓ%uæ€uÄ^_[3ÀËBü:Ãt6„Àtï:ãt'„ätçÁè:Ãt„ÀtÜ:ãt„ätÔë–^_Bÿ[ÃBþ^_[ÃBý^_[ÃBü^_[Ãÿ%Ðà@‹ÿU‹ì‹US3Û;Óuè¬{ÿÿSSSSSÇè4{ÿÿƒÄƒÈÿë 8tß‹M ;ËtØ‹;ÃtÒ8tÎSQRèƒÄ []ËÿU‹ìƒì‹UV‹ujþX‰Eì‰Uä;ðuèc{ÿÿƒ èH{ÿÿÇ ƒÈÿéˆS3Û;ó|;5*Ar'è9{ÿÿ‰è{ÿÿSSSSSÇ è§zÿÿƒÄƒÈÿéQ‹ÆÁøW<… *A‹ƒæÁæÆŠHöÁuèózÿÿ‰èÙzÿÿÇ ëjúÿÿÿwP‰]ð;Ó„öÁ…ÿ9] t7Š@$ÀÐøˆEþ¾ÀHjYtHu‹Â÷Шtƒâþ‰U‹E ‰Eôé‹Â÷Шu!è‡zÿÿ‰èmzÿÿÇSSSSSèõyÿÿƒÄë4‹ÂÑè‰M;Ár‰Eÿuèz|ÿÿY‰Eô;Ãuè5zÿÿÇ è=zÿÿǃÈÿéhjSSÿuè|Öÿÿ‹‰D(‹EôƒÄ‰T,‹ÎöAHttŠI€ù tl9]tgˆ‹@ÿMÇEðÆD 8]þtN‹ŠL%€ù tC9]t>ˆ‹@ÿM€}þÇEðÆD% u$‹ŠL&€ù t9]tˆ‹@ÿMÇEðÆD& SMèQÿuP‹ÿ4ÿ,á@…À„{‹Mè;ËŒp;M‡g‹MðDö€„æ€}þ„;Ët ‹Mô€9 u€ë€ û‹]ô‹EðÉ]‰Eð;؃ЋMŠ<„®< t ˆCA‰Mé‹EðH;ÈsA€8 u AA‰MÆ ëu‰EëmÿEjEèPjEÿP‹ÿ4ÿ,á@…Àu ÿ\à@…ÀuEƒ}èt?‹öDHt€}ÿ t¹Æ ‹ŠMÿˆLë%;]ôu€}ÿ t jjÿjÿÿuèØÔÿÿƒÄ€}ÿ tÆ C‹Eð9E‚Gÿÿÿë‹Dö@u€ëŠˆC‹Ã+Eô€}þ‰Eð…Ð…À„ÈKŠ „ÉxCé†3À@¶Éëƒø;]ôrK¶ @€¹àAt芶ʾ‰àA…Éu èàwÿÿÇ*ëzA;ÈuØë@‹ÎöAHt$CƒøˆQ| Š‹ˆT%Cƒøu Š‹ˆT&C+Øë÷Ø™jRPÿuèþÓÿÿƒÄ‹Eä+]ôÑèPÿu Sÿuôjhéýÿìà@‰Eð…Àu4ÿ\à@Pè…wÿÿYƒMìÿ‹Eô;E tPèµzÿÿY‹Eìƒøþ…‹‹Eð郋Eð‹3É;ÕÁÀ‰Eð‰L0ëÆ;Ët‹Môfƒ9 u€ë€ û‹]ô‹EðÉ]‰Eð;؃ÿ‹E·fƒù„×fƒù tf‰ CC@@‰Eé´‹MðƒÁþ;ÁsHfƒ9 u ƒÀ‰Ej 鎉M鄃EjEèPjEøP‹ÿ4ÿ,á@…Àu ÿ\à@…Àu[ƒ}ètU‹öDHt(fƒ}ø t²j Xf‰‹ŠMøˆL‹ŠMùˆL%‹ÆD& ë*;]ôufƒ}ø t…jjÿjþÿuèšÒÿÿƒÄfƒ}ø tj Xf‰CC‹Eð9E‚ÿÿÿë‹tö@u€ëf‹f‰CC+]ô‰]ðé‘þÿÿÿ\à@j^;ÆuèÙuÿÿÇ èáuÿÿ‰0éiþÿÿƒøm…Yþÿÿ‰]ìé\þÿÿ3À_[^ÉÃjhðø@èïuÿÿ‹Eƒøþuè©uÿÿƒ èŽuÿÿÇ ƒÈÿé¾3ö;Æ|;*Ar!è€uÿÿ‰0èfuÿÿÇ VVVVVèîtÿÿƒÄëÉ‹ÈÁù *A‹øƒçÁç‹ ¾L9ƒát¿¹ÿÿÿ;MÉAuè2uÿÿ‰0èuÿÿÇë°PèãÿÿY‰uü‹öD8tÿuÿu ÿuè~ùÿÿƒÄ ‰EäëèâtÿÿÇ èêtÿÿ‰0ƒMäÿÇEüþÿÿÿè ‹EäèNuÿÿÃÿuèiãÿÿYËÿU‹ìƒì0S3ÛöE€VW‹ð‰]àˆ]þÇEÐ ‰]Ôt ‰]ØÆEÿë ÇE؈]ÿEàPè Y…Àt SSSSSèÒrÿÿƒÄ‹M¸€…Èu÷Á@u9Eàt€Mÿ€‹Áƒà+úÀ¿€tGHt.Ht&è7tÿÿ‰ƒÿètÿÿj^SSSSS‰0è£sÿÿƒÄé‰UøëöÁt÷ÁuîÇEø@ë‰}ø‹EjY+Át7+Át*+Át+Átƒè@u¡9}ø”À‰EðëÇEðëÇEðë ÇEðë‰]ð‹Eº#¹;Á¿;t0;Ãt,;Çt=„”=…@ÿÿÿÇEìë/ÇEìë&ÇEìë=t=t`;Â…ÿÿÿÇEì‹EÇEô€…Çt‹  A÷Ñ#M„ÉxÇEô¨@tMôMøƒMð©t }ô¨ tMôëÇEì릨tMôè£áÿÿ‰ƒøÿuèÎrÿÿ‰ƒÿè±rÿÿÇ鎋E‹=á@SÿuôÇÿuìEÐPÿuðÿuøÿu ÿ׉Eäƒøÿum‹Mø¸À#È;Èu+öEt%eøÿÿÿSÿuôEÐÿuìPÿuðÿuøÿu ÿ׉Eäƒøÿu4‹6‹ÆÁø‹… *AƒæÁæD0€ þÿ\à@Pè?rÿÿYèrÿÿ‹étÿuäÿ<à@;ÃuD‹6‹ÆÁø‹… *AƒæÁæD0€ þÿ\à@‹ðVèüqÿÿYÿuäÿá@;óu°èÃqÿÿÇ ë£ƒøu€Mÿ@ë ƒøu€Mÿÿuäÿ6è4Þÿÿ‹‹ÐƒàÁú‹• *AYÁàYŠMÿ€ÉˆL‹‹ÐƒàÁú‹• *AÁàD$€ €ˆMý€eýHˆMÿ…€öÁ€„±öEtqjƒÏÿWÿ6è£ƒÄ ‰Eè;Çuè:qÿÿ8ƒtMÿ6èéÙÿÿéúþÿÿjEüPÿ6ˆ]üè’õÿÿƒÄ …Àu€}üu‹Eè™RPÿ6è ƒÄ ;ÇtÃSSÿ6èFƒÄ ;Çt³öEÿ€„0¿@¹@…}u‹Eà#Çu Më E‹E#Ç;ÁtD=t)=@t"=t)=@t"=t=@uÆEþë‹M¸#È;Èu ÆEþëˆ]þ÷E„µöEÿ@‰]è…¨‹Eø¹À#Á=@„·=€tw;Á…„‹Eì;Æyƒøvƒøv0ƒø…f¾Eþ3ÿH„&H…RÇEèÿþÇEìéjSSÿ6è8ÌÿÿƒÄ ÂtÇSSSÿ6è'Ìÿÿ#ƒÄƒøÿ„ŽþÿÿjEèPÿ6è/ôÿÿƒÄ ƒøÿ„uþÿÿƒøtkƒø…­}èuYÆEþéÜ‹Eì;Æуø†bÿÿÿƒø‡PÿÿÿjSSÿ6è¸ËÿÿƒÄ „CÿÿÿSSSÿ6è£ËÿÿƒÄ#ƒøÿ…‘éþÿÿ‹Eè%ÿÿ=þÿuÿ6èß×ÿÿYèoÿÿj^‰0‹Æéd=ÿþuSjÿ6èXƒÄ ƒøÿ„ÀýÿÿÆEþëASSÿ6è=ƒÄ ë™ÇEèÇEì‹Eì+ÇPD=èPÿ6è¸ÿÿƒÄ ƒøÿ„€ýÿÿø9}ìÛ‹‹ÈÁù‹  *AƒàÁàD$Š2Mþ€á0‹‹ÈÁù‹  *AƒàÁàD$‹MŠÁéÀá€â ʈ8]ýu!öEt‹‹ÈƒàÁù‹  *AÁàD€ ‹}ø¸À‹Ï#È;Èu|öEtvÿuäÿá@SÿuôEÐjPÿuðçÿÿÿWÿu ÿá@ƒøÿu4ÿ\à@Pèÿmÿÿ‹‹ÈƒàÁù‹  *AÁàD€ þÿ6èÏÚÿÿYé˜ûÿÿ‹6‹ÎÁù‹  *AƒæÁ手Ã_^[ÉÃjhù@èÓmÿÿƒMäÿ3ö‰uà3À9u•À;ÆuèmmÿÿÇVVVVVèõlÿÿƒÄƒÈÿër‰uüÿuj@ÿu ÿuEàPEäè‰øÿÿƒÄ‰EÜÇEüþÿÿÿè‹}Ü;þt<èmÿÿ‰8ë¿3ö9uàt+9uÜt‹EäÁø‹MäƒáÁá‹… *AD€ þÿuäèÛÿÿYËEäèomÿÿËÿU‹ìQQV3ö9uuèÉlÿÿVVVVVÇèQlÿÿƒÄƒÈÿëJ9u tÞÿuEøPEüPÿuÿu è|ƒÄƒøÿtØÿuøÿuüÿujèUÿuü‹ðèÝoÿÿÿuøèÕoÿÿƒÄ‹Æ^ÉËÿU‹ìƒìSW‹}3Û‰}ü;ûu èIlÿÿSSSSSÇèÑkÿÿƒÄƒÈÿéá8tÜ‹E ;ÃtÕ‹;ÃtÏ8tËVj\Wè j/W‹ðè ƒÄ;Ã…;ó…ƒj:Wè=ïÿÿ‹ðYY;óusWèIšÿÿ‹ðƒÆjVèMnÿÿ‹øƒÄ ‰}ü;û„­htô@VWèkÃÿÿƒÄ …Àt SSSSSèjÿÿƒÄÿuVWèØÁÿÿƒÄ …Àt SSSSSèõiÿÿƒÄw‹}ë ;ót;Æv‹ðƒMðÿj.Vèh YY…Àt,Sÿuüè YY…À…ìÿuÿu ÿuüè`þÿÿƒÄ ‰EðéÓÿuüè–™ÿÿ‹ðƒÆjVèšmÿÿƒÄ ‰Eø;ÃuƒÈÿé½ÿuüVPè¸ÂÿÿƒÄ …Àt SSSSSè`iÿÿƒÄÿuüèQ™ÿÿ‹ø}øYèÚjÿÿ‹‰Eì‹Eø+÷ðÇEôìA‹Eôÿ0VWèrÂÿÿƒÄ …Àt SSSSSèiÿÿƒÄSÿuøè] YY…Àtƒmô}ôàA}Äëè„jÿÿÿu‹Mìÿu ‰ÿuøè”ýÿÿƒÄ ‰EðÿuøèÌmÿÿ‹}Y9}üt ÿuüè»mÿÿY‹Eð^_[ÉËÿU‹ìƒìSVW3ÛjSSÿu‰]ð‰]ôè–Æÿÿ‰Eè#ƒÄ‰UìƒøÿtYjSSÿuèzÆÿÿ‹È#ʃăùÿtA‹u ‹}+ðúˆÆ;󆼻Sjÿ4á@Pÿdà@‰Eü…ÀuèÇiÿÿÇ è¼iÿÿ‹_^[ÉÃh€ÿuèŠYY‰Eø…ÿ| ;ór‹Ãë‹ÆPÿuüÿu謫ÿÿƒÄ ƒøÿt6™+ðúxÓ…öwÏ‹uðÿuøÿuèFYYÿuüjÿ4á@Pÿ`à@3Ûé†èWiÿÿƒ8u è:iÿÿÇ ƒÎÿ‰uôë½;ûq|;óskSÿuÿu ÿuèÅÿÿ#ƒÄƒøÿ„Dÿÿÿÿuè›ÖÿÿYPÿ0á@÷ØÀ÷ØH™‰Eð#‰Uôƒøÿu)èÛhÿÿÇ èãhÿÿ‹ðÿ\à@‰‹uð#uôƒþÿ„öþÿÿSÿuìÿuèÿuèÅÿÿ#ƒÄƒøÿ„Ùþÿÿ3ÀéÙþÿÿ‹ÿU‹ìV‹uVè"ÖÿÿYƒøÿuèyhÿÿÇ ƒÈÿëMWÿujÿu Pÿá@‹øƒÿÿuÿ\à@ë3À…Àt PèihÿÿYƒÈÿë‹ÆÁø‹… *AƒæÁæD0€ ý‹Ç_^]ËÿU‹ìS‹] V‹u‹ÆÁø… *A‹ƒæÁæ 0ŠA$ÀW¶y¾Àç€Ñøû@tPû€tBût&ûtûu=€I€‹ L1$Š€â€Êˆë'€I€‹ L1$Š€â‚€Êëè€aë €I€‹ L1$€!€…ÿ_^[u¸€]Ã÷ØÀ%À@]ËÿU‹ì‹EV3ö;ÆuèNgÿÿVVVVVÇèÖfÿÿƒÄjXë ‹ d*A‰3À^]ËÿU‹ìƒìh‹ES3ÛW‰]ôˆ]ÿ;Ãtƒøt~ƒø~ ƒøu ÆEÿ‹E‰Eðë8ègÿÿ‰èçfÿÿSSSSSÇèofÿÿƒÄƒÈÿé®@8uûH8tÆ ‹Á8uëVjD^VE˜SPèdJÿÿ‰u˜‹5*AƒÄ ;ót+Fÿ‹È‹ÐÁù‹  *AƒâÁâ8\uNH;óuà;óŒ@þ23ƒ4‹ÆkÀƒÀf‰EÊ·ÀjPèÇhÿÿYY‰EÌ;Ä;ó‰0‹EÌH|0‰]ø~9‹Eø‹ÐƒàÁúÁà• *AŠPöÂuˆ‹‰ëˆƒÿÿEøAƒÇ9uø|Ê‹EÌ8]ÿt,H3ÒD0ƒþ}‹þëj_;×} ˆƒÿBAƒÀëäÇEôèÎeÿÿ‰EÜPE˜PSÿuÿuôjSSÿuðÿu ÿ à@‹ðÿ\à@ÿuÌ‹øèñhÿÿY;óu Wè£eÿÿYëXƒ}uSè4Rÿÿ‹5á@9]ujÿÿuÜÿà@EìPÿuÜÿà@‹]ìëƒ}uÿuÜÿÖë‹]ÜÿuàÿÖ‹Ãëè(eÿÿÇ ƒÈÿ^_[ÉËÿU‹ìƒì@¡€A3ʼnEü‹M ‹ESVW¾xô@}ð¥¥f¥‰MÔ‹M3Û‰Mà‹M¤j‰EÈ‹ø‹‰Mè‰]܉]ì‰]Ä^ëPè2“ÿÿƒÇt‹Y;ÃuìjV‰uÌè*gÿÿ‹uàYY‰;Ãu#‹Eè‰è˜dÿÿÇ è dÿÿǃÈÿé/EðPEìSPè¼ÚÿÿƒÄ ;ÃtƒøuqSSSSSèËbÿÿƒÄëbEðPè¹’ÿÿ‹øGGY‰}Ð9]ìtÿuì褒ÿÿøY‰}ЋEÔ;ÃtOj‹ð‹_ëP舒ÿÿƒÆ|‹Y;Ãuì¡< A;ÃuCèíÿÿ£< A;Ãu5‹uàÿ6ƒMÜÿèRgÿÿ‹Eè‰Y‰ée‹E艋}È‹‹6;Ã…ñFéU‰]ä8t(Š‹ð€ù=tVè’ÿÿY‹MäL¡< A4‰MäŠ:ËuÜ‹Mä‰MØë+8Xt-€x:u'€x=u!ƒÀPèÝ‘ÿÿY‹MØD‹ < A‰EØÁ€8=t΋EØ+Eä‹uÔø‰}ÀëEðP謑ÿÿPEðPÿ6èƒÄ…ÀtMƒÆ9uÝ}ÐjWè˜eÿÿ‹uàYY‹Mè‰;Ã…2ÿÿÿÿ6èkfÿÿY‰èúbÿÿÇ ècÿÿƒMÜÿÇéiÇEÄë´P‹Æ+ÆEÌPVèºÿÿƒÄ …Àt SSSSSè'aÿÿƒÄÿ7è‘ÿÿtƒÇë6P‹Eà‹+ÆEÌPVèIºÿÿƒÄ …Àt SSSSSèñ`ÿÿƒÄÿ7èãÿÿðƒÇÆ FY‹;ÃuËEèˆ^ÿˆ‹09]Ô„Í‹}Ø‹Eä‹Ï+ÈQ‹ < AÈQVèöºÿÿ+}äƒÄ ÷‹}Ôë6‹EÀ‹Mèÿ7+ÆPVèѹÿÿƒÄ …Àt SSSSSèy`ÿÿƒÄÿ7èkÿÿYtƒÇ9uÆ9]Äug‹}ÐEðPWVè—¹ÿÿƒÄ …Àt SSSSSè?`ÿÿƒÄh`ã@WVè¸ÿÿƒÄ …Àt SSSSSè`ÿÿƒÄ9]ìtÿuìWVèß·ÿÿƒÄ …Àt SSSSSèü_ÿÿƒÄ÷;ót ‹Eè;0uˆFˆ¡< A;ÃtPèÑdÿÿY‰< A9]ìt ÿuìè½dÿÿY‹EÜ‹Mü_^3Í[èIÿÿÉËÿU‹ìV3ö9uu$èBaÿÿ‰0è(aÿÿVVVVVÇè°`ÿÿƒÄjXëU÷E ùÿÿÿuÓÿuÿ8á@ƒøÿuÿ\à@PèaÿÿYèç`ÿÿ‹ë(¨u"¨töE tèã`ÿÿÇèÅ`ÿÿÇ ëÑ3À^]ËÿU‹ìƒìSÿu3ÛMì‰]üèlHÿÿ‹M;Ëu(è“`ÿÿSSSSSÇè`ÿÿƒÄ8]øt‹Eôƒ`pý3ÀëqV‹uð9^uÿu QèjYY8]øtW‹MôƒapýëNWŠ¶Â¶øöD7t!AŠ:Ót¶úÁà Ç9E uAÿ‰Eüë 9]üë9E u‰MüA:ÓuÃ_8]øt‹Eôƒ`pý‹Eü^[ÉËÿU‹ìjÿu ÿuè2ÿÿÿƒÄ ]ËÿU‹ìƒìS3Û9]u3ÀéšÿuMìèGÿÿ‹Eð9Xu&ÿuÿu ÿuèÇÔÿÿƒÄ 8]ø„m‹MôƒapýéaW‹};ût9] u.èƒ_ÿÿSSSSSÇè _ÿÿƒÄ8]øt‹Eôƒ`pý¸ÿÿÿé%Vf¶ÿM·É¶ÑGöD‰MütCŠ:Óu‰]üëXÁáf¶Òf Ê·Éf‹ñG‰Müf;pr f;pwfpë6f;pr0f;pw*fpë$·Uü öAt f¶‰·Éë·Ê‰Müf‹uü‹M f¶ ÿE ·É¶ÑöD‰MütE‹U Š:Óu‰]üëWÁáf¶Òf ÊÿE ·É‰Müf;Hr f;HwfHë6f;Hr0f;Hw*fHë$·Uü öAt f¶‰·Éë·Ê‰Müf‹Müf;Îu!f;ót 9]…ëþÿÿ8]øt‹Eôƒ`pý3À^_[ÉÃÀƒàH8]øtð‹Môƒapýëç‹ÿU‹ìjÿuÿu ÿuè#þÿÿƒÄ]ÃÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌU‹ìW‹}3ÀƒÉÿò®ƒÁ÷ÙƒïŠE ýò®ƒÇ8t3Àë‹Çü_ÉÔú°úÆúÜúîúûû4ûLû`ûhûzûˆûšû¬û¼ûÊûÜûôûüü8üVüjüzü†ü’üžü¶üÎüØüäüöüýýý(ý8ýNýZýjý’ý¬ýÄýÞýôýþþ*þDþTþjþ„þþžþ®þ¾þÐþäþôþ ÿÿ,ÿ>ÿPÿbÿnÿ|ÿŒÿ¢ÿ²ÿÂÿÐÿâÿôÿ(8Jç@²A@4K@ÎX@Ð_@»¬@˜@failed to get exit code from process. failed to create process. %s%sCould not exec %sCannot find Python executable %s #!python.exe#!Cannot open %s -script.pyCorExitProcessmscoree.dll(null)(null)EEE50P( 8PX700WP `h````xpxxxx¨!A"A  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~=EncodePointerKERNEL32.DLLDecodePointerFlsFreeFlsSetValueFlsGetValueFlsAllocruntime error TLOSS error SING error DOMAIN error R6034 An application has made an attempt to load the C runtime library incorrectly. Please contact the application's support team for more information. R6033 - Attempt to use MSIL code from this assembly during native code initialization This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. R6032 - not enough space for locale information R6031 - Attempt to initialize the CRT more than once. This indicates a bug in your application. R6030 - CRT not initialized R6028 - unable to initialize heap R6027 - not enough space for lowio initialization R6026 - not enough space for stdio initialization R6025 - pure virtual function call R6024 - not enough space for _onexit/atexit table R6019 - unable to open console device R6018 - unexpected heap error R6017 - unexpected multithread lock error R6016 - not enough space for thread data This application has requested the Runtime to terminate it in an unusual way. Please contact the application's support team for more information. R6009 - not enough space for environment R6008 - not enough space for arguments R6002 - floating point support not loaded Microsoft Visual C++ Runtime Library ...Runtime Error! Program: À À–ÀÀŽÀÀÀ‘À’À“À€€†€€†€†‚€EEE………00€P€ˆ('8PW€700PPˆ (€ˆ€€`h`hhhxppwpp ((((( H„„„„„„„„„„‚‚‚‚‚‚ h(((( H„„„„„„„„„„‚‚‚‚‚‚ H€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@abcdefghijklmnopqrstuvwxyz[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ABCDEFGHIJKLMNOPQRSTUVWXYZ{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿHH:mm:ssdddd, MMMM dd, yyyyMM/dd/yyPMAMDecemberNovemberOctoberSeptemberAugustJulyJuneAprilMarchFebruaryJanuaryDecNovOctSepAugJulJunMayAprMarFebJanSaturdayFridayThursdayWednesdayTuesdayMondaySundaySatFriThuWedTueMonSunGetProcessWindowStationGetUserObjectInformationAGetLastActivePopupGetActiveWindowMessageBoxAUSER32.DLLSunMonTueWedThuFriSatJanFebMarAprMayJunJulAugSepOctNovDecCONOUT$.com.exe.bat.cmd.\SystemRootH€AÐô@Ð7 i™þÿÿÿÔÿÿÿþÿÿÿ×@þÿÿÿÈÿÿÿþÿÿÿ¼#@þÿÿÿÌÿÿÿþÿÿÿ©%@½%@þÿÿÿŒÿÿÿþÿÿÿ<5@@5@þÿÿÿÔÿÿÿþÿÿÿã:@þÿÿÿÐÿÿÿþÿÿÿ±;@þÿÿÿÌÿÿÿþÿÿÿ;=@=@þÿÿÿÔÿÿÿþÿÿÿÀ>@þÿÿÿÔÿÿÿþÿÿÿó?@þÿÿÿÔÿÿÿþÿÿÿA@9A@þÿÿÿÔÿÿÿþÿÿÿ-G@þÿÿÿÌÿÿÿþÿÿÿûJ@þÿÿÿÔÿÿÿþÿÿÿkN@þÿÿÿÔÿÿÿþÿÿÿ­P@þÿÿÿ¼P@þÿÿÿØÿÿÿþÿÿÿoR@þÿÿÿ{R@þÿÿÿÔÿÿÿþÿÿÿ5Y@þÿÿÿØÿÿÿþÿÿÿÛZ@ïZ@þÿÿÿØÿÿÿþÿÿÿ-[@1[@þÿÿÿÀÿÿÿþÿÿÿˆ^@þÿÿÿÐÿÿÿþÿÿÿ_@/_@þÿÿÿÔÿÿÿþÿÿÿ)j@þÿÿÿÐÿÿÿþÿÿÿ:l@þÿÿÿÔÿÿÿþÿÿÿ>y@þÿÿÿÐÿÿÿþÿÿÿN@þÿÿÿÐÿÿÿþÿÿÿ/‚@þÿÿÿÌÿÿÿþÿÿÿ$•@þÿÿÿÐÿÿÿþÿÿÿ½—@þÿÿÿÐÿÿÿþÿÿÿT¡@þÿÿÿÔÿÿÿþÿÿÿË¥@þÿÿÿÈÿÿÿþÿÿÿ‘§@ͦ@þÿÿÿÐÿÿÿþÿÿÿL®@þÿÿÿÐÿÿÿþÿÿÿhÂ@þÿÿÿÌÿÿÿþÿÿÿ Ê@Tùà”ú°úÆúÜúîúûû4ûLû`ûhûzûˆûšû¬û¼ûÊûÜûôûüü8üVüjüzü†ü’üžü¶üÎüØüäüöüýýý(ý8ýNýZýjý’ý¬ýÄýÞýôýþþ*þDþTþjþ„þþžþ®þ¾þÐþäþôþ ÿÿ,ÿ>ÿPÿbÿnÿ|ÿŒÿ¢ÿ²ÿÂÿÐÿâÿôÿ(8JRGenerateConsoleCtrlEventÆGetExitCodeProcessnWaitForSingleObject•CreateProcessA¯SetConsoleCtrlHandlerõGetModuleFileNameAÚEnterCriticalSectionôLeaveCriticalSectionúGetModuleHandleW+Sleep"GetProcAddressExitProcesspGetCommandLineAðSetHandleCount>GetStdHandleØGetFileType<GetStartupInfoA¿DeleteCriticalSection7TerminateProcessªGetCurrentProcessHUnhandledExceptionFilterSetUnhandledExceptionFilterÖIsDebuggerPresentçGetLastError¦HeapFree¢HeapAlloc\GetCPInfoÅInterlockedIncrementÁInterlockedDecrementSGetACPGetOEMCPàIsValidCodePage>TlsGetValue<TlsAlloc?TlsSetValue=TlsFreeôSetLastError®GetCurrentThreadId—WriteFileöLoadLibraryAºInitializeCriticalSectionAndSpinCountKFreeEnvironmentStringsAÀGetEnvironmentStringsLFreeEnvironmentStringsW„WideCharToMultiByteÂGetEnvironmentStringsW¤HeapCreateaVirtualFreeYQueryPerformanceCounterjGetTickCount«GetCurrentProcessIdSGetSystemTimeAsFileTimešRtlUnwind©HeapReAlloc^VirtualAlloc„GetConsoleCP–GetConsoleModeBFlushFileBuffersæLCMapStringAMultiByteToWideCharèLCMapStringW@GetStringTypeACGetStringTypeWéGetLocaleInfoAçSetFilePointer«HeapSizeDCloseHandleŒWriteConsoleAšGetConsoleOutputCP–WriteConsoleWSetStdHandleyCreateFileASCompareStringAVCompareStringWØSetEnvironmentVariableAKERNEL32.dllnReadFileÕSetEndOfFile&GetProcessHeapÊGetFileAttributesAÀ+AÀ+ANæ@»±¿Dê#@lâ@\â@ÿÿÿÿ€         ! 5A CPR S WY l m pr € ‚ ƒ„ ‘)ž ¡¤ § ·Î×   abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZhA¤`‚y‚!¦ß¡¥Ÿàü@~€ü¨Á£Ú£ þ@þµÁ£Ú£ þAþ¶Ï¢ä¢å¢è¢[þ@~¡þQQÚ^Ú _ÚjÚ2ÓØÞàù1~þlí@þÿÿÿCAAAAAHAhë@ðï@pñ@ˆA˜A˜AhAÿÿÿÿÿÿÿÿøè@Ìè@  è@ è@Üç@¬ç@ˆç@\ç@$ç@üæ@Äæ@Œæ@dæ@Dæ@àå@ ¨å@!°ä@"ä@xä@yðã@zàã@üÜã@ÿÌã@Η@Η@Η@Η@Η@Η@Η@Η@Η@Η@x hë@jí@˜ó@”ó@ó@Œó@ˆó@„ó@€ó@xó@pó@hó@\ó@Pó@Hó@<ó@8ó@4ó@0ó@,ó@(ó@$ó@ ó@ó@ó@ó@ó@ ó@ó@øò@ðò@èò@(ó@àò@Øò@Ðò@Äò@¼ò@°ò@¤ò@ ò@œò@ò@|ò@pò@ ˆA.DAŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AHA. “€pðñÿÿPSTPDTÐAAÿÿÿÿÿÿÿÿþÿÿÿþÿÿÿÿÿÿÿ;Zx—µÔó0Nmÿÿÿÿ:Yw–´Óò/Mllô@dô@\ô@Tô@setuptools-20.7.0/setuptools/cli-64.exe0000664000175000017500000022200012702524020020575 0ustar travistravis00000000000000MZÿÿ¸@ິ Í!¸LÍ!This program cannot be run in DOS mode. $è W†^W†^W†^p¹ý^T†^W‡^ †^ê0^S†^I-^s†^I-^]†^I-^:†^I-^V†^RichW†^PEd†±‹Qð#  Öjx+@p€ì(`ü ð.textÔÖ `.rdata )ð*Ú@@.dataä5 @À.pdataü ` @@H‰\$H‰l$H‰t$H‰|$ ATAUAVHƒì L‹áHƒÉÿ3ÀI‹üºò®H÷ÑD HyÿHcÈè@ 3ö3íLcïÆ"HXL‹ð…ÿ~e€A¶ ,€ù\uÿÆë'€ù"u …ö~D‹Æ²\H‹Ë‹þèZ Hß+öÆ\HÿÃë3öA¶,HÿÅHÿÃI;íˆCÿ|¸…ö~D‹Æ²\H‹Ë‹þè% HßH‹l$HH‹t$PH‹|$XÆ"ÆCH‹\$@I‹ÆHƒÄ A^A]A\ÃÌÌÌÌÌÌÌÌÌH‰\$WHì`H‹¼H3ÄH‰„$PH‹ÙH‹Á¶ H‹ú„ÉtHÿÀ€ù/uÆ@ÿ\Š„ÉuîH„$@LŒ$@LD$@HT$0H‹ËH‰D$ è?€|$0…®€|$@\„£H„$@LŒ$@LD$@HT$0H‹ÏH‰D$ èHƒÉÿ3ÀH|$@ò®HD$@H÷ÑHÿÈHÿÉHÈ€9\uHÿÉ€9\tHD$@H;Èr ÆHÿÉ€9\uëLD$@HT$0HŒ$@L‹ËHÇD$ èÏ º¹è| H”$@뺹èc H‹ÓA¸H‹ÈH‹øè« H‹ÇH‹Œ$PH3ÌèøH‹œ$€HÄ`_ÃÌÌÌÌÌÌÌH‰\$H‰l$H‰t$H‰|$ ATAUAVHƒì H‹ÙHƒÉÿ3ÀL‹êH‹ûPò®H÷ÑHÿÉèç 3ÿH‹óA‰}¾ L‹ðE3äH‰èU…ÀtD¾KHÿÃè@…Àuð¶+HÿÃ@„ít[@¾Íè(…ÀtE…ätI@€ý\uÿÇëÙ@€ý"u@öÇu3ÀE…ä”À@2íD‹àÑÿ…ÿtL‹Ç²\H‹Îè¼ H÷3ÿ@„ít¢@ˆ.HÿÆëš…ÿtL‹Ç²\H‹Îè™ H÷3ÿÆAÿEIcEHÿÆI‰4Æ@„ít&¾ è¡…Àt¾KHÿÃè…Àuð€;…GÿÿÿH‹\$@H‹l$HH‹t$PH‹|$XI‹ÆHƒÄ A^A]A\ÃÌÌÌÌÌHƒì(…Éu‹ ‚!…Ét3Òÿ6ܸHƒÄ(ÃÌÌÌÌÌÌÌÌÌÌÌÌH‰\$WHìà3À3ÿH‹ÙHL$pDGh3Ò‰¼$ðH‰D$PH‰D$XH‰D$`èÆWH ŒÿÿÿÇD$phÿîÛL\$PHD$pL‰\$HH‰D$@H‰|$8H‰|$0E3ÉE3ÀH‹Ó3ɉ|$(ÇD$ ÿ«Û…Àu(èêH«ÞHH`èb3ÀH‹œ$øHÄà_ËD$`H‹L$PƒÊÿ‰• ÿ_ÛH‹L$PH”$ðÿDÛ…Àu(è“H,ÞHH`è 3ÀH‹œ$øHÄà_Ë„$ðH‹œ$øHÄà_ÃÌÌÌÌÌÌÌÌH‰\$H‰l$H‰t$WATAUHƒì L‹éHƒÉÿ3À»I‹ýIcèò®H;ÝH‹òH÷ÑL‹ËLQ}J‹<ÊHƒÉÿ3Àò®IÿÁH÷ÑDÑL;Í|æIcÊH‹ÓèHÌÝM‹ÅH‹ÈL‹àèHƒÉÿ3ÀI‹ýò®H;ÝH÷ÑLiÿ}0L‹ÞIcÍH•ÝIÌèÕH‹<ÞHƒÉÿ3ÀHÿÃò®H÷ÑDéH;Ý|ÐH‹\$@H‹l$HH‹t$PI‹ÄHƒÄ A]A\_ÃÌÌÌ@SWAVAWHìXH‹» H3ÄH‰„$0L‹òD‰D$ LcùHT$0A¸3ÉÿúÙHƒÉÿ3ÀH|$0ò®H÷ÑHD /HL$0H;Áv€8.tHT$0ÆHÿÈH;ÂwëÆ3ÀHƒÉÿH|$03Òò®H‹:ÝHL$0H‰Gÿ·2Ýf‰G¶)݈G è뷋؃øÿu"è³LD$0HïÜHH`è&CéóH”$0A¸‹ÈH‰¬$è1®HcÈH¼ 0‹Ëè_‡H”$0HÿÊHÿÂH;×s¶„Àt< t< uéÆHŒ$0HsÜA¸è…Àt%H‹MÜHŒ$0H‰‹D܉A¶>܈A HT$$HŒ$2èíúÿÿHT$0H‹8H‹ØH‹ÏèjùÿÿH‹èH…Àu èÍHÎÛL‹ÇHH`èBEéH‰´$P‹t$$L‰¤$HL‰¬$@E,7ºAEHcÈè¥H‹ÍL‹àèøÿÿƒþI‰$I|$~"HƒÃÿÎfH‹ èø÷ÿÿHƒÇHƒÃHƒîH‰GøuæHL$0èÜ÷ÿÿ»HƒÇI;ßH‰Gø}I‹ ÞèÁ÷ÿÿHÿÃHƒÇI;ßH‰Gø|çƒ|$ H‹´$PHÇt*I‹ÔH‹ÍèÔ¤èëHÔÚHH`L‹Åè`¸ëE‹ÅI‹ÔH‹ÍèsüÿÿH‹Èè;ûÿÿL‹¤$HL‹¬$@H‹¬$H‹Œ$0H3Ìès HÄXA_A^_[ÃÌÌÌÌÌE3ÀéýÿÿH‹ÄH‰PH‰HL‰@L‰H SVWATHƒì8H‹ù3Û‹ó‹ÃH;Ë•À;Ãu'èL&ÇH‰\$ E3ÉE3À3Ò3Éèb%ƒÈÿé‹ÃH;Ó•À;Ãu'è&ÇH‰\$ E3ÉE3À3Ò3Éè/%ƒÈÿéâLd$pèùöG@…•H‹Ïè¢#ƒøÿt*ƒøþt%HcÐH‹ÊHÁùL×)ƒâHkÒXIÈH 5 ëH , H‹ÑL²)öB8u%ƒøÿtƒøþtHcÈH‹ÁHÁøƒáHkÉXI ÀöA8€t"èj%ÇH‰\$ E3ÉE3À3Ò3Éè€$ƒÎÿ;óu*H‹Ïè ‹ØM‹ÌE3ÀH‹T$hH‹Ïè‹ðH‹×‹Ëè¼H‹Ï賋ÆHƒÄ8A\_^[ÃÌÌÌH™Ã@SHƒì ‹l;»…Àu¸ë;ÃLÃHcȺ‰I;èÀ%H‰+H…Àu$PH‹Ë‰,;è£%H‰+H…Àu¸ëx3ÉH+H‰HƒÂ0HƒÁHƒët H‹Ò*ëåE3ÀH"EHI‹ÈLx(I‹ÀHÁøƒáI‹ÂHkÉXL‹Iƒúÿt IƒúþtM…ÒuÇþÿÿÿIÿÀHƒÂ0Iƒéu¼3ÀHƒÄ [ÃÌÌHƒì(èC)€=4tèÍ&H‹ V*HƒÄ(é}&Ì@SHƒì H‹ÙH |H;Ùr:HH;Øw.H‹ÓH¸«ªªªªªª*H+ÑH÷êHÁúH‹ÊHÁé?Lèø*ºkë HK0ÿcÔHƒÄ [ÃÌ@SHƒì ƒùH‹Ú}ƒÁèÊ*ºkë HJ0ÿ5ÔHƒÄ [ÃÌÌÌHƒì(HñH;Êr7HuH;Èw+ºqH+ÊH¸«ªªªªªª*H÷éHÁúH‹ÊHÁé?Lèk)ë HƒÁ0ÿãÓHƒÄ(ÃÌÌHƒì(ƒù}ºrƒÁèB)ë HJ0ÿºÓHƒÄ(ÃÌ@SHƒì ƒd$@LD$@è_*H‹ØH…Àu9D$@tè¼"H…Àt è²"‹L$@‰H‹ÃHƒÄ [ÃÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌff„H‹ÁIƒørS¶ÒI¹I¯ÑIƒø@rH÷ÙƒátL+ÁH‰HÈM‹ÈIƒà?IÁéu9M‹ÈIƒàIÁétfffH‰HƒÁIÿÉuôM…Àt ˆHÿÁIÿÈuöÃ@fffffIùs0H‰H‰QH‰QHƒÁ@H‰QØH‰QàIÿÉH‰QèH‰QðH‰QøuØë”fDHÃHÃQHÃQHƒÁ@HÃQØHÃQàIÿÉHÃQèHÃQðHÃQøuÐð€ $éTÿÿÿÌÌÌÌÌÌÌÌÌÌÌÌff„L‹ÙM Àt$H+ÊöÂt(Š„Àˆ„ãHÿÂIÿÈtöÂuæë I‹ÃÃH‰HƒÂH‹Iƒèr&I¹ÿþþþþþþ~LÈL‹ÐIƒòÿM3ÑI¹M…ÑtÉIƒÀ„‹„Àˆ„„HÿÂIÿÈtx„äˆ$tuHÿÂIÿÈtiHÁè„ÀˆtbHÿÂIÿÈtV„äˆ$tSHÿÂIÿÈtGHÁè„Àˆt@HÿÂIÿÈt4„äˆ$t1HÿÂIÿÈt%Áè„ÀˆtHÿÂIÿÈt„äˆ$tHÿÂIÿÈ…<ÿÿÿI‹ÃÃHÊH3ÒIƒørEöÁt HÿÁˆIÿÈëñIƒè rH‰H‰QH‰QH‰QHƒÁ Iƒè sçIƒÀ Iƒèr H‰HƒÁëñIƒÀIƒèrˆHÿÁëóI‹ÃÃÌÌ@SHƒì E‹H‹ÚL‹ÉAƒãøAöL‹ÑtA‹@McP÷ØLÑHcÈL#ÑIcÃJ‹H‹C‹HHKöAt ¶AƒàðH˜LÈL3ÊI‹ÉHƒÄ [é™ÌHƒì(M‹A8H‹ÊI‹Ñè‰ÿÿÿ¸HƒÄ(ÃÌÌÌHƒì8H‹D$`H‰D$(L‰L$ M‹ÈL‹ÂHƒÊÿè¾'HƒÄ8ÃÌH‰\$L‰D$UVWATAUAVAWHƒì0L‹¤$¨L‹¬$˜H‹ùL‹ò3ÒM‹ù‹Ê‰T$pH;út L;òuL;Ât¹é¼L;ÂtñL;Êu H9”$uâë H9”$tÖL;êu H9”$ uÇë H9”$ t»L;âu H9”$°u¬ë H9”$°t ¸H‹ß8t HÿÈHÿÃH;Âwñ€;:u,L;òt!Iƒø‚;A¹L‹ÇHƒÊÿI‹ÎèÏ(3ÒH{ëL;òtAˆH‹êH‹òH‹ß8te¾ è–(3Ò;ÂtHÿÃëŠ L‰? H‹ ‹  è¥íÿÿ‹ø‰D$ …Ûu‹Èèôýÿÿèþÿÿë‹øƒ|$@u‹ÈèéýÿÿÌèÿýÿÿ‹ÇH‹\$HHƒÄ0_ÃÌHƒì(è7BHƒÄ(éVþÿÿÌÌH‹ÄH‰XH‰hH‰p H‰PWATAUAVAWHƒì@M‹yM‹!I‹q8M+çöAfM‹ñH‹êL‹é…Ü3ÿH‰HÈL‰@Ð9>†+H^ ‹CøL;à‚§‹CüL;àƒ›ƒ{„‘ƒ;t‹HL$0H‹ÕIÇÿÐ…Àˆ„~sA}csmàu(Hƒ=KtH Bè5…ÀtºI‹Íÿ+‹KA¸H‹ÕIÏèGBI‹F@‹SMcMH‰D$(I‹F(I×M‹ÅH‹ÍH‰D$ ÿ×ÃèJBÿÇHƒÃ;>sjé>ÿÿÿ3ÀëfI‹y 3íI+ÿ9.vTH^‹KôL;ár>‹CøL;às6H;ùr H;øsAöE u/ƒ;t ‹H;øt#ëH‹T$xIDZI‰D‹CüMÇAÿÐÿÅHƒÃ;.r°¸L\$@I‹[0I‹k@I‹sHI‹ãA_A^A]A\_ÃÌÌÌH‰\$H‰|$ATHƒì H‹Ùèè‹Èè•A…À„—èíÿÿHƒÀ0H;Øu3ÀëèòìÿÿHƒÀ`H;Øuw¸ÿÂ÷C ucL%&HcøIƒ<üu+¹èJI‰üH…ÀuHC H‰CH‰¸‰C$‰CëI‹ üÇC$ÇCH‰KH‰ K¸ë3ÀH‹\$0H‹|$8HƒÄ A\ÃÌÌÌ…Ét0SHƒì ºb H‹ÚsH‹ÊèÁcÿîÿÿƒc$Hƒ#HƒcHƒÄ [ÃÌÌÌ@SHƒì öB@I‹Øt HƒzuAÿë&ƒBÿx H‹ˆHÿ¶Áë¾Éèæ,ƒøÿu ëÿHƒÄ [ÃÌ…Ò~LH‰\$H‰l$H‰t$WHƒì I‹ùI‹ð‹Ú@ŠéL‹ÇH‹Ö@ŠÍÿËè…ÿÿÿƒ?ÿt…ÛçH‹\$0H‹l$8H‹t$@HƒÄ _ÃÌÌÌH‰\$H‰l$H‰t$WHƒì Aö@@I‹ùI‹ð‹ÚH‹ét IƒxuAë7…Ò~3ŠML‹ÇH‹ÖÿËèÿÿÿHÿŃ?ÿuè=ƒ8*uL‹ÇH‹Ö±?èÿþÿÿ…ÛÍH‹\$0H‹l$8H‹t$@HƒÄ _ÃÌÌH‰\$UVWATAUAVAWHìÐH‹JôH3ÄH‰„$È3ÀH‹ÙH‰L$hH‹úHL$xI‹ÐM‹é‰D$`D‹à‰D$TD‹ð‰D$H‰D$X‰D$Pè¨óÿÿE3ÒI;ÚuAè£3ÛE3ÉE3À3Ò3ÉÇH‰\$ è·8œ$tH‹„$ˆƒ ÈýƒÈÿéýAƒÏÿöC@L ðÏÿÿ…ºH‹Ëè HËóA;Çt(ƒøþt#LcÀL ÇÏÿÿI‹ÈAƒàHÁùMkÀXM„É€Cë L‹ÂL ¤ÏÿÿAö@8u)A;ÇtƒøþtHcÐH‹ÂƒâHÁøHkÒXI”Á€CöB8€tAè×3ÛE3ÉE3À3Ò3ÉÇH‰\$ èë 8œ$tH‹„$ˆƒ ÈýA‹Çé1E3ÒI;út·@Š/A‹òD‰T$@D‰T$DA‹ÒL‰”$˜A:ê„êH‹œ$¨A»HÿÇA;òH‰¼$°ŒÈEàÿtkHƒ>þteAöEt^AöEuH‹ÿ˜´A;ÇtILcçI‹ÄHÁøAƒäMkäXM$ÆH‹I‰$AŠEAˆD$IL$º èÎ*A;ÇtAÿD$ ëƒÈÿéÕÿÇIÿÅHƒÆ;û|‚E‹çI‹ÿH‹ßHkÛXH)Hƒ;ÿt Hƒ;þt€K€ëÆCAD$ÿ÷ØɃÁõ¸öÿÿÿE;çDÈÿî³H‹ðHƒøÿtJI;ÇtEH‹Èÿß³A;Çt7H‰3¶Àƒøu€K@ë ƒøu€KHKº è"*A;ÇtÿC ëƒÈÿë.€K@HÇþÿÿÿAÿÄHÿÇHƒÿŒQÿÿÿ‹ jÿl³3ÀëƒÈÿLœ$I‹[ I‹s(I‹{0M‹c8I‹ãA_A^A]ÃÌÌÌHƒì8H…Éu%è*Hƒd$ E3ÉE3À3Ò3ÉÇè?ƒÈÿë‹AHƒÄ8ÃÌÌH‰ YøÃ@SHìàƒd$pHL$t3ÒA¸”èPßÿÿL\$pH„$HŒ$L‰\$HH‰D$Pÿ³H‹œ$HT$@H‹ËE3ÀèqH…Àt;Hƒd$8H‹T$@HL$`H‰L$0HL$XL‹ÈH‰L$(HŒ$L‹ÃH‰L$ 3Éè-ë H‹„$èH‰„$H„$èH‰„$¨H‹„$èÇD$pÀÇD$tH‰„$€ÿe²3É‹ØÿS²HL$Hÿ@²…Àu …ÛuHèl4ÿ"²ºÀH‹Èÿ ²HÄà[ÃÌÌÌH‰\$H‰l$H‰t$WHƒì0H‹éH‹ ÷A‹ÙI‹øH‹òè@H…ÀtL‹T$`D‹ËL‹ÇH‹ÖH‹ÍL‰T$ ÿÐë%¹è÷3L‹\$`D‹ËL‹ÇH‹ÖH‹ÍL‰\$ èhþÿÿH‹\$@H‹l$HH‹t$PHƒÄ0_ÃÌÌÌL )å3ÀI‹ÑD@; t+ÿÀIЃø-ròAíƒøw¸ ÃÁDÿÿÿ¸ƒùAFÀÃH˜A‹DÁÃÌHƒì(èwH…Àu H;æëHƒÀHƒÄ(ÃHƒì(èWH…Àu HæëHƒÀHƒÄ(Ã@SHƒì ‹Ùè3H…Àu HûåëHƒÀ‰èLãåH…ÀtLP‹Ëè;ÿÿÿA‰HƒÄ [ÃÌÌH‰\$H‰l$H‰t$WHƒì 3ÿH‹ñƒÍÿH‹ÎèØ2H‹ØH…Àu(9®õv ‹Ïÿ°DŸèD;–õA‹ûGý;ýuÈH‹l$8H‹t$@H‹ÃH‹\$0HƒÄ _ÃH‹ÄH‰XH‰hH‰pH‰x ATHƒì 3ÿH‹òH‹éAƒÌÿE3ÀH‹ÖH‹ÍèiH‹ØH…Àu*93õv"‹Ïÿ¡¯DŸèD;õA‹ûAGüA;üuÀH‹l$8H‹t$@H‹|$HH‹ÃH‹\$0HƒÄ A\ÃÌH‹ÄH‰XH‰hH‰pH‰x ATHƒì 3öH‹úH‹éAƒÌÿH‹×H‹Íè”2H‹ØH…Àu/H…ÿt*9­ôv"‹Îÿ¯DžèD;•ôA‹óAGôA;ôu¾H‹l$8H‹t$@H‹|$HH‹ÃH‹\$0HƒÄ A\ÃÌÌÌH‰\$H‰l$H‰t$WATAUHƒì 3öI‹øH‹êAƒÍÿL‹áL‹ÇH‹ÕI‹ÌèÛ2H‹ØH…Àu/H…ÿt*9 ôv"‹ÎÿŽ®DžèD;ôA‹óAGõA;õu»H‹l$HH‹t$PH‹ÃH‹\$@HƒÄ A]A\_ÃH…Ét7SHƒì L‹ÁH‹ L3ÒÿÔ®…ÀuèSýÿÿH‹Øÿº®‹Èèûüÿÿ‰HƒÄ [ÃÌÌÌH‰\$H‰t$ATHƒì03öNèj^‰\$ ;ˆ}iLcãH‹\Jƒ<àtPJ‹ àöAƒtè&3ƒøÿtÿƉt$$ƒû|1H‹/J‹ àHƒÁ0ÿñ­H‹ J‹ áèAÿÿÿL‹ Kƒ$ãÿÉ\$ ë¹èç‹ÆH‹\$@H‹t$HHƒÄ0A\ÃH‰\$H‰t$WHƒì ‹A3öH‹Ù$<u?÷At6‹9+y…ÿ~-èúÿÿH‹SD‹Ç‹ÈèV:;Çu‹C„Àyƒàý‰CëƒK ƒÎÿH‹Kƒc‹ÆH‹t$8H‰ H‹\$0HƒÄ _ÃÌÌÌ@SHƒì H‹ÙH…Éuè5ë,èjÿÿÿ…ÀtƒÈÿëºcsH‹Ëè¢ùÿÿ‹Èè;÷ØÀë3ÀHƒÄ [ÃÌH‰t$H‰|$L‰d$AUAVAWHƒì0D‹ñE3ä3öNèç3ÿ‰|$ AƒÏÿ;=†LcïH‹ÒJƒ<ètjJ‹èöBƒt`‹ÏèÎ×ÿÿH‹²J‹ èöAƒt5Aƒþuè9ÿÿÿA;Çt%AÿÄD‰d$$ëE…öuöAtèÿÿÿA;ÇAD÷‰t$(H‹lJ‹ê‹Ïèý×ÿÿÿlj|$ énÿÿÿ¹è@AƒþADô‹ÆH‹t$PH‹|$XL‹d$`HƒÄ0A_A^A]ùéÿÿÿÌÌH‰\$H‰t$H‰|$ATHƒì L%á3ö3ÿI‹Üƒ{u%Hcƺ ÿÆH €HþðH ÈH‰ è"…Àt-HãHƒÃÿÇH;Ø|øH‹\$0H‹t$8H‹|$@HƒÄ A\ÃHcÇHÀIƒ$Ä3ÀëÛÌÌH‰\$H‰l$H‰t$WHƒì HuàH-®âH‹ûH‹7H…ötƒtH‹Îÿ$«H‹Îè|üÿÿHƒ'HƒÇH;ý|ÔH‹ H…Ét ƒ{uÿûªHƒÃH;Ý|ãH‹\$0H‹l$8H‹t$@HƒÄ _ÃÌHcÉHàHÉH‹ ÈHÿ%lªH‰\$H‰t$H‰|$AUHƒì HcÙ¾Hƒ=_üuèNèè¹ÿèZàÿÿH‹ûHÿL-©ßIƒ|ýt‹Æë{¹(èÃùÿÿH‹ØH…Àuè.ùÿÿÇ 3ÀëZ¹ èfIƒ|ýu/º H‹ËèŒ …ÀuH‹Ëè€ûÿÿèóøÿÿÇ 3öëI‰\ýë H‹ËèbûÿÿH‹ Êßÿœ©‹ÆH‹\$0H‹t$8H‹|$@HƒÄ A]ÃH‰\$WHƒì HcÙH=øÞHÛHƒ<ßuèõþÿÿ…ÀuHèßÿÿH‹ ßH‹\$0HƒÄ _Hÿ%8©H‰\$WHƒì0I‹ØH‹úH…Ét23ÒHBàH÷ñH;Çs$èHøÿÿHƒd$ E3ÉE3À3Ò3ÉÇ è]÷ÿÿ3Àë]H¯ù¸H…ÿHDø3ÀHƒÿàwH‹ òúPL‹Çÿ~©H…Àu-ƒ=êútH‹Ïè°…ÀuËH…Ût²Ç ëªH…ÛtÇ H‹\$@HƒÄ0_ÃÌH‰\$H‰l$H‰t$WHƒì0H‹òH‹éH…É„ûH…Ò„ò3ÿH‹ÙM…Àt!AŠ„Àt¿H;׆¼HYˆÆ:HÿÃI‹ÑM…ÉtAA€9t;HÿÇH;þƒ–ŠHÿˆHÿÀ:uåI‹ÉèL8€8/t€8\tHÿÇH;þsmÆ\HÿÃH‹L$`H…ÉtëHÿÇH;þsSŠˆHÿÃHÿÁ€9uéH‹L$hH…Ét1Š„Àt+<.t"HÿÇH;þs(Æ.HÿÃëHÿÇH;þsŠˆHÿÃHÿÁ€9uéHGH;ÆvÆEè°öÿÿ»"ëÆ3Àë#èöÿÿ»Hƒd$ E3ÉE3À3Ò3ɉè±õÿÿ‹ÃH‹\$@H‹l$HH‹t$PHƒÄ0_ÃÌÌH‰\$H‰t$WHƒì@‹ÚH‹ÑHL$ A‹ùA‹ðè<ÚÿÿH‹D$(D¶ÛA„|u…ötH‹D$ H‹ˆ@B·Y#Æë3À…Àt¸€|$8t H‹L$0ƒ¡ÈýH‹\$PH‹t$XHƒÄ@_ÃÌH‹Â‹ÑA¹H‹ÈE3ÀénÿÿÿÌÌ‹ÑA¹E3À3ÉéZÿÿÿÌÌHƒì8Hƒd$ èÍ6HƒÄ8ÃH‰L$HìˆH áîÿû¦L‹ÌïL‰\$XE3ÀHT$`H‹L$XèKsH‰D$PHƒ|$PtAHÇD$8HD$HH‰D$0HD$@H‰D$(HŒîH‰D$ L‹L$PL‹D$XH‹T$`3Éèùrë"H‹„$ˆH‰XïH„$ˆHƒÀH‰åîH‹>ïH‰¯íH‹„$H‰°îdží ÀÇ€íH‹%ÙH‰D$hH‹!ÙH‰D$pÿ¦‰ðí¹è"(3Éÿæ¥H Ÿ©ÿÑ¥ƒ=Êíu ¹èú'ÿ°¥º ÀH‹Èÿš¥HĈÃÌÌH‰\$H‰l$H‰t$WHƒì HYH‹é¾H‹ËL‹Æ3Òè«ÑÿÿE3ÛH}AKA·ÃD‰]D‰]D‰] fó«H=¦ÜH+ýŠˆHÿÃHƒîuòHºŠ9ˆHÿÁHƒêuòH‹\$0H‹l$8H‹t$@HƒÄ _ÃÌÌH‰\$H‰t$WHì€H‹ ØH3ÄH‰„$pH‹ñ‹IHT$Pÿ¥»…À„=3ÀHT$pˆÿÀHÿÂ;ÃrõŠD$VÆD$p H|$Vë)¶WD¶ÀD;ÂwA+ÐI‹ÀJLpDB² è½ÐÿÿHƒÇŠ„ÀuÓ‹F ƒd$8LD$p‰D$0‹FD‹Ë‰D$(H„$pº3ÉH‰D$ è?ƒd$@‹F‹V ‰D$8H„$p‰\$0H‰D$(LL$pD‹Ã3ɉ\$ èØ;ƒd$@‹F‹V ‰D$8H„$p‰\$0H‰D$(LL$pA¸3ɉ\$ è¢;Lœ$pHN3ÒAöt € Š„pëAöt€ Š„pˆëÆHÿÁHÿÂIƒÃHƒëu¿ë?3ÒHNDBŸA@ ƒøw€ B ë Aƒøw€ BàˆëÆÿÂHÿÁ;ÓrÇH‹Œ$pH3ÌèÖÕÿÿLœ$€I‹[I‹s I‹ã_ÃÌH‰\$WHƒì èÝ H‹ø‹ˆÈ… šßtHƒ¸Àt H‹˜¸ën¹ è÷øÿÿH‹Ÿ¸H‰\$0H;_ÞtDH…ÛtðƒÿuHÚH‹L$0H;ÈtèüóÿÿH‹5ÞH‰‡¸H‹'ÞH‰D$0ðƒH‹\$0¹ è“÷ÿÿH…ÛuK èÊ×ÿÿH‹ÃH‹\$8HƒÄ _Ã@SHƒì@‹ÙHL$ 3ÒèÕÿÿƒ%)ïƒûþu%Çïÿ”¢€|$8tSH‹L$0ƒ¡ÈýëEƒûýuÇðîÿb¢ëÔƒûüuH‹D$ ÇÔî‹@뻀|$8t H‹D$0ƒ Èý‹ÃHƒÄ@[ÃH‰\$UVWATAUHƒì@H‹ÝÔH3ÄH‰D$8H‹òèIÿÿÿ3Û‹ø;Ãu H‹ÎèüÿÿéL-1Ý‹ËH‹ëI‹ÅA¼98„'AÌIìHƒÀ0ƒùréÿèý„ÿéý„ø·Ïÿ³¡;ÄçHT$ ‹Ïÿ†¡;ÄÆHN3ÒA¸è]Íÿÿ‰~‰^ D9d$ †HD$&8\$&t-8Xt(¶8¶H;ùw+ÏHT7AÌ€ IÔI+ÌuõHƒÀ8uÓHF¹þ€IÄI+Ìuõ‹Né¤t(ƒétƒé tA;Ìt‹Ãë¸ë¸ë ¸ë¸‰F D‰fë‰^H~·Ã¹fó«éà9Bí…·þÿÿƒÈÿéÖHN3ÒA¸èƒÌÿÿHlmLÏÛHíAºMDíI‹ÈA8t18Yt,¶¶A;ÐwLL2AŠAÔA¶AMÌ;ÐvìHƒÁ8uÏIƒÀMÜM+Ôu»‰~ï¤D‰ft$ƒïtƒï t A;üu»ë»ë »ë»‰^ HVI|í¹·HƒÇf‰HƒÂI+ÌuíH‹Îè|úÿÿ3ÀH‹L$8H3ÌèÒÿÿH‹œ$€HƒÄ@A]A\_^]ÃÌH‹ÄH‰XH‰pH‰xL‰` AUHƒì0‹ùAƒÍÿèH‹ðèüÿÿH‹ž¸‹Ïè¾üÿÿD‹à;C„¹ è\îÿÿH‹Ø3ÿH;Ç„|H‹–¸H‹ÈA¸ èY:‰;H‹ÓA‹ÌèýÿÿD‹è;Ç…$H‹Ž¸ðƒÿuH‹Ž¸L%ÖI;ÌtèüïÿÿëL%ÖH‰ž¸ðƒö†È… öÛ…ü¹ èˆôÿÿ‹C‰^ë‹C‰Yë‹C ‰Të‹×‰T$ L«­ÿÿƒú}HcÊ·DKfA‰„Hˆ=ÿ‰T$ ëâ‹×‰T$ ú}HcÊŠDBˆ„ *ÿ‰T$ ëá‰|$ ÿ}HcÏŠ„Bˆ„0+ÿlj|$ ëÞH‹kÙðƒÿuH‹ ^ÙI;ÌtèïÿÿH‰MÙðƒ¹ èÃòÿÿë+ƒøÿu&L%ÕI;ÜtH‹ËèäîÿÿèWìÿÿÇë3ÿD‹ïA‹ÅH‹\$@H‹t$HH‹|$PL‹d$XHƒÄ0A]ÃHƒì(ƒ=aòu¹ýÿÿÿèñýÿÿÇKò3ÀHƒÄ(ÃH‰\$H‰t$WHƒì H‹(H‹ÙH…ÀtyH ÇÞH;ÁtmH‹ƒH…Àtaƒ8u\H‹‹ H…Étƒ9uè;îÿÿH‹‹(è·=H‹‹H…Étƒ9uèîÿÿH‹‹(èM=H‹‹èîÿÿH‹‹(èõíÿÿH‹ƒ0H…ÀtGƒ8uBH‹‹8HéþèÑíÿÿH‹‹H¿€H+Ïè½íÿÿH‹‹PH+Ïè®íÿÿH‹‹0è¢íÿÿH‹‹XHtÜH;Ètƒ¹`uèÕ:H‹‹XèuíÿÿH{X¾HµØH9GðtH‹H…Ét ƒ9uèMíÿÿHƒøtH‹OH…Ét ƒ9uè3íÿÿHƒÇ Hƒîu½H‹ËH‹\$0H‹t$8HƒÄ _éíÿÿÌÌðƒH‹H…ÀtðƒH‹ H…ÀtðƒH‹H…ÀtðƒH‹0H…ÀtðƒHAXA¸H ØH9Pðt H‹H…ÒtðƒHƒxøt H‹PH…ÒtðƒHƒÀ IƒèuÉH‹Xðƒ€`ÃÌÌÌH…É„˜AƒÉÿðD H‹H…ÀtðDH‹ H…ÀtðDH‹H…ÀtðDH‹0H…ÀtðDHAXA¸Hf×H9Pðt H‹H…ÒtðD Hƒxøt H‹PH…ÒtðD HƒÀ IƒèuÉH‹XðDˆ`H‹ÁÃÌÌÌ@SHƒì H‹ÚH…ÒtAH…Ét÷ÿÿL‹àH‹ Èåè/÷ÿÿH‹ØI;Ä‚˜H‹øI+üLoIƒý‚„I‹Ìèó9H‹ðI;ÅsTºH;ÂHBÐHÐH;ÐrI‹Ìè¿àÿÿ3ÛH;Ãuë3ÛHV H;ÖrFI‹Ìè£àÿÿH;Ãt9HÁÿHøH‹ÈèžöÿÿH‰GåI‹ÎèöÿÿH‰HKèƒöÿÿH‰$åI‹Þë3ÛèÆÿÿH‹ÃH‹\$@H‹t$HH‹|$PHƒÄ A^A]A\ÃÌÌÌHƒì(èïþÿÿH÷ØÀ÷ØÿÈHƒÄ(ÃÌH‰\$WHƒì H—¥H=¥ëH‹H…ÀtÿÐHƒÃH;ßríH‹\$0HƒÄ _ÃH‰\$WHƒì Ho¥H=h¥ëH‹H…ÀtÿÐHƒÃH;ßríH‹\$0HƒÄ _ÃH‰\$WHƒì HÏ¿ H‹ èªõÿÿH‰HƒÃHƒïuëH‹\$0HƒÄ _ÃÌÌH‹Á¹MZf9t3ÀÃHcHËÿÿÇ 3ÀH‹\$0H‹t$8HƒÄ _Ãè!ËÿÿH‹Øÿˆ|‹ÈèÉÊÿÿ‰ëÕèËÿÿH‹Øÿo|‹Èè°Êÿÿ‰H‹Æë»ÌH‰\$H‰t$WHƒì03ÿH‹ÚH‹ñH…Òt13ÒHGàH÷óI;Às#èÁÊÿÿH!|$ E3ÉE3À3Ò3ÉÇ è×Éÿÿ3Àë=I¯ØH…Étè%H‹øH‹ÓH‹ÎèÃþÿÿH‹ðH…ÀtH;ûsH+ßH 3ÒL‹Ãèá§ÿÿH‹ÆH‹\$@H‹t$HHƒÄ0_ÃÌÌH‰\$WHƒì0ƒÏÿH‹ÙH…Éu#è:ÊÿÿH!\$ E3ÉE3À3Ò3ÉÇèPÉÿÿ ÇëFöAƒt:è‰ÍÿÿH‹Ë‹øè*H‹ËèÇÇÿÿ‹Èèè(…ÀyƒÏÿëH‹K(H…Ét èiÌÿÿHƒc(ƒc‹ÇH‹\$@HƒÄ0_ÃÌÌÌH‰\$H‰L$WHƒì0H‹ÙƒÏÿ3ÀH…É•À…Àu$è¢ÉÿÿÇHƒd$ E3ÉE3À3Ò3Éè·Èÿÿ‹Çë&öA@tƒaëè~¥ÿÿH‹Ëèÿÿÿ‹øH‹Ëèû¥ÿÿ‹ÇH‹\$HHƒÄ0_ÃÌÌH‰\$ UVWATAUAVAW¸0èÞjH+àH‹„­H3ÄH‰„$ 3í3ÿE‹èL‹âHcÙ‰l$@E…Àu3ÀéçH…Òu.èÉÿÿ!8èóÈÿÿH!|$ E3ÉE3À3Ò3ÉÇè ÈÿÿƒÈÿé´L‹ûL‹óHÜÌIÁþAƒçJ‹ ðL‰t$PMkÿXAŠt8@ö@Ðþ@€þt@€þu A‹Å÷ШtAöD t 3Ò‹ËDBèš‹Ëèï÷ÿÿ…À„ñH|ÌJ‹ðAöD€„ÚèSáÿÿ3ÛHT$XH‹ˆÀHRÌ9YJ‹ ðI‹ ”ÃÿŽz…À„¤…Ût @„ö„—ÿkz!|$LI‹Ü‰D$XE…í„wD‹t$X½ @„ö…ƒH‹T$PŠ E3ö€ù H-èËH‹TÕA”ÆAƒ|Pt AŠDLˆL$]A¸ˆD$\AƒdPHT$\ëI¾ÉèË÷ÿÿ…Àt4I‹ÅH+ÃIÄHƒøŽÏHL$DA¸H‹Óè5*ƒøÿ„vHÿÃëA¸H‹ÓHL$Dè*ƒøÿ„UHƒd$8Hƒd$0‹L$XHD$\LD$DA¹3ÒÇD$(HÿÃH‰D$ ÿ#y‹è…À„H‹D$PHƒd$ H ËH‹ ÁLL$LHT$\I‹ D‹Åÿ¼x…À„B‹ûA+ü|$@9l$LŒË½ E…ö„¯H‹D$PHƒd$ @ˆl$\H ¬ÊLL$LDEôH‹ ÁHT$\I‹ ÿ`x…À„æƒ|$L|{ÿD$@ÿÇëe@€þt@€þu·E3öfƒø f‰D$DA”ÆHƒÃ@€þt@€þu6·L$Dèh&f;D$D…“ƒÇE…öt‹Íf‰l$DèI&f;D$DuxÿÇÿD$@‹ÃA+ÄA;Å‚þÿÿ‹\$LL‹t$P‹l$@…ÿ…¸…Û„zƒû…eèÃÅÿÿÇ èØÅÿÿ‰éØüÿÿŠL‹t$PÿÇJ‹LõAˆDLJ‹DõAÇDP‹\$Lë¥ÿôv‹Øë–‹\$Lë¡H‹ÉJ‹ ðAöD€„Ê3ÛI‹ì@„ö…ÐE…í„üS D‹t$@H´$ 3É‹ÅA+ÄA;Ås&ŠEHÿÅ< u ˆAÿÆHÿÆHÿÁHÿÁˆHÿÆHùÿrÐH!\$ H„$ D‹ÆD+ÀHÉD‰t$@L‹t$PLL$HH”$ J‹ ðI‹ ÿ³v…Àt5|$HH„$ H+ðHcD$HH;ÆŒÅþÿÿ‹Åº A+ÄA;Å‚Nÿÿÿé­þÿÿÿüu‹Øé þÿÿ@€þ…ÔE…í„"º D‹t$@H´$ 3É‹ÅA+ÄA;Ås1·EHƒÅfƒø uf‰AƒÆHƒÆHƒÁHƒÁf‰HƒÆHùþrÅH!\$ H„$ D‹ÆD+ÀH!ÈD‰t$@L‹t$PLL$HH”$ J‹ ðI‹ ÿÌu…À„Jÿÿÿ|$HH„$ H+ðHcD$HH;ÆŒÚýÿÿ‹Åº A+ÄA;Å‚?ÿÿÿéÂýÿÿE…í„NA¸ HL$p3Ò‹ÅA+ÄA;Ås.·EHƒÅfƒø u fD‰HƒÁHƒÂHƒÂf‰HƒÁHú¨rÈHƒd$8Hƒd$0HD$p+ÈLD$pÇD$(U ‹Á¹éý™+Â3ÒÑøD‹ÈH„$ H‰D$ ÿ-uD‹ð…À„€ýÿÿ3öH‹D$PHƒd$ HcÎH” E‹ÆH ÇH‹ ÁLL$HD+ÆI‹ ÿºt…Àt t$HD;ö½ëÿ-t‹ØD;öÈüÿÿ‹ýA¸ A+üA;ý‚ÿÿÿé¯üÿÿI‹ H!|$ LL$HE‹ÅI‹Ôÿgt…Àt ‹|$H3ÛéüÿÿÿÚs‹Øé‚üÿÿ‹ËèœÂÿÿé~ùÿÿHhÆJ‹ðAöD@t A€<$„.ùÿÿè4ÂÿÿÇèIÂÿÿƒ éHùÿÿ+ý‹ÇH‹Œ$ H3Ìèå¥ÿÿH‹œ$ˆHÄ0A_A^A]A\_^]ÃÌÌH‰\$H‰t$‰L$WATAUAVAWHƒì0E‹àL‹êHcÙƒûþuèâÁÿÿ3ÿ‰8è¹ÁÿÿÇ ƒÈÿéÔ3ÿ;ߌ¡;›Åƒ•H‹óL‹óIÁþL=œÅƒæHköXK‹÷¾L0ƒáu+èŠÁÿÿ‰8ècÁÿÿÇ H‰|$ E3ÉE3À3Ò3ÉèyÀÿÿƒÈÿëm‹Ëèõ%K‹÷öD0tE‹ÄI‹Õ‹ËèÔ÷ÿÿ‹øëèÁÿÿÇ è0Áÿÿ‰8ƒÏÿ‹Ëèd&‹Çë)èÁÿÿ‰8èôÀÿÿÇ H‰|$ E3ÉE3À3Ò3Éè ÀÿÿƒÈÿH‹\$hH‹t$pHƒÄ0A_A^A]A\_ÃÌÌÌH‰\$‰L$VWATHƒì0HcùƒÿþuèžÀÿÿÇ ƒÈÿéمɈ®;=‚ă¢H‹ßH‹÷HÁþL%ƒÄƒãHkÛXI‹ô¾Lƒáu%èQÀÿÿÇ Hƒd$ E3ÉE3À3Ò3Éèf¿ÿÿƒÈÿëz‹Ïèâ$I‹ôöDt+‹ÏèK$H‹Èÿ~r…Àu ÿtq‹Øë3Û…ÛtèÀÿÿ‰èî¿ÿÿÇ ƒËÿ‹Ïè>%‹Ãë#èÕ¿ÿÿÇ Hƒd$ E3ÉE3À3Ò3Éèê¾ÿÿƒÈÿH‹\$`HƒÄ0A\_^ÃÌH‰\$WHƒìPH‹ÚH‹ùH…Éu$莿ÿÿHƒd$ E3ÉE3À3Ò3ÉÇ裾ÿÿ3ÀëvH…Òt×H;ÊsòHL$0I‹ÐèP£ÿÿL‹\$8Aƒ{u€|$HHCÿtHH‹L$@ƒ¡Èýë:HSÿHÿÊH;úw ¶BöDuíH‹ËH+ʃáH+Ù€|$Ht H‹L$@ƒ¡ÈýHCÿH‹\$`HƒÄP_ÃÌÌE3Àé<ÿÿÿH‰\$H‰l$H‰t$WATAUHƒìPE3íI‹ùI‹ðH‹êH‹ÙM;ÍuI;ÍuI;Õu 3Àë>I;ÍtI;ÕvM;ÍuDˆ)ëèM;Åu?Dˆ)艾ÿÿ»E3ÉE3À3Ò3ɉL‰l$ èž½ÿÿ‹ÃL\$PI‹[ I‹k(I‹s0I‹ãA]A\_ÃH‹”$HL$0è8¢ÿÿL‹\$8H‹ÕH‹ËE9ku L‹ÏL‹ÆèXD8l$Ht±H‹L$@ƒ¡Èýë£HƒÿÿuŠHÿƈHÿÁA:Åt.Hƒêuëë&ŠHÿƈHÿÁA:Åt HƒêtHƒïuåI;ýuDˆ)HÿÁI;Õ…D8.tHƒÿuYLaÿI‹ôL;ãr¶HT$0è³ÇÿÿA;ÅtHÿÎH;ósæA‹Ä+ƨt*Eˆ,$耽ÿÿº*‰D8l$Ht H‹L$@ƒ¡Èý‹ÂéóþÿÿHƒÿÿu\HƒývOHt+þH‹þH;ór¶HT$0èMÇÿÿA;ÅtHÿÏH;ûsæ‹Æ+Ǩt Dˆ.D8l$Ht H‹D$@ƒ Èý¸Pé˜þÿÿDˆl+ÿëÜDˆ+èõ¼ÿÿ»"E3ÉE3À3Ò3ɉL‰l$ è ¼ÿÿD8l$H„aþÿÿH‹L$@ƒ¡ÈýéPþÿÿH‹ÁH+ÃHƒø|YHqþH‹þH;ór¶HT$0è­ÆÿÿA;ÅtHÿÏH;ûsæ‹Æ+Ǩt+Dˆ.è|¼ÿÿº*‰D8l$H„ÿÿÿH‹D$@ƒ ÈýéóþÿÿD8l$H„ ýÿÿH‹D$@ƒ ÈýéýÿÿÌ@UATAUAVAWHƒì`Hl$@H‰]PH‰uXH‰}`H‹n H3ÅH‰ED‹¿¾3ÿM‹ÙL‰MD‰ED‹ò‰UH‹ÙDnÿD;×uOLaxE‹Íº3ɉ|$(H‰|$ ÿLn;Çt E‹ÕD‰-²¾ëÿmD‹£¾ƒøxDDÖD‰•¾L‹]D‹MpD;Ï~5A‹ÉI‹ÃA+Í@88t IÅ;ÏuñƒÉÿA‹Á+ÁA+ÅA;Á} DHD‰MpëD‹È‰EpD;Ö„\D;ׄSE;Õ…€D‹¥ˆ‹÷D;çuH‹D‹`÷M‹ÃA‹ÌÒ‰|$(H‰|$ ƒâAÕÿ„mLcøD;ÿ„<H»ðÿÿÿÿÿÿA¾ÝÝA½~[3ÒHBàI÷÷HƒørLKL?I;Íw.HAH;ÁwH‹ÃHƒàðèZ\H+àH|$@H…ÿ„åÇÌÌëèîÿÿH‹øH…ÀtD‰0HƒÇH…ÿ„ÀD‹MpL‹EºA‹ÌD‰|$(H‰|$ ÿÜl3É;Á„K‹U‰L$(H‰L$ ‹ME‹ÏL‹Çÿ¿lE3ÀHcðA;ð„!D‹UAºâ s;‹…€A;À„;ðÿ‹M‰D$(H‹ExE‹ÏL‹ÇA‹ÒH‰D$ ÿoléÛA;ð~`3ÒHBàH÷öHƒørQHL6I;Íw*HAH;ÁwH‹ÃHƒàðèW[H+àH\$@I;ØtÇÌÌëèíÿÿE3ÀH‹ØI;ÀtD‰0HƒÃD‹UëI‹ØI;Øtn‹ME‹ÏL‹ÇA‹Ò‰t$(H‰\$ ÿâk3É;Át?‹…€3ÒH‰L$8D‹ÎL‹ÃH‰L$0;Áu ‰L$(H‰L$ ë ‰D$(H‹ExH‰D$ A‹Ìÿ/k‹ðHKðD91uè»ÿÿHOðD91uè»ÿÿ‹ÆéÍH‹÷L‹çD;÷u H‹D‹pD‰u‹½ˆ…ÿuH‹‹xA‹Îèh D‹èƒøÿu3ÀéL‹}xL‹E;Ç„<3ÛLMp‹Ð‹Ï‰\$(H‰\$ è… H‹ðH;ÃtÉD‹Mp‹UL‹ÀA‹Î‰\$(H‰\$ ÿájLcÈD‰MD;Ëu‹ûéD;ËA¾ÝÝ~bI‹ÉIƒùàwYHƒÁHùw4HYH;Ùw H»ðÿÿÿÿÿÿHƒãðH‹Ãè¾YH+ãH\$@H…Ût%ÇÌÌëè€ëÿÿH‹ØH…ÀtD‰0HƒÃD‹MH…Ûu3ÛëƒMcÁ3ÒH‹ËèK•ÿÿD‹]D‹Mp‹U‹MD‰\$(L‹ÆH‰\$ ÿ*j‰E…Àu3ÿë.‹…€LML‹Ã‰D$(‹×A‹ÍL‰|$ è‹}L‹à3ÀL;àDøHKðD91u(èó¹ÿÿë!‹…€D‹Mp‹U‰D$(A‹ÎL‰|$ ÿÂi‹ø3ÛH;ótH‹ÎèÁ¹ÿÿL;ãt M;ütI‹Ì诹ÿÿ‹ÇH‹MH3ÍèñšÿÿH‹]PH‹uXH‹}`He A_A^A]A\]ÃÌÌÌH‰\$H‰t$WHƒìp‹òH‹ÑHL$PI‹ÙA‹øèКÿÿ‹„$¸D‹œ$ÀHL$PD‰\$@‰D$8‹„$°‰D$0H‹„$¨L‹ËH‰D$(‹„$ D‹Ç‹Ö‰D$ èOúÿÿ€|$ht H‹L$`ƒ¡ÈýL\$pI‹[I‹sI‹ã_ÃÌÌD‰L$ UATAUAVAWHƒì@Hl$0H‰]@H‰uHH‰}PH‹’šH3ÅH‰ED‹ ,¹¿3ÛM‹ðD‹úL‹éwD;Ëu=LMHrD‹Ç‹Ïÿ–h;Ãt‰=ô¸ë6ÿ\gD‹ 布øxDDÎD‰ ׸D;΄&D;Ë„D;Ï…C‹uh;óuI‹E‹p÷]xD‹MXM‹ÆҋΉ\$(ƒâH‰\$ ×ÿ hLcàD;ã„A½ÝÝ~hH¸ðÿÿÿÿÿÿL;àwYKL$Hùw5HAH;Áw H¸ðÿÿÿÿÿÿHƒàðèçVH+àH|$0H;û„µÇÌÌëè¥èÿÿH‹øH;Ãt D‰(HƒÇëH‹ûH;û„‹M‹Ä3ÒH‹ÏMÀèl’ÿÿD‹MXM‹Æº‹ÎD‰d$(H‰|$ ÿVg;ÃtL‹M`D‹ÀH‹×A‹ÏÿWg‹ØHOðD9)uè7·ÿÿ‹ÃéˆD‹epH‹ûD;ãuI‹ED‹`‹uh;óuI‹E‹pA‹Ìè"ƒøÿu3ÀëU;Æt$LMXM‹Æ‹Ð‹Î‰\$(H‰\$ èPH‹øH;Ãt×L‹ðH‹E`D‹MXM‹ÆA‹×A‹ÌH‰D$ ÿÁf‹ðH;ûtH‹Ï誶ÿÿ‹ÆH‹MH3Íèì—ÿÿH‹]@H‹uHH‹}PHeA_A^A]A\]ÃÌÌH‰\$H‰t$WHƒì`‹òH‹ÑHL$@A‹ÙI‹øèÌ—ÿÿ‹„$ D‹œ$¨HL$@D‰\$8‰D$0‹„$˜‰D$(H‹„$D‹ËL‹Ç‹ÖH‰D$ è.ýÿÿ€|$Xt H‹L$Pƒ¡ÈýH‹\$pH‹t$xHƒÄ`_ÃÌÌÌÌÌÌÌÌÌÌÌÌÌff„L‹ÙH+Ñ‚žIƒøraöÁt6öÁt Š IÿȈHÿÁöÁtf‹ Iƒèf‰HƒÁöÁt ‹ Iƒè‰HƒÁM‹ÈIÁéuQM‹ÈIÁétH‹ H‰HƒÁIÿÉuðIƒàM…ÀuI‹ÃÃ@Š ˆHÿÁIÿÈuóI‹ÃÃfffffff„fffffIù sBH‹ L‹T HƒÁ H‰AàL‰QèH‹D ðL‹T øIÿÉH‰AðL‰QøuÔIƒàéqÿÿÿfff„fHúrµ¸  D @HÁ€ÿÈuìHé¸@L‹ L‹T Là LÃQL‹L L‹T LÃILÃQL‹L L‹T (HƒÁ@LÃIàLÃQèL‹L ðL‹T øÿÈLÃIðLÃQøuªIèIøƒqÿÿÿð€ $é¹þÿÿffff„fffffffIÈIƒøraöÁt6öÁt HÿÉŠ IÿȈöÁtHƒéf‹ Iƒèf‰öÁt Hƒé‹ Iƒè‰M‹ÈIÁéuPM‹ÈIÁétHƒéH‹ IÿÉH‰uðIƒàM…ÀuI‹ÃÃHÿÉŠ IÿȈuóI‹ÃÃfffffff„fffffIù sBH‹D øL‹T ðHƒé H‰AL‰QH‹D L‹ IÿÉH‰AL‰uÕIƒàésÿÿÿffff„fHúðÿÿwµ¸ Hé€ D @ÿÈuìHÁ¸@L‹L øL‹T ðLÃIøLÃQðL‹L èL‹T àLÃIèLÃQàL‹L ØL‹T ÐHƒé@LÃILÃQL‹L L‹ ÿÈLÃILÃuªIèIøƒqÿÿÿð€ $éºþÿÿH…É„àSHƒì H‹ÙH‹Iè’²ÿÿH‹K色ÿÿH‹K耲ÿÿH‹K èw²ÿÿH‹K(èn²ÿÿH‹K0èe²ÿÿH‹ è]²ÿÿH‹K@èT²ÿÿH‹KHèK²ÿÿH‹KPèB²ÿÿH‹KXè9²ÿÿH‹K`è0²ÿÿH‹Khè'²ÿÿH‹K8è²ÿÿH‹Kpè²ÿÿH‹Kxè ²ÿÿH‹‹€è²ÿÿH‹‹ˆèô±ÿÿH‹‹èè±ÿÿH‹‹˜èܱÿÿH‹‹ èбÿÿH‹‹¨èıÿÿH‹‹°è¸±ÿÿH‹‹¸è¬±ÿÿH‹‹Àè ±ÿÿH‹‹Èè”±ÿÿH‹‹Ð舱ÿÿH‹‹Øè|±ÿÿH‹‹àèp±ÿÿH‹‹èèd±ÿÿH‹‹ðèX±ÿÿH‹‹øèL±ÿÿH‹‹è@±ÿÿH‹‹è4±ÿÿH‹‹è(±ÿÿH‹‹è±ÿÿH‹‹ è±ÿÿH‹‹(è±ÿÿH‹‹0èø°ÿÿH‹‹8èì°ÿÿH‹‹@èà°ÿÿH‹‹HèÔ°ÿÿH‹‹PèȰÿÿHƒÄ [ÃÌÌH…ÉtBSHƒì H‹ÙH‹ H; ¡t袰ÿÿH‹KH; ÿ tè°ÿÿH‹KH; õ tè~°ÿÿHƒÄ [ÃH…É„‹SHƒì H‹ÙH‹IH; Ô tèU°ÿÿH‹K H; Ê tèC°ÿÿH‹K(H; À tè1°ÿÿH‹K0H; ¶ tè°ÿÿH‹K8H; ¬ tè °ÿÿH‹K@H; ¢ tèû¯ÿÿH‹KHH; ˜ tèé¯ÿÿHƒÄ [ÃÌÌÌ@SHƒì0L‹ÉH…Ét H…ÒtM…Àu,Dˆè8­ÿÿ»Hƒd$ E3ÉE3À3Ò3ɉèL¬ÿÿ‹ÃHƒÄ0[À9t HÿÁHƒêuòH…ÒuAˆë¿AŠIÿÀˆHÿÁ„ÀtHƒêuëH…ÒuAˆèÚ¬ÿÿ»"ë 3ÀëµÌÌÌ@SHƒì0M‹ØM…ÉuH…ÉuH…Òu 3Àë?H…ÉtH…ÒtM…ÉuDˆ ëèM…Àu,Dˆè¬ÿÿ»Hƒd$ E3ÉE3À3Ò3ɉ裫ÿÿ‹ÃHƒÄ0[ÃL‹ÑL‹ÂIƒùÿuAŠIÿÃAˆIÿ„Àt,Iƒèuêë$AŠIÿÃAˆIÿ„Àt IƒètIƒéuäM…ÉuEˆ M…À…fÿÿÿIƒùÿu DˆDÿA@Pë˜Æè¬ÿÿ»"émÿÿÿÌÌÌ@SHƒì0H…Ét H…ÒtM…Àu,Dˆè׫ÿÿ»Hƒd$ E3ÉE3À3Ò3ɉèëªÿÿ‹ÃHƒÄ0[ÃL‹ÉAŠIÿÀAˆIÿÁ„ÀtHƒêuêH…Òuˆ莫ÿÿ»"ëµ3ÀëÊÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌff„H+ÑL‹ÊöÁtŠBŠ :ÂuVHÿÁ„ÀtWH÷ÁuæI»J fâÿfúøwËH‹J‹ H;Âu¿Iºÿþþþþþþ~LÒHƒðÿHƒÁI3ÂI…ÃtÇëHÀHƒØÿÃ3ÀÃfff„Òt'„öt#HÁê„Òt„ötHÁê„Òt„öt Áê„Òt„öu‹3ÀÃHÀHƒØÿÃÌÌÌÌÌÌff„H+ÑIƒør"öÁtfŠ: u,HÿÁIÿÈöÁuîM‹ÈIÁéuM…ÀtŠ: u HÿÁIÿÈuñH3ÀÃÀƒØÿÃIÁét7H‹H; u[H‹AH;D uLH‹AH;D u=H‹AH;D u.HƒÁ IÿÉuÍIƒàM‹ÈIÁét›H‹H; uHƒÁIÿÉuîIƒàëƒHƒÁHƒÁHƒÁH‹ HÈHÉH;ÁÀƒØÿÃÌH‰\$WHƒì HcÙA‹øH‰T$8‹Ëèø Hƒøÿu蹩ÿÿÇ HƒÈÿëW‹T$8LD$H‹ I©H;Ït2è˽ÿÿH…Àt(ÿÐH‹ØH…ÀtH‹ 1©H;Ït諽ÿÿH…ÀtH‹ËÿÐH‹ØH‹ ©è’½ÿÿH…ÀtD‹ÍM‹ÅI‹ÖH‹ËÿÐë3ÀH‹\$pH‹l$xHƒÄ@A^A]A\_^ÃHƒì8…Éx ƒù~ ƒùu‹ø›ë1‹𛉠ê›ë#蛥ÿÿHƒd$ E3ÉE3À3Ò3ÉÇè°¤ÿÿƒÈÿHƒÄ8ÃHƒì8H…Éu&èj¥ÿÿHƒd$ E3ÉE3À3Ò3ÉÇè¤ÿÿHƒÈÿëL‹ÁH‹ '¨3ÒÿçWHƒÄ8ÃÌ̹é¶‹ÿÿÌÌHì¨ön˜t ¹ èŠÂÿÿèõÉÿÿH…Àt ¹èòÉÿÿöG˜t_HŒ$ÐÿGVHL$03ÒA¸˜èE‚ÿÿH‹„$¨3ÉH‰D$@HD$0ÇD$0@H‰D$ H„$ÐH‰D$(ÿáUHL$ ÿÎU¹èhŽÿÿÌÌÌÌH‹ÄH‰XH‰hH‰pH‰x ATAUAVHƒìPL‹òH‹ÑHHÈE‹áM‹èèFˆÿÿM…ítM‰uM…öu*è;¤ÿÿHƒd$ E3ÉE3À3Ò3ÉÇèP£ÿÿ€|$HééE…ät Aƒü|ËAƒü$ÅAŠ.L‹D$03ÿI^Aƒ¸ ~LD$0@¶Íºè¾¾ÿÿL‹D$0ëI‹€@@¶Í·Hƒà…Àt@Š+HÿÃ뾋´$@€ý-uƒÎë@€ý+u@Š+HÿÃE…äˆSAƒü„IAƒü$?E…äu(@€ý0tA¼ ë8€;xt €;XtA¼ë&A¼ë Aƒüu@€ý0u€;xt€;Xu@ŠkHƒÃM‹@3ÒƒÈÿA÷ôD‹È@¶ÍE·JAöÀt @¾Íƒé0ëA÷Àt,EŸ@¾Í<wƒé ƒÁÉA;ÌsƒÎA;ùr"u;ÊvƒÎM…íuHÿË@öÆuM…íIEÞ3ÿëYA¯üù@Š+HÿÃ둽ÿÿÿ@öÆu@öÆu:‹Æƒàtÿ€w…Àu';ýv#è¢ÿÿÇ"@öÆtƒÏÿë @ŠÆ$öØÿ÷ßýM…ítI‰]@öÆt÷߀|$Ht H‹L$@ƒ¡Èý‹ÇëM…ítM‰u@8|$Ht H‹D$@ƒ Èý3ÀL\$PI‹[ I‹k(I‹s0I‹{8I‹ãA^A]A\ÃÌÌHƒì83ÀE‹ÈL‹Â‰D$ H‹Ñ9 u H 2‘ë3ÉèQýÿÿHƒÄ8ÃH‰\$WHƒì Hcù‹ÏèìHƒøÿtYH‹Ã¥¹ƒÿu @„¸¸u ;ùuö@`tè½¹H‹Øè°H;Ãt‹Ïè¤H‹ÈÿT…Àu ÿÍR‹Øë3Û‹ÏèØL‹ßH‹ÏHÁùAƒãHS¥H‹ ÊMkÛXBÆD…Ût ‹Ëèb¡ÿÿƒÈÿë3ÀH‹\$0HƒÄ _ÃH‰\$H‰t$ ‰L$WATAUHƒì0HcÙƒûþuè ¡ÿÿ3ÿ‰8èã ÿÿÇ ƒÈÿéÉ3ÿ;ߌ–;ŤƒŠH‹óL‹ãIÁüL-ƤƒæHköXK‹Då¾L0ƒáu+è³ ÿÿ‰8茠ÿÿÇ H‰|$ E3ÉE3À3Ò3É袟ÿÿƒÈÿëa‹ËèK‹DåöD0t ‹Ëè†þÿÿ‹øëèI ÿÿÇ ƒÏÿ‹Ë虋Çë)èP ÿÿ‰8è) ÿÿÇ H‰|$ E3ÉE3À3Ò3Éè?ŸÿÿƒÈÿH‹\$`H‹t$hHƒÄ0A]A\_Ã@SHƒì öAƒH‹Ùt"öAtH‹Ièb¢ÿÿc÷ûÿÿ3ÀH‰H‰C‰CHƒÄ [ÃÌHƒìhH‹ „H3ÄH‰D$Pƒ=“f‰L$@tfH‹ È“Hƒùþu èÑ H‹ ¶“Hƒùÿ„¹Hƒd$ LL$DHT$@A¸ÿ0R…À…‰ƒ=­’…ˆÿµPƒøxu}ƒ%•’ÿûQHƒd$8Hƒd$0‹ÈHD$HLD$@A¹3ÒÇD$(H‰D$ ÿQH‹ )“Hƒùÿt0Hƒd$ LL$DHT$HD‹ÀÿšQ…Àtf‹D$@ëÇ!’ëí¸ÿÿH‹L$PH3Ì艂ÿÿHƒÄhÃH‰\$H‰l$H‰t$WHƒìP3íI‹ðH‹úH‹ÙH;ÕtL;Åt @8*uH;Ítf‰)3ÀH‹\$`H‹l$hH‹t$pHƒÄP_ÃHL$0I‹ÑèJ‚ÿÿL‹\$0A9ku%H;Ýt¶f‰@8l$Ht H‹D$@ƒ Èý¸ë®¶HT$0èÎÿÿ;Å„œH‹L$0D‹‰ Aƒù~0A;ñ|+‹I‹ÅH;Ý•ÀL‹Çº ‰D$(H‰\$ ÿTPH‹L$0;ÅuHc H;ðr(@8ot"‹ @8l$H„4ÿÿÿH‹L$@ƒ¡Èýé#ÿÿÿè’ÿÿÇ*@8l$Ht H‹D$@ƒ ÈýƒÈÿéýþÿÿ‹ÅA¹H;Ý•ÀAQL‹Ç‰D$(H‹D$0H‰\$ ‹HÿÅO;Å…ÿÿÿë¤ÌÌÌE3Éé„þÿÿÌÌÌÌÌÌÌÌH‰\$H‰l$H‰t$WHƒì H‹Ú…Éxi; ¡saHcùH-¡H‹÷ƒçHÁþHkÿXH‹DõHƒ<ÿu=ƒ=Ju'…Étƒét ƒùu¹ôÿÿÿë ¹õÿÿÿë¹öÿÿÿÿ‰OH‹DõH‰3Àë蟜ÿÿÇ è´œÿÿƒ ƒÈÿH‹\$0H‹l$8H‹t$@HƒÄ _ÃÌH‰\$H‰l$WHƒì …Éxs; _ skHcÙH-k H‹ûƒãHÁÿHkÛXH‹DýöDtGHƒ<ÿt@ƒ=›€u)…Étƒét ƒùu¹ôÿÿÿë ¹õÿÿÿë¹öÿÿÿ3ÒÿØNH‹DýHƒ ÿ3Àëèí›ÿÿÇ èœÿÿƒ ƒÈÿH‹\$0H‹l$8HƒÄ _ÃHƒì8ƒùþuèÞ›ÿÿƒ è¶›ÿÿÇ ë]…Éx1; ¤Ÿs)HcÑH °ŸH‹ÂƒâHÁøHkÒXH‹ÁöDtH‹ë,è”›ÿÿƒ èl›ÿÿHƒd$ E3ÉE3À3Ò3ÉÇ èšÿÿHƒÈÿHƒÄ8ÃH‹ÄH‰XH‰pH‰xL‰` AUHƒì HcÙL‹ãIÁüL-6ŸƒãHkÛXK‹t心|3 u3O èJ¢ÿÿƒ|3 uHL3º èoÂÿÿ÷ØÒ#úÿD3 ¹ è¡ÿÿ…ÿtK‹LåHLÿ‡K‹ÇH‹\$0H‹t$8H‹|$@L‹d$HHƒÄ A]ÃÌÌHcÑH ®žH‹ÂƒâHÁøHkÒXH‹ÁHLHÿ%HKH‰\$H‰|$L‰d$AUAVAWHƒì@IƒÌÿE‹ìE3öAL$ 诠ÿÿ…ÀuA‹Äéɹ è¡ÿÿ3ÿ‰|$$H?žƒÿ@›LcÿJ‹øH…Û„H‰\$0J‹øH H;؃ÍöC…ªƒ{ u;¹ è(¡ÿÿƒ{ u HKº èOÁÿÿ…Àu DpD‰t$(ëÿC ¹ è÷ŸÿÿE…öu HKÿdJöCt HKÿ\JëHIƒÌÿE…öu?ÆCL‰#L‹K+øH¸£‹.ºè¢‹.H÷ëL‹êIÁýI‹ÅHÁè?Lè‹ÇÁàDèD‰l$ ëHƒÃXH‰\$0IƒÌÿHFé ÿÿÿE;ì…ÿlj|$$H+éçþÿÿºXJÈèõ™ÿÿH‰D$0H…ÀttHc×LI‰Ѓ✠I‹ ÐHÁ H;ÁsÆ@L‰ Æ@ ƒ` HƒÀXH‰D$0ëÖÁç‰|$ HcÏH‹ÁHÁøƒáHkÉXI‹ÀÆD‹ÏèHýÿÿ…ÀADüD‹ï‰|$ ¹ èÅžÿÿA‹ÅH‹\$`H‹|$hL‹d$pHƒÄ@A_A^A]ÃHƒì8H‹©|H3ÄH‰D$(LD$ A¹ºÆD$&ÿÎJ…ÀuƒÈÿë HL$ è›H‹L$(H3Ìèæ{ÿÿHƒÄ8ÃÌ@USVWATAUAVAWHìˆHl$@H‹@|H3ÅH‰E0L‹µ°E‹!3ÿI‹ØH‹÷‰}L‰MD‹êD‹ùH‰];Ê„HUÿ4I;Ç„Ÿƒ}…•HUA‹ÍÿI;Ç„€ƒ}uzÇEAƒüÿt`A‹ü…ÿŽ©HcÏH¸ðÿÿÿÿÿÿH;ȇ“HL HùwlHAH;Áw H¸ðÿÿÿÿÿÿHƒàðèÏ8H+àH\$@H…Ût<ÇÌÌëNH‹Ëè¢Çÿÿxë–E‹ÌL‹ÃºA‹Ï‰|$(H‰|$ ÿhI‹ø…À…oÿÿÿ3Àé7èVÊÿÿH‹ØH…ÀtÇÝÝHƒÃë3ÛH…ÛtÙLcÇ3ÒH‹ËMÀètÿÿL‹EE‹ÌºA‹Ï‰|$(H‰\$ ÿ IE3ÿA;Ç„ÉM;÷t;‹…¸L‰|$8L‰|$0‰D$(D‹ÏL‹Ã3ÒA‹ÍL‰t$ ÿfHA;Ç„‘I‹öé‰D9}u,L‰|$8L‰|$0D‹ÏL‹Ã3ÒA‹ÍD‰|$(L‰|$ ÿ*H‹øA;ÇtWHc×¹èò–ÿÿH‹ðI;ÇtBL‰|$8L‰|$0D‹ÏL‹Ã3ÒA‹Í‰|$(H‰D$ ÿêGA;Çu H‹ÎèM˜ÿÿI‹÷ë AƒüÿtH‹M‰HKð9ÝÝuè+˜ÿÿH‹ÆH‹M0H3ÍèlyÿÿHeHA_A^A]A\_^[]ÃÌÌÌ3ÒDB éyóÿÿÌL‹ÑM…Àt‹W‘A»ƒøxADÓD‹U‰@‘D‹ D;Ë~YA‹ÉI‹ÇA+̃Îÿ8t IÄ;Ëuï‹Î‹Æ+ÁDÈD‰ D‹…°D;Ã~5A‹ÈH‹ÇA+Ì8t IÄ;Ëuò‹Î‹Æ+ÁDÀD‰…°ëƒÎÿD;Î}Æ3Àé¥D;Æ|ôA;Ó„¯;Ó„§A;ÔuÞD‹­¸D;ëuI‹D‹iD;Ët D;Ã…«E;ÈuA‹Ãé\E;Ä~A‹ÄéOE;Ì~ ¸é@HUA‹Íÿî=;ÃtƒD‹ D;Ë~2ƒ}rÓ8]HEtÊ8XtÅAŠ:r:HvHƒÀ8ëå¸éñ9°~+ƒ}rŒ8]HEtƒ8X„zÿÿÿŠ:r:HvËHƒÀ8ëâM‹Çº A‹Í‰\$(H‰\$ ÿW>LcðD;ó„ìþÿÿI¸ðÿÿÿÿÿÿ~d3ÒHBàI÷öHƒørUKL6Hùw.HAH;ÁwI‹ÀHƒàðè5-H+àHt$0H;ó„þÿÿÇÌÌëèó¾ÿÿH‹ðH;ÃtÇÝÝHƒÆëH‹óH;ó„pþÿÿD‹ M‹ÇA‹ÔA‹ÍD‰t$(H‰t$ ÿ¯=;ÄôD‹°L‹Çº A‹Í‰\$(H‰\$ ÿ†=LcàD;ã„Ç~g3ÒHBàI÷ôHƒørXKL$Hùw1HAH;Áw H¸ðÿÿÿÿÿÿHƒàðèg,H+àH|$0H;ûtÇÌÌëè)¾ÿÿH‹øH;ÃtÇÝÝHƒÇëH‹ûH;ûtVD‹°L‹EºA‹ÍD‰d$(H‰|$ ÿæ<;Ãt‹U‹ME‹ÎL‹ÆD‰d$(H‰|$ ÿ6=‹ØHOð9ÝÝu軌ÿÿHNð9ÝÝu誌ÿÿ‹ÃéèH‹ûL‹ëD;Óu I‹D‹PD‰UD‹¥¸D;ãuI‹D‹`A‹ÊèŽñÿÿD‹ð;Æ„ýÿÿA;ÄteL M‹Ç‹ÐA‹Ì‰\$(H‰\$ èµñÿÿH‹øH;ÄÒüÿÿL‹EL°A‹ÖA‹Ì‰\$(H‰\$ èŠñÿÿL‹èH;Ãu H‹Ïè ŒÿÿéžüÿÿL‹ÿL‹ÀëL‹E‹…°D‹ ‹U‹M‰D$(L‰D$ M‹Çÿ4<‹ðH;ûtH‹ÏèÅ‹ÿÿI‹Í轋ÿÿ‹ÆH‹M(H3ÍèÿlÿÿHe8A_A^A]A\_^[]ÃÌÌH‰\$H‰t$WHƒì`‹òH‹ÑHL$@I‹ÙA‹øèèlÿÿD‹œ$¨‹„$ HL$@D‰\$8‰D$0H‹„$˜H‰D$(‹„$L‹ËD‹Ç‹Ö‰D$ è¾úÿÿ€|$Xt H‹L$Pƒ¡ÈýH‹\$pH‹t$xHƒÄ`_ÃÌÌÌH‰\$H‰t$WHƒì`H‹ñH‹úHL$@I‹ÑI‹Øè[lÿÿH…Ûu8\$Xt H‹D$Pƒ Èý3ÀéÂH…öu=è;ˆÿÿHƒd$ E3ÉE3À3Ò3ÉÇèP‡ÿÿ€|$Xt H‹D$Pƒ Èý¸ÿÿÿé€H…ÿt¾HûÿÿÿwµH‹D$@‹P…ÒuLL$@L‹ÃH‹×H‹Îèªòÿÿë>‹@HL$@L‹Î‰D$8‰\$0A¸H‰|$(‰\$ è™þÿÿ…Àu複ÿÿÇéyÿÿÿƒÀþ€|$Xt H‹L$Pƒ¡ÈýH‹\$pH‹t$xHƒÄ`_ÃÌÌÌH‰\$‰T$UVWATAUAVAWHƒì0E3í‹êL‹ñA‹ÝI;Íu$èC‡ÿÿE3ÉE3À3Ò3ÉL‰l$ ÇèY†ÿÿéêL‹!M;å„Óº=I‹Ìè³H‹øH‰D$pI;Å„µL;à„¬D8hH‹5Þ|E‹ýA”ÇH;5Ø|upH‹îA‹ÅI;õu I‹õëUHƒÆÿÀL9.uõÿÀºHcÈè ‡ÿÿH‹øH‹ðI;Åu¹ è'mÿÿëH‹ÈèÍH‰HƒÇHƒÅH‹EI;ÅuäL‰/H‹|$p‹l$xH‰5^|I;õ…‰A;ít9L9-Y|t0èf÷ÿÿA;Åtjè@†ÿÿǃÈÿH‹œ$€HƒÄ0A_A^A]A\_^]ÃE;ýt3Àëß¹蔆ÿÿH‰ý{I;ÅtÆL‰(L9-þ{u¹èr†ÿÿH‰ë{I;Åt¤L‰(H‹5Ì{H‹îI;õt’H‹‹ÇH‹þA+ÄLcèH…Ét?H‹ÑM‹ÅI‹Ìè¿öÿÿ…ÀuH‹A€|=„¢A8\„—HƒÇH‹H…ÉuÈH‹5r{H+þHÁÿ÷ßE3íA;ýŒŒL9m„‚Hc÷H‹LõèÖ‡ÿÿE;ýtfL9lõtHLõH‹ÿÇHƒÁH‰DõHÿÆL9lõuèHc×H¸ÿÿÿÿÿÿÿH;Ѓ“H‹ {A¸èý†ÿÿI;Åt|ësH‹5çzH+þHÁÿérÿÿÿL‰dõM‰.ë]E;ý…A;ý}÷ßG;ÇŒ„þÿÿLcÀH¸ÿÿÿÿÿÿÿL;ÀƒnþÿÿºH‹Î蛆ÿÿI;Å„XþÿÿHcÏL‰$ÈL‰lÈM‰.H‰tzD9l$x„ŠI‹ÌèµÿÿºHHèO…ÿÿH‹øI;ÅtlI‹Ìèã´ÿÿM‹ÄH‹ÏHPèHØÿÿA;ÅtE3ÉE3À3Ò3ÉL‰l$ è+‚ÿÿH‹×H‹ÏI+ÔHT$pDˆ*HÿÂE;ýIEÕÿú6A;ÅuƒËÿèõƒÿÿÇ*H‹Ïèo†ÿÿE;ýt I‹Ìèb†ÿÿM‰.‹Ãé™ýÿÿI‹ÌèP†ÿÿM‰.é¦ýÿÿH‰\$H‰t$WHƒì0H‹ÙH…ÉtFè<´ÿÿH‹ðHHè·ÿÿH‹øH…Àt-HVL‹ÃH‹Èè×ÿÿ…ÀtHƒd$ E3ÉE3À3Ò3ÉèpÿÿH‹Çë3ÀH‹\$@H‹t$HHƒÄ0_ÃÌH‰\$H‰t$WHƒìPH‹Ù‹úHL$0I‹Ðè'gÿÿ3öH;ÞuDè#ƒÿÿE3ÉE3À3Ò3ÉH‰t$ Çè9‚ÿÿ@8t$Ht H‹D$@ƒ Èý3ÀH‹\$`H‹t$hHƒÄP_ÃH‹T$89ru‹×H‹Ëè€@8t$HtÕH‹L$@ƒ¡ÈýëǶ f;Ît3¶ÁöDtHÿÃ@83t˜¶·ÉÁá È;ùu HCÿë¼·Á;øtHÿÃëÅ·Á;ø…lÿÿÿ@8t$Ht H‹D$@ƒ ÈýH‹ÃéfÿÿÿÌÌE3Àéÿÿÿë:Ât HÿÁŠ„Àuó:ÂuH‹ÁÃ3ÀÃÿ%03ÿ%‚3ÿ%„3Hƒì8H…Éu&è‚ÿÿHƒd$ E3ÉE3À3Ò3ÉÇè+ÿÿHƒÈÿë€9tÕH…ÒtÐH‹H…ÀtÈ€8tÃE3Àè‚HƒÄ8ÃÌH‰T$‰L$SUVWATAUAVAWHƒìXA¼þÿÿÿHcÁA‹ØD‰d$4‰\$8A;Äuè¸ÿÿ3ÿ‰8èÿÿÇ é3ÿ;ÇŒï;t…ƒãH‹ðL‹ðL ùAÿÿIÁþƒæK‹Œñ€CHköXŠD1¨„·ûÿÿÿvèUÿÿ‰8è.ÿÿÇ骋ï;߄Ѝ…‚H;×tÒDŠ|18A¸EÿAÐÿA¾Ïƒétƒéu ‹Ã÷Шt«ƒãþL‹êëd‹Ã÷Шt›ÑëA;ØABØ‹ËèMÿÿL‹èH;Çu踀ÿÿÇ èÍ€ÿÿÇé=‹Œ$ 3ÒDBè°ÖÿÿL !AÿÿL‹ØK‹„ñ€CL‰\0@K‹„ñ€CI‹ÕA¸ öD0H„œŠL0 A:È„;ß„‡AˆMK‹„ñ€CAƒÊÿAÚIUAh÷DˆD0 D:ÿtbK‹„ñ€CŠL09A:ÈtQ;ßtMˆ K‹„ñ€CAÚHÿÂAhøDˆD09A€ÿu.K‹„ñ€CŠL0:A:Èt;ßtˆ K‹„ñ€CHÿÂAhùAÚDˆD0:K‹Œñ€CLL$0D‹ÃH‹ 1H‰|$ ÿ¢2;Ç„ÏHcT$0;׌‹ÃH;Ї·L@ÿÿêK‹„ð€CöD0€„yA€ÿ„¸;×tA€} u€L0ë€d0ûHcÅI‹ÝM‹åIÅH‰D$@L;èƒ:½ AŠ$<„ @:Åt ˆHÿÃIÿÄéëH‹D$@HÿÈL;àsID$€8 u IƒÄéL‹àé½K‹Œð€CLL$0H”$°H‹ 1A¸IÿÄH‰|$ ÿ³1;Çu ÿ0;Çu{9|$0tuL0?ÿÿK‹„ð€CöD0Ht"€¼$° t'@ˆ+K‹Œð€CŠ„$°ˆD1 ëGI;Ýu€¼$° uÆ ë3‹Œ$ A¸HƒÊÿè]Ôÿÿ€¼$° LÆ>ÿÿtëL»>ÿÿ@ˆ+HÿÃL;d$@‚ìþÿÿëK‹„ð€CöD0@u€L0ë AŠ$ˆHÿËëA+íA€ÿ…ð;ï„èA¿I+ßö€uIßé²A‹×ëƒúI;ÝrI+ßA×¶B8¼4tã¶ B¾„4;Çuè}ÿÿÇ*AƒÌÿé‘ÿÀ;ÂuHcÂHØë^K‹„ð€CöD0Ht;I߃úˆL0 |ŠK‹Œð€CI߈D19ƒúuŠK‹Œð€CI߈D1:HcÂH+Øë‹Œ$ ÷ÚE‹ÇHcÒè2Óÿÿ‹D$8L‹¼$¨A+ÝÑèD‹ËM‹Å‰D$(3Ò¹éýL‰|$ ÿe/‹è;ÇuÿI.‹Èè}ÿÿAƒÌÿéäD‹d$4;ÃHS=ÿÿJ‹„ð€C@•Çí‰|0Hé¿;׺ tfA9Uu€L0ë€d0ûHcÅI‹ÝM‹åN<(M;ïƒ{½ A·$fƒø„Ef;Åtf‰HƒÃIƒÄé%IGþL;àsID$f9u IƒÄéÂL‹àéúK‹Œð€CLL$0H”$¸H‹ 1A¸IƒÄH‰|$ ÿ÷.;Çuÿ]-;Ç…®9|$0„¤Ll<ÿÿK‹„ð€CöD0HtFº f9”$¸tKf‰+Š„$¸K‹Œð€CˆD1 Š„$¹K‹Œð€CˆD19K‹„ð€CˆT0:ëWI;Ýuº f9”$¸uf‰ë>‹Œ$ HÇÂþÿÿÿDBèoÑÿÿº LÛ;ÿÿf9”$¸të º LÃ;ÿÿf‰+HƒÃM;ç‚®þÿÿë"K‹„ð€CöD0@u€L0ë A·$f‰HƒÃ‹ëA+íD‹d$4L‹¼$¨M;ïtI‹Íè`}ÿÿAƒüþDDåA‹Äëiÿ5,ƒøuè»zÿÿÇ èÐzÿÿÇéýÿÿƒømuD‹ç뮋ÈèÔzÿÿéýÿÿ3Àë)è¦zÿÿ‰8èzÿÿÇ E3ÉE3À3Ò3ÉH‰|$ è•yÿÿƒÈÿHƒÄXA_A^A]A\_^][ÃÌH‰\$H‰t$‰L$WATAUAVAWHƒì0A‹ðL‹êHcùƒÿþuèBzÿÿ3Û‰èzÿÿÇ ƒÈÿé3Û;ûŒâ;=û}ƒÖL‹çL‹÷IÁþL=ü}AƒäMkäXK‹÷B¾L ƒáu.èèyÿÿ‰èÁyÿÿÇ H‰\$ E3ÉE3À3Ò3Éè×xÿÿƒÈÿé©‹ÃAøÿÿÿ–À;Ãu+èªyÿÿ‰èƒyÿÿÇH‰\$ E3ÉE3À3Ò3Éè™xÿÿƒÈÿën‹ÏèÞÿÿK‹÷BöD tD‹ÆI‹Õ‹Ïès÷ÿÿ‹Øëè:yÿÿÇ èOyÿÿ‰ƒËÿ‹ÏèƒÞÿÿ‹Ãë)è:yÿÿ‰èyÿÿÇ H‰\$ E3ÉE3À3Ò3Éè)xÿÿƒÈÿH‹\$hH‹t$pHƒÄ0A_A^A]A\_ÃÌÌH‹ÄH‰XL‰@H‰HUVWATAUAVAWHì€3ÿA´€A‹ñH‹ÚÇ@¨o‰xœ@ˆ¼$ØH‰x°E„Ìt‰x¸A¶ë‰l$pDŠ÷HL$Tè©;ÇtE3ÉE3À3Ò3ÉH‰|$ èivÿÿºær÷Æ@u |$T€tE ô‹ÎA¸¸ÀA#Ⱥ€;ÏtT+Ít:;Ít1è@xÿÿ‰8ƒ ÿèxÿÿ»E3ÉE3À3Ò3ÉH‰|$ ‰è+wÿÿ‹ÃéûD‹øë@öÆt÷ÆuíA¿@ëD‹ú‹Œ$àA¼ƒét,ƒét#ƒétƒétƒù@u‹D;ú‹Ï”ÁëA‹Èë A‹Ìë‹Íë‹Ï‹Æº‰L$H#ÂtF=t8=t*=t=t*=t&=t;Âté/ÿÿÿA‹ìë½ë ½ëA‹èºæA½€D‰l$PsŠmöÐ"„$言AEDDèD‰l$P@öÆ@tAºíAºïƒÉD‰l$P‰L$Hºæ s AºíD‰l$P@öÆ tAºíë @öÆt AºíD‰l$PèIÜÿÿ‰ƒøÿu!èÕvÿÿ‰8ƒ ÿè«vÿÿÇè vÿÿ‹é H‹„$ÀD‹D$HH‹Œ$ÐH‰|$0LL$`A‹×D‰l$(ljl$ ÿB)H‰D$XHƒøÿ…Œ¹ÀA‹Ç#Á;ÁuC¸@„ðt9D‹D$HH‹Œ$ÐH‰|$0Aº÷LL$`D‰l$(A‹×‰l$ ÿí(H‰D$XHƒøÿu;Hc L-zH‹ÁƒáHÁøHkÉXI‹DÅ€dþÿJ'‹ÈèvÿÿèÎuÿÿ‹8éÌH‹ÈÿÖ&;ÇuMHc L-ÈyH‹ÁƒáHÁøHkÉXI‹DÅ€dþÿ'‹È‹ØèÉuÿÿH‹L$Xÿ6(;ßu§èuuÿÿÇ ëšA;ÄuA€Î@ë ƒøuA€ÎH‹T$X‹ è%ØÿÿHc L-[yH‹ÁƒáºHÁøD òI‹DÅHkÉXDˆtHc H‹ÁƒáHÁøHkÉXI‹DÅ€d8€AŠÆ$HˆD$L…†E„ö‰ÂA„ôtx‹ E‹ÄƒÊÿè¦ ‰D$Dƒøÿuèðtÿÿ8ƒtP‹ èõÒÿÿééþÿÿ‹ HT$@A¸@ˆ|$@èÕòÿÿ;Çu€|$@uHcT$D‹ 较øÿtÁ‹ E3À3ÒèE ƒøÿt°ºE„ö‰<¹@…ñu‹D$T#Áuºîë ð‹Æ#Á=@tJ=t,=@t%=t+=@t$=t=@u(ˆ”$Øë¹‹Æ#Á;ÁuDˆ¤$Øë@ˆ¼$Ø÷Æ„º‰|$DAöÆ@…¬A‹Ç%À=@„$=€t|=À…‡;ï†A;ìvƒýv8ƒý…l¾Œ$ØA¸‹ïA+È„ A;È…PÇD$Dÿþé‹ E‹Ä3ÒèÉÿÿH;ÇtÀ‹ E3À3ÒènÉÿÿHƒøÿ„|þÿÿ‹ HT$DA¸èbñÿÿƒøÿ„aþÿÿA;Ät ƒøuk|$DuD@þDˆ„$ØéÜ·D$D=þÿu‹ è%Ñÿÿèìrÿÿ»‰‹ûéã=ÿþu#‹ E3ÀA‹Ôè’ƒøÿ„ùýÿÿDˆ¤$Øé†‹ E3À3Òèpƒøÿë;;ïvqA;ì†üþÿÿƒý‡êþÿÿ‹ E‹Ä3Òè¡ÈÿÿH;Ç„Þþÿÿ‹ E3À3ÒèŒÈÿÿHƒøÿu8é™ýÿÿÇD$DA¼‹ HcÅE‹ÄHTDD+ÅèN°ÿÿƒøÿ„mýÿÿèD;åÛA¸Hc @Ь$ØH‹Áƒá@€åHÁøHkÉXI‹DÅ€d8€@l8HcH‹ÂƒâHÁøHkÒXI‹Lŋƀd8ÁèÀàD8@8|$Lu!@öÆtHc H‹ÁƒáHÁøHkÉXI‹DÅ€L A‹Ç%À=À…ŸA„ð„–H‹L$Xÿ>$‹D$PD‹D$HH‹Œ$ÐH‰|$0‰D$(Aº÷LL$`ÇD$ A‹×ÿ1$Hƒøÿu6ÿµ"‹Èè~qÿÿLcI‹ÃAƒãHÁøMkÛXI‹DÅB€dþ‹ è¢ÔÿÿéBûÿÿHcH‹ÊƒâHÁùHkÒXI‹LÍH‰ ‹ÇH‹œ$ÈHÄ€A_A^A]A\_^]ÃÌÌH‹Ä‰PL‰@L‰H VWHƒìXƒHØÿƒ`ÜE3ÀH…ÉA•ÀE…Àu(è¬pÿÿÇHƒd$ E3ÉE3À3Ò3ÉèÁoÿÿƒÈÿé“H„$€HƒÀD‹@øƒd$0D‰D$(ÇD$ @D‹ÊL‹ÁHT$@HL$Dèv÷ÿÿ‹ð‰D$Hƒ|$Dt9…Àt(Hc|$@H‹ÏH‹ÇHÁøLCtƒáHkÉXI‹À€dþë‹|$@‹ÏènÕÿÿë‹|$@…öt èÿoÿÿ‰0ƒÈÿë‹ÇHƒÄX_^ÃÌÌÌ@SHƒì0M‹ÐH‹ÂH‹ÙH…Éu&èÓoÿÿHƒd$ E3ÉE3À3Ò3ÉÇèènÿÿHƒÈÿëUH…ÀtÕH‰L$ LL$XLD$@I‹ÒH‹ÈèσøÿtÖL‹L$XL‹D$@H‹Ó¹èçH‹L$@H‹ØèòqÿÿH‹L$XèèqÿÿH‹ÃHƒÄ0[ÃÌÌÌH‰\$L‰D$UVWATAUAVAWHƒì0E3öM‹àL‹êH‹éH‹ñI;Îu(è"oÿÿE3ÉE3À3Ò3ÉL‰t$ Çè8nÿÿHƒÈÿéD81tÓI;ÖtÎH‹I;ÆtÆD80tÁº\èvº/H‹ÍH‹øèfA¿I;Æ…œI;þ… AW9H‹ÍèRìÿÿH‹øI;Æ…ˆH‹Íè.ŸÿÿI‹×HXH‹Ëè{oÿÿH‹ðI;Æ„sÿÿÿLL5H‹ÓH‹ÈèuÂÿÿA;ÆtE3ÉE3À3Ò3ÉL‰t$ èXlÿÿL‹ÅH‹ÓH‹ÎèêÀÿÿA;ÆtE3ÉE3À3Ò3ÉL‰t$ è1lÿÿH~ë I;þtH;ÇvH‹øHƒËÿH‹ÏS/èŸ H‹ÎI;Æt&3Òè A;Æ…÷M‹ÄI‹ÕH‹ÎèõýÿÿH‹ØéáèlžÿÿI‹×L`I‹Ìè¹nÿÿH‹øI;Æ„ÎL‹ÆI‹ÔH‹Èè·ÁÿÿA;ÆtE3ÉE3À3Ò3ÉL‰t$ èškÿÿH‹Îè"žÿÿL4èmÿÿM+æD‹8IZxŒ ºÎÞêö *:JXfp€–¢®¾æ2Hbx† °Æàîþ$4JZl~¢®¼Ìâò"4\hxŠh@?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~=runtime error TLOSS error SING error DOMAIN error R6034 An application has made an attempt to load the C runtime library incorrectly. Please contact the application's support team for more information. R6033 - Attempt to use MSIL code from this assembly during native code initialization This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. R6032 - not enough space for locale information R6031 - Attempt to initialize the CRT more than once. This indicates a bug in your application. R6030 - CRT not initialized R6028 - unable to initialize heap R6027 - not enough space for lowio initialization R6026 - not enough space for stdio initialization R6025 - pure virtual function call R6024 - not enough space for _onexit/atexit table R6019 - unable to open console device R6018 - unexpected heap error R6017 - unexpected multithread lock error R6016 - not enough space for thread data This application has requested the Runtime to terminate it in an unusual way. Please contact the application's support team for more information. R6009 - not enough space for environment R6008 - not enough space for arguments R6002 - floating point support not loaded Microsoft Visual C++ Runtime Library ...Runtime Error! Program: À À–ÀÀŽÀÀÀ‘À’À“À€€†€€†€†‚€EEE………00€P€ˆ('8PW€700PPˆ (€ˆ€€`h`hhhxppwpp ((((( H„„„„„„„„„„‚‚‚‚‚‚ h(((( H„„„„„„„„„„‚‚‚‚‚‚ H€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@abcdefghijklmnopqrstuvwxyz[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ABCDEFGHIJKLMNOPQRSTUVWXYZ{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿHH:mm:ssdddd, MMMM dd, yyyyMM/dd/yyPMAMDecemberNovemberOctoberSeptemberAugustJulyJuneAprilMarchFebruaryJanuaryDecNovOctSepAugJulJunMayAprMarFebJanSaturdayFridayThursdayWednesdayTuesdayMondaySundaySatFriThuWedTueMonSunGetProcessWindowStationGetUserObjectInformationAGetLastActivePopupGetActiveWindowMessageBoxAUSER32.DLLSunMonTueWedThuFriSatJanFebMarAprMayJunJulAugSepOctNovDecCONOUT$.com.exe.bat.cmd.\SystemRoot t d T 42àÐÀ 4 Œp¨P  4 p d T 42ÐÀp!ðÚ<!Ú®(!ÔHÄIÚ®(!ÔHÄIdJÚ®(!TRðÚ< Kðàp0¨0bÀp`0Œ+|I`á 4RðàÐÀ p ` Pr0²02042 p d4rðàÐÀpŒ+ã'ì(xá  4 RpŒ+·*S+šáS+B d T 4 rðàÐÀpt42 À  20dT42p) 4dZðà Ð Àp`P¨È Ä t d 4 ðàÐŒ+`:l:=  ¼0 t dT42À  20d 4R ÀŒ+KBÃB¶á Ä t d RðàÐŒ+DMDÏáÎCjDÿátd42ÀdT42ptd42ÐŒ+OFFâ  4 Rpd T 4Rpd 4 r p  $d´4³° p¨p  4 2pŒ+¾MN4â4r Ð Àp`P¨8 Ä t d 4RÐŒ+-RçR4â20Œ+·VÍVMâ  4 2pŒ+ŠW•WfâªWÑW†â42pŒ+.Y\YfâqY¨Y†âdT² pd T42pÔ t 4Rà t d 42àÐÀŒ+º_{`Ÿâ2P BŒ+çabÀâb BŒ+9b=b=b d4rðàÐ À pŒ+àesfáâ bŒ+ôfgýâg t d T 42àÐÀd 4 R p t d T 4 rÀB  4 2p›b4²p ` Pd 4R p4 R pŒ+÷uvã/ 4qfðà Ð Àp`P¨  d4 RðàÐÀpŒ+,~]~Nã4 R À p `Œ+?ƒ7ã  4 ’p dT4’ÐÀp- Etd4C² ðàÐÀP¨Xd4Ò p1 5#td43rð à ÐÀP¨8d4² p2 0R0 d4 RðàÐÀpŒ+Ö– —Nã T4ràÐÀ p `µ tdT4’àÐÀ  4 2pd 4 RÐÀpŒ+Ÿ(Ÿ7ã¨PT42 p Ä td42ÐŒ+k¤‹¤eã Ät 4 rðàÐŒ+¥³¥~ã4¥å¦žãb¨(' EC ð à ÐÀp`0P¨p‚RPt d 4RÀŒ+ñ¬Ù­·ã  T ÒpdT4²pT 4 r p$ 53 ð à ÐÀp`0P¨X 4RðàÐÀ p ` P ¢ðàÐÀ p ` P 0 d4 RðàÐÀpŒ+ Æ>ÆNã! !4!òðàÐÀp`PrP¢p`Œ+ïÎÏÐã t d T 42ðÐÀd42 p4 ðàÐÀ p P 0#  ð à ÐÀp`P0¨xd 4 ’ pdT 4 ’pNð¨ÄÚð0H`t|Žœ®¼ÎÞìþ*>ZxŒ ºÎÞêö *:JXfp€–¢®¾æ2Hbx† °Æàîþ$4JZl~¢®¼Ìâò"4\hxŠSGenerateConsoleCtrlEventÇGetExitCodeProcessrWaitForSingleObject–CreateProcessA´SetConsoleCtrlHandlerõGetModuleFileNameAÛEnterCriticalSectionîLeaveCriticalSectionúGetModuleHandleW/Sleep"GetProcAddressExitProcessqGetCommandLineAžRtlUnwindExôSetHandleCount>GetStdHandleÙGetFileType<GetStartupInfoAÀDeleteCriticalSection;TerminateProcess«GetCurrentProcessLUnhandledExceptionFilter#SetUnhandledExceptionFilterÐIsDebuggerPresentŸRtlVirtualUnwind˜RtlLookupFunctionEntry‘RtlCaptureContextçGetLastError¦HeapFree¢HeapAlloc]GetCPInfoTGetACPGetOEMCPÚIsValidCodePage×EncodePointer¹DecodePointer@FlsGetValueAFlsSetValue?FlsFreeøSetLastError¯GetCurrentThreadId>FlsAlloc›WriteFileðLoadLibraryAºInitializeCriticalSectionAndSpinCountLFreeEnvironmentStringsAÁGetEnvironmentStringsMFreeEnvironmentStringsWˆWideCharToMultiByteÃGetEnvironmentStringsWªHeapSetInformation¤HeapCreateSQueryPerformanceCounterjGetTickCount¬GetCurrentProcessIdSGetSystemTimeAsFileTime©HeapReAlloc…GetConsoleCP—GetConsoleModeCFlushFileBuffersàLCMapStringAMultiByteToWideCharâLCMapStringW@GetStringTypeACGetStringTypeWéGetLocaleInfoAìSetFilePointer«HeapSizeDCloseHandleWriteConsoleA›GetConsoleOutputCPšWriteConsoleW SetStdHandlezCreateFileASCompareStringAVCompareStringWÝSetEnvironmentVariableAKERNEL32.dllhReadFileÚSetEndOfFile&GetProcessHeapËGetFileAttributesAàE@àE@2¢ß-™+Í] ÒfÔÿÿL)@ô@ðó@ÿÿÿÿÿÿÿÿ€         ! 5A CPR S WY l m pr € ‚ ƒ„ ‘)ž ¡¤ § ·Î×   abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ(@¤`‚y‚!¦ß¡¥Ÿàü@~€ü¨Á£Ú£ þ@þµÁ£Ú£ þAþ¶Ï¢ä¢å¢è¢[þ@~¡þQQÚ^Ú _ÚjÚ2ÓØÞàù1~þôþ@þÿÿÿC@-@@-@@-@@-@@-@P2@ðü@€@@Ð0@P-@P-@(@ÿÿÿÿXú@(ú@ øù@ `ù@(ù@øø@Ðø@ ø@hø@@ø@ø@Ð÷@¨÷@ˆ÷@ ÷@ èö@!ðõ@"Põ@x@õ@y0õ@z õ@üõ@ÿõ@8š@8š@8š@8š@8š@8š@8š@8š@8š@8š@  ðü@òþ@P@L@H@D@@@<@8@0@(@ @@@ô@è@ä@à@Ü@Ø@Ô@Ð@Ì@È@Ä@À@¼@¸@°@ @”@Œ@Ô@„@|@t@h@`@P@@@8@4@(@@@ Ð0@.@2@lB@lB@lB@lB@lB@lB@lB@lB@lB@P2@.€pðñÿÿPSTPDTà2@ 3@ÿÿÿÿÿÿÿÿþÿÿÿÿÿÿÿþÿÿÿÿÿÿÿÿÿÿÿ;Zx—µÔó0Nmÿÿÿÿ:Yw–´Óò/Ml8@0@(@ @çxðY”`«x°Ô à¬í¼ðÚ<Ú®(®e eµôµ½ä½ÛÔè]ThJ¤Ls tÓ¤Ô¤Z \ƒ „ŤD§¤¨Å ÈïP ð•"|˜"&#È`# $¤ $Š$”Œ$%%œø%%&¤(&a&¤d&z&¤”&Ç&¬È&'('³'(´'>)¸x)ß)¤à)w+èx+Š+ Œ+--0-.0.9.@<.ƒ.¤„.Õ.HØ.V/` X/=:\@:-=€0=f=P p=•>¸˜>?¬ h?ˆ? ˆ?¨? ¨?î?¤ð?\@` \@ß@Äà@eAÄhAðA¼ðA-BÜ0BàBäàBYCx\C£C¤¤C˜D ¤D.EL 0E³E` ÌE´Ft ´FøF(øF§G  ¨GþH¬ I{IÀ ¨I¼IP ¼IKÐ KšK` œKMØ €MíÑ(F½èð‹(F½èð‹-éðO ò ðHü­ò-BòÀò@‘‚FhOô€r© ˜G¨ð+ü«Â«&šBÙ¬’ù0.+Ðp:¢B÷Ø«Bò|Àò@pZø?+ûÑø;+ø;ùѨ!ðüF°ñÿ?ÑBò”Àò@h˜GBò4Àò@BòˆÀò@ªh@0˜G ò-ðü½èðB©Oô€r(FðÒûB«Ä(FðÓûB«;3£BÒ“ù ± *Ð *õÑBò˜Àò@B¨"pðü`±BòœÀò@hB“ShC““hD“{ø1© õ…pÿ÷åýF(h©ÿ÷XýFǹBò”Àò@h˜GBò4Àò@*hBò¬Àò@h@0˜G ò-ð±û½èðžBò˜Àò@!ë h ñ˜G€F8Fÿ÷áüÈøñ. Ý5>Uø ÿ÷ÕüDø >÷Ѩÿ÷ÎüDø ºñ Ý›ªñUø ÿ÷ÁüDø >÷Ñ#JFAF8F#`ÿ÷Æþÿ÷Jþ ò-ðnû½èðÿ÷¿ßø ÀÜøÀ`EÑpG0@µ‚°ßøÀÜøÀÍøÀßøÀÜøÀÍøÀðRùþÞ0@0@-é üpÈpðp8qNqzqºqÌqìqr rrjrrrˆrÖrärssRsZsrs’sžs¦s¼sÎsÚsìsøstRtbtjtŒtœtØtuFuRuZu¦uºuìuøuv vÔ6ü67D7H7L7P7T7|8€8„8ˆ8Œ88”8˜8œ8 8¤8¨8L9P9T9X9\9`9d9h9l9p9t9x9|9€9„9:(:,:T:X:”:˜:œ: :$;(;,;0;4;P{\{h{t{ô{L|Ì<Ô<Ø<Ü<à<è<ì|ø|}}}(}4}@}L}X}f}|}Ô}à} Ì0Ø0Ü0à0(1,1MZÿÿ¸@躴 Í!¸LÍ!This program cannot be run in DOS mode. $Ý€ô™fî§™fî§™fî§™fï§Éfî§-£%§šfî§Æ)§fî§]£!§¼fî§]£ §ìfî§]£#§“fî§¾  §˜fî§¾ "§˜fî§Rich™fî§PEÄN€\Qà"  šhq"°@0@àÒ(X ø°.textp˜š `.rdataD)°*ž@@.data$+àÈ@À.pdataXØ@@.reloc„  à@B-éøCFð üFsØ!ð üFOð" z!$.€ø)ÝOð\Oð\cW\+Ñ1à"+ Ñ)ÝFPøëƒBûÑR!ø‹à!c]4´Bø;äÛ)Ý\$F!±PøKƒBûÑR#‚øSp8F½èøƒ-éøOŠFFðÂû!ðÇû#Êø0FÀø@”ù&F%Oðð-ü0±4”ùð'ü(øÑOð\ \!ù{W³8Fðü±¸ñ"Ð\/Ñ5ðç"/ ÑðѸñÑOðàOð'm=±3Frø»“BûÑv%/Oð\ÕÐø{Ñç\!=±3Frø“BûÑv%#ø;Úø03Êø0Iø#`§±”ùðÜû0±4”ùðÖû(øÑ”ù0Oð\+«ÑHF½èøHF½èø-éøCF‰F€FðEû†/ Ý ñ}Tø ð;ûƒ^=÷Ñ!0Fð;ûKòXÀò@BFFðÛû@Fð(û€F/Ý ñ~Uø+Kò\Àò@ëðÈûUø ðûëñ>ëÑ F½èøƒ F½èøƒ0µðóû­òMù FFFJ±\!3/*Ñø“ù *öÑD«“„«ª©(Fð ýù0Û»ù0\+7ÐD«“„«ª© Fðüü¨ðÙú«Z’ù0\+Ñ:’ù0 \+ЩŠBÓpù=\+øÑĨª©+Fðý!Oô‚pðÀúÄ©Oô‚rFðÒú F òMð§û0½!Oô‚pð¯úOô‚r)FFðÁú F òMð–û0½µp¹Nö€cÀò@h0±KòÀò@!h˜G ½ ½µž°F# ¨D"!““ “ “ “ðÐüD# “KòÀò@Aòé Àò@!h˜G«“ «“!FKòÀò@#“““$h#“#"  GX¹ð*ùKò`Àò@@0ðÓù °½Nö€bÀò@ ›˜oð`KòÀò@h˜GKò Àò@˜©h˜GX¹ðùKò|Àò@@0ð¯ù °½˜°½-éðOð û­ò-KòÀò@’‹Fh‚FOô€r© ˜G¨ð ú«Ä«&œBÙ­”ù0.+Ð&p<¬B÷Ø«Kò¤Àò@Z&pø?+ûÑø;+ø;ùѨ!ðlþF°ñÿ?Ñð¸øKò°Àò@ª@0ð`ù ò-ðÏú½èðB©Oô€r(Fð³ùB«Ä(Fð”ýB«;3£BÒ“ù ± *Ð *õÑKòÀÀò@B¨"pðAü`±KòÄÀò@hB“ShC““hD“{ø1© õ…pÿ÷ØýF(h©ÿ÷“þF‡¹ðmøKòÔÀò@*h@0ðù ò-ð„ú½èðž!ë ñðˆù€F8Fÿ÷nýÈøñ. Ý5>Uø ÿ÷býDø >÷Ѩÿ÷[ýDø ºñ Ý ñªñUø ÿ÷NýDø >÷Ñ##`›AF8F“±ð¨ùð$øKòøÀò@@0:FðÌø ò-ð;ú½èðJFÿ÷ðýÿ÷´þ ò-ð0ú½èð"ÿ÷ ¿HpGà@-é0H ò L h¹Oôpà(Ú `!ðŸþ M(`H¹#! #`ð–þ(`¹ àJ#P3 2P+Ú(høç ½è0ˆà@ Aû@-éH ò ð€ÿK“ù0 ±ð~ÿL hðÂÿ##`½èˆ A¨î@-éH ò JF”BÓò`#œB Ø£[ñðøãhSôCã`àKñ h˜G½èˆ°@à@-éH ò F(Ú0ðøÿãhSôCã`àKñ h˜G½èˆ°@ JB Óò`#˜B ØÃh3ôCÃ`ƒ[ñðó¿K 0hGþÞ°@à@(ÚËh3ôCË`0ðá¿Kñ hG°@´-é¾H ò oFybF$<`E¹ð…ú#`ðÕúoðWà)ôÐð|ù(öÛ}`(Fÿ÷~ÿëhð@5Ñ(FðÏú°ñÿ? Ðñ ÐC$IðQø#0ë‚"Jà!JFI“ø$0ðѰñÿ? ÐñÐCðQø#0ë‚’ø$0ð€ÐðAú#`ð‘úoð<`|¹(Fð¨úFñ("yj(FðZû8`)F Fðãúðø8h½è¾]øûµxhÿ÷bÿ½þÞàù@ ã@Fù;+ûÑXpG-éH ò #jF“ðgÿFD¹›3±ðú±ðþù›` F½èˆ-éH ò F‚±  Vø; ±:ùÑB±:Ð!"±ƒø˜BûÑ F½èˆ-é0H ò F##sY»ð¶ø `ÃnM#`ƒn"hc`KhšBÐo+hBÑðaú `KbhhšBУho+hBÑð‚û``¢hoð ÑSðg##sà h#`Khc` F½è0ˆþÞ”ç@ˆç@\å@-éH ò …°KFh;¹KÓø03ø0ðàhF!ÿ÷©ÿšSo+ÝjF! FðŒýàÒø03ø0ðø 0#±šo3ðg°½èˆÐæ@Dð@´-é0H ò ˆ° FF#¨!" •“ð˜ùE¹ðUù#`ð¥ùoðà,ôÐoðC“B#“«hF")F””ðkú›F;“+Û›"pàiF ð±ý F°½è0]øû°Nö´LÀò@ ÜøÀ­ë ÍøÀpGNö´LÀò@ ›ÜøÀ­ëcEѰpGFµlFìF,ð åFð&þ¥F½è@pG-éHëFÛih3ðPXðÐXðþ ½èˆ-éþO ò( F–“Ýø4 FÝø<€ šžF›‰F™ '±¹ñѱ ´à.ûоñÑ*öÑà*óкñÑ+îÑà+ëиñÑ)æÑà)ãÐ",F”ù0±:4*øÑ”ù0:+ѹñ Ð.Àð€#oð*FHFðâýÝøàeà¹ñЉøp•ù0'&+,FJДùðþ±4 à”ù0/+Ð\+Ð.+Ñ&Fàg4”ù0+èÑÝøà‡³¾ñ Ð š{šBDÙ*FoðpFð«ýÝøà=F'.³®B#Óºñ КsšB6Ù*FoðPFð—ýÝøà¸ñ#Й£™B(Ù2Foð@Fðˆýà¾ñÛÐ'ŽøpØçºñ КcšBÙ*FoðPFðsý¸ñЈøp 2à™ 'à šà™ š ž›¹ñб‰øp¾ñÐ ±ŽøpºñÐ ±Šøp¸ñÐ ±ˆøp=¹ðø#`ðXø à(õÑðþÿ"#`" ½èþ-éðH ò †°Ýø0àFF¾ñOô€tÐ%Fà%±#Fà#¹$ ±"à"“;F•Íø à–”ÿ÷âþ°½èðˆ-éH ò FF F™”‘oððHý½èˆFÛðÿAê!ð ÑAêA :ŒFÛ£è:£èùÚ2Û£è:ÛCøÚÐp*ÛYpÈ¿™ppGðÐRøðØÐ’#øÔç-éxH ò F$-FÐ-BÓ.@Ð0ù,1Z³ù<šB'Ñù,ú±ù<šBÑù,š±ù<šBÑù,:±ù<šBÑ4´BÞÓàø,ø< àø,ø<àø,ø<àø,ø<Ð àù Z±‘ù0šBÑ041¬BóÓ ½èxˆx xëç-éH ò K IFhjF ˜G@±KI˜h˜GF ± F˜G½èˆþÞ$²@,°@ ²@(°@ ð?¼ ðU¼-éH ò K h˜GFðÿü Fð,ÿ Fðý Fðý Fðý Fðþ½èˆ$°@-éþI ò F& F?¹ðäþ#`ð4ÿ ?à-õÐð þ ¹ Kh˜G¹&LOðê$h:F!0FÅø€Íø€Íø€ GF4¹Kh˜GðÙþ à`ðTú(`(÷Д Loð$h:F!0F GP¹Kh˜GðÁþ(hðfûÅø€áç ½èþ‰8°@4°@0°@-éH ò Fÿ÷[ÿK Fh˜GþÞ<°@-é0H ò LF#h3± Fðþ±#h(F˜GðCþLM ¬BÒø¹Tø;±˜G¬BøÓÀ¹HðóþL MàTø;±˜G¬BùÓL#hC± Fðòý ±#h"! ˜G ½è0ˆþÞèú@ ±@±@9L@8±@$±@ìú@´-éøO ò oFFþ"!ÿ ÿ÷IÿþÞ-é¾H ò oF ðdÿEöM"FI ˆ“BÑËkÉ hDòPSšB Ñ ‹@ò šBÑKo+ÙÑøè0 ±$à$<`ðLÿ7MP¹+h+Ðð×þ ðþÿ ÿ÷¿þðÿûP¹+h+ÐðÉþ ðúýÿ ÿ÷±þð%ýðÛú'Kh˜G$K`ð8ÿ!K`ð^ø(Ú ÿ÷›ÿð³ø(Ú ÿ÷”ÿ ÿ÷¡þ±ÿ÷ŽÿIKh `KhKhÿ÷ÖùF}` ¹ÿ÷{ÿÿ÷oÿ àF}`;h ¹ÿ÷nÿÿ÷`ÿà=h(F½è¾ˆµF hhðëø½ˆî@Œî@”î@´î@¼î@äú@@°@œö@@-éHëFð[ùÿ÷_ÿ½èˆ-éøO ò OßøD FˆFF$2FAFHFðŽùF¹†±;hs±Úø0 F˜G;hòè2FšBÙoð´ñÿ?æÑ(F½èøþÞD°@Äî@-éðK ò Oßø@F€F$1F@Fð”ùF¹†±;hs±Ùø0 F˜G;hòè2FšBÙoð´ñÿ?çÑ(F½èð‹þÞD°@Äî@-éðK ò Nßø@F€F$"9F@FðßùF…¹3hs±Ùø0 F˜G3hòè2FšBÙoð´ñÿ?çÑ(F½èð‹þÞD°@Äî@-éðK ò Oßø8€F>h$@Fð™ùF}¹v±Ùø0 F˜G>hòè3F³BÙoð´ñÿ?êÑ(F½èð‹D°@Äî@-éxH ò Fâh%ð+Ñô„Ð"h£hÖ.Ýð‹ü¡h2Fðgüãh°BÑð€Ð3ðàSð oðã`£h(F#`#c`½èxˆ-éH ò F¹ ðøà Fÿ÷Åÿ±oð àãhô€OÐ FðZüðžü(ñÑ ½èˆ´-éþI ò oFF½b&~`#»` ðù$<`*KhœB3Úßøœ€Øø0Sø$1³Ëhðƒ"Ð Fÿ÷ùøØø0Sø$ÃhðƒÐ-Ñÿ÷±ÿ°ñÿ?Ðs{` àU¹ðÐÿ÷¥ÿ°ñÿ?Ñoð»`ðø;h\<`½j~hÇçð ø»j+Ñxhà¸h½èþ ]ø ûµ ðßø½µ8hKhSø ÿ÷ìø½þÞ Aû@ ÿ÷•¿-éþI ò oF%=` ð¨ø$|`Nßøl€Øø0œB$Ú3hSø$è±ÃhðƒÐð©ü°ñÿ?Ð5=`,Û3hSø$0ñ Kh˜G3hSø$ðø3h"Cø$ 4|`Öçðø8h½èþ‰µ ð‹ø½H°@û@ A-éH ò €± KF!hKh˜G@¹Kh˜GðûFð'û`½èˆ8°@L°@ ö@-éðH ò L NO$%ch+Ñ;h0F&`Oôza6˜G4=òÑ ½èðˆP°@Èî@€â@-éðK ò LßøH€$&%FOð /h_±kh+ÐØø08F˜G8Fÿ÷­ÿÅø5>îÑN$% h ±ch+Ñ3h˜G4=õѽèð‹H°@€â@-é0H ò MFUø00+¹ðø¹ ÿ÷+ýKUø4h˜G½è0ˆ°@€â@KSø0KhG°@€â@-éðH ò oFFKh;¹ðü ðPûÿ ÿ÷üMUø60ë¹ ÿ÷2þF,¹ð’ú #` à ÿ÷¹ÿUø60 F;¹Oôza Kh˜GEø6@àÿ÷Aÿðø ½èðˆµKmKh˜G½þÞ°@€â@P°@ ö@-éHëFHOô€r!ÿ÷ŸúK"`½èˆàú@àù@-éðO ò ™°oF ÿ÷{ÿžL#h;±#{a£Iñˆð³û%á@! ÿ÷°ý8`8¹#»a›Iñˆð¥ûá `ßø\‚ #Èø0%éC "#hö˜BÒq`Bq…`ø$03ð€ø$0[²ð€ø$0€ø% €ø& …c€ø4P@08`áçñ ‚Kh˜G·øR0+ð‡€{m+ðƒ€hñ Çø ë Çø ¶õoÛOôf$¼`Øø0³B.Ú@! ÿ÷Yý8`0³jJBø$Øø0 3Èø0 !Rø$0ö˜BÒqoð`Aq…`ø$03ð€ø$0€ø%€ø&…c€ø4P@08`ãç4ÍçØø`¨F}`°E:ÚÚø°ñÿ?(Ðñ%Йø0ð ÐðÑMKh˜Gȱ_êhðGIQø#0ë‚<`Úø0#`™ø0#qOôzañ @Kh˜G£h3£`ñÇø€ ñ Çø ñ Çø Âç6L}`ßøä€oð -TÚ#hë…<`#h³ñÿ?ÐñÐ#yoðC#q?àoð~#q¹oð à-Ñoð àoð %Kh˜GF°ñÿ?Ðæ± Kh˜GÀ±&`ò+Ñ#ySð@à+Ñ#ySð#qOôzañ Kh˜G£h3£` à#ySð@#qÄøØø0±Sø%0Ãø5}`L¨çð ø àxià¸i¿°½èðµ ÿ÷Yþ½àù@P°@X°@\°@ AT°@àú@*@*@-éH ò LIH$h#" G± àoð½èˆð@¡'@`°@-éðO ò ‡°Fõi4hŽF+h‘qh‚F´ë ðO‘Ð3ðDe–ø(@ ±©ñ Úø@ðfQÑÖø$€Íø ’+h˜E€ð€ILë{h™E9Ó»h™E6Ò;i£³úh*ÐójRqF¨ð)ú(0Û%ÝÚø0>J“B Ñ#h;± Fð6ø±#h!PF˜G;iœ™"ð$ú3j9i˜“si 0L“Úø0$hRF Gðú+LÝøà™+hñ7˜E¼ÓGà Fà3iwj(h³ë‡B>Òëch™E1Ó£h™E.ÒÚø0ð ÐOð ±)FKh˜E Ó‹h˜EÒ i#išBÑÊhãhšBÐñ1†EìÓ™†EÑÝøà#i±˜EÐà{sbâhójRqF ðÀù(h7™Ýøà4‡BÂÓ °½èðÈù@d°@csmà-éH ò I" FTø;˜BÐ2-*øÓ°ñ+Ø à°ñ¼+Ø à à Sø2½èˆþÞàã@-éHëFðmþ¹Hà0½èˆþÞHå@-éHëFð_þ¹Hà 0½èˆþÞLå@-éH ò Fÿ÷ëÿ` Fÿ÷µÿFÿ÷Öÿ`½èˆK`pGþÞð@ ûÞ-éüK ò LFF hLFˆF$h GFE± œ3F:FAFHF”¨G½èü‹ ûÞ °@ð@-é H ò #"! “ÿ÷×ÿ½è ˆ-éHëF@¹ÿ÷˜ÿ#`ÿ÷èÿoðài½èˆ-éðH ò Fÿ÷éÿðù¨³þ÷@üñ œBÑ%àþ÷8üñ@œB'Ñ%Jh3`ãhô†ÑOOô€VWø%h¹0Fÿ÷ûGø%8¹ñ£`#`#£ac`à ` `¦af`âhAòCã` à ½èðˆþÞ ð@„î@-éH ò Fp±ãhô€_ ÐFÿ÷ûúãh3ôˆSã`#£a#`£`½èˆ-éH ò ËhFð@Ћh›±Kh;K`+Û hp hÀ²3 `àð•û°ñÿ?Ñoðà#h3#`½èˆ-éøO ò Òø @FÕøð@FF‚FÐÒø@¹2hÒ2`à#+`/Ýù 2FAF?ÿ÷ºÿ3h³ñÿ?Ñ+h*+Ñ2FAF? ÿ÷®ÿ/êÜ+h ¹Åø½èø-éðO ò þ÷¤ý­òx-™F#“# “# FF¨F “““”–%Oð þ÷Úüÿ÷¶þÿ÷µýê (Àòòƒ–³óhð@-Ñ0Fÿ÷ÿßøHßøü°ñÿ? ÐñÐCTø#0ðë‚à F“ø$0ðѰñÿ? ÐñÐCTø#0ðë‚‘ø$0ð€Ñœ4¹ÿ÷xþ#`ÿ÷Èþ¶ã”ù`' #!2F. ——“ð©ƒ›ßølçÝøH€“4”/Àòžƒ * Ûx*Üßø\7›ø <ðà#ëÃßøH[V ‘)òxƒßèð«.JMgÆ#“#% “Oð!ê #“Íø<à ‘^ã *Ð#*Ð+* Ð-*Ð0*@ðWƒUðSãUðPãUðMãUð€JãUðGã**ÑÙñðKDñ Yø ‘)€ò8ƒUðIB ‘2ã ›ëƒëC0; “+ãOð (ã**ÑÙñðKDñ Yø¬ºñ€òƒoðšFã ëŠëC³ñ0 ãI*Ðh*Ðl*Ðw*@ðƒUôeã”ù0l+Ñ4Uô€UúâUð÷âUð ôâ”ù 6*Ñ”ù04+Ñ4UôEèâ3*Ñ”ù02+Ñ45ôEÞâd*ðÜ‚i*ðÙ‚o*ðÖ‚u*ðÓ‚x*ðЂX*ðÍ‚# “#𲩓ðŠùP±™ª0Fÿ÷\þ”ù`4.ðÀ‚™ª0Fÿ÷QþŸ˜ —¬â²ñA7)ò‚ßèðÝ8ÝÝŠSeâ=MâââMÆdQOUôoÑUôeôoÐÙñðKDñ 9ø¯Uô€uñ8çUð@ $àOð #à'#$ð€“Ð0"ø Q3" ’ø0à$ð€ÐUôuôO ÐÙñðKDñ Yø Yø<6àô€_ðÑð Ðð@ ÐÙñðKDñ 9ù Ã"àÙñðKDñ 9ø óçð@ ÐÙñðKDñ Yø FÛ àÙñðKDñ Yø #Íø0ð@ Ð+ ÜÛ(Ò@BOðrëUô€uôOÑô€_Ñ3ðÿ3ºñÚOð à5ðºõÝOôzPêÑ" ’ÝøL òo(ºñªñ ÜPêÐF Fá¹¹ùÞðÉþ02“9* FÝJDø)æç òo#£ëÝø0ñô б˜ù00+Шñ0#ˆø00›+@ðˆ€ð@Ðô€Ð-#àðÐ+#àðÐ #ø0# “ › šžŸð Ñ`%½` ,3Ü Ð,Ð, Ð,9Ð,Ð/àßø`Øø?àÿ÷øF½`¹oðàèmFQKhëAëƒSh£BÐ 2rEùÓëA냚BÒSh£BÐ"ñØøà,Ð, Ð,Ðþ÷{ù#`þ÷ËùÒç`3Kh˜Gx`(Nй ý÷¼û± ý÷†þ,Ð ,Ð,Ð à+n;a (f,Ñkn{aŒ#kf,Ñ!L"hFú`N3h›™BÚëAëm나`1ù`"hñç Kh˜GÈøðø¼k,{hѽhin ˜Gà F˜G½h,Ð ,Ð,Ñ;i+f,Ñ{ikf °½èð ]ø ûµ;h± ý÷Mþ½$°@ÌÁ@ÈÁ@ °@Tð@ÀÁ@-éˆH ò oFþ÷Óÿƒo±˜GðxþþÞ-éHëFKHh˜GK`½èˆþÞhð@]J@$°@KhGþÞŒ°@KhGþÞ°@KhGþÞ”°@KhGþÞ˜°@KhGþÞœ°@-éH ò L#h+ Ú#“K!hFh˜Gz(Ñ#à##`+Ý à ½èˆˆ°@¼ì@ˆEöM#šBÐ pGÃkXDòPSšBöÑ ‹@ò šBñÑ pG-é0H ò Ãk$“ŠÕˆ›ñU±Âh‘BÓƒh›™BÓ4(0¬BôÓ ½è0ˆ½è0ˆ-é¸H ò oFF@òÀò@(Fÿ÷¿ÿ¹ 8`àa(Fÿ÷Íÿ¹ 8` àCjðOÑ à 8`à à8h½è¸ˆhhKšBÑ à pGÀ-éxH ò LN % h3h˜GDø =øÑ½èxˆ$°@Àì@-é0H ò KM3«BÒTø;±˜G¬BùÓ½è0ˆ,Ë@(Ë@-é0H ò KM3«BÒTø;±˜G¬BùÓ½è0ˆ4Ë@0Ë@-éH ò ! ý÷^û KFh˜GK`K` ¹ à##` ½èˆøú@ôú@$°@-éøO ò oFFý÷ºø*Kh*Kh˜G€F%Kh'Kh˜GFÁE8Ó ë ñ.2Ó@Fð]ýF´BÒ°õoÒFàOôc¡BÓ@Fý÷ïú8¹ñ¡BÓ@Fý÷çú°±_êªëƒ Kh˜GK`(F Kh˜GÉø ñ Kh˜GK`à%=`ðø8h½èøµý÷mø½øú@$°@ôú@ °@-éHëFÿ÷™ÿ¹oðà ½èˆ-éH ò I" FTø;˜BÐ2*øÓ à Sø2½èˆþÞ°¿@-épH ò ü÷ þ­ò-Fÿ÷ÝÿF-~Ð ðù(VÐ ðùYL¹Ôø(6+MÐü.nÐTJOôEq Fðèù(@ðˆ€#¤ø:2MKOô‚rñ2h ˜G@òû&8¹GJñ21FðÑù(UÑñ2ð÷ùC<+Ù°ñ;ñ2ëBñ2:Jæëc#ð5ù(DÑ5JOôEq Fð{ù(JÑ*FOôEq Fðsùà»,J+I Fð§ü"à'Koð h˜GFܱ°ñÿ?Ð"©5ø;ST±2²õú÷Ó#¨ø2ü÷´üF FL#“$h«© G ò-ü÷¡ý½èpˆ#"! “ý÷êþ#"! “ý÷ãþ#"! “ý÷Üþ#"! “ý÷Õþ#"! “ý÷ÎþþÞþÞ¤°@\°@àÀ@ ÔÀ@ÌÀ@œÀ@ °@hÀ@pð@-éHëF ðDø(Ð ð?øH¹Kh+Ñü ÿ÷!ÿÿ ÿ÷ÿ½èˆ˜ö@hK hšBÑ i+ ÑJi KšB ÐKšBÐKšBÐKšBÐ pGÿ÷Y½þÞ@™"“!“ “csmà-éHëFHÿ÷hý ½èˆþÞyO@-éHëF( Û(Ý(Ñ Kh àKh`àý÷(þ#`ý÷xþoðF½èˆþÞœö@K`pGþÞ˜ö@-éHëFKh˜GK`¹ à ½èˆ ö@¨°@-éðI ò …°&Kh˜GFî³3ˆFà2ø?¹2ˆ+øÑL“_$hOð{2F! Íø €Íø€Íø€Íø€ GFÔ±ý÷uùFµ±”L{2F$h! Íø €Íø€• G¹(Fý÷Šú%K0Fh˜GàK0Fh˜G%(F°½èð‰þÞ´°@°°@¬°@-éøO ò Ýø(šF#Éø0#Êø0FˆFF±Áø ñ'”ù "*ѹ'à'Ö²àÙø03Éø0±#x+p5øk0Fÿ÷ôúH±Ùø03Éø0±#x+p546±/ÙÑ .Ð .ÕÑ~¹¯ àYø$0™Z+x‚ø40Yø$0["šc’D á áœ"Yø%0yð€ðð€%.FÑFF/ð $ ñ@ Aòÿ>«"¦ë¹BÒ–ù61 (Ñp3522rEø îÓ‰H œ ñ@ £ë Pø$œ#“Y…L «JF$h©• G(OððÀ ›šDKEÀò€¦ë»Bñ Aòÿ> ñ@ ÂÓ¶à.CÑFF/ðÄ€ $ ñ@ Aòþ>«"¦ë¹B Ò0ˆ61 (Ñ€3522rE#ø ïÓeH œ ñ@ £ë Pø$œ#“YaL «JF$h©• G(Oð{Ð ›šDKE{Û¦ë»Bñ Aòþ> ñ@ ÅÓpàÁF/ð€€ $ ñ@@öUV õ¢S"©ë¹BÒ¹ø1 ñ (Ñ€322²õÕo#ø íÓ"DL’’ õ¢R›$hëÓs[ õ¢R!OöéP–Íøà GF’ª³&6H œ#©Pø$@˜“ « X3L’‰$h G(± ›šö²BêÜà,Kh˜GšF²BÜ©ë ºEOð @öUV ñ@©Óà$Lh’$h «:FAF G±Ýø( %àKh˜GFºñ&Ñu±-Ñü÷øÿ #`ý÷ø#`›å(Fý÷ ø—åK šSø"0š›yð@Иù0+?ôz­ü÷Üÿ#`ü÷æÿ#â盪ëAöð,åDû÷°þ½èðàù@8°@¤°@°°@̰@Ȱ@\°@´-éøO ò oF‘FŠFF¼bñÑü÷½ÿ#`ü÷«ÿ #`?àü÷¨þ(;Û,/Û#KhœB+Òe NðVø%0ëˆyðÐ FðÃÿVø%0ëˆyðÐJFQF Fÿ÷ ý8` àü÷~ÿ #`ü÷ˆÿ#`ÛC;`ðø8h àü÷~ÿ#`ü÷lÿ #`ü÷¼ÿoð½èø]øûµ¸jðÒÿ½þÞàù@àú@´-éøI ò oFFþ #`ü÷Žþ ½èˆþÞàù@àú@€±F°ú€ð±úóÀòM£ëÀ£ë@OðÀò¡€GùÞ±ëÂs(¿F@A±ë‚s(¿F@A±ëBs(¿F@A±ës(¿F@A±ëÂc(¿F@A±ë‚c(¿F@A±ëBc(¿F@A±ëc(¿F@A±ëÂS(¿F@A±ë‚S(¿F@A±ëBS(¿F@A±ëS(¿F@A±ëÂC(¿F@A±ë‚C(¿F@A±ëBC(¿F@A±ëC(¿F@A±ëÂ3(¿F@A±ë‚3(¿F@A±ëB3(¿F@A±ë3(¿F@A±ëÂ#(¿F@A±ë‚#(¿F@A±ëB#(¿F@A±ë#(¿F@A±ëÂ(¿F@A±ë‚(¿F@A±ëB(¿F@A±ë(¿F@A±ëÂ(¿F@A±ë‚(¿F@A±ëB(¿F@A‹(¿F@ApGðCH¿@B“ê! (¿IB€±F°ú€ð±úóÀòM£ëÀ£ë@OðÀò¡€GùÞ±ëÂs(¿F@A±ë‚s(¿F@A±ëBs(¿F@A±ës(¿F@A±ëÂc(¿F@A±ë‚c(¿F@A±ëBc(¿F@A±ëc(¿F@A±ëÂS(¿F@A±ë‚S(¿F@A±ëBS(¿F@A±ëS(¿F@A±ëÂC(¿F@A±ë‚C(¿F@A±ëBC(¿F@A±ëC(¿F@A±ëÂ3(¿F@A±ë‚3(¿F@A±ëB3(¿F@A±ë3(¿F@A±ëÂ#(¿F@A±ë‚#(¿F@A±ëB#(¿F@A±ë#(¿F@A±ëÂ(¿F@A±ë‚(¿F@A±ëB(¿F@A±ë(¿F@A±ëÂ(¿F@A±ë‚(¿F@A±ëB(¿F@A‹(¿F@A_êL (¿@BH¿IBpG-éðH ñ Pê&ÐQê9ÐFŒF³úƒñ¹²ú‚ñ 1¼ñ¼úŒðѶú†ð 0@.Û (eF4FÓ5F$ð…@Ðñ 4úñ„@ C !àùÞdDêÅtIAmBØÓ”BØ«A@Qñ´BíÑeEëÑàFÿ÷Cþ F!#à! ½èðˆ-éðH ñ ðDÕ@BaëA”ê#ÓRBcëCPê&ÐQê9ÐFŒF³úƒñ¹²ú‚ñ 1¼ñ¼úŒðѶú†ð 0@.Û (eF4FÓ5F$ð…@Ðñ 4úñ„@ C !àùÞdDêÅtIAmBØÓ”BØ«A@Qñ´BíÑeEëÑàFÿ÷çý F!#à! Ó@BaëA?@ÕRBcëC½èðˆ-éH ò …°FhFû÷ú›â²Óø03øø 0#±šo3ðgô@°½èˆ-éH ò …°FhF!û÷ú›â²Óø03øø 0#±šo3ðgô@°½èˆ´-éðH ò аFFF/¹&± ±#+` 1à±oð+`oðCžBÙü÷²û#`ü÷ü !à™¨û÷Êù˜Ðø¨0+»½øL0ÿ+Ù/±&±2F!8Fû÷Ùûü÷—û*#`ü÷“ûhø$0#±šo3ðg °½èð]øû±>³;p½±#+`à#L“«“@h$h#“#ª!–— G0±›+Ñѱ(` Ôç Kh˜Gz(ÈÑ/±&±2F!8Fû÷›ûü÷Yû"#`ü÷©û" ÀçþÞ8°@°°@-éH ò $”ÿ÷zÿ½èˆKhSðKh“BÑ pG pG°÷@´ì@-é0H ò F,NÐ(Màhëh˜BÐû÷êÿ i+i˜BÐû÷äÿ`iki˜BÐû÷Þÿ i«i˜BÐû÷Øÿàiëi˜BÐû÷Òÿ j+j˜BÐû÷Ìÿ`jkj˜BÐû÷Æÿ k«k˜BÐû÷Àÿàkëk˜BÐû÷ºÿ l+l˜BÐû÷´ÿ`lkl˜BÐû÷®ÿ l«l˜BÐû÷¨ÿàlël˜BÐû÷¢ÿ½è0ˆðì@-é0H ò Fô±M h+h˜BÐû÷‘ÿ`hkh˜BÐû÷‹ÿ h«h˜BÐû÷…ÿ k+k˜BÐû÷ÿ`kkk˜BÐû÷yÿ½è0ˆþÞðì@-éH ò F,ð<`hû÷iÿ hû÷fÿàhû÷cÿ iû÷`ÿ`iû÷]ÿ iû÷Zÿ hû÷Wÿ jû÷Tÿ`jû÷Qÿ jû÷Nÿàjû÷Kÿ kû÷Hÿ`kû÷Eÿàiû÷Bÿ kû÷?ÿàkû÷<ÿ lû÷9ÿ`lû÷6ÿ lû÷3ÿàlû÷0ÿ mû÷-ÿ`mû÷*ÿ mû÷'ÿàmû÷$ÿ nû÷!ÿ`nû÷ÿ nû÷ÿànû÷ÿ oû÷ÿ`oû÷ÿ oû÷ÿàoû÷ ÿÔø€û÷ÿÔø„û÷ÿÔøˆû÷ÿÔøŒû÷üþÔøû÷øþÔø”û÷ôþÔø˜û÷ðþÔøœû÷ìþÔø û÷èþÔø¤û÷äþÔø¨û÷àþÔø¸û÷ÜþÔø¼û÷ØþÔøÀû÷ÔþÔøÄû÷ÐþÔøÈû÷ÌþÔøÌû÷ÈþÔø´û÷ÄþÔøÔû÷ÀþÔøØû÷¼þÔøÜû÷¸þÔøàû÷´þÔøäû÷°þÔøèû÷¬þÔøÐû÷¨þÔøìû÷¤þÔøðû÷ þÔøôû÷œþÔøøû÷˜þÔøüû÷”þÔøû÷þÔøû÷ŒþÔøû÷ˆþÔø û÷„þÔøû÷€þÔøû÷|þÔøû÷xþÔøû÷tþÔø û÷pþÔø$û÷lþÔø(û÷hþÔø,û÷dþÔø0û÷`þÔø4û÷\þÔø8û÷XþÔø<û÷TþÔø@û÷PþÔøDû÷LþÔøHû÷HþÔøLû÷DþÔøPû÷@þÔøTû÷<þÔøXû÷8þÔø\û÷4þÔø`û÷0þ½èˆ-éðO ò û÷:ø„°oF‚°{`&×ø< :`¹`ºñÑhÐø 8l± !à!1L $hPF G€F¹&OàMöÝY¸ñ&Ý#Û;˜E!ØñX°õ€oØÃƒBØoð3ðœðåÿ­ë ñ ÐLöÌC+`àþ÷bþF-ÕÐÀø5à%-ÎÐ_êH!(Fû÷PùL{h:h$h!PFÍø€• G8± L»kF$h¸h)F GFUøöѹ…ø 5*Eјø0 ±.ѵñ ÈF¡E Ó˜øiFý÷Òø±¨ñ EõÒ©ëðÐø¬>à¶ñÿ?Ñ/Ùë¨ñ5F¦BÓ(xiFý÷µø±=¥B÷ÒsðÐø¬àãø¬P %à„ø û÷)û"#`û÷yû" à++Û¯>F§BÓ0xiFý÷ø±>¦B÷Ò»ðÐø¬û÷ û*#`* à ø 0+?ôj¯šo3ðgcç-é?H ò F F=¹û÷óú#`û÷Cû #à,õÐ¥BùÒhFFú÷ù™‹h ¹`àb:•BØx[[~ðöÑ£ðãXø 0#±šo3ðg°½è0ˆ"ÿ÷Ç¿-éðH ò F¹¹Ù»$@àÀ³¹³¹#p÷ç*¹#pû÷­ú$(à'´ñÿ?F F ц’ù0³Tñk±=÷Ñ à“Wø;±=Ð<÷ѹ7p-ÓÑ´ñÿ?ÑCø|P$àpû÷ƒú"$`û÷Óúàû÷|ú#`û÷Ìú$ F½èðˆ-éHëFý÷Ÿø± ý÷¥øKhðÐ ûÞ ú÷ÁüþÞLí@ ú÷ü-éHëF@¹û÷Tú#`û÷¤úoðàKF!hKh˜G½èˆä°@ ö@-éðO ò ú÷ùˆ°YKF‘h F˜GF%ý÷tù\L‚F#hÓ»YKXHOôbh!˜GF/ð€NKQIh˜G(ð†€HKh˜GIKKI `h8F˜GDKh˜GDKFI``h8F˜G?Kh˜G@K@I `h8F˜G;Kh˜G a@±:K9I8Fh˜G6Kh˜Gà`3Kh˜GX±¹ñÐ.KHFh˜Gºñ Ð MàºñÐ'K hh˜G Dààh°BÐ#i³BÐ!Kh˜G K‚F ih˜GFºñбÐGP±«“ #ª!¸G±›ðÑXôà`h°BÐKh˜Gh±€GFU± h°BÐ Kh˜GF±(F˜GFK hh˜GF,±šCFIF(F Gà °ú÷pø½èð °@ì°@è°@$°@¤Ê@,°@dÊ@€Ê@”Ê@XÊ@@Ê@„°@°ù@-éH ò à±Ù±*¹#pû÷gù$à„’ù0£Tñ ±9÷ÑA¹#pû÷Wù"$`û÷§ùà$àû÷Nù#`û÷žù$ F½èˆ½ë„ îPO¤hÓ¤EÓ­ë pG_ð ÷ç`´fFoó ¤õ€T%h´BúÑ`¼­ë pG-éðH ò †°FFF6±/±‘ù@4¹ ±#+€ °½èðˆ¨Fù÷4ÿ›Óø¨0k¹ ±3x+€ ø0+ìКo3ðgæç0x©þ÷öüౘCo+ÝŸBÛ ±"à"L@h’$h2F !• G(˜ÑCoŸBÓ–ù0‹±@oÓç ±#à#˜ L“@h$h#2F !• G(ÂÑû÷Ìø*#`oð¼çþÞ4°@#ÿ÷—¿´-éH ò L hñÑðÆú h°ñÿ?ÑOöÿp àL#“$h«"© G(òнø½è]ø ûþÞð°@Pí@-éðH ò F((ÛKh˜B$ÒNðEŸVø%0ûX³ñÿ?ÑKh+ÑH±(Ð( Ñoð àoð àoð K!Fh˜GVø%0 üPàû÷fø #`û÷pø#`ØC½èðˆþÞô°@˜ö@àù@àú@-éxH ò (1Û!Kh˜B-ÒMðDžUø$0òyð!Ðh³ñÿ?ÐKh+ÑX±(Ð( Ñ!oð à!oð à!oð Kh˜GUø$0oð òPàû÷ø #`û÷$ø#`ØC½èxˆþÞô°@˜ö@àù@àú@-éH ò FñÑû÷ ø#`ú÷úÿ #`!àú÷÷þ(Û,ÛKhœB ÒKaðSø!0ë‚yðÐh àú÷ëÿ#`ú÷Ùÿ #`û÷)øoð½èˆþÞàù@àú@´-éH ò oF8aAKðSø!0ë‚£hƒ¹ ú÷æü£hK¹Oôzañ Kh˜G£h3£`ðø:iQ KðSø!0ë‚ñ Kh˜G ½è]ø ûµ ú÷Ûü½°@àù@P°@KAðSø!0ë‚ñ KhGþÞ°@àù@-éðO ò …°oFoð©F=`#û` ú÷½ü(ð˜€ú÷hþ(Àò“€ ú÷Žü&ßøFF–ù *]Ð *Ð*p56TàŽB Òù? +Ñ6 #+p5Hà*pûçZø)$h#Xø“«"©6 G ¹ßøX3h˜Gx»›k³Zø)0CDyðHÐù0™ßø8C +×Ð #+pZø)05ëø0Sqà½BÑù0 +Ñ # à˜#“oðoðþ÷Tÿù0 +Ð #+p5»L™›žBžÓàZø)0ëyð@ÑSðqà3x+p5›î+dÑ.bÐø=ð€Ñ5?à¬J!à)ܽBÓ=+x1›V+õÐ(xƒV¹ú÷ƒû*#$á3‹BÑm&àZø)0ëyðHÐ5)PqÛZø)0ë+x5‚ø%0)ÑZø)0ë+x5‚ø&0mà˜#JB“Óþ÷ëþ ›ŠLí[“›$h:F“+F!OöéP GF.?ôè®®BÐ"à"Zø)0vCDcoð›ŸBÐ8Fù÷õÿñðæ€&Fãà›S³ëÖs[ëC§B9F:FÒ¥ˆ(Ð ( ѪB ÒSˆ +Ñ # €21à€12¢BëÓàZø)0ëySðqË[^Äç*±;ˆ +ÑPðà0𺒗B q=F¸F€ðƒ€‘UL ž‘F¸ø *jÐ *Ð*€5ñ`àˆE Ò8ø? +Ññ #+€5Sà*€ûçZø)$h#0X“«" ñ ñ G¹?Kh˜Gл›Ã³Zø)0›yðHнø 0™8L +ØÐ #+€Zø)05òø 0SqZø)0òø 0‚ø%0Zø)0› "ƒø& à½Bѽø 0 +Ñ # à˜#“oðoðþ÷þ½ø 0 +Ð #+€5L™›˜E‘ÓàZø)0òyð@ÑSðqà¸ø0+€5î.çKh˜G(Ñú÷aú #`ú÷kú#`æm(ô®$ç& àú÷_ú#`ú÷Mú #`ú÷úoð0F °½èðþÞ8°@±@4°@Xí@±@Ȱ@àù@àú@´-éøO ò oFFŠFF¼bñÑú÷1ú#`ú÷ú #`Làú÷ù(HÛ,<Û)KhœB8Òfßø˜€ð Xø&0ë‰yð+ÐoðCBÙú÷ ú#`ú÷ûù#&à Fÿ÷*úXø&0ë‰yðÐ*FQF Fÿ÷­ü8` àú÷åù #`ú÷ïù#`ÛC;`ðø8h àú÷åù#`ú÷Óù #`ú÷#úoð½èø]øûµ¸jÿ÷9ú½àù@àú@-éHëF@¹ú÷ºù#`ú÷ úoðàù0+òÐ)ðÐ h+íГù0+éÐ"ðû½èˆ-éðI ò °FFF€Fü÷Ûø`±LH$h GLI$h GF¹oð#àœü÷Êø(@F9FÐ#“›2F •“›“# “ “«“› G à#š“›LC“›$h2F“+F G °½èð‰ü°@ÌÊ@,°@ØÊ@±@-éðO ò ‘°F# ““ #“#“ ’ F &ú÷Eø(ÚóC#`ùàð€Ð#Oðà#O𠨓ð^ü(@ðã‚ôO Ñôè/Ñ ›³õOÐoðSêOúƒøðÐ+Ð+ Ðú÷"ù#`ÛC#`ú÷ù#`ú÷^ùâOð@I àðÐôà/öÑOð€IàOðI›+Ð +Ð0+ Ð@+Ѐ+ÙѹñOÑ!à!à!à!ôàc³õ€o‘Ü Ðc±³õ€гõ%гõ@¾Ñ' à' à' à³õ oгõÀoгõào¯Ñ'€#Oð “ô€Ðßø5h›3êð€Ñ#“à'êç€#ð@ÐYô€9Qð‘Oð€jô€_ÐSô€s“ô_ÐZðzð ÐZðjàðÐZð€Zÿ÷ù `°ñÿ? Ñú÷•ø#`ÛC#`ú÷ø#ià ›" ˜`›šIF“«Íø —ÿ÷ÑþF “°ñÿ?1Ñð@C³ñ@OÑðЛš ˜9ðI“«IFÍø —ÿ÷·þF “°ñÿ?Ñ"hßø$4QSø!0ðë‚y3ðqßø4h˜Gú÷Zøú÷<øhëáFßøü3h˜G»"hßøè3QSø!0ðë‚y3ðqßøÄ3h˜GFú÷;øßø¼3 ˜h˜G,ÙÑú÷ø #`Ôç(ÑXð@à(ÑXðOúƒø h ™þ÷lÿ#hßøˆãXðYð^ø!0ë‚q#hYð^ø!0Oðë‚’ø$03ð‚ø$0ðH “>Ñð€;Ð B9Ð hoðoð‘þ÷kûF “ @³ñÿ?ˆFÑù÷Úÿhƒ+#Ð hÿ÷(ù†ç h#©"­ø0ÿ÷úX¹½ø0+Ñ h šCFðõú°ñÿ?æÐ h#"“þ÷@ûê³ñÿ?ÛИ!ð€ðÝ€ôè/Ñ ›ôè#ÑUô€EàCôè#³õ€Oгõ€?гõ ?гõ?гõ?гõ€/гõˆ/ÑOðà@ò2ê“BÑOðÍø€àOðùçOðôà/ð¤€#“ð@@ðž€ð@C³ñ€OjгñO0гñ@O@ð’€/ð€/Ù/Ù/@ðˆ€'¸ñpиñ@ð€€OöÿcOðjà h#"‘þ÷ÍúPêéÐ h'#"—þ÷Ãúê³ñÿ?Ñ]ç' h©"ÿ÷åù°ñÿ??ôT¯š(Ð(%ÑmKšBÑ#“Oà’²OöþsšBÑ hÿ÷løù÷ÿ#`&µàOöÿcšB Ñ h#"—þ÷úê³ñÿ??ô+¯#Ýç—àg³/¢Ù/Ø h#"‘þ÷{úPê—Ð#“ h#"þ÷qúê³ñÿ?Ñ çLKOð“« h¨ëùü÷ ÿ°ñÿ??ôý®?¸E«ñÜ#hAOYðWø!0ë‚‘ø$0šS@ð‘ø$0S@ø$0ô€?Ñ à #hYðWø!0ë‚’ø$0ðCêÀ‚ø$0 ›s¹ð Ð#hXðWø 0ë ySð  qð@C³ñ@O3Ñð0ÐK ˜h˜G›š ˜“#“«9ðAÍø ÿ÷Îü°ñÿ?ÑKh˜Gù÷‚þ#hYðWø!0ë‚y3ðq hþ÷þæ#hYðšWø!0˜P0F°½èð#"! “ù÷wþþÞ8°@ø°@àù@X°@¤î@-épH ò …°FF FE¹ù÷+þ#`ù÷{þoðà,ôЫª1F F•ð#ú°ñÿ?ðЛš)F ðÜûF˜ù÷Òú˜ù÷Ïú F°½èpˆ-éðO ò ‡°F‘F’ˆFFG¹ù÷ùý#`ù÷Iþoð™à—ù0+òиñïÐØø0+ëГù0+çÐ\!8FðñüF8F/!ðìü»»:!8Fð*ýFî¹8Fø÷·ûFà!ù÷<ùF-ÑÐIJáþ÷Qü(sÑ:Fá(Fðý(eѮ౰BÙF.!0FoððÀü((F Ð!ð:ý(HÑJFAF(Fÿ÷kÿFAàø÷…ûñ PF!ù÷ ùFæ³*FQFþ÷ü(OÑ(Fø÷tûƒ“ù÷ˆýh˜Oð “&Kªë‘ñ Zø)‰þ÷ü€»!0Fðý8±©ñ ˜™¹ñíÚ àù÷hý›šAF`0Fÿ÷+ÿF0Fù÷!ú½BÐ(Fù÷ú F°½èð#"! “ù÷ý#"! “ù÷zý#"! “ù÷sý#"! “ù÷lýþÞþÞXî@Ë@-éðH ò ,MDðUø$0±õ€O높ø$0yCó-бõO&бõ€?бõ?бõ€//ÑoðCqUø$0높ø$03ð~SðàoðCqUø$0높ø$03ð}Sðàðq àoðCqUø$0높ø$03ð‚ø$0ð€ÑOô@à¹Oô€@àOô€0½èðˆàù@-éHëF8¹ù÷Ìü#`ù÷ý àKh` ½èˆÄù@-éðO ò …°™F#“’F#"F%Oðþ÷Cøê´ñÿ?‘$Ð#“#"8Fþ÷5øê³ñÿ?кëië#.TÛÜ,LÐIKh˜GIKOô€R!h˜G‚FH¹ù÷ƒü #`ù÷üh°½èðOôA8Fÿ÷DÿF.ÛÜ´õ€_ÓOô€Rà"FQF8Fü÷ïù°ñÿ?Ð$fëàv.ÛèÜd±æçù÷hüh+Ñù÷Uü #`oð¨FIF8Fÿ÷ÿ'Kh˜G%KRF!h˜G,à.0ÜÛ,-Ò“KFRF8Fý÷Îÿê³ñÿ?±Ð8Fþ÷(üKh˜G±%àoð_êåxê³ñÿ?Ñù÷ü #` Kh˜GFù÷%ü`ê³ñÿ?Ð#š“›8Fý÷ ÿê³ñÿ?ƒÐ „çþÞ8°@ ±@L°@¨°@h°@-éðO ò ø÷Èúް߸pCFF hF ’ `h"% ‰“—­ø0 zFø2h’’F•@±ø÷¼ùCTø](÷Ñ•!(Fø÷;ÿÈø`¹#;`ù÷Âû #`ù÷Ìû#`oðCá ª¨!ðžû(±(ðAßøè¢'à ¨ø÷’ùñ ˜±ø÷ŒùDßøÐ¢%.ð‹€0h'4F—@±ø÷~ùÃTø_(÷Ñ—Úø@¤¹û÷†ýFÊøt¹ŸØøoð’ù÷Bø%šœÈøP=`ôà”ù0'[±[² F=+Ðø÷UùÃ_ãWà+õÑãW¸F—=+Ñâ’ù0³±’ù0:+Ñ’ù0=+Ñëø÷9ùëñù0ë=+åÐÍø€š¨ë°Fœ3h” à ¨ø÷"ùFØø ©ðúûè±Xø?+ñÑLD! Fø÷œþ›`ع œ hø÷çÿ##`ù÷û #`ù÷)û#`šoð’à#“ãç›=`Ÿ“›“àÝø$€›Øø@h ¹4à™# FÉþ÷Šù(@ð´€›Sø “ø÷Ûø\›hàØø0™ FÉþ÷tù(@ð‚€›hø÷Çø$ #ø;›Sø/“*æÑÝø€ø\%pØø@þ³Ýø€Úø0 F¨ëÙý÷5ûãë3hÝø€›±ŸØø02h FÙþ÷Aù(VÑ0hø÷–ø\Vø?+ìћù ªIF Fþ÷/ù(RÑ1JIF Fðôù(DÑš2±IF Fðìù±'àšLDàš<±Øø0œBÑ%p4%pš$Úø±ø÷Aÿš#Êø0±Fø÷9ÿ F°ø÷Sù½èð#"! “ù÷œú#"! •ù÷•ú#"! •ù÷Žú#"! •ù÷‡ú#"! •ù÷€ú#"! •ù÷yú#"! •ù÷rúþÞþÞ$Ë@¼î@Ë@-éðO ò Ÿ°FOð Oð “‘F±.Ð Ý.Ý.ÑOð ’ù0’Ó± ! àù÷&ú#`ù÷ú#`ù÷dúÃà2’ù0+úÑ’ù0 ±p2’ù0+òѨD"!ø÷<úD#“ù÷úø(Àòª€`KßøxhŒ±aKXø#0ðë‚“ù0¹<9,ñÑ,Àò€Cò23œB€ðŠ€ë„3˜²!­øjø÷Bý(}Ð`šOð!ê,ÝKXø#0ðë‚yðÑph;`à€øà=`107¡BèÛš¹ñÐ!,Ú#Fà#™BÚøëBø[1òçOð ù÷Ÿù «“«“›)L"“™$h#`˜“’#"Íø  G!KFh˜GF˜ø÷9þ¹8Fù÷ù&à.(Ð~¹K ˜)Fh˜GK ˜ ©h˜GK ˜ h˜Gà.Ñ K ˜h˜G%à K ˜h˜Gàù÷Mù #`oð(F°½èð ø÷¢ûþÞþÞø°@ °@°@8°@°@àù@àú@-épH ò …°FFhFF%÷÷Hÿ4¹ù÷#ù#`ù÷sù"à˜ƒh+¹1F FðáùFà"xPú‚ó[~Fð Ð4"x*±Bê#žBÑeà-à–BÑ%F*ñåÑø 0#±šo3ðg(F°½èpˆ"ÿ÷¹¿-é?H ò FFhFF÷÷ÿ4¹ù÷Ýø#`ù÷-ù à˜ƒh»¹)F FðµùFàPú‚ó[~ðÐ4#xs±Cê#BÑ< àBÐ4"x*FéÑ•BÐ$ø 0#±šo3ðg F°½è0ˆ"ÿ÷½¿-éH ò F±±\¹#pù÷šø#`ù÷êø$ F½èˆF’ù0±29ùÑ)¹#pù÷†ø$à”ù0Uñ ±9÷ÑA¹#pù÷vø"$`ù÷ÆøÛç$Ùç-éH ò F FK±iFFø÷sù¹ù÷^øhà˜!FðNùF˜ø÷ý F½èˆ-éðH ò KMFh,h ³<¹Khë±ðzùй,hı¿±8F÷÷!þ%hFà(F÷÷þ°BÙ«W=+Ñ2F9F(Fðú0±Tø_-íÑ ½èðˆ#h›XùçþÞ˜î@”î@üú@-éüK ò oF‚°F FF ø÷8ý=¹ù÷ø#`ù÷Wø#.àOð Åø ±Äø.îÐ0Fÿ÷¥ÿ€Fø±÷÷ÙýF!0F÷÷Üý(`8¹ø÷èÿ #`ø÷äÿhàBF1Fý÷lþ8±Íø#"! ù÷ ø±&`#;`ðø8hàxh°½èð‹µ ø÷ ý½-éÿH ò FFF¹ |àhFF÷÷Øý™‹h+¹:F1F(Fðîùgà±F¹ø÷©ÿ#`ø÷ùÿoð@\àø+?Qú‚ó[~ðÐ+x ¹"àCê"‹‰5šBÓˉšBØ ŠàKŠšB Ó‹ŠšB ØËŠ›š²àPC~ðÐø!ø Qú€ó[~ðÐ3x ¹ àCê ‹‰6˜BÓˉ˜BØ ŠàKŠ˜B Ó‹Š˜B ØËŠ˜²àDc~ðДø‚BÑ ±/©Ñ àÙ àoðø 0#±šo3ðg°½èðˆ#ÿ÷s¿-éH ò Fù;+ûÑJ²8 BÐù0“BøÑù0J²“BÐ ½èˆù0;±J²“BÐ0ù0+øÑù0J²“BÐ pG-éH ò ÷÷Úýа FX¹ø÷ ÿ#`ø÷ûþ#`ø÷Kÿ %à4ððÑKjF!h˜G@¹Kh˜Gø÷ÿø÷åþhà›ðÑð ÐðÐø÷åþ#`ø÷Óþ #`èç °÷÷®ý½èˆ8°@±@-éðO ò …°#“$Kh2hʳ!OOð ê ¸FOð ØRØ^Ør؈ؘبضØÒØâØîØÙÙ*ÙÑ@ED@eL@ÁO@ E@­€@1@%s %sfailed to create process. failed to get exit code from process. -script.pyCannot open %s #!#!python.exeCannot find Python executable %s Could not exec %smscoree.dllCorExitProcess(null)(null)EEE50P( 8PX700WP `h````xpxxxxSunMonTueWedThuFriSatSundayMondayTuesdayWednesdayThursdayFridaySaturdayJanFebMarAprMayJunJulAugSepOctNovDecJanuaryFebruaryMarchAprilJuneJulyAugustSeptemberOctoberNovemberDecemberAMPMMM/dd/yydddd, MMMM dd, yyyyHH:mm:ssSunMonTueWedThuFriSatSundayMondayTuesdayWednesdayThursdayFridaySaturdayJanFebMarAprMayJunJulAugSepOctNovDecJanuaryFebruaryMarchAprilJuneJulyAugustSeptemberOctoberNovemberDecemberAMPMMM/dd/yydddd, MMMM dd, yyyyHH:mm:ssen-USja-JPzh-CNko-KRzh-TW¶@¶@ ¶@,¶@  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~R6002 - floating point support not loaded R6008 - not enough space for arguments R6009 - not enough space for environment R6010 - abort() has been called R6016 - not enough space for thread data R6017 - unexpected multithread lock error R6018 - unexpected heap error R6019 - unable to open console device R6024 - not enough space for _onexit/atexit table R6025 - pure virtual function call R6026 - not enough space for stdio initialization R6027 - not enough space for lowio initialization R6028 - unable to initialize heap R6030 - CRT not initialized R6031 - Attempt to initialize the CRT more than once. This indicates a bug in your application. R6032 - not enough space for locale information R6033 - Attempt to use MSIL code from this assembly during native code initialization This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. R6034 - inconsistent onexit begin-end variables DOMAIN error SING error TLOSS error runtime error ȶ@(·@ €·@ Ø·@ ¸@x¸@ظ@ ¹@x¹@è¹@8º@¨º@»@d»@¨»@ p¼@!ؼ@"Ⱦ@x0¿@yP¿@zl¿@üˆ¿@ÿ¿@Runtime Error! Program: <program name unknown>... Microsoft Visual C++ Runtime LibraryÀ À–ÀÀŽÀÀÀ‘À’À“À´ÀµÀ  €€†€€†€†‚€EEE………00€P€ˆ('8PW€700PPˆ (€ˆ€€`h`hhhxppwpp ((((( H„„„„„„„„„„‚‚‚‚‚‚ h(((( H„„„„„„„„„„‚‚‚‚‚‚ H€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@abcdefghijklmnopqrstuvwxyz[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ABCDEFGHIJKLMNOPQRSTUVWXYZ{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿÀ÷@ø@USER32.DLLMessageBoxWGetUserObjectInformationWGetLastActivePopupGetActiveWindowGetProcessWindowStationCONOUT$CreateFile2kernel32.dll.cmd.bat.exe.com.\SystemRoot=m!YàjàéèÕÿEñÿÿÿc€;à_àbàÔÿî"Kà–àßàêàè‚èßÿEÙÿÿÿp03Çü¨¾ÿïÿ*eû  € àÿýÿÀ àýÿ € àÄÔÿÄ ýÿy03Çü¯øÿïÿ*å• ¿  Çü¨¾ÿ*Ã!#"?"%"U03Çü©þÿïÿ*³$ï$!%‹$ÿ$%= Çü©þÿ*Y%µ%¿%6 Çü¨ðÿ*7'S']'A°!Çüßÿ*³' *#*'°3èžèüßÿèßÿEÙÿÿÿ:03Çü¨ÿïÿ* 88)8ç7ÿ738b03Çü¨ÿïÿ*×8û8 9§8Í89( Çü¨œÿ*·=Å=Ù=§0DéLèü¨pÿè¨pÿEéÿÿÿG Çü¨¸ÿ*@_@s@ʰ3èü«ðÿè«ðÿEÝÿÿÿÇ Çü«üÿ*_CùC'D Çü¨¸ÿ*'E1E9Eš "ü¨üÿïÿíÿ»°3Çü©ðÿ‰ðïÿ*I÷I7J  Çü¨ˆÿ*oJqJqJ' Çü¨¸ÿ*KÅKÏKÅKV Çü¯øÿ*±LCMMM·@àè‚èü¨pÿè¨pÿEéÿÿÿ¬0Uù¼üüèüßÿ÷¼èßÿEÙÿÿÿ\03Çü¯øÿïÿ*/]a]‰]\03Çü©øÿïÿ*ó]5^U^)03Çü¨¸ÿïÿ* __#_ lû¨ÿ € àü¯øÿ¯øÿÿ € àü¯øÿ¯øÿÿ€ àìÿýÿO€ Màü¨ðÿ¨ðÿÿe€ càü¨ðÿ¨ðÿÿy€0Cà ü¨ðÿˆðïÿ|°3ÇèüßÿèßÿEÙÿÿÿ 0§àÇèüßÿèßÿEÙÿÿÿb17à]àüÛüÿÛüýÿÛüýÿhA;àcà üÛüûûÿÛüýÿÛüýÿÿh03ÇüßÿÛïÿ*ettÉt¼€!àüßÿ´03èüßÿèßÿEÙÿÿÿÀ àýÿ € àì`ÿì`üýÿc€ àü¨ðÿ# "ü¨ÿïÿ503Çü¨ÿïÿ*Ý|õ|}®°!Çüßÿ*Ç}ß}¿~}§~µ~U03Çü©øÿïÿ*€7€_€>03Çü¨ÿÿˆðïÿ*g¡i03Çü¯øÿïÿ*aˆ“ˆ»ˆ€ àüßÿÏ€°àüßÿ»€Aàüßÿ»0…àèüßÿèßÿEÙÿÿÿõ€ïàüßÿM°"Çü«üÿ«ðÿ*9œ«œ»œ@°3 èü¨ÿè¨ÿEñÿÿÿN€HàüßÿK€kàüßÿP°3Ç èüßÿ èßÿEÙÿÿÿÓÄØ°$Ô@ÔRÔjÔ€Ô–Ô¬ÔÄÔÜÔìÔüÔÕ$Õ6ÕLÕ\ÕjÕ|Մ՜ըÕÐÕâÕðÕÖÖ$Ö0ÖFÖVÖbÖnÖx֊ֲ֜ÖÐÖÜÖæÖôÖ××$×6×P×f×€×š×´×Æ×Ô׿×ö× ØØ.Ø>ØRØ^Ør؈ؘبضØÒØâØîØÙÙ*Ù¼GenerateConsoleCtrlEventëCreateProcessAÏSetConsoleCtrlHandlerCGetExitCodeProcess¹WaitForSingleObjectyGetModuleFileNameA?EnterCriticalSection³LeaveCriticalSectionDecodePointer;EncodePointer}GetModuleHandleExW²GetProcAddress,AreFileApisANSIáMultiByteToWideChargGetLastErrorlExitProcessáGetCommandLineA]SleepDeleteCriticalSectionMHeapFreebInitializeCriticalSectionAndSpinCountÔGetStartupInfoWUGetFileTypeÚGetStdHandle]InitOnceExecuteOnce¹RtlUnwindExIHeapAlloc'GetCurrentThreadIdSetLastErrorÌGetCPInfoGetOEMCP½GetACPƒIsValidCodePage¸LoadLibraryExWGetCurrentPackageIdOSetUnhandledExceptionFilter§FlsAlloc¨FlsFree©FlsGetValueªFlsSetValuezGetModuleFileNameWïWriteFile·GetProcessHeap>GetEnvironmentStringsWÛWideCharToMultiByte¶FreeEnvironmentStringsW1QueryPerformanceCounterñGetSystemTimeAsFileTimeGetTickCount64PHeapReAllocGetConsoleModeõGetConsoleCP¬FlushFileBuffersßGetStringTypeW¥CompareStringEx¦LCMapStringEx SetFilePointerExRHeapSizeyIsDebuggerPresent OutputDebugStringWîWriteConsoleW.SetStdHandleŽCloseHandleÖCreateFileWKERNEL32.dllKReadConsoleWMReadFile~GetModuleHandleWöSetEndOfFileIGetFileAttributesExWùSetEnvironmentVariableA û@ û@ÿÿÿÿ€         ! 5A CPR S WY l m pr € ‚ ƒ„ ‘)ž ¡¤ § ·Î×  4²@<²@ÿÿÿÿþÿÿÿC¬²@°²@´²@¸²@¼²@À²@IJ@Ȳ@в@ز@à²@ì²@ø²@³@ ³@³@³@³@³@ ³@$³@(³@,³@0³@4³@8³@<³@D³@P³@X³@³@`³@h³@p³@x³@„³@Œ³@˜³@¤³@¨³@¬³@¸³@̳@س@à³@è³@ð³@ø³@´@´@´@ ´@0´@@´@T´@h´@x´@Œ´@”´@œ´@¤´@¬´@´´@¼´@Ä´@Ì´@Ô´@Ü´@ä´@ì´@ü´@µ@µ@¬´@(µ@4µ@@µ@Pµ@dµ@tµ@ˆµ@œµ@¤µ@¬µ@Àµ@èµ@üµ@`å@`å@`å@`å@`å@ðì@0Ã@¸Ç@8É@hå@Ðæ@ˆè@¤`‚y‚!¦ß¡¥Ÿàü@~€ü¨Á£Ú£ þ@þµÁ£Ú£ þAþ¶Ï¢ä¢å¢è¢[þ@~¡þQQÚ^Ú _ÚjÚ2ÓØÞàù1~þ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ4Å@Næ@»±¿Dÿÿÿÿ‘w@‘w@‘w@‘w@‘w@‘w@‘w@‘w@‘w@‘w@..èì@¸÷@¸÷@¸÷@¸÷@¸÷@¸÷@¸÷@¸÷@¸÷@ìì@¼÷@¼÷@¼÷@¼÷@¼÷@¼÷@¼÷@ðì@0Ã@2Å@þÿÿÿôÊ@üÊ@Ë@ Ë@aýñaý…aý 8ËéM`ýXËÙpËÑ©`11Q`0ýay`0ý¥Y`0ý)˜Ë `-]`0ý]i`0ý‘í`1Áp}õ€1ùÀËÌË-ØËEI`?iåc¶ý]³­A`°ý9Ua2ýå]`0ý5q`0ýqIa´ý!1`0ý=å`1ÍèË¿ `!A`0ý=!Ì?"`q"%`?…"`6ýÝ"•`51#•`5…#‰`5Ñ#¹`2ý-$}`0ým$8Ì%`!%%`E%pÌ¿%`Õ%a`0ý&a`3M&©`5©&Y`1ñ&˜Ì]'`}'9`?¡'ÀÌ#*`Q*I`0ý*ñö,…`0ýM,-`?i,-`?…,E`0ý¹,i`uýõ,5`ý-A`?1- a3Á-]`0ýñ-‘`0ý9.Ù`6ý¥.èÌ 7é`4ý7I`0ýµ7Í)8`38`I88Í 9`9`19Å`2ý¥9½`1:9`0ý-: b2ý9;b2ýI<Ýa4ýE=}`1‰=pÍÙ=`)>Å`0ý‘>˜Íå?¸Ís@`…@Åpõ@àÍ™BøÍ'D`EDA`0ýiDIò E Î9E`MEHÎFTÎÉF)`°ýÝF©r=G5`0ýYGÝa3UHQ`0ýÁH`Î7J`]JˆÎyJ-`?ÙJq`0ýEKu`1K°ÎåKA`2ý LI`19LI`1eLa`0ý¡LØÎMM`eM1`?}MU`0ý­MÏEOa`?ÁO%`?ÙOm`?!P9`?EP5tíPUc6ý™R5rQSauý!TÙa31UÝ1ÁU½`3!V=a6ýÑVý`5]W ÏÑ\@ω]`]hÏU^`q^½`3Ñ^Ï#_`-_¸ÏM_ÄÏa_ÔÏu_äÏ_½`0ýÕbôÏucÐAdqpydupµdбe)`°ýåeaa1™f`1ífe0ýyi0ÐyjrÁjHÐálò1ndÐío|нp9a3YqÕ`0ýÅq­`0ý1rMð]rMð%s˜Ð-s‘`1yså€rùs ÐÉt`PýÝtÈÐUvÙñýÉv9a3ewQ`?™wY`?ÍwØÐiy±`0ýÁyðÐÝyüÐùyÑÍz Ñ{í`3¥{ a2ý=|Ý`0ýµ|0Ñ}`Y}Xѵ~`¿~`Ý~e`0ý1a2ýµÑ_€`q€]pÙ€™r%¸Ñ¡aÕå öé‡àÑ»ˆ`͈}`? ‰t¡‰Òá½rAÒé‘ya3©’I`?Ñ’(Ò]”8Òá—XÒé™ ryšñý›Ý`0ýq›u`0ý­›Í`3!œhÒ»œ`PýÅœ)óýáe`0ý9žÒÁž¨ÒiŸ1t  u`1E  óýÍ ¡`0ý!¡¸ÒÉ£=3i¤ÈÒ§•r]§¥11¨`²ýx¶qÜqìrør0s8sPstsˆsšs¦s¼säs$tXt¤t¸tît€uÌ5$6(6,6X6\6œ6 6Ð677$7889 99t9x9úyz>>> >l>???8?°?´?¸?¼?À?Ä?È? ˜Ì0Ð0Ô0Ø0Ü0à0ä0è0ì0ð0L2P2T2X2\2`2d2h2l2Ô2Ø2(3,3|3€3È3Ì34585È5Ì5Ð566 6@6D6H6 6¤6Ô6Ø6è6ì6l7p7t7x7˜7œ7,:0:4:8:<:@:D:H:L:t:x:|:ø;ü;HŒ>à?@˜|0€0è0ì0ð0ˆ2Œ22”2044484<4@4d4D5H5€6„6˜6À6Ä6P8|8€8Œ8˜8¨8¸8¼8D:H:L:P:T:X::”:˜:¤:°:¼:È:Ô:;;Œ{<<0<4<\<`<”<˜<œd>h>l>à?ä?`¨5¬5Ü5à5”6è6p:t:Ø<Ü<plX2„2t3ì3ð3ô3Ô4Ø4Œ7Ä7È74989<9@9D9H9L9P9T9X9\9`9d9À:;;”;˜;œ; ;,<0<4<8<¬<°<(=,=0=P=T=È>Ì>Ð>Ô>Ø>¨?¬?°?€Dh0l0 0¤0¨0Ä0È0ÌpÐ1È7Ì7Ð7Ô7Ø7Ü7à7ä7Ä8È8Œ99”9˜9œ9È?Ì?Ð?Ø?Ü?<à1ä1¤2Ì2H4L4P4T4X4Ô7Ø7Ü7Ì9Ð9Ô9Ø9Ü9à9ä9<<<¸>¼>\?`? 1¸3¼3À3Ä37 7°4(1,10141@1D1H186<6@6D6´?¼?Ä?Ì?Ô?Ü?ä?ì?ô?ü?À(0 000$0,040<0D0L0T0\0d08:<:à 00P5T5h5l5p5t5x5|5€5„5ˆ5Œ55”5˜5œ5 5¤5¨5¬5°5´5¸5¼5À5Ä5È5Ì5Ð5Ô5Ø5Ü5à5ä5è5ì5ð5ô5ø5ü5666 666 6$6(6,6064686<6@6D6H6L6P6T6X6\6`6d6h6l6p6t6x6|6€6„6ˆ6Œ66”6˜6œ6 6¤6¨6¬6°6´6¸6¼6À6Ä6È6ô677$747T7`7d7h7l7ˆ7”7°<À<Ä<È<Ì<Ð<Ô<Ø<Ü<à<ä<ð<ô<ø<ü<=== === =$=(=,=0=4=8=<=@=D=H=X>\>`>d>setuptools-20.7.0/setuptools/cli.exe0000664000175000017500000020000012702524020020342 0ustar travistravis00000000000000MZÿÿ¸@ິ Í!¸LÍ!This program cannot be run in DOS mode. $YSþj292929:ôë9292‘9F29 }929`9929`929`9m29`929Rich29PELø°‹Qà  ÊNç%à@@€,ù(ˆô@à@.text]ÉÊ `.rdata` à"Î@@.dataÄ+ð@ÀQ‹D$PŠ@„ÉuùSUV+ÂW‹èD-jPès ƒÄ3ÿ3Û‰D$Æ"p…í~W뛋L$Š <\uGë <"u…ÿ~Wj\Vè ƒÄ ÷3ÿÆ\Fë3ÿ‹T$ŠˆCF;Ý|Ã…ÿ~Wj\VèV ƒÄ ÷‹D$_Æ"ÆF^][YÃì ¡€A3ĉ„$V‹´$W‹¼$Š‹Ï„Àtd$AƒÀ@PèƒÄ F^‹Œ$3Ìè! ÄÃWhŒ$ QV虫V¼,訊„$,ƒÄH@;ÇsŠ„Ét €ù t€ù uëj”$ hâ@RÆèT ƒÄ …Àt2¡â@‹ â@‹ â@‰„$ â@‰Œ$ ‰”$$ˆ„$(L$Q”$"Rè…ûÿÿ‹0‰D$ D$$PVè$úÿÿ‹øƒÄ‰|$ …ÿu Vhàá@éµS‹\$ U‹¬$,+‰D$@jPèå‹ðW‰t$èCùÿÿ‰¿ƒÄ ƒÆ;ß~‹ÿ‹L$ ‹¹Rè#ùÿÿ‰GƒÄƒÆ;û|æD$$Pè ùÿÿ‰¿ƒÄƒÆ;ï~‹L$‹¹Rèîøÿÿ‰GƒÄƒÆ;ý|惼$4]Ç[tE‹D$‹t$ PVè$¤ƒÄVhÌá@蓃À@PènƒÄ _¸^‹Œ$3ÌèsÄËL$‹T$‹D$ QRPè†üÿÿPèÀûÿÿ‹Œ$,ƒÄ_^3Ìè?ÄÃÌÌÌÌÌÌ‹D$‹L$jPQèýÿÿƒÄ Ãj hðô@èŸ3ö‰uä3À‹];Þ•À;Æu è;ÇVVVVVèÃăÈÿéÍ3À9u •À;ÆtÔ‰]SèŸY‰uüöC @uwSè*Yƒøÿtƒøþt‹ÐÁú‹ÈƒáÁá • *A빘AöA$u)ƒøÿtƒøþt‹ÈÁùƒàÁà *A븘Aö@$€tè¡ÇVVVVVè)ƒÄƒMäÿ9uäu#SèL ‹øEPVÿu S貉EäSWèÎ ƒÄÇEüþÿÿÿè ‹EäèßÃÿuèLYøAáÀ;AVj^…Àu¸ë;Æ}‹Æ£À;AjPè“ YY£¼+A…ÀujV‰5À;Aèz YY£¼+A…ÀujX^Ã3Ò¹A롼+A‰ ƒÁ ƒÂù€A|êjþ^3Ò¹AW‹ÂÁø‹… *A‹úƒçÁ狃øÿt;Æt…Àu‰1ƒÁ BùpA|Î_3À^Ãè§#€=0 Atèp!ÿ5¼+Aè× YËÿU‹ìV‹u¸A;ðr"þ`Aw‹Î+ÈÁùƒÁQèç$N €Yë ƒÆ Vÿà@^]ËÿU‹ì‹Eƒø}ƒÀPèº$‹E H €Y]ËE ƒÀ Pÿà@]ËÿU‹ì‹E¹A;Ár=`Aw` ÿÿÿ+ÁÁøƒÀPè—#Y]ÃÀ Pÿà@]ËÿU‹ì‹Mƒù‹E }` ÿÿÿƒÁQèh#Y]ÃÀ Pÿà@]ËÿU‹ìQƒeüVEüPÿu ÿuèL$‹ðƒÄ …öu9Eütèa…Àt èX‹Mü‰‹Æ^ÉÃÌÌÌÌÌÌÌÌÌÌ‹T$ ‹L$…Òti3ÀŠD$„Àuúrƒ=ˆ*Atée%W‹ùƒúr1÷Ùƒát +шƒÇƒéuö‹ÈÁàÁ‹ÈÁàÁ‹ÊƒâÁétó«…Òt ˆƒÇƒêuö‹D$_ËD$ÃÌÌÌÌÌÌ‹L$ W…É„’VS‹Ù‹t$÷Æ‹|$u Áé……ë'ŠƒÆˆƒÇƒét+„Àt/÷Æuå‹ÙÁéuaƒãtŠƒÆˆƒÇ„Àt7ƒëuí‹D$[^_Ã÷ÇtˆƒÇƒé„˜÷Çuê‹ÙÁéutˆƒÇƒëuö[^‹D$_ɃǃétŸºÿþþ~‹Ѓðÿ3‹ƒÆ©tÜ„Òt,„öt÷Âÿt ÷Âÿuĉëâÿÿ‰ëâÿ‰ë3Ò‰ƒÇ3Àƒét 3À‰ƒÇƒéuöƒã…wÿÿÿ‹D$[^_ËÿU‹ìÿuÿuÿuÿu jÿÿuè %ƒÄ]ËÿU‹ìQQS3ÛVW‰]ø9]t}‹M ;Ëu9]uqë9]tj9]u9]u`ë9]tY9]u9] uOë9] tH9]$u>9](u>‹u3À@8tHF;Ãwö€>:u5;Ëtƒ}‚õjÿujÿQè%&ƒÄF‰uë9](uÂÇEøéÎ;Ëtˆ‹u3ÿ‰]ü8tU¾PèØ%Y…ÀtFëŠé¤þÿÿ‹ÿU‹ìV‹uVèSPè?YY…Àt|èÐòÿÿƒÀ ;ðu3ÀëèÀòÿÿƒÀ@;ðu`3À@ÿ A÷F uNSW<…H Aƒ?»u Sè Y‰…ÀuFj‰F‰X‰F‰Fë ‹?‰~‰>‰^‰^N 3À_@[ë3À^]ËÿU‹ìƒ}t'V‹u ÷F tVèf ÿîÿÿƒfƒ&ƒfY^]ÃöA @tƒyt$ÿIx ‹ˆÿ¶Àë ¾ÀQPèå-YYƒøÿu ÃÿËÿU‹ìV‹ðë‹MŠEÿM èµÿÿÿƒ>ÿtƒ} ç^]ËÿU‹ìöG @SV‹ð‹Ùt2ƒu,‹Eë+ŠÿM‹Ïè}ÿÿÿCƒ>ÿuèÕƒ8*u‹Ï°?èdÿÿÿƒ}Õ^[]ËÿU‹ììx¡€A3ʼnEüS‹] V‹u3ÀW‹}ÿu¤ýÿÿ‰µ´ýÿÿ‰½Üýÿÿ‰…¸ýÿÿ‰…ðýÿÿ‰…Ìýÿÿ‰…èýÿÿ‰…Ðýÿÿ‰…Àýÿÿ‰…Èýÿÿè#÷ÿÿ…öu5èMÇ3ÀPPPPPèӃ½°ýÿÿt ‹…¬ýÿÿƒ`pýƒÈÿéÈ öF @u^Vè@ Yº˜Aƒøÿtƒøþt‹Èƒá‹ðÁþÁá µ *Aë‹ÊöA$u‘ƒøÿtƒøþt‹ÈƒàÁùÁà *Aë‹Âö@$€…gÿÿÿ3É;Ù„]ÿÿÿЉØýÿÿ‰àýÿÿ‰¼ýÿÿˆ•ïýÿÿ„Ò„ Cƒ½Øýÿÿ‰ÄýÿÿŒ ŠÂ, If90t@@;Îuô+…äýÿÿÑøë(;þu ¡A‰…äýÿÿ‹…äýÿÿëI€8t@;Îuõ+…äýÿÿ‰…àýÿÿƒ½Àýÿÿ…\‹…ðýÿÿ¨@t2©t Æ…Ôýÿÿ-ë¨t Æ…Ôýÿÿ+ë ¨tÆ…Ôýÿÿ Ç…Ðýÿÿ‹Ìýÿÿ+àýÿÿ+Ðýÿÿö…ðýÿÿ uÿµ´ýÿÿ…ØýÿÿSj èpõÿÿƒÄ ÿµÐýÿÿ‹½´ýÿÿ…ØýÿÿÔýÿÿèvõÿÿö…ðýÿÿYtö…ðýÿÿuWSj0…Øýÿÿè.õÿÿƒÄ ƒ½Èýÿÿ‹…àýÿÿtf…À~b‹µäýÿÿ‰… ýÿÿ·ÿ ýÿÿPjEôP…˜ýÿÿFPFè5ƒÄ…Àu(9…˜ýÿÿt ÿµ˜ýÿÿ…ØýÿÿMôèñôÿÿƒ½ ýÿÿYuµëƒØýÿÿÿë‹äýÿÿP…ØýÿÿèÊôÿÿYƒ½Øýÿÿ|ö…ðýÿÿtWSj …Øýÿÿè‚ôÿÿƒÄ ƒ½¼ýÿÿtÿµ¼ýÿÿ胥¼ýÿÿY‹ÄýÿÿŠˆ…ïýÿÿ„Àt‹”ýÿÿ‹½ÜýÿÿŠÐéáõÿÿ€½°ýÿÿt ‹…¬ýÿÿƒ`pý‹…Øýÿÿ‹Mü_^3Í[èìÿÿÉÃê*@ë(@)@y)@Å)@Ð)@*@D+@jThPõ@èe3ÿ‰}üEœPÿ@à@ÇEüþÿÿÿj@j ^VèuYY;Ç„£ *A‰5*Aˆë0Æ@ƒÿÆ@ ‰xÆ@$Æ@% Æ@& ‰x8Æ@4ƒÀ@‹  *AÁ;ÁrÌf9}΄ ‹EÐ;Ç„ÿ‹8X;‰Eä¾;þ|‹þÇEàë[j@j èçYY…ÀtV‹Mà  *A‰ƒ*A ë*Æ@ƒÿÆ@ ƒ`€`$€Æ@% Æ@& ƒ`8Æ@4ƒÀ@‹Ö;ÂrÒÿEà9=*A|ë‹=*Aƒeà…ÿ~m‹E䋃ùÿtVƒùþtQЍtK¨u Qÿ<à@…Àt<‹uà‹ÆÁøƒæÁæ4… *A‹E䋉ŠˆFh F Pè€*YY…À„ÉÿFÿEàCƒEä9}à|“3Û‹óÁæ5 *A‹ƒøÿt ƒøþt€N€ërÆF…ÛujöXë ‹ÃH÷ØÀƒÀõPÿ8à@‹øƒÿÿtC…ÿt?Wÿ<à@…Àt4‰>%ÿƒøu€N@ë ƒøu€Nh F Pèê)YY…Àt7ÿFë €N@ÇþÿÿÿCƒûŒgÿÿÿÿ5*Aÿ4à@3Àë3À@ËeèÇEüþÿÿÿƒÈÿècËÿU‹ì‹EV3ö;Æuè½VVVVVÇèEƒÄƒÈÿë‹@^]ËÿU‹ì‹E£P A]ËÿU‹ìì(¡€A3ʼnEüƒ¥ØüÿÿSjL…ÜüÿÿjPèåÿÿ…Øüÿÿ‰…(ýÿÿ…0ýÿÿƒÄ ‰…,ýÿÿ‰…àýÿÿ‰Üýÿÿ‰•Øýÿÿ‰Ôýÿÿ‰µÐýÿÿ‰½ÌýÿÿfŒ•øýÿÿfŒìýÿÿfŒÈýÿÿfŒ…ÄýÿÿfŒ¥ÀýÿÿfŒ­¼ýÿÿœ…ðýÿÿ‹EMÇ…0ýÿÿ‰…èýÿÿ‰ôýÿÿ‹Iü‰äýÿÿÇ…ØüÿÿÀÇ…Üüÿÿ‰…äüÿÿÿXà@j‹ØÿTà@…(ýÿÿPÿPà@…Àu …Ûujèé1YhÀÿLà@PÿHà@‹Mü3Í[è(èÿÿÉËÿU‹ìÿ5P Aè&Y…Àt]ÿàjèª1Y]é²þÿÿ‹ÿU‹ì‹E3É;ÍØAtAƒù-rñHíƒùwj X]ËÍÜA]ÃDÿÿÿjY;ÈÀ#ÁƒÀ]Ã蜅Àu¸@AÃÀÃ艅Àu¸DAÃÀ ËÿU‹ìVèâÿÿÿ‹MQ‰è‚ÿÿÿY‹ðè¼ÿÿÿ‰0^]ÃÌÌÌhÐ7@dÿ5‹D$‰l$l$+àSVW¡€A1Eü3ÅP‰eèÿuø‹EüÇEüþÿÿÿ‰EøEðd£Ã‹Mðd‰ Y__^[‹å]QÃÌÌÌÌÌÌÌ‹ÿU‹ìƒìS‹] V‹s35€AW‹ÆEÿÇEô{ƒøþt ‹NÏ3 8èÙæÿÿ‹N ‹FÏ3 8èÉæÿÿ‹Eö@f…‹MUè‰Sü‹[ ‰Eè‰Mìƒûþt_I[‹L†D†‰Eð‹‰Eø…Ét‹×è$1ÆEÿ…À|@G‹Eø‹Øƒøþu΀}ÿt$‹ƒøþt ‹NÏ3 8èVæÿÿ‹N ‹VÏ3 :èFæÿÿ‹Eô_^[‹å]ÃÇEôëÉ‹M9csmàu)ƒ=Œ*At hŒ*Aèƒ!ƒÄ…Àt‹UjRÿŒ*AƒÄ‹M èÇ0‹E 9X th€AW‹Ó‹ÈèÊ0‹E ‹Mø‰H ‹ƒøþt ‹NÏ3 8èÃåÿÿ‹N ‹VÏ3 :è³åÿÿ‹Eð‹H‹×è]0ºþÿÿÿ9S „Rÿÿÿh€AW‹Ëèu0éÿÿÿ‹ÿU‹ìVW3öÿuèÅ0‹øY…ÿu'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuÊ‹Ç_^]ËÿU‹ìVW3öjÿu ÿuèE‹øƒÄ …ÿu'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuËÇ_^]ËÿU‹ìVW3öÿu ÿuèû0‹øYY…ÿu,9E t'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuÁ‹Ç_^]ËÿU‹ìVW3öÿuÿu ÿuèÅ2‹øƒÄ …ÿu,9Et'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿu½‹Ç_^]Ãj hpõ@è×üÿÿ‹u…ötuƒ=„*AuCjèYƒeüVè×2Y‰Eä…Àt VPèø2YYÇEüþÿÿÿè ƒ}äu7ÿuë jèYÃVjÿ5t)Aÿ`à@…Àuè üÿÿ‹ðÿ\à@PèÐûÿÿ‰Yè›üÿÿÃjhõ@èIüÿÿ3Û‰]äjè–Y‰]üj_‰}à;=À;A}W‹÷Á桼+AÆ9tD‹ö@ ƒtPèj=YƒøÿtÿEäƒÿ|(¡¼+A‹ƒÀ PÿDà@¡¼+Aÿ4èýþÿÿY¡¼+A‰GëžÇEüþÿÿÿè ‹EäèüÿÿÃjè7YËÿU‹ìSV‹u‹F ‹È€á3Û€ùu@©t9‹FW‹>+ø…ÿ~,WPVèeùÿÿYPè‡DƒÄ ;Çu‹F „Àyƒàý‰F ëƒN ƒËÿ_‹Fƒf‰^‹Ã[]ËÿU‹ìV‹u…öu Vè5Yë/Vè|ÿÿÿY…ÀtƒÈÿë÷F @tVèüøÿÿPèûDY÷ØYÀë3À^]Ãjh°õ@èúúÿÿ3ÿ‰}ä‰}ÜjèDY‰}ü3ö‰uà;5À;Aƒ¡¼+A°98t^‹ö@ ƒtVPVèDÝÿÿYY3ÒB‰Uü¡¼+A‹°‹H öÁƒt/9UuPèJÿÿÿYƒøÿtÿEäë9}uöÁtPè/ÿÿÿYƒøÿu E܉}üèFë„3ÿ‹uࡼ+Aÿ4°VèMÝÿÿYYÃÇEüþÿÿÿèƒ}‹Eät‹EÜè{úÿÿÃjè­YÃjèÿÿÿYËÿVW3ö¿X Aƒ<õLAuõHA‰8h ÿ0ƒÇè}!YY…Àt Fƒþ$|Ò3À@_^Ã$õHA3Àëñ‹ÿS‹Dà@V¾HAW‹>…ÿtƒ~t WÿÓWèÐüÿÿƒ&YƒÆþhA|ܾHA_‹…Àt ƒ~uPÿÓƒÆþhA|æ^[ËÿU‹ì‹Eÿ4ÅHAÿà@]Ãj hØõ@è^ùÿÿ3ÿG‰}ä3Û9t)Auè´jèhÿè€ãÿÿYY‹u4õHA9t‹Çënjè ûÿÿY‹ø;ûuèÅøÿÿÇ 3ÀëQj èYY‰]ü9u,h Wèt YY…ÀuWèþûÿÿYèøÿÿÇ ‰]äë ‰>ëWèãûÿÿYÇEüþÿÿÿè ‹EäèöøÿÿÃj è(ÿÿÿYËÿU‹ì‹EV4ÅHAƒ>uPè"ÿÿÿY…ÀujètâÿÿYÿ6ÿà@^]Ãj høõ@èhøÿÿ‹M3ÿ;Ïv.jàX3Ò÷ñ;E À@uèÿ÷ÿÿÇ WWWWWè‡÷ÿÿƒÄ3ÀéÕ¯M ‹ñ‰u;÷u3öF3Û‰]äƒþàwiƒ=„*AuKƒÆƒæð‰u ‹E;p*Aw7jèLÿÿÿY‰}üÿuèè5Y‰EäÇEüþÿÿÿè_‹]ä;ßtÿuWSè6ÛÿÿƒÄ ;ßuaVjÿ5t)Aÿdà@‹Ø;ßuL9=€)At3Vè’Y…À…rÿÿÿ‹E;Ç„PÿÿÿÇ éEÿÿÿ3ÿ‹u jèðýÿÿYÃ;ßu ‹E;ÇtÇ ‹Ãèœ÷ÿÿÃU‹ìƒì‰}ü‹}‹M ÁéfïÀë¤$ffGfG fG0fG@fGPfG`fGp¿€IuЋ}ü‹å]ÃU‹ìƒì‰}ü‹E™‹ø3ú+úƒç3ú+ú…ÿu<‹M‹Ñƒâ‰Uô;Êt+ÊQPèsÿÿÿƒÄ‹E‹Uô…ÒtEE+‰Eø3À‹}ø‹Môóª‹Eë.÷߃lj}ð3À‹}‹Mðóª‹Eð‹M‹UÈ+ÐRjQè~ÿÿÿƒÄ ‹E‹}ü‹å]Ãj hö@èdöÿÿƒeüf(ÁÇEäë#‹Eì‹‹=Àt =Àt3ÀÃ3À@ËeèƒeäÇEüþÿÿÿ‹EäèföÿÿËÿU‹ìƒì3ÀS‰Eü‰Eô‰EøSœX‹È5 PœZ+ÑtQ3À¢‰Eô‰]è‰Uì‰M𸢉Uü‰Eø[÷Eütè\ÿÿÿ…Àt3À@ë3À[ÉÃè™ÿÿÿ£ˆ*A3ÀËÿU‹ìQSV‹u3ÛW;ót9] w èIõÿÿjYSSSSS‹ñ‰èÐôÿÿƒÄ‹ÆéÍ‹E3ÿ;ÃtŠ:Ãtj_9} †ˆFÆ:F‹M‹Á;Ët@8t<ë‹}ü‹U G‰}ü;úsyŠˆF@8uèPQèŒ@ŠYYŠˆF@8uð‹E;Ãt'Š:Ët!€ù.tG;} sÆ.Fë G;} sŠˆF@8uðG;} v‹Eˆèlôÿÿj"éÿÿÿˆ3À_^[ÉËÿU‹ìƒìÿuMðèÜÿÿ¶E ‹MôŠU„Tuƒ}t‹Mð‹‰È·A#Eë3À…Àt3À@€}üt‹MøƒapýÉËÿU‹ìjjÿuÿu è™ÿÿÿƒÄ]ËÿU‹ìjjÿujèÿÿÿƒÄ]ËÿU‹ìjÿuÿuÿu ÿuè…?ƒÄ]ËÿU‹ìì(£°"A‰ ¬"A‰¨"A‰¤"A‰5 "A‰=œ"AfŒÈ"AfŒ ¼"AfŒ˜"AfŒ”"AfŒ%"AfŒ-Œ"AœÀ"A‹E£´"A‹E£¸"AE£Ä"A‹…àüÿÿÇ"A¡¸"A£´!AǨ!A ÀǬ!A¡€A‰…Øüÿÿ¡„A‰…ÜüÿÿÿXà@£ø!AjèO$YjÿTà@hÔâ@ÿPà@ƒ=ø!Aujè+$Yh ÀÿLà@PÿHà@ÉÃ-¤t"ƒètƒè t Ht3ÀøøøøËÿVW‹ðh3ÿFWPè+Öÿÿ3À·È‹Á‰~‰~‰~ Áá Á~«««¹hAƒÄ F+οŠˆ@Ou÷†¾Šˆ@Nu÷_^ËÿU‹ìì¡€A3ʼnEüSW…èúÿÿPÿvÿhà@¿…À„û3Àˆ„üþÿÿ@;ÇrôŠ…îúÿÿÆ…üþÿÿ „Àt.ïúÿÿ¶È¶;Èw+Á@P” üþÿÿj RèhÕÿÿƒÄ CŠC„ÀuØjÿv …üúÿÿÿvPW…üþÿÿPjjèE3ÛSÿv…üýÿÿWPW…üþÿÿPWÿv SèúBƒÄDSÿv…üüÿÿWPW…üþÿÿPhÿv SèÕBƒÄ$3À·ŒEüúÿÿöÁt€LŠŒüýÿÿëöÁt€L ŠŒüüÿÿˆŒëÆ„@;Çr¾ëV†Ç…äúÿÿŸÿÿÿ3É)…äúÿÿ‹•äúÿÿ„ÐZ ƒûw €LŠÑ€Â ëƒúw€L ŠÑ€ê ˆëÆA;Ïr‹Mü_3Í[èOØÿÿÉÃj h8ö@èÏðÿÿè˜ ‹ø¡ŒA…Gptƒlt‹wh…öuj èžÚÿÿY‹ÆèçðÿÿÃj èó÷ÿÿYƒeü‹wh‰uä;5At6…ötVÿpà@…ÀuþhAtVè‡óÿÿY¡A‰Gh‹5A‰uäVÿlà@ÇEüþÿÿÿè뎋uäj è¸öÿÿYËÿU‹ìƒìS3ÛSMðè¤×ÿÿ‰Ì$AƒþþuÇÌ$Aÿxà@8]ütE‹Møƒapýë<ƒþýuÇÌ$Aÿtà@ëÛƒþüu‹Eð‹@ÇÌ$AëÄ8]üt‹Eøƒ`pý‹Æ[ÉËÿU‹ìƒì ¡€A3ʼnEüS‹] V‹uWèdÿÿÿ‹ø3ö‰};þu‹Ãè·üÿÿ3Àé‰uä3À9¸˜A„‘ÿEäƒÀ0=ðrçÿèý„pÿéý„d·ÇPÿ|à@…À„REèPWÿhà@…À„3hCVPèˆÒÿÿ3ÒBƒÄ ‰{‰s 9Uè†ø€}î„ÏuɄ¶Fÿ¶Éé¦hCVPèAÒÿÿ‹MäƒÄ kÉ0‰u౨A‰uäë*ŠF„Àt(¶>¶Àë‹EàŠ€”AD;¶FG;øvê‹}FF€>uÑ‹uäÿEàƒÆƒ}à‰uäré‹Ç‰{ÇCègûÿÿj‰C C‰œAZf‹1Af‰0A@@Juó‹óè×ûÿÿé·þÿÿ€L@;ÁvöFF€~ÿ…4ÿÿÿC¹þ€@Iuù‹Cèûÿÿ‰C ‰Së‰s3À·È‹ÁÁá Á{«««ë¨95Ì$A…XþÿÿƒÈÿ‹Mü_^3Í[èJÕÿÿÉÃjhXö@èÊíÿÿƒMàÿè‹ø‰}ÜèÜüÿÿ‹_h‹uèuýÿÿ‰E;C„Wh è‚ïÿÿY‹Ø…Û„F¹ˆ‹wh‹ûó¥ƒ#Sÿuè¸ýÿÿYY‰Eà…À…ü‹uÜÿvhÿpà@…Àu‹Fh=hAtPècðÿÿY‰^hS‹=là@ÿ×öFp…êöŒA…Ýj ètôÿÿYƒeü‹C£Ü$A‹C£à$A‹C £ä$A3À‰Eäƒø}f‹LCf‰ EÐ$A@ëè3À‰Eä=} ŠLˆˆˆA@ëé3À‰Eä=}ŠŒˆˆA@ëæÿ5Aÿpà@…Àu¡A=hAtPèªïÿÿY‰ASÿ×ÇEüþÿÿÿèë0j èíòÿÿYÃë%ƒøÿu ûhAtSètïÿÿYèìÿÿÇëƒeà‹Eàè‚ìÿÿÃ=°+AujýèVþÿÿYǰ+A3ÀËÿU‹ìSV‹u‹†¼3ÛW;Ãto=HAth‹†°;Ãt^9uZ‹†¸;Ãt9uPèûîÿÿÿ¶¼è;AYY‹†´;Ãt9uPèÚîÿÿÿ¶¼èÕ@YYÿ¶°èÂîÿÿÿ¶¼è·îÿÿYY‹†À;ÃtD9u@‹†Ä-þPè–îÿÿ‹†Ì¿€+ÇPèƒîÿÿ‹†Ð+ÇPèuîÿÿÿ¶ÀèjîÿÿƒÄ¾Ô‹=ˆAt9˜´uPè»>ÿ7èCîÿÿYY~PÇEøAt‹;Ãt 9uPèîÿÿY9_üt‹G;Ãt 9uPèîÿÿYƒÇÿMuÇVèøíÿÿY_^[]ËÿU‹ìSV‹5là@W‹}WÿÖ‹‡°…ÀtPÿÖ‹‡¸…ÀtPÿÖ‹‡´…ÀtPÿÖ‹‡À…ÀtPÿÖ_PÇE{øAt ‹…ÀtPÿÖƒ{üt ‹C…ÀtPÿÖƒÃÿMuÖ‹‡Ô´PÿÖ_^[]ËÿU‹ìW‹}…ÿ„ƒSV‹5pà@WÿÖ‹‡°…ÀtPÿÖ‹‡¸…ÀtPÿÖ‹‡´…ÀtPÿÖ‹‡À…ÀtPÿÖ_PÇE{øAt ‹…ÀtPÿÖƒ{üt ‹C…ÀtPÿÖƒÃÿMuÖ‹‡Ô´PÿÖ^[‹Ç_]Ã…ÿt7…Àt3V‹0;÷t(W‰8èÁþÿÿY…ötVèEÿÿÿƒ>Yuþ˜AtVèYýÿÿY‹Ç^Ã3ÀÃj hxö@ècéÿÿè,‹ð¡ŒA…Fpt"ƒ~ltè‹pl…öuj è-ÓÿÿY‹ÆèvéÿÿÃj è‚ðÿÿYƒeüFl‹=pAèiÿÿÿ‰EäÇEüþÿÿÿèëÁj è}ïÿÿY‹uäËÿU‹ìVÿ5„A‹5€à@ÿÖ…Àt!¡€AƒøÿtPÿ5„AÿÖÿÐ…Àt‹€øë'¾tã@Vÿ à@…Àu VènÒÿÿY…Àthdã@Pÿ(à@…ÀtÿuÿЉE‹E^]Ãjè‡ÿÿÿYËÿU‹ìVÿ5„A‹5€à@ÿÖ…Àt!¡€AƒøÿtPÿ5„AÿÖÿÐ…Àt‹€üë'¾tã@Vÿ à@…Àu VèóÑÿÿY…Àthã@Pÿ(à@…ÀtÿuÿЉE‹E^]Ãÿ„à@‹ÿVÿ5„Aÿ€à@‹ð…öuÿ5%AèeÿÿÿY‹ðVÿ5„Aÿˆà@‹Æ^á€AƒøÿtPÿ5%Aè;ÿÿÿYÿЃ €Aÿ¡„AƒøÿtPÿŒà@ƒ „Aÿéºíÿÿj h˜ö@è†çÿÿ¾tã@Vÿ à@…ÀuVè4ÑÿÿY‰Eä‹uÇF\é@3ÿG‰~…Àt$hdã@P‹(à@ÿÓ‰†øhã@ÿuäÿÓ‰†ü‰~pƆÈCƆKCÇFhhAj ènîÿÿYƒeüÿvhÿlà@ÇEüþÿÿÿè>j èMîÿÿY‰}ü‹E ‰Fl…Àu¡pA‰FlÿvlèüÿÿYÇEüþÿÿÿèè çÿÿÃ3ÿG‹uj è5íÿÿYÃj è,íÿÿYËÿVWÿ\à@ÿ5€A‹øè‘þÿÿÿЋð…öuNhjè±èÿÿ‹ðYY…öt:Vÿ5€Aÿ5%AèèýÿÿYÿÐ…ÀtjVèÅþÿÿYYÿ”à@ƒNÿ‰ë Vè^éÿÿY3öWÿà@_‹Æ^ËÿVèÿÿÿ‹ð…öujèÐÿÿY‹Æ^ÃjhÀö@è æÿÿ‹u…ö„ø‹F$…ÀtPèéÿÿY‹F,…ÀtPèéÿÿY‹F4…ÀtPèõèÿÿY‹F<…ÀtPèçèÿÿY‹F@…ÀtPèÙèÿÿY‹FD…ÀtPèËèÿÿY‹FH…ÀtPè½èÿÿY‹F\=é@tPè¬èÿÿYj èàìÿÿYƒeü‹~h…ÿtWÿpà@…ÀuÿhAtWèèÿÿYÇEüþÿÿÿèWj è§ìÿÿYÇEü‹~l…ÿt#WèóúÿÿY;=pAtÿ˜At ƒ?uWèÿøÿÿYÇEüþÿÿÿèVè'èÿÿYèIåÿÿ‹uj èvëÿÿYËuj èjëÿÿYËÿVW¾tã@Vÿ à@…ÀuVè“ÎÿÿY‹ø…ÿ„^‹5(à@hÀã@WÿÖh´ã@W£ %AÿÖh¨ã@W£%AÿÖh ã@W£%AÿÖƒ= %A‹5ˆà@£%Atƒ=%At ƒ=%At…Àu$¡€à@£%A¡Œà@Ç %AdO@‰5%A£%Aÿ„à@£„Aƒøÿ„Ìÿ5%APÿÖ…À„»èÅÐÿÿÿ5 %Aèûÿÿÿ5%A£ %Aèûÿÿÿ5%A£%Aèóúÿÿÿ5%A£%AèãúÿÿƒÄ£%Aè¬éÿÿ…ÀtehXQ@ÿ5 %Aè=ûÿÿYÿУ€AƒøÿtHhjèÓåÿÿ‹ðYY…öt4Vÿ5€Aÿ5%Aè ûÿÿYÿÐ…ÀtjVèçûÿÿYYÿ”à@ƒNÿ‰3À@ëè’ûÿÿ3À_^ËÿU‹ìƒìSÿuMèèÉÊÿÿ‹]C=w‹E苀ȷXëu‰]Á}EèP‹E%ÿPèGYY…ÀtŠEjˆEøˆ]ùÆEúYë 3Ɉ]øÆEùA‹EèjÿpÿpEüPQEøPEèjPè6ƒÄ …Àu8Eôt‹Eðƒ`pý3Àë·Eü#E €}ôt‹Mðƒapý[ÉËÿU‹ìQV‹u Vèwàÿÿ‰E ‹F Y¨‚uè8âÿÿÇ ƒN ƒÈÿé/¨@t èâÿÿÇ"ëãS3Û¨t‰^¨„‡‹Nƒàþ‰‰F ‹F ƒàïƒÈ‰F ‰^‰]ü© u,è—ÃÿÿƒÀ ;ðt è‹ÃÿÿƒÀ@;ðu ÿu è©Y…ÀuVè¾?Y÷F W„€‹F‹>H‰‹N+øI;û‰N~WPÿu èÜ*ƒÄ ‰EüëMƒÈ ‰F ƒÈÿëy‹M ƒùÿtƒùþt‹Áƒà‹ÑÁúÁà• *A븘Aö@ tjSSQè*>#ƒÄƒøÿt%‹FŠMˆë3ÿGWEPÿu èm*ƒÄ ‰Eü9}üt ƒN ƒÈÿë‹E%ÿ_[^ÉËÿU‹ìQQS‹]VW3ö3ÿ‰}ü;ýˆAt G‰}üƒÿrîƒÿƒwjèz@Yƒø„4jèi@Y…Àu ƒ=ŒA„ûü„Ahpé@»S¿ %AWè08ƒÄ …Àt VVVVVèØÞÿÿƒÄh¾9%AVjÆ=&Aÿà@…Àu&hXé@hûVèî7ƒÄ …Àt3ÀPPPPPè”ÞÿÿƒÄVè‡@YƒøYƒøtjèñ>Y…Àuƒ=ŒAuhüè)þÿÿhÿèþÿÿYYËÿU‹ìQSVWÿ5¬+AèÊöÿÿÿ5¨+A‹ø‰}üèºöÿÿ‹ðYY;÷‚ƒ‹Þ+ßCƒørwWèÕ>‹øCY;øsH¸;øs‹ÇÇ;ÇrPÿuüèsáÿÿYY…ÀuG;Çr@Pÿuüè]áÿÿYY…Àt1ÁûP4˜èÕõÿÿY£¬+AÿuèÇõÿÿ‰ƒÆVè¼õÿÿY£¨+A‹EYë3À_^[ÉËÿVjj èÇàÿÿ‹ðVè•õÿÿƒÄ £¬+A£¨+A…öujX^Ã&3À^Ãj hèö@èeÞÿÿèÀÈÿÿƒeüÿuèøþÿÿY‰EäÇEüþÿÿÿè ‹EäèÞÿÿÃèŸÈÿÿËÿU‹ìÿuè·ÿÿÿ÷ØÀ÷ØYH]ËÿV¸àô@¾àô@W‹ø;Æs‹…ÀtÿЃÇ;þrñ_^ËÿV¸èô@¾èô@W‹ø;Æs‹…ÀtÿЃÇ;þrñ_^ËÿVW3ÿ·@Aÿ6èÆôÿÿƒÇY‰ƒÿ(rè_^ÃÌ‹ÿU‹ì‹M¸MZf9t3À]ËA<Á8PEuï3Ò¹ f9H”‹Â]ÃÌÌÌÌÌÌÌÌÌÌÌ‹ÿU‹ì‹E‹H<È·ASV·q3ÒWD…öv‹} ‹H ;ùr ‹XÙ;ûr BƒÀ(;Örè3À_^[]ÃÌÌÌÌÌÌÌÌÌÌÌÌ‹ÿU‹ìjþh÷@hÐ7@d¡PƒìSVW¡€A1Eø3ÅPEðd£‰eèÇEüh@è*ÿÿÿƒÄ…ÀtU‹E-@Ph@èPÿÿÿƒÄ…Àt;‹@$Áè÷ЃàÇEüþÿÿÿ‹Mðd‰ Y_^[‹å]ËEì‹‹3Ò=À”‹ÂËeèÇEüþÿÿÿ3À‹Mðd‰ Y_^[‹å]Ãjh(÷@èWÜÿÿè öÿÿ‹@x…ÀtƒeüÿÐë3À@ËeèÇEüþÿÿÿè—<èpÜÿÿÃh [@è'óÿÿY£4(AÃËÿU‹ìQQVè`õÿÿ‹ð…ö„F‹V\¡tAW‹}‹ÊS99t‹ØkÛ ƒÁ Ú;ËrîkÀ Â;Ès99u‹Áë3À…Àt ‹X‰]ü…Ûu3Àéûƒûu ƒ`3À@éêƒû„Þ‹N`‰Mø‹M ‰N`‹Hƒù…¸‹ hA‹=lA‹Ñù;×}$kÉ ‹~\ƒd9‹=hA‹lAB߃Á ;Ó|â‹]ü‹‹~d=ŽÀu ÇFdƒë^=Àu ÇFdëN=‘Àu ÇFd„ë>=“Àu ÇFd…ë.=Àu ÇFd‚ë=Àu ÇFd†ë=’ÀuÇFdŠÿvdjÿÓY‰~dëƒ`QÿÓ‹EøY‰F`ƒÈÿ[_^ÉËÿU‹ì‹E£8(A£<(A£@(A£D(A]ËÿU‹ì‹E‹ tAV9Pt‹ñkö uƒÀ ;ÆrìkÉ M^;Ás9Pt3À]Ãÿ5@(AèÚñÿÿYÃj hH÷@èJÚÿÿ3ÿ‰}ä‰}Ø‹]ƒû Lt‹ÃjY+Át"+Át+Átd+ÁuDèsóÿÿ‹ø‰}Ø…ÿuƒÈÿéa¾8(A¡8(Aë`ÿw\‹Óè]ÿÿÿ‹ðƒÆ‹ëZ‹Ãƒèt<ƒèt+HtèŽÙÿÿÇ3ÀPPPPPèÙÿÿƒÄ뮾@(A¡@(Aë¾<(A¡<(Aë ¾D(A¡D(AÇEäPèñÿÿ‰EàY3Àƒ}à„Ø9EàujèòÅÿÿ9EätPèÆàÿÿY3À‰Eüƒût ƒû tƒûu‹O`‰MÔ‰G`ƒûu@‹Od‰MÐÇGdŒƒûu.‹ hA‰MÜ‹ lA‹hAÊ9MÜ}‹MÜkÉ ‹W\‰DÿEÜëÛè~ðÿÿ‰ÇEüþÿÿÿèƒûuÿwdSÿUàYë‹]‹}؃}ätjèTßÿÿYÃSÿUàYƒût ƒû tƒûu‹EÔ‰G`ƒûu‹EЉGd3ÀèìØÿÿËÿU‹ì‹E£L(A]ËÿU‹ì‹E£X(A]ËÿU‹ì‹E£\(A]Ãjhh÷@èmØÿÿƒeüÿu ÿuÿ à@‰Eäë/‹Eì‹‹‰Eà3É=À”Á‹ÁËeè}àÀujÿà@ƒeäÇEüþÿÿÿ‹Eäè_ØÿÿËÿU‹ì‹E£`(A]ËÿU‹ìÿ5`(Aè|ïÿÿY…ÀtÿuÿÐY…Àt3À@]Ã3À]ËÿU‹ì‹E‹8csmàu*ƒxu$‹@= “t=!“t="“t=@™uèCûÿÿ3À]ÂhŽ_@ÿTà@3ÀÃ=°+AuèHëÿÿV‹5< AW3ÿ…öuƒÈÿé <=tGVèƒYtŠ„ÀuêjGWè€Ùÿÿ‹øYY‰= A…ÿtË‹5< ASëBVèR‹ØC€>=Yt1jSèRÙÿÿYY‰…ÀtNVSPè|.ƒÄ …Àt3ÀPPPPPè"ÕÿÿƒÄƒÇó€>u¹ÿ5< AèÚÿÿƒ%< Aƒ'Ǥ+A3ÀY[_^Ãÿ5 AèÝÙÿÿƒ% AƒÈÿëä‹ÿU‹ìQ‹MS3ÀV‰‹ò‹U Ç9Et ‹]ƒE‰‰Eü€>"u3À9Eü³"”ÀF‰Eüë<ÿ…ÒtŠˆB‰U жÃPFèâÿÿY…Àtÿƒ} t ‹M ŠÿE ˆF‹U ‹M„Ût2ƒ}üu©€û t€û uŸ…ÒtÆBÿƒeü€>„éŠ< t< uFëóNëã€>„Ѓ}t ‹EƒE‰ÿ3ÛC3ÉëFA€>\tù€>"u&öÁuƒ}üt F€8"u‹ðë 3À3Û9Eü”À‰EüÑé…ÉtI…ÒtÆ\Bÿ…Éuñ‰U Š„ÀtUƒ}üu< tK< tG…Ût=¾ÀP…Òt#è9áÿÿY…Àt Š‹M ÿE ˆFÿ‹M ŠÿE ˆë èáÿÿY…ÀtFÿÿ‹U FéVÿÿÿ…ÒtÆB‰U ÿ‹Méÿÿÿ‹E^[…Àtƒ ÿÉËÿU‹ìƒì S3ÛVW9°+AuèÄèÿÿh¾h(AVSˆl)Aÿà@¡ +A‰5( A;Ãt‰Eü8u‰uü‹UüEøPSS}ôè þÿÿ‹EøƒÄ =ÿÿÿ?sJ‹MôƒùÿsB‹øÁç;Ár6PèƒÖÿÿ‹ðY;ót)‹UüEøPþWV}ôèÉýÿÿ‹EøƒÄ H£ A‰5 A3ÀëƒÈÿ_^[ÉËÿU‹ì¡p)Aƒì SV‹5´à@W3Û3ÿ;Ãu.ÿÖ‹ø;ût Çp)Aë#ÿ\à@ƒøxu jX£p)Aë¡p)Aƒø…;ûuÿÖ‹ø;ûu3ÀéÊ‹Çf9t@@f9uù@@f9uò‹5°à@SSS+ÇSÑø@PWSS‰EôÿÖ‰Eø;Ãt/Pè©ÕÿÿY‰Eü;Ãt!SSÿuøPÿuôWSSÿÖ…Àu ÿuüè¸ÖÿÿY‰]ü‹]üWÿ¬à@‹Ãë\ƒøt;Ãu‚ÿ¨à@‹ð;ó„rÿÿÿ8t @8uû@8uö+Æ@P‰EøèBÕÿÿ‹øY;ûu Vÿ¤à@éEÿÿÿÿuøVWè©+ƒÄ Vÿ¤à@‹Ç_^[ÉËÿU‹ì3À9Ej”ÀhPÿ¸à@£t)A…Àu]Ã3À@£„*A]ËÿU‹ìƒì¡€AƒeøƒeüSW¿Næ@»»ÿÿ;Çt …Ãt ÷У„Aë`VEøPÿÌà@‹uü3uøÿÈà@3ðÿ”à@3ðÿÄà@3ðEðPÿÀà@‹Eô3Eð3ð;÷u¾Oæ@»ë …óu‹ÆÁà ð‰5€A÷Ö‰5„A^_[ÉËÿU‹ì‹EƒøþuèÒÿÿÇ 3À]ÃV3ö;Æ|;*ArèæÑÿÿVVVVVÇ ènÑÿÿƒÄ3Àë‹ÈƒàÁù‹  *AÁà¾Dƒà@^]á€AƒÈ3É9x)A”Á‹ÁÃÌÌÌÌÌÌÌÌ‹L$÷Át$ŠƒÁ„ÀtN÷Áuï¤$¤$‹ºÿþþ~Ѓðÿ3ƒÁ©tè‹Aü„Àt2„ät$©ÿt©ÿtëÍAÿ‹L$+ÁÃAþ‹L$+ÁÃAý‹L$+ÁÃAü‹L$+ÁËÿU‹ìƒìSV‹u 3ÛW‹};óu;ûv‹E;Ãt‰3À郋E;ÃtƒÿÿÿÿÿvèÇÐÿÿj^SSSSS‰0èPÐÿÿƒÄ‹ÆëVÿuMðès¸ÿÿ‹Eð9X…œf‹E¹ÿf;Áv6;ót;ûv WSVè8´ÿÿƒÄ ètÐÿÿÇ*èiÐÿÿ‹8]üt‹Møƒapý_^[ÉÃ;ót2;ûw,èIÐÿÿj"^SSSSS‰0èÒÏÿÿƒÄ8]ü„yÿÿÿ‹Eøƒ`pýémÿÿÿˆ‹E;ÃtÇ8]ü„%ÿÿÿ‹Eøƒ`pýéÿÿÿM QSWVjMQS‰] ÿpÿ°à@;Ãt9] …^ÿÿÿ‹M;Ët½‰ë¹ÿ\à@ƒøz…Dÿÿÿ;ó„gÿÿÿ;û†_ÿÿÿWSVèa³ÿÿƒÄ éOÿÿÿ‹ÿU‹ìjÿuÿuÿu ÿuè|þÿÿƒÄ]ËÿU‹ìƒìÿu Mðè:·ÿÿ¶E‹Mð‹‰È·A%€€}üt‹MøƒapýÉËÿU‹ìjÿuè¹ÿÿÿYY]ÃÌV‹D$ Àu(‹L$‹D$ 3Ò÷ñ‹Ø‹D$÷ñ‹ð‹Ã÷d$‹È‹Æ÷d$ÑëG‹È‹\$‹T$ ‹D$ÑéÑÛÑêÑØ Éuô÷ó‹ð÷d$‹È‹D$÷æÑr;T$ wr;D$v N+D$T$3Û+D$T$ ÷Ú÷؃ڋʋӋًȋÆ^ƒ%€*AÃÌÌÌSVW‹T$‹D$‹L$URPQQh i@dÿ5¡€A3ĉD$d‰%‹D$0‹X‹L$,3‹p ƒþþt;‹T$4ƒúþt;òv.4v\³‹ ‰H ƒ{uÌh‹Cè1¹‹Cè1ë°dƒÄ_^[ËL$÷A¸t3‹D$‹H3È袵ÿÿU‹hÿp ÿpÿpè>ÿÿÿƒÄ ]‹D$‹T$‰¸ÃU‹L$‹)ÿqÿqÿq(èÿÿÿƒÄ ]ÂUVWS‹ê3À3Û3Ò3ö3ÿÿÑ[_^]Ëê‹ñ‹Ájè_03À3Û3É3Ò3ÿÿæU‹ìSVWjjhÇi@Qè—Q_^[]ÃU‹l$RQÿt$è´þÿÿƒÄ ]Âj hˆ÷@èÍÿÿƒeä‹u;5p*Aw"jèÄÔÿÿYƒeüVèa Y‰EäÇEüþÿÿÿè ‹EäèÍÿÿÃjè¿ÓÿÿYËÿU‹ìV‹uƒþà‡¡SW‹=dà@ƒ=t)AuèíÿÿjèÏëÿÿhÿèM·ÿÿYY¡„*Aƒøu…öt‹Æë3À@Pëƒøu VèSÿÿÿY…Àu…öuFƒÆƒæðVjÿ5t)Aÿ׋؅Ûu.j ^9€)Atÿuè¢ôÿÿY…Àt‹ué{ÿÿÿèNÌÿÿ‰0èGÌÿÿ‰0_‹Ã[ëVè{ôÿÿYè3ÌÿÿÇ 3À^]Ãjh¨÷@èhÌÿÿ‹]…Ûuÿu èÿÿÿYéÌ‹u …öu SècÏÿÿYé·ƒ=„*A…“3ÿ‰}äƒþà‡ŠjèwÓÿÿY‰}üSè6Y‰Eà;Ç„ž;5p*AwIVSPèƒÄ …Àt‰]äë5Vèç Y‰Eä;Çt'‹CüH;Ær‹ÆPSÿuäè:$Sèæ‰EàSPè ƒÄ9}äuH;÷u3öF‰u ƒÆƒæð‰u VWÿ5t)Aÿdà@‰Eä;Çt ‹CüH;Ær‹ÆPSÿuäèæ#Sÿuà迃ÄÇEüþÿÿÿè.ƒ}àu1…öuFƒÆƒæð‰u VSjÿ5t)AÿÔà@‹øë‹u ‹]jè¨ÑÿÿYË}ä…ÿ…¿9=€)At,VèóÿÿY…À…Òþÿÿè´Êÿÿ9}àul‹ðÿ\à@Pè_ÊÿÿY‰ë_…ÿ…ƒèÊÿÿ9}àthÇ ëq…öuFVSjÿ5t)AÿÔà@‹ø…ÿuV9€)At4Vè›òÿÿY…ÀtƒþàvÍVè‹òÿÿYèCÊÿÿÇ 3ÀèÇÊÿÿÃè0Êÿÿé|ÿÿÿ…ÿuè"Êÿÿ‹ðÿ\à@PèÒÉÿÿ‰Y‹ÇëÒ‹ÿU‹ì‹M S3Û;Ëv(jà3ÒX÷ñ;EsèíÉÿÿSSSSSÇ èuÉÿÿƒÄ3ÀëA¯MVW‹ñ9]t ÿuèÈ)Y‹ØVÿuèýÿÿ‹øYY…ÿt;Þs+óVjßSèX­ÿÿƒÄ ‹Ç_^[]ËÿU‹ì‹ h*A¡l*AkÉÈë‹U+P úr ƒÀ;Árë3À]ËÿU‹ìƒì‹M‹AV‹u W‹þ+y ƒÆüÁï‹ÏiÉŒD‰Mð‹I‰MüöÁ…ÓS1‹‰Uô‹Vü‰Uø‹Uô‰] öÂutÁúJƒú?vj?Z‹K;KuB»€ƒú s‹ÊÓëL÷Ó!\¸Dþ u#‹M!ëJàÓëL÷Ó!œ¸Äþ u‹M!Y‹] ‹S‹[‹MüMô‰Z‹U ‹Z‹R‰S‰Mü‹ÑÁúJƒú?vj?Z‹]øƒã‰]ô…+uø‹]øÁûj?‰u K^;Þv‹ÞMø‹ÑÁúJ‰Mü;Öv‹Ö;Út^‹M ‹q;qu;¾€ƒû s‹ËÓî÷Ö!t¸DþLu!‹M!1ëKàÓî÷Ö!´¸ÄþLu‹M!q‹M ‹q‹I‰N‹M ‹q‹I‰N‹u ë‹]ƒ}ôu;Ú„€‹Mð Ñ‹Y‰N‰^‰q‹N‰q‹N;Nu`ŠLˆMþÁˆLƒú s%€}u‹Ê»€Óë‹M »€‹ÊÓëD¸D ë)€}uJເÓë‹M YJ຀Óê„¸Ä ‹Eü‰‰D0ü‹Eðÿ…ó¡|)A…À„Ø‹ |*A‹5¼à@h@ÁáH »€SQÿÖ‹ |*A¡|)Aº€Óê P¡|)A‹@‹ |*Aƒ¤ˆÄ¡|)A‹@þHC¡|)A‹H€yCu ƒ`þ¡|)AƒxÿueSjÿp ÿÖ¡|)Aÿpjÿ5t)Aÿ`à@‹ h*A¡|)AkÉ‹l*A+ÈLìQHQPèí+‹EƒÄ ÿ h*A;|)Avƒm¡l*A£t*A‹E£|)A‰=|*A[_^Éáx*AV‹5h*AW3ÿ;ðu4ƒÀkÀPÿ5l*AWÿ5t)AÿÔà@;Çu3Àëxƒx*A‹5h*A£l*Akö5l*AhÄAjÿ5t)Aÿdà@‰F;ÇtÇjh hWÿØà@‰F ;ÇuÿvWÿ5t)Aÿ`à@뛃Nÿ‰>‰~ÿh*A‹Fƒÿ‹Æ_^ËÿU‹ìQQ‹M‹ASV‹qW3ÛëÀC…À}ù‹ÃiÀ„0Dj?‰EøZ‰@‰@ƒÀJuôj‹ûhÁçy h€WÿØà@…ÀuƒÈÿé—p‰Uü;úwC‹Ê+ÏÁé GAƒHøÿƒˆìÿü‰üïÿÿÇ@üð‰PÇ€èðIuË‹Uü‹EøøO ‰H‰AJ ‰H‰AƒdžD3ÿG‰¼žÄŠFCŠÈþÁ„À‹EˆNCu xº€‹ËÓê÷Ò!P‹Ã_^[ÉËÿU‹ìƒì ‹M‹ASV‹uW‹} ‹×+Q ƒÆÁê‹ÊiÉŒD‰Mô‹OüƒæðI;ñ|9ü‹‰M‰]üŽUöÃ…EÙ;ó;‹MüÁùI‰Møƒù?vj?Y‰Mø‹_;_uC»€ƒù sÓë‹MøL÷Ó!\Dþ u&‹M!ëƒÁàÓë‹MøL÷Ó!œÄþ u‹M!Y‹O‹_‰Y‹O‹‰y‹M+ÎMüƒ}üŽ¥‹}ü‹M ÁÿOL1üƒÿ?vj?_‹]ôû‰]‹[‰Y‹]‰Y‰K‹Y‰K‹Y;YuWŠLˆMþÁˆLƒÿ s€}u‹Ï»€Óë‹M DD‹Ïë €}uOເÓë‹M Y„ÄO຀Óê ‹U ‹MüD2ü‰‰Lüë‹U F‰Bü‰D2øé<3Àé8/‹] )uN‰Kü\3ü‹uÁþN‰] ‰Küƒþ?vj?^öEü…€‹uüÁþNƒþ?vj?^‹O;OuB»€ƒþ s‹ÎÓët÷Ó!\Dþu#‹M!ëNàÓëL÷Ó!œÄþ u‹M!Y‹] ‹O‹w‰q‹w‹O‰q‹uuü‰uÁþNƒþ?vj?^‹Mô ñ‹y‰K‰{‰Y‹K‰Y‹K;KuWŠLˆMþÁˆLƒþ s€}u‹Î¿€Óï‹M 9DD‹Îë €}uNà¿€Óï‹M y„ÄN຀Óê ‹E‰‰Dü3À@_^[ÉËÿU‹ìƒì¡h*A‹MkÀl*AƒÁƒáð‰MðÁùSIƒù VW} ƒÎÿÓîƒMøÿë ƒÁàƒÊÿ3öÓê‰Uø‹ t*A‹Ùë‹S‹;#Uø#þ ×u ƒÃ‰];Ørè;Øu‹l*Aë‹S‹;#Uø#þ ×u ƒÃ‰];Ùrè;Ùu[ë ƒ{u ƒÃ‰];Ørð;Øu1‹l*Aë ƒ{u ƒÃ‰];Ùrð;Ùuè úÿÿ‹Ø‰]…Ûu3Àé Sè:ûÿÿY‹K‰‹Cƒ8ÿtå‰t*A‹C‹‰Uüƒúÿt‹ŒÄ‹|D#Mø#þ Ïu)ƒeü‹ÄHD‹9#Uø#þ ×uÿEü‹‘„ƒÁëç‹Uü‹ÊiÉŒD‰Mô‹LD3ÿ#Îu‹ŒÄ#Møj _ëÉG…É}ù‹Mô‹Tù‹ +Mð‹ñÁþNƒþ?‰Mø~j?^;÷„‹J;Ju\ƒÿ »€}&‹ÏÓë‹Mü|8÷Ó‰]ì#\ˆD‰\ˆDþu3‹Mì‹]! ë,OàÓë‹MüŒˆÄ|8÷Ó!þ‰]ìu ‹]‹Mì!Kë‹]ƒ}ø‹J‹z‰y‹J‹z‰y„‹Mô ñ‹y‰J‰z‰Q‹J‰Q‹J;Ju^ŠLˆM þÁƒþ ˆL}#€} u ¿€‹ÎÓï ;‹Î¿€Óï‹Mü |ˆDë)€} u Nà¿€Óï {‹Mü¼ˆÄNྀÓî 7‹Mø…Ét ‰ ‰Lüë‹Mø‹uðÑN‰ ‰L2ü‹uô‹y‰>…Éu;|)Au‹Mü; |*Auƒ%|)A‹Mü‰B_^[ÉËÿU‹ìSV‹uW3ÿƒËÿ;÷uèµ¾ÿÿWWWWWÇè=¾ÿÿƒÄ ÃëBöF ƒt7Vè(ÃÿÿV‹ØèÄ(Vè³¼ÿÿPèë'ƒÄ…À}ƒËÿë‹F;Çt PèÎÁÿÿY‰~‰~ ‹Ã_^[]Ãj hÈ÷@è—¾ÿÿƒMäÿ3À‹u3ÿ;÷•À;Çuè2¾ÿÿÇWWWWW躽ÿÿƒÄƒÈÿë öF @t ‰~ ‹Eäèš¾ÿÿÃVè– ÿÿY‰}üVè*ÿÿÿY‰EäÇEüþÿÿÿèëÕ‹uVèä ÿÿYËÿU‹ì¸äè8*¡€A3ʼnEü‹E V3ö‰…4åÿÿ‰µ8åÿÿ‰µ0åÿÿ9uu3Àéé;Æu'訽ÿÿ‰0莽ÿÿVVVVVÇè½ÿÿƒÄƒÈÿé¾SW‹}‹ÇÁø4… *A‹ƒçÁçÇŠX$ÛÐû‰µ(åÿÿˆ'åÿÿ€ût€ûu0‹M÷ÑöÁu&è?½ÿÿ3ö‰0è#½ÿÿVVVVVÇ諼ÿÿƒÄéCö@ tjjjÿuècƒÄÿuèÖêÿÿY…À„‹öD€„èëÖÿÿ‹@l3É9H…åÿÿ”ÁP‹ÿ4‰ åÿÿÿàà@…À„`3É9 åÿÿt„Û„PÿÜà@‹4åÿÿ‰…åÿÿ3À‰…<åÿÿ9E†B‰…DåÿÿŠ…'åÿÿ„À…gŠ ‹µ(åÿÿ3À€ù ”À‰… åÿÿ‹ǃx8tŠP4ˆUôˆMõƒ`8jEôPëK¾ÁPè×ìÿÿY…Àt:‹4åÿÿ+ËM3À@;Ȇ¥j…@åÿÿSPè<(ƒÄ ƒøÿ„±Cÿ…DåÿÿëjS…@åÿÿPè(ƒÄ ƒøÿ„3ÀPPjMôQj@åÿÿQPÿµåÿÿCÿ…Dåÿÿÿ°à@‹ð…ö„\j…<åÿÿPVEôP‹…(åÿÿ‹ÿ4ÿ˜à@…À„)‹…Dåÿÿ‹0åÿÿÁ9µ<åÿÿ‰…8åÿÿŒƒ½ åÿÿ„Íj…<åÿÿPjEôP‹…(åÿÿ‹ÆEô ÿ4ÿ˜à@…À„Ѓ½<åÿÿŒÏÿ…0åÿÿÿ…8åÿÿéƒ<t<u!·33Éfƒþ ”ÁCCƒ…Dåÿÿ‰µ@åÿÿ‰ åÿÿ<t<uRÿµ@åÿÿè%%Yf;…@åÿÿ…hƒ…8åÿÿƒ½ åÿÿt)j XP‰…@åÿÿèø$Yf;…@åÿÿ…;ÿ…8åÿÿÿ…0åÿÿ‹E9…Dåÿÿ‚ùýÿÿé'‹Šÿ…8åÿÿˆT4‹‰D8é3É‹Çö@€„¿‹…4åÿÿ‰@åÿÿ„Û…ʉ…<åÿÿ9M† 답(åÿÿ‹<åÿÿƒ¥Dåÿÿ+4åÿÿ…Håÿÿ;Ms9‹•<åÿÿÿ…<åÿÿŠA€ú uÿ…0åÿÿÆ @ÿ…Dåÿÿˆ@ÿ…Dåÿÿ½Dåÿÿÿr‹؅Håÿÿ+Øj…,åÿÿPS…HåÿÿP‹ÿ4ÿ˜à@…À„B‹…,åÿÿ…8åÿÿ;ÃŒ:‹…<åÿÿ+…4åÿÿ;E‚Lÿÿÿé ‰…Dåÿÿ€û…Ñ9M†M답(åÿÿ‹Dåÿÿƒ¥<åÿÿ+4åÿÿ…Håÿÿ;MsF‹•Dåÿÿƒ…Dåÿÿ·AAfƒú uƒ…0åÿÿj [f‰@@ƒ…<åÿÿƒ…<åÿÿf‰@@½<åÿÿþrµ‹Ø…Håÿÿ+Øj…,åÿÿPS…HåÿÿP‹ÿ4ÿ˜à@…À„b‹…,åÿÿ…8åÿÿ;ÃŒZ‹…Dåÿÿ+…4åÿÿ;E‚?ÿÿÿé@9M†|‹Dåÿÿƒ¥<åÿÿ+4åÿÿj…Hùÿÿ^;Ms<‹•Dåÿÿ·µDåÿÿÎfƒú uj [f‰Æµ<åÿÿµ<åÿÿf‰ƽ<åÿÿ¨r¿3öVVhU ðëÿÿQHùÿÿ+Á™+ÂÑøP‹ÁPVhéýÿ°à@‹Ø;Þ„—j…,åÿÿP‹Ã+ÆP„5ðëÿÿP‹…(åÿÿ‹ÿ4ÿ˜à@…Àt µ,åÿÿ;ÞËë ÿ\à@‰…@åÿÿ;Þ\‹…Dåÿÿ+…4åÿÿ‰…8åÿÿ;E‚ ÿÿÿë?j,åÿÿQÿuÿµ4åÿÿÿ0ÿ˜à@…Àt‹…,åÿÿƒ¥@åÿÿ‰…8åÿÿë ÿ\à@‰…@åÿÿƒ½8åÿÿulƒ½@åÿÿt-j^9µ@åÿÿuè·ÿÿÇ è·ÿÿ‰0ë?ÿµ@åÿÿè"·ÿÿYë1‹µ(åÿÿ‹öD@t‹…4åÿÿ€8u3Àë$èÖ¶ÿÿÇèÞ¶ÿÿƒ ƒÈÿë ‹…8åÿÿ+…0åÿÿ_[‹Mü3Í^èhžÿÿÉÃjhè÷@èè¶ÿÿ‹Eƒøþu袶ÿÿƒ 臶ÿÿÇ ƒÈÿé3ÿ;Ç|;*Ar!èy¶ÿÿ‰8è_¶ÿÿÇ WWWWWèçµÿÿƒÄëÉ‹ÈÁù *A‹ðƒæÁæ‹ ¾L1ƒát¿Pè9$Y‰}ü‹öD0tÿuÿu ÿuè.øÿÿƒÄ ‰EäëèüµÿÿÇ è¶ÿÿ‰8ƒMäÿÇEüþÿÿÿè ‹Eäèh¶ÿÿÃÿuèƒ$YÃjhø@è ¶ÿÿ‹Eƒøþuè³µÿÿÇ ƒÈÿéª3Û;Ã|;*Arè’µÿÿÇ SSSSSèµÿÿƒÄëЋÈÁù< *A‹ðƒæÁ拾LƒátÆPèl#Y‰]ü‹öDt1ÿuèà"YPÿäà@…Àu ÿ\à@‰Eäë‰]ä9]ätè1µÿÿ‹Mä‰èµÿÿÇ ƒMäÿÇEüþÿÿÿè ‹Eä臵ÿÿÃÿuè¢#YËÿU‹ìƒìS3Û9]uèÖ´ÿÿSSSSSÇè^´ÿÿƒÄ3ÀëjV‹u ;óuè²´ÿÿSSSSSÇè:´ÿÿƒÄë9ur3Àë>ÿuMðèVœÿÿ‹MôFÿ9YtH9Ew ¶öD uð‹Î+ȃá+ñN‹Æ8]üt‹Møƒapý^[ÉËÿU‹ìjÿu ÿuèUÿÿÿƒÄ ]ËÿU‹ìƒìS3ÛV‹u9]u;óu9] u3Àéç;ót9] wè ´ÿÿj^SSSSS‰0è’³ÿÿƒÄ‹ÆéÀ9]uˆëÉW‹};ûuˆèسÿÿj^SSSSS‰0èa³ÿÿƒÄé(ÿuMì胛ÿÿ‹Eð9XuÿuWÿu Vè£ ƒÄéLƒ}ÿ‹U ‹ÆuŠˆ@G:ËtJuó늈@G:ËtJtÿMuî9]uˆ@;Ó…È8tƒ}u5xÿ‰}ü;þrEìP‹Eü¶Pè0¿ÿÿYY…ÀtÿMü9uüsâ‹Ç+Eü¨…Ã}ÿuZ‹E ƒøv:|þ‰};þr!EìP‹E¶Pèì¾ÿÿYY…ÀtÿM9usâ‹E ‹Ï+MöÁtˆëˆ\ÿ8]øt‹Eôƒ`pýjPXéˆè·²ÿÿj"^SSSSS‰0è@²ÿÿƒÄ8]øt‹Eôƒ`pý‹Æëd‹È+΃ù|Mxþ‰};þrEìP‹E¶Pèi¾ÿÿYY…ÀtÿM9usâ‹Ç+E¨tˆèT²ÿÿ‹Èj*X‰8]øt‹Môƒapýë8]øt‹Eôƒ`pý3À_^[ÉËÿU‹ì‹E…Àtƒè8ÝÝuPèxµÿÿY]ËÿU‹ìƒì¡€A3ʼnEüSV3ÛW‹ñ9„)Au8SS3ÿGWhdê@hSÿðà@…Àt‰=„)Aëÿ\à@ƒøxu Ç„)A9]~"‹M‹EI8t@;ËuöƒÉÿ‹E+ÁH;E}@‰E¡„)Aƒø„¬;Ĥƒø…̉]ø9] u‹‹@‰E ‹5ìà@3À9]$SSÿu•ÀÿuÅPÿu ÿÖ‹ø;û„~Cjà3ÒX÷÷ƒør7D?=wèŽ#‹Ä;ÃtÇÌÌëPè äÿÿY;Ãt ÇÝ݃À‰Eôë‰]ô9]ô„>Wÿuôÿuÿujÿu ÿÖ…À„ã‹5ðà@SSWÿuôÿu ÿuÿ֋ȉMø;Ë„Â÷E t)9]„°;M§ÿuÿuWÿuôÿu ÿuÿÖé;Ë~Ejà3ÒX÷ñƒør9D =wèÏ"‹ô;ótjÇÌ̃ÆëPèJãÿÿY;Ãt ÇÝ݃À‹ðë3ö;ótAÿuøVWÿuôÿu ÿuÿðà@…Àt"SS9]uSSëÿuÿuÿuøVSÿu ÿ°à@‰EøVè¸ýÿÿYÿuôè¯ýÿÿ‹EøYéY‰]ô‰]ð9]u‹‹@‰E9] u‹‹@‰E ÿuè Y‰Eìƒøÿu3Àé!;E „ÛSSMQÿuPÿu è> ƒÄ‰Eô;ÃtÔ‹5èà@SSÿuPÿu ÿuÿÖ‰Eø;Ãu3öé·~=ƒøàw8ƒÀ=wè¹!‹ü;ûtÝÇÌ̃ÇëPè4âÿÿY;Ãt ÇÝ݃À‹øë3ÿ;ût´ÿuøSWèÀ’ÿÿƒÄ ÿuøWÿuÿuôÿu ÿuÿÖ‰Eø;Ãu3öë%ÿuEøÿuPWÿu ÿuìè‹ð‰uðƒÄ÷Þö#uøWèüÿÿYëÿuÿuÿuÿuÿu ÿuÿèà@‹ð9]ôt ÿuôèø±ÿÿY‹Eð;Ãt 9EtPèå±ÿÿY‹Æeà_^[‹Mü3Íè'–ÿÿÉËÿU‹ìƒìÿuMðè!–ÿÿÿu(Mðÿu$ÿu ÿuÿuÿuÿuÿu è(üÿÿƒÄ €}üt‹MøƒapýÉËÿU‹ìQQ¡€A3ʼnEü¡ˆ)ASV3ÛW‹ù;Ãu:EøP3öFVhdê@Vÿøà@…Àt‰5ˆ)Aë4ÿ\à@ƒøxu jX£ˆ)A롈)Aƒø„Ï;Äǃø…è‰]ø9]u‹‹@‰E‹5ìà@3À9] SSÿu•Àÿu ÅPÿuÿÖ‹ø;û„«~<ÿðÿÿw4D?=wèÒ‹Ä;ÃtÇÌÌëPèPàÿÿY;Ãt ÇÝ݃À‹Ø…Ûti?PjSèÞÿÿƒÄ WSÿuÿu jÿuÿÖ…ÀtÿuPSÿuÿøà@‰EøSèÉúÿÿ‹EøYëu3ö9]u‹‹@‰E9]u‹‹@‰EÿuèAYƒøÿu3ÀëG;EtSSMQÿu Pÿuèi‹ðƒÄ;ót܉u ÿuÿuÿu ÿuÿuÿôà@‹ø;ótVèæ¯ÿÿY‹Çeì_^[‹Mü3Íè(”ÿÿÉËÿU‹ìƒìÿuMðè"”ÿÿÿu$Mðÿu ÿuÿuÿuÿuÿu èþÿÿƒÄ€}üt‹MøƒapýÉËÿU‹ìV‹u…ö„ÿvèv¯ÿÿÿvèn¯ÿÿÿv èf¯ÿÿÿvè^¯ÿÿÿvèV¯ÿÿÿvèN¯ÿÿÿ6èG¯ÿÿÿv è?¯ÿÿÿv$è7¯ÿÿÿv(è/¯ÿÿÿv,è'¯ÿÿÿv0è¯ÿÿÿv4è¯ÿÿÿvè¯ÿÿÿv8è¯ÿÿÿv<èÿ®ÿÿƒÄ@ÿv@èô®ÿÿÿvDèì®ÿÿÿvHèä®ÿÿÿvLèÜ®ÿÿÿvPèÔ®ÿÿÿvTèÌ®ÿÿÿvXèÄ®ÿÿÿv\è¼®ÿÿÿv`è´®ÿÿÿvd謮ÿÿÿvh褮ÿÿÿvl蜮ÿÿÿvpè”®ÿÿÿvt茮ÿÿÿvxè„®ÿÿÿv|è|®ÿÿƒÄ@ÿ¶€èn®ÿÿÿ¶„èc®ÿÿÿ¶ˆèX®ÿÿÿ¶ŒèM®ÿÿÿ¶èB®ÿÿÿ¶”è7®ÿÿÿ¶˜è,®ÿÿÿ¶œè!®ÿÿÿ¶ è®ÿÿÿ¶¤è ®ÿÿÿ¶¨è®ÿÿƒÄ,^]ËÿU‹ìV‹u…öt5‹;HAtPèÝ­ÿÿY‹F;LAtPèË­ÿÿY‹v;5PAtVè¹­ÿÿY^]ËÿU‹ìV‹u…öt~‹F ;TAtPè—­ÿÿY‹F;XAtPè…­ÿÿY‹F;\AtPès­ÿÿY‹F;`AtPèa­ÿÿY‹F;dAtPèO­ÿÿY‹F ;hAtPè=­ÿÿY‹v$;5lAtVè+­ÿÿY^]ËÿU‹ì‹ES3ÛVW;Ãt‹} ;ûwè¡©ÿÿj^‰0SSSSSè*©ÿÿƒÄ‹Æë<‹u;óuˆëÚ‹Ð8tBOuø;ût BF:ËtOuó;ûuˆèZ©ÿÿj"Y‰‹ñëµ3À_^[]ÃÌÌÌÌÌÌU‹ìV3ÀPPPPPPPP‹U IŠ Àt ƒÂ«$ëñ‹uƒÉÿIƒÁŠ Àt ƒÆ£$sî‹ÁƒÄ ^ÉËÿU‹ìSV‹u3ÛW9]u;óu9] u3À_^[]Ã;ót‹} ;ûwę̀ÿÿj^‰0SSSSSèU¨ÿÿƒÄ‹ÆëÕ9]uˆëÊ‹U;Óuˆëу}ÿ‹ÆuŠ ˆ@B:ËtOuóëŠ ˆ@B:ËtOtÿMuî9]uˆ;ûu‹ƒ}ÿu‹E jPˆ\ÿXéxÿÿÿˆèR¨ÿÿj"Y‰‹ñë‚‹ÿU‹ì‹MS3ÛVW;Ët‹} ;ûwè,¨ÿÿj^‰0SSSSSèµ§ÿÿƒÄ‹Æë0‹u;óuˆëÚ‹ÑŠˆBF:ÃtOuó;ûuˆèñ§ÿÿj"Y‰‹ñëÁ3À_^[]ÃÌÌÌÌÌÌÌÌÌÌÌÌÌ‹T$‹L$÷Âu<‹:u. Àt&:au% ätÁè:Au Àt:auƒÁƒÂ äuÒ‹ÿ3ÀÃÀÑàƒÀÃ÷ÂtŠƒÂ:uçƒÁ ÀtÜ÷Ât¤f‹ƒÂ:uÎ ÀtÆ:auÅ ät½ƒÁëˆÌÌÌÌÌÌÌÌU‹ìWV‹u ‹M‹}‹Á‹ÑÆ;þv;ø‚¤ùrƒ=ˆ*AtWVƒçƒæ;þ^_u^_]é,÷ÇuÁéƒâƒùr*ó¥ÿ$•T‘@‹Çºƒér ƒàÈÿ$…h@ÿ$d‘@ÿ$è@x@¤@È@#ÑŠˆŠFˆGŠFÁéˆGƒÆƒÇƒùrÌó¥ÿ$•T‘@I#ÑŠˆŠFÁéˆGƒÆƒÇƒùr¦ó¥ÿ$•T‘@#ÑŠˆƒÆÁéƒÇƒùrˆó¥ÿ$•T‘@IK‘@8‘@0‘@(‘@ ‘@‘@‘@‘@‹DŽä‰Dä‹DŽè‰Dè‹DŽì‰Dì‹DŽð‰Dð‹DŽô‰Dô‹DŽø‰Dø‹DŽü‰Düðøÿ$•T‘@‹ÿd‘@l‘@x‘@Œ‘@‹E^_Éʈ‹E^_ÉʈŠFˆG‹E^_ÉÃIŠˆŠFˆGŠFˆG‹E^_ÉÃt1ü|9ü÷Çu$Áéƒâƒùr ýó¥üÿ$•ð’@‹ÿ÷Ùÿ$ ’@I‹Çºƒùr ƒà+Èÿ$…ô‘@ÿ$ð’@’@(’@P’@ŠF#шGƒîÁéƒïƒùr²ýó¥üÿ$•ð’@IŠF#шGŠFÁéˆGƒîƒïƒùrˆýó¥üÿ$•ð’@ŠF#шGŠFˆGŠFÁéˆGƒîƒïƒù‚Vÿÿÿýó¥üÿ$•ð’@I¤’@¬’@´’@¼’@Ä’@Ì’@Ô’@ç’@‹DމD‹DމD‹DމD‹DމD‹DŽ ‰D ‹DމD‹DމDðøÿ$•ð’@‹ÿ“@“@“@,“@‹E^_ÉÊFˆG‹E^_ÉÃIŠFˆGŠFˆG‹E^_ÉÊFˆGŠFˆGŠFˆG‹E^_ÉÃÌÌÌÌÌÌÌÌÌÌÌU‹ìV3ÀPPPPPPPP‹U IŠ Àt ƒÂ«$ëñ‹u‹ÿŠ Àt ƒÆ£$sñFÿƒÄ ^ÉËÿU‹ìQQ‹E V‹u‰Eø‹EWV‰EüèƒÏÿY;Çuèi£ÿÿÇ ‹Ç‹×ëJÿuMüQÿuøPÿá@‰Eø;Çuÿ\à@…Àt Pè[£ÿÿYëÏ‹ÆÁø‹… *AƒæÁæD0€ ý‹Eø‹Uü_^ÉÃjh(ø@èO£ÿÿƒÎÿ‰u܉uà‹Eƒøþuè£ÿÿƒ èå¢ÿÿÇ ‹Æ‹ÖéÐ3ÿ;Ç|;*Ar!èÖ¢ÿÿ‰8è¼¢ÿÿÇ WWWWWèD¢ÿÿƒÄëÈ‹ÈÁù *A‹ðƒæÁæ‹ ¾L1ƒáu&è•¢ÿÿ‰8è{¢ÿÿÇ WWWWWè¢ÿÿƒÄƒÊÿ‹Âë[PèpY‰}ü‹öD0tÿuÿuÿu ÿuè©þÿÿƒÄ‰E܉Uàëè-¢ÿÿÇ è5¢ÿÿ‰8ƒMÜÿƒMàÿÇEüþÿÿÿè ‹EÜ‹Uàè’¢ÿÿÃÿuè­YËÿU‹ìÿ Ahè¤ÿÿY‹M‰A…Àt ƒI ÇAëƒI A‰AÇA‹Aƒa‰]ËÿU‹ìƒìSVWèb¹ÿÿƒeüƒ=)A‹Ø…Žhô@ÿœà@‹ø…ÿ„*‹5(à@hôó@WÿÖ…À„P謸ÿÿÇ$äó@W£)AÿÖPè—¸ÿÿÇ$Ðó@W£”)AÿÖP肸ÿÿÇ$´ó@W£˜)AÿÖPèm¸ÿÿY£ )A…Àthœó@WÿÖPèU¸ÿÿY£œ)A¡œ)A;ÃtO9 )AtGP賸ÿÿÿ5 )A‹ð覸ÿÿYY‹ø…öt,…ÿt(ÿÖ…ÀtMøQj MìQjPÿ×…ÀtöEôu M ë9¡”)A;Ãt0Pèc¸ÿÿY…Àt%ÿЉEü…Àt¡˜)A;ÃtPèF¸ÿÿY…ÀtÿuüÿЉEüÿ5)Aè.¸ÿÿY…Àtÿuÿu ÿuÿuüÿÐë3À_^[ÉËÿU‹ì‹MV3ö;Î|ƒù~ ƒùu¡D Aë(¡D A‰ D Aëè ÿÿVVVVVÇ蚟ÿÿƒÄƒÈÿ^]ÃjhHø@è9 ÿÿ3À‹]3ÿ;ß•À;ÇuèØŸÿÿÇWWWWWè`ŸÿÿƒÄƒÈÿëSƒ=„*Au8jèU§ÿÿY‰}üSèÖÿÿY‰Eà;Çt ‹süƒî ‰uäë‹uäÇEüþÿÿÿè%9}àuSWÿ5t)Aÿá@‹ð‹ÆèùŸÿÿÃ3ÿ‹]‹uäjè#¦ÿÿYÃjè‰ÿÿYËÿU‹ìì(¡€A3ʼnEüöAVtj è3¾ÿÿYè Åÿÿ…Àtjè ÅÿÿYöA„ʉ…àýÿÿ‰Üýÿÿ‰•Øýÿÿ‰Ôýÿÿ‰µÐýÿÿ‰½ÌýÿÿfŒ•øýÿÿfŒìýÿÿfŒÈýÿÿfŒ…ÄýÿÿfŒ¥ÀýÿÿfŒ­¼ýÿÿœ…ðýÿÿ‹uE‰…ôýÿÿÇ…0ýÿÿ‰µèýÿÿ‹@üjP‰…äýÿÿ…ØüÿÿjPè:‚ÿÿ…ØüÿÿƒÄ ‰…(ýÿÿ…0ýÿÿjÇ…Øüÿÿ@‰µäüÿÿ‰…,ýÿÿÿTà@…(ýÿÿPÿPà@jèýŠÿÿÌÌÌU‹ìSVWUjjh™@ÿuèV"]_^[‹å]ËL$÷A¸t2‹D$‹Hü3Èè²…ÿÿU‹h‹P(R‹P$RèƒÄ]‹D$‹T$‰¸ÃSVW‹D$UPjþh™@dÿ5¡€A3ÄPD$d£‹D$(‹X‹p ƒþÿt:ƒ|$,ÿt;t$,v-4v‹ ³‰L$ ‰H ƒ|³uh‹D³èI‹D³è_ë·‹L$d‰ ƒÄ_^[Ã3Àd‹ y™@u‹Q ‹R 9Qu¸ÃSQ»”Aë SQ»”A‹L$ ‰K‰C‰k UQPXY]Y[ÂÿÐËÿU‹ìƒìVWÿuMì资ÿÿ‹E‹u 3ÿ;Çt‰0;÷u,èÑœÿÿWWWWWÇèYœÿÿƒÄ€}øt‹Eôƒ`pý3ÀéØ9}t ƒ}|Ƀ}$ËMìSЉ}ü~ƒ¹¬~EìP¶ÃjPèe¹ÿÿ‹MìƒÄ 닑ȶ÷Bƒà…ÀtŠGëÇ€û-uƒMë€û+uŠG‹E…ÀŒKƒø„Bƒø$9…Àu*€û0t ÇE ë4зɶÒÁá Ê9M u Hë·Ñ9U t @f¶·Éf;ËuÇ·É9M u8]üt‹Møƒapýë8]üt‹Eøƒ`pý3À^[ÉËÿU‹ìjÿu ÿuè2ÿÿÿƒÄ ]ÃÌÌÌBÿ[ä$d$3ÀŠD$S‹ØÁà‹T$÷ÂtŠ ƒÂ:ËtÏ„ÉtQ÷Âuë ØW‹ÃÁãV Ø‹ ¿ÿþþ~‹Á‹÷3Ëðùƒñÿƒðÿ3Ï3ƃÂáu%tÓ%uæ€uÄ^_[3ÀËBü:Ãt6„Àtï:ãt'„ätçÁè:Ãt„ÀtÜ:ãt„ätÔë–^_Bÿ[ÃBþ^_[ÃBý^_[ÃBü^_[Ãÿ%Ðà@‹ÿU‹ì‹US3Û;Óuè¬{ÿÿSSSSSÇè4{ÿÿƒÄƒÈÿë 8tß‹M ;ËtØ‹;ÃtÒ8tÎSQRèƒÄ []ËÿU‹ìƒì‹UV‹ujþX‰Eì‰Uä;ðuèc{ÿÿƒ èH{ÿÿÇ ƒÈÿéˆS3Û;ó|;5*Ar'è9{ÿÿ‰è{ÿÿSSSSSÇ è§zÿÿƒÄƒÈÿéQ‹ÆÁøW<… *A‹ƒæÁæÆŠHöÁuèózÿÿ‰èÙzÿÿÇ ëjúÿÿÿwP‰]ð;Ó„öÁ…ÿ9] t7Š@$ÀÐøˆEþ¾ÀHjYtHu‹Â÷Шtƒâþ‰U‹E ‰Eôé‹Â÷Шu!è‡zÿÿ‰èmzÿÿÇSSSSSèõyÿÿƒÄë4‹ÂÑè‰M;Ár‰Eÿuèz|ÿÿY‰Eô;Ãuè5zÿÿÇ è=zÿÿǃÈÿéhjSSÿuè|Öÿÿ‹‰D(‹EôƒÄ‰T,‹ÎöAHttŠI€ù tl9]tgˆ‹@ÿMÇEðÆD 8]þtN‹ŠL%€ù tC9]t>ˆ‹@ÿM€}þÇEðÆD% u$‹ŠL&€ù t9]tˆ‹@ÿMÇEðÆD& SMèQÿuP‹ÿ4ÿ,á@…À„{‹Mè;ËŒp;M‡g‹MðDö€„æ€}þ„;Ët ‹Mô€9 u€ë€ û‹]ô‹EðÉ]‰Eð;؃ЋMŠ<„®< t ˆCA‰Mé‹EðH;ÈsA€8 u AA‰MÆ ëu‰EëmÿEjEèPjEÿP‹ÿ4ÿ,á@…Àu ÿ\à@…ÀuEƒ}èt?‹öDHt€}ÿ t¹Æ ‹ŠMÿˆLë%;]ôu€}ÿ t jjÿjÿÿuèØÔÿÿƒÄ€}ÿ tÆ C‹Eð9E‚Gÿÿÿë‹Dö@u€ëŠˆC‹Ã+Eô€}þ‰Eð…Ð…À„ÈKŠ „ÉxCé†3À@¶Éëƒø;]ôrK¶ @€¹àAt芶ʾ‰àA…Éu èàwÿÿÇ*ëzA;ÈuØë@‹ÎöAHt$CƒøˆQ| Š‹ˆT%Cƒøu Š‹ˆT&C+Øë÷Ø™jRPÿuèþÓÿÿƒÄ‹Eä+]ôÑèPÿu Sÿuôjhéýÿìà@‰Eð…Àu4ÿ\à@Pè…wÿÿYƒMìÿ‹Eô;E tPèµzÿÿY‹Eìƒøþ…‹‹Eð郋Eð‹3É;ÕÁÀ‰Eð‰L0ëÆ;Ët‹Môfƒ9 u€ë€ û‹]ô‹EðÉ]‰Eð;؃ÿ‹E·fƒù„×fƒù tf‰ CC@@‰Eé´‹MðƒÁþ;ÁsHfƒ9 u ƒÀ‰Ej 鎉M鄃EjEèPjEøP‹ÿ4ÿ,á@…Àu ÿ\à@…Àu[ƒ}ètU‹öDHt(fƒ}ø t²j Xf‰‹ŠMøˆL‹ŠMùˆL%‹ÆD& ë*;]ôufƒ}ø t…jjÿjþÿuèšÒÿÿƒÄfƒ}ø tj Xf‰CC‹Eð9E‚ÿÿÿë‹tö@u€ëf‹f‰CC+]ô‰]ðé‘þÿÿÿ\à@j^;ÆuèÙuÿÿÇ èáuÿÿ‰0éiþÿÿƒøm…Yþÿÿ‰]ìé\þÿÿ3À_[^ÉÃjhðø@èïuÿÿ‹Eƒøþuè©uÿÿƒ èŽuÿÿÇ ƒÈÿé¾3ö;Æ|;*Ar!è€uÿÿ‰0èfuÿÿÇ VVVVVèîtÿÿƒÄëÉ‹ÈÁù *A‹øƒçÁç‹ ¾L9ƒát¿¹ÿÿÿ;MÉAuè2uÿÿ‰0èuÿÿÇë°PèãÿÿY‰uü‹öD8tÿuÿu ÿuè~ùÿÿƒÄ ‰EäëèâtÿÿÇ èêtÿÿ‰0ƒMäÿÇEüþÿÿÿè ‹EäèNuÿÿÃÿuèiãÿÿYËÿU‹ìƒì0S3ÛöE€VW‹ð‰]àˆ]þÇEÐ ‰]Ôt ‰]ØÆEÿë ÇE؈]ÿEàPè Y…Àt SSSSSèÒrÿÿƒÄ‹M¸€…Èu÷Á@u9Eàt€Mÿ€‹Áƒà+úÀ¿€tGHt.Ht&è7tÿÿ‰ƒÿètÿÿj^SSSSS‰0è£sÿÿƒÄé‰UøëöÁt÷ÁuîÇEø@ë‰}ø‹EjY+Át7+Át*+Át+Átƒè@u¡9}ø”À‰EðëÇEðëÇEðë ÇEðë‰]ð‹Eº#¹;Á¿;t0;Ãt,;Çt=„”=…@ÿÿÿÇEìë/ÇEìë&ÇEìë=t=t`;Â…ÿÿÿÇEì‹EÇEô€…Çt‹  A÷Ñ#M„ÉxÇEô¨@tMôMøƒMð©t }ô¨ tMôëÇEì릨tMôè£áÿÿ‰ƒøÿuèÎrÿÿ‰ƒÿè±rÿÿÇ鎋E‹=á@SÿuôÇÿuìEÐPÿuðÿuøÿu ÿ׉Eäƒøÿum‹Mø¸À#È;Èu+öEt%eøÿÿÿSÿuôEÐÿuìPÿuðÿuøÿu ÿ׉Eäƒøÿu4‹6‹ÆÁø‹… *AƒæÁæD0€ þÿ\à@Pè?rÿÿYèrÿÿ‹étÿuäÿ<à@;ÃuD‹6‹ÆÁø‹… *AƒæÁæD0€ þÿ\à@‹ðVèüqÿÿYÿuäÿá@;óu°èÃqÿÿÇ ë£ƒøu€Mÿ@ë ƒøu€Mÿÿuäÿ6è4Þÿÿ‹‹ÐƒàÁú‹• *AYÁàYŠMÿ€ÉˆL‹‹ÐƒàÁú‹• *AÁàD$€ €ˆMý€eýHˆMÿ…€öÁ€„±öEtqjƒÏÿWÿ6è£ƒÄ ‰Eè;Çuè:qÿÿ8ƒtMÿ6èéÙÿÿéúþÿÿjEüPÿ6ˆ]üè’õÿÿƒÄ …Àu€}üu‹Eè™RPÿ6è ƒÄ ;ÇtÃSSÿ6èFƒÄ ;Çt³öEÿ€„0¿@¹@…}u‹Eà#Çu Më E‹E#Ç;ÁtD=t)=@t"=t)=@t"=t=@uÆEþë‹M¸#È;Èu ÆEþëˆ]þ÷E„µöEÿ@‰]è…¨‹Eø¹À#Á=@„·=€tw;Á…„‹Eì;Æyƒøvƒøv0ƒø…f¾Eþ3ÿH„&H…RÇEèÿþÇEìéjSSÿ6è8ÌÿÿƒÄ ÂtÇSSSÿ6è'Ìÿÿ#ƒÄƒøÿ„ŽþÿÿjEèPÿ6è/ôÿÿƒÄ ƒøÿ„uþÿÿƒøtkƒø…­}èuYÆEþéÜ‹Eì;Æуø†bÿÿÿƒø‡PÿÿÿjSSÿ6è¸ËÿÿƒÄ „CÿÿÿSSSÿ6è£ËÿÿƒÄ#ƒøÿ…‘éþÿÿ‹Eè%ÿÿ=þÿuÿ6èß×ÿÿYèoÿÿj^‰0‹Æéd=ÿþuSjÿ6èXƒÄ ƒøÿ„ÀýÿÿÆEþëASSÿ6è=ƒÄ ë™ÇEèÇEì‹Eì+ÇPD=èPÿ6è¸ÿÿƒÄ ƒøÿ„€ýÿÿø9}ìÛ‹‹ÈÁù‹  *AƒàÁàD$Š2Mþ€á0‹‹ÈÁù‹  *AƒàÁàD$‹MŠÁéÀá€â ʈ8]ýu!öEt‹‹ÈƒàÁù‹  *AÁàD€ ‹}ø¸À‹Ï#È;Èu|öEtvÿuäÿá@SÿuôEÐjPÿuðçÿÿÿWÿu ÿá@ƒøÿu4ÿ\à@Pèÿmÿÿ‹‹ÈƒàÁù‹  *AÁàD€ þÿ6èÏÚÿÿYé˜ûÿÿ‹6‹ÎÁù‹  *AƒæÁ手Ã_^[ÉÃjhù@èÓmÿÿƒMäÿ3ö‰uà3À9u•À;ÆuèmmÿÿÇVVVVVèõlÿÿƒÄƒÈÿër‰uüÿuj@ÿu ÿuEàPEäè‰øÿÿƒÄ‰EÜÇEüþÿÿÿè‹}Ü;þt<èmÿÿ‰8ë¿3ö9uàt+9uÜt‹EäÁø‹MäƒáÁá‹… *AD€ þÿuäèÛÿÿYËEäèomÿÿËÿU‹ìQQV3ö9uuèÉlÿÿVVVVVÇèQlÿÿƒÄƒÈÿëJ9u tÞÿuEøPEüPÿuÿu è|ƒÄƒøÿtØÿuøÿuüÿujèUÿuü‹ðèÝoÿÿÿuøèÕoÿÿƒÄ‹Æ^ÉËÿU‹ìƒìSW‹}3Û‰}ü;ûu èIlÿÿSSSSSÇèÑkÿÿƒÄƒÈÿéá8tÜ‹E ;ÃtÕ‹;ÃtÏ8tËVj\Wè j/W‹ðè ƒÄ;Ã…;ó…ƒj:Wè=ïÿÿ‹ðYY;óusWèIšÿÿ‹ðƒÆjVèMnÿÿ‹øƒÄ ‰}ü;û„­htô@VWèkÃÿÿƒÄ …Àt SSSSSèjÿÿƒÄÿuVWèØÁÿÿƒÄ …Àt SSSSSèõiÿÿƒÄw‹}ë ;ót;Æv‹ðƒMðÿj.Vèh YY…Àt,Sÿuüè YY…À…ìÿuÿu ÿuüè`þÿÿƒÄ ‰EðéÓÿuüè–™ÿÿ‹ðƒÆjVèšmÿÿƒÄ ‰Eø;ÃuƒÈÿé½ÿuüVPè¸ÂÿÿƒÄ …Àt SSSSSè`iÿÿƒÄÿuüèQ™ÿÿ‹ø}øYèÚjÿÿ‹‰Eì‹Eø+÷ðÇEôìA‹Eôÿ0VWèrÂÿÿƒÄ …Àt SSSSSèiÿÿƒÄSÿuøè] YY…Àtƒmô}ôàA}Äëè„jÿÿÿu‹Mìÿu ‰ÿuøè”ýÿÿƒÄ ‰EðÿuøèÌmÿÿ‹}Y9}üt ÿuüè»mÿÿY‹Eð^_[ÉËÿU‹ìƒìSVW3ÛjSSÿu‰]ð‰]ôè–Æÿÿ‰Eè#ƒÄ‰UìƒøÿtYjSSÿuèzÆÿÿ‹È#ʃăùÿtA‹u ‹}+ðúˆÆ;󆼻Sjÿ4á@Pÿdà@‰Eü…ÀuèÇiÿÿÇ è¼iÿÿ‹_^[ÉÃh€ÿuèŠYY‰Eø…ÿ| ;ór‹Ãë‹ÆPÿuüÿu謫ÿÿƒÄ ƒøÿt6™+ðúxÓ…öwÏ‹uðÿuøÿuèFYYÿuüjÿ4á@Pÿ`à@3Ûé†èWiÿÿƒ8u è:iÿÿÇ ƒÎÿ‰uôë½;ûq|;óskSÿuÿu ÿuèÅÿÿ#ƒÄƒøÿ„Dÿÿÿÿuè›ÖÿÿYPÿ0á@÷ØÀ÷ØH™‰Eð#‰Uôƒøÿu)èÛhÿÿÇ èãhÿÿ‹ðÿ\à@‰‹uð#uôƒþÿ„öþÿÿSÿuìÿuèÿuèÅÿÿ#ƒÄƒøÿ„Ùþÿÿ3ÀéÙþÿÿ‹ÿU‹ìV‹uVè"ÖÿÿYƒøÿuèyhÿÿÇ ƒÈÿëMWÿujÿu Pÿá@‹øƒÿÿuÿ\à@ë3À…Àt PèihÿÿYƒÈÿë‹ÆÁø‹… *AƒæÁæD0€ ý‹Ç_^]ËÿU‹ìS‹] V‹u‹ÆÁø… *A‹ƒæÁæ 0ŠA$ÀW¶y¾Àç€Ñøû@tPû€tBût&ûtûu=€I€‹ L1$Š€â€Êˆë'€I€‹ L1$Š€â‚€Êëè€aë €I€‹ L1$€!€…ÿ_^[u¸€]Ã÷ØÀ%À@]ËÿU‹ì‹EV3ö;ÆuèNgÿÿVVVVVÇèÖfÿÿƒÄjXë ‹ d*A‰3À^]ËÿU‹ìƒìh‹ES3ÛW‰]ôˆ]ÿ;Ãtƒøt~ƒø~ ƒøu ÆEÿ‹E‰Eðë8ègÿÿ‰èçfÿÿSSSSSÇèofÿÿƒÄƒÈÿé®@8uûH8tÆ ‹Á8uëVjD^VE˜SPèdJÿÿ‰u˜‹5*AƒÄ ;ót+Fÿ‹È‹ÐÁù‹  *AƒâÁâ8\uNH;óuà;óŒ@þ23ƒ4‹ÆkÀƒÀf‰EÊ·ÀjPèÇhÿÿYY‰EÌ;Ä;ó‰0‹EÌH|0‰]ø~9‹Eø‹ÐƒàÁúÁà• *AŠPöÂuˆ‹‰ëˆƒÿÿEøAƒÇ9uø|Ê‹EÌ8]ÿt,H3ÒD0ƒþ}‹þëj_;×} ˆƒÿBAƒÀëäÇEôèÎeÿÿ‰EÜPE˜PSÿuÿuôjSSÿuðÿu ÿ à@‹ðÿ\à@ÿuÌ‹øèñhÿÿY;óu Wè£eÿÿYëXƒ}uSè4Rÿÿ‹5á@9]ujÿÿuÜÿà@EìPÿuÜÿà@‹]ìëƒ}uÿuÜÿÖë‹]ÜÿuàÿÖ‹Ãëè(eÿÿÇ ƒÈÿ^_[ÉËÿU‹ìƒì@¡€A3ʼnEü‹M ‹ESVW¾xô@}ð¥¥f¥‰MÔ‹M3Û‰Mà‹M¤j‰EÈ‹ø‹‰Mè‰]܉]ì‰]Ä^ëPè2“ÿÿƒÇt‹Y;ÃuìjV‰uÌè*gÿÿ‹uàYY‰;Ãu#‹Eè‰è˜dÿÿÇ è dÿÿǃÈÿé/EðPEìSPè¼ÚÿÿƒÄ ;ÃtƒøuqSSSSSèËbÿÿƒÄëbEðPè¹’ÿÿ‹øGGY‰}Ð9]ìtÿuì褒ÿÿøY‰}ЋEÔ;ÃtOj‹ð‹_ëP舒ÿÿƒÆ|‹Y;Ãuì¡< A;ÃuCèíÿÿ£< A;Ãu5‹uàÿ6ƒMÜÿèRgÿÿ‹Eè‰Y‰ée‹E艋}È‹‹6;Ã…ñFéU‰]ä8t(Š‹ð€ù=tVè’ÿÿY‹MäL¡< A4‰MäŠ:ËuÜ‹Mä‰MØë+8Xt-€x:u'€x=u!ƒÀPèÝ‘ÿÿY‹MØD‹ < A‰EØÁ€8=t΋EØ+Eä‹uÔø‰}ÀëEðP謑ÿÿPEðPÿ6èƒÄ…ÀtMƒÆ9uÝ}ÐjWè˜eÿÿ‹uàYY‹Mè‰;Ã…2ÿÿÿÿ6èkfÿÿY‰èúbÿÿÇ ècÿÿƒMÜÿÇéiÇEÄë´P‹Æ+ÆEÌPVèºÿÿƒÄ …Àt SSSSSè'aÿÿƒÄÿ7è‘ÿÿtƒÇë6P‹Eà‹+ÆEÌPVèIºÿÿƒÄ …Àt SSSSSèñ`ÿÿƒÄÿ7èãÿÿðƒÇÆ FY‹;ÃuËEèˆ^ÿˆ‹09]Ô„Í‹}Ø‹Eä‹Ï+ÈQ‹ < AÈQVèöºÿÿ+}äƒÄ ÷‹}Ôë6‹EÀ‹Mèÿ7+ÆPVèѹÿÿƒÄ …Àt SSSSSèy`ÿÿƒÄÿ7èkÿÿYtƒÇ9uÆ9]Äug‹}ÐEðPWVè—¹ÿÿƒÄ …Àt SSSSSè?`ÿÿƒÄh`ã@WVè¸ÿÿƒÄ …Àt SSSSSè`ÿÿƒÄ9]ìtÿuìWVèß·ÿÿƒÄ …Àt SSSSSèü_ÿÿƒÄ÷;ót ‹Eè;0uˆFˆ¡< A;ÃtPèÑdÿÿY‰< A9]ìt ÿuìè½dÿÿY‹EÜ‹Mü_^3Í[èIÿÿÉËÿU‹ìV3ö9uu$èBaÿÿ‰0è(aÿÿVVVVVÇè°`ÿÿƒÄjXëU÷E ùÿÿÿuÓÿuÿ8á@ƒøÿuÿ\à@PèaÿÿYèç`ÿÿ‹ë(¨u"¨töE tèã`ÿÿÇèÅ`ÿÿÇ ëÑ3À^]ËÿU‹ìƒìSÿu3ÛMì‰]üèlHÿÿ‹M;Ëu(è“`ÿÿSSSSSÇè`ÿÿƒÄ8]øt‹Eôƒ`pý3ÀëqV‹uð9^uÿu QèjYY8]øtW‹MôƒapýëNWŠ¶Â¶øöD7t!AŠ:Ót¶úÁà Ç9E uAÿ‰Eüë 9]üë9E u‰MüA:ÓuÃ_8]øt‹Eôƒ`pý‹Eü^[ÉËÿU‹ìjÿu ÿuè2ÿÿÿƒÄ ]ËÿU‹ìƒìS3Û9]u3ÀéšÿuMìèGÿÿ‹Eð9Xu&ÿuÿu ÿuèÇÔÿÿƒÄ 8]ø„m‹MôƒapýéaW‹};ût9] u.èƒ_ÿÿSSSSSÇè _ÿÿƒÄ8]øt‹Eôƒ`pý¸ÿÿÿé%Vf¶ÿM·É¶ÑGöD‰MütCŠ:Óu‰]üëXÁáf¶Òf Ê·Éf‹ñG‰Müf;pr f;pwfpë6f;pr0f;pw*fpë$·Uü öAt f¶‰·Éë·Ê‰Müf‹uü‹M f¶ ÿE ·É¶ÑöD‰MütE‹U Š:Óu‰]üëWÁáf¶Òf ÊÿE ·É‰Müf;Hr f;HwfHë6f;Hr0f;Hw*fHë$·Uü öAt f¶‰·Éë·Ê‰Müf‹Müf;Îu!f;ót 9]…ëþÿÿ8]øt‹Eôƒ`pý3À^_[ÉÃÀƒàH8]øtð‹Môƒapýëç‹ÿU‹ìjÿuÿu ÿuè#þÿÿƒÄ]ÃÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌU‹ìW‹}3ÀƒÉÿò®ƒÁ÷ÙƒïŠE ýò®ƒÇ8t3Àë‹Çü_ÉÔú°úÆúÜúîúûû4ûLû`ûhûzûˆûšû¬û¼ûÊûÜûôûüü8üVüjüzü†ü’üžü¶üÎüØüäüöüýýý(ý8ýNýZýjý’ý¬ýÄýÞýôýþþ*þDþTþjþ„þþžþ®þ¾þÐþäþôþ ÿÿ,ÿ>ÿPÿbÿnÿ|ÿŒÿ¢ÿ²ÿÂÿÐÿâÿôÿ(8Jç@²A@4K@ÎX@Ð_@»¬@˜@failed to get exit code from process. failed to create process. %s%sCould not exec %sCannot find Python executable %s #!python.exe#!Cannot open %s -script.pyCorExitProcessmscoree.dll(null)(null)EEE50P( 8PX700WP `h````xpxxxx¨!A"A  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~=EncodePointerKERNEL32.DLLDecodePointerFlsFreeFlsSetValueFlsGetValueFlsAllocruntime error TLOSS error SING error DOMAIN error R6034 An application has made an attempt to load the C runtime library incorrectly. Please contact the application's support team for more information. R6033 - Attempt to use MSIL code from this assembly during native code initialization This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. R6032 - not enough space for locale information R6031 - Attempt to initialize the CRT more than once. This indicates a bug in your application. R6030 - CRT not initialized R6028 - unable to initialize heap R6027 - not enough space for lowio initialization R6026 - not enough space for stdio initialization R6025 - pure virtual function call R6024 - not enough space for _onexit/atexit table R6019 - unable to open console device R6018 - unexpected heap error R6017 - unexpected multithread lock error R6016 - not enough space for thread data This application has requested the Runtime to terminate it in an unusual way. Please contact the application's support team for more information. R6009 - not enough space for environment R6008 - not enough space for arguments R6002 - floating point support not loaded Microsoft Visual C++ Runtime Library ...Runtime Error! Program: À À–ÀÀŽÀÀÀ‘À’À“À€€†€€†€†‚€EEE………00€P€ˆ('8PW€700PPˆ (€ˆ€€`h`hhhxppwpp ((((( H„„„„„„„„„„‚‚‚‚‚‚ h(((( H„„„„„„„„„„‚‚‚‚‚‚ H€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@abcdefghijklmnopqrstuvwxyz[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ABCDEFGHIJKLMNOPQRSTUVWXYZ{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿHH:mm:ssdddd, MMMM dd, yyyyMM/dd/yyPMAMDecemberNovemberOctoberSeptemberAugustJulyJuneAprilMarchFebruaryJanuaryDecNovOctSepAugJulJunMayAprMarFebJanSaturdayFridayThursdayWednesdayTuesdayMondaySundaySatFriThuWedTueMonSunGetProcessWindowStationGetUserObjectInformationAGetLastActivePopupGetActiveWindowMessageBoxAUSER32.DLLSunMonTueWedThuFriSatJanFebMarAprMayJunJulAugSepOctNovDecCONOUT$.com.exe.bat.cmd.\SystemRootH€AÐô@Ð7 i™þÿÿÿÔÿÿÿþÿÿÿ×@þÿÿÿÈÿÿÿþÿÿÿ¼#@þÿÿÿÌÿÿÿþÿÿÿ©%@½%@þÿÿÿŒÿÿÿþÿÿÿ<5@@5@þÿÿÿÔÿÿÿþÿÿÿã:@þÿÿÿÐÿÿÿþÿÿÿ±;@þÿÿÿÌÿÿÿþÿÿÿ;=@=@þÿÿÿÔÿÿÿþÿÿÿÀ>@þÿÿÿÔÿÿÿþÿÿÿó?@þÿÿÿÔÿÿÿþÿÿÿA@9A@þÿÿÿÔÿÿÿþÿÿÿ-G@þÿÿÿÌÿÿÿþÿÿÿûJ@þÿÿÿÔÿÿÿþÿÿÿkN@þÿÿÿÔÿÿÿþÿÿÿ­P@þÿÿÿ¼P@þÿÿÿØÿÿÿþÿÿÿoR@þÿÿÿ{R@þÿÿÿÔÿÿÿþÿÿÿ5Y@þÿÿÿØÿÿÿþÿÿÿÛZ@ïZ@þÿÿÿØÿÿÿþÿÿÿ-[@1[@þÿÿÿÀÿÿÿþÿÿÿˆ^@þÿÿÿÐÿÿÿþÿÿÿ_@/_@þÿÿÿÔÿÿÿþÿÿÿ)j@þÿÿÿÐÿÿÿþÿÿÿ:l@þÿÿÿÔÿÿÿþÿÿÿ>y@þÿÿÿÐÿÿÿþÿÿÿN@þÿÿÿÐÿÿÿþÿÿÿ/‚@þÿÿÿÌÿÿÿþÿÿÿ$•@þÿÿÿÐÿÿÿþÿÿÿ½—@þÿÿÿÐÿÿÿþÿÿÿT¡@þÿÿÿÔÿÿÿþÿÿÿË¥@þÿÿÿÈÿÿÿþÿÿÿ‘§@ͦ@þÿÿÿÐÿÿÿþÿÿÿL®@þÿÿÿÐÿÿÿþÿÿÿhÂ@þÿÿÿÌÿÿÿþÿÿÿ Ê@Tùà”ú°úÆúÜúîúûû4ûLû`ûhûzûˆûšû¬û¼ûÊûÜûôûüü8üVüjüzü†ü’üžü¶üÎüØüäüöüýýý(ý8ýNýZýjý’ý¬ýÄýÞýôýþþ*þDþTþjþ„þþžþ®þ¾þÐþäþôþ ÿÿ,ÿ>ÿPÿbÿnÿ|ÿŒÿ¢ÿ²ÿÂÿÐÿâÿôÿ(8JRGenerateConsoleCtrlEventÆGetExitCodeProcessnWaitForSingleObject•CreateProcessA¯SetConsoleCtrlHandlerõGetModuleFileNameAÚEnterCriticalSectionôLeaveCriticalSectionúGetModuleHandleW+Sleep"GetProcAddressExitProcesspGetCommandLineAðSetHandleCount>GetStdHandleØGetFileType<GetStartupInfoA¿DeleteCriticalSection7TerminateProcessªGetCurrentProcessHUnhandledExceptionFilterSetUnhandledExceptionFilterÖIsDebuggerPresentçGetLastError¦HeapFree¢HeapAlloc\GetCPInfoÅInterlockedIncrementÁInterlockedDecrementSGetACPGetOEMCPàIsValidCodePage>TlsGetValue<TlsAlloc?TlsSetValue=TlsFreeôSetLastError®GetCurrentThreadId—WriteFileöLoadLibraryAºInitializeCriticalSectionAndSpinCountKFreeEnvironmentStringsAÀGetEnvironmentStringsLFreeEnvironmentStringsW„WideCharToMultiByteÂGetEnvironmentStringsW¤HeapCreateaVirtualFreeYQueryPerformanceCounterjGetTickCount«GetCurrentProcessIdSGetSystemTimeAsFileTimešRtlUnwind©HeapReAlloc^VirtualAlloc„GetConsoleCP–GetConsoleModeBFlushFileBuffersæLCMapStringAMultiByteToWideCharèLCMapStringW@GetStringTypeACGetStringTypeWéGetLocaleInfoAçSetFilePointer«HeapSizeDCloseHandleŒWriteConsoleAšGetConsoleOutputCP–WriteConsoleWSetStdHandleyCreateFileASCompareStringAVCompareStringWØSetEnvironmentVariableAKERNEL32.dllnReadFileÕSetEndOfFile&GetProcessHeapÊGetFileAttributesAÀ+AÀ+ANæ@»±¿Dê#@lâ@\â@ÿÿÿÿ€         ! 5A CPR S WY l m pr € ‚ ƒ„ ‘)ž ¡¤ § ·Î×   abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZhA¤`‚y‚!¦ß¡¥Ÿàü@~€ü¨Á£Ú£ þ@þµÁ£Ú£ þAþ¶Ï¢ä¢å¢è¢[þ@~¡þQQÚ^Ú _ÚjÚ2ÓØÞàù1~þlí@þÿÿÿCAAAAAHAhë@ðï@pñ@ˆA˜A˜AhAÿÿÿÿÿÿÿÿøè@Ìè@  è@ è@Üç@¬ç@ˆç@\ç@$ç@üæ@Äæ@Œæ@dæ@Dæ@àå@ ¨å@!°ä@"ä@xä@yðã@zàã@üÜã@ÿÌã@Η@Η@Η@Η@Η@Η@Η@Η@Η@Η@x hë@jí@˜ó@”ó@ó@Œó@ˆó@„ó@€ó@xó@pó@hó@\ó@Pó@Hó@<ó@8ó@4ó@0ó@,ó@(ó@$ó@ ó@ó@ó@ó@ó@ ó@ó@øò@ðò@èò@(ó@àò@Øò@Ðò@Äò@¼ò@°ò@¤ò@ ò@œò@ò@|ò@pò@ ˆA.DAŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AHA. “€pðñÿÿPSTPDTÐAAÿÿÿÿÿÿÿÿþÿÿÿþÿÿÿÿÿÿÿ;Zx—µÔó0Nmÿÿÿÿ:Yw–´Óò/Mllô@dô@\ô@Tô@setuptools-20.7.0/setuptools/depends.py0000664000175000017500000001442212702524020021077 0ustar travistravis00000000000000import sys import imp import marshal from imp import PKG_DIRECTORY, PY_COMPILED, PY_SOURCE, PY_FROZEN from distutils.version import StrictVersion from setuptools.extern import six __all__ = [ 'Require', 'find_module', 'get_module_constant', 'extract_constant' ] class Require: """A prerequisite to building or installing a distribution""" def __init__(self, name, requested_version, module, homepage='', attribute=None, format=None): if format is None and requested_version is not None: format = StrictVersion if format is not None: requested_version = format(requested_version) if attribute is None: attribute = '__version__' self.__dict__.update(locals()) del self.self def full_name(self): """Return full package/distribution name, w/version""" if self.requested_version is not None: return '%s-%s' % (self.name,self.requested_version) return self.name def version_ok(self, version): """Is 'version' sufficiently up-to-date?""" return self.attribute is None or self.format is None or \ str(version) != "unknown" and version >= self.requested_version def get_version(self, paths=None, default="unknown"): """Get version number of installed module, 'None', or 'default' Search 'paths' for module. If not found, return 'None'. If found, return the extracted version attribute, or 'default' if no version attribute was specified, or the value cannot be determined without importing the module. The version is formatted according to the requirement's version format (if any), unless it is 'None' or the supplied 'default'. """ if self.attribute is None: try: f,p,i = find_module(self.module,paths) if f: f.close() return default except ImportError: return None v = get_module_constant(self.module, self.attribute, default, paths) if v is not None and v is not default and self.format is not None: return self.format(v) return v def is_present(self, paths=None): """Return true if dependency is present on 'paths'""" return self.get_version(paths) is not None def is_current(self, paths=None): """Return true if dependency is present and up-to-date on 'paths'""" version = self.get_version(paths) if version is None: return False return self.version_ok(version) def _iter_code(code): """Yield '(op,arg)' pair for each operation in code object 'code'""" from array import array from dis import HAVE_ARGUMENT, EXTENDED_ARG bytes = array('b',code.co_code) eof = len(code.co_code) ptr = 0 extended_arg = 0 while ptr=HAVE_ARGUMENT: arg = bytes[ptr+1] + bytes[ptr+2]*256 + extended_arg ptr += 3 if op==EXTENDED_ARG: long_type = six.integer_types[-1] extended_arg = arg * long_type(65536) continue else: arg = None ptr += 1 yield op,arg def find_module(module, paths=None): """Just like 'imp.find_module()', but with package support""" parts = module.split('.') while parts: part = parts.pop(0) f, path, (suffix,mode,kind) = info = imp.find_module(part, paths) if kind==PKG_DIRECTORY: parts = parts or ['__init__'] paths = [path] elif parts: raise ImportError("Can't find %r in %s" % (parts,module)) return info def get_module_constant(module, symbol, default=-1, paths=None): """Find 'module' by searching 'paths', and extract 'symbol' Return 'None' if 'module' does not exist on 'paths', or it does not define 'symbol'. If the module defines 'symbol' as a constant, return the constant. Otherwise, return 'default'.""" try: f, path, (suffix, mode, kind) = find_module(module, paths) except ImportError: # Module doesn't exist return None try: if kind==PY_COMPILED: f.read(8) # skip magic & date code = marshal.load(f) elif kind==PY_FROZEN: code = imp.get_frozen_object(module) elif kind==PY_SOURCE: code = compile(f.read(), path, 'exec') else: # Not something we can parse; we'll have to import it. :( if module not in sys.modules: imp.load_module(module, f, path, (suffix, mode, kind)) return getattr(sys.modules[module], symbol, None) finally: if f: f.close() return extract_constant(code, symbol, default) def extract_constant(code, symbol, default=-1): """Extract the constant value of 'symbol' from 'code' If the name 'symbol' is bound to a constant value by the Python code object 'code', return that value. If 'symbol' is bound to an expression, return 'default'. Otherwise, return 'None'. Return value is based on the first assignment to 'symbol'. 'symbol' must be a global, or at least a non-"fast" local in the code block. That is, only 'STORE_NAME' and 'STORE_GLOBAL' opcodes are checked, and 'symbol' must be present in 'code.co_names'. """ if symbol not in code.co_names: # name's not there, can't possibly be an assigment return None name_idx = list(code.co_names).index(symbol) STORE_NAME = 90 STORE_GLOBAL = 97 LOAD_CONST = 100 const = default for op, arg in _iter_code(code): if op==LOAD_CONST: const = code.co_consts[arg] elif arg==name_idx and (op==STORE_NAME or op==STORE_GLOBAL): return const else: const = default def _update_globals(): """ Patch the globals to remove the objects not available on some platforms. XXX it'd be better to test assertions about bytecode instead. """ if not sys.platform.startswith('java') and sys.platform != 'cli': return incompatible = 'extract_constant', 'get_module_constant' for name in incompatible: del globals()[name] __all__.remove(name) _update_globals() setuptools-20.7.0/setuptools/dist.py0000664000175000017500000010557012702524020020425 0ustar travistravis00000000000000__all__ = ['Distribution'] import re import os import sys import warnings import numbers import distutils.log import distutils.core import distutils.cmd import distutils.dist from distutils.core import Distribution as _Distribution from distutils.errors import (DistutilsOptionError, DistutilsPlatformError, DistutilsSetupError) from setuptools.extern import six from setuptools.extern.six.moves import map from pkg_resources.extern import packaging from setuptools.depends import Require from setuptools import windows_support import pkg_resources def _get_unpatched(cls): """Protect against re-patching the distutils if reloaded Also ensures that no other distutils extension monkeypatched the distutils first. """ while cls.__module__.startswith('setuptools'): cls, = cls.__bases__ if not cls.__module__.startswith('distutils'): raise AssertionError( "distutils has already been patched by %r" % cls ) return cls _Distribution = _get_unpatched(_Distribution) def _patch_distribution_metadata_write_pkg_info(): """ Workaround issue #197 - Python 3 prior to 3.2.2 uses an environment-local encoding to save the pkg_info. Monkey-patch its write_pkg_info method to correct this undesirable behavior. """ environment_local = (3,) <= sys.version_info[:3] < (3, 2, 2) if not environment_local: return # from Python 3.4 def write_pkg_info(self, base_dir): """Write the PKG-INFO file into the release tree. """ with open(os.path.join(base_dir, 'PKG-INFO'), 'w', encoding='UTF-8') as pkg_info: self.write_pkg_file(pkg_info) distutils.dist.DistributionMetadata.write_pkg_info = write_pkg_info _patch_distribution_metadata_write_pkg_info() sequence = tuple, list def check_importable(dist, attr, value): try: ep = pkg_resources.EntryPoint.parse('x='+value) assert not ep.extras except (TypeError,ValueError,AttributeError,AssertionError): raise DistutilsSetupError( "%r must be importable 'module:attrs' string (got %r)" % (attr,value) ) def assert_string_list(dist, attr, value): """Verify that value is a string list or None""" try: assert ''.join(value)!=value except (TypeError,ValueError,AttributeError,AssertionError): raise DistutilsSetupError( "%r must be a list of strings (got %r)" % (attr,value) ) def check_nsp(dist, attr, value): """Verify that namespace packages are valid""" assert_string_list(dist,attr,value) for nsp in value: if not dist.has_contents_for(nsp): raise DistutilsSetupError( "Distribution contains no modules or packages for " + "namespace package %r" % nsp ) if '.' in nsp: parent = '.'.join(nsp.split('.')[:-1]) if parent not in value: distutils.log.warn( "WARNING: %r is declared as a package namespace, but %r" " is not: please correct this in setup.py", nsp, parent ) def check_extras(dist, attr, value): """Verify that extras_require mapping is valid""" try: for k,v in value.items(): if ':' in k: k,m = k.split(':',1) if pkg_resources.invalid_marker(m): raise DistutilsSetupError("Invalid environment marker: "+m) list(pkg_resources.parse_requirements(v)) except (TypeError,ValueError,AttributeError): raise DistutilsSetupError( "'extras_require' must be a dictionary whose values are " "strings or lists of strings containing valid project/version " "requirement specifiers." ) def assert_bool(dist, attr, value): """Verify that value is True, False, 0, or 1""" if bool(value) != value: tmpl = "{attr!r} must be a boolean value (got {value!r})" raise DistutilsSetupError(tmpl.format(attr=attr, value=value)) def check_requirements(dist, attr, value): """Verify that install_requires is a valid requirements list""" try: list(pkg_resources.parse_requirements(value)) except (TypeError, ValueError) as error: tmpl = ( "{attr!r} must be a string or list of strings " "containing valid project/version requirement specifiers; {error}" ) raise DistutilsSetupError(tmpl.format(attr=attr, error=error)) def check_entry_points(dist, attr, value): """Verify that entry_points map is parseable""" try: pkg_resources.EntryPoint.parse_map(value) except ValueError as e: raise DistutilsSetupError(e) def check_test_suite(dist, attr, value): if not isinstance(value, six.string_types): raise DistutilsSetupError("test_suite must be a string") def check_package_data(dist, attr, value): """Verify that value is a dictionary of package names to glob lists""" if isinstance(value,dict): for k,v in value.items(): if not isinstance(k,str): break try: iter(v) except TypeError: break else: return raise DistutilsSetupError( attr+" must be a dictionary mapping package names to lists of " "wildcard patterns" ) def check_packages(dist, attr, value): for pkgname in value: if not re.match(r'\w+(\.\w+)*', pkgname): distutils.log.warn( "WARNING: %r not a valid package name; please use only " ".-separated package names in setup.py", pkgname ) class Distribution(_Distribution): """Distribution with support for features, tests, and package data This is an enhanced version of 'distutils.dist.Distribution' that effectively adds the following new optional keyword arguments to 'setup()': 'install_requires' -- a string or sequence of strings specifying project versions that the distribution requires when installed, in the format used by 'pkg_resources.require()'. They will be installed automatically when the package is installed. If you wish to use packages that are not available in PyPI, or want to give your users an alternate download location, you can add a 'find_links' option to the '[easy_install]' section of your project's 'setup.cfg' file, and then setuptools will scan the listed web pages for links that satisfy the requirements. 'extras_require' -- a dictionary mapping names of optional "extras" to the additional requirement(s) that using those extras incurs. For example, this:: extras_require = dict(reST = ["docutils>=0.3", "reSTedit"]) indicates that the distribution can optionally provide an extra capability called "reST", but it can only be used if docutils and reSTedit are installed. If the user installs your package using EasyInstall and requests one of your extras, the corresponding additional requirements will be installed if needed. 'features' **deprecated** -- a dictionary mapping option names to 'setuptools.Feature' objects. Features are a portion of the distribution that can be included or excluded based on user options, inter-feature dependencies, and availability on the current system. Excluded features are omitted from all setup commands, including source and binary distributions, so you can create multiple distributions from the same source tree. Feature names should be valid Python identifiers, except that they may contain the '-' (minus) sign. Features can be included or excluded via the command line options '--with-X' and '--without-X', where 'X' is the name of the feature. Whether a feature is included by default, and whether you are allowed to control this from the command line, is determined by the Feature object. See the 'Feature' class for more information. 'test_suite' -- the name of a test suite to run for the 'test' command. If the user runs 'python setup.py test', the package will be installed, and the named test suite will be run. The format is the same as would be used on a 'unittest.py' command line. That is, it is the dotted name of an object to import and call to generate a test suite. 'package_data' -- a dictionary mapping package names to lists of filenames or globs to use to find data files contained in the named packages. If the dictionary has filenames or globs listed under '""' (the empty string), those names will be searched for in every package, in addition to any names for the specific package. Data files found using these names/globs will be installed along with the package, in the same location as the package. Note that globs are allowed to reference the contents of non-package subdirectories, as long as you use '/' as a path separator. (Globs are automatically converted to platform-specific paths at runtime.) In addition to these new keywords, this class also has several new methods for manipulating the distribution's contents. For example, the 'include()' and 'exclude()' methods can be thought of as in-place add and subtract commands that add or remove packages, modules, extensions, and so on from the distribution. They are used by the feature subsystem to configure the distribution for the included and excluded features. """ _patched_dist = None def patch_missing_pkg_info(self, attrs): # Fake up a replacement for the data that would normally come from # PKG-INFO, but which might not yet be built if this is a fresh # checkout. # if not attrs or 'name' not in attrs or 'version' not in attrs: return key = pkg_resources.safe_name(str(attrs['name'])).lower() dist = pkg_resources.working_set.by_key.get(key) if dist is not None and not dist.has_metadata('PKG-INFO'): dist._version = pkg_resources.safe_version(str(attrs['version'])) self._patched_dist = dist def __init__(self, attrs=None): have_package_data = hasattr(self, "package_data") if not have_package_data: self.package_data = {} _attrs_dict = attrs or {} if 'features' in _attrs_dict or 'require_features' in _attrs_dict: Feature.warn_deprecated() self.require_features = [] self.features = {} self.dist_files = [] self.src_root = attrs and attrs.pop("src_root", None) self.patch_missing_pkg_info(attrs) # Make sure we have any eggs needed to interpret 'attrs' if attrs is not None: self.dependency_links = attrs.pop('dependency_links', []) assert_string_list(self,'dependency_links',self.dependency_links) if attrs and 'setup_requires' in attrs: self.fetch_build_eggs(attrs['setup_requires']) for ep in pkg_resources.iter_entry_points('distutils.setup_keywords'): vars(self).setdefault(ep.name, None) _Distribution.__init__(self,attrs) if isinstance(self.metadata.version, numbers.Number): # Some people apparently take "version number" too literally :) self.metadata.version = str(self.metadata.version) if self.metadata.version is not None: try: ver = packaging.version.Version(self.metadata.version) normalized_version = str(ver) if self.metadata.version != normalized_version: warnings.warn( "Normalizing '%s' to '%s'" % ( self.metadata.version, normalized_version, ) ) self.metadata.version = normalized_version except (packaging.version.InvalidVersion, TypeError): warnings.warn( "The version specified (%r) is an invalid version, this " "may not work as expected with newer versions of " "setuptools, pip, and PyPI. Please see PEP 440 for more " "details." % self.metadata.version ) def parse_command_line(self): """Process features after parsing command line options""" result = _Distribution.parse_command_line(self) if self.features: self._finalize_features() return result def _feature_attrname(self,name): """Convert feature name to corresponding option attribute name""" return 'with_'+name.replace('-','_') def fetch_build_eggs(self, requires): """Resolve pre-setup requirements""" resolved_dists = pkg_resources.working_set.resolve( pkg_resources.parse_requirements(requires), installer=self.fetch_build_egg, replace_conflicting=True, ) for dist in resolved_dists: pkg_resources.working_set.add(dist, replace=True) def finalize_options(self): _Distribution.finalize_options(self) if self.features: self._set_global_opts_from_features() for ep in pkg_resources.iter_entry_points('distutils.setup_keywords'): value = getattr(self,ep.name,None) if value is not None: ep.require(installer=self.fetch_build_egg) ep.load()(self, ep.name, value) if getattr(self, 'convert_2to3_doctests', None): # XXX may convert to set here when we can rely on set being builtin self.convert_2to3_doctests = [os.path.abspath(p) for p in self.convert_2to3_doctests] else: self.convert_2to3_doctests = [] def get_egg_cache_dir(self): egg_cache_dir = os.path.join(os.curdir, '.eggs') if not os.path.exists(egg_cache_dir): os.mkdir(egg_cache_dir) windows_support.hide_file(egg_cache_dir) readme_txt_filename = os.path.join(egg_cache_dir, 'README.txt') with open(readme_txt_filename, 'w') as f: f.write('This directory contains eggs that were downloaded ' 'by setuptools to build, test, and run plug-ins.\n\n') f.write('This directory caches those eggs to prevent ' 'repeated downloads.\n\n') f.write('However, it is safe to delete this directory.\n\n') return egg_cache_dir def fetch_build_egg(self, req): """Fetch an egg needed for building""" try: cmd = self._egg_fetcher cmd.package_index.to_scan = [] except AttributeError: from setuptools.command.easy_install import easy_install dist = self.__class__({'script_args':['easy_install']}) dist.parse_config_files() opts = dist.get_option_dict('easy_install') keep = ( 'find_links', 'site_dirs', 'index_url', 'optimize', 'site_dirs', 'allow_hosts' ) for key in list(opts): if key not in keep: del opts[key] # don't use any other settings if self.dependency_links: links = self.dependency_links[:] if 'find_links' in opts: links = opts['find_links'][1].split() + links opts['find_links'] = ('setup', links) install_dir = self.get_egg_cache_dir() cmd = easy_install( dist, args=["x"], install_dir=install_dir, exclude_scripts=True, always_copy=False, build_directory=None, editable=False, upgrade=False, multi_version=True, no_report=True, user=False ) cmd.ensure_finalized() self._egg_fetcher = cmd return cmd.easy_install(req) def _set_global_opts_from_features(self): """Add --with-X/--without-X options based on optional features""" go = [] no = self.negative_opt.copy() for name,feature in self.features.items(): self._set_feature(name,None) feature.validate(self) if feature.optional: descr = feature.description incdef = ' (default)' excdef='' if not feature.include_by_default(): excdef, incdef = incdef, excdef go.append(('with-'+name, None, 'include '+descr+incdef)) go.append(('without-'+name, None, 'exclude '+descr+excdef)) no['without-'+name] = 'with-'+name self.global_options = self.feature_options = go + self.global_options self.negative_opt = self.feature_negopt = no def _finalize_features(self): """Add/remove features and resolve dependencies between them""" # First, flag all the enabled items (and thus their dependencies) for name,feature in self.features.items(): enabled = self.feature_is_included(name) if enabled or (enabled is None and feature.include_by_default()): feature.include_in(self) self._set_feature(name,1) # Then disable the rest, so that off-by-default features don't # get flagged as errors when they're required by an enabled feature for name,feature in self.features.items(): if not self.feature_is_included(name): feature.exclude_from(self) self._set_feature(name,0) def get_command_class(self, command): """Pluggable version of get_command_class()""" if command in self.cmdclass: return self.cmdclass[command] for ep in pkg_resources.iter_entry_points('distutils.commands',command): ep.require(installer=self.fetch_build_egg) self.cmdclass[command] = cmdclass = ep.load() return cmdclass else: return _Distribution.get_command_class(self, command) def print_commands(self): for ep in pkg_resources.iter_entry_points('distutils.commands'): if ep.name not in self.cmdclass: # don't require extras as the commands won't be invoked cmdclass = ep.resolve() self.cmdclass[ep.name] = cmdclass return _Distribution.print_commands(self) def get_command_list(self): for ep in pkg_resources.iter_entry_points('distutils.commands'): if ep.name not in self.cmdclass: # don't require extras as the commands won't be invoked cmdclass = ep.resolve() self.cmdclass[ep.name] = cmdclass return _Distribution.get_command_list(self) def _set_feature(self,name,status): """Set feature's inclusion status""" setattr(self,self._feature_attrname(name),status) def feature_is_included(self,name): """Return 1 if feature is included, 0 if excluded, 'None' if unknown""" return getattr(self,self._feature_attrname(name)) def include_feature(self,name): """Request inclusion of feature named 'name'""" if self.feature_is_included(name)==0: descr = self.features[name].description raise DistutilsOptionError( descr + " is required, but was excluded or is not available" ) self.features[name].include_in(self) self._set_feature(name,1) def include(self,**attrs): """Add items to distribution that are named in keyword arguments For example, 'dist.exclude(py_modules=["x"])' would add 'x' to the distribution's 'py_modules' attribute, if it was not already there. Currently, this method only supports inclusion for attributes that are lists or tuples. If you need to add support for adding to other attributes in this or a subclass, you can add an '_include_X' method, where 'X' is the name of the attribute. The method will be called with the value passed to 'include()'. So, 'dist.include(foo={"bar":"baz"})' will try to call 'dist._include_foo({"bar":"baz"})', which can then handle whatever special inclusion logic is needed. """ for k,v in attrs.items(): include = getattr(self, '_include_'+k, None) if include: include(v) else: self._include_misc(k,v) def exclude_package(self,package): """Remove packages, modules, and extensions in named package""" pfx = package+'.' if self.packages: self.packages = [ p for p in self.packages if p != package and not p.startswith(pfx) ] if self.py_modules: self.py_modules = [ p for p in self.py_modules if p != package and not p.startswith(pfx) ] if self.ext_modules: self.ext_modules = [ p for p in self.ext_modules if p.name != package and not p.name.startswith(pfx) ] def has_contents_for(self,package): """Return true if 'exclude_package(package)' would do something""" pfx = package+'.' for p in self.iter_distribution_names(): if p==package or p.startswith(pfx): return True def _exclude_misc(self,name,value): """Handle 'exclude()' for list/tuple attrs without a special handler""" if not isinstance(value,sequence): raise DistutilsSetupError( "%s: setting must be a list or tuple (%r)" % (name, value) ) try: old = getattr(self,name) except AttributeError: raise DistutilsSetupError( "%s: No such distribution setting" % name ) if old is not None and not isinstance(old,sequence): raise DistutilsSetupError( name+": this setting cannot be changed via include/exclude" ) elif old: setattr(self,name,[item for item in old if item not in value]) def _include_misc(self,name,value): """Handle 'include()' for list/tuple attrs without a special handler""" if not isinstance(value,sequence): raise DistutilsSetupError( "%s: setting must be a list (%r)" % (name, value) ) try: old = getattr(self,name) except AttributeError: raise DistutilsSetupError( "%s: No such distribution setting" % name ) if old is None: setattr(self,name,value) elif not isinstance(old,sequence): raise DistutilsSetupError( name+": this setting cannot be changed via include/exclude" ) else: setattr(self,name,old+[item for item in value if item not in old]) def exclude(self,**attrs): """Remove items from distribution that are named in keyword arguments For example, 'dist.exclude(py_modules=["x"])' would remove 'x' from the distribution's 'py_modules' attribute. Excluding packages uses the 'exclude_package()' method, so all of the package's contained packages, modules, and extensions are also excluded. Currently, this method only supports exclusion from attributes that are lists or tuples. If you need to add support for excluding from other attributes in this or a subclass, you can add an '_exclude_X' method, where 'X' is the name of the attribute. The method will be called with the value passed to 'exclude()'. So, 'dist.exclude(foo={"bar":"baz"})' will try to call 'dist._exclude_foo({"bar":"baz"})', which can then handle whatever special exclusion logic is needed. """ for k,v in attrs.items(): exclude = getattr(self, '_exclude_'+k, None) if exclude: exclude(v) else: self._exclude_misc(k,v) def _exclude_packages(self,packages): if not isinstance(packages,sequence): raise DistutilsSetupError( "packages: setting must be a list or tuple (%r)" % (packages,) ) list(map(self.exclude_package, packages)) def _parse_command_opts(self, parser, args): # Remove --with-X/--without-X options when processing command args self.global_options = self.__class__.global_options self.negative_opt = self.__class__.negative_opt # First, expand any aliases command = args[0] aliases = self.get_option_dict('aliases') while command in aliases: src,alias = aliases[command] del aliases[command] # ensure each alias can expand only once! import shlex args[:1] = shlex.split(alias,True) command = args[0] nargs = _Distribution._parse_command_opts(self, parser, args) # Handle commands that want to consume all remaining arguments cmd_class = self.get_command_class(command) if getattr(cmd_class,'command_consumes_arguments',None): self.get_option_dict(command)['args'] = ("command line", nargs) if nargs is not None: return [] return nargs def get_cmdline_options(self): """Return a '{cmd: {opt:val}}' map of all command-line options Option names are all long, but do not include the leading '--', and contain dashes rather than underscores. If the option doesn't take an argument (e.g. '--quiet'), the 'val' is 'None'. Note that options provided by config files are intentionally excluded. """ d = {} for cmd,opts in self.command_options.items(): for opt,(src,val) in opts.items(): if src != "command line": continue opt = opt.replace('_','-') if val==0: cmdobj = self.get_command_obj(cmd) neg_opt = self.negative_opt.copy() neg_opt.update(getattr(cmdobj,'negative_opt',{})) for neg,pos in neg_opt.items(): if pos==opt: opt=neg val=None break else: raise AssertionError("Shouldn't be able to get here") elif val==1: val = None d.setdefault(cmd,{})[opt] = val return d def iter_distribution_names(self): """Yield all packages, modules, and extension names in distribution""" for pkg in self.packages or (): yield pkg for module in self.py_modules or (): yield module for ext in self.ext_modules or (): if isinstance(ext,tuple): name, buildinfo = ext else: name = ext.name if name.endswith('module'): name = name[:-6] yield name def handle_display_options(self, option_order): """If there were any non-global "display-only" options (--help-commands or the metadata display options) on the command line, display the requested info and return true; else return false. """ import sys if six.PY2 or self.help_commands: return _Distribution.handle_display_options(self, option_order) # Stdout may be StringIO (e.g. in tests) import io if not isinstance(sys.stdout, io.TextIOWrapper): return _Distribution.handle_display_options(self, option_order) # Don't wrap stdout if utf-8 is already the encoding. Provides # workaround for #334. if sys.stdout.encoding.lower() in ('utf-8', 'utf8'): return _Distribution.handle_display_options(self, option_order) # Print metadata in UTF-8 no matter the platform encoding = sys.stdout.encoding errors = sys.stdout.errors newline = sys.platform != 'win32' and '\n' or None line_buffering = sys.stdout.line_buffering sys.stdout = io.TextIOWrapper( sys.stdout.detach(), 'utf-8', errors, newline, line_buffering) try: return _Distribution.handle_display_options(self, option_order) finally: sys.stdout = io.TextIOWrapper( sys.stdout.detach(), encoding, errors, newline, line_buffering) # Install it throughout the distutils for module in distutils.dist, distutils.core, distutils.cmd: module.Distribution = Distribution class Feature: """ **deprecated** -- The `Feature` facility was never completely implemented or supported, `has reported issues `_ and will be removed in a future version. A subset of the distribution that can be excluded if unneeded/wanted Features are created using these keyword arguments: 'description' -- a short, human readable description of the feature, to be used in error messages, and option help messages. 'standard' -- if true, the feature is included by default if it is available on the current system. Otherwise, the feature is only included if requested via a command line '--with-X' option, or if another included feature requires it. The default setting is 'False'. 'available' -- if true, the feature is available for installation on the current system. The default setting is 'True'. 'optional' -- if true, the feature's inclusion can be controlled from the command line, using the '--with-X' or '--without-X' options. If false, the feature's inclusion status is determined automatically, based on 'availabile', 'standard', and whether any other feature requires it. The default setting is 'True'. 'require_features' -- a string or sequence of strings naming features that should also be included if this feature is included. Defaults to empty list. May also contain 'Require' objects that should be added/removed from the distribution. 'remove' -- a string or list of strings naming packages to be removed from the distribution if this feature is *not* included. If the feature *is* included, this argument is ignored. This argument exists to support removing features that "crosscut" a distribution, such as defining a 'tests' feature that removes all the 'tests' subpackages provided by other features. The default for this argument is an empty list. (Note: the named package(s) or modules must exist in the base distribution when the 'setup()' function is initially called.) other keywords -- any other keyword arguments are saved, and passed to the distribution's 'include()' and 'exclude()' methods when the feature is included or excluded, respectively. So, for example, you could pass 'packages=["a","b"]' to cause packages 'a' and 'b' to be added or removed from the distribution as appropriate. A feature must include at least one 'requires', 'remove', or other keyword argument. Otherwise, it can't affect the distribution in any way. Note also that you can subclass 'Feature' to create your own specialized feature types that modify the distribution in other ways when included or excluded. See the docstrings for the various methods here for more detail. Aside from the methods, the only feature attributes that distributions look at are 'description' and 'optional'. """ @staticmethod def warn_deprecated(): warnings.warn( "Features are deprecated and will be removed in a future " "version. See https://github.com/pypa/setuptools/issues/65.", DeprecationWarning, stacklevel=3, ) def __init__(self, description, standard=False, available=True, optional=True, require_features=(), remove=(), **extras): self.warn_deprecated() self.description = description self.standard = standard self.available = available self.optional = optional if isinstance(require_features,(str,Require)): require_features = require_features, self.require_features = [ r for r in require_features if isinstance(r,str) ] er = [r for r in require_features if not isinstance(r,str)] if er: extras['require_features'] = er if isinstance(remove,str): remove = remove, self.remove = remove self.extras = extras if not remove and not require_features and not extras: raise DistutilsSetupError( "Feature %s: must define 'require_features', 'remove', or at least one" " of 'packages', 'py_modules', etc." ) def include_by_default(self): """Should this feature be included by default?""" return self.available and self.standard def include_in(self,dist): """Ensure feature and its requirements are included in distribution You may override this in a subclass to perform additional operations on the distribution. Note that this method may be called more than once per feature, and so should be idempotent. """ if not self.available: raise DistutilsPlatformError( self.description+" is required, " "but is not available on this platform" ) dist.include(**self.extras) for f in self.require_features: dist.include_feature(f) def exclude_from(self,dist): """Ensure feature is excluded from distribution You may override this in a subclass to perform additional operations on the distribution. This method will be called at most once per feature, and only after all included features have been asked to include themselves. """ dist.exclude(**self.extras) if self.remove: for item in self.remove: dist.exclude_package(item) def validate(self,dist): """Verify that feature makes sense in context of distribution This method is called by the distribution just before it parses its command line. It checks to ensure that the 'remove' attribute, if any, contains only valid package/module names that are present in the base distribution when 'setup()' is called. You may override it in a subclass to perform any other required validation of the feature against a target distribution. """ for item in self.remove: if not dist.has_contents_for(item): raise DistutilsSetupError( "%s wants to be able to remove %s, but the distribution" " doesn't contain any packages or modules under %s" % (self.description, item, item) ) setuptools-20.7.0/setuptools/extension.py0000664000175000017500000000323612702524020021472 0ustar travistravis00000000000000import sys import re import functools import distutils.core import distutils.errors import distutils.extension from setuptools.extern.six.moves import map from .dist import _get_unpatched from . import msvc9_support _Extension = _get_unpatched(distutils.core.Extension) msvc9_support.patch_for_specialized_compiler() def _have_cython(): """ Return True if Cython can be imported. """ cython_impl = 'Cython.Distutils.build_ext', try: # from (cython_impl) import build_ext __import__(cython_impl, fromlist=['build_ext']).build_ext return True except Exception: pass return False # for compatibility have_pyrex = _have_cython class Extension(_Extension): """Extension that uses '.c' files in place of '.pyx' files""" def _convert_pyx_sources_to_lang(self): """ Replace sources with .pyx extensions to sources with the target language extension. This mechanism allows language authors to supply pre-converted sources but to prefer the .pyx sources. """ if _have_cython(): # the build has Cython, so allow it to compile the .pyx files return lang = self.language or '' target_ext = '.cpp' if lang.lower() == 'c++' else '.c' sub = functools.partial(re.sub, '.pyx$', target_ext) self.sources = list(map(sub, self.sources)) class Library(Extension): """Just like a regular Extension, but built as a library instead""" distutils.core.Extension = Extension distutils.extension.Extension = Extension if 'distutils.command.build_ext' in sys.modules: sys.modules['distutils.command.build_ext'].Extension = Extension setuptools-20.7.0/setuptools/gui-32.exe0000664000175000017500000020000012702524020020601 0ustar travistravis00000000000000MZÿÿ¸@躴 Í!¸LÍ!This program cannot be run in DOS mode. $äSÀØ 2®‹ 2®‹ 2®‹‡ôÕ‹£2®‹ 2¯‹û2®‹}8‹¤2®‹¾`*‹„2®‹¾`;‹²2®‹¾`-‹Ñ2®‹¾`?‹¡2®‹Rich 2®‹PEL±‹Qà  ÊN&à@@€4ù(ˆô@à@.textíÉÊ `.rdatah à"Î@@.dataÄ+ð@ÀQ‹D$PŠ@„ÉuùSUV+ÂW‹èD-jPèx ƒÄ3ÿ3Û‰D$Æ"p…í~W뛋L$Š <\uGë <"u…ÿ~Wj\Vè ƒÄ ÷3ÿÆ\Fë3ÿ‹T$ŠˆCF;Ý|Ã…ÿ~Wj\VèV ƒÄ ÷‹D$_Æ"ÆF^][YÃì ¡€A3ĉ„$V‹´$W‹¼$Š‹Ï„Àtd$A9](u>‹u3À@8tHF;Ãwö€>:u5;Ëtƒ}‚õjÿujÿQèU&ƒÄF‰uë9](uÂÇEøéÎ;Ëtˆ‹u3ÿ‰]ü8tU¾Pè&Y…ÀtFëŠYƒeü3ÛC98 A„ʼn4 AŠE¢0 Aƒ} …ÿ5¬+Aè0,Y‹ø‰}Ø…ÿtxÿ5¨+Aè,Y‹ð‰u܉}ä‰uàƒî‰uÜ;÷rWè÷+9tí;÷rJÿ6èñ+‹øèá+‰ÿ×ÿ5¬+AèÛ+‹øÿ5¨+AèÎ+ƒÄ 9}äu9Eàt‰}ä‰}؉Eà‹ð‰uÜ‹}ØëŸhpá@¸dá@è_þÿÿYhxá@¸tá@èOþÿÿYÇEüþÿÿÿèƒ}u(‰8 AjèlYÿuèüýÿÿ3ÛCƒ}tjèSYÃèËÿU‹ìjjÿuèÃþÿÿƒÄ ]ËÿU‹ìjjÿuè­þÿÿƒÄ ]ÃjjjèþÿÿƒÄ ÃjjjèŽþÿÿƒÄ ËÿVèó*‹ðVèY;Vèä:VèwVèÉ:Vè´:Vèœ8Vè57Vè7hê#@èE*ƒÄ$£ˆA^ËÿU‹ìƒ=D AuèŒ3ÿuèÙ1hÿè'ýÿÿYY]ÃjXh0õ@èû3ö‰uüE˜Pÿ4à@jþ_‰}ü¸MZf9@u8¡<@¸@PEu'¹ f9ˆ@uƒ¸t@v3É9°è@•Á‰Mäë‰uä3ÛCSèÏ?Y…ÀujèXÿÿÿYè-…ÀujèGÿÿÿYèW4‰]üèø …À}jè&üÿÿYÿ0à@£ +AèQ>£< AèŒ=…À}jèüÿÿYè;…À}j èïûÿÿYSè§üÿÿY;ÆtPèÝûÿÿYè:„]Ät·MÈëj YQPVh@èòÿÿ‰Eà9uäuPèþÿÿèEþÿÿ‰}üë5‹Eì‹‹ ‰MÜPQè·5YYËeè‹E܉Eàƒ}äuPèþÿÿè!þÿÿÇEüþÿÿÿ‹Eàë3À@ËeèÇEüþÿÿÿ¸ÿèÏÃèï>éxþÿÿ‹ÿU‹ìV‹uVèSPèk?YY…Àt|è©òÿÿƒÀ ;ðu3Àëè™òÿÿƒÀ@;ðu`3À@ÿ A÷F uNSW<…H Aƒ?»u Sè Y‰…ÀuFj‰F‰X‰F‰Fë ‹?‰~‰>‰^‰^N 3À_@[ë3À^]ËÿU‹ìƒ}t'V‹u ÷F tVèf ÿîÿÿƒfƒ&ƒfY^]ÃöA @tƒyt$ÿIx ‹ˆÿ¶Àë ¾ÀQPèé-YYƒøÿu ÃÿËÿU‹ìV‹ðë‹MŠEÿM èµÿÿÿƒ>ÿtƒ} ç^]ËÿU‹ìöG @SV‹ð‹Ùt2ƒu,‹Eë+ŠÿM‹Ïè}ÿÿÿCƒ>ÿuèÕƒ8*u‹Ï°?èdÿÿÿƒ}Õ^[]ËÿU‹ììx¡€A3ʼnEüS‹] V‹u3ÀW‹}ÿu¤ýÿÿ‰µ´ýÿÿ‰½Üýÿÿ‰…¸ýÿÿ‰…ðýÿÿ‰…Ìýÿÿ‰…èýÿÿ‰…Ðýÿÿ‰…Àýÿÿ‰…Èýÿÿè÷öÿÿ…öu5èMÇ3ÀPPPPPèӃ½°ýÿÿt ‹…¬ýÿÿƒ`pýƒÈÿéÈ öF @u^Vè@ Yº˜Aƒøÿtƒøþt‹Èƒá‹ðÁþÁá µ *Aë‹ÊöA$u‘ƒøÿtƒøþt‹ÈƒàÁùÁà *Aë‹Âö@$€…gÿÿÿ3É;Ù„]ÿÿÿЉØýÿÿ‰àýÿÿ‰¼ýÿÿˆ•ïýÿÿ„Ò„ Cƒ½Øýÿÿ‰ÄýÿÿŒ ŠÂ, If90t@@;Îuô+…äýÿÿÑøë(;þu ¡A‰…äýÿÿ‹…äýÿÿëI€8t@;Îuõ+…äýÿÿ‰…àýÿÿƒ½Àýÿÿ…\‹…ðýÿÿ¨@t2©t Æ…Ôýÿÿ-ë¨t Æ…Ôýÿÿ+ë ¨tÆ…Ôýÿÿ Ç…Ðýÿÿ‹Ìýÿÿ+àýÿÿ+Ðýÿÿö…ðýÿÿ uÿµ´ýÿÿ…ØýÿÿSj èpõÿÿƒÄ ÿµÐýÿÿ‹½´ýÿÿ…ØýÿÿÔýÿÿèvõÿÿö…ðýÿÿYtö…ðýÿÿuWSj0…Øýÿÿè.õÿÿƒÄ ƒ½Èýÿÿ‹…àýÿÿtf…À~b‹µäýÿÿ‰… ýÿÿ·ÿ ýÿÿPjEôP…˜ýÿÿFPFèå5ƒÄ…Àu(9…˜ýÿÿt ÿµ˜ýÿÿ…ØýÿÿMôèñôÿÿƒ½ ýÿÿYuµëƒØýÿÿÿë‹äýÿÿP…ØýÿÿèÊôÿÿYƒ½Øýÿÿ|ö…ðýÿÿtWSj …Øýÿÿè‚ôÿÿƒÄ ƒ½¼ýÿÿtÿµ¼ýÿÿ胥¼ýÿÿY‹ÄýÿÿŠˆ…ïýÿÿ„Àt‹”ýÿÿ‹½ÜýÿÿŠÐéáõÿÿ€½°ýÿÿt ‹…¬ýÿÿƒ`pý‹…Øýÿÿ‹Mü_^3Í[èÚëÿÿÉÃ+@)@G)@¥)@ñ)@ü)@B*@p+@jThXõ@èe3ÿ‰}üEœPÿ4à@ÇEüþÿÿÿj@j ^VèyYY;Ç„£ *A‰5*Aˆë0Æ@ƒÿÆ@ ‰xÆ@$Æ@% Æ@& ‰x8Æ@4ƒÀ@‹  *AÁ;ÁrÌf9}΄ ‹EÐ;Ç„ÿ‹8X;‰Eä¾;þ|‹þÇEàë[j@j èëYY…ÀtV‹Mà  *A‰ƒ*A ë*Æ@ƒÿÆ@ ƒ`€`$€Æ@% Æ@& ƒ`8Æ@4ƒÀ@‹Ö;ÂrÒÿEà9=*A|ë‹=*Aƒeà…ÿ~m‹E䋃ùÿtVƒùþtQЍtK¨u Qÿ@à@…Àt<‹uà‹ÆÁøƒæÁæ4… *A‹E䋉ŠˆFh F Pè„*YY…À„ÉÿFÿEàCƒEä9}à|“3Û‹óÁæ5 *A‹ƒøÿt ƒøþt€N€ërÆF…ÛujöXë ‹ÃH÷ØÀƒÀõPÿ<à@‹øƒÿÿtC…ÿt?Wÿ@à@…Àt4‰>%ÿƒøu€N@ë ƒøu€Nh F Pèî)YY…Àt7ÿFë €N@ÇþÿÿÿCƒûŒgÿÿÿÿ5*Aÿ8à@3Àë3À@ËeèÇEüþÿÿÿƒÈÿècËÿU‹ì‹EV3ö;Æuè½VVVVVÇèEƒÄƒÈÿë‹@^]ËÿU‹ì‹E£P A]ËÿU‹ìì(¡€A3ʼnEüƒ¥ØüÿÿSjL…ÜüÿÿjPèóäÿÿ…Øüÿÿ‰…(ýÿÿ…0ýÿÿƒÄ ‰…,ýÿÿ‰…àýÿÿ‰Üýÿÿ‰•Øýÿÿ‰Ôýÿÿ‰µÐýÿÿ‰½ÌýÿÿfŒ•øýÿÿfŒìýÿÿfŒÈýÿÿfŒ…ÄýÿÿfŒ¥ÀýÿÿfŒ­¼ýÿÿœ…ðýÿÿ‹EMÇ…0ýÿÿ‰…èýÿÿ‰ôýÿÿ‹Iü‰äýÿÿÇ…ØüÿÿÀÇ…Üüÿÿ‰…äüÿÿÿXà@j‹ØÿTà@…(ýÿÿPÿPà@…Àu …ÛujèM2YhÀÿLà@PÿHà@‹Mü3Í[èüçÿÿÉËÿU‹ìÿ5P Aè*Y…Àt]ÿàjè2Y]é²þÿÿ‹ÿU‹ì‹E3É;ÍØAtAƒù-rñHíƒùwj X]ËÍÜA]ÃDÿÿÿjY;ÈÀ#ÁƒÀ]Ãè …Àu¸@AÃÀÃè…Àu¸DAÃÀ ËÿU‹ìVèâÿÿÿ‹MQ‰è‚ÿÿÿY‹ðè¼ÿÿÿ‰0^]ÃÌÌÌh8@dÿ5‹D$‰l$l$+àSVW¡€A1Eü3ÅP‰eèÿuø‹EüÇEüþÿÿÿ‰EøEðd£Ã‹Mðd‰ Y__^[‹å]QÃÌÌÌÌÌÌÌÌÌÌÌ‹ÿU‹ìƒìS‹] V‹s35€AW‹ÆEÿÇEô{ƒøþt ‹NÏ3 8è©æÿÿ‹N ‹FÏ3 8è™æÿÿ‹Eö@f…‹MUè‰Sü‹[ ‰Eè‰Mìƒûþt_I[‹L†D†‰Eð‹‰Eø…Ét‹×è„1ÆEÿ…À|@G‹Eø‹Øƒøþu΀}ÿt$‹ƒøþt ‹NÏ3 8è&æÿÿ‹N ‹VÏ3 :èæÿÿ‹Eô_^[‹å]ÃÇEôëÉ‹M9csmàu)ƒ=Œ*At hŒ*Aèƒ!ƒÄ…Àt‹UjRÿŒ*AƒÄ‹M è'1‹E 9X th€AW‹Ó‹Èè*1‹E ‹Mø‰H ‹ƒøþt ‹NÏ3 8è“åÿÿ‹N ‹VÏ3 :èƒåÿÿ‹Eð‹H‹×è½0ºþÿÿÿ9S „Rÿÿÿh€AW‹ËèÕ0éÿÿÿ‹ÿU‹ìVW3öÿuè%1‹øY…ÿu'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuÊ‹Ç_^]ËÿU‹ìVW3öjÿu ÿuèE‹øƒÄ …ÿu'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuËÇ_^]ËÿU‹ìVW3öÿu ÿuè[1‹øYY…ÿu,9E t'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuÁ‹Ç_^]ËÿU‹ìVW3öÿuÿu ÿuè%3‹øƒÄ …ÿu,9Et'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿu½‹Ç_^]Ãj hxõ@èÓüÿÿ‹u…ötuƒ=„*AuCjèYƒeüVè73Y‰Eä…Àt VPèX3YYÇEüþÿÿÿè ƒ}äu7ÿuë jèYÃVjÿ5t)Aÿ`à@…Àuèüÿÿ‹ðÿ\à@PèÌûÿÿ‰Yè—üÿÿÃjh˜õ@èEüÿÿ3Û‰]äjè–Y‰]üj_‰}à;=À;A}W‹÷Á桼+AÆ9tD‹ö@ ƒtPèÊ=YƒøÿtÿEäƒÿ|(¡¼+A‹ƒÀ PÿDà@¡¼+Aÿ4èýþÿÿY¡¼+A‰GëžÇEüþÿÿÿè ‹EäèüÿÿÃjè7YËÿU‹ìSV‹u‹F ‹È€á3Û€ùu@©t9‹FW‹>+ø…ÿ~,WPVèaùÿÿYPèçDƒÄ ;Çu‹F „Àyƒàý‰F ëƒN ƒËÿ_‹Fƒf‰^‹Ã[]ËÿU‹ìV‹u…öu Vè5Yë/Vè|ÿÿÿY…ÀtƒÈÿë÷F @tVèøøÿÿPè[EY÷ØYÀë3À^]Ãjh¸õ@èöúÿÿ3ÿ‰}ä‰}ÜjèDY‰}ü3ö‰uà;5À;Aƒ¡¼+A°98t^‹ö@ ƒtVPVèÝÿÿYY3ÒB‰Uü¡¼+A‹°‹H öÁƒt/9UuPèJÿÿÿYƒøÿtÿEäë9}uöÁtPè/ÿÿÿYƒøÿu E܉}üèFë„3ÿ‹uࡼ+Aÿ4°Vè"ÝÿÿYYÃÇEüþÿÿÿèƒ}‹Eät‹EÜèwúÿÿÃjè­YÃjèÿÿÿYËÿVW3ö¿X Aƒ<õLAuõHA‰8h ÿ0ƒÇè}!YY…Àt Fƒþ$|Ò3À@_^Ã$õHA3Àëñ‹ÿS‹Dà@V¾HAW‹>…ÿtƒ~t WÿÓWèÐüÿÿƒ&YƒÆþhA|ܾHA_‹…Àt ƒ~uPÿÓƒÆþhA|æ^[ËÿU‹ì‹Eÿ4ÅHAÿà@]Ãj hàõ@èZùÿÿ3ÿG‰}ä3Û9t)Auè´jèhÿèPãÿÿYY‹u4õHA9t‹Çënjè ûÿÿY‹ø;ûuèÁøÿÿÇ 3ÀëQj èYY‰]ü9u,h Wèt YY…ÀuWèþûÿÿYè‹øÿÿÇ ‰]äë ‰>ëWèãûÿÿYÇEüþÿÿÿè ‹EäèòøÿÿÃj è(ÿÿÿYËÿU‹ì‹EV4ÅHAƒ>uPè"ÿÿÿY…ÀujèDâÿÿYÿ6ÿà@^]Ãj hö@èdøÿÿ‹M3ÿ;Ïv.jàX3Ò÷ñ;E À@uèû÷ÿÿÇ WWWWWèƒ÷ÿÿƒÄ3ÀéÕ¯M ‹ñ‰u;÷u3öF3Û‰]äƒþàwiƒ=„*AuKƒÆƒæð‰u ‹E;p*Aw7jèLÿÿÿY‰}üÿuèH6Y‰EäÇEüþÿÿÿè_‹]ä;ßtÿuWSèÛÿÿƒÄ ;ßuaVjÿ5t)Aÿdà@‹Ø;ßuL9=€)At3Vè’Y…À…rÿÿÿ‹E;Ç„PÿÿÿÇ éEÿÿÿ3ÿ‹u jèðýÿÿYÃ;ßu ‹E;ÇtÇ ‹Ãè˜÷ÿÿÃU‹ìƒì‰}ü‹}‹M ÁéfïÀë¤$ffGfG fG0fG@fGPfG`fGp¿€IuЋ}ü‹å]ÃU‹ìƒì‰}ü‹E™‹ø3ú+úƒç3ú+ú…ÿu<‹M‹Ñƒâ‰Uô;Êt+ÊQPèsÿÿÿƒÄ‹E‹Uô…ÒtEE+‰Eø3À‹}ø‹Môóª‹Eë.÷߃lj}ð3À‹}‹Mðóª‹Eð‹M‹UÈ+ÐRjQè~ÿÿÿƒÄ ‹E‹}ü‹å]Ãj h ö@è`öÿÿƒeüf(ÁÇEäë#‹Eì‹‹=Àt =Àt3ÀÃ3À@ËeèƒeäÇEüþÿÿÿ‹EäèböÿÿËÿU‹ìƒì3ÀS‰Eü‰Eô‰EøSœX‹È5 PœZ+ÑtQ3À¢‰Eô‰]è‰Uì‰M𸢉Uü‰Eø[÷Eütè\ÿÿÿ…Àt3À@ë3À[ÉÃè™ÿÿÿ£ˆ*A3ÀËÿU‹ìQSV‹u3ÛW;ót9] w èEõÿÿjYSSSSS‹ñ‰èÌôÿÿƒÄ‹ÆéÍ‹E3ÿ;ÃtŠ:Ãtj_9} †ˆFÆ:F‹M‹Á;Ët@8t<ë‹}ü‹U G‰}ü;úsyŠˆF@8uèPQèì@ŠYYŠˆF@8uð‹E;Ãt'Š:Ët!€ù.tG;} sÆ.Fë G;} sŠˆF@8uðG;} v‹Eˆèhôÿÿj"éÿÿÿˆ3À_^[ÉËÿU‹ìƒìÿuMðèæÛÿÿ¶E ‹MôŠU„Tuƒ}t‹Mð‹‰È·A#Eë3À…Àt3À@€}üt‹MøƒapýÉËÿU‹ìjjÿuÿu è™ÿÿÿƒÄ]ËÿU‹ìjjÿujèÿÿÿƒÄ]ËÿU‹ìjÿuÿuÿu ÿuèå?ƒÄ]ËÿU‹ìì(£°"A‰ ¬"A‰¨"A‰¤"A‰5 "A‰=œ"AfŒÈ"AfŒ ¼"AfŒ˜"AfŒ”"AfŒ%"AfŒ-Œ"AœÀ"A‹E£´"A‹E£¸"AE£Ä"A‹…àüÿÿÇ"A¡¸"A£´!AǨ!A ÀǬ!A¡€A‰…Øüÿÿ¡„A‰…ÜüÿÿÿXà@£ø!Ajè¯$YjÿTà@hÔâ@ÿPà@ƒ=ø!Aujè‹$Yh ÀÿLà@PÿHà@ÉÃ-¤t"ƒètƒè t Ht3ÀøøøøËÿVW‹ðh3ÿFWPèûÕÿÿ3À·È‹Á‰~‰~‰~ Áá Á~«««¹hAƒÄ F+οŠˆ@Ou÷†¾Šˆ@Nu÷_^ËÿU‹ìì¡€A3ʼnEüSW…èúÿÿPÿvÿhà@¿…À„û3Àˆ„üþÿÿ@;ÇrôŠ…îúÿÿÆ…üþÿÿ „Àt.ïúÿÿ¶È¶;Èw+Á@P” üþÿÿj Rè8ÕÿÿƒÄ CŠC„ÀuØjÿv …üúÿÿÿvPW…üþÿÿPjjèyE3ÛSÿv…üýÿÿWPW…üþÿÿPWÿv SèZCƒÄDSÿv…üüÿÿWPW…üþÿÿPhÿv Sè5CƒÄ$3À·ŒEüúÿÿöÁt€LŠŒüýÿÿëöÁt€L ŠŒüüÿÿˆŒëÆ„@;Çr¾ëV†Ç…äúÿÿŸÿÿÿ3É)…äúÿÿ‹•äúÿÿ„ÐZ ƒûw €LŠÑ€Â ëƒúw€L ŠÑ€ê ˆëÆA;Ïr‹Mü_3Í[èØÿÿÉÃj h@ö@èËðÿÿè˜ ‹ø¡ŒA…Gptƒlt‹wh…öuj ènÚÿÿY‹ÆèãðÿÿÃj èó÷ÿÿYƒeü‹wh‰uä;5At6…ötVÿpà@…ÀuþhAtVè‡óÿÿY¡A‰Gh‹5A‰uäVÿlà@ÇEüþÿÿÿè뎋uäj è¸öÿÿYËÿU‹ìƒìS3ÛSMðèt×ÿÿ‰Ì$AƒþþuÇÌ$Aÿxà@8]ütE‹Møƒapýë<ƒþýuÇÌ$Aÿtà@ëÛƒþüu‹Eð‹@ÇÌ$AëÄ8]üt‹Eøƒ`pý‹Æ[ÉËÿU‹ìƒì ¡€A3ʼnEüS‹] V‹uWèdÿÿÿ‹ø3ö‰};þu‹Ãè·üÿÿ3Àé‰uä3À9¸˜A„‘ÿEäƒÀ0=ðrçÿèý„pÿéý„d·ÇPÿ|à@…À„REèPWÿhà@…À„3hCVPèXÒÿÿ3ÒBƒÄ ‰{‰s 9Uè†ø€}î„ÏuɄ¶Fÿ¶Éé¦hCVPèÒÿÿ‹MäƒÄ kÉ0‰u౨A‰uäë*ŠF„Àt(¶>¶Àë‹EàŠ€”AD;¶FG;øvê‹}FF€>uÑ‹uäÿEàƒÆƒ}à‰uäré‹Ç‰{ÇCègûÿÿj‰C C‰œAZf‹1Af‰0A@@Juó‹óè×ûÿÿé·þÿÿ€L@;ÁvöFF€~ÿ…4ÿÿÿC¹þ€@Iuù‹Cèûÿÿ‰C ‰Së‰s3À·È‹ÁÁá Á{«««ë¨95Ì$A…XþÿÿƒÈÿ‹Mü_^3Í[èÕÿÿÉÃjh`ö@èÆíÿÿƒMàÿè‹ø‰}ÜèÜüÿÿ‹_h‹uèuýÿÿ‰E;C„Wh è‚ïÿÿY‹Ø…Û„F¹ˆ‹wh‹ûó¥ƒ#Sÿuè¸ýÿÿYY‰Eà…À…ü‹uÜÿvhÿpà@…Àu‹Fh=hAtPècðÿÿY‰^hS‹=là@ÿ×öFp…êöŒA…Ýj ètôÿÿYƒeü‹C£Ü$A‹C£à$A‹C £ä$A3À‰Eäƒø}f‹LCf‰ EÐ$A@ëè3À‰Eä=} ŠLˆˆˆA@ëé3À‰Eä=}ŠŒˆˆA@ëæÿ5Aÿpà@…Àu¡A=hAtPèªïÿÿY‰ASÿ×ÇEüþÿÿÿèë0j èíòÿÿYÃë%ƒøÿu ûhAtSètïÿÿYèìÿÿÇëƒeà‹Eàè~ìÿÿÃ=°+AujýèVþÿÿYǰ+A3ÀËÿU‹ìSV‹u‹†¼3ÛW;Ãto=HAth‹†°;Ãt^9uZ‹†¸;Ãt9uPèûîÿÿÿ¶¼è›AYY‹†´;Ãt9uPèÚîÿÿÿ¶¼è5AYYÿ¶°èÂîÿÿÿ¶¼è·îÿÿYY‹†À;ÃtD9u@‹†Ä-þPè–îÿÿ‹†Ì¿€+ÇPèƒîÿÿ‹†Ð+ÇPèuîÿÿÿ¶ÀèjîÿÿƒÄ¾Ô‹=ˆAt9˜´uPè?ÿ7èCîÿÿYY~PÇEøAt‹;Ãt 9uPèîÿÿY9_üt‹G;Ãt 9uPèîÿÿYƒÇÿMuÇVèøíÿÿY_^[]ËÿU‹ìSV‹5là@W‹}WÿÖ‹‡°…ÀtPÿÖ‹‡¸…ÀtPÿÖ‹‡´…ÀtPÿÖ‹‡À…ÀtPÿÖ_PÇE{øAt ‹…ÀtPÿÖƒ{üt ‹C…ÀtPÿÖƒÃÿMuÖ‹‡Ô´PÿÖ_^[]ËÿU‹ìW‹}…ÿ„ƒSV‹5pà@WÿÖ‹‡°…ÀtPÿÖ‹‡¸…ÀtPÿÖ‹‡´…ÀtPÿÖ‹‡À…ÀtPÿÖ_PÇE{øAt ‹…ÀtPÿÖƒ{üt ‹C…ÀtPÿÖƒÃÿMuÖ‹‡Ô´PÿÖ^[‹Ç_]Ã…ÿt7…Àt3V‹0;÷t(W‰8èÁþÿÿY…ötVèEÿÿÿƒ>Yuþ˜AtVèYýÿÿY‹Ç^Ã3ÀÃj h€ö@è_éÿÿè,‹ð¡ŒA…Fpt"ƒ~ltè‹pl…öuj èýÒÿÿY‹ÆèréÿÿÃj è‚ðÿÿYƒeüFl‹=pAèiÿÿÿ‰EäÇEüþÿÿÿèëÁj è}ïÿÿY‹uäËÿU‹ìVÿ5„A‹5€à@ÿÖ…Àt!¡€AƒøÿtPÿ5„AÿÖÿÐ…Àt‹€øë'¾tã@Vÿ à@…Àu Vè>ÒÿÿY…Àthdã@Pÿ(à@…ÀtÿuÿЉE‹E^]Ãjè‡ÿÿÿYËÿU‹ìVÿ5„A‹5€à@ÿÖ…Àt!¡€AƒøÿtPÿ5„AÿÖÿÐ…Àt‹€üë'¾tã@Vÿ à@…Àu VèÃÑÿÿY…Àthã@Pÿ(à@…ÀtÿuÿЉE‹E^]Ãÿ„à@‹ÿVÿ5„Aÿ€à@‹ð…öuÿ5%AèeÿÿÿY‹ðVÿ5„Aÿˆà@‹Æ^á€AƒøÿtPÿ5%Aè;ÿÿÿYÿЃ €Aÿ¡„AƒøÿtPÿŒà@ƒ „Aÿéºíÿÿj h ö@è‚çÿÿ¾tã@Vÿ à@…ÀuVèÑÿÿY‰Eä‹uÇF\é@3ÿG‰~…Àt$hdã@P‹(à@ÿÓ‰†øhã@ÿuäÿÓ‰†ü‰~pƆÈCƆKCÇFhhAj ènîÿÿYƒeüÿvhÿlà@ÇEüþÿÿÿè>j èMîÿÿY‰}ü‹E ‰Fl…Àu¡pA‰FlÿvlèüÿÿYÇEüþÿÿÿèèçÿÿÃ3ÿG‹uj è5íÿÿYÃj è,íÿÿYËÿVWÿ\à@ÿ5€A‹øè‘þÿÿÿЋð…öuNhjè±èÿÿ‹ðYY…öt:Vÿ5€Aÿ5%AèèýÿÿYÿÐ…ÀtjVèÅþÿÿYYÿ”à@ƒNÿ‰ë Vè^éÿÿY3öWÿà@_‹Æ^ËÿVèÿÿÿ‹ð…öujèáÏÿÿY‹Æ^ÃjhÈö@èæÿÿ‹u…ö„ø‹F$…ÀtPèéÿÿY‹F,…ÀtPèéÿÿY‹F4…ÀtPèõèÿÿY‹F<…ÀtPèçèÿÿY‹F@…ÀtPèÙèÿÿY‹FD…ÀtPèËèÿÿY‹FH…ÀtPè½èÿÿY‹F\=é@tPè¬èÿÿYj èàìÿÿYƒeü‹~h…ÿtWÿpà@…ÀuÿhAtWèèÿÿYÇEüþÿÿÿèWj è§ìÿÿYÇEü‹~l…ÿt#WèóúÿÿY;=pAtÿ˜At ƒ?uWèÿøÿÿYÇEüþÿÿÿèVè'èÿÿYèEåÿÿ‹uj èvëÿÿYËuj èjëÿÿYËÿVW¾tã@Vÿ à@…ÀuVècÎÿÿY‹ø…ÿ„^‹5(à@hÀã@WÿÖh´ã@W£ %AÿÖh¨ã@W£%AÿÖh ã@W£%AÿÖƒ= %A‹5ˆà@£%Atƒ=%At ƒ=%At…Àu$¡€à@£%A¡Œà@Ç %A”O@‰5%A£%Aÿ„à@£„Aƒøÿ„Ìÿ5%APÿÖ…À„»è•Ðÿÿÿ5 %Aèûÿÿÿ5%A£ %Aèûÿÿÿ5%A£%Aèóúÿÿÿ5%A£%AèãúÿÿƒÄ£%Aè¬éÿÿ…ÀtehˆQ@ÿ5 %Aè=ûÿÿYÿУ€AƒøÿtHhjèÓåÿÿ‹ðYY…öt4Vÿ5€Aÿ5%Aè ûÿÿYÿÐ…ÀtjVèçûÿÿYYÿ”à@ƒNÿ‰3À@ëè’ûÿÿ3À_^ËÿU‹ìƒìSÿuMèè™Êÿÿ‹]C=w‹E苀ȷXëu‰]Á}EèP‹E%ÿPè§YY…ÀtŠEjˆEøˆ]ùÆEúYë 3Ɉ]øÆEùA‹EèjÿpÿpEüPQEøPEèjPè~6ƒÄ …Àu8Eôt‹Eðƒ`pý3Àë·Eü#E €}ôt‹Mðƒapý[ÉËÿU‹ìQV‹u Vèsàÿÿ‰E ‹F Y¨‚uè4âÿÿÇ ƒN ƒÈÿé/¨@t èâÿÿÇ"ëãS3Û¨t‰^¨„‡‹Nƒàþ‰‰F ‹F ƒàïƒÈ‰F ‰^‰]ü© u,èlÃÿÿƒÀ ;ðt è`ÃÿÿƒÀ@;ðu ÿu èY…ÀuVè@Y÷F W„€‹F‹>H‰‹N+øI;û‰N~WPÿu è<+ƒÄ ‰EüëMƒÈ ‰F ƒÈÿëy‹M ƒùÿtƒùþt‹Áƒà‹ÑÁúÁà• *A븘Aö@ tjSSQèŠ>#ƒÄƒøÿt%‹FŠMˆë3ÿGWEPÿu èÍ*ƒÄ ‰Eü9}üt ƒN ƒÈÿë‹E%ÿ_[^ÉËÿU‹ìQQS‹]VW3ö3ÿ‰}ü;ýˆAt G‰}üƒÿrîƒÿƒwjèÚ@Yƒø„4jèÉ@Y…Àu ƒ=ŒA„ûü„Ahpé@»S¿ %AWè8ƒÄ …Àt VVVVVèÔÞÿÿƒÄh¾9%AVjÆ=&Aÿà@…Àu&hXé@hûVèN8ƒÄ …Àt3ÀPPPPPèÞÿÿƒÄVèç@YƒøƒÄ ë2jôÿ<à@‹Ø;Þt$ƒûÿtjEøP4ýŒAÿ6è%YPÿ6Sÿ˜à@_^[ÉÃjè^?YƒøtjèQ?Y…Àuƒ=ŒAuhüè)þÿÿhÿèþÿÿYYËÿU‹ìQSVWÿ5¬+AèÊöÿÿÿ5¨+A‹ø‰}üèºöÿÿ‹ðYY;÷‚ƒ‹Þ+ßCƒørwWè5?‹øCY;øsH¸;øs‹ÇÇ;ÇrPÿuüèsáÿÿYY…ÀuG;Çr@Pÿuüè]áÿÿYY…Àt1ÁûP4˜èÕõÿÿY£¬+AÿuèÇõÿÿ‰ƒÆVè¼õÿÿY£¨+A‹EYë3À_^[ÉËÿVjj èÇàÿÿ‹ðVè•õÿÿƒÄ £¬+A£¨+A…öujX^Ã&3À^Ãj hðö@èaÞÿÿèÈÿÿƒeüÿuèøþÿÿY‰EäÇEüþÿÿÿè ‹Eäè}ÞÿÿÃèoÈÿÿËÿU‹ìÿuè·ÿÿÿ÷ØÀ÷ØYH]ËÿV¸àô@¾àô@W‹ø;Æs‹…ÀtÿЃÇ;þrñ_^ËÿV¸èô@¾èô@W‹ø;Æs‹…ÀtÿЃÇ;þrñ_^ËÿVW3ÿ·@Aÿ6èÆôÿÿƒÇY‰ƒÿ(rè_^ÃÌ‹ÿU‹ì‹M¸MZf9t3À]ËA<Á8PEuï3Ò¹ f9H”‹Â]ÃÌÌÌÌÌÌÌÌÌÌÌ‹ÿU‹ì‹E‹H<È·ASV·q3ÒWD…öv‹} ‹H ;ùr ‹XÙ;ûr BƒÀ(;Örè3À_^[]ÃÌÌÌÌÌÌÌÌÌÌÌÌ‹ÿU‹ìjþh÷@h8@d¡PƒìSVW¡€A1Eø3ÅPEðd£‰eèÇEüh@è*ÿÿÿƒÄ…ÀtU‹E-@Ph@èPÿÿÿƒÄ…Àt;‹@$Áè÷ЃàÇEüþÿÿÿ‹Mðd‰ Y_^[‹å]ËEì‹‹3Ò=À”‹ÂËeèÇEüþÿÿÿ3À‹Mðd‰ Y_^[‹å]Ãjh0÷@èSÜÿÿè öÿÿ‹@x…ÀtƒeüÿÐë3À@ËeèÇEüþÿÿÿè÷<èlÜÿÿÃh=[@è'óÿÿY£4(AÃËÿU‹ìQQVè`õÿÿ‹ð…ö„F‹V\¡tAW‹}‹ÊS99t‹ØkÛ ƒÁ Ú;ËrîkÀ Â;Ès99u‹Áë3À…Àt ‹X‰]ü…Ûu3Àéûƒûu ƒ`3À@éêƒû„Þ‹N`‰Mø‹M ‰N`‹Hƒù…¸‹ hA‹=lA‹Ñù;×}$kÉ ‹~\ƒd9‹=hA‹lAB߃Á ;Ó|â‹]ü‹‹~d=ŽÀu ÇFdƒë^=Àu ÇFdëN=‘Àu ÇFd„ë>=“Àu ÇFd…ë.=Àu ÇFd‚ë=Àu ÇFd†ë=’ÀuÇFdŠÿvdjÿÓY‰~dëƒ`QÿÓ‹EøY‰F`ƒÈÿ[_^ÉËÿU‹ì‹E£8(A£<(A£@(A£D(A]ËÿU‹ì‹E‹ tAV9Pt‹ñkö uƒÀ ;ÆrìkÉ M^;Ás9Pt3À]Ãÿ5@(AèÚñÿÿYÃj hP÷@èFÚÿÿ3ÿ‰}ä‰}Ø‹]ƒû Lt‹ÃjY+Át"+Át+Átd+ÁuDèsóÿÿ‹ø‰}Ø…ÿuƒÈÿéa¾8(A¡8(Aë`ÿw\‹Óè]ÿÿÿ‹ðƒÆ‹ëZ‹Ãƒèt<ƒèt+HtèŠÙÿÿÇ3ÀPPPPPèÙÿÿƒÄ뮾@(A¡@(Aë¾<(A¡<(Aë ¾D(A¡D(AÇEäPèñÿÿ‰EàY3Àƒ}à„Ø9EàujèÂÅÿÿ9EätPèÆàÿÿY3À‰Eüƒût ƒû tƒûu‹O`‰MÔ‰G`ƒûu@‹Od‰MÐÇGdŒƒûu.‹ hA‰MÜ‹ lA‹hAÊ9MÜ}‹MÜkÉ ‹W\‰DÿEÜëÛè~ðÿÿ‰ÇEüþÿÿÿèƒûuÿwdSÿUàYë‹]‹}؃}ätjèTßÿÿYÃSÿUàYƒût ƒû tƒûu‹EÔ‰G`ƒûu‹EЉGd3ÀèèØÿÿËÿU‹ì‹E£L(A]ËÿU‹ì‹E£X(A]ËÿU‹ì‹E£\(A]Ãjhp÷@èiØÿÿƒeüÿu ÿuÿ à@‰Eäë/‹Eì‹‹‰Eà3É=À”Á‹ÁËeè}àÀujÿà@ƒeäÇEüþÿÿÿ‹Eäè[ØÿÿËÿU‹ì‹E£`(A]ËÿU‹ìÿ5`(Aè|ïÿÿY…ÀtÿuÿÐY…Àt3À@]Ã3À]ËÿU‹ì‹E‹8csmàu*ƒxu$‹@= “t=!“t="“t=@™uèCûÿÿ3À]Âh¾_@ÿTà@3ÀËÿVW3ÿ9=°+AuèCëÿÿ‹5 +A…öu¾bã@Š< w„Àt.…ÿt$<"u 3É…ÿ”Á‹ù¶ÀPèãÿÿY…ÀtFFëÓ< wFŠ„Àuõ_‹Æ^Ã=°+AuèéêÿÿV‹5< AW3ÿ…öuƒÈÿé <=tGVè„YtŠ„ÀuêjGWè!Ùÿÿ‹øYY‰= A…ÿtË‹5< ASëBVèS‹ØC€>=Yt1jSèóØÿÿYY‰…ÀtNVSPè}.ƒÄ …Àt3ÀPPPPPè¿ÔÿÿƒÄƒÇó€>u¹ÿ5< Aè¤Ùÿÿƒ%< Aƒ'Ǥ+A3ÀY[_^Ãÿ5 Aè~Ùÿÿƒ% AƒÈÿëä‹ÿU‹ìQ‹MS3ÀV‰‹ò‹U Ç9Et ‹]ƒE‰‰Eü€>"u3À9Eü³"”ÀF‰Eüë<ÿ…ÒtŠˆB‰U жÃPFè¿áÿÿY…Àtÿƒ} t ‹M ŠÿE ˆF‹U ‹M„Ût2ƒ}üu©€û t€û uŸ…ÒtÆBÿƒeü€>„éŠ< t< uFëóNëã€>„Ѓ}t ‹EƒE‰ÿ3ÛC3ÉëFA€>\tù€>"u&öÁuƒ}üt F€8"u‹ðë 3À3Û9Eü”À‰EüÑé…ÉtI…ÒtÆ\Bÿ…Éuñ‰U Š„ÀtUƒ}üu< tK< tG…Ût=¾ÀP…Òt#èÚàÿÿY…Àt Š‹M ÿE ˆFÿ‹M ŠÿE ˆë è·àÿÿY…ÀtFÿÿ‹U FéVÿÿÿ…ÒtÆB‰U ÿ‹Méÿÿÿ‹E^[…Àtƒ ÿÉËÿU‹ìƒì S3ÛVW9°+Auèeèÿÿh¾h(AVSˆl)Aÿà@¡ +A‰5( A;Ãt‰Eü8u‰uü‹UüEøPSS}ôè þÿÿ‹EøƒÄ =ÿÿÿ?sJ‹MôƒùÿsB‹øÁç;Ár6Pè$Öÿÿ‹ðY;ót)‹UüEøPþWV}ôèÉýÿÿ‹EøƒÄ H£ A‰5 A3ÀëƒÈÿ_^[ÉËÿU‹ì¡p)Aƒì SV‹5´à@W3Û3ÿ;Ãu.ÿÖ‹ø;ût Çp)Aë#ÿ\à@ƒøxu jX£p)Aë¡p)Aƒø…;ûuÿÖ‹ø;ûu3ÀéÊ‹Çf9t@@f9uù@@f9uò‹5°à@SSS+ÇSÑø@PWSS‰EôÿÖ‰Eø;Ãt/PèJÕÿÿY‰Eü;Ãt!SSÿuøPÿuôWSSÿÖ…Àu ÿuüèYÖÿÿY‰]ü‹]üWÿ¬à@‹Ãë\ƒøt;Ãu‚ÿ¨à@‹ð;ó„rÿÿÿ8t @8uû@8uö+Æ@P‰EøèãÔÿÿ‹øY;ûu Vÿ¤à@éEÿÿÿÿuøVWèª+ƒÄ Vÿ¤à@‹Ç_^[ÉËÿU‹ì3À9Ej”ÀhPÿ¸à@£t)A…Àu]Ã3À@£„*A]ËÿU‹ìƒì¡€AƒeøƒeüSW¿Næ@»»ÿÿ;Çt …Ãt ÷У„Aë`VEøPÿÌà@‹uü3uøÿÈà@3ðÿ”à@3ðÿÄà@3ðEðPÿÀà@‹Eô3Eð3ð;÷u¾Oæ@»ë …óu‹ÆÁà ð‰5€A÷Ö‰5„A^_[ÉËÿU‹ì‹Eƒøþuè¡ÑÿÿÇ 3À]ÃV3ö;Æ|;*ArèƒÑÿÿVVVVVÇ è ÑÿÿƒÄ3Àë‹ÈƒàÁù‹  *AÁà¾Dƒà@^]á€AƒÈ3É9x)A”Á‹ÁÃÌÌÌÌÌÌÌÌÌ‹L$÷Át$ŠƒÁ„ÀtN÷Áuï¤$¤$‹ºÿþþ~Ѓðÿ3ƒÁ©tè‹Aü„Àt2„ät$©ÿt©ÿtëÍAÿ‹L$+ÁÃAþ‹L$+ÁÃAý‹L$+ÁÃAü‹L$+ÁËÿU‹ìƒìSV‹u 3ÛW‹};óu;ûv‹E;Ãt‰3À郋E;ÃtƒÿÿÿÿÿvècÐÿÿj^SSSSS‰0èìÏÿÿƒÄ‹ÆëVÿuMðèã·ÿÿ‹Eð9X…œf‹E¹ÿf;Áv6;ót;ûv WSV訳ÿÿƒÄ èÐÿÿÇ*èÐÿÿ‹8]üt‹Møƒapý_^[ÉÃ;ót2;ûw,èåÏÿÿj"^SSSSS‰0ènÏÿÿƒÄ8]ü„yÿÿÿ‹Eøƒ`pýémÿÿÿˆ‹E;ÃtÇ8]ü„%ÿÿÿ‹Eøƒ`pýéÿÿÿM QSWVjMQS‰] ÿpÿ°à@;Ãt9] …^ÿÿÿ‹M;Ët½‰ë¹ÿ\à@ƒøz…Dÿÿÿ;ó„gÿÿÿ;û†_ÿÿÿWSVèѲÿÿƒÄ éOÿÿÿ‹ÿU‹ìjÿuÿuÿu ÿuè|þÿÿƒÄ]ËÿU‹ìƒìÿu Mð誶ÿÿ¶E‹Mð‹‰È·A%€€}üt‹MøƒapýÉËÿU‹ìjÿuè¹ÿÿÿYY]ÃÌV‹D$ Àu(‹L$‹D$ 3Ò÷ñ‹Ø‹D$÷ñ‹ð‹Ã÷d$‹È‹Æ÷d$ÑëG‹È‹\$‹T$ ‹D$ÑéÑÛÑêÑØ Éuô÷ó‹ð÷d$‹È‹D$÷æÑr;T$ wr;D$v N+D$T$3Û+D$T$ ÷Ú÷؃ڋʋӋًȋÆ^ƒ%€*AÃÌÌÌSVW‹T$‹D$‹L$URPQQh°i@dÿ5¡€A3ĉD$d‰%‹D$0‹X‹L$,3‹p ƒþþt;‹T$4ƒúþt;òv.4v\³‹ ‰H ƒ{uÌh‹Cè1¹‹Cè1ë°dƒÄ_^[ËL$÷A¸t3‹D$‹H3ÈèµÿÿU‹hÿp ÿpÿpè>ÿÿÿƒÄ ]‹D$‹T$‰¸ÃU‹L$‹)ÿqÿqÿq(èÿÿÿƒÄ ]ÂUVWS‹ê3À3Û3Ò3ö3ÿÿÑ[_^]Ëê‹ñ‹Ájè_03À3Û3É3Ò3ÿÿæU‹ìSVWjjhWj@Qè—Q_^[]ÃU‹l$RQÿt$è´þÿÿƒÄ ]Âj h÷@èÍÿÿƒeä‹u;5p*Aw"jèdÔÿÿYƒeüVèa Y‰EäÇEüþÿÿÿè ‹Eäè)ÍÿÿÃjè_ÓÿÿYËÿU‹ìV‹uƒþà‡¡SW‹=dà@ƒ=t)Auè!íÿÿjèoëÿÿhÿè½¶ÿÿYY¡„*Aƒøu…öt‹Æë3À@Pëƒøu VèSÿÿÿY…Àu…öuFƒÆƒæðVjÿ5t)Aÿ׋؅Ûu.j ^9€)AtÿuèBôÿÿY…Àt‹ué{ÿÿÿèêËÿÿ‰0èãËÿÿ‰0_‹Ã[ëVèôÿÿYèÏËÿÿÇ 3À^]Ãjh°÷@èÌÿÿ‹]…Ûuÿu èÿÿÿYéÌ‹u …öu SèÏÿÿYé·ƒ=„*A…“3ÿ‰}äƒþà‡ŠjèÓÿÿY‰}üSè6Y‰Eà;Ç„ž;5p*AwIVSPèƒÄ …Àt‰]äë5Vèç Y‰Eä;Çt'‹CüH;Ær‹ÆPSÿuäè:$Sèæ‰EàSPè ƒÄ9}äuH;÷u3öF‰u ƒÆƒæð‰u VWÿ5t)Aÿdà@‰Eä;Çt ‹CüH;Ær‹ÆPSÿuäèæ#Sÿuà迃ÄÇEüþÿÿÿè.ƒ}àu1…öuFƒÆƒæð‰u VSjÿ5t)AÿÔà@‹øë‹u ‹]jèHÑÿÿYË}ä…ÿ…¿9=€)At,Vè¤òÿÿY…À…ÒþÿÿèPÊÿÿ9}àul‹ðÿ\à@PèûÉÿÿY‰ë_…ÿ…ƒè+Êÿÿ9}àthÇ ëq…öuFVSjÿ5t)AÿÔà@‹ø…ÿuV9€)At4Vè;òÿÿY…ÀtƒþàvÍVè+òÿÿYèßÉÿÿÇ 3ÀècÊÿÿÃèÌÉÿÿé|ÿÿÿ…ÿuè¾Éÿÿ‹ðÿ\à@PènÉÿÿ‰Y‹ÇëÒ‹ÿU‹ì‹M S3Û;Ëv(jà3ÒX÷ñ;Esè‰ÉÿÿSSSSSÇ èÉÿÿƒÄ3ÀëA¯MVW‹ñ9]t ÿuèÈ)Y‹ØVÿuèýÿÿ‹øYY…ÿt;Þs+óVjßSèȬÿÿƒÄ ‹Ç_^[]ËÿU‹ì‹ h*A¡l*AkÉÈë‹U+P úr ƒÀ;Árë3À]ËÿU‹ìƒì‹M‹AV‹u W‹þ+y ƒÆüÁï‹ÏiÉŒD‰Mð‹I‰MüöÁ…ÓS1‹‰Uô‹Vü‰Uø‹Uô‰] öÂutÁúJƒú?vj?Z‹K;KuB»€ƒú s‹ÊÓëL÷Ó!\¸Dþ u#‹M!ëJàÓëL÷Ó!œ¸Äþ u‹M!Y‹] ‹S‹[‹MüMô‰Z‹U ‹Z‹R‰S‰Mü‹ÑÁúJƒú?vj?Z‹]øƒã‰]ô…+uø‹]øÁûj?‰u K^;Þv‹ÞMø‹ÑÁúJ‰Mü;Öv‹Ö;Út^‹M ‹q;qu;¾€ƒû s‹ËÓî÷Ö!t¸DþLu!‹M!1ëKàÓî÷Ö!´¸ÄþLu‹M!q‹M ‹q‹I‰N‹M ‹q‹I‰N‹u ë‹]ƒ}ôu;Ú„€‹Mð Ñ‹Y‰N‰^‰q‹N‰q‹N;Nu`ŠLˆMþÁˆLƒú s%€}u‹Ê»€Óë‹M »€‹ÊÓëD¸D ë)€}uJເÓë‹M YJ຀Óê„¸Ä ‹Eü‰‰D0ü‹Eðÿ…ó¡|)A…À„Ø‹ |*A‹5¼à@h@ÁáH »€SQÿÖ‹ |*A¡|)Aº€Óê P¡|)A‹@‹ |*Aƒ¤ˆÄ¡|)A‹@þHC¡|)A‹H€yCu ƒ`þ¡|)AƒxÿueSjÿp ÿÖ¡|)Aÿpjÿ5t)Aÿ`à@‹ h*A¡|)AkÉ‹l*A+ÈLìQHQPèí+‹EƒÄ ÿ h*A;|)Avƒm¡l*A£t*A‹E£|)A‰=|*A[_^Éáx*AV‹5h*AW3ÿ;ðu4ƒÀkÀPÿ5l*AWÿ5t)AÿÔà@;Çu3Àëxƒx*A‹5h*A£l*Akö5l*AhÄAjÿ5t)Aÿdà@‰F;ÇtÇjh hWÿØà@‰F ;ÇuÿvWÿ5t)Aÿ`à@뛃Nÿ‰>‰~ÿh*A‹Fƒÿ‹Æ_^ËÿU‹ìQQ‹M‹ASV‹qW3ÛëÀC…À}ù‹ÃiÀ„0Dj?‰EøZ‰@‰@ƒÀJuôj‹ûhÁçy h€WÿØà@…ÀuƒÈÿé—p‰Uü;úwC‹Ê+ÏÁé GAƒHøÿƒˆìÿü‰üïÿÿÇ@üð‰PÇ€èðIuË‹Uü‹EøøO ‰H‰AJ ‰H‰AƒdžD3ÿG‰¼žÄŠFCŠÈþÁ„À‹EˆNCu xº€‹ËÓê÷Ò!P‹Ã_^[ÉËÿU‹ìƒì ‹M‹ASV‹uW‹} ‹×+Q ƒÆÁê‹ÊiÉŒD‰Mô‹OüƒæðI;ñ|9ü‹‰M‰]üŽUöÃ…EÙ;ó;‹MüÁùI‰Møƒù?vj?Y‰Mø‹_;_uC»€ƒù sÓë‹MøL÷Ó!\Dþ u&‹M!ëƒÁàÓë‹MøL÷Ó!œÄþ u‹M!Y‹O‹_‰Y‹O‹‰y‹M+ÎMüƒ}üŽ¥‹}ü‹M ÁÿOL1üƒÿ?vj?_‹]ôû‰]‹[‰Y‹]‰Y‰K‹Y‰K‹Y;YuWŠLˆMþÁˆLƒÿ s€}u‹Ï»€Óë‹M DD‹Ïë €}uOເÓë‹M Y„ÄO຀Óê ‹U ‹MüD2ü‰‰Lüë‹U F‰Bü‰D2øé<3Àé8/‹] )uN‰Kü\3ü‹uÁþN‰] ‰Küƒþ?vj?^öEü…€‹uüÁþNƒþ?vj?^‹O;OuB»€ƒþ s‹ÎÓët÷Ó!\Dþu#‹M!ëNàÓëL÷Ó!œÄþ u‹M!Y‹] ‹O‹w‰q‹w‹O‰q‹uuü‰uÁþNƒþ?vj?^‹Mô ñ‹y‰K‰{‰Y‹K‰Y‹K;KuWŠLˆMþÁˆLƒþ s€}u‹Î¿€Óï‹M 9DD‹Îë €}uNà¿€Óï‹M y„ÄN຀Óê ‹E‰‰Dü3À@_^[ÉËÿU‹ìƒì¡h*A‹MkÀl*AƒÁƒáð‰MðÁùSIƒù VW} ƒÎÿÓîƒMøÿë ƒÁàƒÊÿ3öÓê‰Uø‹ t*A‹Ùë‹S‹;#Uø#þ ×u ƒÃ‰];Ørè;Øu‹l*Aë‹S‹;#Uø#þ ×u ƒÃ‰];Ùrè;Ùu[ë ƒ{u ƒÃ‰];Ørð;Øu1‹l*Aë ƒ{u ƒÃ‰];Ùrð;Ùuè úÿÿ‹Ø‰]…Ûu3Àé Sè:ûÿÿY‹K‰‹Cƒ8ÿtå‰t*A‹C‹‰Uüƒúÿt‹ŒÄ‹|D#Mø#þ Ïu)ƒeü‹ÄHD‹9#Uø#þ ×uÿEü‹‘„ƒÁëç‹Uü‹ÊiÉŒD‰Mô‹LD3ÿ#Îu‹ŒÄ#Møj _ëÉG…É}ù‹Mô‹Tù‹ +Mð‹ñÁþNƒþ?‰Mø~j?^;÷„‹J;Ju\ƒÿ »€}&‹ÏÓë‹Mü|8÷Ó‰]ì#\ˆD‰\ˆDþu3‹Mì‹]! ë,OàÓë‹MüŒˆÄ|8÷Ó!þ‰]ìu ‹]‹Mì!Kë‹]ƒ}ø‹J‹z‰y‹J‹z‰y„‹Mô ñ‹y‰J‰z‰Q‹J‰Q‹J;Ju^ŠLˆM þÁƒþ ˆL}#€} u ¿€‹ÎÓï ;‹Î¿€Óï‹Mü |ˆDë)€} u Nà¿€Óï {‹Mü¼ˆÄNྀÓî 7‹Mø…Ét ‰ ‰Lüë‹Mø‹uðÑN‰ ‰L2ü‹uô‹y‰>…Éu;|)Au‹Mü; |*Auƒ%|)A‹Mü‰B_^[ÉËÿU‹ìSV‹uW3ÿƒËÿ;÷uèQ¾ÿÿWWWWWÇèÙ½ÿÿƒÄ ÃëBöF ƒt7VèÈÂÿÿV‹ØèÄ(VèO¼ÿÿPèë'ƒÄ…À}ƒËÿë‹F;Çt PènÁÿÿY‰~‰~ ‹Ã_^[]Ãj hÐ÷@è3¾ÿÿƒMäÿ3À‹u3ÿ;÷•À;ÇuèνÿÿÇWWWWWèV½ÿÿƒÄƒÈÿë öF @t ‰~ ‹Eäè6¾ÿÿÃVè  ÿÿY‰}üVè*ÿÿÿY‰EäÇEüþÿÿÿèëÕ‹uVèY ÿÿYËÿU‹ì¸äè8*¡€A3ʼnEü‹E V3ö‰…4åÿÿ‰µ8åÿÿ‰µ0åÿÿ9uu3Àéé;Æu'èD½ÿÿ‰0è*½ÿÿVVVVVÇè²¼ÿÿƒÄƒÈÿé¾SW‹}‹ÇÁø4… *A‹ƒçÁçÇŠX$ÛÐû‰µ(åÿÿˆ'åÿÿ€ût€ûu0‹M÷ÑöÁu&èÛ¼ÿÿ3ö‰0迼ÿÿVVVVVÇèG¼ÿÿƒÄéCö@ tjjjÿuècƒÄÿuèÕêÿÿY…À„‹öD€„è‹Öÿÿ‹@l3É9H…åÿÿ”ÁP‹ÿ4‰ åÿÿÿàà@…À„`3É9 åÿÿt„Û„PÿÜà@‹4åÿÿ‰…åÿÿ3À‰…<åÿÿ9E†B‰…DåÿÿŠ…'åÿÿ„À…gŠ ‹µ(åÿÿ3À€ù ”À‰… åÿÿ‹ǃx8tŠP4ˆUôˆMõƒ`8jEôPëK¾ÁPè×ìÿÿY…Àt:‹4åÿÿ+ËM3À@;Ȇ¥j…@åÿÿSPè<(ƒÄ ƒøÿ„±Cÿ…DåÿÿëjS…@åÿÿPè(ƒÄ ƒøÿ„3ÀPPjMôQj@åÿÿQPÿµåÿÿCÿ…Dåÿÿÿ°à@‹ð…ö„\j…<åÿÿPVEôP‹…(åÿÿ‹ÿ4ÿ˜à@…À„)‹…Dåÿÿ‹0åÿÿÁ9µ<åÿÿ‰…8åÿÿŒƒ½ åÿÿ„Íj…<åÿÿPjEôP‹…(åÿÿ‹ÆEô ÿ4ÿ˜à@…À„Ѓ½<åÿÿŒÏÿ…0åÿÿÿ…8åÿÿéƒ<t<u!·33Éfƒþ ”ÁCCƒ…Dåÿÿ‰µ@åÿÿ‰ åÿÿ<t<uRÿµ@åÿÿè%%Yf;…@åÿÿ…hƒ…8åÿÿƒ½ åÿÿt)j XP‰…@åÿÿèø$Yf;…@åÿÿ…;ÿ…8åÿÿÿ…0åÿÿ‹E9…Dåÿÿ‚ùýÿÿé'‹Šÿ…8åÿÿˆT4‹‰D8é3É‹Çö@€„¿‹…4åÿÿ‰@åÿÿ„Û…ʉ…<åÿÿ9M† 답(åÿÿ‹<åÿÿƒ¥Dåÿÿ+4åÿÿ…Håÿÿ;Ms9‹•<åÿÿÿ…<åÿÿŠA€ú uÿ…0åÿÿÆ @ÿ…Dåÿÿˆ@ÿ…Dåÿÿ½Dåÿÿÿr‹؅Håÿÿ+Øj…,åÿÿPS…HåÿÿP‹ÿ4ÿ˜à@…À„B‹…,åÿÿ…8åÿÿ;ÃŒ:‹…<åÿÿ+…4åÿÿ;E‚Lÿÿÿé ‰…Dåÿÿ€û…Ñ9M†M답(åÿÿ‹Dåÿÿƒ¥<åÿÿ+4åÿÿ…Håÿÿ;MsF‹•Dåÿÿƒ…Dåÿÿ·AAfƒú uƒ…0åÿÿj [f‰@@ƒ…<åÿÿƒ…<åÿÿf‰@@½<åÿÿþrµ‹Ø…Håÿÿ+Øj…,åÿÿPS…HåÿÿP‹ÿ4ÿ˜à@…À„b‹…,åÿÿ…8åÿÿ;ÃŒZ‹…Dåÿÿ+…4åÿÿ;E‚?ÿÿÿé@9M†|‹Dåÿÿƒ¥<åÿÿ+4åÿÿj…Hùÿÿ^;Ms<‹•Dåÿÿ·µDåÿÿÎfƒú uj [f‰Æµ<åÿÿµ<åÿÿf‰ƽ<åÿÿ¨r¿3öVVhU ðëÿÿQHùÿÿ+Á™+ÂÑøP‹ÁPVhéýÿ°à@‹Ø;Þ„—j…,åÿÿP‹Ã+ÆP„5ðëÿÿP‹…(åÿÿ‹ÿ4ÿ˜à@…Àt µ,åÿÿ;ÞËë ÿ\à@‰…@åÿÿ;Þ\‹…Dåÿÿ+…4åÿÿ‰…8åÿÿ;E‚ ÿÿÿë?j,åÿÿQÿuÿµ4åÿÿÿ0ÿ˜à@…Àt‹…,åÿÿƒ¥@åÿÿ‰…8åÿÿë ÿ\à@‰…@åÿÿƒ½8åÿÿulƒ½@åÿÿt-j^9µ@åÿÿuè²¶ÿÿÇ èº¶ÿÿ‰0ë?ÿµ@åÿÿè¾¶ÿÿYë1‹µ(åÿÿ‹öD@t‹…4åÿÿ€8u3Àë$èr¶ÿÿÇèz¶ÿÿƒ ƒÈÿë ‹…8åÿÿ+…0åÿÿ_[‹Mü3Í^èØÿÿÉÃjhð÷@è„¶ÿÿ‹Eƒøþuè>¶ÿÿƒ è#¶ÿÿÇ ƒÈÿé3ÿ;Ç|;*Ar!è¶ÿÿ‰8èûµÿÿÇ WWWWW胵ÿÿƒÄëÉ‹ÈÁù *A‹ðƒæÁæ‹ ¾L1ƒát¿Pè9$Y‰}ü‹öD0tÿuÿu ÿuè.øÿÿƒÄ ‰Eäë蘵ÿÿÇ è µÿÿ‰8ƒMäÿÇEüþÿÿÿè ‹Eäè¶ÿÿÃÿuèƒ$YÃjhø@訵ÿÿ‹EƒøþuèOµÿÿÇ ƒÈÿéª3Û;Ã|;*Arè.µÿÿÇ SSSSSè¶´ÿÿƒÄëЋÈÁù< *A‹ðƒæÁ拾LƒátÆPèl#Y‰]ü‹öDt1ÿuèà"YPÿäà@…Àu ÿ\à@‰Eäë‰]ä9]ätèÍ´ÿÿ‹Mä‰è°´ÿÿÇ ƒMäÿÇEüþÿÿÿè ‹Eäè#µÿÿÃÿuè¢#YËÿU‹ìƒìS3Û9]uèr´ÿÿSSSSSÇèú³ÿÿƒÄ3ÀëjV‹u ;óuèN´ÿÿSSSSSÇèÖ³ÿÿƒÄë9ur3Àë>ÿuMðèÆ›ÿÿ‹MôFÿ9YtH9Ew ¶öD uð‹Î+ȃá+ñN‹Æ8]üt‹Møƒapý^[ÉËÿU‹ìjÿu ÿuèUÿÿÿƒÄ ]ËÿU‹ìƒìS3ÛV‹u9]u;óu9] u3Àéç;ót9] w襳ÿÿj^SSSSS‰0è.³ÿÿƒÄ‹ÆéÀ9]uˆëÉW‹};ûuˆèt³ÿÿj^SSSSS‰0èý²ÿÿƒÄé(ÿuMìèóšÿÿ‹Eð9XuÿuWÿu Vè£ ƒÄéLƒ}ÿ‹U ‹ÆuŠˆ@G:ËtJuó늈@G:ËtJtÿMuî9]uˆ@;Ó…È8tƒ}u5xÿ‰}ü;þrEìP‹Eü¶PèоÿÿYY…ÀtÿMü9uüsâ‹Ç+Eü¨…Ã}ÿuZ‹E ƒøv:|þ‰};þr!EìP‹E¶P茾ÿÿYY…ÀtÿM9usâ‹E ‹Ï+MöÁtˆëˆ\ÿ8]øt‹Eôƒ`pýjPXéˆèS²ÿÿj"^SSSSS‰0èܱÿÿƒÄ8]øt‹Eôƒ`pý‹Æëd‹È+΃ù|Mxþ‰};þrEìP‹E¶Pè ¾ÿÿYY…ÀtÿM9usâ‹Ç+E¨tˆèð±ÿÿ‹Èj*X‰8]øt‹Môƒapýë8]øt‹Eôƒ`pý3À_^[ÉËÿU‹ì‹E…Àtƒè8ÝÝuPèµÿÿY]ËÿU‹ìƒì¡€A3ʼnEüSV3ÛW‹ñ9„)Au8SS3ÿGWhdê@hSÿðà@…Àt‰=„)Aëÿ\à@ƒøxu Ç„)A9]~"‹M‹EI8t@;ËuöƒÉÿ‹E+ÁH;E}@‰E¡„)Aƒø„¬;Ĥƒø…̉]ø9] u‹‹@‰E ‹5ìà@3À9]$SSÿu•ÀÿuÅPÿu ÿÖ‹ø;û„~Cjà3ÒX÷÷ƒør7D?=wèŽ#‹Ä;ÃtÇÌÌëPè äÿÿY;Ãt ÇÝ݃À‰Eôë‰]ô9]ô„>Wÿuôÿuÿujÿu ÿÖ…À„ã‹5ðà@SSWÿuôÿu ÿuÿ֋ȉMø;Ë„Â÷E t)9]„°;M§ÿuÿuWÿuôÿu ÿuÿÖé;Ë~Ejà3ÒX÷ñƒør9D =wèÏ"‹ô;ótjÇÌ̃ÆëPèJãÿÿY;Ãt ÇÝ݃À‹ðë3ö;ótAÿuøVWÿuôÿu ÿuÿðà@…Àt"SS9]uSSëÿuÿuÿuøVSÿu ÿ°à@‰EøVè¸ýÿÿYÿuôè¯ýÿÿ‹EøYéY‰]ô‰]ð9]u‹‹@‰E9] u‹‹@‰E ÿuè Y‰Eìƒøÿu3Àé!;E „ÛSSMQÿuPÿu è> ƒÄ‰Eô;ÃtÔ‹5èà@SSÿuPÿu ÿuÿÖ‰Eø;Ãu3öé·~=ƒøàw8ƒÀ=wè¹!‹ü;ûtÝÇÌ̃ÇëPè4âÿÿY;Ãt ÇÝ݃À‹øë3ÿ;ût´ÿuøSWè0’ÿÿƒÄ ÿuøWÿuÿuôÿu ÿuÿÖ‰Eø;Ãu3öë%ÿuEøÿuPWÿu ÿuìè‹ð‰uðƒÄ÷Þö#uøWèüÿÿYëÿuÿuÿuÿuÿu ÿuÿèà@‹ð9]ôt ÿuô蘱ÿÿY‹Eð;Ãt 9EtPè…±ÿÿY‹Æeà_^[‹Mü3Íè—•ÿÿÉËÿU‹ìƒìÿuMðè‘•ÿÿÿu(Mðÿu$ÿu ÿuÿuÿuÿuÿu è(üÿÿƒÄ €}üt‹MøƒapýÉËÿU‹ìQQ¡€A3ʼnEü¡ˆ)ASV3ÛW‹ù;Ãu:EøP3öFVhdê@Vÿøà@…Àt‰5ˆ)Aë4ÿ\à@ƒøxu jX£ˆ)A롈)Aƒø„Ï;Äǃø…è‰]ø9]u‹‹@‰E‹5ìà@3À9] SSÿu•Àÿu ÅPÿuÿÖ‹ø;û„«~<ÿðÿÿw4D?=wèÒ‹Ä;ÃtÇÌÌëPèPàÿÿY;Ãt ÇÝ݃À‹Ø…Ûti?PjSèNÿÿƒÄ WSÿuÿu jÿuÿÖ…ÀtÿuPSÿuÿøà@‰EøSèÉúÿÿ‹EøYëu3ö9]u‹‹@‰E9]u‹‹@‰EÿuèAYƒøÿu3ÀëG;EtSSMQÿu Pÿuèi‹ðƒÄ;ót܉u ÿuÿuÿu ÿuÿuÿôà@‹ø;ótV膯ÿÿY‹Çeì_^[‹Mü3Í蘓ÿÿÉËÿU‹ìƒìÿuMðè’“ÿÿÿu$Mðÿu ÿuÿuÿuÿuÿu èþÿÿƒÄ€}üt‹MøƒapýÉËÿU‹ìV‹u…ö„ÿvè¯ÿÿÿvè¯ÿÿÿv è¯ÿÿÿvèþ®ÿÿÿvèö®ÿÿÿvèî®ÿÿÿ6èç®ÿÿÿv èß®ÿÿÿv$è×®ÿÿÿv(èÏ®ÿÿÿv,èÇ®ÿÿÿv0è¿®ÿÿÿv4è·®ÿÿÿv诮ÿÿÿv8è§®ÿÿÿv<蟮ÿÿƒÄ@ÿv@è”®ÿÿÿvD茮ÿÿÿvHè„®ÿÿÿvLè|®ÿÿÿvPèt®ÿÿÿvTèl®ÿÿÿvXèd®ÿÿÿv\è\®ÿÿÿv`èT®ÿÿÿvdèL®ÿÿÿvhèD®ÿÿÿvlè<®ÿÿÿvpè4®ÿÿÿvtè,®ÿÿÿvxè$®ÿÿÿv|è®ÿÿƒÄ@ÿ¶€è®ÿÿÿ¶„è®ÿÿÿ¶ˆèø­ÿÿÿ¶Œèí­ÿÿÿ¶èâ­ÿÿÿ¶”è×­ÿÿÿ¶˜èÌ­ÿÿÿ¶œèÁ­ÿÿÿ¶ è¶­ÿÿÿ¶¤è«­ÿÿÿ¶¨è ­ÿÿƒÄ,^]ËÿU‹ìV‹u…öt5‹;HAtPè}­ÿÿY‹F;LAtPèk­ÿÿY‹v;5PAtVèY­ÿÿY^]ËÿU‹ìV‹u…öt~‹F ;TAtPè7­ÿÿY‹F;XAtPè%­ÿÿY‹F;\AtPè­ÿÿY‹F;`AtPè­ÿÿY‹F;dAtPèï¬ÿÿY‹F ;hAtPèݬÿÿY‹v$;5lAtVèˬÿÿY^]ËÿU‹ì‹ES3ÛVW;Ãt‹} ;ûwè=©ÿÿj^‰0SSSSSèÆ¨ÿÿƒÄ‹Æë<‹u;óuˆëÚ‹Ð8tBOuø;ût BF:ËtOuó;ûuˆèö¨ÿÿj"Y‰‹ñëµ3À_^[]ÃÌÌÌÌÌÌU‹ìV3ÀPPPPPPPP‹U IŠ Àt ƒÂ«$ëñ‹uƒÉÿIƒÁŠ Àt ƒÆ£$sî‹ÁƒÄ ^ÉËÿU‹ìSV‹u3ÛW9]u;óu9] u3À_^[]Ã;ót‹} ;ûwèh¨ÿÿj^‰0SSSSSèñ§ÿÿƒÄ‹ÆëÕ9]uˆëÊ‹U;Óuˆëу}ÿ‹ÆuŠ ˆ@B:ËtOuóëŠ ˆ@B:ËtOtÿMuî9]uˆ;ûu‹ƒ}ÿu‹E jPˆ\ÿXéxÿÿÿˆèî§ÿÿj"Y‰‹ñë‚‹ÿU‹ì‹MS3ÛVW;Ët‹} ;ûwèȧÿÿj^‰0SSSSSèQ§ÿÿƒÄ‹Æë0‹u;óuˆëÚ‹ÑŠˆBF:ÃtOuó;ûuˆè§ÿÿj"Y‰‹ñëÁ3À_^[]ÃÌÌÌÌÌÌÌÌÌÌÌÌÌ‹T$‹L$÷Âu<‹:u. Àt&:au% ätÁè:Au Àt:auƒÁƒÂ äuÒ‹ÿ3ÀÃÀÑàƒÀÃ÷ÂtŠƒÂ:uçƒÁ ÀtÜ÷Ât¤f‹ƒÂ:uÎ ÀtÆ:auÅ ät½ƒÁëˆÌÌÌÌÌÌÌÌU‹ìWV‹u ‹M‹}‹Á‹ÑÆ;þv;ø‚¤ùrƒ=ˆ*AtWVƒçƒæ;þ^_u^_]é,÷ÇuÁéƒâƒùr*ó¥ÿ$•ä‘@‹Çºƒér ƒàÈÿ$…ø@ÿ$ô‘@ÿ$x‘@‘@4‘@X‘@#ÑŠˆŠFˆGŠFÁéˆGƒÆƒÇƒùrÌó¥ÿ$•ä‘@I#ÑŠˆŠFÁéˆGƒÆƒÇƒùr¦ó¥ÿ$•ä‘@#ÑŠˆƒÆÁéƒÇƒùrˆó¥ÿ$•ä‘@IÛ‘@È‘@À‘@¸‘@°‘@¨‘@ ‘@˜‘@‹DŽä‰Dä‹DŽè‰Dè‹DŽì‰Dì‹DŽð‰Dð‹DŽô‰Dô‹DŽø‰Dø‹DŽü‰Düðøÿ$•ä‘@‹ÿô‘@ü‘@’@’@‹E^_Éʈ‹E^_ÉʈŠFˆG‹E^_ÉÃIŠˆŠFˆGŠFˆG‹E^_ÉÃt1ü|9ü÷Çu$Áéƒâƒùr ýó¥üÿ$•€“@‹ÿ÷Ùÿ$0“@I‹Çºƒùr ƒà+Èÿ$…„’@ÿ$€“@”’@¸’@à’@ŠF#шGƒîÁéƒïƒùr²ýó¥üÿ$•€“@IŠF#шGŠFÁéˆGƒîƒïƒùrˆýó¥üÿ$•€“@ŠF#шGŠFˆGŠFÁéˆGƒîƒïƒù‚Vÿÿÿýó¥üÿ$•€“@I4“@<“@D“@L“@T“@\“@d“@w“@‹DމD‹DމD‹DމD‹DމD‹DŽ ‰D ‹DމD‹DމDðøÿ$•€“@‹ÿ“@˜“@¨“@¼“@‹E^_ÉÊFˆG‹E^_ÉÃIŠFˆGŠFˆG‹E^_ÉÊFˆGŠFˆGŠFˆG‹E^_ÉÃÌÌÌÌÌÌÌÌÌÌÌU‹ìV3ÀPPPPPPPP‹U IŠ Àt ƒÂ«$ëñ‹u‹ÿŠ Àt ƒÆ£$sñFÿƒÄ ^ÉËÿU‹ìQQ‹E V‹u‰Eø‹EWV‰EüèƒÏÿY;Çuè£ÿÿÇ ‹Ç‹×ëJÿuMüQÿuøPÿá@‰Eø;Çuÿ\à@…Àt Pè÷¢ÿÿYëÏ‹ÆÁø‹… *AƒæÁæD0€ ý‹Eø‹Uü_^ÉÃjh0ø@èë¢ÿÿƒÎÿ‰u܉uà‹Eƒøþu蜢ÿÿƒ è¢ÿÿÇ ‹Æ‹ÖéÐ3ÿ;Ç|;*Ar!èr¢ÿÿ‰8èX¢ÿÿÇ WWWWWèà¡ÿÿƒÄëÈ‹ÈÁù *A‹ðƒæÁæ‹ ¾L1ƒáu&è1¢ÿÿ‰8è¢ÿÿÇ WWWWW蟡ÿÿƒÄƒÊÿ‹Âë[PèpY‰}ü‹öD0tÿuÿuÿu ÿuè©þÿÿƒÄ‰E܉UàëèÉ¡ÿÿÇ èÑ¡ÿÿ‰8ƒMÜÿƒMàÿÇEüþÿÿÿè ‹EÜ‹Uàè.¢ÿÿÃÿuè­YËÿU‹ìÿ Ahè¹£ÿÿY‹M‰A…Àt ƒI ÇAëƒI A‰AÇA‹Aƒa‰]ËÿU‹ìƒìSVWè¹ÿÿƒeüƒ=)A‹Ø…Žhô@ÿœà@‹ø…ÿ„*‹5(à@hôó@WÿÖ…À„PèL¸ÿÿÇ$äó@W£)AÿÖPè7¸ÿÿÇ$Ðó@W£”)AÿÖPè"¸ÿÿÇ$´ó@W£˜)AÿÖPè ¸ÿÿY£ )A…Àthœó@WÿÖPèõ·ÿÿY£œ)A¡œ)A;ÃtO9 )AtGPèS¸ÿÿÿ5 )A‹ðèF¸ÿÿYY‹ø…öt,…ÿt(ÿÖ…ÀtMøQj MìQjPÿ×…ÀtöEôu M ë9¡”)A;Ãt0Pè¸ÿÿY…Àt%ÿЉEü…Àt¡˜)A;ÃtPèæ·ÿÿY…ÀtÿuüÿЉEüÿ5)AèηÿÿY…Àtÿuÿu ÿuÿuüÿÐë3À_^[ÉËÿU‹ì‹MV3ö;Î|ƒù~ ƒùu¡D Aë(¡D A‰ D Aë讟ÿÿVVVVVÇè6ŸÿÿƒÄƒÈÿ^]ÃjhPø@èÕŸÿÿ3À‹]3ÿ;ß•À;ÇuètŸÿÿÇWWWWWèüžÿÿƒÄƒÈÿëSƒ=„*Au8jèõ¦ÿÿY‰}üSèÖÿÿY‰Eà;Çt ‹süƒî ‰uäë‹uäÇEüþÿÿÿè%9}àuSWÿ5t)Aÿá@‹ð‹Æè•ŸÿÿÃ3ÿ‹]‹uäjèÃ¥ÿÿYÃjèÿˆÿÿYËÿU‹ìì(¡€A3ʼnEüöAVtj èÓ½ÿÿYèªÄÿÿ…Àtjè¬ÄÿÿYöA„ʉ…àýÿÿ‰Üýÿÿ‰•Øýÿÿ‰Ôýÿÿ‰µÐýÿÿ‰½ÌýÿÿfŒ•øýÿÿfŒìýÿÿfŒÈýÿÿfŒ…ÄýÿÿfŒ¥ÀýÿÿfŒ­¼ýÿÿœ…ðýÿÿ‹uE‰…ôýÿÿÇ…0ýÿÿ‰µèýÿÿ‹@üjP‰…äýÿÿ…ØüÿÿjPèªÿÿ…ØüÿÿƒÄ ‰…(ýÿÿ…0ýÿÿjÇ…Øüÿÿ@‰µäüÿÿ‰…,ýÿÿÿTà@…(ýÿÿPÿPà@jèmŠÿÿÌÌÌU‹ìSVWUjjh˜™@ÿuèV"]_^[‹å]ËL$÷A¸t2‹D$‹Hü3Èè"…ÿÿU‹h‹P(R‹P$RèƒÄ]‹D$‹T$‰¸ÃSVW‹D$UPjþh ™@dÿ5¡€A3ÄPD$d£‹D$(‹X‹p ƒþÿt:ƒ|$,ÿt;t$,v-4v‹ ³‰L$ ‰H ƒ|³uh‹D³èI‹D³è_ë·‹L$d‰ ƒÄ_^[Ã3Àd‹ y ™@u‹Q ‹R 9Qu¸ÃSQ»”Aë SQ»”A‹L$ ‰K‰C‰k UQPXY]Y[ÂÿÐËÿU‹ìƒìVWÿuMìè%„ÿÿ‹E‹u 3ÿ;Çt‰0;÷u,èmœÿÿWWWWWÇèõ›ÿÿƒÄ€}øt‹Eôƒ`pý3ÀéØ9}t ƒ}|Ƀ}$ËMìSЉ}ü~ƒ¹¬~EìP¶ÃjPè¹ÿÿ‹MìƒÄ 닑ȶ÷Bƒà…ÀtŠGëÇ€û-uƒMë€û+uŠG‹E…ÀŒKƒø„Bƒø$9…Àu*€û0t ÇE ë4зɶÒÁá Ê9M u Hë·Ñ9U t @f¶·Éf;ËuÇ·É9M u8]üt‹Møƒapýë8]üt‹Eøƒ`pý3À^[ÉËÿU‹ìjÿu ÿuè2ÿÿÿƒÄ ]ÃÌÌÌBÿ[ä$d$3ÀŠD$S‹ØÁà‹T$÷ÂtŠ ƒÂ:ËtÏ„ÉtQ÷Âuë ØW‹ÃÁãV Ø‹ ¿ÿþþ~‹Á‹÷3Ëðùƒñÿƒðÿ3Ï3ƃÂáu%tÓ%uæ€uÄ^_[3ÀËBü:Ãt6„Àtï:ãt'„ätçÁè:Ãt„ÀtÜ:ãt„ätÔë–^_Bÿ[ÃBþ^_[ÃBý^_[ÃBü^_[Ãÿ%Ðà@‹ÿU‹ì‹US3Û;ÓuèH{ÿÿSSSSSÇèÐzÿÿƒÄƒÈÿë 8tß‹M ;ËtØ‹;ÃtÒ8tÎSQRèƒÄ []ËÿU‹ìƒì‹UV‹ujþX‰Eì‰Uä;ðuèÿzÿÿƒ èäzÿÿÇ ƒÈÿéˆS3Û;ó|;5*Ar'èÕzÿÿ‰è»zÿÿSSSSSÇ èCzÿÿƒÄƒÈÿéQ‹ÆÁøW<… *A‹ƒæÁæÆŠHöÁuèzÿÿ‰èuzÿÿÇ ëjúÿÿÿwP‰]ð;Ó„öÁ…ÿ9] t7Š@$ÀÐøˆEþ¾ÀHjYtHu‹Â÷Шtƒâþ‰U‹E ‰Eôé‹Â÷Шu!è#zÿÿ‰è zÿÿÇSSSSSè‘yÿÿƒÄë4‹ÂÑè‰M;Ár‰Eÿuè|ÿÿY‰Eô;ÃuèÑyÿÿÇ èÙyÿÿǃÈÿéhjSSÿuè|Öÿÿ‹‰D(‹EôƒÄ‰T,‹ÎöAHttŠI€ù tl9]tgˆ‹@ÿMÇEðÆD 8]þtN‹ŠL%€ù tC9]t>ˆ‹@ÿM€}þÇEðÆD% u$‹ŠL&€ù t9]tˆ‹@ÿMÇEðÆD& SMèQÿuP‹ÿ4ÿ,á@…À„{‹Mè;ËŒp;M‡g‹MðDö€„æ€}þ„;Ët ‹Mô€9 u€ë€ û‹]ô‹EðÉ]‰Eð;؃ЋMŠ<„®< t ˆCA‰Mé‹EðH;ÈsA€8 u AA‰MÆ ëu‰EëmÿEjEèPjEÿP‹ÿ4ÿ,á@…Àu ÿ\à@…ÀuEƒ}èt?‹öDHt€}ÿ t¹Æ ‹ŠMÿˆLë%;]ôu€}ÿ t jjÿjÿÿuèØÔÿÿƒÄ€}ÿ tÆ C‹Eð9E‚Gÿÿÿë‹Dö@u€ëŠˆC‹Ã+Eô€}þ‰Eð…Ð…À„ÈKŠ „ÉxCé†3À@¶Éëƒø;]ôrK¶ @€¹àAt芶ʾ‰àA…Éu è|wÿÿÇ*ëzA;ÈuØë@‹ÎöAHt$CƒøˆQ| Š‹ˆT%Cƒøu Š‹ˆT&C+Øë÷Ø™jRPÿuèþÓÿÿƒÄ‹Eä+]ôÑèPÿu Sÿuôjhéýÿìà@‰Eð…Àu4ÿ\à@Pè!wÿÿYƒMìÿ‹Eô;E tPèUzÿÿY‹Eìƒøþ…‹‹Eð郋Eð‹3É;ÕÁÀ‰Eð‰L0ëÆ;Ët‹Môfƒ9 u€ë€ û‹]ô‹EðÉ]‰Eð;؃ÿ‹E·fƒù„×fƒù tf‰ CC@@‰Eé´‹MðƒÁþ;ÁsHfƒ9 u ƒÀ‰Ej 鎉M鄃EjEèPjEøP‹ÿ4ÿ,á@…Àu ÿ\à@…Àu[ƒ}ètU‹öDHt(fƒ}ø t²j Xf‰‹ŠMøˆL‹ŠMùˆL%‹ÆD& ë*;]ôufƒ}ø t…jjÿjþÿuèšÒÿÿƒÄfƒ}ø tj Xf‰CC‹Eð9E‚ÿÿÿë‹tö@u€ëf‹f‰CC+]ô‰]ðé‘þÿÿÿ\à@j^;ÆuèuuÿÿÇ è}uÿÿ‰0éiþÿÿƒøm…Yþÿÿ‰]ìé\þÿÿ3À_[^ÉÃjhøø@è‹uÿÿ‹EƒøþuèEuÿÿƒ è*uÿÿÇ ƒÈÿé¾3ö;Æ|;*Ar!èuÿÿ‰0èuÿÿÇ VVVVVèŠtÿÿƒÄëÉ‹ÈÁù *A‹øƒçÁç‹ ¾L9ƒát¿¹ÿÿÿ;MÉAuèÎtÿÿ‰0è´tÿÿÇë°PèãÿÿY‰uü‹öD8tÿuÿu ÿuè~ùÿÿƒÄ ‰Eäëè~tÿÿÇ è†tÿÿ‰0ƒMäÿÇEüþÿÿÿè ‹EäèêtÿÿÃÿuèiãÿÿYËÿU‹ìƒì0S3ÛöE€VW‹ð‰]àˆ]þÇEÐ ‰]Ôt ‰]ØÆEÿë ÇE؈]ÿEàPè Y…Àt SSSSSènrÿÿƒÄ‹M¸€…Èu÷Á@u9Eàt€Mÿ€‹Áƒà+úÀ¿€tGHt.Ht&èÓsÿÿ‰ƒÿè¶sÿÿj^SSSSS‰0è?sÿÿƒÄé‰UøëöÁt÷ÁuîÇEø@ë‰}ø‹EjY+Át7+Át*+Át+Átƒè@u¡9}ø”À‰EðëÇEðëÇEðë ÇEðë‰]ð‹Eº#¹;Á¿;t0;Ãt,;Çt=„”=…@ÿÿÿÇEìë/ÇEìë&ÇEìë=t=t`;Â…ÿÿÿÇEì‹EÇEô€…Çt‹  A÷Ñ#M„ÉxÇEô¨@tMôMøƒMð©t }ô¨ tMôëÇEì릨tMôè£áÿÿ‰ƒøÿuèjrÿÿ‰ƒÿèMrÿÿÇ鎋E‹=á@SÿuôÇÿuìEÐPÿuðÿuøÿu ÿ׉Eäƒøÿum‹Mø¸À#È;Èu+öEt%eøÿÿÿSÿuôEÐÿuìPÿuðÿuøÿu ÿ׉Eäƒøÿu4‹6‹ÆÁø‹… *AƒæÁæD0€ þÿ\à@PèÛqÿÿYè¯qÿÿ‹étÿuäÿ@à@;ÃuD‹6‹ÆÁø‹… *AƒæÁæD0€ þÿ\à@‹ðVè˜qÿÿYÿuäÿá@;óu°è_qÿÿÇ ë£ƒøu€Mÿ@ë ƒøu€Mÿÿuäÿ6è4Þÿÿ‹‹ÐƒàÁú‹• *AYÁàYŠMÿ€ÉˆL‹‹ÐƒàÁú‹• *AÁàD$€ €ˆMý€eýHˆMÿ…€öÁ€„±öEtqjƒÏÿWÿ6è£ƒÄ ‰Eè;ÇuèÖpÿÿ8ƒtMÿ6èéÙÿÿéúþÿÿjEüPÿ6ˆ]üè’õÿÿƒÄ …Àu€}üu‹Eè™RPÿ6è ƒÄ ;ÇtÃSSÿ6èFƒÄ ;Çt³öEÿ€„0¿@¹@…}u‹Eà#Çu Më E‹E#Ç;ÁtD=t)=@t"=t)=@t"=t=@uÆEþë‹M¸#È;Èu ÆEþëˆ]þ÷E„µöEÿ@‰]è…¨‹Eø¹À#Á=@„·=€tw;Á…„‹Eì;Æyƒøvƒøv0ƒø…f¾Eþ3ÿH„&H…RÇEèÿþÇEìéjSSÿ6è8ÌÿÿƒÄ ÂtÇSSSÿ6è'Ìÿÿ#ƒÄƒøÿ„ŽþÿÿjEèPÿ6è/ôÿÿƒÄ ƒøÿ„uþÿÿƒøtkƒø…­}èuYÆEþéÜ‹Eì;Æуø†bÿÿÿƒø‡PÿÿÿjSSÿ6è¸ËÿÿƒÄ „CÿÿÿSSSÿ6è£ËÿÿƒÄ#ƒøÿ…‘éþÿÿ‹Eè%ÿÿ=þÿuÿ6èß×ÿÿYè¤nÿÿj^‰0‹Æéd=ÿþuSjÿ6èXƒÄ ƒøÿ„ÀýÿÿÆEþëASSÿ6è=ƒÄ ë™ÇEèÇEì‹Eì+ÇPD=èPÿ6è¸ÿÿƒÄ ƒøÿ„€ýÿÿø9}ìÛ‹‹ÈÁù‹  *AƒàÁàD$Š2Mþ€á0‹‹ÈÁù‹  *AƒàÁàD$‹MŠÁéÀá€â ʈ8]ýu!öEt‹‹ÈƒàÁù‹  *AÁàD€ ‹}ø¸À‹Ï#È;Èu|öEtvÿuäÿá@SÿuôEÐjPÿuðçÿÿÿWÿu ÿá@ƒøÿu4ÿ\à@Pè›mÿÿ‹‹ÈƒàÁù‹  *AÁàD€ þÿ6èÏÚÿÿYé˜ûÿÿ‹6‹ÎÁù‹  *AƒæÁ手Ã_^[ÉÃjhù@èomÿÿƒMäÿ3ö‰uà3À9u•À;Æuè mÿÿÇVVVVVè‘lÿÿƒÄƒÈÿër‰uüÿuj@ÿu ÿuEàPEäè‰øÿÿƒÄ‰EÜÇEüþÿÿÿè‹}Ü;þt<è¹lÿÿ‰8ë¿3ö9uàt+9uÜt‹EäÁø‹MäƒáÁá‹… *AD€ þÿuäèÛÿÿYËEäè mÿÿËÿU‹ìQQV3ö9uuèelÿÿVVVVVÇèíkÿÿƒÄƒÈÿëJ9u tÞÿuEøPEüPÿuÿu è|ƒÄƒøÿtØÿuøÿuüÿujèUÿuü‹ðè}oÿÿÿuøèuoÿÿƒÄ‹Æ^ÉËÿU‹ìƒìSW‹}3Û‰}ü;ûu èåkÿÿSSSSSÇèmkÿÿƒÄƒÈÿéá8tÜ‹E ;ÃtÕ‹;ÃtÏ8tËVj\Wè j/W‹ðè ƒÄ;Ã…;ó…ƒj:Wè=ïÿÿ‹ðYY;óusWèIšÿÿ‹ðƒÆjVèímÿÿ‹øƒÄ ‰}ü;û„­htô@VWèkÃÿÿƒÄ …Àt SSSSSè¯iÿÿƒÄÿuVWèØÁÿÿƒÄ …Àt SSSSSè‘iÿÿƒÄw‹}ë ;ót;Æv‹ðƒMðÿj.Vèh YY…Àt,Sÿuüè YY…À…ìÿuÿu ÿuüè`þÿÿƒÄ ‰EðéÓÿuüè–™ÿÿ‹ðƒÆjVè:mÿÿƒÄ ‰Eø;ÃuƒÈÿé½ÿuüVPè¸ÂÿÿƒÄ …Àt SSSSSèühÿÿƒÄÿuüèQ™ÿÿ‹ø}øYèvjÿÿ‹‰Eì‹Eø+÷ðÇEôìA‹Eôÿ0VWèrÂÿÿƒÄ …Àt SSSSSè¶hÿÿƒÄSÿuøè] YY…Àtƒmô}ôàA}Äëè jÿÿÿu‹Mìÿu ‰ÿuøè”ýÿÿƒÄ ‰Eðÿuøèlmÿÿ‹}Y9}üt ÿuüè[mÿÿY‹Eð^_[ÉËÿU‹ìƒìSVW3ÛjSSÿu‰]ð‰]ôè–Æÿÿ‰Eè#ƒÄ‰UìƒøÿtYjSSÿuèzÆÿÿ‹È#ʃăùÿtA‹u ‹}+ðúˆÆ;󆼻Sjÿ4á@Pÿdà@‰Eü…ÀuèciÿÿÇ èXiÿÿ‹_^[ÉÃh€ÿuèŠYY‰Eø…ÿ| ;ór‹Ãë‹ÆPÿuüÿu謫ÿÿƒÄ ƒøÿt6™+ðúxÓ…öwÏ‹uðÿuøÿuèFYYÿuüjÿ4á@Pÿ`à@3Ûé†èóhÿÿƒ8u èÖhÿÿÇ ƒÎÿ‰uôë½;ûq|;óskSÿuÿu ÿuèÅÿÿ#ƒÄƒøÿ„Dÿÿÿÿuè›ÖÿÿYPÿ0á@÷ØÀ÷ØH™‰Eð#‰Uôƒøÿu)èwhÿÿÇ èhÿÿ‹ðÿ\à@‰‹uð#uôƒþÿ„öþÿÿSÿuìÿuèÿuèÅÿÿ#ƒÄƒøÿ„Ùþÿÿ3ÀéÙþÿÿ‹ÿU‹ìV‹uVè"ÖÿÿYƒøÿuèhÿÿÇ ƒÈÿëMWÿujÿu Pÿá@‹øƒÿÿuÿ\à@ë3À…Àt PèhÿÿYƒÈÿë‹ÆÁø‹… *AƒæÁæD0€ ý‹Ç_^]ËÿU‹ìS‹] V‹u‹ÆÁø… *A‹ƒæÁæ 0ŠA$ÀW¶y¾Àç€Ñøû@tPû€tBût&ûtûu=€I€‹ L1$Š€â€Êˆë'€I€‹ L1$Š€â‚€Êëè€aë €I€‹ L1$€!€…ÿ_^[u¸€]Ã÷ØÀ%À@]ËÿU‹ì‹EV3ö;ÆuèêfÿÿVVVVVÇèrfÿÿƒÄjXë ‹ d*A‰3À^]ËÿU‹ìƒìh‹ES3ÛW‰]ôˆ]ÿ;Ãtƒøt~ƒø~ ƒøu ÆEÿ‹E‰Eðë8èfÿÿ‰èƒfÿÿSSSSSÇè fÿÿƒÄƒÈÿé®@8uûH8tÆ ‹Á8uëVjD^VE˜SPèÔIÿÿ‰u˜‹5*AƒÄ ;ót+Fÿ‹È‹ÐÁù‹  *AƒâÁâ8\uNH;óuà;óŒ@þ23ƒ4‹ÆkÀƒÀf‰EÊ·ÀjPèghÿÿYY‰EÌ;Ä;ó‰0‹EÌH|0‰]ø~9‹Eø‹ÐƒàÁúÁà• *AŠPöÂuˆ‹‰ëˆƒÿÿEøAƒÇ9uø|Ê‹EÌ8]ÿt,H3ÒD0ƒþ}‹þëj_;×} ˆƒÿBAƒÀëäÇEôèjeÿÿ‰EÜPE˜PSÿuÿuôjSSÿuðÿu ÿ à@‹ðÿ\à@ÿuÌ‹øè‘hÿÿY;óu Wè?eÿÿYëXƒ}uSè¤Qÿÿ‹5á@9]ujÿÿuÜÿà@EìPÿuÜÿà@‹]ìëƒ}uÿuÜÿÖë‹]ÜÿuàÿÖ‹ÃëèÄdÿÿÇ ƒÈÿ^_[ÉËÿU‹ìƒì@¡€A3ʼnEü‹M ‹ESVW¾xô@}ð¥¥f¥‰MÔ‹M3Û‰Mà‹M¤j‰EÈ‹ø‹‰Mè‰]܉]ì‰]Ä^ëPè2“ÿÿƒÇt‹Y;ÃuìjV‰uÌèÊfÿÿ‹uàYY‰;Ãu#‹Eè‰è4dÿÿÇ è?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~=EncodePointerKERNEL32.DLLDecodePointerFlsFreeFlsSetValueFlsGetValueFlsAllocruntime error TLOSS error SING error DOMAIN error R6034 An application has made an attempt to load the C runtime library incorrectly. Please contact the application's support team for more information. R6033 - Attempt to use MSIL code from this assembly during native code initialization This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. R6032 - not enough space for locale information R6031 - Attempt to initialize the CRT more than once. This indicates a bug in your application. R6030 - CRT not initialized R6028 - unable to initialize heap R6027 - not enough space for lowio initialization R6026 - not enough space for stdio initialization R6025 - pure virtual function call R6024 - not enough space for _onexit/atexit table R6019 - unable to open console device R6018 - unexpected heap error R6017 - unexpected multithread lock error R6016 - not enough space for thread data This application has requested the Runtime to terminate it in an unusual way. Please contact the application's support team for more information. R6009 - not enough space for environment R6008 - not enough space for arguments R6002 - floating point support not loaded Microsoft Visual C++ Runtime Library ...Runtime Error! Program: À À–ÀÀŽÀÀÀ‘À’À“À€€†€€†€†‚€EEE………00€P€ˆ('8PW€700PPˆ (€ˆ€€`h`hhhxppwpp ((((( H„„„„„„„„„„‚‚‚‚‚‚ h(((( H„„„„„„„„„„‚‚‚‚‚‚ H€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@abcdefghijklmnopqrstuvwxyz[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ABCDEFGHIJKLMNOPQRSTUVWXYZ{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿHH:mm:ssdddd, MMMM dd, yyyyMM/dd/yyPMAMDecemberNovemberOctoberSeptemberAugustJulyJuneAprilMarchFebruaryJanuaryDecNovOctSepAugJulJunMayAprMarFebJanSaturdayFridayThursdayWednesdayTuesdayMondaySundaySatFriThuWedTueMonSunGetProcessWindowStationGetUserObjectInformationAGetLastActivePopupGetActiveWindowMessageBoxAUSER32.DLLSunMonTueWedThuFriSatJanFebMarAprMayJunJulAugSepOctNovDecCONOUT$.com.exe.bat.cmd.\SystemRootH€AÐô@8°i ™þÿÿÿÔÿÿÿþÿÿÿÜ@þÿÿÿÈÿÿÿþÿÿÿ¼#@þÿÿÿˆÿÿÿþÿÿÿú%@þ%@þÿÿÿÀ%@Ô%@þÿÿÿŒÿÿÿþÿÿÿh5@l5@þÿÿÿÔÿÿÿþÿÿÿ;@þÿÿÿÐÿÿÿþÿÿÿá;@þÿÿÿÌÿÿÿþÿÿÿk=@7=@þÿÿÿÔÿÿÿþÿÿÿð>@þÿÿÿÔÿÿÿþÿÿÿ#@@þÿÿÿÔÿÿÿþÿÿÿMA@iA@þÿÿÿÔÿÿÿþÿÿÿ]G@þÿÿÿÌÿÿÿþÿÿÿ+K@þÿÿÿÔÿÿÿþÿÿÿ›N@þÿÿÿÔÿÿÿþÿÿÿÝP@þÿÿÿìP@þÿÿÿØÿÿÿþÿÿÿŸR@þÿÿÿ«R@þÿÿÿÔÿÿÿþÿÿÿeY@þÿÿÿØÿÿÿþÿÿÿ [@[@þÿÿÿØÿÿÿþÿÿÿ][@a[@þÿÿÿÀÿÿÿþÿÿÿ¸^@þÿÿÿÐÿÿÿþÿÿÿH_@__@þÿÿÿÔÿÿÿþÿÿÿ¹j@þÿÿÿÐÿÿÿþÿÿÿÊl@þÿÿÿÔÿÿÿþÿÿÿÎy@þÿÿÿÐÿÿÿþÿÿÿÞ@þÿÿÿÐÿÿÿþÿÿÿ¿‚@þÿÿÿÌÿÿÿþÿÿÿ´•@þÿÿÿÐÿÿÿþÿÿÿM˜@þÿÿÿÐÿÿÿþÿÿÿä¡@þÿÿÿÔÿÿÿþÿÿÿ[¦@þÿÿÿÈÿÿÿþÿÿÿ!¨@]§@þÿÿÿÐÿÿÿþÿÿÿÜ®@þÿÿÿÐÿÿÿþÿÿÿøÂ@þÿÿÿÌÿÿÿþÿÿÿ›Ê@\ùàœú¸úÎúäúöúû$û<ûTûhûpû‚ûû¢û´ûÆûÖûäûüûü$ü@ü^ürü‚üŽüšü¦ü¾üÖüàüìüþü ýý&ý0ý@ýVýbýrýšý´ýÌýæýüýþ$þ2þLþ\þrþŒþ˜þ¦þ¶þÆþØþìþüþÿ"ÿ4ÿFÿXÿjÿvÿ„ÿ”ÿªÿºÿÊÿØÿêÿüÿ$0@RRGenerateConsoleCtrlEventÆGetExitCodeProcessnWaitForSingleObject•CreateProcessA¯SetConsoleCtrlHandlerõGetModuleFileNameAÚEnterCriticalSectionôLeaveCriticalSectionúGetModuleHandleW+Sleep"GetProcAddressExitProcesspGetCommandLineA<GetStartupInfoAðSetHandleCount>GetStdHandleØGetFileType¿DeleteCriticalSection7TerminateProcessªGetCurrentProcessHUnhandledExceptionFilterSetUnhandledExceptionFilterÖIsDebuggerPresentçGetLastError¦HeapFree¢HeapAlloc\GetCPInfoÅInterlockedIncrementÁInterlockedDecrementSGetACPGetOEMCPàIsValidCodePage>TlsGetValue<TlsAlloc?TlsSetValue=TlsFreeôSetLastError®GetCurrentThreadId—WriteFileöLoadLibraryAºInitializeCriticalSectionAndSpinCountKFreeEnvironmentStringsAÀGetEnvironmentStringsLFreeEnvironmentStringsW„WideCharToMultiByteÂGetEnvironmentStringsW¤HeapCreateaVirtualFreeYQueryPerformanceCounterjGetTickCount«GetCurrentProcessIdSGetSystemTimeAsFileTimešRtlUnwind©HeapReAlloc^VirtualAlloc„GetConsoleCP–GetConsoleModeBFlushFileBuffersæLCMapStringAMultiByteToWideCharèLCMapStringW@GetStringTypeACGetStringTypeWéGetLocaleInfoAçSetFilePointer«HeapSizeDCloseHandleŒWriteConsoleAšGetConsoleOutputCP–WriteConsoleWSetStdHandleyCreateFileASCompareStringAVCompareStringWØSetEnvironmentVariableAKERNEL32.dllnReadFileÕSetEndOfFile&GetProcessHeapÊGetFileAttributesAÀ+AÀ+ANæ@»±¿Dê#@lâ@\â@ÿÿÿÿ€         ! 5A CPR S WY l m pr € ‚ ƒ„ ‘)ž ¡¤ § ·Î×   abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZhA¤`‚y‚!¦ß¡¥Ÿàü@~€ü¨Á£Ú£ þ@þµÁ£Ú£ þAþ¶Ï¢ä¢å¢è¢[þ@~¡þQQÚ^Ú _ÚjÚ2ÓØÞàù1~þlí@þÿÿÿCAAAAAHAhë@ðï@pñ@ˆA˜A˜AhAÿÿÿÿÿÿÿÿøè@Ìè@  è@ è@Üç@¬ç@ˆç@\ç@$ç@üæ@Äæ@Œæ@dæ@Dæ@àå@ ¨å@!°ä@"ä@xä@yðã@zàã@üÜã@ÿÌã@^˜@^˜@^˜@^˜@^˜@^˜@^˜@^˜@^˜@^˜@x hë@jí@˜ó@”ó@ó@Œó@ˆó@„ó@€ó@xó@pó@hó@\ó@Pó@Hó@<ó@8ó@4ó@0ó@,ó@(ó@$ó@ ó@ó@ó@ó@ó@ ó@ó@øò@ðò@èò@(ó@àò@Øò@Ðò@Äò@¼ò@°ò@¤ò@ ò@œò@ò@|ò@pò@ ˆA.DAŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AHA. “€pðñÿÿPSTPDTÐAAÿÿÿÿÿÿÿÿþÿÿÿþÿÿÿÿÿÿÿ;Zx—µÔó0Nmÿÿÿÿ:Yw–´Óò/Mllô@dô@\ô@Tô@setuptools-20.7.0/setuptools/gui-64.exe0000664000175000017500000022300012702524020020613 0ustar travistravis00000000000000MZÿÿ¸@غ´ Í!¸LÍ!This program cannot be run in DOS mode. $#^¤›g?ÊÈg?ÊÈg?ÊÈ@ù±Èd?ÊÈg?ËÈ:?ÊÈÚp\Èc?ÊÈymNÈC?ÊÈym_Èm?ÊÈymIÈ ?ÊÈym[Èf?ÊÈRichg?ÊÈPEd†±‹Qð#  ÖlÌ+@p€(` ð.textüÔÖ `.rdata¸)ð*Ú@@.dataä5 @À.pdata ` @@H‰\$H‰l$H‰t$H‰|$ ATAUAVHƒì L‹áHƒÉÿ3ÀI‹üºò®H÷ÑD HyÿHcÈèP 3ö3íLcïÆ"HXL‹ð…ÿ~e€A¶ ,€ù\uÿÆë'€ù"u …ö~D‹Æ²\H‹Ë‹þèj Hß+öÆ\HÿÃë3öA¶,HÿÅHÿÃI;íˆCÿ|¸…ö~D‹Æ²\H‹Ë‹þè5 HßH‹l$HH‹t$PH‹|$XÆ"ÆCH‹\$@I‹ÆHƒÄ A^A]A\ÃÌÌÌÌÌÌÌÌÌH‰\$WHì`H‹¼H3ÄH‰„$PH‹ÙH‹Á¶ H‹ú„ÉtHÿÀ€ù/uÆ@ÿ\Š„ÉuîH„$@LŒ$@LD$@HT$0H‹ËH‰D$ èO€|$0…®€|$@\„£H„$@LŒ$@LD$@HT$0H‹ÏH‰D$ èHƒÉÿ3ÀH|$@ò®HD$@H÷ÑHÿÈHÿÉHÈ€9\uHÿÉ€9\tHD$@H;Èr ÆHÿÉ€9\uëLD$@HT$0HŒ$@L‹ËHÇD$ èß º¹èŒ H”$@뺹ès H‹ÓA¸H‹ÈH‹øè» H‹ÇH‹Œ$PH3ÌèH‹œ$€HÄ`_ÃÌÌÌÌÌÌÌH‰\$H‰l$H‰t$H‰|$ ATAUAVHƒì H‹ÙHƒÉÿ3ÀL‹êH‹ûPò®H÷ÑHÿÉè÷ 3ÿH‹óA‰}¾ L‹ðE3äH‰èe…ÀtD¾KHÿÃèP…Àuð¶+HÿÃ@„ít[@¾Íè8…ÀtE…ätI@€ý\uÿÇëÙ@€ý"u@öÇu3ÀE…ä”À@2íD‹àÑÿ…ÿtL‹Ç²\H‹ÎèÌ H÷3ÿ@„ít¢@ˆ.HÿÆëš…ÿtL‹Ç²\H‹Îè© H÷3ÿÆAÿEIcEHÿÆI‰4Æ@„ít&¾ è±…Àt¾KHÿÃè …Àuð€;…GÿÿÿH‹\$@H‹l$HH‹t$PH‹|$XI‹ÆHƒÄ A^A]A\ÃÌÌÌÌÌHƒì(…Éu‹ ‚!…Ét3Òÿ6ܸHƒÄ(ÃÌÌÌÌÌÌÌÌÌÌÌÌH‰\$WHìà3À3ÿH‹ÙHL$pDGh3Ò‰¼$ðH‰D$PH‰D$XH‰D$`èÖWH ŒÿÿÿÇD$phÿîÛL\$PHD$pL‰\$HH‰D$@H‰|$8H‰|$0E3ÉE3ÀH‹Ó3ɉ|$(ÇD$ ÿ«Û…Àu(èúH«ÞHH`èr3ÀH‹œ$øHÄà_ËD$`H‹L$PƒÊÿ‰• ÿ_ÛH‹L$PH”$ðÿDÛ…Àu(è£H,ÞHH`è3ÀH‹œ$øHÄà_Ë„$ðH‹œ$øHÄà_ÃÌÌÌÌÌÌÌÌH‰\$H‰l$H‰t$WATAUHƒì L‹éHƒÉÿ3À»I‹ýIcèò®H;ÝH‹òH÷ÑL‹ËLQ}J‹<ÊHƒÉÿ3Àò®IÿÁH÷ÑDÑL;Í|æIcÊH‹ÓèHÌÝM‹ÅH‹ÈL‹àèHƒÉÿ3ÀI‹ýò®H;ÝH÷ÑLiÿ}0L‹ÞIcÍH•ÝIÌèåH‹<ÞHƒÉÿ3ÀHÿÃò®H÷ÑDéH;Ý|ÐH‹\$@H‹l$HH‹t$PI‹ÄHƒÄ A]A\_ÃÌÌÌ@SWAVAWHìXH‹» H3ÄH‰„$0L‹òD‰D$ LcùHT$0A¸3ÉÿúÙHƒÉÿ3ÀH|$0ò®H÷ÑHD /HL$0H;Áv€8.tHT$0ÆHÿÈH;ÂwëÆ3ÀHƒÉÿH|$03Òò®H‹:ÝHL$0H‰Gÿ‹3݉Gè׸‹Øƒøÿu"èÏLD$0HûÜHH`èBCéùH”$0A¸‹ÈH‰¬$è¯HcÈH¼ 0‹ËèKˆH”$0HÿÊHÿÂH;×s¶„Àt< t< uéÆHŒ$0HÜA¸è$…Àt%H‹YÜHŒ$0H‰‹P܉A¶J܈A HT$$HŒ$2èùúÿÿHT$0H‹8H‹ØH‹ÏèvùÿÿH‹èH…Àu èéHÚÛL‹ÇHH`è^Eé H‰´$P‹t$$L‰¤$HL‰¬$@E,7ºAEHcÈèÁH‹ÍL‹àè"øÿÿƒþI‰$I|$~ HƒÃÿÎH‹ èøÿÿHƒÇHƒÃHƒîH‰GøuæHL$0èê÷ÿÿ»HƒÇI;ßH‰Gø}!„I‹ ÞèÇ÷ÿÿHÿÃHƒÇI;ßH‰Gø|çƒ|$ H‹´$PHÇt*I‹ÔH‹Í躥èHÚÚHH`L‹Åèv¸ëE‹ÅI‹ÔH‹ÍèyüÿÿH‹ÈèAûÿÿL‹¤$HL‹¬$@H‹¬$H‹Œ$0H3Ìè‰ HÄXA_A^_[ÃÌÌÌÌÌÌÌÌÌÌÌH‹i‹ _A¸éøüÿÿH‹ÄH‰PH‰HL‰@L‰H SVWATHƒì8H‹ù3Û‹ó‹ÃH;Ë•À;Ãu'è&ÇH‰\$ E3ÉE3À3Ò3Éè¦%ƒÈÿé‹ÃH;Ó•À;Ãu'è]&ÇH‰\$ E3ÉE3À3Ò3Éès%ƒÈÿéâLd$pèùöG@…•H‹Ïèæ#ƒøÿt*ƒøþt%HcÐH‹ÊHÁùLÇ)ƒâHkÒXIÈH % ëH  H‹ÑL¢)öB8u%ƒøÿtƒøþtHcÈH‹ÁHÁøƒáHkÉXI ÀöA8€t"è®%ÇH‰\$ E3ÉE3À3Ò3ÉèÄ$ƒÎÿ;óu*H‹ÏèM‹ØM‹ÌE3ÀH‹T$hH‹Ïè`‹ðH‹×‹ËèH‹Ï賋ÆHƒÄ8A\_^[ÃÌÌÌH‰Ã@SHƒì ‹\;»…Àu¸ë;ÃLÃHcȺ‰9;è&H‰ +H…Àu$PH‹Ë‰;èç%H‰ð*H…Àu¸ëx3ÉHH‰HƒÂ0HƒÁHƒët H‹Â*ëåE3ÀHEHI‹ÈLh(I‹ÀHÁøƒáI‹ÂHkÉXL‹Iƒúÿt IƒúþtM…ÒuÇþÿÿÿIÿÀHƒÂ0Iƒéu¼3ÀHƒÄ [ÃÌÌHƒì(è‡)€=$tè'H‹ F*HƒÄ(éÁ&Ì@SHƒì H‹ÙH lH;Ùr:HðH;Øw.H‹ÓH¸«ªªªªªª*H+ÑH÷êHÁúH‹ÊHÁé?Lè<+ºkë HK0ÿSÔHƒÄ [ÃÌ@SHƒì ƒùH‹Ú}ƒÁè+ºkë HJ0ÿ%ÔHƒÄ [ÃÌÌÌHƒì(HáH;Êr7HeH;Èw+ºqH+ÊH¸«ªªªªªª*H÷éHÁúH‹ÊHÁé?Lè¯)ë HƒÁ0ÿÓÓHƒÄ(ÃÌÌHƒì(ƒù}ºrƒÁè†)ë HJ0ÿªÓHƒÄ(ÃÌ@SHƒì ƒd$@LD$@è£*H‹ØH…Àu9D$@tè#H…Àt èö"‹L$@‰H‹ÃHƒÄ [ÃÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌff„H‹ÁIƒørS¶ÒI¹I¯ÑIƒø@rH÷ÙƒátL+ÁH‰HÈM‹ÈIƒà?IÁéu9M‹ÈIƒàIÁétfffH‰HƒÁIÿÉuôM…Àt ˆHÿÁIÿÈuöÃ@fffffIùs0H‰H‰QH‰QHƒÁ@H‰QØH‰QàIÿÉH‰QèH‰QðH‰QøuØë”fDHÃHÃQHÃQHƒÁ@HÃQØHÃQàIÿÉHÃQèHÃQðHÃQøuÐð€ $éTÿÿÿÌÌÌÌÌÌÌÌÌÌÌÌff„L‹ÙM Àt$H+ÊöÂt(Š„Àˆ„ãHÿÂIÿÈtöÂuæë I‹ÃÃH‰HƒÂH‹Iƒèr&I¹ÿþþþþþþ~LÈL‹ÐIƒòÿM3ÑI¹M…ÑtÉIƒÀ„‹„Àˆ„„HÿÂIÿÈtx„äˆ$tuHÿÂIÿÈtiHÁè„ÀˆtbHÿÂIÿÈtV„äˆ$tSHÿÂIÿÈtGHÁè„Àˆt@HÿÂIÿÈt4„äˆ$t1HÿÂIÿÈt%Áè„ÀˆtHÿÂIÿÈt„äˆ$tHÿÂIÿÈ…<ÿÿÿI‹ÃÃHÊH3ÒIƒørEöÁt HÿÁˆIÿÈëñIƒè rH‰H‰QH‰QH‰QHƒÁ Iƒè sçIƒÀ Iƒèr H‰HƒÁëñIƒÀIƒèrˆHÿÁëóI‹ÃÃÌÌ@SHƒì E‹H‹ÚL‹ÉAƒãøAöL‹ÑtA‹@McP÷ØLÑHcÈL#ÑIcÃJ‹H‹C‹HHKöAt ¶AƒàðH˜LÈL3ÊI‹ÉHƒÄ [é™ÌHƒì(M‹A8H‹ÊI‹Ñè‰ÿÿÿ¸HƒÄ(ÃÌÌÌHƒì8H‹D$`H‰D$(L‰L$ M‹ÈL‹ÂHƒÊÿè(HƒÄ8ÃÌH‰\$L‰D$UVWATAUAVAWHƒì0L‹¤$¨L‹¬$˜H‹ùL‹ò3ÒM‹ù‹Ê‰T$pH;út L;òuL;Ât¹é¼L;ÂtñL;Êu H9”$uâë H9”$tÖL;êu H9”$ uÇë H9”$ t»L;âu H9”$°u¬ë H9”$°t ¸H‹ß8t HÿÈHÿÃH;Âwñ€;:u,L;òt!Iƒø‚;A¹L‹ÇHƒÊÿI‹Îè)3ÒH{ëL;òtAˆH‹êH‹òH‹ß8te¾ èÚ(3Ò;ÂtHÿÃ늆+H^ ‹CøL;à‚§‹CüL;àƒ›ƒ{„‘ƒ;t‹HL$0H‹ÕIÇÿÐ…Àˆ„~sA}csmàu(Hƒ=÷tH îè©5…ÀtºI‹Íÿ׋KA¸H‹ÕIÏèÓBI‹F@‹SMcMH‰D$(I‹F(I×M‹ÅH‹ÍH‰D$ ÿ‹ÃèÖBÿÇHƒÃ;>sjé>ÿÿÿ3ÀëfI‹y 3íI+ÿ9.vTH^‹KôL;ár>‹CøL;às6H;ùr H;øsAöE u/ƒ;t ‹H;øt#ëH‹T$xIDZI‰D‹CüMÇAÿÐÿÅHƒÃ;.r°¸L\$@I‹[0I‹k@I‹sHI‹ãA_A^A]A\_ÃÌÌÌH‰\$H‰|$ATHƒì H‹Ùèè‹Èè!B…À„—èÀìÿÿHƒÀ0H;Øu3Àëè®ìÿÿHƒÀ`H;Øuw¸ÿn÷C ucL%ÒHcøIƒ<üu+¹èJI‰üH…ÀuHC H‰CH‰¸‰C$‰CëI‹ üÇC$ÇCH‰KH‰ K¸ë3ÀH‹\$0H‹|$8HƒÄ A\ÃÌÌÌ…Ét0SHƒì ºb H‹ÚsH‹ÊèÁcÿîÿÿƒc$Hƒ#HƒcHƒÄ [ÃÌÌÌ@SHƒì öB@I‹Øt HƒzuAÿë&ƒBÿx H‹ˆHÿ¶Áë¾Éèæ,ƒøÿu ëÿHƒÄ [ÃÌ…Ò~LH‰\$H‰l$H‰t$WHƒì I‹ùI‹ð‹Ú@ŠéL‹ÇH‹Ö@ŠÍÿËè…ÿÿÿƒ?ÿt…ÛçH‹\$0H‹l$8H‹t$@HƒÄ _ÃÌÌÌH‰\$H‰l$H‰t$WHƒì Aö@@I‹ùI‹ð‹ÚH‹ét IƒxuAë7…Ò~3ŠML‹ÇH‹ÖÿËèÿÿÿHÿŃ?ÿuè=ƒ8*uL‹ÇH‹Ö±?èÿþÿÿ…ÛÍH‹\$0H‹l$8H‹t$@HƒÄ _ÃÌÌH‰\$UVWATAUAVAWHìÐH‹öóH3ÄH‰„$È3ÀH‹ÙH‰L$hH‹úHL$xI‹ÐM‹é‰D$`D‹à‰D$TD‹ð‰D$H‰D$X‰D$PèdóÿÿE3ÒI;ÚuAè£3ÛE3ÉE3À3Ò3ÉÇH‰\$ è·8œ$tH‹„$ˆƒ ÈýƒÈÿéýAƒÏÿöC@L œÏÿÿ…ºH‹Ëè HwóA;Çt(ƒøþt#LcÀL sÏÿÿI‹ÈAƒàHÁùMkÀXM„É€Cë L‹ÂL PÏÿÿAö@8u)A;ÇtƒøþtHcÐH‹ÂƒâHÁøHkÒXI”Á€CöB8€tAè×3ÛE3ÉE3À3Ò3ÉÇH‰\$ èë 8œ$tH‹„$ˆƒ ÈýA‹Çé1E3ÒI;út·@Š/A‹òD‰T$@D‰T$DA‹ÒL‰”$˜A:ê„êH‹œ$¨A»HÿÇA;òH‰¼$°ŒÈEàÿtkHƒ>þteAöEt^AöEuH‹ÿL´A;ÇtILcçI‹ÄHÁøAƒäMkäXM$ÆH‹I‰$AŠEAˆD$IL$º èÚ*A;ÇtAÿD$ ëƒÈÿéÕÿÇIÿÅHƒÆ;û|‚E‹çI‹ÿH‹ßHkÛXHÕHƒ;ÿt Hƒ;þt€K€ëÆCAD$ÿ÷ØɃÁõ¸öÿÿÿE;çDÈÿ¢³H‹ðHƒøÿtJI;ÇtEH‹Èÿ“³A;Çt7H‰3¶Àƒøu€K@ë ƒøu€KHKº è.*A;ÇtÿC ëƒÈÿë.€K@HÇþÿÿÿAÿÄHÿÇHƒÿŒQÿÿÿ‹ ÿ ³3ÀëƒÈÿLœ$I‹[ I‹s(I‹{0M‹c8I‹ãA_A^A]ÃÌÌÌHƒì8H…Éu%è*Hƒd$ E3ÉE3À3Ò3ÉÇè?ƒÈÿë‹AHƒÄ8ÃÌÌH‰ øÃ@SHìàƒd$pHL$t3ÒA¸”è ßÿÿL\$pH„$HŒ$L‰\$HH‰D$PÿDzH‹œ$HT$@H‹ËE3ÀèýH…Àt;Hƒd$8H‹T$@HL$`H‰L$0HL$XL‹ÈH‰L$(HŒ$L‹ÃH‰L$ 3Éè¹ë H‹„$èH‰„$H„$èH‰„$¨H‹„$èÇD$pÀÇD$tH‰„$€ÿ²3É‹Øÿÿ±HL$Hÿì±…Àu …ÛuHèø4ÿαºÀH‹Èÿ¸±HÄà[ÃÌÌÌH‰\$H‰l$H‰t$WHƒì0H‹éH‹ ¾öA‹ÙI‹øH‹òè@H…ÀtL‹T$`D‹ËL‹ÇH‹ÖH‹ÍL‰T$ ÿÐë%¹èƒ4L‹\$`D‹ËL‹ÇH‹ÖH‹ÍL‰\$ èhþÿÿH‹\$@H‹l$HH‹t$PHƒÄ0_ÃÌÌÌL Õä3ÀI‹ÑD@; t+ÿÀIЃø-ròAíƒøw¸ ÃÁDÿÿÿ¸ƒùAFÀÃH˜A‹DÁÃÌHƒì(èwH…Àu HçåëHƒÀHƒÄ(ÃHƒì(èWH…Àu HËåëHƒÀHƒÄ(Ã@SHƒì ‹Ùè3H…Àu H§åëHƒÀ‰èLåH…ÀtLP‹Ëè;ÿÿÿA‰HƒÄ [ÃÌÌH‰\$H‰l$H‰t$WHƒì 3ÿH‹ñƒÍÿH‹Îèd3H‹ØH…Àu(9Zõv ‹ÏÿȯDŸèD;BõA‹ûGý;ýuÈH‹l$8H‹t$@H‹ÃH‹\$0HƒÄ _ÃH‹ÄH‰XH‰hH‰pH‰x ATHƒì 3ÿH‹òH‹éAƒÌÿE3ÀH‹ÖH‹ÍèiH‹ØH…Àu*9ßôv"‹ÏÿM¯DŸèD;ÇôA‹ûAGüA;üuÀH‹l$8H‹t$@H‹|$HH‹ÃH‹\$0HƒÄ A\ÃÌH‹ÄH‰XH‰hH‰pH‰x ATHƒì 3öH‹úH‹éAƒÌÿH‹×H‹Íè 3H‹ØH…Àu/H…ÿt*9Yôv"‹ÎÿÇ®DžèD;AôA‹óAGôA;ôu¾H‹l$8H‹t$@H‹|$HH‹ÃH‹\$0HƒÄ A\ÃÌÌÌH‰\$H‰l$H‰t$WATAUHƒì 3öI‹øH‹êAƒÍÿL‹áL‹ÇH‹ÕI‹Ìèg3H‹ØH…Àu/H…ÿt*9Ìóv"‹Îÿ:®DžèD;´óA‹óAGõA;õu»H‹l$HH‹t$PH‹ÃH‹\$@HƒÄ A]A\_ÃH…Ét7SHƒì L‹ÁH‹ øÿ3Òÿ€®…ÀuèSýÿÿH‹Øÿf®‹Èèûüÿÿ‰HƒÄ [ÃÌÌÌH‰\$H‰t$ATHƒì03öNèj^‰\$ ;4}iLcãH‹Jƒ<àtPJ‹ àöAƒtè²3ƒøÿtÿƉt$$ƒû|1H‹ÛJ‹ àHƒÁ0ÿ­H‹ ÆJ‹ áèAÿÿÿL‹¶Kƒ$ãÿÉ\$ ë¹èç‹ÆH‹\$@H‹t$HHƒÄ0A\ÃH‰\$H‰t$WHƒì ‹A3öH‹Ù$<u?÷At6‹9+y…ÿ~-èúÿÿH‹SD‹Ç‹Èèâ:;Çu‹C„Àyƒàý‰CëƒK ƒÎÿH‹Kƒc‹ÆH‹t$8H‰ H‹\$0HƒÄ _ÃÌÌÌ@SHƒì H‹ÙH…Éuè5ë,èjÿÿÿ…ÀtƒÈÿëºcsH‹Ëè¢ùÿÿ‹Èè£;÷ØÀë3ÀHƒÄ [ÃÌH‰t$H‰|$L‰d$AUAVAWHƒì0D‹ñE3ä3öNèç3ÿ‰|$ AƒÏÿ;=®†LcïH‹~Jƒ<ètjJ‹èöBƒt`‹ÏèŠ×ÿÿH‹^J‹ èöAƒt5Aƒþuè9ÿÿÿA;Çt%AÿÄD‰d$$ëE…öuöAtèÿÿÿA;ÇAD÷‰t$(H‹J‹ê‹Ïè¹×ÿÿÿlj|$ énÿÿÿ¹è@AƒþADô‹ÆH‹t$PH‹|$XL‹d$`HƒÄ0A_A^A]ùéÿÿÿÌÌH‰\$H‰t$H‰|$ATHƒì L%¬à3ö3ÿI‹Üƒ{u%Hcƺ ÿÆH €HªðH ÈH‰ è"…Àt-H³âHƒÃÿÇH;Ø|øH‹\$0H‹t$8H‹|$@HƒÄ A\ÃHcÇHÀIƒ$Ä3ÀëÛÌÌH‰\$H‰l$H‰t$WHƒì H!àH-ZâH‹ûH‹7H…ötƒtH‹ÎÿЪH‹Îè|üÿÿHƒ'HƒÇH;ý|ÔH‹ H…Ét ƒ{uÿ§ªHƒÃH;Ý|ãH‹\$0H‹l$8H‹t$@HƒÄ _ÃÌHcÉH®ßHÉH‹ ÈHÿ%ªH‰\$H‰t$H‰|$AUHƒì HcÙ¾Hƒ= üuèNèè¹ÿèàÿÿH‹ûHÿL-UßIƒ|ýt‹Æë{¹(èÃùÿÿH‹ØH…Àuè.ùÿÿÇ 3ÀëZ¹ èfIƒ|ýu/º H‹Ëè˜ …ÀuH‹Ëè€ûÿÿèóøÿÿÇ 3öëI‰\ýë H‹ËèbûÿÿH‹ vßÿH©‹ÆH‹\$0H‹t$8H‹|$@HƒÄ A]ÃH‰\$WHƒì HcÙH=¤ÞHÛHƒ<ßuèõþÿÿ…ÀuHèÑÞÿÿH‹ ßH‹\$0HƒÄ _Hÿ%ä¨H‰\$WHƒì0I‹ØH‹úH…Ét23ÒHBàH÷ñH;Çs$èHøÿÿHƒd$ E3ÉE3À3Ò3ÉÇ è]÷ÿÿ3Àë]H¯ù¸H…ÿHDø3ÀHƒÿàwH‹ žúPL‹Çÿ*©H…Àu-ƒ=–útH‹Ïè¼…ÀuËH…Ût²Ç ëªH…ÛtÇ H‹\$@HƒÄ0_ÃÌH‰\$H‰l$H‰t$WHƒì0H‹òH‹éH…É„ûH…Ò„ò3ÿH‹ÙM…Àt!AŠ„Àt¿H;׆¼HYˆÆ:HÿÃI‹ÑM…ÉtAA€9t;HÿÇH;þƒ–ŠHÿˆHÿÀ:uåI‹ÉèØ8€8/t€8\tHÿÇH;þsmÆ\HÿÃH‹L$`H…ÉtëHÿÇH;þsSŠˆHÿÃHÿÁ€9uéH‹L$hH…Ét1Š„Àt+<.t"HÿÇH;þs(Æ.HÿÃëHÿÇH;þsŠˆHÿÃHÿÁ€9uéHGH;ÆvÆEè°öÿÿ»"ëÆ3Àë#èöÿÿ»Hƒd$ E3ÉE3À3Ò3ɉè±õÿÿ‹ÃH‹\$@H‹l$HH‹t$PHƒÄ0_ÃÌÌH‰\$H‰t$WHƒì@‹ÚH‹ÑHL$ A‹ùA‹ðèøÙÿÿH‹D$(D¶ÛA„|u…ötH‹D$ H‹ˆ@B·Y#Æë3À…Àt¸€|$8t H‹L$0ƒ¡ÈýH‹\$PH‹t$XHƒÄ@_ÃÌH‹Â‹ÑA¹H‹ÈE3ÀénÿÿÿÌÌ‹ÑA¹E3À3ÉéZÿÿÿÌÌHƒì8Hƒd$ èY7HƒÄ8ÃH‰L$HìˆH îÿ§¦L‹xïL‰\$XE3ÀHT$`H‹L$Xè×sH‰D$PHƒ|$PtAHÇD$8HD$HH‰D$0HD$@H‰D$(H8îH‰D$ L‹L$PL‹D$XH‹T$`3Éè…së"H‹„$ˆH‰ïH„$ˆHƒÀH‰‘îH‹êîH‰[íH‹„$H‰\îÇ2í ÀÇ,íH‹ÑØH‰D$hH‹ÍØH‰D$pÿ²¥‰œí¹è®(3Éÿ’¥H K©ÿ}¥ƒ=víu ¹è†(ÿ\¥º ÀH‹ÈÿF¥HĈÃÌÌH‰\$H‰l$H‰t$WHƒì HYH‹é¾H‹ËL‹Æ3ÒègÑÿÿE3ÛH}AKA·ÃD‰]D‰]D‰] fó«H=RÜH+ýŠˆHÿÃHƒîuòHºŠ9ˆHÿÁHƒêuòH‹\$0H‹l$8H‹t$@HƒÄ _ÃÌÌH‰\$H‰t$WHì€H‹·×H3ÄH‰„$pH‹ñ‹IHT$Pÿˤ»…À„=3ÀHT$pˆÿÀHÿÂ;ÃrõŠD$VÆD$p H|$Vë)¶WD¶ÀD;ÂwA+ÐI‹ÀJLpDB² èyÐÿÿHƒÇŠ„ÀuÓ‹F ƒd$8LD$p‰D$0‹FD‹Ë‰D$(H„$pº3ÉH‰D$ è›?ƒd$@‹F‹V ‰D$8H„$p‰\$0H‰D$(LL$pD‹Ã3ɉ\$ èd<ƒd$@‹F‹V ‰D$8H„$p‰\$0H‰D$(LL$pA¸3ɉ\$ è.<Lœ$pHN3ÒAöt € Š„pëAöt€ Š„pˆëÆHÿÁHÿÂIƒÃHƒëu¿ë?3ÒHNDBŸA@ ƒøw€ B ë Aƒøw€ BàˆëÆÿÂHÿÁ;ÓrÇH‹Œ$pH3Ìè’ÕÿÿLœ$€I‹[I‹s I‹ã_ÃÌH‰\$WHƒì èÝ H‹ø‹ˆÈ… FßtHƒ¸Àt H‹˜¸ën¹ è÷øÿÿH‹Ÿ¸H‰\$0H; ÞtDH…ÛtðƒÿuHÇÙH‹L$0H;ÈtèüóÿÿH‹áÝH‰‡¸H‹ÓÝH‰D$0ðƒH‹\$0¹ è“÷ÿÿH…ÛuK è†×ÿÿH‹ÃH‹\$8HƒÄ _Ã@SHƒì@‹ÙHL$ 3ÒèÌÔÿÿƒ%Õîƒûþu%ÇÆîÿ@¢€|$8tSH‹L$0ƒ¡ÈýëEƒûýuÇœîÿ¢ëÔƒûüuH‹D$ Ç€î‹@뻀|$8t H‹D$0ƒ Èý‹ÃHƒÄ@[ÃH‰\$UVWATAUHƒì@H‹‰ÔH3ÄH‰D$8H‹òèIÿÿÿ3Û‹ø;Ãu H‹ÎèüÿÿéL-ÝÜ‹ËH‹ëI‹ÅA¼98„'AÌIìHƒÀ0ƒùréÿèý„ÿéý„ø·Ïÿ_¡;ÄçHT$ ‹Ïÿ2¡;ÄÆHN3ÒA¸èÍÿÿ‰~‰^ D9d$ †HD$&8\$&t-8Xt(¶8¶H;ùw+ÏHT7AÌ€ IÔI+ÌuõHƒÀ8uÓHF¹þ€IÄI+Ìuõ‹Né¤t(ƒétƒé tA;Ìt‹Ãë¸ë¸ë ¸ë¸‰F D‰fë‰^H~·Ã¹fó«éà9îì…·þÿÿƒÈÿéÖHN3ÒA¸è?ÌÿÿHlmL{ÛHíAºMDíI‹ÈA8t18Yt,¶¶A;ÐwLL2AŠAÔA¶AMÌ;ÐvìHƒÁ8uÏIƒÀMÜM+Ôu»‰~ï¤D‰ft$ƒïtƒï t A;üu»ë»ë »ë»‰^ HVI|í¹·HƒÇf‰HƒÂI+ÌuíH‹Îè|úÿÿ3ÀH‹L$8H3ÌèÍÑÿÿH‹œ$€HƒÄ@A]A\_^]ÃÌH‹ÄH‰XH‰pH‰xL‰` AUHƒì0‹ùAƒÍÿèH‹ðèüÿÿH‹ž¸‹Ïè¾üÿÿD‹à;C„¹ è\îÿÿH‹Ø3ÿH;Ç„|H‹–¸H‹ÈA¸ èå:‰;H‹ÓA‹ÌèýÿÿD‹è;Ç…$H‹Ž¸ðƒÿuH‹Ž¸L%ÂÕI;ÌtèüïÿÿëL%¯ÕH‰ž¸ðƒö†È… öÈÚ…ü¹ èˆôÿÿ‹C‰ ë‹C‰ë‹C ‰ë‹×‰T$ LW­ÿÿƒú}HcÊ·DKfA‰„Hˆ=ÿ‰T$ ëâ‹×‰T$ ú}HcÊŠDBˆ„ *ÿ‰T$ ëá‰|$ ÿ}HcÏŠ„Bˆ„0+ÿlj|$ ëÞH‹ÙðƒÿuH‹ ÙI;ÌtèïÿÿH‰ùØðƒ¹ èÃòÿÿë+ƒøÿu&L%­ÔI;ÜtH‹ËèäîÿÿèWìÿÿÇë3ÿD‹ïA‹ÅH‹\$@H‹t$HH‹|$PL‹d$XHƒÄ0A]ÃHƒì(ƒ= òu¹ýÿÿÿèñýÿÿÇ÷ñ3ÀHƒÄ(ÃH‰\$H‰t$WHƒì H‹(H‹ÙH…ÀtyH sÞH;ÁtmH‹ƒH…Àtaƒ8u\H‹‹ H…Étƒ9uè;îÿÿH‹‹(èC>H‹‹H…Étƒ9uèîÿÿH‹‹(èÙ=H‹‹èîÿÿH‹‹(èõíÿÿH‹ƒ0H…ÀtGƒ8uBH‹‹8HéþèÑíÿÿH‹‹H¿€H+Ïè½íÿÿH‹‹PH+Ïè®íÿÿH‹‹0è¢íÿÿH‹‹XH ÜH;Ètƒ¹`uèa;H‹‹XèuíÿÿH{X¾HaØH9GðtH‹H…Ét ƒ9uèMíÿÿHƒøtH‹OH…Ét ƒ9uè3íÿÿHƒÇ Hƒîu½H‹ËH‹\$0H‹t$8HƒÄ _éíÿÿÌÌðƒH‹H…ÀtðƒH‹ H…ÀtðƒH‹H…ÀtðƒH‹0H…ÀtðƒHAXA¸H·×H9Pðt H‹H…ÒtðƒHƒxøt H‹PH…ÒtðƒHƒÀ IƒèuÉH‹Xðƒ€`ÃÌÌÌH…É„˜AƒÉÿðD H‹H…ÀtðDH‹ H…ÀtðDH‹H…ÀtðDH‹0H…ÀtðDHAXA¸H×H9Pðt H‹H…ÒtðD Hƒxøt H‹PH…ÒtðD HƒÀ IƒèuÉH‹XðDˆ`H‹ÁÃÌÌÌ@SHƒì H‹ÚH…ÒtAH…Étº…Àt@ˆ´$ˆ@ˆ¼$‰Æ„$ŠDJë@ˆ¼$ˆÆ„$‰D‹ÊH‹L$@‰T$8L„$ˆ‹A‰D$0‹AHL$@‰D$(HD$pH‰D$ èí0…Àu8D$Xt H‹D$Pƒ Èý3Àë·D$p#Å€|$Xt H‹L$Pƒ¡ÈýL\$`I‹kI‹s I‹ã_ÃÌÌÌH‹ÄH‰XH‰hH‰p ‰HWHƒì H‹ÊH‹Úè¶áÿÿ‹KHcðöÁ‚uèÞãÿÿÇ ƒK ƒÈÿé4öÁ@t èÂãÿÿÇ"ëâ3ÿöÁt‰{öÁ„‰H‹CƒáþH‰‰K‹C‰{ƒàïƒÈ‰C© u/è3¾ÿÿHƒÀ0H;Øtè%¾ÿÿHƒÀ`H;Øu ‹Îèi;ÇuH‹ËèÑ;÷C„‹+H‹S+kHBH‰‹C$ÿÈ;ï‰C~D‹Å‹Îè¾!‹øëWƒÉ ‰Ké?ÿÿÿƒþÿt#ƒþþtH‹ÎH‹ÆHÀæƒáHÁøHkÉXH ÂëH ÇöA t3Ò‹ÎDBè:Hƒøÿ„ïþÿÿH‹KŠD$0ˆë½HT$0‹ÎD‹ÅèC!‹ø;ý…Åþÿÿ¶D$0H‹\$8H‹l$@H‹t$HHƒÄ _ÃÌÌÌH‰\$H‰|$L‰l$ AVHƒì0L5ˆÑ‹ù3ÛI‹Æ;t ÿÃHƒÀƒûrñƒûƒÔ¹èÿ<ƒø„|¹èì<…Àu ƒ=9Æ„aÿü„šH=àA½L H‹ÏI‹Õè„6…ÀtHƒd$ E3ÉE3À3Ò3ÉèÛßÿÿHùßA¸3ÉÆîàÿ#’…Àu1L¨œH Òߺûè36…ÀtHƒd$ E3ÉE3À3Ò3ÉèŠßÿÿH ¨ßèšHÿÀHƒø÷ÿÿL‹àH‹ tåè/÷ÿÿH‹ØI;Ä‚˜H‹øI+üLoIƒý‚„I‹Ìè:H‹ðI;ÅsTºH;ÂHBÐHÐH;ÐrI‹Ìè¿àÿÿ3ÛH;Ãuë3ÛHV H;ÖrFI‹Ìè£àÿÿH;Ãt9HÁÿHøH‹ÈèžöÿÿH‰óäI‹ÎèöÿÿH‰HKèƒöÿÿH‰ÐäI‹Þë3ÛèÄÅÿÿH‹ÃH‹\$@H‹t$HH‹|$PHƒÄ A^A]A\ÃÌÌÌHƒì(èïþÿÿH÷ØÀ÷ØÿÈHƒÄ(ÃÌH‰\$WHƒì HC¥H=<¥ëH‹H…ÀtÿÐHƒÃH;ßríH‹\$0HƒÄ _ÃH‰\$WHƒì H¥H=¥ëH‹H…ÀtÿÐHƒÃH;ßríH‹\$0HƒÄ _ÃH‰\$WHƒì HÃο H‹ èªõÿÿH‰HƒÃHƒïuëH‹\$0HƒÄ _ÃÌÌÌÌÌÌÌÌÌÌÌÌÌÌH‹Á¹MZf9t3ÀÃHcH%‹Ãë#èI¿ÿÿÇ Hƒd$ E3ÉE3À3Ò3Éè^¾ÿÿƒÈÿH‹\$`HƒÄ0A\_^ÃÌH‰\$WHƒìPH‹ÚH‹ùH…Éu$è¿ÿÿHƒd$ E3ÉE3À3Ò3ÉÇè¾ÿÿ3ÀëvH…Òt×H;ÊsòHL$0I‹Ð耢ÿÿL‹\$8Aƒ{u€|$HHCÿtHH‹L$@ƒ¡Èýë:HSÿHÿÊH;úw ¶BöDuíH‹ËH+ʃáH+Ù€|$Ht H‹L$@ƒ¡ÈýHCÿH‹\$`HƒÄP_ÃÌÌE3Àé<ÿÿÿH‰\$H‰l$H‰t$WATAUHƒìPE3íI‹ùI‹ðH‹êH‹ÙM;ÍuI;ÍuI;Õu 3Àë>I;ÍtI;ÕvM;ÍuDˆ)ëèM;Åu?Dˆ)èý½ÿÿ»E3ÉE3À3Ò3ɉL‰l$ è½ÿÿ‹ÃL\$PI‹[ I‹k(I‹s0I‹ãA]A\_ÃH‹”$HL$0èh¡ÿÿL‹\$8H‹ÕH‹ËE9ku L‹ÏL‹ÆèXD8l$Ht±H‹L$@ƒ¡Èýë£HƒÿÿuŠHÿƈHÿÁA:Åt.Hƒêuëë&ŠHÿƈHÿÁA:Åt HƒêtHƒïuåI;ýuDˆ)HÿÁI;Õ…D8.tHƒÿuYLaÿI‹ôL;ãr¶HT$0è'ÇÿÿA;ÅtHÿÎH;ósæA‹Ä+ƨt*Eˆ,$èô¼ÿÿº*‰D8l$Ht H‹L$@ƒ¡Èý‹ÂéóþÿÿHƒÿÿu\HƒývOHt+þH‹þH;ór¶HT$0èÁÆÿÿA;ÅtHÿÏH;ûsæ‹Æ+Ǩt Dˆ.D8l$Ht H‹D$@ƒ Èý¸Pé˜þÿÿDˆl+ÿëÜDˆ+èi¼ÿÿ»"E3ÉE3À3Ò3ɉL‰l$ è~»ÿÿD8l$H„aþÿÿH‹L$@ƒ¡ÈýéPþÿÿH‹ÁH+ÃHƒø|YHqþH‹þH;ór¶HT$0è!ÆÿÿA;ÅtHÿÏH;ûsæ‹Æ+Ǩt+Dˆ.èð»ÿÿº*‰D8l$H„ÿÿÿH‹D$@ƒ ÈýéóþÿÿD8l$H„ ýÿÿH‹D$@ƒ ÈýéýÿÿÌ@UATAUAVAWHƒì`Hl$@H‰]PH‰uXH‰}`H‹ŽŸH3ÅH‰ED‹$¾¾3ÿM‹ÙL‰MD‰ED‹ò‰UH‹ÙDnÿD;×uOLwE‹Íº3ɉ|$(H‰|$ ÿlm;Çt E‹ÕD‰-Ò½ëÿ>lD‹ýƒøxDDÖD‰µ½L‹]D‹MpD;Ï~5A‹ÉI‹ÃA+Í@88t IÅ;ÏuñƒÉÿA‹Á+ÁA+ÅA;Á} DHD‰MpëD‹È‰EpD;Ö„\D;ׄSE;Õ…€D‹¥ˆ‹÷D;çuH‹D‹`÷M‹ÃA‹ÌÒ‰|$(H‰|$ ƒâAÕÿ¤lLcøD;ÿ„<H»ðÿÿÿÿÿÿA¾ÝÝA½~[3ÒHBàI÷÷HƒørLKL?I;Íw.HAH;ÁwH‹ÃHƒàðèZ\H+àH|$@H…ÿ„åÇÌÌëèîÿÿH‹øH…ÀtD‰0HƒÇH…ÿ„ÀD‹MpL‹EºA‹ÌD‰|$(H‰|$ ÿük3É;Á„K‹U‰L$(H‰L$ ‹ME‹ÏL‹ÇÿßkE3ÀHcðA;ð„!D‹UAºâ s;‹…€A;À„;ðÿ‹M‰D$(H‹ExE‹ÏL‹ÇA‹ÒH‰D$ ÿkéÛA;ð~`3ÒHBàH÷öHƒørQHL6I;Íw*HAH;ÁwH‹ÃHƒàðèW[H+àH\$@I;ØtÇÌÌëèíÿÿE3ÀH‹ØI;ÀtD‰0HƒÃD‹UëI‹ØI;Øtn‹ME‹ÏL‹ÇA‹Ò‰t$(H‰\$ ÿk3É;Át?‹…€3ÒH‰L$8D‹ÎL‹ÃH‰L$0;Áu ‰L$(H‰L$ ë ‰D$(H‹ExH‰D$ A‹ÌÿOj‹ðHKðD91uè»ÿÿHOðD91uèõºÿÿ‹ÆéÍH‹÷L‹çD;÷u H‹D‹pD‰u‹½ˆ…ÿuH‹‹xA‹Îèh D‹èƒøÿu3ÀéL‹}xL‹E;Ç„<3ÛLMp‹Ð‹Ï‰\$(H‰\$ è… H‹ðH;ÃtÉD‹Mp‹UL‹ÀA‹Î‰\$(H‰\$ ÿjLcÈD‰MD;Ëu‹ûéD;ËA¾ÝÝ~bI‹ÉIƒùàwYHƒÁHùw4HYH;Ùw H»ðÿÿÿÿÿÿHƒãðH‹Ãè¾YH+ãH\$@H…Ût%ÇÌÌëè€ëÿÿH‹ØH…ÀtD‰0HƒÃD‹MH…Ûu3ÛëƒMcÁ3ÒH‹Ëè{”ÿÿD‹]D‹Mp‹U‹MD‰\$(L‹ÆH‰\$ ÿJi‰E…Àu3ÿë.‹…€LML‹Ã‰D$(‹×A‹ÍL‰|$ è‹}L‹à3ÀL;àDøHKðD91u(èg¹ÿÿë!‹…€D‹Mp‹U‰D$(A‹ÎL‰|$ ÿâh‹ø3ÛH;ótH‹Îè5¹ÿÿL;ãt M;ütI‹Ìè#¹ÿÿ‹ÇH‹MH3Íè!šÿÿH‹]PH‹uXH‹}`He A_A^A]A\]ÃÌÌÌH‰\$H‰t$WHƒìp‹òH‹ÑHL$PI‹ÙA‹øèšÿÿ‹„$¸D‹œ$ÀHL$PD‰\$@‰D$8‹„$°‰D$0H‹„$¨L‹ËH‰D$(‹„$ D‹Ç‹Ö‰D$ èOúÿÿ€|$ht H‹L$`ƒ¡ÈýL\$pI‹[I‹sI‹ã_ÃÌÌD‰L$ UATAUAVAWHƒì@Hl$0H‰]@H‰uHH‰}PH‹²™H3ÅH‰ED‹ L¸¿3ÛM‹ðD‹úL‹éwD;Ëu=LMH­qD‹Ç‹Ïÿ¶g;Ãt‰=¸ë6ÿ|fD‹ ¸ƒøxDDÎD‰ ÷·D;΄&D;Ë„D;Ï…C‹uh;óuI‹E‹p÷]xD‹MXM‹ÆҋΉ\$(ƒâH‰\$ ×ÿ,gLcàD;ã„A½ÝÝ~hH¸ðÿÿÿÿÿÿL;àwYKL$Hùw5HAH;Áw H¸ðÿÿÿÿÿÿHƒàðèçVH+àH|$0H;û„µÇÌÌëè¥èÿÿH‹øH;Ãt D‰(HƒÇëH‹ûH;û„‹M‹Ä3ÒH‹ÏMÀ蜑ÿÿD‹MXM‹Æº‹ÎD‰d$(H‰|$ ÿvf;ÃtL‹M`D‹ÀH‹×A‹Ïÿwf‹ØHOðD9)uè«¶ÿÿ‹ÃéˆD‹epH‹ûD;ãuI‹ED‹`‹uh;óuI‹E‹pA‹Ìè"ƒøÿu3ÀëU;Æt$LMXM‹Æ‹Ð‹Î‰\$(H‰\$ èPH‹øH;Ãt×L‹ðH‹E`D‹MXM‹ÆA‹×A‹ÌH‰D$ ÿáe‹ðH;ûtH‹Ïè¶ÿÿ‹ÆH‹MH3Íè—ÿÿH‹]@H‹uHH‹}PHeA_A^A]A\]ÃÌÌH‰\$H‰t$WHƒì`‹òH‹ÑHL$@A‹ÙI‹øèü–ÿÿ‹„$ D‹œ$¨HL$@D‰\$8‰D$0‹„$˜‰D$(H‹„$D‹ËL‹Ç‹ÖH‰D$ è.ýÿÿ€|$Xt H‹L$Pƒ¡ÈýH‹\$pH‹t$xHƒÄ`_ÃÌÌÌÌÌÌÌÌÌÌÌÌÌff„L‹ÙH+Ñ‚žIƒøraöÁt6öÁt Š IÿȈHÿÁöÁtf‹ Iƒèf‰HƒÁöÁt ‹ Iƒè‰HƒÁM‹ÈIÁéuQM‹ÈIÁétH‹ H‰HƒÁIÿÉuðIƒàM…ÀuI‹ÃÃ@Š ˆHÿÁIÿÈuóI‹ÃÃfffffff„fffffIù sBH‹ L‹T HƒÁ H‰AàL‰QèH‹D ðL‹T øIÿÉH‰AðL‰QøuÔIƒàéqÿÿÿfff„fHúrµ¸  D @HÁ€ÿÈuìHé¸@L‹ L‹T Là LÃQL‹L L‹T LÃILÃQL‹L L‹T (HƒÁ@LÃIàLÃQèL‹L ðL‹T øÿÈLÃIðLÃQøuªIèIøƒqÿÿÿð€ $é¹þÿÿffff„fffffffIÈIƒøraöÁt6öÁt HÿÉŠ IÿȈöÁtHƒéf‹ Iƒèf‰öÁt Hƒé‹ Iƒè‰M‹ÈIÁéuPM‹ÈIÁétHƒéH‹ IÿÉH‰uðIƒàM…ÀuI‹ÃÃHÿÉŠ IÿȈuóI‹ÃÃfffffff„fffffIù sBH‹D øL‹T ðHƒé H‰AL‰QH‹D L‹ IÿÉH‰AL‰uÕIƒàésÿÿÿffff„fHúðÿÿwµ¸ Hé€ D @ÿÈuìHÁ¸@L‹L øL‹T ðLÃIøLÃQðL‹L èL‹T àLÃIèLÃQàL‹L ØL‹T ÐHƒé@LÃILÃQL‹L L‹ ÿÈLÃILÃuªIèIøƒqÿÿÿð€ $éºþÿÿH…É„àSHƒì H‹ÙH‹Iè²ÿÿH‹Kèý±ÿÿH‹Kèô±ÿÿH‹K èë±ÿÿH‹K(èâ±ÿÿH‹K0èÙ±ÿÿH‹ èѱÿÿH‹K@èȱÿÿH‹KH迱ÿÿH‹KPè¶±ÿÿH‹KXè­±ÿÿH‹K`褱ÿÿH‹Khè›±ÿÿH‹K8è’±ÿÿH‹Kp艱ÿÿH‹Kx耱ÿÿH‹‹€èt±ÿÿH‹‹ˆèh±ÿÿH‹‹è\±ÿÿH‹‹˜èP±ÿÿH‹‹ èD±ÿÿH‹‹¨è8±ÿÿH‹‹°è,±ÿÿH‹‹¸è ±ÿÿH‹‹Àè±ÿÿH‹‹Èè±ÿÿH‹‹Ðèü°ÿÿH‹‹Øèð°ÿÿH‹‹àèä°ÿÿH‹‹èèØ°ÿÿH‹‹ðḛ̀ÿÿH‹‹øèÀ°ÿÿH‹‹è´°ÿÿH‹‹訰ÿÿH‹‹蜰ÿÿH‹‹è°ÿÿH‹‹ è„°ÿÿH‹‹(èx°ÿÿH‹‹0èl°ÿÿH‹‹8è`°ÿÿH‹‹@èT°ÿÿH‹‹HèH°ÿÿH‹‹Pè<°ÿÿHƒÄ [ÃÌÌH…ÉtBSHƒì H‹ÙH‹ H; ) tè°ÿÿH‹KH;  tè°ÿÿH‹KH;  tèò¯ÿÿHƒÄ [ÃH…É„‹SHƒì H‹ÙH‹IH; ôŸtèɯÿÿH‹K H; êŸtè·¯ÿÿH‹K(H; àŸt襯ÿÿH‹K0H; ÖŸt蓯ÿÿH‹K8H; ÌŸtè¯ÿÿH‹K@H; Ÿtèo¯ÿÿH‹KHH; ¸Ÿtè]¯ÿÿHƒÄ [ÃÌÌÌ@SHƒì0L‹ÉH…Ét H…ÒtM…Àu,Dˆ謬ÿÿ»Hƒd$ E3ÉE3À3Ò3ɉèÀ«ÿÿ‹ÃHƒÄ0[À9t HÿÁHƒêuòH…ÒuAˆë¿AŠIÿÀˆHÿÁ„ÀtHƒêuëH…ÒuAˆèN¬ÿÿ»"ë 3ÀëµÌÌÌ@SHƒì0M‹ØM…ÉuH…ÉuH…Òu 3Àë?H…ÉtH…ÒtM…ÉuDˆ ëèM…Àu,Dˆè¬ÿÿ»Hƒd$ E3ÉE3À3Ò3ɉè«ÿÿ‹ÃHƒÄ0[ÃL‹ÑL‹ÂIƒùÿuAŠIÿÃAˆIÿ„Àt,Iƒèuêë$AŠIÿÃAˆIÿ„Àt IƒètIƒéuäM…ÉuEˆ M…À…fÿÿÿIƒùÿu DˆDÿA@Pë˜Æèu«ÿÿ»"émÿÿÿÌÌÌ@SHƒì0H…Ét H…ÒtM…Àu,DˆèK«ÿÿ»Hƒd$ E3ÉE3À3Ò3ɉè_ªÿÿ‹ÃHƒÄ0[ÃL‹ÉAŠIÿÀAˆIÿÁ„ÀtHƒêuêH…Òuˆè«ÿÿ»"ëµ3ÀëÊÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌÌff„H+ÑL‹ÊöÁtŠBŠ :ÂuVHÿÁ„ÀtWH÷ÁuæI»J fâÿfúøwËH‹J‹ H;Âu¿Iºÿþþþþþþ~LÒHƒðÿHƒÁI3ÂI…ÃtÇëHÀHƒØÿÃ3ÀÃfff„Òt'„öt#HÁê„Òt„ötHÁê„Òt„öt Áê„Òt„öu‹3ÀÃHÀHƒØÿÃÌÌÌÌÌÌff„H+ÑIƒør"öÁtfŠ: u,HÿÁIÿÈöÁuîM‹ÈIÁéuM…ÀtŠ: u HÿÁIÿÈuñH3ÀÃÀƒØÿÃIÁét7H‹H; u[H‹AH;D uLH‹AH;D u=H‹AH;D u.HƒÁ IÿÉuÍIƒàM‹ÈIÁét›H‹H; uHƒÁIÿÉuîIƒàëƒHƒÁHƒÁHƒÁH‹ HÈHÉH;ÁÀƒØÿÃÌH‰\$WHƒì HcÙA‹øH‰T$8‹Ëèø Hƒøÿuè-©ÿÿÇ HƒÈÿëW‹T$8LD$H‹ i¨H;Ït2è?½ÿÿH…Àt(ÿÐH‹ØH…ÀtH‹ Q¨H;Ïtè½ÿÿH…ÀtH‹ËÿÐH‹ØH‹ #¨è½ÿÿH…ÀtD‹ÍM‹ÅI‹ÖH‹ËÿÐë3ÀH‹\$pH‹l$xHƒÄ@A^A]A\_^ÃHƒì8…Éx ƒù~ ƒùu‹›ë1‹›‰ ›ë#è¥ÿÿHƒd$ E3ÉE3À3Ò3ÉÇè$¤ÿÿƒÈÿHƒÄ8ÃHƒì8H…Éu&èÞ¤ÿÿHƒd$ E3ÉE3À3Ò3ÉÇèó£ÿÿHƒÈÿëL‹ÁH‹ G§3ÒÿWHƒÄ8ÃÌ̹éæŠÿÿÌÌHì¨öŽ—t ¹ èþÁÿÿèuÉÿÿH…Àt ¹èrÉÿÿög—t_HŒ$ÐÿgUHL$03ÒA¸˜èuÿÿH‹„$¨3ÉH‰D$@HD$0ÇD$0@H‰D$ H„$ÐH‰D$(ÿUHL$ ÿîT¹è˜ÿÿÌÌÌÌH‹ÄH‰XH‰hH‰pH‰x ATAUAVHƒìPL‹òH‹ÑHHÈE‹áM‹èèv‡ÿÿM…ítM‰uM…öu*诣ÿÿHƒd$ E3ÉE3À3Ò3ÉÇèÄ¢ÿÿ€|$HééE…ät Aƒü|ËAƒü$ÅAŠ.L‹D$03ÿI^Aƒ¸ ~LD$0@¶Íºè2¾ÿÿL‹D$0ëI‹€@@¶Í·Hƒà…Àt@Š+HÿÃ뾋´$@€ý-uƒÎë@€ý+u@Š+HÿÃE…äˆSAƒü„IAƒü$?E…äu(@€ý0tA¼ ë8€;xt €;XtA¼ë&A¼ë Aƒüu@€ý0u€;xt€;Xu@ŠkHƒÃM‹@3ÒƒÈÿA÷ôD‹È@¶ÍE·JAöÀt @¾Íƒé0ëA÷Àt,EŸ@¾Í<wƒé ƒÁÉA;ÌsƒÎA;ùr"u;ÊvƒÎM…íuHÿË@öÆuM…íIEÞ3ÿëYA¯üù@Š+HÿÃ둽ÿÿÿ@öÆu@öÆu:‹Æƒàtÿ€w…Àu';ýv#èõ¡ÿÿÇ"@öÆtƒÏÿë @ŠÆ$öØÿ÷ßýM…ítI‰]@öÆt÷߀|$Ht H‹L$@ƒ¡Èý‹ÇëM…ítM‰u@8|$Ht H‹D$@ƒ Èý3ÀL\$PI‹[ I‹k(I‹s0I‹{8I‹ãA^A]A\ÃÌÌHƒì83ÀE‹ÈL‹Â‰D$ H‹Ñ9;Ÿu H Rë3ÉèQýÿÿHƒÄ8ÃH‰\$WHƒì Hcù‹ÏèìHƒøÿtYH‹㤹ƒÿu @„¸¸u ;ùuö@`tè½¹H‹Øè°H;Ãt‹Ïè¤H‹Èÿ?S…Àu ÿíQ‹Øë3Û‹ÏèØL‹ßH‹ÏHÁùAƒãHs¤H‹ ÊMkÛXBÆD…Ût ‹ËèÖ ÿÿƒÈÿë3ÀH‹\$0HƒÄ _ÃH‰\$H‰t$ ‰L$WATAUHƒì0HcÙƒûþu耠ÿÿ3ÿ‰8èW ÿÿÇ ƒÈÿéÉ3ÿ;ߌ–;壃ŠH‹óL‹ãIÁüL-棃æHköXK‹Då¾L0ƒáu+è' ÿÿ‰8è ÿÿÇ H‰|$ E3ÉE3À3Ò3ÉèŸÿÿƒÈÿëa‹ËèK‹DåöD0t ‹Ëè†þÿÿ‹øë轟ÿÿÇ ƒÏÿ‹Ë虋Çë)èÄŸÿÿ‰8èŸÿÿÇ H‰|$ E3ÉE3À3Ò3É賞ÿÿƒÈÿH‹\$`H‹t$hHƒÄ0A]A\_Ã@SHƒì öAƒH‹Ùt"öAtH‹IèÖ¡ÿÿc÷ûÿÿ3ÀH‰H‰C‰CHƒÄ [ÃÌHƒìhH‹-ƒH3ÄH‰D$Pƒ="’f‰L$@tfH‹ è’Hƒùþu èÑ H‹ Ö’Hƒùÿ„¹Hƒd$ LL$DHT$@A¸ÿPQ…À…‰ƒ=Í‘…ˆÿÕOƒøxu}ƒ%µ‘ÿQHƒd$8Hƒd$0‹ÈHD$HLD$@A¹3ÒÇD$(H‰D$ ÿ8PH‹ I’Hƒùÿt0Hƒd$ LL$DHT$HD‹ÀÿºP…Àtf‹D$@ëÇA‘ëí¸ÿÿH‹L$PH3Ìè¹ÿÿHƒÄhÃH‰\$H‰l$H‰t$WHƒìP3íI‹ðH‹úH‹ÙH;ÕtL;Åt @8*uH;Ítf‰)3ÀH‹\$`H‹l$hH‹t$pHƒÄP_ÃHL$0I‹ÑèzÿÿL‹\$0A9ku%H;Ýt¶f‰@8l$Ht H‹D$@ƒ Èý¸ë®¶HT$0èÎÿÿ;Å„œH‹L$0D‹‰ Aƒù~0A;ñ|+‹I‹ÅH;Ý•ÀL‹Çº ‰D$(H‰\$ ÿtOH‹L$0;ÅuHc H;ðr(@8ot"‹ @8l$H„4ÿÿÿH‹L$@ƒ¡Èýé#ÿÿÿèÿÿÇ*@8l$Ht H‹D$@ƒ ÈýƒÈÿéýþÿÿ‹ÅA¹H;Ý•ÀAQL‹Ç‰D$(H‹D$0H‰\$ ‹HÿåN;Å…ÿÿÿë¤ÌÌÌE3Éé„þÿÿÌÌÌÌÌÌÌÌH‰\$H‰l$H‰t$WHƒì H‹Ú…Éxi; ' saHcùH-3 H‹÷ƒçHÁþHkÿXH‹DõHƒ<ÿu=ƒ=j€u'…Étƒét ƒùu¹ôÿÿÿë ¹õÿÿÿë¹öÿÿÿÿ©NH‹DõH‰3ÀëèœÿÿÇ è(œÿÿƒ ƒÈÿH‹\$0H‹l$8H‹t$@HƒÄ _ÃÌH‰\$H‰l$WHƒì …Éxs; ŸskHcÙH-‹ŸH‹ûƒãHÁÿHkÛXH‹DýöDtGHƒ<ÿt@ƒ=»u)…Étƒét ƒùu¹ôÿÿÿë ¹õÿÿÿë¹öÿÿÿ3ÒÿøMH‹DýHƒ ÿ3Àëèa›ÿÿÇ èv›ÿÿƒ ƒÈÿH‹\$0H‹l$8HƒÄ _ÃHƒì8ƒùþuèR›ÿÿƒ è*›ÿÿÇ ë]…Éx1; Äžs)HcÑH ОH‹ÂƒâHÁøHkÒXH‹ÁöDtH‹ë,è›ÿÿƒ èàšÿÿHƒd$ E3ÉE3À3Ò3ÉÇ èõ™ÿÿHƒÈÿHƒÄ8ÃH‹ÄH‰XH‰pH‰xL‰` AUHƒì HcÙL‹ãIÁüL-VžƒãHkÛXK‹t心|3 u3O 辡ÿÿƒ|3 uHL3º èïÁÿÿ÷ØÒ#úÿD3 ¹ è“ ÿÿ…ÿtK‹LåHLÿ§J‹ÇH‹\$0H‹t$8H‹|$@L‹d$HHƒÄ A]ÃÌÌHcÑH ÎH‹ÂƒâHÁøHkÒXH‹ÁHLHÿ%hJH‰\$H‰|$L‰d$AUAVAWHƒì@IƒÌÿE‹ìE3öAL$ è# ÿÿ…ÀuA‹Äéɹ èõ ÿÿ3ÿ‰|$$H_ƒÿ@›LcÿJ‹øH…Û„H‰\$0J‹øH H;؃ÍöC…ªƒ{ u;¹ 蜠ÿÿƒ{ u HKº èÏÀÿÿ…Àu DpD‰t$(ëÿC ¹ èkŸÿÿE…öu HKÿ„IöCt HKÿ|IëHIƒÌÿE…öu?ÆCL‰#L«œK+øH¸£‹.ºè¢‹.H÷ëL‹êIÁýI‹ÅHÁè?Lè‹ÇÁàDèD‰l$ ëHƒÃXH‰\$0IƒÌÿHfœé ÿÿÿE;ì…ÿlj|$$HKœéçþÿÿºXJÈèi™ÿÿH‰D$0H…ÀttHc×L%œI‰Ѓœ I‹ ÐHÁ H;ÁsÆ@L‰ Æ@ ƒ` HƒÀXH‰D$0ëÖÁç‰|$ HcÏH‹ÁHÁøƒáHkÉXI‹ÀÆD‹ÏèHýÿÿ…ÀADüD‹ï‰|$ ¹ è9žÿÿA‹ÅH‹\$`H‹|$hL‹d$pHƒÄ@A_A^A]ÃHƒì8H‹É{H3ÄH‰D$(LD$ A¹ºÆD$&ÿîI…ÀuƒÈÿë HL$ è›H‹L$(H3Ìè{ÿÿHƒÄ8ÃÌ@USVWATAUAVAWHìˆHl$@H‹`{H3ÅH‰E0L‹µ°E‹!3ÿI‹ØH‹÷‰}L‰MD‹êD‹ùH‰];Ê„HUÿTH;Ç„Ÿƒ}…•HUA‹Íÿ5H;Ç„€ƒ}uzÇEAƒüÿt`A‹ü…ÿŽ©HcÏH¸ðÿÿÿÿÿÿH;ȇ“HL HùwlHAH;Áw H¸ðÿÿÿÿÿÿHƒàðèÏ8H+àH\$@H…Ût<ÇÌÌëNH‹Ëè¢Çÿÿxë–E‹ÌL‹ÃºA‹Ï‰|$(H‰|$ ÿˆH‹ø…À…oÿÿÿ3Àé7èVÊÿÿH‹ØH…ÀtÇÝÝHƒÃë3ÛH…ÛtÙLcÇ3ÒH‹ËMÀèOsÿÿL‹EE‹ÌºA‹Ï‰|$(H‰\$ ÿ)HE3ÿA;Ç„ÉM;÷t;‹…¸L‰|$8L‰|$0‰D$(D‹ÏL‹Ã3ÒA‹ÍL‰t$ ÿ†GA;Ç„‘I‹öé‰D9}u,L‰|$8L‰|$0D‹ÏL‹Ã3ÒA‹ÍD‰|$(L‰|$ ÿJG‹øA;ÇtWHc×¹èf–ÿÿH‹ðI;ÇtBL‰|$8L‰|$0D‹ÏL‹Ã3ÒA‹Í‰|$(H‰D$ ÿ GA;Çu H‹ÎèÁ—ÿÿI‹÷ë AƒüÿtH‹M‰HKð9ÝÝu蟗ÿÿH‹ÆH‹M0H3ÍèœxÿÿHeHA_A^A]A\_^[]ÃÌÌÌ3ÒDB éyóÿÿÌL‹ÑM…Àtˆt_è+…ÀuVH‹ˆH…ÛtJH…ötEH‹ÎèŠÃÿÿH‹øH‹ H…Ét2èzÃÿÿH;ÇvH‹ €<9=uL‹ÇH‹ÖèÝ…ÀtHƒÃëÐH‹HD8ë3ÀH‹\$0H‹t$8HƒÄ _ÃÌÌÌH‰\$H‰t$H‰|$ATHƒì0I‹ðH‹ÚH‹ù¹è8™ÿÿ3ÀH…ÿ•À…Àu&èÚ‘ÿÿ»‰Hƒd$ E3ÉE3À3Ò3Éèîÿÿé¶Hƒ'H…ÛtHƒ#3ÀH…ö•À…Àu#蛑ÿÿ»‰Hƒd$ E3ÉE3À3Ò3Éè¯ÿÿëzH‹Îè½þÿÿH‹ðH…Àu3ÛëfH‹Èè…ÂÿÿºL$I‹Ìè(nÿÿH‰H…ÀuèC‘ÿÿÇ è8‘ÿÿ‹ë1L‹ÆI‹ÔH‹Èè¾åÿÿ…ÀtHƒd$ E3ÉE3À3Ò3ÉèÿÿH…ÛtL‰#3Û¹èE—ÿÿ‹ÃH‹\$@H‹t$HH‹|$PHƒÄ0A\ÃÌH‰l$WHƒìpHcùHL$Pè}tÿÿÿsbH‹T$Pƒº ~LD$Pº‹Ï膫ÿÿH‹T$PëH‹‚@·xƒà…ÀtH‹‚H¶8éè€|$ht H‹D$`ƒ Èý‹ÇéáH‹D$Pƒ¸ ~6‹ïHT$PÁý@¶Íè¶Àÿÿ…Àt@ˆ¬$€@ˆ¼$Æ„$‚ºë èÿÿºÇ*@ˆ¼$€Æ„$H‹L$PÇD$@LŒ$€‹AA¸‰D$8H„$ÇD$0H‰D$(‰T$ ‹QHL$PèCÙÿÿ…À„2ÿÿÿƒø¶„$t ¶Œ$‘Áà Á€|$ht H‹L$`ƒ¡ÈýH‹¬$ˆHƒÄp_ÃH‹ÄH‰XH‰hH‰pWHƒì`H‹ñH‹úHHØI‹ÑI‹éI‹ØèørÿÿH…Ûu8\$Xt H‹D$Pƒ Èý3Àé¯H…öu:èÿÿHƒd$ E3ÉE3À3Ò3ÉÇè1Žÿÿ€|$Xt H‹D$Pƒ Èý¸ÿÿÿëpH…ÿtÁHûÿÿÿw¸H‹L$HƒyuL‹ÍL‹ÃH‹×H‹ÎèÁë1‹A‹Q HL$@‰D$8‰\$0L‹ÎA¸H‰|$(‰\$ è …ÀtŒƒÀþ€|$Xt H‹L$Pƒ¡ÈýL\$`I‹[I‹kI‹s I‹ã_ÃÌE3ÉéèþÿÿH‰\$H‰l$WHƒì@Hƒd$PH‹ðƒH‹H…À„ªƒÍÿHƒd$8Hƒd$0ƒd$(Hƒd$ D‹ÍL‹À3Ò3ÉÿÊ?Hcø…À„‘H‹ÏºèâŽÿÿH‰D$PH…ÀtzHƒd$8Hƒd$0L‹D‹Í3Ò3ɉ|$(H‰D$ ÿƒ?…ÀtGHL$P3ÒèË…ÀyH‹L$PH…Ét è$ÿÿHƒd$PHƒÃH‹H…À…Yÿÿÿ3ÀH‹\$XH‹l$`HƒÄ@_ÃH‹L$Pèòÿÿ‹ÅëâÌÌ@USVWATAUAVAWHƒìhHl$0H‹KqH3ÅH‰E(H‹½¨D‹Ò‰U‹ÍA»3ÛM‹ùD‰EL‹ñH‰}Ecÿ;ÓuOL8IE‹Ì3Ò3ÉD‰d$(L‰D$ ÿ?;Ãt A‹ÔE\$ëÿù=‹wA»ƒøxADÓD‹U‰`D‹ D;Ë~YA‹ÉI‹ÇA+̃Îÿ8t IÄ;Ëuï‹Î‹Æ+ÁDÈD‰ D‹…°D;Ã~5A‹ÈH‹ÇA+Ì8t IÄ;Ëuò‹Î‹Æ+ÁDÀD‰…°ëƒÎÿD;Î}Æ3Àé¥D;Æ|ôA;Ó„¯;Ó„§A;ÔuÞD‹­¸D;ëuI‹D‹iD;Ët D;Ã…«E;ÈuA‹Ãé\E;Ä~A‹ÄéOE;Ì~ ¸é@HUA‹Íÿ=;ÃtƒD‹ D;Ë~2ƒ}rÓ8]HEtÊ8XtÅAŠ:r:HvHƒÀ8ëå¸éñ9°~+ƒ}rŒ8]HEtƒ8X„zÿÿÿŠ:r:HvËHƒÀ8ëâM‹Çº A‹Í‰\$(H‰\$ ÿw=LcðD;ó„ìþÿÿI¸ðÿÿÿÿÿÿ~d3ÒHBàI÷öHƒørUKL6Hùw.HAH;ÁwI‹ÀHƒàðè5-H+àHt$0H;ó„þÿÿÇÌÌëèó¾ÿÿH‹ðH;ÃtÇÝÝHƒÆëH‹óH;ó„pþÿÿD‹ M‹ÇA‹ÔA‹ÍD‰t$(H‰t$ ÿÏ<;ÄôD‹°L‹Çº A‹Í‰\$(H‰\$ ÿ¦<LcàD;ã„Ç~g3ÒHBàI÷ôHƒørXKL$Hùw1HAH;Áw H¸ðÿÿÿÿÿÿHƒàðèg,H+àH|$0H;ûtÇÌÌëè)¾ÿÿH‹øH;ÃtÇÝÝHƒÇëH‹ûH;ûtVD‹°L‹EºA‹ÍD‰d$(H‰|$ ÿ<;Ãt‹U‹ME‹ÎL‹ÆD‰d$(H‰|$ ÿV<‹ØHOð9ÝÝuè/ŒÿÿHNð9ÝÝuèŒÿÿ‹ÃéèH‹ûL‹ëD;Óu I‹D‹PD‰UD‹¥¸D;ãuI‹D‹`A‹ÊèŽñÿÿD‹ð;Æ„ýÿÿA;ÄteL M‹Ç‹ÐA‹Ì‰\$(H‰\$ èµñÿÿH‹øH;ÄÒüÿÿL‹EL°A‹ÖA‹Ì‰\$(H‰\$ èŠñÿÿL‹èH;Ãu H‹Ïè~‹ÿÿéžüÿÿL‹ÿL‹ÀëL‹E‹…°D‹ ‹U‹M‰D$(L‰D$ M‹ÇÿT;‹ðH;ûtH‹Ïè9‹ÿÿI‹Íè1‹ÿÿ‹ÆH‹M(H3Íè/lÿÿHe8A_A^A]A\_^[]ÃÌÌH‰\$H‰t$WHƒì`‹òH‹ÑHL$@I‹ÙA‹øèlÿÿD‹œ$¨‹„$ HL$@D‰\$8‰D$0H‹„$˜H‰D$(‹„$L‹ËD‹Ç‹Ö‰D$ è¾úÿÿ€|$Xt H‹L$Pƒ¡ÈýH‹\$pH‹t$xHƒÄ`_ÃÌÌÌH‰\$H‰t$WHƒì`H‹ñH‹úHL$@I‹ÑI‹Øè‹kÿÿH…Ûu8\$Xt H‹D$Pƒ Èý3ÀéÂH…öu=诇ÿÿHƒd$ E3ÉE3À3Ò3ÉÇèĆÿÿ€|$Xt H‹D$Pƒ Èý¸ÿÿÿé€H…ÿt¾HûÿÿÿwµH‹D$@‹P…ÒuLL$@L‹ÃH‹×H‹Îèªòÿÿë>‹@HL$@L‹Î‰D$8‰\$0A¸H‰|$(‰\$ è™þÿÿ…Àuè‡ÿÿÇéyÿÿÿƒÀþ€|$Xt H‹L$Pƒ¡ÈýH‹\$pH‹t$xHƒÄ`_ÃÌÌÌH‰\$‰T$UVWATAUAVAWHƒì0E3í‹êL‹ñA‹ÝI;Íu$è·†ÿÿE3ÉE3À3Ò3ÉL‰l$ ÇèÍ…ÿÿéêL‹!M;å„Óº=I‹Ìè³H‹øH‰D$pI;Å„µL;à„¬D8hH‹5þ{E‹ýA”ÇH;5ø{upH‹îA‹ÅI;õu I‹õëUHƒÆÿÀL9.uõÿÀºHcÈè‡ÿÿH‹øH‹ðI;Åu¹ èWlÿÿëH‹ÈèÍH‰HƒÇHƒÅH‹EI;ÅuäL‰/H‹|$p‹l$xH‰5~{I;õ…‰A;ít9L9-y{t0èf÷ÿÿA;Åtjè´…ÿÿǃÈÿH‹œ$€HƒÄ0A_A^A]A\_^]ÃE;ýt3Àëß¹è†ÿÿH‰{I;ÅtÆL‰(L9-{u¹èæ…ÿÿH‰ {I;Åt¤L‰(H‹5ìzH‹îI;õt’H‹‹ÇH‹þA+ÄLcèH…Ét?H‹ÑM‹ÅI‹Ìè¿öÿÿ…ÀuH‹A€|=„¢A8\„—HƒÇH‹H…ÉuÈH‹5’zH+þHÁÿ÷ßE3íA;ýŒŒL9m„‚Hc÷H‹LõèJ‡ÿÿE;ýtfL9lõtHLõH‹ÿÇHƒÁH‰DõHÿÆL9lõuèHc×H¸ÿÿÿÿÿÿÿH;Ѓ“H‹ zA¸èq†ÿÿI;Åt|ësH‹5zH+þHÁÿérÿÿÿL‰dõM‰.ë]E;ý…A;ý}÷ßG;ÇŒ„þÿÿLcÀH¸ÿÿÿÿÿÿÿL;ÀƒnþÿÿºH‹Îè†ÿÿI;Å„XþÿÿHcÏL‰$ÈL‰lÈM‰.H‰”yD9l$x„ŠI‹ÌèµÿÿºHHèÄÿÿH‹øI;ÅtlI‹Ìèã´ÿÿM‹ÄH‹ÏHPèHØÿÿA;ÅtE3ÉE3À3Ò3ÉL‰l$ èŸÿÿH‹×H‹ÏI+ÔHT$pDˆ*HÿÂE;ýIEÕÿ6A;ÅuƒËÿèiƒÿÿÇ*H‹Ïèã…ÿÿE;ýt I‹ÌèÖ…ÿÿM‰.‹Ãé™ýÿÿI‹ÌèÄ…ÿÿM‰.é¦ýÿÿH‰\$H‰t$WHƒì0H‹ÙH…ÉtFè<´ÿÿH‹ðHHè·ÿÿH‹øH…Àt-HVL‹ÃH‹Èè×ÿÿ…ÀtHƒd$ E3ÉE3À3Ò3Éèä€ÿÿH‹Çë3ÀH‹\$@H‹t$HHƒÄ0_ÃÌH‰\$H‰t$WHƒìPH‹Ù‹úHL$0I‹ÐèWfÿÿ3öH;ÞuDè—‚ÿÿE3ÉE3À3Ò3ÉH‰t$ Çè­ÿÿ@8t$Ht H‹D$@ƒ Èý3ÀH‹\$`H‹t$hHƒÄP_ÃH‹T$89ru‹×H‹Ëè€@8t$HtÕH‹L$@ƒ¡ÈýëǶ f;Ît3¶ÁöDtHÿÃ@83t˜¶·ÉÁá È;ùu HCÿë¼·Á;øtHÿÃëÅ·Á;ø…lÿÿÿ@8t$Ht H‹D$@ƒ ÈýH‹ÃéfÿÿÿÌÌE3Àéÿÿÿë:Ât HÿÁŠ„Àuó:ÂuH‹ÁÃ3ÀÃÿ%X2ÿ%¢2ÿ%¤2Hƒì8H…Éu&èŠÿÿHƒd$ E3ÉE3À3Ò3ÉÇ蟀ÿÿHƒÈÿë€9tÕH…ÒtÐH‹H…ÀtÈ€8tÃE3Àè‚HƒÄ8ÃÌH‰T$‰L$SUVWATAUAVAWHƒìXA¼þÿÿÿHcÁA‹ØD‰d$4‰\$8A;Äuè,ÿÿ3ÿ‰8èÿÿÇ é3ÿ;ÇŒï;”„ƒãH‹ðL‹ðL AÿÿIÁþƒæK‹Œñ€CHköXŠD1¨„·ûÿÿÿvèÉ€ÿÿ‰8袀ÿÿÇ骋ï;߄Ѝ…‚H;×tÒDŠ|18A¸EÿAÐÿA¾Ïƒétƒéu ‹Ã÷Шt«ƒãþL‹êëd‹Ã÷Шt›ÑëA;ØABØ‹ËèÁ€ÿÿL‹èH;Çuè,€ÿÿÇ èA€ÿÿÇé=‹Œ$ 3ÒDBè°ÖÿÿL A@ÿÿL‹ØK‹„ñ€CL‰\0@K‹„ñ€CI‹ÕA¸ öD0H„œŠL0 A:È„;ß„‡AˆMK‹„ñ€CAƒÊÿAÚIUAh÷DˆD0 D:ÿtbK‹„ñ€CŠL09A:ÈtQ;ßtMˆ K‹„ñ€CAÚHÿÂAhøDˆD09A€ÿu.K‹„ñ€CŠL0:A:Èt;ßtˆ K‹„ñ€CHÿÂAhùAÚDˆD0:K‹Œñ€CLL$0D‹ÃH‹ 1H‰|$ ÿÂ1;Ç„ÏHcT$0;׌‹ÃH;Ї·L3?ÿÿêK‹„ð€CöD0€„yA€ÿ„¸;×tA€} u€L0ë€d0ûHcÅI‹ÝM‹åIÅH‰D$@L;èƒ:½ AŠ$<„ @:Åt ˆHÿÃIÿÄéëH‹D$@HÿÈL;àsID$€8 u IƒÄéL‹àé½K‹Œð€CLL$0H”$°H‹ 1A¸IÿÄH‰|$ ÿÓ0;Çu ÿ9/;Çu{9|$0tuLP>ÿÿK‹„ð€CöD0Ht"€¼$° t'@ˆ+K‹Œð€CŠ„$°ˆD1 ëGI;Ýu€¼$° uÆ ë3‹Œ$ A¸HƒÊÿè]Ôÿÿ€¼$° Læ=ÿÿtëLÛ=ÿÿ@ˆ+HÿÃL;d$@‚ìþÿÿëK‹„ð€CöD0@u€L0ë AŠ$ˆHÿËëA+íA€ÿ…ð;ï„èA¿I+ßö€uIßé²A‹×ëƒúI;ÝrI+ßA×¶B8¼4tã¶ B¾„4;Çuè}ÿÿÇ*AƒÌÿé‘ÿÀ;ÂuHcÂHØë^K‹„ð€CöD0Ht;I߃úˆL0 |ŠK‹Œð€CI߈D19ƒúuŠK‹Œð€CI߈D1:HcÂH+Øë‹Œ$ ÷ÚE‹ÇHcÒè2Óÿÿ‹D$8L‹¼$¨A+ÝÑèD‹ËM‹Å‰D$(3Ò¹éýL‰|$ ÿ….‹è;Çuÿi-‹Èè†|ÿÿAƒÌÿéäD‹d$4;ÃHs<ÿÿJ‹„ð€C@•Çí‰|0Hé¿;׺ tfA9Uu€L0ë€d0ûHcÅI‹ÝM‹åN<(M;ïƒ{½ A·$fƒø„Ef;Åtf‰HƒÃIƒÄé%IGþL;àsID$f9u IƒÄéÂL‹àéúK‹Œð€CLL$0H”$¸H‹ 1A¸IƒÄH‰|$ ÿ.;Çuÿ},;Ç…®9|$0„¤LŒ;ÿÿK‹„ð€CöD0HtFº f9”$¸tKf‰+Š„$¸K‹Œð€CˆD1 Š„$¹K‹Œð€CˆD19K‹„ð€CˆT0:ëWI;Ýuº f9”$¸uf‰ë>‹Œ$ HÇÂþÿÿÿDBèoÑÿÿº Lû:ÿÿf9”$¸të º Lã:ÿÿf‰+HƒÃM;ç‚®þÿÿë"K‹„ð€CöD0@u€L0ë A·$f‰HƒÃ‹ëA+íD‹d$4L‹¼$¨M;ïtI‹ÍèÔ|ÿÿAƒüþDDåA‹ÄëiÿU+ƒøuè/zÿÿÇ èDzÿÿÇéýÿÿƒømuD‹ç뮋ÈèHzÿÿéýÿÿ3Àë)èzÿÿ‰8èóyÿÿÇ E3ÉE3À3Ò3ÉH‰|$ è yÿÿƒÈÿHƒÄXA_A^A]A\_^][ÃÌH‰\$H‰t$‰L$WATAUAVAWHƒì0A‹ðL‹êHcùƒÿþuè¶yÿÿ3Û‰èyÿÿÇ ƒÈÿé3Û;ûŒâ;=}ƒÖL‹çL‹÷IÁþL=}AƒäMkäXK‹÷B¾L ƒáu.è\yÿÿ‰è5yÿÿÇ H‰\$ E3ÉE3À3Ò3ÉèKxÿÿƒÈÿé©‹ÃAøÿÿÿ–À;Ãu+èyÿÿ‰è÷xÿÿÇH‰\$ E3ÉE3À3Ò3Éè xÿÿƒÈÿën‹ÏèÞÿÿK‹÷BöD tD‹ÆI‹Õ‹Ïès÷ÿÿ‹Øëè®xÿÿÇ èÃxÿÿ‰ƒËÿ‹ÏèƒÞÿÿ‹Ãë)è®xÿÿ‰è‡xÿÿÇ H‰\$ E3ÉE3À3Ò3ÉèwÿÿƒÈÿH‹\$hH‹t$pHƒÄ0A_A^A]A\_ÃÌÌH‹ÄH‰XL‰@H‰HUVWATAUAVAWHì€3ÿA´€A‹ñH‹ÚÇ@¨o‰xœ@ˆ¼$ØH‰x°E„Ìt‰x¸A¶ë‰l$pDŠ÷HL$Tè©;ÇtE3ÉE3À3Ò3ÉH‰|$ èÝuÿÿºær÷Æ@u |$T€tE ô‹ÎA¸¸ÀA#Ⱥ€;ÏtT+Ít:;Ít1è´wÿÿ‰8ƒ ÿèŠwÿÿ»E3ÉE3À3Ò3ÉH‰|$ ‰èŸvÿÿ‹ÃéûD‹øë@öÆt÷ÆuíA¿@ëD‹ú‹Œ$àA¼ƒét,ƒét#ƒétƒétƒù@u‹D;ú‹Ï”ÁëA‹Èë A‹Ìë‹Íë‹Ï‹Æº‰L$H#ÂtF=t8=t*=t=t*=t&=t;Âté/ÿÿÿA‹ìë½ë ½ëA‹èºæA½€D‰l$PsŠ'löÐ"„$言AEDDèD‰l$P@öÆ@tAºíAºïƒÉD‰l$P‰L$Hºæ s AºíD‰l$P@öÆ tAºíë @öÆt AºíD‰l$PèIÜÿÿ‰ƒøÿu!èIvÿÿ‰8ƒ ÿèvÿÿÇèvÿÿ‹é H‹„$ÀD‹D$HH‹Œ$ÐH‰|$0LL$`A‹×D‰l$(ljl$ ÿb(H‰D$XHƒøÿ…Œ¹ÀA‹Ç#Á;ÁuC¸@„ðt9D‹D$HH‹Œ$ÐH‰|$0Aº÷LL$`D‰l$(A‹×‰l$ ÿ (H‰D$XHƒøÿu;Hc L-0yH‹ÁƒáHÁøHkÉXI‹DÅ€dþÿj&‹Èè‡uÿÿèBuÿÿ‹8éÌH‹Èÿþ%;ÇuMHc L-èxH‹ÁƒáHÁøHkÉXI‹DÅ€dþÿ"&‹È‹Øè=uÿÿH‹L$XÿV';ßu§èétÿÿÇ ëšA;ÄuA€Î@ë ƒøuA€ÎH‹T$X‹ è%ØÿÿHc L-{xH‹ÁƒáºHÁøD òI‹DÅHkÉXDˆtHc H‹ÁƒáHÁøHkÉXI‹DÅ€d8€AŠÆ$HˆD$L…†E„ö‰ÂA„ôtx‹ E‹ÄƒÊÿè¦ ‰D$Dƒøÿuèdtÿÿ8ƒtP‹ èõÒÿÿééþÿÿ‹ HT$@A¸@ˆ|$@èÕòÿÿ;Çu€|$@uHcT$D‹ 较øÿtÁ‹ E3À3ÒèE ƒøÿt°ºE„ö‰<¹@…ñu‹D$T#Áuºîë ð‹Æ#Á=@tJ=t,=@t%=t+=@t$=t=@u(ˆ”$Øë¹‹Æ#Á;ÁuDˆ¤$Øë@ˆ¼$Ø÷Æ„º‰|$DAöÆ@…¬A‹Ç%À=@„$=€t|=À…‡;ï†A;ìvƒýv8ƒý…l¾Œ$ØA¸‹ïA+È„ A;È…PÇD$Dÿþé‹ E‹Ä3ÒèÉÿÿH;ÇtÀ‹ E3À3ÒènÉÿÿHƒøÿ„|þÿÿ‹ HT$DA¸èbñÿÿƒøÿ„aþÿÿA;Ät ƒøuk|$DuD@þDˆ„$ØéÜ·D$D=þÿu‹ è%Ñÿÿè`rÿÿ»‰‹ûéã=ÿþu#‹ E3ÀA‹Ôè’ƒøÿ„ùýÿÿDˆ¤$Øé†‹ E3À3Òèpƒøÿë;;ïvqA;ì†üþÿÿƒý‡êþÿÿ‹ E‹Ä3Òè¡ÈÿÿH;Ç„Þþÿÿ‹ E3À3ÒèŒÈÿÿHƒøÿu8é™ýÿÿÇD$DA¼‹ HcÅE‹ÄHTDD+ÅèN°ÿÿƒøÿ„mýÿÿèD;åÛA¸Hc @Ь$ØH‹Áƒá@€åHÁøHkÉXI‹DÅ€d8€@l8HcH‹ÂƒâHÁøHkÒXI‹Lŋƀd8ÁèÀàD8@8|$Lu!@öÆtHc H‹ÁƒáHÁøHkÉXI‹DÅ€L A‹Ç%À=À…ŸA„ð„–H‹L$Xÿ^#‹D$PD‹D$HH‹Œ$ÐH‰|$0‰D$(Aº÷LL$`ÇD$ A‹×ÿQ#Hƒøÿu6ÿÕ!‹ÈèòpÿÿLcI‹ÃAƒãHÁøMkÛXI‹DÅB€dþ‹ è¢ÔÿÿéBûÿÿHcH‹ÊƒâHÁùHkÒXI‹LÍH‰ ‹ÇH‹œ$ÈHÄ€A_A^A]A\_^]ÃÌÌH‹Ä‰PL‰@L‰H VWHƒìXƒHØÿƒ`ÜE3ÀH…ÉA•ÀE…Àu(è pÿÿÇHƒd$ E3ÉE3À3Ò3Éè5oÿÿƒÈÿé“H„$€HƒÀD‹@øƒd$0D‰D$(ÇD$ @D‹ÊL‹ÁHT$@HL$Dèv÷ÿÿ‹ð‰D$Hƒ|$Dt9…Àt(Hc|$@H‹ÏH‹ÇHÁøLcsƒáHkÉXI‹À€dþë‹|$@‹ÏènÕÿÿë‹|$@…öt èsoÿÿ‰0ƒÈÿë‹ÇHƒÄX_^ÃÌÌÌ@SHƒì0M‹ÐH‹ÂH‹ÙH…Éu&èGoÿÿHƒd$ E3ÉE3À3Ò3ÉÇè\nÿÿHƒÈÿëUH…ÀtÕH‰L$ LL$XLD$@I‹ÒH‹ÈèσøÿtÖL‹L$XL‹D$@H‹Ó¹èçH‹L$@H‹ØèfqÿÿH‹L$Xè\qÿÿH‹ÃHƒÄ0[ÃÌÌÌH‰\$L‰D$UVWATAUAVAWHƒì0E3öM‹àL‹êH‹éH‹ñI;Îu(è–nÿÿE3ÉE3À3Ò3ÉL‰t$ Çè¬mÿÿHƒÈÿéD81tÓI;ÖtÎH‹I;ÆtÆD80tÁº\èvº/H‹ÍH‹øèfA¿I;Æ…œI;þ… AW9H‹ÍèRìÿÿH‹øI;Æ…ˆH‹Íè.ŸÿÿI‹×HXH‹ËèïnÿÿH‹ðI;Æ„sÿÿÿLl4H‹ÓH‹ÈèuÂÿÿA;ÆtE3ÉE3À3Ò3ÉL‰t$ èÌkÿÿL‹ÅH‹ÓH‹ÎèêÀÿÿA;ÆtE3ÉE3À3Ò3ÉL‰t$ è¥kÿÿH~ë I;þtH;ÇvH‹øHƒËÿH‹ÏS/èŸ H‹ÎI;Æt&3Òè A;Æ…÷M‹ÄI‹ÕH‹ÎèõýÿÿH‹ØéáèlžÿÿI‹×L`I‹Ìè-nÿÿH‹øI;Æ„ÎL‹ÆI‹ÔH‹Èè·ÁÿÿA;ÆtE3ÉE3À3Ò3ÉL‰t$ èkÿÿH‹Îè"žÿÿL4èõlÿÿM+æD‹8I?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~=runtime error TLOSS error SING error DOMAIN error R6034 An application has made an attempt to load the C runtime library incorrectly. Please contact the application's support team for more information. R6033 - Attempt to use MSIL code from this assembly during native code initialization This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. R6032 - not enough space for locale information R6031 - Attempt to initialize the CRT more than once. This indicates a bug in your application. R6030 - CRT not initialized R6028 - unable to initialize heap R6027 - not enough space for lowio initialization R6026 - not enough space for stdio initialization R6025 - pure virtual function call R6024 - not enough space for _onexit/atexit table R6019 - unable to open console device R6018 - unexpected heap error R6017 - unexpected multithread lock error R6016 - not enough space for thread data This application has requested the Runtime to terminate it in an unusual way. Please contact the application's support team for more information. R6009 - not enough space for environment R6008 - not enough space for arguments R6002 - floating point support not loaded Microsoft Visual C++ Runtime Library ...Runtime Error! Program: À À–ÀÀŽÀÀÀ‘À’À“À€€†€€†€†‚€EEE………00€P€ˆ('8PW€700PPˆ (€ˆ€€`h`hhhxppwpp ((((( H„„„„„„„„„„‚‚‚‚‚‚ h(((( H„„„„„„„„„„‚‚‚‚‚‚ H€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@abcdefghijklmnopqrstuvwxyz[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ABCDEFGHIJKLMNOPQRSTUVWXYZ{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿHH:mm:ssdddd, MMMM dd, yyyyMM/dd/yyPMAMDecemberNovemberOctoberSeptemberAugustJulyJuneAprilMarchFebruaryJanuaryDecNovOctSepAugJulJunMayAprMarFebJanSaturdayFridayThursdayWednesdayTuesdayMondaySundaySatFriThuWedTueMonSunGetProcessWindowStationGetUserObjectInformationAGetLastActivePopupGetActiveWindowMessageBoxAUSER32.DLLSunMonTueWedThuFriSatJanFebMarAprMayJunJulAugSepOctNovDecCONOUT$.com.exe.bat.cmd.\SystemRoot t d T 42àÐÀ 4 Œp¸P  4 p!ðÎ$!΢!ÔHÄI΢!ÔHÄIdJ΢!TRðÎ$ Kðàp0¸0bÀp`0à+ŒY@â 4RðàÐÀ p ` Pr0²042 p  4 2p d4rðàÐÀpà+ó'ü(Xâ2P d4 pà+**¯+ï*‘+zâ‘+ d T 4 rðàÐÀpt42 À  20dT42pdT42p) 4dZðà Ð Àp`P¸È Ä t d 4 ðàÐà+´:À:\=  ¼0 t dT42À d T 42ÐÀp  20d 4R Àà+ŸBC–â Ä t d RðàÐà+[D¡D¯â"D¾Dßâtd42Àtd42Ðà+£FãFøâd T 4Rpd 4 r p  $d´4³° p¸p  4 2pà+NkNã4r Ð Àp`P¸8 Ä t d 4RÐà+R;Sã20à+ W!W-ã  4 2pà+ÞWéWFãþW%Xfã42pà+‚Y°YFãÅYüYfãdT² pd T42pÔ t 4Rà t d 42àÐÀà+`Ï`ãB Bà+Gbzb ãzb Bà+™bbb d4rðàÐ À pà+@fÓfÁã bà+TgcgÝãcg t d T 42àÐÀd 4 R p t d T 4 rÀB  4 2p›4²p ` Pd 4R p  4 RpRP4 R pà+×vávÿã/ 4qfðà Ð Àp`P¸  d4 RðàÐÀpà+ =.ä4 R À p `à+€c€ä  4 ’p dT4’ÐÀp- Etd4C² ðàÐÀP¸Xd4Ò p1 5#td43rð à ÐÀP¸8d4² p2 0 d4 RðàÐÀpà+¶—é—.ä T4ràÐÀ p `µ tdT4’àÐÀd 4 RÐÀpà+㟠ä20¸PT42 p Ä td42Ðà+K¥k¥Eä Ät 4 rðàÐà+m¦“¦^ä¦Å§~äb¸(' EC ð à ÐÀp`0P¸pb‚t d 4RÀà+Ñ­¹®—ä  T ÒpdT4²pT 4 r p$ 53 ð à ÐÀp`0P¸X 4RðàÐÀ p ` Pd 4 ’ p ¢ðàÐÀ p ` P 0 d4 RðàÐÀpà+ìÆÇ.ä! !4!òðàÐÀp`PrP¢p`à+ÏÏüϰäR0 t d T 42ðÐÀd42 p4 ðàÐÀ p P 0#  ð à ÐÀp`P0¸xdT 4 ’p0fðÀÜò2H`xŒ”¦´ÆØæø.BVr¤¸Òæö$0BRbp~ˆ˜®ºÆÖþ0J`zž¸ÈÞø(<Lbr„–¨ºÆÔäú (:Lt€¢SGenerateConsoleCtrlEventÇGetExitCodeProcessrWaitForSingleObject–CreateProcessA´SetConsoleCtrlHandlerõGetModuleFileNameAÛEnterCriticalSectionîLeaveCriticalSectionúGetModuleHandleW/Sleep"GetProcAddressExitProcessqGetCommandLineA<GetStartupInfoAžRtlUnwindExôSetHandleCount>GetStdHandleÙGetFileTypeÀDeleteCriticalSection;TerminateProcess«GetCurrentProcessLUnhandledExceptionFilter#SetUnhandledExceptionFilterÐIsDebuggerPresentŸRtlVirtualUnwind˜RtlLookupFunctionEntry‘RtlCaptureContextçGetLastError¦HeapFree¢HeapAlloc]GetCPInfoTGetACPGetOEMCPÚIsValidCodePage×EncodePointer¹DecodePointer@FlsGetValueAFlsSetValue?FlsFreeøSetLastError¯GetCurrentThreadId>FlsAlloc›WriteFileðLoadLibraryAºInitializeCriticalSectionAndSpinCountLFreeEnvironmentStringsAÁGetEnvironmentStringsMFreeEnvironmentStringsWˆWideCharToMultiByteÃGetEnvironmentStringsWªHeapSetInformation¤HeapCreateSQueryPerformanceCounterjGetTickCount¬GetCurrentProcessIdSGetSystemTimeAsFileTime©HeapReAlloc…GetConsoleCP—GetConsoleModeCFlushFileBuffersàLCMapStringAMultiByteToWideCharâLCMapStringW@GetStringTypeACGetStringTypeWéGetLocaleInfoAìSetFilePointer«HeapSizeDCloseHandleWriteConsoleA›GetConsoleOutputCPšWriteConsoleW SetStdHandlezCreateFileASCompareStringAVCompareStringWÝSetEnvironmentVariableAKERNEL32.dllhReadFileÚSetEndOfFile&GetProcessHeapËGetFileAttributesAàE@àE@2¢ß-™+Í] ÒfÔÿÿ\)@ô@ðó@ÿÿÿÿÿÿÿÿ€         ! 5A CPR S WY l m pr € ‚ ƒ„ ‘)ž ¡¤ § ·Î×   abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ(@¤`‚y‚!¦ß¡¥Ÿàü@~€ü¨Á£Ú£ þ@þµÁ£Ú£ þAþ¶Ï¢ä¢å¢è¢[þ@~¡þQQÚ^Ú _ÚjÚ2ÓØÞàù1~þôþ@þÿÿÿC@-@@-@@-@@-@@-@P2@ðü@€@@Ð0@P-@P-@(@ÿÿÿÿXú@(ú@ øù@ `ù@(ù@øø@Ðø@ ø@hø@@ø@ø@Ð÷@¨÷@ˆ÷@ ÷@ èö@!ðõ@"Põ@x@õ@y0õ@z õ@üõ@ÿõ@›@›@›@›@›@›@›@›@›@›@  ðü@òþ@P@L@H@D@@@<@8@0@(@ @@@ô@è@ä@à@Ü@Ø@Ô@Ð@Ì@È@Ä@À@¼@¸@°@ @”@Œ@Ô@„@|@t@h@`@P@@@8@4@(@@@ Ð0@.@2@lB@lB@lB@lB@lB@lB@lB@lB@lB@P2@.€pðñÿÿPSTPDTà2@ 3@ÿÿÿÿÿÿÿÿþÿÿÿÿÿÿÿþÿÿÿÿÿÿÿÿÿÿÿ;Zx—µÔó0Nmÿÿÿÿ:Yw–´Óò/Ml8@0@(@ @çxðY”`«x°Ôd à¬íôðÎ$΢¢_ô_¯Ü¯·Ì·Õ¼øm<xZh\ƒd „ãhähjd l“d ”ÕhT·h¸Õd Øÿ< ¥"d¨"6#àp#$h$š$|œ$5%„&5&h8&q&ht&Š&h¤&×&ŒØ&'˜'Ã'˜Ä'N)¤ˆ)ï)hð)É+ÜÌ+Þ+d à+-„-U.4X..D.×.hØ.)/L,/ª/`¬/‘:t”:=˜„=º=<Ä=é>Ðì>q?¼ ¼?Ü?d Ü?ü?d ü?B@hD@°@`°@3AÜ4A¹AܼADBôDBB „B4C 4C­C °C÷ChøCìD< øD‚E| „EF` FG GLG˜LGûG€ üGRI¼ TIÏIÐ üIJ<JZKà \KîK`ðKÓMè ÔMN N O| O—Q( ˜QSD S¸Sd ¸S2U tVËVhÌVAWt `W…Wd ˆW:X” â€@âX⌠XâzâÔzâ–âÔ–â¯âÔ¯âÕâÔßâøâÔøâãÔã-ãÔ-ãFãÔFã_ãÔfããÔã“ãÔ ãÁãÔÁãÝ㌠ÝãÿãÔÿãäŒ ä.äŒ .äEäŒ Eä^äÔ^äwäÔ~ä—äÔ—ä°äŒ °äüäPsetuptools-20.7.0/setuptools/gui-arm-32.exe0000664000175000017500000020700012702524020021365 0ustar travistravis00000000000000MZÿÿ¸@º´ Í!¸LÍ!This program cannot be run in DOS mode. $Õ7 <‘Vco‘Vco‘Vcoö¤o•VcoU“¨o“VcoU“®o“VcoU“­oVcoU“¬o“Vco‘Vbo¢Vco%“¨o’Vco¶±oVco¶ªoVco¶¯oVcoRich‘VcoPEÄþFǹBò€Àò@h˜GBò Àò@*hBò@Àò@h@0˜G ò-ð½û½èðž!ë XBò„Àò@h˜G€F8Fÿ÷ÈýÈøñ. Ý5>Uø ÿ÷¼ýDø >÷Ѩÿ÷µýDø ¹ñ Ý ñ©ñUø ÿ÷¨ýDø >÷Ñ#AF8F#`ðdûBò€Àò@h˜GBò Àò@BòdÀò@:Fh@0˜G ò-ðkû½èðÿ÷ü¾ßø ÀÜøÀ`EÑpG0@µ‚°ßøÀÜøÀÍøÀßøÀÜøÀÍøÀðRùþÞ0@0@-é%R%v%„%Ž%–%¤%($$$¸$*&2&<&D&N&X&b&E@í@@-@%R%v%„%Ž%–%¤%($$$¸$*&2&<&D&N&X&b&yGetModuleFileNameAKERNEL32.dll¶isspaceocalloc__iob_func9_makepathŽfprintf-_splitpathMSVCR110.dllŽ__getmainargsÚ_amsg_exitzexitñ_cexit9_exit]__C_specific_handler½_initterm_e¼_initterm__initenvY_XcptFilter¶__set_app_type¸__setusermatherr_configthreadlocaleT_fmodeÿ_commode9?terminate@@YAXXZƒ__crtSetUnhandledExceptionFilterð_calloc_crtÐ_onexit*_lock†__dllonexit_unlock;EncodePointerDecodePointer1QueryPerformanceCounter'GetCurrentThreadIdñGetSystemTimeAsFileTimeGetTickCount64æ_readý_closeÑ_open5_execvstrlenstrncpystrncmpNæ@»±¿Dÿÿÿÿþÿÿÿ1a5™"©¥b6ýý¸""E}`qý™"­`í=a?É%`?Ý8"-%`?EI`1qI`1m`1å@"[`y1`?íu`1)h"Ý1±Ü"Éè"åô"ýI`?€0€ H`P} ÜpÈpðp8qNqzqºqÌqìqr rrjrrrˆrÖrär sJszs†sŽsÚsîs t,t6t\tÄtÐtØt5<5@5„5ˆ5Œ55”5¼6À6Ä6È6Ì6Ð6Ô6Ø6Ü6à6ä6è6Œ77”7˜7œ7 7¤7¨7¬7°7´7¸7¼7À7Ä7@8h8l8”8˜8Ô8Ø8Ü8à8d9h9l9p9t9yœy¨y´y4zŒz ;;;; ;(;,{8{D{P{\{h{t{€{Œ{˜{¤{²{È{ | ´0À0Ä0È01 1MZÿÿ¸@𺴠Í!¸LÍ!This program cannot be run in DOS mode. $6á3r€n`r€n`r€n`r€o`"€n`ÆE¥`q€n`ì ©`v€n`¶E¡`W€n`¶E `€n`¶E£`x€n`UF `s€n`UF¢`s€n`Richr€n`PEÄR€\Qà"  šhm"°@0@àÒ(h °.textô˜š `.rdataD)°*ž@@.data$+àÈ@À.pdatahØ@@.reloc‚  à@B-éøCFð üFsØ!ðüFOð" z!$.€ø)ÝOð\Oð\cW\+Ñ1à"+ Ñ)ÝFPøëƒBûÑR!ø‹à!c]4´Bø;äÛ)Ý\$F!±PøKƒBûÑR#‚øSp8F½èøƒ-éøOŠFFðÆû!ðËû#Êø0FÀø@”ù&F%Oðð1ü0±4”ùð+ü(øÑOð\ \!ù{W³8Fð ü±¸ñ"Ð\/Ñ5ðç"/ ÑðѸñÑOðàOð'm=±3Frø»“BûÑv%/Oð\ÕÐø{Ñç\!=±3Frø“BûÑv%#ø;Úø03Êø0Iø#`§±”ùðàû0±4”ùðÚû(øÑ”ù0Oð\+«ÑHF½èøHF½èø-éøCF‰F€FðIû†/ Ý ñ}Tø ð?ûƒ^=÷Ñ!0Fð?ûKòXÀò@BFFðßû@Fð,û€F/Ý ñ~Uø+Kò\Àò@ëðÌûUø ðûëñ>ëÑ F½èøƒ F½èøƒ0µð÷û­òMù FFFJ±\!3/*Ñø“ù *öÑD«“„«ª©(Fðýù0Û»ù0\+7ÐD«“„«ª© Fðý¨ðÝú«Z’ù0\+Ñ:’ù0 \+ЩŠBÓpù=\+øÑĨª©+Fð ý!Oô‚pðÄúÄ©Oô‚rFðÖú F òMð«û0½!Oô‚pð³úOô‚r)FFðÅú F òMðšû0½µp¹Nö€cÀò@h0±KòÀò@!h˜G ½ ½µž°F# ¨D"!““ “ “ “ðÔüD# “KòÀò@Aòé Àò@!h˜G«“ «“!FKòÀò@#“““$h#“#"  GX¹ð.ùKò`Àò@@0ð×ù °½Nö€bÀò@ ›˜oð`KòÀò@h˜GKò Àò@˜©h˜GX¹ð ùKò|Àò@@0ð³ù °½˜°½-éðOðû­ò-KòÀò@’‹Fh‚FOô€r© ˜G¨ðú«Ä«&œBÙ­”ù0.+Ð&p<¬B÷Ø«Kò¤Àò@Z&pø?+ûÑø;+ø;ùѨ!ð°þF°ñÿ?Ñð¼øKò°Àò@ª@0ðdù ò-ðÓú½èðB©Oô€r(Fð÷ùB«Ä(FðØýB«;3£BÒ“ù ± *Ð *õÑKòÀÀò@B¨"pðEü`±KòÄÀò@hB“ShC““hD“{ø1© õ…pÿ÷ØýF(h©ÿ÷“þF‡¹ðqøKòÔÀò@*h@0ðù ò-ðˆú½èðž!ë ñðŒù€F8Fÿ÷nýÈøñ. Ý5>Uø ÿ÷býDø >÷Ѩÿ÷[ýDø ºñ Ý ñªñUø ÿ÷NýDø >÷Ñ##`›AF8F“±ðìùð(øKòøÀò@@0:FðÐø ò-ð?ú½èðJFÿ÷ðýÿ÷´þ ò-ð4ú½èðNöŒcÀò@"hNöˆcÀò@hÿ÷¿HpGà@-é0H ò L h¹Oôpà(Ú `!ð™þ M(`H¹#! #`ðþ(`¹ àJ#P3 2P+Ú(høç ½è0ˆà@ Aû@-éH ò ðzÿK“ù0 ±ðxÿL hð¼ÿ##`½èˆ A¨î@-éH ò JF”BÓò`#œB Ø£[ñð øãhSôCã`àKñ h˜G½èˆ°@à@-éH ò F(Ú0ðòÿãhSôCã`àKñ h˜G½èˆ°@ JB Óò`#˜B ØÃh3ôCÃ`ƒ[ñðí¿K 0hGþÞ°@à@(ÚËh3ôCË`0ðÛ¿Kñ hG°@´-é¾H ò oFybF$<`E¹ðú#`ðÏúoðWà)ôÐðvù(öÛ}`(Fÿ÷~ÿëhð@5Ñ(FðÉú°ñÿ? Ðñ ÐC$IðQø#0ë‚"Jà!JFI“ø$0ðѰñÿ? ÐñÐCðQø#0ë‚’ø$0ð€Ðð;ú#`ð‹úoð<`|¹(Fð¢úFñ("yj(FðVû8`)F FðÝúðø8h½è¾]øûµxhÿ÷bÿ½þÞàù@ ã@Fù;+ûÑXpG-éH ò #jF“ðcÿFD¹›3±ðûù±ðøù›` F½èˆ-éH ò F‚±  Vø; ±:ùÑB±:Ð!"±ƒø˜BûÑ F½èˆ-é0H ò F##sY»ð²ø `ÃnM#`ƒn"hc`KhšBÐo+hBÑð]ú `KbhhšBУho+hBÑð~û``¢hoð ÑSðg##sà h#`Khc` F½è0ˆþÞ”ç@ˆç@\å@-éH ò …°KFh;¹KÓø03ø0ðàhF!ÿ÷©ÿšSo+ÝjF! FðˆýàÒø03ø0ðø 0#±šo3ðg°½èˆÐæ@Dð@´-é0H ò ˆ° FF#¨!" •“ð˜ùE¹ðOù#`ðŸùoðà,ôÐoðC“B#“«hF")F””ðgú›F;“+Û›"pàiF ð­ý F°½è0]øû°Nö´LÀò@ ÜøÀ­ë ÍøÀpGNö´LÀò@ ›ÜøÀ­ëcEѰpGFµlFìF,ð åFð"þ¥F½è@pG-éHëFÛih3ðPXðÐXðþ ½èˆ-éþO ò( F–“Ýø4 FÝø<€ šžF›‰F™ '±¹ñѱ ´à.ûоñÑ*öÑà*óкñÑ+îÑà+ëиñÑ)æÑà)ãÐ",F”ù0±:4*øÑ”ù0:+ѹñ Ð.Àð€#oð*FHFðÞýÝøàeà¹ñЉøp•ù0'&+,FJДùðþý±4 à”ù0/+Ð\+Ð.+Ñ&Fàg4”ù0+èÑÝøà‡³¾ñ Ð š{šBDÙ*FoðpFð§ýÝøà=F'.³®B#Óºñ КsšB6Ù*FoðPFð“ýÝøà¸ñ#Й£™B(Ù2Foð@Fð„ýà¾ñÛÐ'ŽøpØçºñ КcšBÙ*FoðPFðoý¸ñЈøp 2à™ 'à šà™ š ž›¹ñб‰øp¾ñÐ ±ŽøpºñÐ ±Šøp¸ñÐ ±ˆøp=¹ðø#`ðRø à(õÑðøÿ"#`" ½èþ-éðH ò †°Ýø0àFF¾ñOô€tÐ%Fà%±#Fà#¹$ ±"à"“;F•Íø à–”ÿ÷âþ°½èðˆ-éH ò FF F™”‘oððDý½èˆFÛðÿAê!ð ÑAêA :ŒFÛ£è:£èùÚ2Û£è:ÛCøÚÐp*ÛYpÈ¿™ppGðÐRøðØÐ’#øÔç-éxH ò F$-FÐ-BÓ.@Ð0ù,1Z³ù<šB'Ñù,ú±ù<šBÑù,š±ù<šBÑù,:±ù<šBÑ4´BÞÓàø,ø< àø,ø<àø,ø<àø,ø<Ð àù Z±‘ù0šBÑ041¬BóÓ ½èxˆx xëç-éH ò K IFhjF ˜G@±KI˜h˜GF ± F˜G½èˆþÞ$²@,°@ ²@(°@ ð9¼ ðO¼-éH ò K h˜GFðûü Fð&ÿ Fðý Fðý Fðý Fðþ½èˆ$°@-éþI ò F& F?¹ðÞþ#`ð.ÿ ?à-õÐð2þ ¹ Kh˜G¹&LOðê$h:F!0FÅø€Íø€Íø€ GF4¹Kh˜GðÓþ à`ðNú(`(÷Д Loð$h:F!0F GP¹Kh˜Gð»þ(hð`ûÅø€áç ½èþ‰8°@4°@0°@-éH ò Fÿ÷[ÿK Fh˜GþÞ<°@-é0H ò LF#h3± Fð)þ±#h(F˜GðUþLM ¬BÒø¹Tø;±˜G¬BøÓÀ¹HðÿL MàTø;±˜G¬BùÓL#hC± Fðþ ±#h"! ˜G ½è0ˆþÞèú@ ±@±@eL@8±@$±@ìú@´-éøO ò oFFh$@FðßùF}¹v±Ùø0 F˜G>hòè3F³BÙoð´ñÿ?êÑ(F½èð‹D°@Äî@-éxH ò Fâh%ð+Ñô„Ð"h£hÖ.Ýð‹ü¡h2Fð­üãh°BÑð€Ð3ðàSð oðã`£h(F#`#c`½èxˆ-éH ò F¹ ðøà Fÿ÷Åÿ±oð àãhô€OÐ FðZüðäü(ñÑ ½èˆ´-éþI ò oFF½b&~`#»` ðù$<`*KhœB3Úßøœ€Øø0Sø$1³Ëhðƒ"Ð Fÿ÷ÿøØø0Sø$ÃhðƒÐ-Ñÿ÷±ÿ°ñÿ?Ðs{` àU¹ðÐÿ÷¥ÿ°ñÿ?Ñoð»`ðø;h\<`½j~hÇçð ø»j+Ñxhà¸h½èþ ]ø ûµ ðßø½µ8hKhSø ÿ÷òø½þÞ Aû@ ÿ÷•¿-éþI ò oF%=` ð¨ø$|`Nßøl€Øø0œB$Ú3hSø$è±ÃhðƒÐðïü°ñÿ?Ð5=`,Û3hSø$0ñ Kh˜G3hSø$ðø3h"Cø$ 4|`Öçðø8h½èþ‰µ ð‹ø½H°@û@ A-éH ò €± KF!hKh˜G@¹Kh˜GðûFð'û`½èˆ8°@L°@ ö@-éðH ò L NO$%ch+Ñ;h0F&`Oôza6˜G4=òÑ ½èðˆP°@Èî@€â@-éðK ò LßøH€$&%FOð /h_±kh+ÐØø08F˜G8Fÿ÷­ÿÅø5>îÑN$% h ±ch+Ñ3h˜G4=õѽèð‹H°@€â@-é0H ò MFUø00+¹ðø¹ ÿ÷1ýKUø4h˜G½è0ˆ°@€â@KSø0KhG°@€â@-éðH ò oFFKh;¹ð7ü ðhûÿ ÿ÷ üMUø60ë¹ ÿ÷2þF,¹ð’ú #` à ÿ÷¹ÿUø60 F;¹Oôza Kh˜GEø6@àÿ÷Aÿðø ½èðˆµKmKh˜G½þÞ°@€â@P°@ ö@-éHëFHOô€r!ÿ÷¥úK"`½èˆàú@àù@-éðO ò ™°oF ÿ÷{ÿžL#h;±#{a£Iñˆðùû%á@! ÿ÷°ý8`8¹#»a›Iñˆðëûá `ßø\‚ #Èø0%éC "#hö˜BÒq`Bq…`ø$03ð€ø$0[²ð€ø$0€ø% €ø& …c€ø4P@08`áçñ ‚Kh˜G·øR0+ð‡€{m+ðƒ€hñ Çø ë Çø ¶õoÛOôf$¼`Øø0³B.Ú@! ÿ÷Yý8`0³jJBø$Øø0 3Èø0 !Rø$0ö˜BÒqoð`Aq…`ø$03ð€ø$0€ø%€ø&…c€ø4P@08`ãç4ÍçØø`¨F}`°E:ÚÚø°ñÿ?(Ðñ%Йø0ð ÐðÑMKh˜Gȱ_êhðGIQø#0ë‚<`Úø0#`™ø0#qOôzañ @Kh˜G£h3£`ñÇø€ ñ Çø ñ Çø Âç6L}`ßøä€oð -TÚ#hë…<`#h³ñÿ?ÐñÐ#yoðC#q?àoð~#q¹oð à-Ñoð àoð %Kh˜GF°ñÿ?Ðæ± Kh˜GÀ±&`ò+Ñ#ySð@à+Ñ#ySð#qOôzañ Kh˜G£h3£` à#ySð@#qÄøØø0±Sø%0Ãø5}`L¨çð ø àxià¸i¿°½èðµ ÿ÷Yþ½àù@P°@X°@\°@ AT°@àú@*@*@-éH ò LIH$h#" G± àoð½èˆð@'@`°@-éðO ò ‡°Fõi4hŽF+h‘qh‚F´ë ðO‘Ð3ðDe–ø(@ ±©ñ Úø@ðfQÑÖø$€Íø ’+h˜E€ð€ILë{h™E9Ó»h™E6Ò;i£³úh*ÐójRqF¨ðoú(0Û%ÝÚø0>J“B Ñ#h;± FðNø±#h!PF˜G;iœ™"ðjú3j9i˜“si 0L“Úø0$hRF Gð_ú+LÝøà™+hñ7˜E¼ÓGà Fà3iwj(h³ë‡B>Òëch™E1Ó£h™E.ÒÚø0ð ÐOð ±)FKh˜E Ó‹h˜EÒ i#išBÑÊhãhšBÐñ1†EìÓ™†EÑÝøà#i±˜EÐà{sbâhójRqF ðú(h7™Ýøà4‡BÂÓ °½èðÈù@d°@csmà-éH ò I" FTø;˜BÐ2-*øÓ°ñ+Ø à°ñ¼+Ø à à Sø2½èˆþÞàã@-éHëFðoþ¹Hà0½èˆþÞHå@-éHëFðaþ¹Hà 0½èˆþÞLå@-éH ò Fÿ÷ëÿ` Fÿ÷µÿFÿ÷Öÿ`½èˆK`pGþÞð@ ûÞ-éüK ò LFF hLFˆF$h GFE± œ3F:FAFHF”¨G½èü‹ ûÞ °@ð@-é H ò #"! “ÿ÷×ÿ½è ˆ-éHëF@¹ÿ÷˜ÿ#`ÿ÷èÿoðài½èˆ-éðH ò Fÿ÷éÿðeù¨³þ÷Füñ œBÑ%àþ÷>üñ@œB'Ñ%Jh3`ãhô†ÑOOô€VWø%h¹0Fÿ÷ûGø%8¹ñ£`#`#£ac`à ` `¦af`âhAòCã` à ½èðˆþÞ ð@„î@-éH ò Fp±ãhô€_ ÐFÿ÷ûúãh3ôˆSã`#£a#`£`½èˆ-éH ò ËhFð@Ћh›±Kh;K`+Û hp hÀ²3 `àð—û°ñÿ?Ñoðà#h3#`½èˆ-éøO ò Òø @FÕøð@FF‚FÐÒø@¹2hÒ2`à#+`/Ýù 2FAF?ÿ÷ºÿ3h³ñÿ?Ñ+h*+Ñ2FAF? ÿ÷®ÿ/êÜ+h ¹Åø½èø-éðO ò þ÷¨ý­òx-™F#“# “# FF¨F “““”–%Oð þ÷Þüÿ÷´þÿ÷³ýê (Àòòƒ–³óhð@-Ñ0Fÿ÷ÿßøHßøü°ñÿ? ÐñÐCTø#0ðë‚à F“ø$0ðѰñÿ? ÐñÐCTø#0ðë‚‘ø$0ð€Ñœ4¹ÿ÷vþ#`ÿ÷Æþ¶ã”ù`' #!2F. ——“ð©ƒ›ßølçÝøH€“4”/Àòžƒ * Ûx*Üßø\7›ø <ðà#ëÃßøH[V ‘)òxƒßèð«.JMgÆ#“#% “Oð!ê #“Íø<à ‘^ã *Ð#*Ð+* Ð-*Ð0*@ðWƒUðSãUðPãUðMãUð€JãUðGã**ÑÙñðKDñ Yø ‘)€ò8ƒUðIB ‘2ã ›ëƒëC0; “+ãOð (ã**ÑÙñðKDñ Yø¬ºñ€òƒoðšFã ëŠëC³ñ0 ãI*Ðh*Ðl*Ðw*@ðƒUôeã”ù0l+Ñ4Uô€UúâUð÷âUð ôâ”ù 6*Ñ”ù04+Ñ4UôEèâ3*Ñ”ù02+Ñ45ôEÞâd*ðÜ‚i*ðÙ‚o*ðÖ‚u*ðÓ‚x*ðЂX*ðÍ‚# “#𲩓ðÎùP±™ª0Fÿ÷Zþ”ù`4.ðÀ‚™ª0Fÿ÷OþŸ˜ —¬â²ñA7)ò‚ßèðÝ8ÝÝŠSeâ=MâââMÆdQOUôoÑUôeôoÐÙñðKDñ 9ø¯Uô€uñ8çUð@ $àOð #à'#$ð€“Ð0"ø Q3" ’ø0à$ð€ÐUôuôO ÐÙñðKDñ Yø Yø<6àô€_ðÑð Ðð@ ÐÙñðKDñ 9ù Ã"àÙñðKDñ 9ø óçð@ ÐÙñðKDñ Yø FÛ àÙñðKDñ Yø #Íø0ð@ Ð+ ÜÛ(Ò@BOðrëUô€uôOÑô€_Ñ3ðÿ3ºñÚOð à5ðºõÝOôzPêÑ" ’ÝøL òo(ºñªñ ÜPêÐF Fá¹¹ùÞð ÿ02“9* FÝJDø)æç òo#£ëÝø0ñô б˜ù00+Шñ0#ˆø00›+@ðˆ€ð@Ðô€Ð-#àðÐ+#àðÐ #ø0# “ › šžŸð Ñ`%½` ,3Ü Ð,Ð, Ð,9Ð,Ð/àßø`Øø?àÿ÷øF½`¹oðàèmFQKhëAëƒSh£BÐ 2rEùÓëA냚BÒSh£BÐ"ñØøà,Ð, Ð,Ðþ÷yù#`þ÷ÉùÒç`3Kh˜Gx`(Nй ý÷Àû± ý÷„þ,Ð ,Ð,Ð à+n;a (f,Ñkn{aŒ#kf,Ñ!L"hFú`N3h›™BÚëAëm나`1ù`"hñç Kh˜GÈøðø¼k,{hѽhin ˜Gà F˜G½h,Ð ,Ð,Ñ;i+f,Ñ{ikf °½èð ]ø ûµ;h± ý÷Kþ½$°@ÌÁ@ÈÁ@ °@Tð@ÀÁ@-éˆH ò oFþ÷Óÿƒo±˜Gð¼þþÞ-éHëFKHh˜GK`½èˆþÞhð@]J@$°@-éHëF’°KhFh˜G ›ðнø0à °½èˆþÞT°@KhGþÞŒ°@KhGþÞ°@KhGþÞ”°@KhGþÞ˜°@KhGþÞœ°@-éH ò L#h+ Ú#“K!hFh˜Gz(Ñ#à##`+Ý à ½èˆˆ°@¼ì@ˆEöM#šBÐ pGÃkXDòPSšBöÑ ‹@ò šBñÑ pG-é0H ò Ãk$“ŠÕˆ›ñU±Âh‘BÓƒh›™BÓ4(0¬BôÓ ½è0ˆ½è0ˆ-é¸H ò oFF@òÀò@(Fÿ÷¿ÿ¹ 8`àa(Fÿ÷Íÿ¹ 8` àCjðOÑ à 8`à à8h½è¸ˆhhKšBÑ à pGÀ-éxH ò LN % h3h˜GDø =øÑ½èxˆ$°@Àì@-é0H ò KM3«BÒTø;±˜G¬BùÓ½è0ˆ,Ë@(Ë@-é0H ò KM3«BÒTø;±˜G¬BùÓ½è0ˆ4Ë@0Ë@-éH ò ! ý÷Fû KFh˜GK`K` ¹ à##` ½èˆøú@ôú@$°@-éøO ò oFFý÷¨ø*Kh*Kh˜G€F%Kh'Kh˜GFÁE8Ó ë ñ.2Ó@Fð‹ýF´BÒ°õoÒFàOôc¡BÓ@Fý÷×ú8¹ñ¡BÓ@Fý÷Ïú°±_êªëƒ Kh˜GK`(F Kh˜GÉø ñ Kh˜GK`à%=`ðø8h½èøµý÷[ø½øú@$°@ôú@ °@-éHëFÿ÷™ÿ¹oðà ½èˆ-éH ò I" FTø;˜BÐ2*øÓ à Sø2½èˆþÞ°¿@-épH ò ü÷þ­ò-Fÿ÷ÝÿF-~Ð ðù(VÐ ðùYL¹Ôø(6+MÐü.nÐTJOôEq Fðú(@ðˆ€#¤ø:2MKOô‚rñ2h ˜G@òû&8¹GJñ21Fðÿù(UÑñ2ð%úC<+Ù°ñ;ñ2ëBñ2:Jæëc#ðcù(DÑ5JOôEq Fð©ù(JÑ*FOôEq Fð¡ùà»,J+I FðÕü"à'Koð h˜GFܱ°ñÿ?Ð"©5ø;ST±2²õú÷Ó#¨ø2ü÷¢üF FL#“$h«© G ò-ü÷ý½èpˆ#"! “ý÷Òþ#"! “ý÷Ëþ#"! “ý÷Äþ#"! “ý÷½þ#"! “ý÷¶þþÞþÞ¤°@\°@àÀ@ ÔÀ@ÌÀ@œÀ@ °@hÀ@pð@-éHëF ðDø(Ð ð?øH¹Kh+Ñü ÿ÷!ÿÿ ÿ÷ÿ½èˆ˜ö@hK hšBÑ i+ ÑJi KšB ÐKšBÐKšBÐKšBÐ pGÿ÷C½þÞ@™"“!“ “csmà-éHëFHÿ÷hý ½èˆþÞ¥O@-éHëF( Û(Ý(Ñ Kh àKh`àý÷þ#`ý÷`þoðF½èˆþÞœö@K`pGþÞ˜ö@-éHëFKh˜GK`¹ à ½èˆ ö@¨°@-éðI ò …°&Kh˜GFî³3ˆFà2ø?¹2ˆ+øÑL“_$hOð{2F! Íø €Íø€Íø€Íø€ GFÔ±ý÷]ùFµ±”L{2F$h! Íø €Íø€• G¹(Fý÷rú%K0Fh˜GàK0Fh˜G%(F°½èð‰þÞ´°@°°@¬°@-éøO ò Ýø(šF#Éø0#Êø0FˆFF±Áø ñ'”ù "*ѹ'à'Ö²àÙø03Éø0±#x+p5øk0Fÿ÷ÞúH±Ùø03Éø0±#x+p546±/ÙÑ .Ð .ÕÑ~¹ú\”ù0+óÑh!ü÷¸ÿßø€€F-ÈøåЯ àYø$0™Z+x‚ø40Yø$0["šc’D á áœ"Yø%0yð€ðð€%.FÑFF/ð $ ñ@ Aòÿ>«"¦ë¹BÒ–ù61 (Ñp3522rEø îÓ‰H œ ñ@ £ë Pø$œ#“Y…L «JF$h©• G(OððÀ ›šDKEÀò€¦ë»Bñ Aòÿ> ñ@ ÂÓ¶à.CÑFF/ðÄ€ $ ñ@ Aòþ>«"¦ë¹B Ò0ˆ61 (Ñ€3522rE#ø ïÓeH œ ñ@ £ë Pø$œ#“YaL «JF$h©• G(Oð{Ð ›šDKE{Û¦ë»Bñ Aòþ> ñ@ ÅÓpàÁF/ð€€ $ ñ@@öUV õ¢S"©ë¹BÒ¹ø1 ñ (Ñ€322²õÕo#ø íÓ"DL’’ õ¢R›$hëÓs[ õ¢R!OöéP–Íøà GF’ª³&6H œ#©Pø$@˜“ « X3L’‰$h G(± ›šö²BêÜà,Kh˜GšF²BÜ©ë ºEOð @öUV ñ@©Óà$Lh’$h «:FAF G±Ýø( %àKh˜GFºñ&Ñu±-Ñü÷²ÿ #`ü÷¼ÿ#`›å(Fü÷Äÿ—åK šSø"0š›yð@Иù0+?ôz­ü÷–ÿ#`ü÷ ÿ#â盪ëAöð,åDû÷pþ½èðàù@8°@¤°@°°@̰@Ȱ@\°@´-éøO ò oF‘FŠFF¼bñÑü÷wÿ#`ü÷eÿ #`?àü÷bþ(;Û,/Û#KhœB+Òe NðVø%0ëˆyðÐ FðÃÿVø%0ëˆyðÐJFQF Fÿ÷ ý8` àü÷8ÿ #`ü÷Bÿ#`ÛC;`ðø8h àü÷8ÿ#`ü÷&ÿ #`ü÷vÿoð½èø]øûµ¸jðÒÿ½þÞàù@àú@´-éøI ò oFF³;p½±#+`à#L“«“@h$h#“#ª!–— G0±›+Ñѱ(` Ôç Kh˜Gz(ÈÑ/±&±2F!8Fû÷[ûü÷û"#`ü÷cû" ÀçþÞ8°@°°@-éH ò $”ÿ÷zÿ½èˆKhSðKh“BÑ pG pG°÷@´ì@-é0H ò F,NÐ(Màhëh˜BÐû÷¤ÿ i+i˜BÐû÷žÿ`iki˜BÐû÷˜ÿ i«i˜BÐû÷’ÿàiëi˜BÐû÷Œÿ j+j˜BÐû÷†ÿ`jkj˜BÐû÷€ÿ k«k˜BÐû÷zÿàkëk˜BÐû÷tÿ l+l˜BÐû÷nÿ`lkl˜BÐû÷hÿ l«l˜BÐû÷bÿàlël˜BÐû÷\ÿ½è0ˆðì@-é0H ò Fô±M h+h˜BÐû÷Kÿ`hkh˜BÐû÷Eÿ h«h˜BÐû÷?ÿ k+k˜BÐû÷9ÿ`kkk˜BÐû÷3ÿ½è0ˆþÞðì@-éH ò F,ð<`hû÷#ÿ hû÷ ÿàhû÷ÿ iû÷ÿ`iû÷ÿ iû÷ÿ hû÷ÿ jû÷ÿ`jû÷ ÿ jû÷ÿàjû÷ÿ kû÷ÿ`kû÷ÿþàiû÷üþ kû÷ùþàkû÷öþ lû÷óþ`lû÷ðþ lû÷íþàlû÷êþ mû÷çþ`mû÷äþ mû÷áþàmû÷Þþ nû÷Ûþ`nû÷Øþ nû÷Õþànû÷Òþ oû÷Ïþ`oû÷Ìþ oû÷Éþàoû÷ÆþÔø€û÷ÂþÔø„û÷¾þÔøˆû÷ºþÔøŒû÷¶þÔøû÷²þÔø”û÷®þÔø˜û÷ªþÔøœû÷¦þÔø û÷¢þÔø¤û÷žþÔø¨û÷šþÔø¸û÷–þÔø¼û÷’þÔøÀû÷ŽþÔøÄû÷ŠþÔøÈû÷†þÔøÌû÷‚þÔø´û÷~þÔøÔû÷zþÔøØû÷vþÔøÜû÷rþÔøàû÷nþÔøäû÷jþÔøèû÷fþÔøÐû÷bþÔøìû÷^þÔøðû÷ZþÔøôû÷VþÔøøû÷RþÔøüû÷NþÔøû÷JþÔøû÷FþÔøû÷BþÔø û÷>þÔøû÷:þÔøû÷6þÔøû÷2þÔøû÷.þÔø û÷*þÔø$û÷&þÔø(û÷"þÔø,û÷þÔø0û÷þÔø4û÷þÔø8û÷þÔø<û÷þÔø@û÷ þÔøDû÷þÔøHû÷þÔøLû÷þýÔøPû÷úýÔøTû÷öýÔøXû÷òýÔø\û÷îýÔø`û÷êý½èˆ-éðO ò ú÷úÿ„°oF‚°{`&×ø< :`¹`ºñÑhÐø 8l± !à!1L $hPF G€F¹&OàMöÝY¸ñ&Ý#Û;˜E!ØñX°õ€oØÃƒBØoð3ðœðåÿ­ë ñ ÐLöÌC+`àþ÷bþF-ÕÐÀø5à%-ÎÐ_êH!(Fû÷ùL{h:h$h!PFÍø€• G8± L»kF$h¸h)F GFUøöѹ…ø 5*Eјø0 ±.ѵñ ÈF¡E Ó˜øiFý÷Žø±¨ñ EõÒ©ëðÐø¬>à¶ñÿ?Ñ/Ùë¨ñ5F¦BÓ(xiFý÷qø±=¥B÷ÒsðÐø¬àãø¬P %à„ø û÷ãú"#`û÷3û" à++Û¯>F§BÓ0xiFý÷Lø±>¦B÷Ò»ðÐø¬û÷Æú*#`* à ø 0+?ôj¯šo3ðgcç-é?H ò F F=¹û÷­ú#`û÷ýú #à,õÐ¥BùÒhFFú÷Çø™‹h ¹`àb:•BØx[[~ðöÑ£ðãXø 0#±šo3ðg°½è0ˆ"ÿ÷Ç¿-éðH ò F¹¹Ù»$@àÀ³¹³¹#p÷ç*¹#pû÷gú$(à'´ñÿ?F F ц’ù0³Tñk±=÷Ñ à“Wø;±=Ð<÷ѹ7p-ÓÑ´ñÿ?ÑCø|P$àpû÷=ú"$`û÷úàû÷6ú#`û÷†ú$ F½èðˆ-éHëFý÷[ø± ý÷aøKhðÐ ûÞ ú÷üþÞLí@ ú÷ƒ¼-éHëF@¹û÷ú#`û÷^úoðàKF!hKh˜G½èˆä°@ ö@-éðO ò ú÷Ðøˆ°YKF‘h F˜GF%ý÷Fù\L‚F#hÓ»YKXHOôbh!˜GF/ð€NKQIh˜G(ð†€HKh˜GIKKI `h8F˜GDKh˜GDKFI``h8F˜G?Kh˜G@K@I `h8F˜G;Kh˜G a@±:K9I8Fh˜G6Kh˜Gà`3Kh˜GX±¹ñÐ.KHFh˜Gºñ Ð MàºñÐ'K hh˜G Dààh°BÐ#i³BÐ!Kh˜G K‚F ih˜GFºñбÐGP±«“ #ª!¸G±›ðÑXôà`h°BÐKh˜Gh±€GFU± h°BÐ Kh˜GF±(F˜GFK hh˜GF,±šCFIF(F Gà °ú÷0ø½èð °@ì°@è°@$°@¤Ê@,°@dÊ@€Ê@”Ê@XÊ@@Ê@„°@°ù@-éH ò à±Ù±*¹#pû÷!ù$à„’ù0£Tñ ±9÷ÑA¹#pû÷ù"$`û÷aùà$àû÷ù#`û÷Xù$ F½èˆ½ë„ îPO¤hÓ¤EÓ­ë pG_ð ÷ç`´fFoó ¤õ€T%h´BúÑ`¼­ë pG-éðH ò †°FFF6±/±‘ù@4¹ ±#+€ °½èðˆ¨Fù÷ôþ›Óø¨0k¹ ±3x+€ ø0+ìКo3ðgæç0x©þ÷öüౘCo+ÝŸBÛ ±"à"L@h’$h2F !• G(˜ÑCoŸBÓ–ù0‹±@oÓç ±#à#˜ L“@h$h#2F !• G(ÂÑû÷†ø*#`oð¼çþÞ4°@#ÿ÷—¿´-éH ò L hñÑðÆú h°ñÿ?ÑOöÿp àL#“$h«"© G(òнø½è]ø ûþÞð°@Pí@-éðH ò F((ÛKh˜B$ÒNðEŸVø%0ûX³ñÿ?ÑKh+ÑH±(Ð( Ñoð àoð àoð K!Fh˜GVø%0 üPàû÷ ø #`û÷*ø#`ØC½èðˆþÞô°@˜ö@àù@àú@-éxH ò (1Û!Kh˜B-ÒMðDžUø$0òyð!Ðh³ñÿ?ÐKh+ÑX±(Ð( Ñ!oð à!oð à!oð Kh˜GUø$0oð òPàú÷Ôÿ #`ú÷Þÿ#`ØC½èxˆþÞô°@˜ö@àù@àú@-éH ò FñÑú÷Æÿ#`ú÷´ÿ #`!àú÷±þ(Û,ÛKhœB ÒKaðSø!0ë‚yðÐh àú÷¥ÿ#`ú÷“ÿ #`ú÷ãÿoð½èˆþÞàù@àú@´-éH ò oF8aAKðSø!0ë‚£hƒ¹ ú÷ ü£hK¹Oôzañ Kh˜G£h3£`ðø:iQ KðSø!0ë‚ñ Kh˜G ½è]ø ûµ ú÷•ü½°@àù@P°@KAðSø!0ë‚ñ KhGþÞ°@àù@-éðO ò …°oFoð©F=`#û` ú÷wü(ð˜€ú÷"þ(Àò“€ ú÷Hü&ßøFF–ù *]Ð *Ð*p56TàŽB Òù? +Ñ6 #+p5Hà*pûçZø)$h#Xø“«"©6 G ¹ßøX3h˜Gx»›k³Zø)0CDyðHÐù0™ßø8C +×Ð #+pZø)05ëø0Sqà½BÑù0 +Ñ # à˜#“oðoðþ÷Tÿù0 +Ð #+p5»L™›žBžÓàZø)0ëyð@ÑSðqà3x+p5›î+dÑ.bÐø=ð€Ñ5?à¬J!à)ܽBÓ=+x1›V+õÐ(xƒV¹ú÷=û*#$á3‹BÑm&àZø)0ëyðHÐ5)PqÛZø)0ë+x5‚ø%0)ÑZø)0ë+x5‚ø&0mà˜#JB“Óþ÷ëþ ›ŠLí[“›$h:F“+F!OöéP GF.?ôè®®BÐ"à"Zø)0vCDcoð›ŸBÐ8Fù÷¯ÿñðæ€&Fãà›S³ëÖs[ëC§B9F:FÒ¥ˆ(Ð ( ѪB ÒSˆ +Ñ # €21à€12¢BëÓàZø)0ëySðqË[^Äç*±;ˆ +ÑPðà0𺒗B q=F¸F€ðƒ€‘UL ž‘F¸ø *jÐ *Ð*€5ñ`àˆE Ò8ø? +Ññ #+€5Sà*€ûçZø)$h#0X“«" ñ ñ G¹?Kh˜Gл›Ã³Zø)0›yðHнø 0™8L +ØÐ #+€Zø)05òø 0SqZø)0òø 0‚ø%0Zø)0› "ƒø& à½Bѽø 0 +Ñ # à˜#“oðoðþ÷þ½ø 0 +Ð #+€5L™›˜E‘ÓàZø)0òyð@ÑSðqà¸ø0+€5î.çKh˜G(Ñú÷ú #`ú÷%ú#`æm(ô®$ç& àú÷ú#`ú÷ú #`ú÷Wúoð0F °½èðþÞ8°@±@4°@Xí@±@Ȱ@àù@àú@´-éøO ò oFFŠFF¼bñÑú÷ëù#`ú÷Ùù #`Làú÷Öø(HÛ,<Û)KhœB8Òfßø˜€ð Xø&0ë‰yð+ÐoðCBÙú÷Çù#`ú÷µù#&à Fÿ÷*úXø&0ë‰yðÐ*FQF Fÿ÷­ü8` àú÷Ÿù #`ú÷©ù#`ÛC;`ðø8h àú÷Ÿù#`ú÷ù #`ú÷Ýùoð½èø]øûµ¸jÿ÷9ú½àù@àú@-éHëF@¹ú÷tù#`ú÷Äùoðàù0+òÐ)ðÐ h+íГù0+éÐ"ðû½èˆ-éðI ò °FFF€Fü÷­ø`±LH$h GLI$h GF¹oð#àœü÷œø(@F9FÐ#“›2F •“›“# “ “«“› G à#š“›LC“›$h2F“+F G °½èð‰ü°@ÌÊ@,°@ØÊ@±@-éðO ò ‘°F# ““ #“#“ ’ F &ù÷ÿÿ(ÚóC#`ùàð€Ð#Oðà#O𠨓ð^ü(@ðã‚ôO Ñôè/Ñ ›³õOÐoðSêOúƒøðÐ+Ð+ Ðú÷Üø#`ÛC#`ú÷Èø#`ú÷ùâOð@I àðÐôà/öÑOð€IàOðI›+Ð +Ð0+ Ð@+Ѐ+ÙѹñOÑ!à!à!à!ôàc³õ€o‘Ü Ðc±³õ€гõ%гõ@¾Ñ' à' à' à³õ oгõÀoгõào¯Ñ'€#Oð “ô€Ðßø5h›3êð€Ñ#“à'êç€#ð@ÐYô€9Qð‘Oð€jô€_ÐSô€s“ô_ÐZðzð ÐZðjàðÐZð€Zÿ÷ù `°ñÿ? Ñú÷Oø#`ÛC#`ú÷;ø#ià ›" ˜`›šIF“«Íø —ÿ÷ÑþF “°ñÿ?1Ñð@C³ñ@OÑðЛš ˜9ðI“«IFÍø —ÿ÷·þF “°ñÿ?Ñ"hßø$4QSø!0ðë‚y3ðqßø4h˜Gú÷øù÷öÿhëáFßøü3h˜G»"hßøè3QSø!0ðë‚y3ðqßøÄ3h˜GFù÷õÿßø¼3 ˜h˜G,ÙÑù÷Ðÿ #`Ôç(ÑXð@à(ÑXðOúƒø h ™þ÷lÿ#hßøˆãXðYð^ø!0ë‚q#hYð^ø!0Oðë‚’ø$03ð‚ø$0ðH “>Ñð€;Ð B9Ð hoðoð‘þ÷kûF “ @³ñÿ?ˆFÑù÷”ÿhƒ+#Ð hÿ÷(ù†ç h#©"­ø0ÿ÷úX¹½ø0+Ñ h šCFðõú°ñÿ?æÐ h#"“þ÷@ûê³ñÿ?ÛИ!ð€ðÝ€ôè/Ñ ›ôè#ÑUô€EàCôè#³õ€Oгõ€?гõ ?гõ?гõ?гõ€/гõˆ/ÑOðà@ò2ê“BÑOðÍø€àOðùçOðôà/ð¤€#“ð@@ðž€ð@C³ñ€OjгñO0гñ@O@ð’€/ð€/Ù/Ù/@ðˆ€'¸ñpиñ@ð€€OöÿcOðjà h#"‘þ÷ÍúPêéÐ h'#"—þ÷Ãúê³ñÿ?Ñ]ç' h©"ÿ÷åù°ñÿ??ôT¯š(Ð(%ÑmKšBÑ#“Oà’²OöþsšBÑ hÿ÷løù÷Âþ#`&µàOöÿcšB Ñ h#"—þ÷úê³ñÿ??ô+¯#Ýç—àg³/¢Ù/Ø h#"‘þ÷{úPê—Ð#“ h#"þ÷qúê³ñÿ?Ñ çLKOð“« h¨ëùü÷ ÿ°ñÿ??ôý®?¸E«ñÜ#hAOYðWø!0ë‚‘ø$0šS@ð‘ø$0S@ø$0ô€?Ñ à #hYðWø!0ë‚’ø$0ðCêÀ‚ø$0 ›s¹ð Ð#hXðWø 0ë ySð  qð@C³ñ@O3Ñð0ÐK ˜h˜G›š ˜“#“«9ðAÍø ÿ÷Îü°ñÿ?ÑKh˜Gù÷<þ#hYðWø!0ë‚y3ðq hþ÷þæ#hYðšWø!0˜P0F°½èð#"! “ù÷1þþÞ8°@ø°@àù@X°@¤î@-épH ò …°FF FE¹ù÷åý#`ù÷5þoðà,ôЫª1F F•ð#ú°ñÿ?ðЛš)F ðÜûF˜ù÷Œú˜ù÷‰ú F°½èpˆ-éðO ò ‡°F‘F’ˆFFG¹ù÷³ý#`ù÷þoð™à—ù0+òиñïÐØø0+ëГù0+çÐ\!8FðñüF8F/!ðìü»»:!8Fð*ýFî¹8Fø÷wûFà!ù÷öøF-ÑÐIJáþ÷Qü(sÑ:Fá(Fðý(eѮ౰BÙF.!0FoððÀü((F Ð!ð:ý(HÑJFAF(Fÿ÷kÿFAàø÷Eûñ PF!ù÷ÃøFæ³*FQFþ÷ü(OÑ(Fø÷4ûƒ“ù÷Býh˜Oð “&Kªë‘ñ Zø)‰þ÷ü€»!0Fðý8±©ñ ˜™¹ñíÚ àù÷"ý›šAF`0Fÿ÷+ÿF0Fù÷Ûù½BÐ(Fù÷Öù F°½èð#"! “ù÷;ý#"! “ù÷4ý#"! “ù÷-ý#"! “ù÷&ýþÞþÞXî@Ë@-éðH ò ,MDðUø$0±õ€O높ø$0yCó-бõO&бõ€?бõ?бõ€//ÑoðCqUø$0높ø$03ð~SðàoðCqUø$0높ø$03ð}Sðàðq àoðCqUø$0높ø$03ð‚ø$0ð€ÑOô@à¹Oô€@àOô€0½èðˆàù@-éHëF8¹ù÷†ü#`ù÷Öü àKh` ½èˆÄù@-éðO ò …°™F#“’F#"F%Oðþ÷Cøê´ñÿ?‘$Ð#“#"8Fþ÷5øê³ñÿ?кëië#.TÛÜ,LÐIKh˜GIKOô€R!h˜G‚FH¹ù÷=ü #`ù÷9üh°½èðOôA8Fÿ÷DÿF.ÛÜ´õ€_ÓOô€Rà"FQF8Fü÷ïù°ñÿ?Ð$fëàv.ÛèÜd±æçù÷"üh+Ñù÷ü #`oð¨FIF8Fÿ÷ÿ'Kh˜G%KRF!h˜G,à.0ÜÛ,-Ò“KFRF8Fý÷Îÿê³ñÿ?±Ð8Fþ÷(üKh˜G±%àoð_êåxê³ñÿ?Ñù÷Ùû #` Kh˜GFù÷ßû`ê³ñÿ?Ð#š“›8Fý÷ ÿê³ñÿ?ƒÐ „çþÞ8°@ ±@L°@¨°@h°@-éðO ò ø÷ˆúް߸pCFF hF ’ `h"% ‰“—­ø0 zFø2h’’F•@±ø÷|ùCTø](÷Ñ•!(Fø÷õþÈø`¹#;`ù÷|û #`ù÷†û#`oðCá ª¨!ðžû(±(ðAßøè¢'à ¨ø÷Rùñ ˜±ø÷LùDßøÐ¢%.ð‹€0h'4F—@±ø÷>ùÃTø_(÷Ñ—Úø@¤¹û÷XýFÊøt¹ŸØøoð’ø÷üÿ%šœÈøP=`ôà”ù0'[±[² F=+Ðø÷ùÃ_ãWà+õÑãW¸F—=+Ñâ’ù0³±’ù0:+Ñ’ù0=+Ñëø÷ùøëñù0ë=+åÐÍø€š¨ë°Fœ3h” à ¨ø÷âøFØø ©ðúûè±Xø?+ñÑLD! Fø÷Vþ›`ع œ hø÷¡ÿ##`ù÷Ùú #`ù÷ãú#`šoð’à#“ãç›=`Ÿ“›“àÝø$€›Øø@h ¹4à™# FÉþ÷Šù(@ð´€›Sø “ø÷›ø\›hàØø0™ FÉþ÷tù(@ð‚€›hø÷‡ø$ #ø;›Sø/“*æÑÝø€ø\%pØø@þ³Ýø€Úø0 F¨ëÙý÷5ûãë3hÝø€›±ŸØø02h FÙþ÷Aù(VÑ0hø÷Vø\Vø?+ìћù ªIF Fþ÷/ù(RÑ1JIF Fðôù(DÑš2±IF Fðìù±'àšLDàš<±Øø0œBÑ%p4%pš$Úø±ø÷ûþš#Êø0±Fø÷óþ F°ø÷ù½èð#"! “ù÷Vú#"! •ù÷Oú#"! •ù÷Hú#"! •ù÷Aú#"! •ù÷:ú#"! •ù÷3ú#"! •ù÷,úþÞþÞ$Ë@¼î@Ë@-éðO ò Ÿ°FOð Oð “‘F±.Ð Ý.Ý.ÑOð ’ù0’Ó± ! àù÷àù#`ù÷Îù#`ù÷úÃà2’ù0+úÑ’ù0 ±p2’ù0+òѨD"!ø÷üùD#“ù÷´ø(Àòª€`KßøxhŒ±aKXø#0ðë‚“ù0¹<9,ñÑ,Àò€Cò23œB€ðŠ€ë„3˜²!­øjø÷üü(}Ð`šOð!ê,ÝKXø#0ðë‚yðÑph;`à€øà=`107¡BèÛš¹ñÐ!,Ú#Fà#™BÚøëBø[1òçOð ù÷Yù «“«“›)L"“™$h#`˜“’#"Íø  G!KFh˜GF˜ø÷óý¹8Fù÷Gù&à.(Ð~¹K ˜)Fh˜GK ˜ ©h˜GK ˜ h˜Gà.Ñ K ˜h˜G%à K ˜h˜Gàù÷ù #`oð(F°½èð ø÷bûþÞþÞø°@ °@°@8°@°@àù@àú@-épH ò …°FFhFF%÷÷ÿ4¹ù÷Ýø#`ù÷-ù"à˜ƒh+¹1F FðáùFà"xPú‚ó[~Fð Ð4"x*±Bê#žBÑeà-à–BÑ%F*ñåÑø 0#±šo3ðg(F°½èpˆ"ÿ÷¹¿-é?H ò FFhFF÷÷Âþ4¹ù÷—ø#`ù÷çø à˜ƒh»¹)F FðµùFàPú‚ó[~ðÐ4#xs±Cê#BÑ< àBÐ4"x*FéÑ•BÐ$ø 0#±šo3ðg F°½è0ˆ"ÿ÷½¿-éH ò F±±\¹#pù÷Tø#`ù÷¤ø$ F½èˆF’ù0±29ùÑ)¹#pù÷@ø$à”ù0Uñ ±9÷ÑA¹#pù÷0ø"$`ù÷€øÛç$Ùç-éH ò F FK±iFFø÷3ù¹ù÷øhà˜!FðNùF˜ø÷Òü F½èˆ-éðH ò KMFh,h ³<¹Khë±ðzùй,hı¿±8F÷÷áý%hFà(F÷÷Ûý°BÙ«W=+Ñ2F9F(Fðú0±Tø_-íÑ ½èðˆ#h›XùçþÞ˜î@”î@üú@-éüK ò oF‚°F FF ø÷òü=¹ø÷Áÿ#`ù÷ø#.àOð Åø ±Äø.îÐ0Fÿ÷¥ÿ€Fø±÷÷™ýF!0F÷÷œý(`8¹ø÷¢ÿ #`ø÷žÿhàBF1Fý÷lþ8±Íø#"! ø÷Ãÿ±&`#;`ðø8hàxh°½èð‹µ ø÷Çü½-éÿH ò FFF¹ |àhFF÷÷˜ý™‹h+¹:F1F(Fðìùgà±F¹ø÷cÿ#`ø÷³ÿoð@\àø+?Qú‚ó[~ðÐ+x ¹"àCê"‹‰5šBÓˉšBØ ŠàKŠšB Ó‹ŠšB ØËŠ›š²àPC~ðÐø!ø Qú€ó[~ðÐ3x ¹ àCê ‹‰6˜BÓˉ˜BØ ŠàKŠ˜B Ó‹Š˜B ØËŠ˜²àDc~ðДø‚BÑ ±/©Ñ àÙ àoðø 0#±šo3ðg°½èðˆ#ÿ÷s¿-éH ò Fù;+ûÑJ²8 BÐù0“BøÑù0J²“BÐ ½èˆù0;±J²“BÐ0ù0+øÑù0J²“BÐ pG-éH ò ÷÷šýа FX¹ø÷Çþ#`ø÷µþ#`ø÷ÿ %à4ððÑKjF!h˜G@¹Kh˜Gø÷½þø÷Ÿþhà›ðÑð ÐðÐø÷Ÿþ#`ø÷þ #`èç °÷÷ný½èˆ8°@±@-éðO ò …°#“$Kh2hʳ!OOð ê ¸FOð ØRØ^Ør؈ؘبضØÒØâØîØÙÙ*ÙÙ@ED@‘L@íO@ E@5@9@%s %sfailed to create process. failed to get exit code from process. -script.pywCannot open %s #!#!python.exeCannot find Python executable %s Could not exec %smscoree.dllCorExitProcess(null)(null)EEE50P( 8PX700WP `h````xpxxxxSunMonTueWedThuFriSatSundayMondayTuesdayWednesdayThursdayFridaySaturdayJanFebMarAprMayJunJulAugSepOctNovDecJanuaryFebruaryMarchAprilJuneJulyAugustSeptemberOctoberNovemberDecemberAMPMMM/dd/yydddd, MMMM dd, yyyyHH:mm:ssSunMonTueWedThuFriSatSundayMondayTuesdayWednesdayThursdayFridaySaturdayJanFebMarAprMayJunJulAugSepOctNovDecJanuaryFebruaryMarchAprilJuneJulyAugustSeptemberOctoberNovemberDecemberAMPMMM/dd/yydddd, MMMM dd, yyyyHH:mm:ssen-USja-JPzh-CNko-KRzh-TW¶@¶@ ¶@,¶@  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~R6002 - floating point support not loaded R6008 - not enough space for arguments R6009 - not enough space for environment R6010 - abort() has been called R6016 - not enough space for thread data R6017 - unexpected multithread lock error R6018 - unexpected heap error R6019 - unable to open console device R6024 - not enough space for _onexit/atexit table R6025 - pure virtual function call R6026 - not enough space for stdio initialization R6027 - not enough space for lowio initialization R6028 - unable to initialize heap R6030 - CRT not initialized R6031 - Attempt to initialize the CRT more than once. This indicates a bug in your application. R6032 - not enough space for locale information R6033 - Attempt to use MSIL code from this assembly during native code initialization This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. R6034 - inconsistent onexit begin-end variables DOMAIN error SING error TLOSS error runtime error ȶ@(·@ €·@ Ø·@ ¸@x¸@ظ@ ¹@x¹@è¹@8º@¨º@»@d»@¨»@ p¼@!ؼ@"Ⱦ@x0¿@yP¿@zl¿@üˆ¿@ÿ¿@Runtime Error! Program: <program name unknown>... Microsoft Visual C++ Runtime LibraryÀ À–ÀÀŽÀÀÀ‘À’À“À´ÀµÀ  €€†€€†€†‚€EEE………00€P€ˆ('8PW€700PPˆ (€ˆ€€`h`hhhxppwpp ((((( H„„„„„„„„„„‚‚‚‚‚‚ h(((( H„„„„„„„„„„‚‚‚‚‚‚ H€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@abcdefghijklmnopqrstuvwxyz[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ABCDEFGHIJKLMNOPQRSTUVWXYZ{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿÀ÷@ø@USER32.DLLMessageBoxWGetUserObjectInformationWGetLastActivePopupGetActiveWindowGetProcessWindowStationCONOUT$CreateFile2kernel32.dll.cmd.bat.exe.com.\SystemRoot=m!YàjàéèÕÿMñÿÿÿc€;à_àbàÔÿî"Kà–àßàêàè‚èßÿMÙÿÿÿp03Çü¨¾ÿïÿ}*m € àÿýÿÀ àýÿ € àÄÔÿÄ ýÿy03Çü¯øÿïÿ}*í Ç ‚ Çü©þÿ}*Ñ!-"I"/"U03Çü©þÿïÿ}*¯$ë$%‡$û$%= Çü©þÿ}*U%±%»%6 Çü¨ðÿ}*3'O'Y'A°!Çüßÿ}*¯' **'°3èžèüßÿèßÿMÙÿÿÿ:03Çü¨ÿïÿ}* 88)8ç7ÿ738b03Çü¨ÿïÿ}*×8û8 9§8Í89( Çü¨œÿ}*·=Å=Ù=§0DéLèü¨pÿè¨pÿMéÿÿÿG Çü¨¸ÿ}*@_@s@ʰ3èü«ðÿè«ðÿMÝÿÿÿÇ Çü«üÿ}*_CùC'D Çü¨¸ÿ}*'E1E9Eš "ü¨üÿïÿíÿ»°3Çü©ðÿ‰ðïÿ}*I÷I7J  Çü¨ˆÿ}*oJqJqJ' Çü¨¸ÿ}*¹KñKûKñKV Çü¯øÿ}*ÝLoMyM·@àè‚èü¨pÿè¨pÿMéÿÿÿ¬0Uù¼üüèüßÿ÷¼èßÿMÙÿÿÿ\03Çü¯øÿïÿ}*·]é]^\03Çü©øÿïÿ}*{^½^Ý^)03Çü¨¸ÿïÿ}*“_›_«_ lû¨ÿ € àü¯øÿ¯øÿÿ € àü¯øÿ¯øÿÿ€ àìÿýÿO€ Màü¨ðÿ¨ðÿÿe€ càü¨ðÿ¨ðÿÿy€0Cà ü¨ðÿˆðïÿ|°3ÇèüßÿèßÿMÙÿÿÿ 0§àÇèüßÿèßÿMÙÿÿÿb17à]àüÛüÿÛüýÿÛüýÿhA;àcà üÛüûûÿÛüýÿÛüýÿÿh03ÇüßÿÛïÿ}*ít%uQu¼€!àüßÿ´03èüßÿèßÿMÙÿÿÿÀ àýÿ € àì`ÿì`üýÿc€ àü¨ðÿ# "ü¨ÿïÿ503Çü¨ÿïÿ}*e}}}§}®°!Çüßÿ}*O~g~G~/=U03Çü©øÿïÿ}*—€¿€ç€>03Çü¨ÿÿˆðïÿ}*ï‚)‚i03Çü¯øÿïÿ}*鈉C‰€ àüßÿÏ€°àüßÿ»€Aàüßÿ»0…àèüßÿèßÿMÙÿÿÿõ€ïàüßÿM°"Çü«üÿ«ðÿ}*Áœ3C@°3 èü¨ÿè¨ÿMñÿÿÿN€HàüßÿK€kàüßÿP°3Ç èüßÿ èßÿMÙÿÿÿÓÄØ°$Ô@ÔRÔjÔ€Ô–Ô¬ÔÄÔÜÔìÔüÔÕ$Õ6ÕLÕ\ÕjÕ|Մ՜ըÕÐÕâÕðÕÖÖ$Ö0ÖFÖVÖbÖnÖx֊ֲ֜ÖÐÖÜÖæÖôÖ××$×6×P×f×€×š×´×Æ×Ô׿×ö× ØØ.Ø>ØRØ^Ør؈ؘبضØÒØâØîØÙÙ*Ù¼GenerateConsoleCtrlEventëCreateProcessAÏSetConsoleCtrlHandlerCGetExitCodeProcess¹WaitForSingleObjectyGetModuleFileNameA?EnterCriticalSection³LeaveCriticalSectionDecodePointer;EncodePointer}GetModuleHandleExW²GetProcAddress,AreFileApisANSIáMultiByteToWideChargGetLastErrorlExitProcessáGetCommandLineA]SleepDeleteCriticalSectionMHeapFreebInitializeCriticalSectionAndSpinCountÔGetStartupInfoWUGetFileTypeÚGetStdHandle]InitOnceExecuteOnce¹RtlUnwindExIHeapAlloc'GetCurrentThreadIdSetLastErrorÌGetCPInfoGetOEMCP½GetACPƒIsValidCodePage¸LoadLibraryExWGetCurrentPackageIdOSetUnhandledExceptionFilter§FlsAlloc¨FlsFree©FlsGetValueªFlsSetValuezGetModuleFileNameWïWriteFile·GetProcessHeap>GetEnvironmentStringsWÛWideCharToMultiByte¶FreeEnvironmentStringsW1QueryPerformanceCounterñGetSystemTimeAsFileTimeGetTickCount64PHeapReAllocGetConsoleModeõGetConsoleCP¬FlushFileBuffersßGetStringTypeW¥CompareStringEx¦LCMapStringEx SetFilePointerExRHeapSizeyIsDebuggerPresent OutputDebugStringWîWriteConsoleW.SetStdHandleŽCloseHandleÖCreateFileWKERNEL32.dllKReadConsoleWMReadFile~GetModuleHandleWöSetEndOfFileIGetFileAttributesExWùSetEnvironmentVariableA û@ û@ÿÿÿÿ€         ! 5A CPR S WY l m pr € ‚ ƒ„ ‘)ž ¡¤ § ·Î×  4²@<²@ÿÿÿÿþÿÿÿC¬²@°²@´²@¸²@¼²@À²@IJ@Ȳ@в@ز@à²@ì²@ø²@³@ ³@³@³@³@³@ ³@$³@(³@,³@0³@4³@8³@<³@D³@P³@X³@³@`³@h³@p³@x³@„³@Œ³@˜³@¤³@¨³@¬³@¸³@̳@س@à³@è³@ð³@ø³@´@´@´@ ´@0´@@´@T´@h´@x´@Œ´@”´@œ´@¤´@¬´@´´@¼´@Ä´@Ì´@Ô´@Ü´@ä´@ì´@ü´@µ@µ@¬´@(µ@4µ@@µ@Pµ@dµ@tµ@ˆµ@œµ@¤µ@¬µ@Àµ@èµ@üµ@`å@`å@`å@`å@`å@ðì@0Ã@¸Ç@8É@hå@Ðæ@ˆè@¤`‚y‚!¦ß¡¥Ÿàü@~€ü¨Á£Ú£ þ@þµÁ£Ú£ þAþ¶Ï¢ä¢å¢è¢[þ@~¡þQQÚ^Ú _ÚjÚ2ÓØÞàù1~þ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ4Å@Næ@»±¿Dÿÿÿÿx@x@x@x@x@x@x@x@x@x@..èì@¸÷@¸÷@¸÷@¸÷@¸÷@¸÷@¸÷@¸÷@¸÷@ìì@¼÷@¼÷@¼÷@¼÷@¼÷@¼÷@¼÷@ðì@0Ã@2Å@þÿÿÿôÊ@üÊ@Ë@ Ë@aýñaý…aý 8ËéM`ýXËÙpËÙ©`19Q`0ýiy`0ý­Y`0ý1˜Ë`5]`0ýei`0ý™í`1Áp…õ€1ÀËÌË5ØËMI`?qåc¶ýe³µA`°ýAUa2ýí]`0ý=q`0ýyIa´ý)1`0ýEå`1ÕèËÇ `%!A`0ýE!ÌI"`m"%`?"`6ýÙ"•`5-#•`5#‰`5Í#¹`2ý)$}`0ýi$8Ì%`%%`A%pÌ»%`Ñ%a`0ý &a`3I&©`5¥&Y`1í&˜ÌY'`y'9`?'ÀÌ*`M*I`0ý}*ñö,…`0ýI,-`?e,-`?,E`0ýµ,i`uýñ,5`ý -A`?-- a3½-]`0ýí-‘`0ý5.Ù`6ý¥.èÌ 7é`4ý7I`0ýµ7Í)8`38`I88Í 9`9`19Å`2ý¥9½`1:9`0ý-: b2ý9;b2ýI<Ýa4ýE=}`1‰=pÍÙ=`)>Å`0ý‘>˜Íå?¸Ís@`…@Åpõ@àÍ™BøÍ'D`EDA`0ýiDIò E Î9E`MEHÎFTÎÉF)`°ýÝF©r=G5`0ýYGÝa3UHQ`0ýÁH`Î7J`]JˆÎyJ-`?JM¿Kq`0ýqKu`1­K°ÎLA`2ý9LI`1eLI`1‘La`0ýÍLØÎyM`‘M1`?©MU`0ýÙMÏqOa`?íO%`?Pm`?MP9`?qP5tQUc6ýÅR5r}SauýMT¡`1©TÙa3¹UÝ1IV½`3©V=a6ýYWý`5åW ÏY]@Ï^`%^hÏÝ^`ù^½`3Y_Ï«_`µ_¸ÏÕ_ÄÏé_ÔÏý_äÏ `½`0ý]côÏýcÐÉdqpeup=eÐ9f)`°ýmfaa1!g`1uge0ýj0ÐkrIkHÐimò¹ndÐup|ÐEq9a3áqÕ`0ýMr­`0ý¹rMðårMð­s˜Ðµs‘`1tå€rt ÐQu`PýeuÈÐÝvÙñýQw9a3íwQ`?!xY`?UxØÐñy±`0ýIzðÐezüÐzÑU{ Ñ¥{í`3-| a2ýÅ|Ý`0ý=}0ѧ}`á}XÑ=`G`ee`0ý™1a2ý=€Ñç€`ù€]pa™r­¸Ñ)‚a]‚å öqˆàÑC‰`U‰}`?•‰t)ŠÒi½rÉÒq’ya31“I`?Y“(Òå”8Òi˜XÒqš r›ñý‰›Ý`0ýù›u`0ý5œÍ`3©œhÒC`PýM)óýiže`0ýÁžÒIŸ¨ÒíŸ1t u`1É  óýQ¡¡`0ý¥¡¸ÒM¤=3í¤ÈÒ•§•rá§¥1µ¨`²ý|¶qÜqìrør0s8sPstsˆsšs¦s¼säs$tXt¤t¸tît€u´uÀuÔ5,60646`6d6¤6¨6Ø67 7,78 8999|9€9zz> >$>(>t>? ?$?@?¸?¼?À?Ä?È?Ì?Ð? Ô0Ø0Ü0à0ä0è0ì0ð0ô0ø0X2\2`2d2h2Ð2Ô2$3(3x3|3Ä3È30545Ä5È5Ì5666<6@6D6œ6 6Ð6Ô6ä6è6h7l7p7t7”7˜7(:,:0:4:8:<:@:D:H:p:t:x:ô;ø;D<`<|<¬<è<ì<´=¸=0Pô6ø6ü6777€7„7ˆ7°7<8@8D8 9$9(9,9”9˜9œ9 9:: :4;D<8=<=@=„=ä=è=$>Œ>à?@˜|0€0è0ì0ð0ˆ2Œ22”2044484<4@4d4D5H5€6„6˜6À6Ä6P8|8€8Œ8˜8¨8¸8¼8D:H:L:P:T:X::”:˜:Ä:Ð:Ü:è:ô:;<;@;¸{0<4<\<`<ˆ<Œ<À<Ä<È<€=„=ˆ=Œ=Ô=H?L?P?X?\?`?d?h?l? ?Ph0<0H0h0l0 111`3d3h3l3p3t3x3<4@4D4H4œ4 4¤4(6064686<6D6H7L7P7T7Ø7Ü7à7<=@=D=H=L=P=T=> >è>ì>ð>ô>` h0l00646d6h67p7ø:ü:`=d=phà2 3ü3t4x4|4\5`58L8P8¼9À9Ä9È9Ì9Ð9Ô9Ø9Ü9à9ä9è9ì9H;œ; ;< <$<(<´<¸<¼<À<4=8=°=´=¸=Ø=Ü=P?T?X?\?`?€@004080ð0ô0(1,101L1P1TqX2P8T8X8\8`8d8h8l8L9P9::: :$:HP0T0X0`0d0h2l2,3T3Ð4Ô4Ø4Ü4à4\8`8d8T:X:\:`:d:h:l:œ< <¤<@?D?ä?è?  1<4@4D4H4Œ77°4(1,10141@1D1H186<6@6D6´?¼?Ä?Ì?Ô?Ü?ä?ì?ô?ü?À(0 000$0,040<0D0L0T0\0d08:<:à 00P5T5h5l5p5t5x5|5€5„5ˆ5Œ55”5˜5œ5 5¤5¨5¬5°5´5¸5¼5À5Ä5È5Ì5Ð5Ô5Ø5Ü5à5ä5è5ì5ð5ô5ø5ü5666 666 6$6(6,6064686<6@6D6H6L6P6T6X6\6`6d6h6l6p6t6x6|6€6„6ˆ6Œ66”6˜6œ6 6¤6¨6¬6°6´6¸6¼6À6Ä6È6ô677$747T7`7d7h7l7ˆ7”7°<À<Ä<È<Ì<Ð<Ô<Ø<Ü<à<ä<ð<ô<ø<ü<=== === =$=(=,=0=4=8=<=@=D=H=X>\>`>d>setuptools-20.7.0/setuptools/gui.exe0000664000175000017500000020000012702524020020357 0ustar travistravis00000000000000MZÿÿ¸@躴 Í!¸LÍ!This program cannot be run in DOS mode. $äSÀØ 2®‹ 2®‹ 2®‹‡ôÕ‹£2®‹ 2¯‹û2®‹}8‹¤2®‹¾`*‹„2®‹¾`;‹²2®‹¾`-‹Ñ2®‹¾`?‹¡2®‹Rich 2®‹PEL±‹Qà  ÊN&à@@€4ù(ˆô@à@.textíÉÊ `.rdatah à"Î@@.dataÄ+ð@ÀQ‹D$PŠ@„ÉuùSUV+ÂW‹èD-jPèx ƒÄ3ÿ3Û‰D$Æ"p…í~W뛋L$Š <\uGë <"u…ÿ~Wj\Vè ƒÄ ÷3ÿÆ\Fë3ÿ‹T$ŠˆCF;Ý|Ã…ÿ~Wj\VèV ƒÄ ÷‹D$_Æ"ÆF^][YÃì ¡€A3ĉ„$V‹´$W‹¼$Š‹Ï„Àtd$A9](u>‹u3À@8tHF;Ãwö€>:u5;Ëtƒ}‚õjÿujÿQèU&ƒÄF‰uë9](uÂÇEøéÎ;Ëtˆ‹u3ÿ‰]ü8tU¾Pè&Y…ÀtFëŠYƒeü3ÛC98 A„ʼn4 AŠE¢0 Aƒ} …ÿ5¬+Aè0,Y‹ø‰}Ø…ÿtxÿ5¨+Aè,Y‹ð‰u܉}ä‰uàƒî‰uÜ;÷rWè÷+9tí;÷rJÿ6èñ+‹øèá+‰ÿ×ÿ5¬+AèÛ+‹øÿ5¨+AèÎ+ƒÄ 9}äu9Eàt‰}ä‰}؉Eà‹ð‰uÜ‹}ØëŸhpá@¸dá@è_þÿÿYhxá@¸tá@èOþÿÿYÇEüþÿÿÿèƒ}u(‰8 AjèlYÿuèüýÿÿ3ÛCƒ}tjèSYÃèËÿU‹ìjjÿuèÃþÿÿƒÄ ]ËÿU‹ìjjÿuè­þÿÿƒÄ ]ÃjjjèþÿÿƒÄ ÃjjjèŽþÿÿƒÄ ËÿVèó*‹ðVèY;Vèä:VèwVèÉ:Vè´:Vèœ8Vè57Vè7hê#@èE*ƒÄ$£ˆA^ËÿU‹ìƒ=D AuèŒ3ÿuèÙ1hÿè'ýÿÿYY]ÃjXh0õ@èû3ö‰uüE˜Pÿ4à@jþ_‰}ü¸MZf9@u8¡<@¸@PEu'¹ f9ˆ@uƒ¸t@v3É9°è@•Á‰Mäë‰uä3ÛCSèÏ?Y…ÀujèXÿÿÿYè-…ÀujèGÿÿÿYèW4‰]üèø …À}jè&üÿÿYÿ0à@£ +AèQ>£< AèŒ=…À}jèüÿÿYè;…À}j èïûÿÿYSè§üÿÿY;ÆtPèÝûÿÿYè:„]Ät·MÈëj YQPVh@èòÿÿ‰Eà9uäuPèþÿÿèEþÿÿ‰}üë5‹Eì‹‹ ‰MÜPQè·5YYËeè‹E܉Eàƒ}äuPèþÿÿè!þÿÿÇEüþÿÿÿ‹Eàë3À@ËeèÇEüþÿÿÿ¸ÿèÏÃèï>éxþÿÿ‹ÿU‹ìV‹uVèSPèk?YY…Àt|è©òÿÿƒÀ ;ðu3Àëè™òÿÿƒÀ@;ðu`3À@ÿ A÷F uNSW<…H Aƒ?»u Sè Y‰…ÀuFj‰F‰X‰F‰Fë ‹?‰~‰>‰^‰^N 3À_@[ë3À^]ËÿU‹ìƒ}t'V‹u ÷F tVèf ÿîÿÿƒfƒ&ƒfY^]ÃöA @tƒyt$ÿIx ‹ˆÿ¶Àë ¾ÀQPèé-YYƒøÿu ÃÿËÿU‹ìV‹ðë‹MŠEÿM èµÿÿÿƒ>ÿtƒ} ç^]ËÿU‹ìöG @SV‹ð‹Ùt2ƒu,‹Eë+ŠÿM‹Ïè}ÿÿÿCƒ>ÿuèÕƒ8*u‹Ï°?èdÿÿÿƒ}Õ^[]ËÿU‹ììx¡€A3ʼnEüS‹] V‹u3ÀW‹}ÿu¤ýÿÿ‰µ´ýÿÿ‰½Üýÿÿ‰…¸ýÿÿ‰…ðýÿÿ‰…Ìýÿÿ‰…èýÿÿ‰…Ðýÿÿ‰…Àýÿÿ‰…Èýÿÿè÷öÿÿ…öu5èMÇ3ÀPPPPPèӃ½°ýÿÿt ‹…¬ýÿÿƒ`pýƒÈÿéÈ öF @u^Vè@ Yº˜Aƒøÿtƒøþt‹Èƒá‹ðÁþÁá µ *Aë‹ÊöA$u‘ƒøÿtƒøþt‹ÈƒàÁùÁà *Aë‹Âö@$€…gÿÿÿ3É;Ù„]ÿÿÿЉØýÿÿ‰àýÿÿ‰¼ýÿÿˆ•ïýÿÿ„Ò„ Cƒ½Øýÿÿ‰ÄýÿÿŒ ŠÂ, If90t@@;Îuô+…äýÿÿÑøë(;þu ¡A‰…äýÿÿ‹…äýÿÿëI€8t@;Îuõ+…äýÿÿ‰…àýÿÿƒ½Àýÿÿ…\‹…ðýÿÿ¨@t2©t Æ…Ôýÿÿ-ë¨t Æ…Ôýÿÿ+ë ¨tÆ…Ôýÿÿ Ç…Ðýÿÿ‹Ìýÿÿ+àýÿÿ+Ðýÿÿö…ðýÿÿ uÿµ´ýÿÿ…ØýÿÿSj èpõÿÿƒÄ ÿµÐýÿÿ‹½´ýÿÿ…ØýÿÿÔýÿÿèvõÿÿö…ðýÿÿYtö…ðýÿÿuWSj0…Øýÿÿè.õÿÿƒÄ ƒ½Èýÿÿ‹…àýÿÿtf…À~b‹µäýÿÿ‰… ýÿÿ·ÿ ýÿÿPjEôP…˜ýÿÿFPFèå5ƒÄ…Àu(9…˜ýÿÿt ÿµ˜ýÿÿ…ØýÿÿMôèñôÿÿƒ½ ýÿÿYuµëƒØýÿÿÿë‹äýÿÿP…ØýÿÿèÊôÿÿYƒ½Øýÿÿ|ö…ðýÿÿtWSj …Øýÿÿè‚ôÿÿƒÄ ƒ½¼ýÿÿtÿµ¼ýÿÿ胥¼ýÿÿY‹ÄýÿÿŠˆ…ïýÿÿ„Àt‹”ýÿÿ‹½ÜýÿÿŠÐéáõÿÿ€½°ýÿÿt ‹…¬ýÿÿƒ`pý‹…Øýÿÿ‹Mü_^3Í[èÚëÿÿÉÃ+@)@G)@¥)@ñ)@ü)@B*@p+@jThXõ@èe3ÿ‰}üEœPÿ4à@ÇEüþÿÿÿj@j ^VèyYY;Ç„£ *A‰5*Aˆë0Æ@ƒÿÆ@ ‰xÆ@$Æ@% Æ@& ‰x8Æ@4ƒÀ@‹  *AÁ;ÁrÌf9}΄ ‹EÐ;Ç„ÿ‹8X;‰Eä¾;þ|‹þÇEàë[j@j èëYY…ÀtV‹Mà  *A‰ƒ*A ë*Æ@ƒÿÆ@ ƒ`€`$€Æ@% Æ@& ƒ`8Æ@4ƒÀ@‹Ö;ÂrÒÿEà9=*A|ë‹=*Aƒeà…ÿ~m‹E䋃ùÿtVƒùþtQЍtK¨u Qÿ@à@…Àt<‹uà‹ÆÁøƒæÁæ4… *A‹E䋉ŠˆFh F Pè„*YY…À„ÉÿFÿEàCƒEä9}à|“3Û‹óÁæ5 *A‹ƒøÿt ƒøþt€N€ërÆF…ÛujöXë ‹ÃH÷ØÀƒÀõPÿ<à@‹øƒÿÿtC…ÿt?Wÿ@à@…Àt4‰>%ÿƒøu€N@ë ƒøu€Nh F Pèî)YY…Àt7ÿFë €N@ÇþÿÿÿCƒûŒgÿÿÿÿ5*Aÿ8à@3Àë3À@ËeèÇEüþÿÿÿƒÈÿècËÿU‹ì‹EV3ö;Æuè½VVVVVÇèEƒÄƒÈÿë‹@^]ËÿU‹ì‹E£P A]ËÿU‹ìì(¡€A3ʼnEüƒ¥ØüÿÿSjL…ÜüÿÿjPèóäÿÿ…Øüÿÿ‰…(ýÿÿ…0ýÿÿƒÄ ‰…,ýÿÿ‰…àýÿÿ‰Üýÿÿ‰•Øýÿÿ‰Ôýÿÿ‰µÐýÿÿ‰½ÌýÿÿfŒ•øýÿÿfŒìýÿÿfŒÈýÿÿfŒ…ÄýÿÿfŒ¥ÀýÿÿfŒ­¼ýÿÿœ…ðýÿÿ‹EMÇ…0ýÿÿ‰…èýÿÿ‰ôýÿÿ‹Iü‰äýÿÿÇ…ØüÿÿÀÇ…Üüÿÿ‰…äüÿÿÿXà@j‹ØÿTà@…(ýÿÿPÿPà@…Àu …ÛujèM2YhÀÿLà@PÿHà@‹Mü3Í[èüçÿÿÉËÿU‹ìÿ5P Aè*Y…Àt]ÿàjè2Y]é²þÿÿ‹ÿU‹ì‹E3É;ÍØAtAƒù-rñHíƒùwj X]ËÍÜA]ÃDÿÿÿjY;ÈÀ#ÁƒÀ]Ãè …Àu¸@AÃÀÃè…Àu¸DAÃÀ ËÿU‹ìVèâÿÿÿ‹MQ‰è‚ÿÿÿY‹ðè¼ÿÿÿ‰0^]ÃÌÌÌh8@dÿ5‹D$‰l$l$+àSVW¡€A1Eü3ÅP‰eèÿuø‹EüÇEüþÿÿÿ‰EøEðd£Ã‹Mðd‰ Y__^[‹å]QÃÌÌÌÌÌÌÌÌÌÌÌ‹ÿU‹ìƒìS‹] V‹s35€AW‹ÆEÿÇEô{ƒøþt ‹NÏ3 8è©æÿÿ‹N ‹FÏ3 8è™æÿÿ‹Eö@f…‹MUè‰Sü‹[ ‰Eè‰Mìƒûþt_I[‹L†D†‰Eð‹‰Eø…Ét‹×è„1ÆEÿ…À|@G‹Eø‹Øƒøþu΀}ÿt$‹ƒøþt ‹NÏ3 8è&æÿÿ‹N ‹VÏ3 :èæÿÿ‹Eô_^[‹å]ÃÇEôëÉ‹M9csmàu)ƒ=Œ*At hŒ*Aèƒ!ƒÄ…Àt‹UjRÿŒ*AƒÄ‹M è'1‹E 9X th€AW‹Ó‹Èè*1‹E ‹Mø‰H ‹ƒøþt ‹NÏ3 8è“åÿÿ‹N ‹VÏ3 :èƒåÿÿ‹Eð‹H‹×è½0ºþÿÿÿ9S „Rÿÿÿh€AW‹ËèÕ0éÿÿÿ‹ÿU‹ìVW3öÿuè%1‹øY…ÿu'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuÊ‹Ç_^]ËÿU‹ìVW3öjÿu ÿuèE‹øƒÄ …ÿu'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuËÇ_^]ËÿU‹ìVW3öÿu ÿuè[1‹øYY…ÿu,9E t'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿuÁ‹Ç_^]ËÿU‹ìVW3öÿuÿu ÿuè%3‹øƒÄ …ÿu,9Et'9T AvVÿ$à@†è;T AvƒÈÿ‹ðƒøÿu½‹Ç_^]Ãj hxõ@èÓüÿÿ‹u…ötuƒ=„*AuCjèYƒeüVè73Y‰Eä…Àt VPèX3YYÇEüþÿÿÿè ƒ}äu7ÿuë jèYÃVjÿ5t)Aÿ`à@…Àuèüÿÿ‹ðÿ\à@PèÌûÿÿ‰Yè—üÿÿÃjh˜õ@èEüÿÿ3Û‰]äjè–Y‰]üj_‰}à;=À;A}W‹÷Á桼+AÆ9tD‹ö@ ƒtPèÊ=YƒøÿtÿEäƒÿ|(¡¼+A‹ƒÀ PÿDà@¡¼+Aÿ4èýþÿÿY¡¼+A‰GëžÇEüþÿÿÿè ‹EäèüÿÿÃjè7YËÿU‹ìSV‹u‹F ‹È€á3Û€ùu@©t9‹FW‹>+ø…ÿ~,WPVèaùÿÿYPèçDƒÄ ;Çu‹F „Àyƒàý‰F ëƒN ƒËÿ_‹Fƒf‰^‹Ã[]ËÿU‹ìV‹u…öu Vè5Yë/Vè|ÿÿÿY…ÀtƒÈÿë÷F @tVèøøÿÿPè[EY÷ØYÀë3À^]Ãjh¸õ@èöúÿÿ3ÿ‰}ä‰}ÜjèDY‰}ü3ö‰uà;5À;Aƒ¡¼+A°98t^‹ö@ ƒtVPVèÝÿÿYY3ÒB‰Uü¡¼+A‹°‹H öÁƒt/9UuPèJÿÿÿYƒøÿtÿEäë9}uöÁtPè/ÿÿÿYƒøÿu E܉}üèFë„3ÿ‹uࡼ+Aÿ4°Vè"ÝÿÿYYÃÇEüþÿÿÿèƒ}‹Eät‹EÜèwúÿÿÃjè­YÃjèÿÿÿYËÿVW3ö¿X Aƒ<õLAuõHA‰8h ÿ0ƒÇè}!YY…Àt Fƒþ$|Ò3À@_^Ã$õHA3Àëñ‹ÿS‹Dà@V¾HAW‹>…ÿtƒ~t WÿÓWèÐüÿÿƒ&YƒÆþhA|ܾHA_‹…Àt ƒ~uPÿÓƒÆþhA|æ^[ËÿU‹ì‹Eÿ4ÅHAÿà@]Ãj hàõ@èZùÿÿ3ÿG‰}ä3Û9t)Auè´jèhÿèPãÿÿYY‹u4õHA9t‹Çënjè ûÿÿY‹ø;ûuèÁøÿÿÇ 3ÀëQj èYY‰]ü9u,h Wèt YY…ÀuWèþûÿÿYè‹øÿÿÇ ‰]äë ‰>ëWèãûÿÿYÇEüþÿÿÿè ‹EäèòøÿÿÃj è(ÿÿÿYËÿU‹ì‹EV4ÅHAƒ>uPè"ÿÿÿY…ÀujèDâÿÿYÿ6ÿà@^]Ãj hö@èdøÿÿ‹M3ÿ;Ïv.jàX3Ò÷ñ;E À@uèû÷ÿÿÇ WWWWWèƒ÷ÿÿƒÄ3ÀéÕ¯M ‹ñ‰u;÷u3öF3Û‰]äƒþàwiƒ=„*AuKƒÆƒæð‰u ‹E;p*Aw7jèLÿÿÿY‰}üÿuèH6Y‰EäÇEüþÿÿÿè_‹]ä;ßtÿuWSèÛÿÿƒÄ ;ßuaVjÿ5t)Aÿdà@‹Ø;ßuL9=€)At3Vè’Y…À…rÿÿÿ‹E;Ç„PÿÿÿÇ éEÿÿÿ3ÿ‹u jèðýÿÿYÃ;ßu ‹E;ÇtÇ ‹Ãè˜÷ÿÿÃU‹ìƒì‰}ü‹}‹M ÁéfïÀë¤$ffGfG fG0fG@fGPfG`fGp¿€IuЋ}ü‹å]ÃU‹ìƒì‰}ü‹E™‹ø3ú+úƒç3ú+ú…ÿu<‹M‹Ñƒâ‰Uô;Êt+ÊQPèsÿÿÿƒÄ‹E‹Uô…ÒtEE+‰Eø3À‹}ø‹Môóª‹Eë.÷߃lj}ð3À‹}‹Mðóª‹Eð‹M‹UÈ+ÐRjQè~ÿÿÿƒÄ ‹E‹}ü‹å]Ãj h ö@è`öÿÿƒeüf(ÁÇEäë#‹Eì‹‹=Àt =Àt3ÀÃ3À@ËeèƒeäÇEüþÿÿÿ‹EäèböÿÿËÿU‹ìƒì3ÀS‰Eü‰Eô‰EøSœX‹È5 PœZ+ÑtQ3À¢‰Eô‰]è‰Uì‰M𸢉Uü‰Eø[÷Eütè\ÿÿÿ…Àt3À@ë3À[ÉÃè™ÿÿÿ£ˆ*A3ÀËÿU‹ìQSV‹u3ÛW;ót9] w èEõÿÿjYSSSSS‹ñ‰èÌôÿÿƒÄ‹ÆéÍ‹E3ÿ;ÃtŠ:Ãtj_9} †ˆFÆ:F‹M‹Á;Ët@8t<ë‹}ü‹U G‰}ü;úsyŠˆF@8uèPQèì@ŠYYŠˆF@8uð‹E;Ãt'Š:Ët!€ù.tG;} sÆ.Fë G;} sŠˆF@8uðG;} v‹Eˆèhôÿÿj"éÿÿÿˆ3À_^[ÉËÿU‹ìƒìÿuMðèæÛÿÿ¶E ‹MôŠU„Tuƒ}t‹Mð‹‰È·A#Eë3À…Àt3À@€}üt‹MøƒapýÉËÿU‹ìjjÿuÿu è™ÿÿÿƒÄ]ËÿU‹ìjjÿujèÿÿÿƒÄ]ËÿU‹ìjÿuÿuÿu ÿuèå?ƒÄ]ËÿU‹ìì(£°"A‰ ¬"A‰¨"A‰¤"A‰5 "A‰=œ"AfŒÈ"AfŒ ¼"AfŒ˜"AfŒ”"AfŒ%"AfŒ-Œ"AœÀ"A‹E£´"A‹E£¸"AE£Ä"A‹…àüÿÿÇ"A¡¸"A£´!AǨ!A ÀǬ!A¡€A‰…Øüÿÿ¡„A‰…ÜüÿÿÿXà@£ø!Ajè¯$YjÿTà@hÔâ@ÿPà@ƒ=ø!Aujè‹$Yh ÀÿLà@PÿHà@ÉÃ-¤t"ƒètƒè t Ht3ÀøøøøËÿVW‹ðh3ÿFWPèûÕÿÿ3À·È‹Á‰~‰~‰~ Áá Á~«««¹hAƒÄ F+οŠˆ@Ou÷†¾Šˆ@Nu÷_^ËÿU‹ìì¡€A3ʼnEüSW…èúÿÿPÿvÿhà@¿…À„û3Àˆ„üþÿÿ@;ÇrôŠ…îúÿÿÆ…üþÿÿ „Àt.ïúÿÿ¶È¶;Èw+Á@P” üþÿÿj Rè8ÕÿÿƒÄ CŠC„ÀuØjÿv …üúÿÿÿvPW…üþÿÿPjjèyE3ÛSÿv…üýÿÿWPW…üþÿÿPWÿv SèZCƒÄDSÿv…üüÿÿWPW…üþÿÿPhÿv Sè5CƒÄ$3À·ŒEüúÿÿöÁt€LŠŒüýÿÿëöÁt€L ŠŒüüÿÿˆŒëÆ„@;Çr¾ëV†Ç…äúÿÿŸÿÿÿ3É)…äúÿÿ‹•äúÿÿ„ÐZ ƒûw €LŠÑ€Â ëƒúw€L ŠÑ€ê ˆëÆA;Ïr‹Mü_3Í[èØÿÿÉÃj h@ö@èËðÿÿè˜ ‹ø¡ŒA…Gptƒlt‹wh…öuj ènÚÿÿY‹ÆèãðÿÿÃj èó÷ÿÿYƒeü‹wh‰uä;5At6…ötVÿpà@…ÀuþhAtVè‡óÿÿY¡A‰Gh‹5A‰uäVÿlà@ÇEüþÿÿÿè뎋uäj è¸öÿÿYËÿU‹ìƒìS3ÛSMðèt×ÿÿ‰Ì$AƒþþuÇÌ$Aÿxà@8]ütE‹Møƒapýë<ƒþýuÇÌ$Aÿtà@ëÛƒþüu‹Eð‹@ÇÌ$AëÄ8]üt‹Eøƒ`pý‹Æ[ÉËÿU‹ìƒì ¡€A3ʼnEüS‹] V‹uWèdÿÿÿ‹ø3ö‰};þu‹Ãè·üÿÿ3Àé‰uä3À9¸˜A„‘ÿEäƒÀ0=ðrçÿèý„pÿéý„d·ÇPÿ|à@…À„REèPWÿhà@…À„3hCVPèXÒÿÿ3ÒBƒÄ ‰{‰s 9Uè†ø€}î„ÏuɄ¶Fÿ¶Éé¦hCVPèÒÿÿ‹MäƒÄ kÉ0‰u౨A‰uäë*ŠF„Àt(¶>¶Àë‹EàŠ€”AD;¶FG;øvê‹}FF€>uÑ‹uäÿEàƒÆƒ}à‰uäré‹Ç‰{ÇCègûÿÿj‰C C‰œAZf‹1Af‰0A@@Juó‹óè×ûÿÿé·þÿÿ€L@;ÁvöFF€~ÿ…4ÿÿÿC¹þ€@Iuù‹Cèûÿÿ‰C ‰Së‰s3À·È‹ÁÁá Á{«««ë¨95Ì$A…XþÿÿƒÈÿ‹Mü_^3Í[èÕÿÿÉÃjh`ö@èÆíÿÿƒMàÿè‹ø‰}ÜèÜüÿÿ‹_h‹uèuýÿÿ‰E;C„Wh è‚ïÿÿY‹Ø…Û„F¹ˆ‹wh‹ûó¥ƒ#Sÿuè¸ýÿÿYY‰Eà…À…ü‹uÜÿvhÿpà@…Àu‹Fh=hAtPècðÿÿY‰^hS‹=là@ÿ×öFp…êöŒA…Ýj ètôÿÿYƒeü‹C£Ü$A‹C£à$A‹C £ä$A3À‰Eäƒø}f‹LCf‰ EÐ$A@ëè3À‰Eä=} ŠLˆˆˆA@ëé3À‰Eä=}ŠŒˆˆA@ëæÿ5Aÿpà@…Àu¡A=hAtPèªïÿÿY‰ASÿ×ÇEüþÿÿÿèë0j èíòÿÿYÃë%ƒøÿu ûhAtSètïÿÿYèìÿÿÇëƒeà‹Eàè~ìÿÿÃ=°+AujýèVþÿÿYǰ+A3ÀËÿU‹ìSV‹u‹†¼3ÛW;Ãto=HAth‹†°;Ãt^9uZ‹†¸;Ãt9uPèûîÿÿÿ¶¼è›AYY‹†´;Ãt9uPèÚîÿÿÿ¶¼è5AYYÿ¶°èÂîÿÿÿ¶¼è·îÿÿYY‹†À;ÃtD9u@‹†Ä-þPè–îÿÿ‹†Ì¿€+ÇPèƒîÿÿ‹†Ð+ÇPèuîÿÿÿ¶ÀèjîÿÿƒÄ¾Ô‹=ˆAt9˜´uPè?ÿ7èCîÿÿYY~PÇEøAt‹;Ãt 9uPèîÿÿY9_üt‹G;Ãt 9uPèîÿÿYƒÇÿMuÇVèøíÿÿY_^[]ËÿU‹ìSV‹5là@W‹}WÿÖ‹‡°…ÀtPÿÖ‹‡¸…ÀtPÿÖ‹‡´…ÀtPÿÖ‹‡À…ÀtPÿÖ_PÇE{øAt ‹…ÀtPÿÖƒ{üt ‹C…ÀtPÿÖƒÃÿMuÖ‹‡Ô´PÿÖ_^[]ËÿU‹ìW‹}…ÿ„ƒSV‹5pà@WÿÖ‹‡°…ÀtPÿÖ‹‡¸…ÀtPÿÖ‹‡´…ÀtPÿÖ‹‡À…ÀtPÿÖ_PÇE{øAt ‹…ÀtPÿÖƒ{üt ‹C…ÀtPÿÖƒÃÿMuÖ‹‡Ô´PÿÖ^[‹Ç_]Ã…ÿt7…Àt3V‹0;÷t(W‰8èÁþÿÿY…ötVèEÿÿÿƒ>Yuþ˜AtVèYýÿÿY‹Ç^Ã3ÀÃj h€ö@è_éÿÿè,‹ð¡ŒA…Fpt"ƒ~ltè‹pl…öuj èýÒÿÿY‹ÆèréÿÿÃj è‚ðÿÿYƒeüFl‹=pAèiÿÿÿ‰EäÇEüþÿÿÿèëÁj è}ïÿÿY‹uäËÿU‹ìVÿ5„A‹5€à@ÿÖ…Àt!¡€AƒøÿtPÿ5„AÿÖÿÐ…Àt‹€øë'¾tã@Vÿ à@…Àu Vè>ÒÿÿY…Àthdã@Pÿ(à@…ÀtÿuÿЉE‹E^]Ãjè‡ÿÿÿYËÿU‹ìVÿ5„A‹5€à@ÿÖ…Àt!¡€AƒøÿtPÿ5„AÿÖÿÐ…Àt‹€üë'¾tã@Vÿ à@…Àu VèÃÑÿÿY…Àthã@Pÿ(à@…ÀtÿuÿЉE‹E^]Ãÿ„à@‹ÿVÿ5„Aÿ€à@‹ð…öuÿ5%AèeÿÿÿY‹ðVÿ5„Aÿˆà@‹Æ^á€AƒøÿtPÿ5%Aè;ÿÿÿYÿЃ €Aÿ¡„AƒøÿtPÿŒà@ƒ „Aÿéºíÿÿj h ö@è‚çÿÿ¾tã@Vÿ à@…ÀuVèÑÿÿY‰Eä‹uÇF\é@3ÿG‰~…Àt$hdã@P‹(à@ÿÓ‰†øhã@ÿuäÿÓ‰†ü‰~pƆÈCƆKCÇFhhAj ènîÿÿYƒeüÿvhÿlà@ÇEüþÿÿÿè>j èMîÿÿY‰}ü‹E ‰Fl…Àu¡pA‰FlÿvlèüÿÿYÇEüþÿÿÿèèçÿÿÃ3ÿG‹uj è5íÿÿYÃj è,íÿÿYËÿVWÿ\à@ÿ5€A‹øè‘þÿÿÿЋð…öuNhjè±èÿÿ‹ðYY…öt:Vÿ5€Aÿ5%AèèýÿÿYÿÐ…ÀtjVèÅþÿÿYYÿ”à@ƒNÿ‰ë Vè^éÿÿY3öWÿà@_‹Æ^ËÿVèÿÿÿ‹ð…öujèáÏÿÿY‹Æ^ÃjhÈö@èæÿÿ‹u…ö„ø‹F$…ÀtPèéÿÿY‹F,…ÀtPèéÿÿY‹F4…ÀtPèõèÿÿY‹F<…ÀtPèçèÿÿY‹F@…ÀtPèÙèÿÿY‹FD…ÀtPèËèÿÿY‹FH…ÀtPè½èÿÿY‹F\=é@tPè¬èÿÿYj èàìÿÿYƒeü‹~h…ÿtWÿpà@…ÀuÿhAtWèèÿÿYÇEüþÿÿÿèWj è§ìÿÿYÇEü‹~l…ÿt#WèóúÿÿY;=pAtÿ˜At ƒ?uWèÿøÿÿYÇEüþÿÿÿèVè'èÿÿYèEåÿÿ‹uj èvëÿÿYËuj èjëÿÿYËÿVW¾tã@Vÿ à@…ÀuVècÎÿÿY‹ø…ÿ„^‹5(à@hÀã@WÿÖh´ã@W£ %AÿÖh¨ã@W£%AÿÖh ã@W£%AÿÖƒ= %A‹5ˆà@£%Atƒ=%At ƒ=%At…Àu$¡€à@£%A¡Œà@Ç %A”O@‰5%A£%Aÿ„à@£„Aƒøÿ„Ìÿ5%APÿÖ…À„»è•Ðÿÿÿ5 %Aèûÿÿÿ5%A£ %Aèûÿÿÿ5%A£%Aèóúÿÿÿ5%A£%AèãúÿÿƒÄ£%Aè¬éÿÿ…ÀtehˆQ@ÿ5 %Aè=ûÿÿYÿУ€AƒøÿtHhjèÓåÿÿ‹ðYY…öt4Vÿ5€Aÿ5%Aè ûÿÿYÿÐ…ÀtjVèçûÿÿYYÿ”à@ƒNÿ‰3À@ëè’ûÿÿ3À_^ËÿU‹ìƒìSÿuMèè™Êÿÿ‹]C=w‹E苀ȷXëu‰]Á}EèP‹E%ÿPè§YY…ÀtŠEjˆEøˆ]ùÆEúYë 3Ɉ]øÆEùA‹EèjÿpÿpEüPQEøPEèjPè~6ƒÄ …Àu8Eôt‹Eðƒ`pý3Àë·Eü#E €}ôt‹Mðƒapý[ÉËÿU‹ìQV‹u Vèsàÿÿ‰E ‹F Y¨‚uè4âÿÿÇ ƒN ƒÈÿé/¨@t èâÿÿÇ"ëãS3Û¨t‰^¨„‡‹Nƒàþ‰‰F ‹F ƒàïƒÈ‰F ‰^‰]ü© u,èlÃÿÿƒÀ ;ðt è`ÃÿÿƒÀ@;ðu ÿu èY…ÀuVè@Y÷F W„€‹F‹>H‰‹N+øI;û‰N~WPÿu è<+ƒÄ ‰EüëMƒÈ ‰F ƒÈÿëy‹M ƒùÿtƒùþt‹Áƒà‹ÑÁúÁà• *A븘Aö@ tjSSQèŠ>#ƒÄƒøÿt%‹FŠMˆë3ÿGWEPÿu èÍ*ƒÄ ‰Eü9}üt ƒN ƒÈÿë‹E%ÿ_[^ÉËÿU‹ìQQS‹]VW3ö3ÿ‰}ü;ýˆAt G‰}üƒÿrîƒÿƒwjèÚ@Yƒø„4jèÉ@Y…Àu ƒ=ŒA„ûü„Ahpé@»S¿ %AWè8ƒÄ …Àt VVVVVèÔÞÿÿƒÄh¾9%AVjÆ=&Aÿà@…Àu&hXé@hûVèN8ƒÄ …Àt3ÀPPPPPèÞÿÿƒÄVèç@YƒøƒÄ ë2jôÿ<à@‹Ø;Þt$ƒûÿtjEøP4ýŒAÿ6è%YPÿ6Sÿ˜à@_^[ÉÃjè^?YƒøtjèQ?Y…Àuƒ=ŒAuhüè)þÿÿhÿèþÿÿYYËÿU‹ìQSVWÿ5¬+AèÊöÿÿÿ5¨+A‹ø‰}üèºöÿÿ‹ðYY;÷‚ƒ‹Þ+ßCƒørwWè5?‹øCY;øsH¸;øs‹ÇÇ;ÇrPÿuüèsáÿÿYY…ÀuG;Çr@Pÿuüè]áÿÿYY…Àt1ÁûP4˜èÕõÿÿY£¬+AÿuèÇõÿÿ‰ƒÆVè¼õÿÿY£¨+A‹EYë3À_^[ÉËÿVjj èÇàÿÿ‹ðVè•õÿÿƒÄ £¬+A£¨+A…öujX^Ã&3À^Ãj hðö@èaÞÿÿèÈÿÿƒeüÿuèøþÿÿY‰EäÇEüþÿÿÿè ‹Eäè}ÞÿÿÃèoÈÿÿËÿU‹ìÿuè·ÿÿÿ÷ØÀ÷ØYH]ËÿV¸àô@¾àô@W‹ø;Æs‹…ÀtÿЃÇ;þrñ_^ËÿV¸èô@¾èô@W‹ø;Æs‹…ÀtÿЃÇ;þrñ_^ËÿVW3ÿ·@Aÿ6èÆôÿÿƒÇY‰ƒÿ(rè_^ÃÌ‹ÿU‹ì‹M¸MZf9t3À]ËA<Á8PEuï3Ò¹ f9H”‹Â]ÃÌÌÌÌÌÌÌÌÌÌÌ‹ÿU‹ì‹E‹H<È·ASV·q3ÒWD…öv‹} ‹H ;ùr ‹XÙ;ûr BƒÀ(;Örè3À_^[]ÃÌÌÌÌÌÌÌÌÌÌÌÌ‹ÿU‹ìjþh÷@h8@d¡PƒìSVW¡€A1Eø3ÅPEðd£‰eèÇEüh@è*ÿÿÿƒÄ…ÀtU‹E-@Ph@èPÿÿÿƒÄ…Àt;‹@$Áè÷ЃàÇEüþÿÿÿ‹Mðd‰ Y_^[‹å]ËEì‹‹3Ò=À”‹ÂËeèÇEüþÿÿÿ3À‹Mðd‰ Y_^[‹å]Ãjh0÷@èSÜÿÿè öÿÿ‹@x…ÀtƒeüÿÐë3À@ËeèÇEüþÿÿÿè÷<èlÜÿÿÃh=[@è'óÿÿY£4(AÃËÿU‹ìQQVè`õÿÿ‹ð…ö„F‹V\¡tAW‹}‹ÊS99t‹ØkÛ ƒÁ Ú;ËrîkÀ Â;Ès99u‹Áë3À…Àt ‹X‰]ü…Ûu3Àéûƒûu ƒ`3À@éêƒû„Þ‹N`‰Mø‹M ‰N`‹Hƒù…¸‹ hA‹=lA‹Ñù;×}$kÉ ‹~\ƒd9‹=hA‹lAB߃Á ;Ó|â‹]ü‹‹~d=ŽÀu ÇFdƒë^=Àu ÇFdëN=‘Àu ÇFd„ë>=“Àu ÇFd…ë.=Àu ÇFd‚ë=Àu ÇFd†ë=’ÀuÇFdŠÿvdjÿÓY‰~dëƒ`QÿÓ‹EøY‰F`ƒÈÿ[_^ÉËÿU‹ì‹E£8(A£<(A£@(A£D(A]ËÿU‹ì‹E‹ tAV9Pt‹ñkö uƒÀ ;ÆrìkÉ M^;Ás9Pt3À]Ãÿ5@(AèÚñÿÿYÃj hP÷@èFÚÿÿ3ÿ‰}ä‰}Ø‹]ƒû Lt‹ÃjY+Át"+Át+Átd+ÁuDèsóÿÿ‹ø‰}Ø…ÿuƒÈÿéa¾8(A¡8(Aë`ÿw\‹Óè]ÿÿÿ‹ðƒÆ‹ëZ‹Ãƒèt<ƒèt+HtèŠÙÿÿÇ3ÀPPPPPèÙÿÿƒÄ뮾@(A¡@(Aë¾<(A¡<(Aë ¾D(A¡D(AÇEäPèñÿÿ‰EàY3Àƒ}à„Ø9EàujèÂÅÿÿ9EätPèÆàÿÿY3À‰Eüƒût ƒû tƒûu‹O`‰MÔ‰G`ƒûu@‹Od‰MÐÇGdŒƒûu.‹ hA‰MÜ‹ lA‹hAÊ9MÜ}‹MÜkÉ ‹W\‰DÿEÜëÛè~ðÿÿ‰ÇEüþÿÿÿèƒûuÿwdSÿUàYë‹]‹}؃}ätjèTßÿÿYÃSÿUàYƒût ƒû tƒûu‹EÔ‰G`ƒûu‹EЉGd3ÀèèØÿÿËÿU‹ì‹E£L(A]ËÿU‹ì‹E£X(A]ËÿU‹ì‹E£\(A]Ãjhp÷@èiØÿÿƒeüÿu ÿuÿ à@‰Eäë/‹Eì‹‹‰Eà3É=À”Á‹ÁËeè}àÀujÿà@ƒeäÇEüþÿÿÿ‹Eäè[ØÿÿËÿU‹ì‹E£`(A]ËÿU‹ìÿ5`(Aè|ïÿÿY…ÀtÿuÿÐY…Àt3À@]Ã3À]ËÿU‹ì‹E‹8csmàu*ƒxu$‹@= “t=!“t="“t=@™uèCûÿÿ3À]Âh¾_@ÿTà@3ÀËÿVW3ÿ9=°+AuèCëÿÿ‹5 +A…öu¾bã@Š< w„Àt.…ÿt$<"u 3É…ÿ”Á‹ù¶ÀPèãÿÿY…ÀtFFëÓ< wFŠ„Àuõ_‹Æ^Ã=°+AuèéêÿÿV‹5< AW3ÿ…öuƒÈÿé <=tGVè„YtŠ„ÀuêjGWè!Ùÿÿ‹øYY‰= A…ÿtË‹5< ASëBVèS‹ØC€>=Yt1jSèóØÿÿYY‰…ÀtNVSPè}.ƒÄ …Àt3ÀPPPPPè¿ÔÿÿƒÄƒÇó€>u¹ÿ5< Aè¤Ùÿÿƒ%< Aƒ'Ǥ+A3ÀY[_^Ãÿ5 Aè~Ùÿÿƒ% AƒÈÿëä‹ÿU‹ìQ‹MS3ÀV‰‹ò‹U Ç9Et ‹]ƒE‰‰Eü€>"u3À9Eü³"”ÀF‰Eüë<ÿ…ÒtŠˆB‰U жÃPFè¿áÿÿY…Àtÿƒ} t ‹M ŠÿE ˆF‹U ‹M„Ût2ƒ}üu©€û t€û uŸ…ÒtÆBÿƒeü€>„éŠ< t< uFëóNëã€>„Ѓ}t ‹EƒE‰ÿ3ÛC3ÉëFA€>\tù€>"u&öÁuƒ}üt F€8"u‹ðë 3À3Û9Eü”À‰EüÑé…ÉtI…ÒtÆ\Bÿ…Éuñ‰U Š„ÀtUƒ}üu< tK< tG…Ût=¾ÀP…Òt#èÚàÿÿY…Àt Š‹M ÿE ˆFÿ‹M ŠÿE ˆë è·àÿÿY…ÀtFÿÿ‹U FéVÿÿÿ…ÒtÆB‰U ÿ‹Méÿÿÿ‹E^[…Àtƒ ÿÉËÿU‹ìƒì S3ÛVW9°+Auèeèÿÿh¾h(AVSˆl)Aÿà@¡ +A‰5( A;Ãt‰Eü8u‰uü‹UüEøPSS}ôè þÿÿ‹EøƒÄ =ÿÿÿ?sJ‹MôƒùÿsB‹øÁç;Ár6Pè$Öÿÿ‹ðY;ót)‹UüEøPþWV}ôèÉýÿÿ‹EøƒÄ H£ A‰5 A3ÀëƒÈÿ_^[ÉËÿU‹ì¡p)Aƒì SV‹5´à@W3Û3ÿ;Ãu.ÿÖ‹ø;ût Çp)Aë#ÿ\à@ƒøxu jX£p)Aë¡p)Aƒø…;ûuÿÖ‹ø;ûu3ÀéÊ‹Çf9t@@f9uù@@f9uò‹5°à@SSS+ÇSÑø@PWSS‰EôÿÖ‰Eø;Ãt/PèJÕÿÿY‰Eü;Ãt!SSÿuøPÿuôWSSÿÖ…Àu ÿuüèYÖÿÿY‰]ü‹]üWÿ¬à@‹Ãë\ƒøt;Ãu‚ÿ¨à@‹ð;ó„rÿÿÿ8t @8uû@8uö+Æ@P‰EøèãÔÿÿ‹øY;ûu Vÿ¤à@éEÿÿÿÿuøVWèª+ƒÄ Vÿ¤à@‹Ç_^[ÉËÿU‹ì3À9Ej”ÀhPÿ¸à@£t)A…Àu]Ã3À@£„*A]ËÿU‹ìƒì¡€AƒeøƒeüSW¿Næ@»»ÿÿ;Çt …Ãt ÷У„Aë`VEøPÿÌà@‹uü3uøÿÈà@3ðÿ”à@3ðÿÄà@3ðEðPÿÀà@‹Eô3Eð3ð;÷u¾Oæ@»ë …óu‹ÆÁà ð‰5€A÷Ö‰5„A^_[ÉËÿU‹ì‹Eƒøþuè¡ÑÿÿÇ 3À]ÃV3ö;Æ|;*ArèƒÑÿÿVVVVVÇ è ÑÿÿƒÄ3Àë‹ÈƒàÁù‹  *AÁà¾Dƒà@^]á€AƒÈ3É9x)A”Á‹ÁÃÌÌÌÌÌÌÌÌÌ‹L$÷Át$ŠƒÁ„ÀtN÷Áuï¤$¤$‹ºÿþþ~Ѓðÿ3ƒÁ©tè‹Aü„Àt2„ät$©ÿt©ÿtëÍAÿ‹L$+ÁÃAþ‹L$+ÁÃAý‹L$+ÁÃAü‹L$+ÁËÿU‹ìƒìSV‹u 3ÛW‹};óu;ûv‹E;Ãt‰3À郋E;ÃtƒÿÿÿÿÿvècÐÿÿj^SSSSS‰0èìÏÿÿƒÄ‹ÆëVÿuMðèã·ÿÿ‹Eð9X…œf‹E¹ÿf;Áv6;ót;ûv WSV訳ÿÿƒÄ èÐÿÿÇ*èÐÿÿ‹8]üt‹Møƒapý_^[ÉÃ;ót2;ûw,èåÏÿÿj"^SSSSS‰0ènÏÿÿƒÄ8]ü„yÿÿÿ‹Eøƒ`pýémÿÿÿˆ‹E;ÃtÇ8]ü„%ÿÿÿ‹Eøƒ`pýéÿÿÿM QSWVjMQS‰] ÿpÿ°à@;Ãt9] …^ÿÿÿ‹M;Ët½‰ë¹ÿ\à@ƒøz…Dÿÿÿ;ó„gÿÿÿ;û†_ÿÿÿWSVèѲÿÿƒÄ éOÿÿÿ‹ÿU‹ìjÿuÿuÿu ÿuè|þÿÿƒÄ]ËÿU‹ìƒìÿu Mð誶ÿÿ¶E‹Mð‹‰È·A%€€}üt‹MøƒapýÉËÿU‹ìjÿuè¹ÿÿÿYY]ÃÌV‹D$ Àu(‹L$‹D$ 3Ò÷ñ‹Ø‹D$÷ñ‹ð‹Ã÷d$‹È‹Æ÷d$ÑëG‹È‹\$‹T$ ‹D$ÑéÑÛÑêÑØ Éuô÷ó‹ð÷d$‹È‹D$÷æÑr;T$ wr;D$v N+D$T$3Û+D$T$ ÷Ú÷؃ڋʋӋًȋÆ^ƒ%€*AÃÌÌÌSVW‹T$‹D$‹L$URPQQh°i@dÿ5¡€A3ĉD$d‰%‹D$0‹X‹L$,3‹p ƒþþt;‹T$4ƒúþt;òv.4v\³‹ ‰H ƒ{uÌh‹Cè1¹‹Cè1ë°dƒÄ_^[ËL$÷A¸t3‹D$‹H3ÈèµÿÿU‹hÿp ÿpÿpè>ÿÿÿƒÄ ]‹D$‹T$‰¸ÃU‹L$‹)ÿqÿqÿq(èÿÿÿƒÄ ]ÂUVWS‹ê3À3Û3Ò3ö3ÿÿÑ[_^]Ëê‹ñ‹Ájè_03À3Û3É3Ò3ÿÿæU‹ìSVWjjhWj@Qè—Q_^[]ÃU‹l$RQÿt$è´þÿÿƒÄ ]Âj h÷@èÍÿÿƒeä‹u;5p*Aw"jèdÔÿÿYƒeüVèa Y‰EäÇEüþÿÿÿè ‹Eäè)ÍÿÿÃjè_ÓÿÿYËÿU‹ìV‹uƒþà‡¡SW‹=dà@ƒ=t)Auè!íÿÿjèoëÿÿhÿè½¶ÿÿYY¡„*Aƒøu…öt‹Æë3À@Pëƒøu VèSÿÿÿY…Àu…öuFƒÆƒæðVjÿ5t)Aÿ׋؅Ûu.j ^9€)AtÿuèBôÿÿY…Àt‹ué{ÿÿÿèêËÿÿ‰0èãËÿÿ‰0_‹Ã[ëVèôÿÿYèÏËÿÿÇ 3À^]Ãjh°÷@èÌÿÿ‹]…Ûuÿu èÿÿÿYéÌ‹u …öu SèÏÿÿYé·ƒ=„*A…“3ÿ‰}äƒþà‡ŠjèÓÿÿY‰}üSè6Y‰Eà;Ç„ž;5p*AwIVSPèƒÄ …Àt‰]äë5Vèç Y‰Eä;Çt'‹CüH;Ær‹ÆPSÿuäè:$Sèæ‰EàSPè ƒÄ9}äuH;÷u3öF‰u ƒÆƒæð‰u VWÿ5t)Aÿdà@‰Eä;Çt ‹CüH;Ær‹ÆPSÿuäèæ#Sÿuà迃ÄÇEüþÿÿÿè.ƒ}àu1…öuFƒÆƒæð‰u VSjÿ5t)AÿÔà@‹øë‹u ‹]jèHÑÿÿYË}ä…ÿ…¿9=€)At,Vè¤òÿÿY…À…ÒþÿÿèPÊÿÿ9}àul‹ðÿ\à@PèûÉÿÿY‰ë_…ÿ…ƒè+Êÿÿ9}àthÇ ëq…öuFVSjÿ5t)AÿÔà@‹ø…ÿuV9€)At4Vè;òÿÿY…ÀtƒþàvÍVè+òÿÿYèßÉÿÿÇ 3ÀècÊÿÿÃèÌÉÿÿé|ÿÿÿ…ÿuè¾Éÿÿ‹ðÿ\à@PènÉÿÿ‰Y‹ÇëÒ‹ÿU‹ì‹M S3Û;Ëv(jà3ÒX÷ñ;Esè‰ÉÿÿSSSSSÇ èÉÿÿƒÄ3ÀëA¯MVW‹ñ9]t ÿuèÈ)Y‹ØVÿuèýÿÿ‹øYY…ÿt;Þs+óVjßSèȬÿÿƒÄ ‹Ç_^[]ËÿU‹ì‹ h*A¡l*AkÉÈë‹U+P úr ƒÀ;Árë3À]ËÿU‹ìƒì‹M‹AV‹u W‹þ+y ƒÆüÁï‹ÏiÉŒD‰Mð‹I‰MüöÁ…ÓS1‹‰Uô‹Vü‰Uø‹Uô‰] öÂutÁúJƒú?vj?Z‹K;KuB»€ƒú s‹ÊÓëL÷Ó!\¸Dþ u#‹M!ëJàÓëL÷Ó!œ¸Äþ u‹M!Y‹] ‹S‹[‹MüMô‰Z‹U ‹Z‹R‰S‰Mü‹ÑÁúJƒú?vj?Z‹]øƒã‰]ô…+uø‹]øÁûj?‰u K^;Þv‹ÞMø‹ÑÁúJ‰Mü;Öv‹Ö;Út^‹M ‹q;qu;¾€ƒû s‹ËÓî÷Ö!t¸DþLu!‹M!1ëKàÓî÷Ö!´¸ÄþLu‹M!q‹M ‹q‹I‰N‹M ‹q‹I‰N‹u ë‹]ƒ}ôu;Ú„€‹Mð Ñ‹Y‰N‰^‰q‹N‰q‹N;Nu`ŠLˆMþÁˆLƒú s%€}u‹Ê»€Óë‹M »€‹ÊÓëD¸D ë)€}uJເÓë‹M YJ຀Óê„¸Ä ‹Eü‰‰D0ü‹Eðÿ…ó¡|)A…À„Ø‹ |*A‹5¼à@h@ÁáH »€SQÿÖ‹ |*A¡|)Aº€Óê P¡|)A‹@‹ |*Aƒ¤ˆÄ¡|)A‹@þHC¡|)A‹H€yCu ƒ`þ¡|)AƒxÿueSjÿp ÿÖ¡|)Aÿpjÿ5t)Aÿ`à@‹ h*A¡|)AkÉ‹l*A+ÈLìQHQPèí+‹EƒÄ ÿ h*A;|)Avƒm¡l*A£t*A‹E£|)A‰=|*A[_^Éáx*AV‹5h*AW3ÿ;ðu4ƒÀkÀPÿ5l*AWÿ5t)AÿÔà@;Çu3Àëxƒx*A‹5h*A£l*Akö5l*AhÄAjÿ5t)Aÿdà@‰F;ÇtÇjh hWÿØà@‰F ;ÇuÿvWÿ5t)Aÿ`à@뛃Nÿ‰>‰~ÿh*A‹Fƒÿ‹Æ_^ËÿU‹ìQQ‹M‹ASV‹qW3ÛëÀC…À}ù‹ÃiÀ„0Dj?‰EøZ‰@‰@ƒÀJuôj‹ûhÁçy h€WÿØà@…ÀuƒÈÿé—p‰Uü;úwC‹Ê+ÏÁé GAƒHøÿƒˆìÿü‰üïÿÿÇ@üð‰PÇ€èðIuË‹Uü‹EøøO ‰H‰AJ ‰H‰AƒdžD3ÿG‰¼žÄŠFCŠÈþÁ„À‹EˆNCu xº€‹ËÓê÷Ò!P‹Ã_^[ÉËÿU‹ìƒì ‹M‹ASV‹uW‹} ‹×+Q ƒÆÁê‹ÊiÉŒD‰Mô‹OüƒæðI;ñ|9ü‹‰M‰]üŽUöÃ…EÙ;ó;‹MüÁùI‰Møƒù?vj?Y‰Mø‹_;_uC»€ƒù sÓë‹MøL÷Ó!\Dþ u&‹M!ëƒÁàÓë‹MøL÷Ó!œÄþ u‹M!Y‹O‹_‰Y‹O‹‰y‹M+ÎMüƒ}üŽ¥‹}ü‹M ÁÿOL1üƒÿ?vj?_‹]ôû‰]‹[‰Y‹]‰Y‰K‹Y‰K‹Y;YuWŠLˆMþÁˆLƒÿ s€}u‹Ï»€Óë‹M DD‹Ïë €}uOເÓë‹M Y„ÄO຀Óê ‹U ‹MüD2ü‰‰Lüë‹U F‰Bü‰D2øé<3Àé8/‹] )uN‰Kü\3ü‹uÁþN‰] ‰Küƒþ?vj?^öEü…€‹uüÁþNƒþ?vj?^‹O;OuB»€ƒþ s‹ÎÓët÷Ó!\Dþu#‹M!ëNàÓëL÷Ó!œÄþ u‹M!Y‹] ‹O‹w‰q‹w‹O‰q‹uuü‰uÁþNƒþ?vj?^‹Mô ñ‹y‰K‰{‰Y‹K‰Y‹K;KuWŠLˆMþÁˆLƒþ s€}u‹Î¿€Óï‹M 9DD‹Îë €}uNà¿€Óï‹M y„ÄN຀Óê ‹E‰‰Dü3À@_^[ÉËÿU‹ìƒì¡h*A‹MkÀl*AƒÁƒáð‰MðÁùSIƒù VW} ƒÎÿÓîƒMøÿë ƒÁàƒÊÿ3öÓê‰Uø‹ t*A‹Ùë‹S‹;#Uø#þ ×u ƒÃ‰];Ørè;Øu‹l*Aë‹S‹;#Uø#þ ×u ƒÃ‰];Ùrè;Ùu[ë ƒ{u ƒÃ‰];Ørð;Øu1‹l*Aë ƒ{u ƒÃ‰];Ùrð;Ùuè úÿÿ‹Ø‰]…Ûu3Àé Sè:ûÿÿY‹K‰‹Cƒ8ÿtå‰t*A‹C‹‰Uüƒúÿt‹ŒÄ‹|D#Mø#þ Ïu)ƒeü‹ÄHD‹9#Uø#þ ×uÿEü‹‘„ƒÁëç‹Uü‹ÊiÉŒD‰Mô‹LD3ÿ#Îu‹ŒÄ#Møj _ëÉG…É}ù‹Mô‹Tù‹ +Mð‹ñÁþNƒþ?‰Mø~j?^;÷„‹J;Ju\ƒÿ »€}&‹ÏÓë‹Mü|8÷Ó‰]ì#\ˆD‰\ˆDþu3‹Mì‹]! ë,OàÓë‹MüŒˆÄ|8÷Ó!þ‰]ìu ‹]‹Mì!Kë‹]ƒ}ø‹J‹z‰y‹J‹z‰y„‹Mô ñ‹y‰J‰z‰Q‹J‰Q‹J;Ju^ŠLˆM þÁƒþ ˆL}#€} u ¿€‹ÎÓï ;‹Î¿€Óï‹Mü |ˆDë)€} u Nà¿€Óï {‹Mü¼ˆÄNྀÓî 7‹Mø…Ét ‰ ‰Lüë‹Mø‹uðÑN‰ ‰L2ü‹uô‹y‰>…Éu;|)Au‹Mü; |*Auƒ%|)A‹Mü‰B_^[ÉËÿU‹ìSV‹uW3ÿƒËÿ;÷uèQ¾ÿÿWWWWWÇèÙ½ÿÿƒÄ ÃëBöF ƒt7VèÈÂÿÿV‹ØèÄ(VèO¼ÿÿPèë'ƒÄ…À}ƒËÿë‹F;Çt PènÁÿÿY‰~‰~ ‹Ã_^[]Ãj hÐ÷@è3¾ÿÿƒMäÿ3À‹u3ÿ;÷•À;ÇuèνÿÿÇWWWWWèV½ÿÿƒÄƒÈÿë öF @t ‰~ ‹Eäè6¾ÿÿÃVè  ÿÿY‰}üVè*ÿÿÿY‰EäÇEüþÿÿÿèëÕ‹uVèY ÿÿYËÿU‹ì¸äè8*¡€A3ʼnEü‹E V3ö‰…4åÿÿ‰µ8åÿÿ‰µ0åÿÿ9uu3Àéé;Æu'èD½ÿÿ‰0è*½ÿÿVVVVVÇè²¼ÿÿƒÄƒÈÿé¾SW‹}‹ÇÁø4… *A‹ƒçÁçÇŠX$ÛÐû‰µ(åÿÿˆ'åÿÿ€ût€ûu0‹M÷ÑöÁu&èÛ¼ÿÿ3ö‰0迼ÿÿVVVVVÇèG¼ÿÿƒÄéCö@ tjjjÿuècƒÄÿuèÕêÿÿY…À„‹öD€„è‹Öÿÿ‹@l3É9H…åÿÿ”ÁP‹ÿ4‰ åÿÿÿàà@…À„`3É9 åÿÿt„Û„PÿÜà@‹4åÿÿ‰…åÿÿ3À‰…<åÿÿ9E†B‰…DåÿÿŠ…'åÿÿ„À…gŠ ‹µ(åÿÿ3À€ù ”À‰… åÿÿ‹ǃx8tŠP4ˆUôˆMõƒ`8jEôPëK¾ÁPè×ìÿÿY…Àt:‹4åÿÿ+ËM3À@;Ȇ¥j…@åÿÿSPè<(ƒÄ ƒøÿ„±Cÿ…DåÿÿëjS…@åÿÿPè(ƒÄ ƒøÿ„3ÀPPjMôQj@åÿÿQPÿµåÿÿCÿ…Dåÿÿÿ°à@‹ð…ö„\j…<åÿÿPVEôP‹…(åÿÿ‹ÿ4ÿ˜à@…À„)‹…Dåÿÿ‹0åÿÿÁ9µ<åÿÿ‰…8åÿÿŒƒ½ åÿÿ„Íj…<åÿÿPjEôP‹…(åÿÿ‹ÆEô ÿ4ÿ˜à@…À„Ѓ½<åÿÿŒÏÿ…0åÿÿÿ…8åÿÿéƒ<t<u!·33Éfƒþ ”ÁCCƒ…Dåÿÿ‰µ@åÿÿ‰ åÿÿ<t<uRÿµ@åÿÿè%%Yf;…@åÿÿ…hƒ…8åÿÿƒ½ åÿÿt)j XP‰…@åÿÿèø$Yf;…@åÿÿ…;ÿ…8åÿÿÿ…0åÿÿ‹E9…Dåÿÿ‚ùýÿÿé'‹Šÿ…8åÿÿˆT4‹‰D8é3É‹Çö@€„¿‹…4åÿÿ‰@åÿÿ„Û…ʉ…<åÿÿ9M† 답(åÿÿ‹<åÿÿƒ¥Dåÿÿ+4åÿÿ…Håÿÿ;Ms9‹•<åÿÿÿ…<åÿÿŠA€ú uÿ…0åÿÿÆ @ÿ…Dåÿÿˆ@ÿ…Dåÿÿ½Dåÿÿÿr‹؅Håÿÿ+Øj…,åÿÿPS…HåÿÿP‹ÿ4ÿ˜à@…À„B‹…,åÿÿ…8åÿÿ;ÃŒ:‹…<åÿÿ+…4åÿÿ;E‚Lÿÿÿé ‰…Dåÿÿ€û…Ñ9M†M답(åÿÿ‹Dåÿÿƒ¥<åÿÿ+4åÿÿ…Håÿÿ;MsF‹•Dåÿÿƒ…Dåÿÿ·AAfƒú uƒ…0åÿÿj [f‰@@ƒ…<åÿÿƒ…<åÿÿf‰@@½<åÿÿþrµ‹Ø…Håÿÿ+Øj…,åÿÿPS…HåÿÿP‹ÿ4ÿ˜à@…À„b‹…,åÿÿ…8åÿÿ;ÃŒZ‹…Dåÿÿ+…4åÿÿ;E‚?ÿÿÿé@9M†|‹Dåÿÿƒ¥<åÿÿ+4åÿÿj…Hùÿÿ^;Ms<‹•Dåÿÿ·µDåÿÿÎfƒú uj [f‰Æµ<åÿÿµ<åÿÿf‰ƽ<åÿÿ¨r¿3öVVhU ðëÿÿQHùÿÿ+Á™+ÂÑøP‹ÁPVhéýÿ°à@‹Ø;Þ„—j…,åÿÿP‹Ã+ÆP„5ðëÿÿP‹…(åÿÿ‹ÿ4ÿ˜à@…Àt µ,åÿÿ;ÞËë ÿ\à@‰…@åÿÿ;Þ\‹…Dåÿÿ+…4åÿÿ‰…8åÿÿ;E‚ ÿÿÿë?j,åÿÿQÿuÿµ4åÿÿÿ0ÿ˜à@…Àt‹…,åÿÿƒ¥@åÿÿ‰…8åÿÿë ÿ\à@‰…@åÿÿƒ½8åÿÿulƒ½@åÿÿt-j^9µ@åÿÿuè²¶ÿÿÇ èº¶ÿÿ‰0ë?ÿµ@åÿÿè¾¶ÿÿYë1‹µ(åÿÿ‹öD@t‹…4åÿÿ€8u3Àë$èr¶ÿÿÇèz¶ÿÿƒ ƒÈÿë ‹…8åÿÿ+…0åÿÿ_[‹Mü3Í^èØÿÿÉÃjhð÷@è„¶ÿÿ‹Eƒøþuè>¶ÿÿƒ è#¶ÿÿÇ ƒÈÿé3ÿ;Ç|;*Ar!è¶ÿÿ‰8èûµÿÿÇ WWWWW胵ÿÿƒÄëÉ‹ÈÁù *A‹ðƒæÁæ‹ ¾L1ƒát¿Pè9$Y‰}ü‹öD0tÿuÿu ÿuè.øÿÿƒÄ ‰Eäë蘵ÿÿÇ è µÿÿ‰8ƒMäÿÇEüþÿÿÿè ‹Eäè¶ÿÿÃÿuèƒ$YÃjhø@訵ÿÿ‹EƒøþuèOµÿÿÇ ƒÈÿéª3Û;Ã|;*Arè.µÿÿÇ SSSSSè¶´ÿÿƒÄëЋÈÁù< *A‹ðƒæÁ拾LƒátÆPèl#Y‰]ü‹öDt1ÿuèà"YPÿäà@…Àu ÿ\à@‰Eäë‰]ä9]ätèÍ´ÿÿ‹Mä‰è°´ÿÿÇ ƒMäÿÇEüþÿÿÿè ‹Eäè#µÿÿÃÿuè¢#YËÿU‹ìƒìS3Û9]uèr´ÿÿSSSSSÇèú³ÿÿƒÄ3ÀëjV‹u ;óuèN´ÿÿSSSSSÇèÖ³ÿÿƒÄë9ur3Àë>ÿuMðèÆ›ÿÿ‹MôFÿ9YtH9Ew ¶öD uð‹Î+ȃá+ñN‹Æ8]üt‹Møƒapý^[ÉËÿU‹ìjÿu ÿuèUÿÿÿƒÄ ]ËÿU‹ìƒìS3ÛV‹u9]u;óu9] u3Àéç;ót9] w襳ÿÿj^SSSSS‰0è.³ÿÿƒÄ‹ÆéÀ9]uˆëÉW‹};ûuˆèt³ÿÿj^SSSSS‰0èý²ÿÿƒÄé(ÿuMìèóšÿÿ‹Eð9XuÿuWÿu Vè£ ƒÄéLƒ}ÿ‹U ‹ÆuŠˆ@G:ËtJuó늈@G:ËtJtÿMuî9]uˆ@;Ó…È8tƒ}u5xÿ‰}ü;þrEìP‹Eü¶PèоÿÿYY…ÀtÿMü9uüsâ‹Ç+Eü¨…Ã}ÿuZ‹E ƒøv:|þ‰};þr!EìP‹E¶P茾ÿÿYY…ÀtÿM9usâ‹E ‹Ï+MöÁtˆëˆ\ÿ8]øt‹Eôƒ`pýjPXéˆèS²ÿÿj"^SSSSS‰0èܱÿÿƒÄ8]øt‹Eôƒ`pý‹Æëd‹È+΃ù|Mxþ‰};þrEìP‹E¶Pè ¾ÿÿYY…ÀtÿM9usâ‹Ç+E¨tˆèð±ÿÿ‹Èj*X‰8]øt‹Môƒapýë8]øt‹Eôƒ`pý3À_^[ÉËÿU‹ì‹E…Àtƒè8ÝÝuPèµÿÿY]ËÿU‹ìƒì¡€A3ʼnEüSV3ÛW‹ñ9„)Au8SS3ÿGWhdê@hSÿðà@…Àt‰=„)Aëÿ\à@ƒøxu Ç„)A9]~"‹M‹EI8t@;ËuöƒÉÿ‹E+ÁH;E}@‰E¡„)Aƒø„¬;Ĥƒø…̉]ø9] u‹‹@‰E ‹5ìà@3À9]$SSÿu•ÀÿuÅPÿu ÿÖ‹ø;û„~Cjà3ÒX÷÷ƒør7D?=wèŽ#‹Ä;ÃtÇÌÌëPè äÿÿY;Ãt ÇÝ݃À‰Eôë‰]ô9]ô„>Wÿuôÿuÿujÿu ÿÖ…À„ã‹5ðà@SSWÿuôÿu ÿuÿ֋ȉMø;Ë„Â÷E t)9]„°;M§ÿuÿuWÿuôÿu ÿuÿÖé;Ë~Ejà3ÒX÷ñƒør9D =wèÏ"‹ô;ótjÇÌ̃ÆëPèJãÿÿY;Ãt ÇÝ݃À‹ðë3ö;ótAÿuøVWÿuôÿu ÿuÿðà@…Àt"SS9]uSSëÿuÿuÿuøVSÿu ÿ°à@‰EøVè¸ýÿÿYÿuôè¯ýÿÿ‹EøYéY‰]ô‰]ð9]u‹‹@‰E9] u‹‹@‰E ÿuè Y‰Eìƒøÿu3Àé!;E „ÛSSMQÿuPÿu è> ƒÄ‰Eô;ÃtÔ‹5èà@SSÿuPÿu ÿuÿÖ‰Eø;Ãu3öé·~=ƒøàw8ƒÀ=wè¹!‹ü;ûtÝÇÌ̃ÇëPè4âÿÿY;Ãt ÇÝ݃À‹øë3ÿ;ût´ÿuøSWè0’ÿÿƒÄ ÿuøWÿuÿuôÿu ÿuÿÖ‰Eø;Ãu3öë%ÿuEøÿuPWÿu ÿuìè‹ð‰uðƒÄ÷Þö#uøWèüÿÿYëÿuÿuÿuÿuÿu ÿuÿèà@‹ð9]ôt ÿuô蘱ÿÿY‹Eð;Ãt 9EtPè…±ÿÿY‹Æeà_^[‹Mü3Íè—•ÿÿÉËÿU‹ìƒìÿuMðè‘•ÿÿÿu(Mðÿu$ÿu ÿuÿuÿuÿuÿu è(üÿÿƒÄ €}üt‹MøƒapýÉËÿU‹ìQQ¡€A3ʼnEü¡ˆ)ASV3ÛW‹ù;Ãu:EøP3öFVhdê@Vÿøà@…Àt‰5ˆ)Aë4ÿ\à@ƒøxu jX£ˆ)A롈)Aƒø„Ï;Äǃø…è‰]ø9]u‹‹@‰E‹5ìà@3À9] SSÿu•Àÿu ÅPÿuÿÖ‹ø;û„«~<ÿðÿÿw4D?=wèÒ‹Ä;ÃtÇÌÌëPèPàÿÿY;Ãt ÇÝ݃À‹Ø…Ûti?PjSèNÿÿƒÄ WSÿuÿu jÿuÿÖ…ÀtÿuPSÿuÿøà@‰EøSèÉúÿÿ‹EøYëu3ö9]u‹‹@‰E9]u‹‹@‰EÿuèAYƒøÿu3ÀëG;EtSSMQÿu Pÿuèi‹ðƒÄ;ót܉u ÿuÿuÿu ÿuÿuÿôà@‹ø;ótV膯ÿÿY‹Çeì_^[‹Mü3Í蘓ÿÿÉËÿU‹ìƒìÿuMðè’“ÿÿÿu$Mðÿu ÿuÿuÿuÿuÿu èþÿÿƒÄ€}üt‹MøƒapýÉËÿU‹ìV‹u…ö„ÿvè¯ÿÿÿvè¯ÿÿÿv è¯ÿÿÿvèþ®ÿÿÿvèö®ÿÿÿvèî®ÿÿÿ6èç®ÿÿÿv èß®ÿÿÿv$è×®ÿÿÿv(èÏ®ÿÿÿv,èÇ®ÿÿÿv0è¿®ÿÿÿv4è·®ÿÿÿv诮ÿÿÿv8è§®ÿÿÿv<蟮ÿÿƒÄ@ÿv@è”®ÿÿÿvD茮ÿÿÿvHè„®ÿÿÿvLè|®ÿÿÿvPèt®ÿÿÿvTèl®ÿÿÿvXèd®ÿÿÿv\è\®ÿÿÿv`èT®ÿÿÿvdèL®ÿÿÿvhèD®ÿÿÿvlè<®ÿÿÿvpè4®ÿÿÿvtè,®ÿÿÿvxè$®ÿÿÿv|è®ÿÿƒÄ@ÿ¶€è®ÿÿÿ¶„è®ÿÿÿ¶ˆèø­ÿÿÿ¶Œèí­ÿÿÿ¶èâ­ÿÿÿ¶”è×­ÿÿÿ¶˜èÌ­ÿÿÿ¶œèÁ­ÿÿÿ¶ è¶­ÿÿÿ¶¤è«­ÿÿÿ¶¨è ­ÿÿƒÄ,^]ËÿU‹ìV‹u…öt5‹;HAtPè}­ÿÿY‹F;LAtPèk­ÿÿY‹v;5PAtVèY­ÿÿY^]ËÿU‹ìV‹u…öt~‹F ;TAtPè7­ÿÿY‹F;XAtPè%­ÿÿY‹F;\AtPè­ÿÿY‹F;`AtPè­ÿÿY‹F;dAtPèï¬ÿÿY‹F ;hAtPèݬÿÿY‹v$;5lAtVèˬÿÿY^]ËÿU‹ì‹ES3ÛVW;Ãt‹} ;ûwè=©ÿÿj^‰0SSSSSèÆ¨ÿÿƒÄ‹Æë<‹u;óuˆëÚ‹Ð8tBOuø;ût BF:ËtOuó;ûuˆèö¨ÿÿj"Y‰‹ñëµ3À_^[]ÃÌÌÌÌÌÌU‹ìV3ÀPPPPPPPP‹U IŠ Àt ƒÂ«$ëñ‹uƒÉÿIƒÁŠ Àt ƒÆ£$sî‹ÁƒÄ ^ÉËÿU‹ìSV‹u3ÛW9]u;óu9] u3À_^[]Ã;ót‹} ;ûwèh¨ÿÿj^‰0SSSSSèñ§ÿÿƒÄ‹ÆëÕ9]uˆëÊ‹U;Óuˆëу}ÿ‹ÆuŠ ˆ@B:ËtOuóëŠ ˆ@B:ËtOtÿMuî9]uˆ;ûu‹ƒ}ÿu‹E jPˆ\ÿXéxÿÿÿˆèî§ÿÿj"Y‰‹ñë‚‹ÿU‹ì‹MS3ÛVW;Ët‹} ;ûwèȧÿÿj^‰0SSSSSèQ§ÿÿƒÄ‹Æë0‹u;óuˆëÚ‹ÑŠˆBF:ÃtOuó;ûuˆè§ÿÿj"Y‰‹ñëÁ3À_^[]ÃÌÌÌÌÌÌÌÌÌÌÌÌÌ‹T$‹L$÷Âu<‹:u. Àt&:au% ätÁè:Au Àt:auƒÁƒÂ äuÒ‹ÿ3ÀÃÀÑàƒÀÃ÷ÂtŠƒÂ:uçƒÁ ÀtÜ÷Ât¤f‹ƒÂ:uÎ ÀtÆ:auÅ ät½ƒÁëˆÌÌÌÌÌÌÌÌU‹ìWV‹u ‹M‹}‹Á‹ÑÆ;þv;ø‚¤ùrƒ=ˆ*AtWVƒçƒæ;þ^_u^_]é,÷ÇuÁéƒâƒùr*ó¥ÿ$•ä‘@‹Çºƒér ƒàÈÿ$…ø@ÿ$ô‘@ÿ$x‘@‘@4‘@X‘@#ÑŠˆŠFˆGŠFÁéˆGƒÆƒÇƒùrÌó¥ÿ$•ä‘@I#ÑŠˆŠFÁéˆGƒÆƒÇƒùr¦ó¥ÿ$•ä‘@#ÑŠˆƒÆÁéƒÇƒùrˆó¥ÿ$•ä‘@IÛ‘@È‘@À‘@¸‘@°‘@¨‘@ ‘@˜‘@‹DŽä‰Dä‹DŽè‰Dè‹DŽì‰Dì‹DŽð‰Dð‹DŽô‰Dô‹DŽø‰Dø‹DŽü‰Düðøÿ$•ä‘@‹ÿô‘@ü‘@’@’@‹E^_Éʈ‹E^_ÉʈŠFˆG‹E^_ÉÃIŠˆŠFˆGŠFˆG‹E^_ÉÃt1ü|9ü÷Çu$Áéƒâƒùr ýó¥üÿ$•€“@‹ÿ÷Ùÿ$0“@I‹Çºƒùr ƒà+Èÿ$…„’@ÿ$€“@”’@¸’@à’@ŠF#шGƒîÁéƒïƒùr²ýó¥üÿ$•€“@IŠF#шGŠFÁéˆGƒîƒïƒùrˆýó¥üÿ$•€“@ŠF#шGŠFˆGŠFÁéˆGƒîƒïƒù‚Vÿÿÿýó¥üÿ$•€“@I4“@<“@D“@L“@T“@\“@d“@w“@‹DމD‹DމD‹DމD‹DމD‹DŽ ‰D ‹DމD‹DމDðøÿ$•€“@‹ÿ“@˜“@¨“@¼“@‹E^_ÉÊFˆG‹E^_ÉÃIŠFˆGŠFˆG‹E^_ÉÊFˆGŠFˆGŠFˆG‹E^_ÉÃÌÌÌÌÌÌÌÌÌÌÌU‹ìV3ÀPPPPPPPP‹U IŠ Àt ƒÂ«$ëñ‹u‹ÿŠ Àt ƒÆ£$sñFÿƒÄ ^ÉËÿU‹ìQQ‹E V‹u‰Eø‹EWV‰EüèƒÏÿY;Çuè£ÿÿÇ ‹Ç‹×ëJÿuMüQÿuøPÿá@‰Eø;Çuÿ\à@…Àt Pè÷¢ÿÿYëÏ‹ÆÁø‹… *AƒæÁæD0€ ý‹Eø‹Uü_^ÉÃjh0ø@èë¢ÿÿƒÎÿ‰u܉uà‹Eƒøþu蜢ÿÿƒ è¢ÿÿÇ ‹Æ‹ÖéÐ3ÿ;Ç|;*Ar!èr¢ÿÿ‰8èX¢ÿÿÇ WWWWWèà¡ÿÿƒÄëÈ‹ÈÁù *A‹ðƒæÁæ‹ ¾L1ƒáu&è1¢ÿÿ‰8è¢ÿÿÇ WWWWW蟡ÿÿƒÄƒÊÿ‹Âë[PèpY‰}ü‹öD0tÿuÿuÿu ÿuè©þÿÿƒÄ‰E܉UàëèÉ¡ÿÿÇ èÑ¡ÿÿ‰8ƒMÜÿƒMàÿÇEüþÿÿÿè ‹EÜ‹Uàè.¢ÿÿÃÿuè­YËÿU‹ìÿ Ahè¹£ÿÿY‹M‰A…Àt ƒI ÇAëƒI A‰AÇA‹Aƒa‰]ËÿU‹ìƒìSVWè¹ÿÿƒeüƒ=)A‹Ø…Žhô@ÿœà@‹ø…ÿ„*‹5(à@hôó@WÿÖ…À„PèL¸ÿÿÇ$äó@W£)AÿÖPè7¸ÿÿÇ$Ðó@W£”)AÿÖPè"¸ÿÿÇ$´ó@W£˜)AÿÖPè ¸ÿÿY£ )A…Àthœó@WÿÖPèõ·ÿÿY£œ)A¡œ)A;ÃtO9 )AtGPèS¸ÿÿÿ5 )A‹ðèF¸ÿÿYY‹ø…öt,…ÿt(ÿÖ…ÀtMøQj MìQjPÿ×…ÀtöEôu M ë9¡”)A;Ãt0Pè¸ÿÿY…Àt%ÿЉEü…Àt¡˜)A;ÃtPèæ·ÿÿY…ÀtÿuüÿЉEüÿ5)AèηÿÿY…Àtÿuÿu ÿuÿuüÿÐë3À_^[ÉËÿU‹ì‹MV3ö;Î|ƒù~ ƒùu¡D Aë(¡D A‰ D Aë讟ÿÿVVVVVÇè6ŸÿÿƒÄƒÈÿ^]ÃjhPø@èÕŸÿÿ3À‹]3ÿ;ß•À;ÇuètŸÿÿÇWWWWWèüžÿÿƒÄƒÈÿëSƒ=„*Au8jèõ¦ÿÿY‰}üSèÖÿÿY‰Eà;Çt ‹süƒî ‰uäë‹uäÇEüþÿÿÿè%9}àuSWÿ5t)Aÿá@‹ð‹Æè•ŸÿÿÃ3ÿ‹]‹uäjèÃ¥ÿÿYÃjèÿˆÿÿYËÿU‹ìì(¡€A3ʼnEüöAVtj èÓ½ÿÿYèªÄÿÿ…Àtjè¬ÄÿÿYöA„ʉ…àýÿÿ‰Üýÿÿ‰•Øýÿÿ‰Ôýÿÿ‰µÐýÿÿ‰½ÌýÿÿfŒ•øýÿÿfŒìýÿÿfŒÈýÿÿfŒ…ÄýÿÿfŒ¥ÀýÿÿfŒ­¼ýÿÿœ…ðýÿÿ‹uE‰…ôýÿÿÇ…0ýÿÿ‰µèýÿÿ‹@üjP‰…äýÿÿ…ØüÿÿjPèªÿÿ…ØüÿÿƒÄ ‰…(ýÿÿ…0ýÿÿjÇ…Øüÿÿ@‰µäüÿÿ‰…,ýÿÿÿTà@…(ýÿÿPÿPà@jèmŠÿÿÌÌÌU‹ìSVWUjjh˜™@ÿuèV"]_^[‹å]ËL$÷A¸t2‹D$‹Hü3Èè"…ÿÿU‹h‹P(R‹P$RèƒÄ]‹D$‹T$‰¸ÃSVW‹D$UPjþh ™@dÿ5¡€A3ÄPD$d£‹D$(‹X‹p ƒþÿt:ƒ|$,ÿt;t$,v-4v‹ ³‰L$ ‰H ƒ|³uh‹D³èI‹D³è_ë·‹L$d‰ ƒÄ_^[Ã3Àd‹ y ™@u‹Q ‹R 9Qu¸ÃSQ»”Aë SQ»”A‹L$ ‰K‰C‰k UQPXY]Y[ÂÿÐËÿU‹ìƒìVWÿuMìè%„ÿÿ‹E‹u 3ÿ;Çt‰0;÷u,èmœÿÿWWWWWÇèõ›ÿÿƒÄ€}øt‹Eôƒ`pý3ÀéØ9}t ƒ}|Ƀ}$ËMìSЉ}ü~ƒ¹¬~EìP¶ÃjPè¹ÿÿ‹MìƒÄ 닑ȶ÷Bƒà…ÀtŠGëÇ€û-uƒMë€û+uŠG‹E…ÀŒKƒø„Bƒø$9…Àu*€û0t ÇE ë4зɶÒÁá Ê9M u Hë·Ñ9U t @f¶·Éf;ËuÇ·É9M u8]üt‹Møƒapýë8]üt‹Eøƒ`pý3À^[ÉËÿU‹ìjÿu ÿuè2ÿÿÿƒÄ ]ÃÌÌÌBÿ[ä$d$3ÀŠD$S‹ØÁà‹T$÷ÂtŠ ƒÂ:ËtÏ„ÉtQ÷Âuë ØW‹ÃÁãV Ø‹ ¿ÿþþ~‹Á‹÷3Ëðùƒñÿƒðÿ3Ï3ƃÂáu%tÓ%uæ€uÄ^_[3ÀËBü:Ãt6„Àtï:ãt'„ätçÁè:Ãt„ÀtÜ:ãt„ätÔë–^_Bÿ[ÃBþ^_[ÃBý^_[ÃBü^_[Ãÿ%Ðà@‹ÿU‹ì‹US3Û;ÓuèH{ÿÿSSSSSÇèÐzÿÿƒÄƒÈÿë 8tß‹M ;ËtØ‹;ÃtÒ8tÎSQRèƒÄ []ËÿU‹ìƒì‹UV‹ujþX‰Eì‰Uä;ðuèÿzÿÿƒ èäzÿÿÇ ƒÈÿéˆS3Û;ó|;5*Ar'èÕzÿÿ‰è»zÿÿSSSSSÇ èCzÿÿƒÄƒÈÿéQ‹ÆÁøW<… *A‹ƒæÁæÆŠHöÁuèzÿÿ‰èuzÿÿÇ ëjúÿÿÿwP‰]ð;Ó„öÁ…ÿ9] t7Š@$ÀÐøˆEþ¾ÀHjYtHu‹Â÷Шtƒâþ‰U‹E ‰Eôé‹Â÷Шu!è#zÿÿ‰è zÿÿÇSSSSSè‘yÿÿƒÄë4‹ÂÑè‰M;Ár‰Eÿuè|ÿÿY‰Eô;ÃuèÑyÿÿÇ èÙyÿÿǃÈÿéhjSSÿuè|Öÿÿ‹‰D(‹EôƒÄ‰T,‹ÎöAHttŠI€ù tl9]tgˆ‹@ÿMÇEðÆD 8]þtN‹ŠL%€ù tC9]t>ˆ‹@ÿM€}þÇEðÆD% u$‹ŠL&€ù t9]tˆ‹@ÿMÇEðÆD& SMèQÿuP‹ÿ4ÿ,á@…À„{‹Mè;ËŒp;M‡g‹MðDö€„æ€}þ„;Ët ‹Mô€9 u€ë€ û‹]ô‹EðÉ]‰Eð;؃ЋMŠ<„®< t ˆCA‰Mé‹EðH;ÈsA€8 u AA‰MÆ ëu‰EëmÿEjEèPjEÿP‹ÿ4ÿ,á@…Àu ÿ\à@…ÀuEƒ}èt?‹öDHt€}ÿ t¹Æ ‹ŠMÿˆLë%;]ôu€}ÿ t jjÿjÿÿuèØÔÿÿƒÄ€}ÿ tÆ C‹Eð9E‚Gÿÿÿë‹Dö@u€ëŠˆC‹Ã+Eô€}þ‰Eð…Ð…À„ÈKŠ „ÉxCé†3À@¶Éëƒø;]ôrK¶ @€¹àAt芶ʾ‰àA…Éu è|wÿÿÇ*ëzA;ÈuØë@‹ÎöAHt$CƒøˆQ| Š‹ˆT%Cƒøu Š‹ˆT&C+Øë÷Ø™jRPÿuèþÓÿÿƒÄ‹Eä+]ôÑèPÿu Sÿuôjhéýÿìà@‰Eð…Àu4ÿ\à@Pè!wÿÿYƒMìÿ‹Eô;E tPèUzÿÿY‹Eìƒøþ…‹‹Eð郋Eð‹3É;ÕÁÀ‰Eð‰L0ëÆ;Ët‹Môfƒ9 u€ë€ û‹]ô‹EðÉ]‰Eð;؃ÿ‹E·fƒù„×fƒù tf‰ CC@@‰Eé´‹MðƒÁþ;ÁsHfƒ9 u ƒÀ‰Ej 鎉M鄃EjEèPjEøP‹ÿ4ÿ,á@…Àu ÿ\à@…Àu[ƒ}ètU‹öDHt(fƒ}ø t²j Xf‰‹ŠMøˆL‹ŠMùˆL%‹ÆD& ë*;]ôufƒ}ø t…jjÿjþÿuèšÒÿÿƒÄfƒ}ø tj Xf‰CC‹Eð9E‚ÿÿÿë‹tö@u€ëf‹f‰CC+]ô‰]ðé‘þÿÿÿ\à@j^;ÆuèuuÿÿÇ è}uÿÿ‰0éiþÿÿƒøm…Yþÿÿ‰]ìé\þÿÿ3À_[^ÉÃjhøø@è‹uÿÿ‹EƒøþuèEuÿÿƒ è*uÿÿÇ ƒÈÿé¾3ö;Æ|;*Ar!èuÿÿ‰0èuÿÿÇ VVVVVèŠtÿÿƒÄëÉ‹ÈÁù *A‹øƒçÁç‹ ¾L9ƒát¿¹ÿÿÿ;MÉAuèÎtÿÿ‰0è´tÿÿÇë°PèãÿÿY‰uü‹öD8tÿuÿu ÿuè~ùÿÿƒÄ ‰Eäëè~tÿÿÇ è†tÿÿ‰0ƒMäÿÇEüþÿÿÿè ‹EäèêtÿÿÃÿuèiãÿÿYËÿU‹ìƒì0S3ÛöE€VW‹ð‰]àˆ]þÇEÐ ‰]Ôt ‰]ØÆEÿë ÇE؈]ÿEàPè Y…Àt SSSSSènrÿÿƒÄ‹M¸€…Èu÷Á@u9Eàt€Mÿ€‹Áƒà+úÀ¿€tGHt.Ht&èÓsÿÿ‰ƒÿè¶sÿÿj^SSSSS‰0è?sÿÿƒÄé‰UøëöÁt÷ÁuîÇEø@ë‰}ø‹EjY+Át7+Át*+Át+Átƒè@u¡9}ø”À‰EðëÇEðëÇEðë ÇEðë‰]ð‹Eº#¹;Á¿;t0;Ãt,;Çt=„”=…@ÿÿÿÇEìë/ÇEìë&ÇEìë=t=t`;Â…ÿÿÿÇEì‹EÇEô€…Çt‹  A÷Ñ#M„ÉxÇEô¨@tMôMøƒMð©t }ô¨ tMôëÇEì릨tMôè£áÿÿ‰ƒøÿuèjrÿÿ‰ƒÿèMrÿÿÇ鎋E‹=á@SÿuôÇÿuìEÐPÿuðÿuøÿu ÿ׉Eäƒøÿum‹Mø¸À#È;Èu+öEt%eøÿÿÿSÿuôEÐÿuìPÿuðÿuøÿu ÿ׉Eäƒøÿu4‹6‹ÆÁø‹… *AƒæÁæD0€ þÿ\à@PèÛqÿÿYè¯qÿÿ‹étÿuäÿ@à@;ÃuD‹6‹ÆÁø‹… *AƒæÁæD0€ þÿ\à@‹ðVè˜qÿÿYÿuäÿá@;óu°è_qÿÿÇ ë£ƒøu€Mÿ@ë ƒøu€Mÿÿuäÿ6è4Þÿÿ‹‹ÐƒàÁú‹• *AYÁàYŠMÿ€ÉˆL‹‹ÐƒàÁú‹• *AÁàD$€ €ˆMý€eýHˆMÿ…€öÁ€„±öEtqjƒÏÿWÿ6è£ƒÄ ‰Eè;ÇuèÖpÿÿ8ƒtMÿ6èéÙÿÿéúþÿÿjEüPÿ6ˆ]üè’õÿÿƒÄ …Àu€}üu‹Eè™RPÿ6è ƒÄ ;ÇtÃSSÿ6èFƒÄ ;Çt³öEÿ€„0¿@¹@…}u‹Eà#Çu Më E‹E#Ç;ÁtD=t)=@t"=t)=@t"=t=@uÆEþë‹M¸#È;Èu ÆEþëˆ]þ÷E„µöEÿ@‰]è…¨‹Eø¹À#Á=@„·=€tw;Á…„‹Eì;Æyƒøvƒøv0ƒø…f¾Eþ3ÿH„&H…RÇEèÿþÇEìéjSSÿ6è8ÌÿÿƒÄ ÂtÇSSSÿ6è'Ìÿÿ#ƒÄƒøÿ„ŽþÿÿjEèPÿ6è/ôÿÿƒÄ ƒøÿ„uþÿÿƒøtkƒø…­}èuYÆEþéÜ‹Eì;Æуø†bÿÿÿƒø‡PÿÿÿjSSÿ6è¸ËÿÿƒÄ „CÿÿÿSSSÿ6è£ËÿÿƒÄ#ƒøÿ…‘éþÿÿ‹Eè%ÿÿ=þÿuÿ6èß×ÿÿYè¤nÿÿj^‰0‹Æéd=ÿþuSjÿ6èXƒÄ ƒøÿ„ÀýÿÿÆEþëASSÿ6è=ƒÄ ë™ÇEèÇEì‹Eì+ÇPD=èPÿ6è¸ÿÿƒÄ ƒøÿ„€ýÿÿø9}ìÛ‹‹ÈÁù‹  *AƒàÁàD$Š2Mþ€á0‹‹ÈÁù‹  *AƒàÁàD$‹MŠÁéÀá€â ʈ8]ýu!öEt‹‹ÈƒàÁù‹  *AÁàD€ ‹}ø¸À‹Ï#È;Èu|öEtvÿuäÿá@SÿuôEÐjPÿuðçÿÿÿWÿu ÿá@ƒøÿu4ÿ\à@Pè›mÿÿ‹‹ÈƒàÁù‹  *AÁàD€ þÿ6èÏÚÿÿYé˜ûÿÿ‹6‹ÎÁù‹  *AƒæÁ手Ã_^[ÉÃjhù@èomÿÿƒMäÿ3ö‰uà3À9u•À;Æuè mÿÿÇVVVVVè‘lÿÿƒÄƒÈÿër‰uüÿuj@ÿu ÿuEàPEäè‰øÿÿƒÄ‰EÜÇEüþÿÿÿè‹}Ü;þt<è¹lÿÿ‰8ë¿3ö9uàt+9uÜt‹EäÁø‹MäƒáÁá‹… *AD€ þÿuäèÛÿÿYËEäè mÿÿËÿU‹ìQQV3ö9uuèelÿÿVVVVVÇèíkÿÿƒÄƒÈÿëJ9u tÞÿuEøPEüPÿuÿu è|ƒÄƒøÿtØÿuøÿuüÿujèUÿuü‹ðè}oÿÿÿuøèuoÿÿƒÄ‹Æ^ÉËÿU‹ìƒìSW‹}3Û‰}ü;ûu èåkÿÿSSSSSÇèmkÿÿƒÄƒÈÿéá8tÜ‹E ;ÃtÕ‹;ÃtÏ8tËVj\Wè j/W‹ðè ƒÄ;Ã…;ó…ƒj:Wè=ïÿÿ‹ðYY;óusWèIšÿÿ‹ðƒÆjVèímÿÿ‹øƒÄ ‰}ü;û„­htô@VWèkÃÿÿƒÄ …Àt SSSSSè¯iÿÿƒÄÿuVWèØÁÿÿƒÄ …Àt SSSSSè‘iÿÿƒÄw‹}ë ;ót;Æv‹ðƒMðÿj.Vèh YY…Àt,Sÿuüè YY…À…ìÿuÿu ÿuüè`þÿÿƒÄ ‰EðéÓÿuüè–™ÿÿ‹ðƒÆjVè:mÿÿƒÄ ‰Eø;ÃuƒÈÿé½ÿuüVPè¸ÂÿÿƒÄ …Àt SSSSSèühÿÿƒÄÿuüèQ™ÿÿ‹ø}øYèvjÿÿ‹‰Eì‹Eø+÷ðÇEôìA‹Eôÿ0VWèrÂÿÿƒÄ …Àt SSSSSè¶hÿÿƒÄSÿuøè] YY…Àtƒmô}ôàA}Äëè jÿÿÿu‹Mìÿu ‰ÿuøè”ýÿÿƒÄ ‰Eðÿuøèlmÿÿ‹}Y9}üt ÿuüè[mÿÿY‹Eð^_[ÉËÿU‹ìƒìSVW3ÛjSSÿu‰]ð‰]ôè–Æÿÿ‰Eè#ƒÄ‰UìƒøÿtYjSSÿuèzÆÿÿ‹È#ʃăùÿtA‹u ‹}+ðúˆÆ;󆼻Sjÿ4á@Pÿdà@‰Eü…ÀuèciÿÿÇ èXiÿÿ‹_^[ÉÃh€ÿuèŠYY‰Eø…ÿ| ;ór‹Ãë‹ÆPÿuüÿu謫ÿÿƒÄ ƒøÿt6™+ðúxÓ…öwÏ‹uðÿuøÿuèFYYÿuüjÿ4á@Pÿ`à@3Ûé†èóhÿÿƒ8u èÖhÿÿÇ ƒÎÿ‰uôë½;ûq|;óskSÿuÿu ÿuèÅÿÿ#ƒÄƒøÿ„Dÿÿÿÿuè›ÖÿÿYPÿ0á@÷ØÀ÷ØH™‰Eð#‰Uôƒøÿu)èwhÿÿÇ èhÿÿ‹ðÿ\à@‰‹uð#uôƒþÿ„öþÿÿSÿuìÿuèÿuèÅÿÿ#ƒÄƒøÿ„Ùþÿÿ3ÀéÙþÿÿ‹ÿU‹ìV‹uVè"ÖÿÿYƒøÿuèhÿÿÇ ƒÈÿëMWÿujÿu Pÿá@‹øƒÿÿuÿ\à@ë3À…Àt PèhÿÿYƒÈÿë‹ÆÁø‹… *AƒæÁæD0€ ý‹Ç_^]ËÿU‹ìS‹] V‹u‹ÆÁø… *A‹ƒæÁæ 0ŠA$ÀW¶y¾Àç€Ñøû@tPû€tBût&ûtûu=€I€‹ L1$Š€â€Êˆë'€I€‹ L1$Š€â‚€Êëè€aë €I€‹ L1$€!€…ÿ_^[u¸€]Ã÷ØÀ%À@]ËÿU‹ì‹EV3ö;ÆuèêfÿÿVVVVVÇèrfÿÿƒÄjXë ‹ d*A‰3À^]ËÿU‹ìƒìh‹ES3ÛW‰]ôˆ]ÿ;Ãtƒøt~ƒø~ ƒøu ÆEÿ‹E‰Eðë8èfÿÿ‰èƒfÿÿSSSSSÇè fÿÿƒÄƒÈÿé®@8uûH8tÆ ‹Á8uëVjD^VE˜SPèÔIÿÿ‰u˜‹5*AƒÄ ;ót+Fÿ‹È‹ÐÁù‹  *AƒâÁâ8\uNH;óuà;óŒ@þ23ƒ4‹ÆkÀƒÀf‰EÊ·ÀjPèghÿÿYY‰EÌ;Ä;ó‰0‹EÌH|0‰]ø~9‹Eø‹ÐƒàÁúÁà• *AŠPöÂuˆ‹‰ëˆƒÿÿEøAƒÇ9uø|Ê‹EÌ8]ÿt,H3ÒD0ƒþ}‹þëj_;×} ˆƒÿBAƒÀëäÇEôèjeÿÿ‰EÜPE˜PSÿuÿuôjSSÿuðÿu ÿ à@‹ðÿ\à@ÿuÌ‹øè‘hÿÿY;óu Wè?eÿÿYëXƒ}uSè¤Qÿÿ‹5á@9]ujÿÿuÜÿà@EìPÿuÜÿà@‹]ìëƒ}uÿuÜÿÖë‹]ÜÿuàÿÖ‹ÃëèÄdÿÿÇ ƒÈÿ^_[ÉËÿU‹ìƒì@¡€A3ʼnEü‹M ‹ESVW¾xô@}ð¥¥f¥‰MÔ‹M3Û‰Mà‹M¤j‰EÈ‹ø‹‰Mè‰]܉]ì‰]Ä^ëPè2“ÿÿƒÇt‹Y;ÃuìjV‰uÌèÊfÿÿ‹uàYY‰;Ãu#‹Eè‰è4dÿÿÇ è?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~=EncodePointerKERNEL32.DLLDecodePointerFlsFreeFlsSetValueFlsGetValueFlsAllocruntime error TLOSS error SING error DOMAIN error R6034 An application has made an attempt to load the C runtime library incorrectly. Please contact the application's support team for more information. R6033 - Attempt to use MSIL code from this assembly during native code initialization This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. R6032 - not enough space for locale information R6031 - Attempt to initialize the CRT more than once. This indicates a bug in your application. R6030 - CRT not initialized R6028 - unable to initialize heap R6027 - not enough space for lowio initialization R6026 - not enough space for stdio initialization R6025 - pure virtual function call R6024 - not enough space for _onexit/atexit table R6019 - unable to open console device R6018 - unexpected heap error R6017 - unexpected multithread lock error R6016 - not enough space for thread data This application has requested the Runtime to terminate it in an unusual way. Please contact the application's support team for more information. R6009 - not enough space for environment R6008 - not enough space for arguments R6002 - floating point support not loaded Microsoft Visual C++ Runtime Library ...Runtime Error! Program: À À–ÀÀŽÀÀÀ‘À’À“À€€†€€†€†‚€EEE………00€P€ˆ('8PW€700PPˆ (€ˆ€€`h`hhhxppwpp ((((( H„„„„„„„„„„‚‚‚‚‚‚ h(((( H„„„„„„„„„„‚‚‚‚‚‚ H€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@abcdefghijklmnopqrstuvwxyz[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ABCDEFGHIJKLMNOPQRSTUVWXYZ{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖרÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿHH:mm:ssdddd, MMMM dd, yyyyMM/dd/yyPMAMDecemberNovemberOctoberSeptemberAugustJulyJuneAprilMarchFebruaryJanuaryDecNovOctSepAugJulJunMayAprMarFebJanSaturdayFridayThursdayWednesdayTuesdayMondaySundaySatFriThuWedTueMonSunGetProcessWindowStationGetUserObjectInformationAGetLastActivePopupGetActiveWindowMessageBoxAUSER32.DLLSunMonTueWedThuFriSatJanFebMarAprMayJunJulAugSepOctNovDecCONOUT$.com.exe.bat.cmd.\SystemRootH€AÐô@8°i ™þÿÿÿÔÿÿÿþÿÿÿÜ@þÿÿÿÈÿÿÿþÿÿÿ¼#@þÿÿÿˆÿÿÿþÿÿÿú%@þ%@þÿÿÿÀ%@Ô%@þÿÿÿŒÿÿÿþÿÿÿh5@l5@þÿÿÿÔÿÿÿþÿÿÿ;@þÿÿÿÐÿÿÿþÿÿÿá;@þÿÿÿÌÿÿÿþÿÿÿk=@7=@þÿÿÿÔÿÿÿþÿÿÿð>@þÿÿÿÔÿÿÿþÿÿÿ#@@þÿÿÿÔÿÿÿþÿÿÿMA@iA@þÿÿÿÔÿÿÿþÿÿÿ]G@þÿÿÿÌÿÿÿþÿÿÿ+K@þÿÿÿÔÿÿÿþÿÿÿ›N@þÿÿÿÔÿÿÿþÿÿÿÝP@þÿÿÿìP@þÿÿÿØÿÿÿþÿÿÿŸR@þÿÿÿ«R@þÿÿÿÔÿÿÿþÿÿÿeY@þÿÿÿØÿÿÿþÿÿÿ [@[@þÿÿÿØÿÿÿþÿÿÿ][@a[@þÿÿÿÀÿÿÿþÿÿÿ¸^@þÿÿÿÐÿÿÿþÿÿÿH_@__@þÿÿÿÔÿÿÿþÿÿÿ¹j@þÿÿÿÐÿÿÿþÿÿÿÊl@þÿÿÿÔÿÿÿþÿÿÿÎy@þÿÿÿÐÿÿÿþÿÿÿÞ@þÿÿÿÐÿÿÿþÿÿÿ¿‚@þÿÿÿÌÿÿÿþÿÿÿ´•@þÿÿÿÐÿÿÿþÿÿÿM˜@þÿÿÿÐÿÿÿþÿÿÿä¡@þÿÿÿÔÿÿÿþÿÿÿ[¦@þÿÿÿÈÿÿÿþÿÿÿ!¨@]§@þÿÿÿÐÿÿÿþÿÿÿÜ®@þÿÿÿÐÿÿÿþÿÿÿøÂ@þÿÿÿÌÿÿÿþÿÿÿ›Ê@\ùàœú¸úÎúäúöúû$û<ûTûhûpû‚ûû¢û´ûÆûÖûäûüûü$ü@ü^ürü‚üŽüšü¦ü¾üÖüàüìüþü ýý&ý0ý@ýVýbýrýšý´ýÌýæýüýþ$þ2þLþ\þrþŒþ˜þ¦þ¶þÆþØþìþüþÿ"ÿ4ÿFÿXÿjÿvÿ„ÿ”ÿªÿºÿÊÿØÿêÿüÿ$0@RRGenerateConsoleCtrlEventÆGetExitCodeProcessnWaitForSingleObject•CreateProcessA¯SetConsoleCtrlHandlerõGetModuleFileNameAÚEnterCriticalSectionôLeaveCriticalSectionúGetModuleHandleW+Sleep"GetProcAddressExitProcesspGetCommandLineA<GetStartupInfoAðSetHandleCount>GetStdHandleØGetFileType¿DeleteCriticalSection7TerminateProcessªGetCurrentProcessHUnhandledExceptionFilterSetUnhandledExceptionFilterÖIsDebuggerPresentçGetLastError¦HeapFree¢HeapAlloc\GetCPInfoÅInterlockedIncrementÁInterlockedDecrementSGetACPGetOEMCPàIsValidCodePage>TlsGetValue<TlsAlloc?TlsSetValue=TlsFreeôSetLastError®GetCurrentThreadId—WriteFileöLoadLibraryAºInitializeCriticalSectionAndSpinCountKFreeEnvironmentStringsAÀGetEnvironmentStringsLFreeEnvironmentStringsW„WideCharToMultiByteÂGetEnvironmentStringsW¤HeapCreateaVirtualFreeYQueryPerformanceCounterjGetTickCount«GetCurrentProcessIdSGetSystemTimeAsFileTimešRtlUnwind©HeapReAlloc^VirtualAlloc„GetConsoleCP–GetConsoleModeBFlushFileBuffersæLCMapStringAMultiByteToWideCharèLCMapStringW@GetStringTypeACGetStringTypeWéGetLocaleInfoAçSetFilePointer«HeapSizeDCloseHandleŒWriteConsoleAšGetConsoleOutputCP–WriteConsoleWSetStdHandleyCreateFileASCompareStringAVCompareStringWØSetEnvironmentVariableAKERNEL32.dllnReadFileÕSetEndOfFile&GetProcessHeapÊGetFileAttributesAÀ+AÀ+ANæ@»±¿Dê#@lâ@\â@ÿÿÿÿ€         ! 5A CPR S WY l m pr € ‚ ƒ„ ‘)ž ¡¤ § ·Î×   abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZhA¤`‚y‚!¦ß¡¥Ÿàü@~€ü¨Á£Ú£ þ@þµÁ£Ú£ þAþ¶Ï¢ä¢å¢è¢[þ@~¡þQQÚ^Ú _ÚjÚ2ÓØÞàù1~þlí@þÿÿÿCAAAAAHAhë@ðï@pñ@ˆA˜A˜AhAÿÿÿÿÿÿÿÿøè@Ìè@  è@ è@Üç@¬ç@ˆç@\ç@$ç@üæ@Äæ@Œæ@dæ@Dæ@àå@ ¨å@!°ä@"ä@xä@yðã@zàã@üÜã@ÿÌã@^˜@^˜@^˜@^˜@^˜@^˜@^˜@^˜@^˜@^˜@x hë@jí@˜ó@”ó@ó@Œó@ˆó@„ó@€ó@xó@pó@hó@\ó@Pó@Hó@<ó@8ó@4ó@0ó@,ó@(ó@$ó@ ó@ó@ó@ó@ó@ ó@ó@øò@ðò@èò@(ó@àò@Øò@Ðò@Äò@¼ò@°ò@¤ò@ ò@œò@ò@|ò@pò@ ˆA.DAŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AŒ)AHA. “€pðñÿÿPSTPDTÐAAÿÿÿÿÿÿÿÿþÿÿÿþÿÿÿÿÿÿÿ;Zx—µÔó0Nmÿÿÿÿ:Yw–´Óò/Mllô@dô@\ô@Tô@setuptools-20.7.0/setuptools/launch.py0000664000175000017500000000133212702524020020723 0ustar travistravis00000000000000""" Launch the Python script on the command line after setuptools is bootstrapped via import. """ # Note that setuptools gets imported implicitly by the # invocation of this script using python -m setuptools.launch import tokenize import sys def run(): """ Run the script in sys.argv[1] as if it had been invoked naturally. """ __builtins__ script_name = sys.argv[1] namespace = dict( __file__ = script_name, __name__ = '__main__', __doc__ = None, ) sys.argv[:] = sys.argv[1:] open_ = getattr(tokenize, 'open', open) script = open_(script_name).read() norm_script = script.replace('\\r\\n', '\\n') code = compile(norm_script, script_name, 'exec') exec(code, namespace) if __name__ == '__main__': run() setuptools-20.7.0/setuptools/lib2to3_ex.py0000664000175000017500000000371612702524020021433 0ustar travistravis00000000000000""" Customized Mixin2to3 support: - adds support for converting doctests This module raises an ImportError on Python 2. """ from distutils.util import Mixin2to3 as _Mixin2to3 from distutils import log from lib2to3.refactor import RefactoringTool, get_fixers_from_package import setuptools class DistutilsRefactoringTool(RefactoringTool): def log_error(self, msg, *args, **kw): log.error(msg, *args) def log_message(self, msg, *args): log.info(msg, *args) def log_debug(self, msg, *args): log.debug(msg, *args) class Mixin2to3(_Mixin2to3): def run_2to3(self, files, doctests = False): # See of the distribution option has been set, otherwise check the # setuptools default. if self.distribution.use_2to3 is not True: return if not files: return log.info("Fixing "+" ".join(files)) self.__build_fixer_names() self.__exclude_fixers() if doctests: if setuptools.run_2to3_on_doctests: r = DistutilsRefactoringTool(self.fixer_names) r.refactor(files, write=True, doctests_only=True) else: _Mixin2to3.run_2to3(self, files) def __build_fixer_names(self): if self.fixer_names: return self.fixer_names = [] for p in setuptools.lib2to3_fixer_packages: self.fixer_names.extend(get_fixers_from_package(p)) if self.distribution.use_2to3_fixers is not None: for p in self.distribution.use_2to3_fixers: self.fixer_names.extend(get_fixers_from_package(p)) def __exclude_fixers(self): excluded_fixers = getattr(self, 'exclude_fixers', []) if self.distribution.use_2to3_exclude_fixers is not None: excluded_fixers.extend(self.distribution.use_2to3_exclude_fixers) for fixer_name in excluded_fixers: if fixer_name in self.fixer_names: self.fixer_names.remove(fixer_name) setuptools-20.7.0/setuptools/msvc9_support.py0000664000175000017500000000421112702524020022305 0ustar travistravis00000000000000try: import distutils.msvc9compiler except Exception: pass unpatched = dict() def patch_for_specialized_compiler(): """ Patch functions in distutils.msvc9compiler to use the standalone compiler build for Python (Windows only). Fall back to original behavior when the standalone compiler is not available. """ if 'distutils' not in globals(): # The module isn't available to be patched return if unpatched: # Already patched return unpatched.update(vars(distutils.msvc9compiler)) distutils.msvc9compiler.find_vcvarsall = find_vcvarsall distutils.msvc9compiler.query_vcvarsall = query_vcvarsall def find_vcvarsall(version): Reg = distutils.msvc9compiler.Reg VC_BASE = r'Software\%sMicrosoft\DevDiv\VCForPython\%0.1f' key = VC_BASE % ('', version) try: # Per-user installs register the compiler path here productdir = Reg.get_value(key, "installdir") except KeyError: try: # All-user installs on a 64-bit system register here key = VC_BASE % ('Wow6432Node\\', version) productdir = Reg.get_value(key, "installdir") except KeyError: productdir = None if productdir: import os vcvarsall = os.path.join(productdir, "vcvarsall.bat") if os.path.isfile(vcvarsall): return vcvarsall return unpatched['find_vcvarsall'](version) def query_vcvarsall(version, *args, **kwargs): try: return unpatched['query_vcvarsall'](version, *args, **kwargs) except distutils.errors.DistutilsPlatformError as exc: if exc and "vcvarsall.bat" in exc.args[0]: message = 'Microsoft Visual C++ %0.1f is required (%s).' % (version, exc.args[0]) if int(version) == 9: # This redirection link is maintained by Microsoft. # Contact vspython@microsoft.com if it needs updating. raise distutils.errors.DistutilsPlatformError( message + ' Get it from http://aka.ms/vcpython27' ) raise distutils.errors.DistutilsPlatformError(message) raise setuptools-20.7.0/setuptools/package_index.py0000775000175000017500000011510212702524020022237 0ustar travistravis00000000000000"""PyPI and direct package downloading""" import sys import os import re import shutil import socket import base64 import hashlib import itertools from functools import wraps try: from urllib.parse import splituser except ImportError: from urllib2 import splituser from setuptools.extern import six from setuptools.extern.six.moves import urllib, http_client, configparser, map from pkg_resources import ( CHECKOUT_DIST, Distribution, BINARY_DIST, normalize_path, SOURCE_DIST, require, Environment, find_distributions, safe_name, safe_version, to_filename, Requirement, DEVELOP_DIST, ) from setuptools import ssl_support from distutils import log from distutils.errors import DistutilsError from fnmatch import translate from setuptools.py26compat import strip_fragment from setuptools.py27compat import get_all_headers EGG_FRAGMENT = re.compile(r'^egg=([-A-Za-z0-9_.]+)$') HREF = re.compile("""href\\s*=\\s*['"]?([^'"> ]+)""", re.I) # this is here to fix emacs' cruddy broken syntax highlighting PYPI_MD5 = re.compile( '
    ([^<]+)\n\s+\\(md5\\)' ) URL_SCHEME = re.compile('([-+.a-z0-9]{2,}):',re.I).match EXTENSIONS = ".tar.gz .tar.bz2 .tar .zip .tgz".split() __all__ = [ 'PackageIndex', 'distros_for_url', 'parse_bdist_wininst', 'interpret_distro_name', ] _SOCKET_TIMEOUT = 15 def parse_bdist_wininst(name): """Return (base,pyversion) or (None,None) for possible .exe name""" lower = name.lower() base, py_ver, plat = None, None, None if lower.endswith('.exe'): if lower.endswith('.win32.exe'): base = name[:-10] plat = 'win32' elif lower.startswith('.win32-py',-16): py_ver = name[-7:-4] base = name[:-16] plat = 'win32' elif lower.endswith('.win-amd64.exe'): base = name[:-14] plat = 'win-amd64' elif lower.startswith('.win-amd64-py',-20): py_ver = name[-7:-4] base = name[:-20] plat = 'win-amd64' return base,py_ver,plat def egg_info_for_url(url): parts = urllib.parse.urlparse(url) scheme, server, path, parameters, query, fragment = parts base = urllib.parse.unquote(path.split('/')[-1]) if server=='sourceforge.net' and base=='download': # XXX Yuck base = urllib.parse.unquote(path.split('/')[-2]) if '#' in base: base, fragment = base.split('#',1) return base,fragment def distros_for_url(url, metadata=None): """Yield egg or source distribution objects that might be found at a URL""" base, fragment = egg_info_for_url(url) for dist in distros_for_location(url, base, metadata): yield dist if fragment: match = EGG_FRAGMENT.match(fragment) if match: for dist in interpret_distro_name( url, match.group(1), metadata, precedence = CHECKOUT_DIST ): yield dist def distros_for_location(location, basename, metadata=None): """Yield egg or source distribution objects based on basename""" if basename.endswith('.egg.zip'): basename = basename[:-4] # strip the .zip if basename.endswith('.egg') and '-' in basename: # only one, unambiguous interpretation return [Distribution.from_location(location, basename, metadata)] if basename.endswith('.exe'): win_base, py_ver, platform = parse_bdist_wininst(basename) if win_base is not None: return interpret_distro_name( location, win_base, metadata, py_ver, BINARY_DIST, platform ) # Try source distro extensions (.zip, .tgz, etc.) # for ext in EXTENSIONS: if basename.endswith(ext): basename = basename[:-len(ext)] return interpret_distro_name(location, basename, metadata) return [] # no extension matched def distros_for_filename(filename, metadata=None): """Yield possible egg or source distribution objects based on a filename""" return distros_for_location( normalize_path(filename), os.path.basename(filename), metadata ) def interpret_distro_name( location, basename, metadata, py_version=None, precedence=SOURCE_DIST, platform=None ): """Generate alternative interpretations of a source distro name Note: if `location` is a filesystem filename, you should call ``pkg_resources.normalize_path()`` on it before passing it to this routine! """ # Generate alternative interpretations of a source distro name # Because some packages are ambiguous as to name/versions split # e.g. "adns-python-1.1.0", "egenix-mx-commercial", etc. # So, we generate each possible interepretation (e.g. "adns, python-1.1.0" # "adns-python, 1.1.0", and "adns-python-1.1.0, no version"). In practice, # the spurious interpretations should be ignored, because in the event # there's also an "adns" package, the spurious "python-1.1.0" version will # compare lower than any numeric version number, and is therefore unlikely # to match a request for it. It's still a potential problem, though, and # in the long run PyPI and the distutils should go for "safe" names and # versions in distribution archive names (sdist and bdist). parts = basename.split('-') if not py_version and any(re.match('py\d\.\d$', p) for p in parts[2:]): # it is a bdist_dumb, not an sdist -- bail out return for p in range(1,len(parts)+1): yield Distribution( location, metadata, '-'.join(parts[:p]), '-'.join(parts[p:]), py_version=py_version, precedence = precedence, platform = platform ) # From Python 2.7 docs def unique_everseen(iterable, key=None): "List unique elements, preserving order. Remember all elements ever seen." # unique_everseen('AAAABBBCCDAABBB') --> A B C D # unique_everseen('ABBCcAD', str.lower) --> A B C D seen = set() seen_add = seen.add if key is None: for element in six.moves.filterfalse(seen.__contains__, iterable): seen_add(element) yield element else: for element in iterable: k = key(element) if k not in seen: seen_add(k) yield element def unique_values(func): """ Wrap a function returning an iterable such that the resulting iterable only ever yields unique items. """ @wraps(func) def wrapper(*args, **kwargs): return unique_everseen(func(*args, **kwargs)) return wrapper REL = re.compile("""<([^>]*\srel\s*=\s*['"]?([^'">]+)[^>]*)>""", re.I) # this line is here to fix emacs' cruddy broken syntax highlighting @unique_values def find_external_links(url, page): """Find rel="homepage" and rel="download" links in `page`, yielding URLs""" for match in REL.finditer(page): tag, rel = match.groups() rels = set(map(str.strip, rel.lower().split(','))) if 'homepage' in rels or 'download' in rels: for match in HREF.finditer(tag): yield urllib.parse.urljoin(url, htmldecode(match.group(1))) for tag in ("Home Page", "Download URL"): pos = page.find(tag) if pos!=-1: match = HREF.search(page,pos) if match: yield urllib.parse.urljoin(url, htmldecode(match.group(1))) user_agent = "Python-urllib/%s setuptools/%s" % ( sys.version[:3], require('setuptools')[0].version ) class ContentChecker(object): """ A null content checker that defines the interface for checking content """ def feed(self, block): """ Feed a block of data to the hash. """ return def is_valid(self): """ Check the hash. Return False if validation fails. """ return True def report(self, reporter, template): """ Call reporter with information about the checker (hash name) substituted into the template. """ return class HashChecker(ContentChecker): pattern = re.compile( r'(?Psha1|sha224|sha384|sha256|sha512|md5)=' r'(?P[a-f0-9]+)' ) def __init__(self, hash_name, expected): self.hash_name = hash_name self.hash = hashlib.new(hash_name) self.expected = expected @classmethod def from_url(cls, url): "Construct a (possibly null) ContentChecker from a URL" fragment = urllib.parse.urlparse(url)[-1] if not fragment: return ContentChecker() match = cls.pattern.search(fragment) if not match: return ContentChecker() return cls(**match.groupdict()) def feed(self, block): self.hash.update(block) def is_valid(self): return self.hash.hexdigest() == self.expected def report(self, reporter, template): msg = template % self.hash_name return reporter(msg) class PackageIndex(Environment): """A distribution index that scans web pages for download URLs""" def __init__( self, index_url="https://pypi.python.org/simple", hosts=('*',), ca_bundle=None, verify_ssl=True, *args, **kw ): Environment.__init__(self,*args,**kw) self.index_url = index_url + "/"[:not index_url.endswith('/')] self.scanned_urls = {} self.fetched_urls = {} self.package_pages = {} self.allows = re.compile('|'.join(map(translate,hosts))).match self.to_scan = [] if verify_ssl and ssl_support.is_available and (ca_bundle or ssl_support.find_ca_bundle()): self.opener = ssl_support.opener_for(ca_bundle) else: self.opener = urllib.request.urlopen def process_url(self, url, retrieve=False): """Evaluate a URL as a possible download, and maybe retrieve it""" if url in self.scanned_urls and not retrieve: return self.scanned_urls[url] = True if not URL_SCHEME(url): self.process_filename(url) return else: dists = list(distros_for_url(url)) if dists: if not self.url_ok(url): return self.debug("Found link: %s", url) if dists or not retrieve or url in self.fetched_urls: list(map(self.add, dists)) return # don't need the actual page if not self.url_ok(url): self.fetched_urls[url] = True return self.info("Reading %s", url) self.fetched_urls[url] = True # prevent multiple fetch attempts f = self.open_url(url, "Download error on %s: %%s -- Some packages may not be found!" % url) if f is None: return self.fetched_urls[f.url] = True if 'html' not in f.headers.get('content-type', '').lower(): f.close() # not html, we can't process it return base = f.url # handle redirects page = f.read() if not isinstance(page, str): # We are in Python 3 and got bytes. We want str. if isinstance(f, urllib.error.HTTPError): # Errors have no charset, assume latin1: charset = 'latin-1' else: charset = f.headers.get_param('charset') or 'latin-1' page = page.decode(charset, "ignore") f.close() for match in HREF.finditer(page): link = urllib.parse.urljoin(base, htmldecode(match.group(1))) self.process_url(link) if url.startswith(self.index_url) and getattr(f,'code',None)!=404: page = self.process_index(url, page) def process_filename(self, fn, nested=False): # process filenames or directories if not os.path.exists(fn): self.warn("Not found: %s", fn) return if os.path.isdir(fn) and not nested: path = os.path.realpath(fn) for item in os.listdir(path): self.process_filename(os.path.join(path,item), True) dists = distros_for_filename(fn) if dists: self.debug("Found: %s", fn) list(map(self.add, dists)) def url_ok(self, url, fatal=False): s = URL_SCHEME(url) if (s and s.group(1).lower()=='file') or self.allows(urllib.parse.urlparse(url)[1]): return True msg = ("\nNote: Bypassing %s (disallowed host; see " "http://bit.ly/1dg9ijs for details).\n") if fatal: raise DistutilsError(msg % url) else: self.warn(msg, url) def scan_egg_links(self, search_path): dirs = filter(os.path.isdir, search_path) egg_links = ( (path, entry) for path in dirs for entry in os.listdir(path) if entry.endswith('.egg-link') ) list(itertools.starmap(self.scan_egg_link, egg_links)) def scan_egg_link(self, path, entry): with open(os.path.join(path, entry)) as raw_lines: # filter non-empty lines lines = list(filter(None, map(str.strip, raw_lines))) if len(lines) != 2: # format is not recognized; punt return egg_path, setup_path = lines for dist in find_distributions(os.path.join(path, egg_path)): dist.location = os.path.join(path, *lines) dist.precedence = SOURCE_DIST self.add(dist) def process_index(self,url,page): """Process the contents of a PyPI page""" def scan(link): # Process a URL to see if it's for a package page if link.startswith(self.index_url): parts = list(map( urllib.parse.unquote, link[len(self.index_url):].split('/') )) if len(parts)==2 and '#' not in parts[1]: # it's a package page, sanitize and index it pkg = safe_name(parts[0]) ver = safe_version(parts[1]) self.package_pages.setdefault(pkg.lower(),{})[link] = True return to_filename(pkg), to_filename(ver) return None, None # process an index page into the package-page index for match in HREF.finditer(page): try: scan(urllib.parse.urljoin(url, htmldecode(match.group(1)))) except ValueError: pass pkg, ver = scan(url) # ensure this page is in the page index if pkg: # process individual package page for new_url in find_external_links(url, page): # Process the found URL base, frag = egg_info_for_url(new_url) if base.endswith('.py') and not frag: if ver: new_url+='#egg=%s-%s' % (pkg,ver) else: self.need_version_info(url) self.scan_url(new_url) return PYPI_MD5.sub( lambda m: '%s' % m.group(1,3,2), page ) else: return "" # no sense double-scanning non-package pages def need_version_info(self, url): self.scan_all( "Page at %s links to .py file(s) without version info; an index " "scan is required.", url ) def scan_all(self, msg=None, *args): if self.index_url not in self.fetched_urls: if msg: self.warn(msg,*args) self.info( "Scanning index of all packages (this may take a while)" ) self.scan_url(self.index_url) def find_packages(self, requirement): self.scan_url(self.index_url + requirement.unsafe_name+'/') if not self.package_pages.get(requirement.key): # Fall back to safe version of the name self.scan_url(self.index_url + requirement.project_name+'/') if not self.package_pages.get(requirement.key): # We couldn't find the target package, so search the index page too self.not_found_in_index(requirement) for url in list(self.package_pages.get(requirement.key,())): # scan each page that might be related to the desired package self.scan_url(url) def obtain(self, requirement, installer=None): self.prescan() self.find_packages(requirement) for dist in self[requirement.key]: if dist in requirement: return dist self.debug("%s does not match %s", requirement, dist) return super(PackageIndex, self).obtain(requirement,installer) def check_hash(self, checker, filename, tfp): """ checker is a ContentChecker """ checker.report(self.debug, "Validating %%s checksum for %s" % filename) if not checker.is_valid(): tfp.close() os.unlink(filename) raise DistutilsError( "%s validation failed for %s; " "possible download problem?" % ( checker.hash.name, os.path.basename(filename)) ) def add_find_links(self, urls): """Add `urls` to the list that will be prescanned for searches""" for url in urls: if ( self.to_scan is None # if we have already "gone online" or not URL_SCHEME(url) # or it's a local file/directory or url.startswith('file:') or list(distros_for_url(url)) # or a direct package link ): # then go ahead and process it now self.scan_url(url) else: # otherwise, defer retrieval till later self.to_scan.append(url) def prescan(self): """Scan urls scheduled for prescanning (e.g. --find-links)""" if self.to_scan: list(map(self.scan_url, self.to_scan)) self.to_scan = None # from now on, go ahead and process immediately def not_found_in_index(self, requirement): if self[requirement.key]: # we've seen at least one distro meth, msg = self.info, "Couldn't retrieve index page for %r" else: # no distros seen for this name, might be misspelled meth, msg = (self.warn, "Couldn't find index page for %r (maybe misspelled?)") meth(msg, requirement.unsafe_name) self.scan_all() def download(self, spec, tmpdir): """Locate and/or download `spec` to `tmpdir`, returning a local path `spec` may be a ``Requirement`` object, or a string containing a URL, an existing local filename, or a project/version requirement spec (i.e. the string form of a ``Requirement`` object). If it is the URL of a .py file with an unambiguous ``#egg=name-version`` tag (i.e., one that escapes ``-`` as ``_`` throughout), a trivial ``setup.py`` is automatically created alongside the downloaded file. If `spec` is a ``Requirement`` object or a string containing a project/version requirement spec, this method returns the location of a matching distribution (possibly after downloading it to `tmpdir`). If `spec` is a locally existing file or directory name, it is simply returned unchanged. If `spec` is a URL, it is downloaded to a subpath of `tmpdir`, and the local filename is returned. Various errors may be raised if a problem occurs during downloading. """ if not isinstance(spec,Requirement): scheme = URL_SCHEME(spec) if scheme: # It's a url, download it to tmpdir found = self._download_url(scheme.group(1), spec, tmpdir) base, fragment = egg_info_for_url(spec) if base.endswith('.py'): found = self.gen_setup(found,fragment,tmpdir) return found elif os.path.exists(spec): # Existing file or directory, just return it return spec else: try: spec = Requirement.parse(spec) except ValueError: raise DistutilsError( "Not a URL, existing file, or requirement spec: %r" % (spec,) ) return getattr(self.fetch_distribution(spec, tmpdir),'location',None) def fetch_distribution( self, requirement, tmpdir, force_scan=False, source=False, develop_ok=False, local_index=None ): """Obtain a distribution suitable for fulfilling `requirement` `requirement` must be a ``pkg_resources.Requirement`` instance. If necessary, or if the `force_scan` flag is set, the requirement is searched for in the (online) package index as well as the locally installed packages. If a distribution matching `requirement` is found, the returned distribution's ``location`` is the value you would have gotten from calling the ``download()`` method with the matching distribution's URL or filename. If no matching distribution is found, ``None`` is returned. If the `source` flag is set, only source distributions and source checkout links will be considered. Unless the `develop_ok` flag is set, development and system eggs (i.e., those using the ``.egg-info`` format) will be ignored. """ # process a Requirement self.info("Searching for %s", requirement) skipped = {} dist = None def find(req, env=None): if env is None: env = self # Find a matching distribution; may be called more than once for dist in env[req.key]: if dist.precedence==DEVELOP_DIST and not develop_ok: if dist not in skipped: self.warn("Skipping development or system egg: %s",dist) skipped[dist] = 1 continue if dist in req and (dist.precedence<=SOURCE_DIST or not source): return dist if force_scan: self.prescan() self.find_packages(requirement) dist = find(requirement) if local_index is not None: dist = dist or find(requirement, local_index) if dist is None: if self.to_scan is not None: self.prescan() dist = find(requirement) if dist is None and not force_scan: self.find_packages(requirement) dist = find(requirement) if dist is None: self.warn( "No local packages or download links found for %s%s", (source and "a source distribution of " or ""), requirement, ) else: self.info("Best match: %s", dist) return dist.clone(location=self.download(dist.location, tmpdir)) def fetch(self, requirement, tmpdir, force_scan=False, source=False): """Obtain a file suitable for fulfilling `requirement` DEPRECATED; use the ``fetch_distribution()`` method now instead. For backward compatibility, this routine is identical but returns the ``location`` of the downloaded distribution instead of a distribution object. """ dist = self.fetch_distribution(requirement,tmpdir,force_scan,source) if dist is not None: return dist.location return None def gen_setup(self, filename, fragment, tmpdir): match = EGG_FRAGMENT.match(fragment) dists = match and [ d for d in interpret_distro_name(filename, match.group(1), None) if d.version ] or [] if len(dists)==1: # unambiguous ``#egg`` fragment basename = os.path.basename(filename) # Make sure the file has been downloaded to the temp dir. if os.path.dirname(filename) != tmpdir: dst = os.path.join(tmpdir, basename) from setuptools.command.easy_install import samefile if not samefile(filename, dst): shutil.copy2(filename, dst) filename=dst with open(os.path.join(tmpdir, 'setup.py'), 'w') as file: file.write( "from setuptools import setup\n" "setup(name=%r, version=%r, py_modules=[%r])\n" % ( dists[0].project_name, dists[0].version, os.path.splitext(basename)[0] ) ) return filename elif match: raise DistutilsError( "Can't unambiguously interpret project/version identifier %r; " "any dashes in the name or version should be escaped using " "underscores. %r" % (fragment,dists) ) else: raise DistutilsError( "Can't process plain .py files without an '#egg=name-version'" " suffix to enable automatic setup script generation." ) dl_blocksize = 8192 def _download_to(self, url, filename): self.info("Downloading %s", url) # Download the file fp, info = None, None try: checker = HashChecker.from_url(url) fp = self.open_url(strip_fragment(url)) if isinstance(fp, urllib.error.HTTPError): raise DistutilsError( "Can't download %s: %s %s" % (url, fp.code,fp.msg) ) headers = fp.info() blocknum = 0 bs = self.dl_blocksize size = -1 if "content-length" in headers: # Some servers return multiple Content-Length headers :( sizes = get_all_headers(headers, 'Content-Length') size = max(map(int, sizes)) self.reporthook(url, filename, blocknum, bs, size) with open(filename,'wb') as tfp: while True: block = fp.read(bs) if block: checker.feed(block) tfp.write(block) blocknum += 1 self.reporthook(url, filename, blocknum, bs, size) else: break self.check_hash(checker, filename, tfp) return headers finally: if fp: fp.close() def reporthook(self, url, filename, blocknum, blksize, size): pass # no-op def open_url(self, url, warning=None): if url.startswith('file:'): return local_open(url) try: return open_with_auth(url, self.opener) except (ValueError, http_client.InvalidURL) as v: msg = ' '.join([str(arg) for arg in v.args]) if warning: self.warn(warning, msg) else: raise DistutilsError('%s %s' % (url, msg)) except urllib.error.HTTPError as v: return v except urllib.error.URLError as v: if warning: self.warn(warning, v.reason) else: raise DistutilsError("Download error for %s: %s" % (url, v.reason)) except http_client.BadStatusLine as v: if warning: self.warn(warning, v.line) else: raise DistutilsError( '%s returned a bad status line. The server might be ' 'down, %s' % (url, v.line) ) except http_client.HTTPException as v: if warning: self.warn(warning, v) else: raise DistutilsError("Download error for %s: %s" % (url, v)) def _download_url(self, scheme, url, tmpdir): # Determine download filename # name, fragment = egg_info_for_url(url) if name: while '..' in name: name = name.replace('..','.').replace('\\','_') else: name = "__downloaded__" # default if URL has no path contents if name.endswith('.egg.zip'): name = name[:-4] # strip the extra .zip before download filename = os.path.join(tmpdir,name) # Download the file # if scheme=='svn' or scheme.startswith('svn+'): return self._download_svn(url, filename) elif scheme=='git' or scheme.startswith('git+'): return self._download_git(url, filename) elif scheme.startswith('hg+'): return self._download_hg(url, filename) elif scheme=='file': return urllib.request.url2pathname(urllib.parse.urlparse(url)[2]) else: self.url_ok(url, True) # raises error if not allowed return self._attempt_download(url, filename) def scan_url(self, url): self.process_url(url, True) def _attempt_download(self, url, filename): headers = self._download_to(url, filename) if 'html' in headers.get('content-type','').lower(): return self._download_html(url, headers, filename) else: return filename def _download_html(self, url, headers, filename): file = open(filename) for line in file: if line.strip(): # Check for a subversion index page if re.search(r'([^- ]+ - )?Revision \d+:', line): # it's a subversion index page: file.close() os.unlink(filename) return self._download_svn(url, filename) break # not an index page file.close() os.unlink(filename) raise DistutilsError("Unexpected HTML page found at "+url) def _download_svn(self, url, filename): url = url.split('#',1)[0] # remove any fragment for svn's sake creds = '' if url.lower().startswith('svn:') and '@' in url: scheme, netloc, path, p, q, f = urllib.parse.urlparse(url) if not netloc and path.startswith('//') and '/' in path[2:]: netloc, path = path[2:].split('/',1) auth, host = splituser(netloc) if auth: if ':' in auth: user, pw = auth.split(':',1) creds = " --username=%s --password=%s" % (user, pw) else: creds = " --username="+auth netloc = host parts = scheme, netloc, url, p, q, f url = urllib.parse.urlunparse(parts) self.info("Doing subversion checkout from %s to %s", url, filename) os.system("svn checkout%s -q %s %s" % (creds, url, filename)) return filename @staticmethod def _vcs_split_rev_from_url(url, pop_prefix=False): scheme, netloc, path, query, frag = urllib.parse.urlsplit(url) scheme = scheme.split('+', 1)[-1] # Some fragment identification fails path = path.split('#',1)[0] rev = None if '@' in path: path, rev = path.rsplit('@', 1) # Also, discard fragment url = urllib.parse.urlunsplit((scheme, netloc, path, query, '')) return url, rev def _download_git(self, url, filename): filename = filename.split('#',1)[0] url, rev = self._vcs_split_rev_from_url(url, pop_prefix=True) self.info("Doing git clone from %s to %s", url, filename) os.system("git clone --quiet %s %s" % (url, filename)) if rev is not None: self.info("Checking out %s", rev) os.system("(cd %s && git checkout --quiet %s)" % ( filename, rev, )) return filename def _download_hg(self, url, filename): filename = filename.split('#',1)[0] url, rev = self._vcs_split_rev_from_url(url, pop_prefix=True) self.info("Doing hg clone from %s to %s", url, filename) os.system("hg clone --quiet %s %s" % (url, filename)) if rev is not None: self.info("Updating to %s", rev) os.system("(cd %s && hg up -C -r %s >&-)" % ( filename, rev, )) return filename def debug(self, msg, *args): log.debug(msg, *args) def info(self, msg, *args): log.info(msg, *args) def warn(self, msg, *args): log.warn(msg, *args) # This pattern matches a character entity reference (a decimal numeric # references, a hexadecimal numeric reference, or a named reference). entity_sub = re.compile(r'&(#(\d+|x[\da-fA-F]+)|[\w.:-]+);?').sub def uchr(c): if not isinstance(c, int): return c if c>255: return six.unichr(c) return chr(c) def decode_entity(match): what = match.group(1) if what.startswith('#x'): what = int(what[2:], 16) elif what.startswith('#'): what = int(what[1:]) else: what = six.moves.html_entities.name2codepoint.get(what, match.group(0)) return uchr(what) def htmldecode(text): """Decode HTML entities in the given text.""" return entity_sub(decode_entity, text) def socket_timeout(timeout=15): def _socket_timeout(func): def _socket_timeout(*args, **kwargs): old_timeout = socket.getdefaulttimeout() socket.setdefaulttimeout(timeout) try: return func(*args, **kwargs) finally: socket.setdefaulttimeout(old_timeout) return _socket_timeout return _socket_timeout def _encode_auth(auth): """ A function compatible with Python 2.3-3.3 that will encode auth from a URL suitable for an HTTP header. >>> str(_encode_auth('username%3Apassword')) 'dXNlcm5hbWU6cGFzc3dvcmQ=' Long auth strings should not cause a newline to be inserted. >>> long_auth = 'username:' + 'password'*10 >>> chr(10) in str(_encode_auth(long_auth)) False """ auth_s = urllib.parse.unquote(auth) # convert to bytes auth_bytes = auth_s.encode() # use the legacy interface for Python 2.3 support encoded_bytes = base64.encodestring(auth_bytes) # convert back to a string encoded = encoded_bytes.decode() # strip the trailing carriage return return encoded.replace('\n','') class Credential(object): """ A username/password pair. Use like a namedtuple. """ def __init__(self, username, password): self.username = username self.password = password def __iter__(self): yield self.username yield self.password def __str__(self): return '%(username)s:%(password)s' % vars(self) class PyPIConfig(configparser.RawConfigParser): def __init__(self): """ Load from ~/.pypirc """ defaults = dict.fromkeys(['username', 'password', 'repository'], '') configparser.RawConfigParser.__init__(self, defaults) rc = os.path.join(os.path.expanduser('~'), '.pypirc') if os.path.exists(rc): self.read(rc) @property def creds_by_repository(self): sections_with_repositories = [ section for section in self.sections() if self.get(section, 'repository').strip() ] return dict(map(self._get_repo_cred, sections_with_repositories)) def _get_repo_cred(self, section): repo = self.get(section, 'repository').strip() return repo, Credential( self.get(section, 'username').strip(), self.get(section, 'password').strip(), ) def find_credential(self, url): """ If the URL indicated appears to be a repository defined in this config, return the credential for that repository. """ for repository, cred in self.creds_by_repository.items(): if url.startswith(repository): return cred def open_with_auth(url, opener=urllib.request.urlopen): """Open a urllib2 request, handling HTTP authentication""" scheme, netloc, path, params, query, frag = urllib.parse.urlparse(url) # Double scheme does not raise on Mac OS X as revealed by a # failing test. We would expect "nonnumeric port". Refs #20. if netloc.endswith(':'): raise http_client.InvalidURL("nonnumeric port: ''") if scheme in ('http', 'https'): auth, host = splituser(netloc) else: auth = None if not auth: cred = PyPIConfig().find_credential(url) if cred: auth = str(cred) info = cred.username, url log.info('Authenticating as %s for %s (from .pypirc)' % info) if auth: auth = "Basic " + _encode_auth(auth) parts = scheme, host, path, params, query, frag new_url = urllib.parse.urlunparse(parts) request = urllib.request.Request(new_url) request.add_header("Authorization", auth) else: request = urllib.request.Request(url) request.add_header('User-Agent', user_agent) fp = opener(request) if auth: # Put authentication info back into request URL if same host, # so that links found on the page will work s2, h2, path2, param2, query2, frag2 = urllib.parse.urlparse(fp.url) if s2==scheme and h2==host: parts = s2, netloc, path2, param2, query2, frag2 fp.url = urllib.parse.urlunparse(parts) return fp # adding a timeout to avoid freezing package_index open_with_auth = socket_timeout(_SOCKET_TIMEOUT)(open_with_auth) def fix_sf_url(url): return url # backward compatibility def local_open(url): """Read a local path, with special support for directories""" scheme, server, path, param, query, frag = urllib.parse.urlparse(url) filename = urllib.request.url2pathname(path) if os.path.isfile(filename): return urllib.request.urlopen(url) elif path.endswith('/') and os.path.isdir(filename): files = [] for f in os.listdir(filename): filepath = os.path.join(filename, f) if f == 'index.html': with open(filepath, 'r') as fp: body = fp.read() break elif os.path.isdir(filepath): f += '/' files.append('<a href="{name}">{name}</a>'.format(name=f)) else: tmpl = ("<html><head><title>{url}" "{files}") body = tmpl.format(url=url, files='\n'.join(files)) status, message = 200, "OK" else: status, message, body = 404, "Path not found", "Not found" headers = {'content-type': 'text/html'} body_stream = six.StringIO(body) return urllib.error.HTTPError(url, status, message, headers, body_stream) setuptools-20.7.0/setuptools/py26compat.py0000664000175000017500000000074112702524020021460 0ustar travistravis00000000000000""" Compatibility Support for Python 2.6 and earlier """ import sys try: from urllib.parse import splittag except ImportError: from urllib import splittag def strip_fragment(url): """ In `Python 8280 `_, Python 2.7 and later was patched to disregard the fragment when making URL requests. Do the same for Python 2.6 and earlier. """ url, fragment = splittag(url) return url if sys.version_info >= (2,7): strip_fragment = lambda x: x setuptools-20.7.0/setuptools/py27compat.py0000664000175000017500000000046212702524020021461 0ustar travistravis00000000000000""" Compatibility Support for Python 2.7 and earlier """ import sys def get_all_headers(message, key): """ Given an HTTPMessage, return all headers matching a given key. """ return message.get_all(key) if sys.version_info < (3,): def get_all_headers(message, key): return message.getheaders(key) setuptools-20.7.0/setuptools/py31compat.py0000664000175000017500000000314412702524020021454 0ustar travistravis00000000000000import sys import unittest __all__ = ['get_config_vars', 'get_path'] try: # Python 2.7 or >=3.2 from sysconfig import get_config_vars, get_path except ImportError: from distutils.sysconfig import get_config_vars, get_python_lib def get_path(name): if name not in ('platlib', 'purelib'): raise ValueError("Name must be purelib or platlib") return get_python_lib(name=='platlib') try: # Python >=3.2 from tempfile import TemporaryDirectory except ImportError: import shutil import tempfile class TemporaryDirectory(object): """ Very simple temporary directory context manager. Will try to delete afterward, but will also ignore OS and similar errors on deletion. """ def __init__(self): self.name = None # Handle mkdtemp raising an exception self.name = tempfile.mkdtemp() def __enter__(self): return self.name def __exit__(self, exctype, excvalue, exctrace): try: shutil.rmtree(self.name, True) except OSError: #removal errors are not the only possible pass self.name = None unittest_main = unittest.main _PY31 = (3, 1) <= sys.version_info[:2] < (3, 2) if _PY31: # on Python 3.1, translate testRunner==None to TextTestRunner # for compatibility with Python 2.6, 2.7, and 3.2+ def unittest_main(*args, **kwargs): if 'testRunner' in kwargs and kwargs['testRunner'] is None: kwargs['testRunner'] = unittest.TextTestRunner return unittest.main(*args, **kwargs) setuptools-20.7.0/setuptools/sandbox.py0000775000175000017500000003360212702524020021117 0ustar travistravis00000000000000import os import sys import tempfile import operator import functools import itertools import re import contextlib import pickle from setuptools.extern import six from setuptools.extern.six.moves import builtins, map import pkg_resources if sys.platform.startswith('java'): import org.python.modules.posix.PosixModule as _os else: _os = sys.modules[os.name] try: _file = file except NameError: _file = None _open = open from distutils.errors import DistutilsError from pkg_resources import working_set __all__ = [ "AbstractSandbox", "DirectorySandbox", "SandboxViolation", "run_setup", ] def _execfile(filename, globals, locals=None): """ Python 3 implementation of execfile. """ mode = 'rb' with open(filename, mode) as stream: script = stream.read() # compile() function in Python 2.6 and 3.1 requires LF line endings. if sys.version_info[:2] < (2, 7) or sys.version_info[:2] >= (3, 0) and sys.version_info[:2] < (3, 2): script = script.replace(b'\r\n', b'\n') script = script.replace(b'\r', b'\n') if locals is None: locals = globals code = compile(script, filename, 'exec') exec(code, globals, locals) @contextlib.contextmanager def save_argv(repl=None): saved = sys.argv[:] if repl is not None: sys.argv[:] = repl try: yield saved finally: sys.argv[:] = saved @contextlib.contextmanager def save_path(): saved = sys.path[:] try: yield saved finally: sys.path[:] = saved @contextlib.contextmanager def override_temp(replacement): """ Monkey-patch tempfile.tempdir with replacement, ensuring it exists """ if not os.path.isdir(replacement): os.makedirs(replacement) saved = tempfile.tempdir tempfile.tempdir = replacement try: yield finally: tempfile.tempdir = saved @contextlib.contextmanager def pushd(target): saved = os.getcwd() os.chdir(target) try: yield saved finally: os.chdir(saved) class UnpickleableException(Exception): """ An exception representing another Exception that could not be pickled. """ @staticmethod def dump(type, exc): """ Always return a dumped (pickled) type and exc. If exc can't be pickled, wrap it in UnpickleableException first. """ try: return pickle.dumps(type), pickle.dumps(exc) except Exception: # get UnpickleableException inside the sandbox from setuptools.sandbox import UnpickleableException as cls return cls.dump(cls, cls(repr(exc))) class ExceptionSaver: """ A Context Manager that will save an exception, serialized, and restore it later. """ def __enter__(self): return self def __exit__(self, type, exc, tb): if not exc: return # dump the exception self._saved = UnpickleableException.dump(type, exc) self._tb = tb # suppress the exception return True def resume(self): "restore and re-raise any exception" if '_saved' not in vars(self): return type, exc = map(pickle.loads, self._saved) six.reraise(type, exc, self._tb) @contextlib.contextmanager def save_modules(): """ Context in which imported modules are saved. Translates exceptions internal to the context into the equivalent exception outside the context. """ saved = sys.modules.copy() with ExceptionSaver() as saved_exc: yield saved sys.modules.update(saved) # remove any modules imported since del_modules = ( mod_name for mod_name in sys.modules if mod_name not in saved # exclude any encodings modules. See #285 and not mod_name.startswith('encodings.') ) _clear_modules(del_modules) saved_exc.resume() def _clear_modules(module_names): for mod_name in list(module_names): del sys.modules[mod_name] @contextlib.contextmanager def save_pkg_resources_state(): saved = pkg_resources.__getstate__() try: yield saved finally: pkg_resources.__setstate__(saved) @contextlib.contextmanager def setup_context(setup_dir): temp_dir = os.path.join(setup_dir, 'temp') with save_pkg_resources_state(): with save_modules(): hide_setuptools() with save_path(): with save_argv(): with override_temp(temp_dir): with pushd(setup_dir): # ensure setuptools commands are available __import__('setuptools') yield def _needs_hiding(mod_name): """ >>> _needs_hiding('setuptools') True >>> _needs_hiding('pkg_resources') True >>> _needs_hiding('setuptools_plugin') False >>> _needs_hiding('setuptools.__init__') True >>> _needs_hiding('distutils') True >>> _needs_hiding('os') False >>> _needs_hiding('Cython') True """ pattern = re.compile('(setuptools|pkg_resources|distutils|Cython)(\.|$)') return bool(pattern.match(mod_name)) def hide_setuptools(): """ Remove references to setuptools' modules from sys.modules to allow the invocation to import the most appropriate setuptools. This technique is necessary to avoid issues such as #315 where setuptools upgrading itself would fail to find a function declared in the metadata. """ modules = filter(_needs_hiding, sys.modules) _clear_modules(modules) def run_setup(setup_script, args): """Run a distutils setup script, sandboxed in its directory""" setup_dir = os.path.abspath(os.path.dirname(setup_script)) with setup_context(setup_dir): try: sys.argv[:] = [setup_script]+list(args) sys.path.insert(0, setup_dir) # reset to include setup dir, w/clean callback list working_set.__init__() working_set.callbacks.append(lambda dist:dist.activate()) def runner(): ns = dict(__file__=setup_script, __name__='__main__') _execfile(setup_script, ns) DirectorySandbox(setup_dir).run(runner) except SystemExit as v: if v.args and v.args[0]: raise # Normal exit, just return class AbstractSandbox: """Wrap 'os' module and 'open()' builtin for virtualizing setup scripts""" _active = False def __init__(self): self._attrs = [ name for name in dir(_os) if not name.startswith('_') and hasattr(self,name) ] def _copy(self, source): for name in self._attrs: setattr(os, name, getattr(source,name)) def run(self, func): """Run 'func' under os sandboxing""" try: self._copy(self) if _file: builtins.file = self._file builtins.open = self._open self._active = True return func() finally: self._active = False if _file: builtins.file = _file builtins.open = _open self._copy(_os) def _mk_dual_path_wrapper(name): original = getattr(_os,name) def wrap(self,src,dst,*args,**kw): if self._active: src,dst = self._remap_pair(name,src,dst,*args,**kw) return original(src,dst,*args,**kw) return wrap for name in ["rename", "link", "symlink"]: if hasattr(_os,name): locals()[name] = _mk_dual_path_wrapper(name) def _mk_single_path_wrapper(name, original=None): original = original or getattr(_os,name) def wrap(self,path,*args,**kw): if self._active: path = self._remap_input(name,path,*args,**kw) return original(path,*args,**kw) return wrap if _file: _file = _mk_single_path_wrapper('file', _file) _open = _mk_single_path_wrapper('open', _open) for name in [ "stat", "listdir", "chdir", "open", "chmod", "chown", "mkdir", "remove", "unlink", "rmdir", "utime", "lchown", "chroot", "lstat", "startfile", "mkfifo", "mknod", "pathconf", "access" ]: if hasattr(_os,name): locals()[name] = _mk_single_path_wrapper(name) def _mk_single_with_return(name): original = getattr(_os,name) def wrap(self,path,*args,**kw): if self._active: path = self._remap_input(name,path,*args,**kw) return self._remap_output(name, original(path,*args,**kw)) return original(path,*args,**kw) return wrap for name in ['readlink', 'tempnam']: if hasattr(_os,name): locals()[name] = _mk_single_with_return(name) def _mk_query(name): original = getattr(_os,name) def wrap(self,*args,**kw): retval = original(*args,**kw) if self._active: return self._remap_output(name, retval) return retval return wrap for name in ['getcwd', 'tmpnam']: if hasattr(_os,name): locals()[name] = _mk_query(name) def _validate_path(self,path): """Called to remap or validate any path, whether input or output""" return path def _remap_input(self,operation,path,*args,**kw): """Called for path inputs""" return self._validate_path(path) def _remap_output(self,operation,path): """Called for path outputs""" return self._validate_path(path) def _remap_pair(self,operation,src,dst,*args,**kw): """Called for path pairs like rename, link, and symlink operations""" return ( self._remap_input(operation+'-from',src,*args,**kw), self._remap_input(operation+'-to',dst,*args,**kw) ) if hasattr(os, 'devnull'): _EXCEPTIONS = [os.devnull,] else: _EXCEPTIONS = [] try: from win32com.client.gencache import GetGeneratePath _EXCEPTIONS.append(GetGeneratePath()) del GetGeneratePath except ImportError: # it appears pywin32 is not installed, so no need to exclude. pass class DirectorySandbox(AbstractSandbox): """Restrict operations to a single subdirectory - pseudo-chroot""" write_ops = dict.fromkeys([ "open", "chmod", "chown", "mkdir", "remove", "unlink", "rmdir", "utime", "lchown", "chroot", "mkfifo", "mknod", "tempnam", ]) _exception_patterns = [ # Allow lib2to3 to attempt to save a pickled grammar object (#121) '.*lib2to3.*\.pickle$', ] "exempt writing to paths that match the pattern" def __init__(self, sandbox, exceptions=_EXCEPTIONS): self._sandbox = os.path.normcase(os.path.realpath(sandbox)) self._prefix = os.path.join(self._sandbox,'') self._exceptions = [ os.path.normcase(os.path.realpath(path)) for path in exceptions ] AbstractSandbox.__init__(self) def _violation(self, operation, *args, **kw): from setuptools.sandbox import SandboxViolation raise SandboxViolation(operation, args, kw) if _file: def _file(self, path, mode='r', *args, **kw): if mode not in ('r', 'rt', 'rb', 'rU', 'U') and not self._ok(path): self._violation("file", path, mode, *args, **kw) return _file(path,mode,*args,**kw) def _open(self, path, mode='r', *args, **kw): if mode not in ('r', 'rt', 'rb', 'rU', 'U') and not self._ok(path): self._violation("open", path, mode, *args, **kw) return _open(path,mode,*args,**kw) def tmpnam(self): self._violation("tmpnam") def _ok(self, path): active = self._active try: self._active = False realpath = os.path.normcase(os.path.realpath(path)) return ( self._exempted(realpath) or realpath == self._sandbox or realpath.startswith(self._prefix) ) finally: self._active = active def _exempted(self, filepath): start_matches = ( filepath.startswith(exception) for exception in self._exceptions ) pattern_matches = ( re.match(pattern, filepath) for pattern in self._exception_patterns ) candidates = itertools.chain(start_matches, pattern_matches) return any(candidates) def _remap_input(self, operation, path, *args, **kw): """Called for path inputs""" if operation in self.write_ops and not self._ok(path): self._violation(operation, os.path.realpath(path), *args, **kw) return path def _remap_pair(self, operation, src, dst, *args, **kw): """Called for path pairs like rename, link, and symlink operations""" if not self._ok(src) or not self._ok(dst): self._violation(operation, src, dst, *args, **kw) return (src,dst) def open(self, file, flags, mode=0o777, *args, **kw): """Called for low-level os.open()""" if flags & WRITE_FLAGS and not self._ok(file): self._violation("os.open", file, flags, mode, *args, **kw) return _os.open(file,flags,mode, *args, **kw) WRITE_FLAGS = functools.reduce( operator.or_, [getattr(_os, a, 0) for a in "O_WRONLY O_RDWR O_APPEND O_CREAT O_TRUNC O_TEMPORARY".split()] ) class SandboxViolation(DistutilsError): """A setup script attempted to modify the filesystem outside the sandbox""" def __str__(self): return """SandboxViolation: %s%r %s The package setup script has attempted to modify files on your system that are not within the EasyInstall build area, and has been aborted. This package cannot be safely installed by EasyInstall, and may not support alternate installation locations even if you run its setup script by hand. Please inform the package's author and the EasyInstall maintainers to find out if a fix or workaround is available.""" % self.args # setuptools-20.7.0/setuptools/script (dev).tmpl0000664000175000017500000000031112702524020022155 0ustar travistravis00000000000000# EASY-INSTALL-DEV-SCRIPT: %(spec)r,%(script_name)r __requires__ = %(spec)r __import__('pkg_resources').require(%(spec)r) __file__ = %(dev_path)r exec(compile(open(__file__).read(), __file__, 'exec')) setuptools-20.7.0/setuptools/script.tmpl0000664000175000017500000000021212702524020021275 0ustar travistravis00000000000000# EASY-INSTALL-SCRIPT: %(spec)r,%(script_name)r __requires__ = %(spec)r __import__('pkg_resources').run_script(%(spec)r, %(script_name)r) setuptools-20.7.0/setuptools/site-patch.py0000664000175000017500000000452512702524020021521 0ustar travistravis00000000000000def __boot(): import sys import os PYTHONPATH = os.environ.get('PYTHONPATH') if PYTHONPATH is None or (sys.platform=='win32' and not PYTHONPATH): PYTHONPATH = [] else: PYTHONPATH = PYTHONPATH.split(os.pathsep) pic = getattr(sys,'path_importer_cache',{}) stdpath = sys.path[len(PYTHONPATH):] mydir = os.path.dirname(__file__) #print "searching",stdpath,sys.path for item in stdpath: if item==mydir or not item: continue # skip if current dir. on Windows, or my own directory importer = pic.get(item) if importer is not None: loader = importer.find_module('site') if loader is not None: # This should actually reload the current module loader.load_module('site') break else: try: import imp # Avoid import loop in Python >= 3.3 stream, path, descr = imp.find_module('site',[item]) except ImportError: continue if stream is None: continue try: # This should actually reload the current module imp.load_module('site',stream,path,descr) finally: stream.close() break else: raise ImportError("Couldn't find the real 'site' module") #print "loaded", __file__ known_paths = dict([(makepath(item)[1],1) for item in sys.path]) # 2.2 comp oldpos = getattr(sys,'__egginsert',0) # save old insertion position sys.__egginsert = 0 # and reset the current one for item in PYTHONPATH: addsitedir(item) sys.__egginsert += oldpos # restore effective old position d, nd = makepath(stdpath[0]) insert_at = None new_path = [] for item in sys.path: p, np = makepath(item) if np==nd and insert_at is None: # We've hit the first 'system' path entry, so added entries go here insert_at = len(new_path) if np in known_paths or insert_at is None: new_path.append(item) else: # new path after the insert point, back-insert it new_path.insert(insert_at, item) insert_at += 1 sys.path[:] = new_path if __name__=='site': __boot() del __boot setuptools-20.7.0/setuptools/ssl_support.py0000664000175000017500000001766712702524020022070 0ustar travistravis00000000000000import os import socket import atexit import re from setuptools.extern.six.moves import urllib, http_client, map import pkg_resources from pkg_resources import ResolutionError, ExtractionError try: import ssl except ImportError: ssl = None __all__ = [ 'VerifyingHTTPSHandler', 'find_ca_bundle', 'is_available', 'cert_paths', 'opener_for' ] cert_paths = """ /etc/pki/tls/certs/ca-bundle.crt /etc/ssl/certs/ca-certificates.crt /usr/share/ssl/certs/ca-bundle.crt /usr/local/share/certs/ca-root.crt /etc/ssl/cert.pem /System/Library/OpenSSL/certs/cert.pem /usr/local/share/certs/ca-root-nss.crt """.strip().split() try: HTTPSHandler = urllib.request.HTTPSHandler HTTPSConnection = http_client.HTTPSConnection except AttributeError: HTTPSHandler = HTTPSConnection = object is_available = ssl is not None and object not in (HTTPSHandler, HTTPSConnection) try: from ssl import CertificateError, match_hostname except ImportError: try: from backports.ssl_match_hostname import CertificateError from backports.ssl_match_hostname import match_hostname except ImportError: CertificateError = None match_hostname = None if not CertificateError: class CertificateError(ValueError): pass if not match_hostname: def _dnsname_match(dn, hostname, max_wildcards=1): """Matching according to RFC 6125, section 6.4.3 http://tools.ietf.org/html/rfc6125#section-6.4.3 """ pats = [] if not dn: return False # Ported from python3-syntax: # leftmost, *remainder = dn.split(r'.') parts = dn.split(r'.') leftmost = parts[0] remainder = parts[1:] wildcards = leftmost.count('*') if wildcards > max_wildcards: # Issue #17980: avoid denials of service by refusing more # than one wildcard per fragment. A survey of established # policy among SSL implementations showed it to be a # reasonable choice. raise CertificateError( "too many wildcards in certificate DNS name: " + repr(dn)) # speed up common case w/o wildcards if not wildcards: return dn.lower() == hostname.lower() # RFC 6125, section 6.4.3, subitem 1. # The client SHOULD NOT attempt to match a presented identifier in which # the wildcard character comprises a label other than the left-most label. if leftmost == '*': # When '*' is a fragment by itself, it matches a non-empty dotless # fragment. pats.append('[^.]+') elif leftmost.startswith('xn--') or hostname.startswith('xn--'): # RFC 6125, section 6.4.3, subitem 3. # The client SHOULD NOT attempt to match a presented identifier # where the wildcard character is embedded within an A-label or # U-label of an internationalized domain name. pats.append(re.escape(leftmost)) else: # Otherwise, '*' matches any dotless string, e.g. www* pats.append(re.escape(leftmost).replace(r'\*', '[^.]*')) # add the remaining fragments, ignore any wildcards for frag in remainder: pats.append(re.escape(frag)) pat = re.compile(r'\A' + r'\.'.join(pats) + r'\Z', re.IGNORECASE) return pat.match(hostname) def match_hostname(cert, hostname): """Verify that *cert* (in decoded format as returned by SSLSocket.getpeercert()) matches the *hostname*. RFC 2818 and RFC 6125 rules are followed, but IP addresses are not accepted for *hostname*. CertificateError is raised on failure. On success, the function returns nothing. """ if not cert: raise ValueError("empty or no certificate") dnsnames = [] san = cert.get('subjectAltName', ()) for key, value in san: if key == 'DNS': if _dnsname_match(value, hostname): return dnsnames.append(value) if not dnsnames: # The subject is only checked when there is no dNSName entry # in subjectAltName for sub in cert.get('subject', ()): for key, value in sub: # XXX according to RFC 2818, the most specific Common Name # must be used. if key == 'commonName': if _dnsname_match(value, hostname): return dnsnames.append(value) if len(dnsnames) > 1: raise CertificateError("hostname %r " "doesn't match either of %s" % (hostname, ', '.join(map(repr, dnsnames)))) elif len(dnsnames) == 1: raise CertificateError("hostname %r " "doesn't match %r" % (hostname, dnsnames[0])) else: raise CertificateError("no appropriate commonName or " "subjectAltName fields were found") class VerifyingHTTPSHandler(HTTPSHandler): """Simple verifying handler: no auth, subclasses, timeouts, etc.""" def __init__(self, ca_bundle): self.ca_bundle = ca_bundle HTTPSHandler.__init__(self) def https_open(self, req): return self.do_open( lambda host, **kw: VerifyingHTTPSConn(host, self.ca_bundle, **kw), req ) class VerifyingHTTPSConn(HTTPSConnection): """Simple verifying connection: no auth, subclasses, timeouts, etc.""" def __init__(self, host, ca_bundle, **kw): HTTPSConnection.__init__(self, host, **kw) self.ca_bundle = ca_bundle def connect(self): sock = socket.create_connection( (self.host, self.port), getattr(self, 'source_address', None) ) # Handle the socket if a (proxy) tunnel is present if hasattr(self, '_tunnel') and getattr(self, '_tunnel_host', None): self.sock = sock self._tunnel() # http://bugs.python.org/issue7776: Python>=3.4.1 and >=2.7.7 # change self.host to mean the proxy server host when tunneling is # being used. Adapt, since we are interested in the destination # host for the match_hostname() comparison. actual_host = self._tunnel_host else: actual_host = self.host self.sock = ssl.wrap_socket( sock, cert_reqs=ssl.CERT_REQUIRED, ca_certs=self.ca_bundle ) try: match_hostname(self.sock.getpeercert(), actual_host) except CertificateError: self.sock.shutdown(socket.SHUT_RDWR) self.sock.close() raise def opener_for(ca_bundle=None): """Get a urlopen() replacement that uses ca_bundle for verification""" return urllib.request.build_opener( VerifyingHTTPSHandler(ca_bundle or find_ca_bundle()) ).open _wincerts = None def get_win_certfile(): global _wincerts if _wincerts is not None: return _wincerts.name try: from wincertstore import CertFile except ImportError: return None class MyCertFile(CertFile): def __init__(self, stores=(), certs=()): CertFile.__init__(self) for store in stores: self.addstore(store) self.addcerts(certs) atexit.register(self.close) def close(self): try: super(MyCertFile, self).close() except OSError: pass _wincerts = MyCertFile(stores=['CA', 'ROOT']) return _wincerts.name def find_ca_bundle(): """Return an existing CA bundle path, or None""" if os.name=='nt': return get_win_certfile() else: for cert_path in cert_paths: if os.path.isfile(cert_path): return cert_path try: return pkg_resources.resource_filename('certifi', 'cacert.pem') except (ImportError, ResolutionError, ExtractionError): return None setuptools-20.7.0/setuptools/unicode_utils.py0000664000175000017500000000174312702524020022325 0ustar travistravis00000000000000import unicodedata import sys from setuptools.extern import six # HFS Plus uses decomposed UTF-8 def decompose(path): if isinstance(path, six.text_type): return unicodedata.normalize('NFD', path) try: path = path.decode('utf-8') path = unicodedata.normalize('NFD', path) path = path.encode('utf-8') except UnicodeError: pass # Not UTF-8 return path def filesys_decode(path): """ Ensure that the given path is decoded, NONE when no expected encoding works """ if isinstance(path, six.text_type): return path fs_enc = sys.getfilesystemencoding() or 'utf-8' candidates = fs_enc, 'utf-8' for enc in candidates: try: return path.decode(enc) except UnicodeDecodeError: continue def try_encode(string, enc): "turn unicode encoding into a functional routine" try: return string.encode(enc) except UnicodeEncodeError: return None setuptools-20.7.0/setuptools/utils.py0000664000175000017500000000044512702524020020615 0ustar travistravis00000000000000import os import os.path def cs_path_exists(fspath): if not os.path.exists(fspath): return False # make absolute so we always have a directory abspath = os.path.abspath(fspath) directory, filename = os.path.split(abspath) return filename in os.listdir(directory)setuptools-20.7.0/setuptools/version.py0000664000175000017500000000020412702524020021133 0ustar travistravis00000000000000import pkg_resources try: __version__ = pkg_resources.require('setuptools')[0].version except Exception: __version__ = 'unknown' setuptools-20.7.0/setuptools/windows_support.py0000664000175000017500000000131212702524020022735 0ustar travistravis00000000000000import platform import ctypes def windows_only(func): if platform.system() != 'Windows': return lambda *args, **kwargs: None return func @windows_only def hide_file(path): """ Set the hidden attribute on a file or directory. From http://stackoverflow.com/questions/19622133/ `path` must be text. """ __import__('ctypes.wintypes') SetFileAttributes = ctypes.windll.kernel32.SetFileAttributesW SetFileAttributes.argtypes = ctypes.wintypes.LPWSTR, ctypes.wintypes.DWORD SetFileAttributes.restype = ctypes.wintypes.BOOL FILE_ATTRIBUTE_HIDDEN = 0x02 ret = SetFileAttributes(path, FILE_ATTRIBUTE_HIDDEN) if not ret: raise ctypes.WinError() setuptools-20.7.0/setuptools.egg-info/0000775000175000017500000000000012702524134020600 5ustar travistravis00000000000000setuptools-20.7.0/setuptools.egg-info/PKG-INFO0000664000175000017500000003114212702524134021676 0ustar travistravis00000000000000Metadata-Version: 1.1 Name: setuptools Version: 20.7.0 Summary: Easily download, build, install, upgrade, and uninstall Python packages Home-page: https://github.com/pypa/setuptools Author: Python Packaging Authority Author-email: distutils-sig@python.org License: UNKNOWN Description: =============================== Installing and Using Setuptools =============================== .. contents:: **Table of Contents** `Change History `_. ------------------------- Installation Instructions ------------------------- The recommended way to bootstrap setuptools on any system is to download `ez_setup.py`_ and run it using the target Python environment. Different operating systems have different recommended techniques to accomplish this basic routine, so below are some examples to get you started. Setuptools requires Python 2.6 or later. To install setuptools on Python 2.4 or Python 2.5, use the `bootstrap script for Setuptools 1.x `_. The link provided to ez_setup.py is a bookmark to bootstrap script for the latest known stable release. .. _ez_setup.py: https://bootstrap.pypa.io/ez_setup.py Windows (Powershell 3 or later) =============================== For best results, uninstall previous versions FIRST (see `Uninstalling`_). Using Windows 8 (which includes PowerShell 3) or earlier versions of Windows with PowerShell 3 installed, it's possible to install with one simple Powershell command. Start up Powershell and paste this command:: > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | python - You must start the Powershell with Administrative privileges or you may choose to install a user-local installation:: > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | python - --user If you have Python 3.3 or later, you can use the ``py`` command to install to different Python versions. For example, to install to Python 3.3 if you have Python 2.7 installed:: > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | py -3 - The recommended way to install setuptools on Windows is to download `ez_setup.py`_ and run it. The script will download the appropriate distribution file and install it for you. Once installation is complete, you will find an ``easy_install`` program in your Python ``Scripts`` subdirectory. For simple invocation and best results, add this directory to your ``PATH`` environment variable, if it is not already present. If you did a user-local install, the ``Scripts`` subdirectory is ``$env:APPDATA\Python\Scripts``. Windows (simplified) ==================== For Windows without PowerShell 3 or for installation without a command-line, download `ez_setup.py`_ using your preferred web browser or other technique and "run" that file. Unix (wget) =========== Most Linux distributions come with wget. Download `ez_setup.py`_ and run it using the target Python version. The script will download the appropriate version and install it for you:: > wget https://bootstrap.pypa.io/ez_setup.py -O - | python Note that you will may need to invoke the command with superuser privileges to install to the system Python:: > wget https://bootstrap.pypa.io/ez_setup.py -O - | sudo python Alternatively, Setuptools may be installed to a user-local path:: > wget https://bootstrap.pypa.io/ez_setup.py -O - | python - --user Note that on some older systems (noted on Debian 6 and CentOS 5 installations), `wget` may refuse to download `ez_setup.py`, complaining that the certificate common name `*.c.ssl.fastly.net` does not match the host name `bootstrap.pypa.io`. In addition, the `ez_setup.py` script may then encounter similar problems using `wget` internally to download `setuptools-x.y.zip`, complaining that the certificate common name of `www.python.org` does not match the host name `pypi.python.org`. Those are known issues, related to a bug in the older versions of `wget` (see `Issue 59 `_). If you happen to encounter them, install Setuptools as follows:: > wget --no-check-certificate https://bootstrap.pypa.io/ez_setup.py > python ez_setup.py --insecure Unix including Mac OS X (curl) ============================== If your system has curl installed, follow the ``wget`` instructions but replace ``wget`` with ``curl`` and ``-O`` with ``-o``. For example:: > curl https://bootstrap.pypa.io/ez_setup.py -o - | python Advanced Installation ===================== For more advanced installation options, such as installing to custom locations or prefixes, download and extract the source tarball from `Setuptools on PyPI `_ and run setup.py with any supported distutils and Setuptools options. For example:: setuptools-x.x$ python setup.py install --prefix=/opt/setuptools Use ``--help`` to get a full options list, but we recommend consulting the `EasyInstall manual`_ for detailed instructions, especially `the section on custom installation locations`_. .. _EasyInstall manual: https://pythonhosted.org/setuptools/EasyInstall .. _the section on custom installation locations: https://pythonhosted.org/setuptools/EasyInstall#custom-installation-locations Downloads ========= All setuptools downloads can be found at `the project's home page in the Python Package Index`_. Scroll to the very bottom of the page to find the links. .. _the project's home page in the Python Package Index: https://pypi.python.org/pypi/setuptools In addition to the PyPI downloads, the development version of ``setuptools`` is available from the `Bitbucket repo`_, and in-development versions of the `0.6 branch`_ are available as well. .. _Bitbucket repo: https://bitbucket.org/pypa/setuptools/get/default.tar.gz#egg=setuptools-dev .. _0.6 branch: http://svn.python.org/projects/sandbox/branches/setuptools-0.6/#egg=setuptools-dev06 Uninstalling ============ On Windows, if Setuptools was installed using an ``.exe`` or ``.msi`` installer, simply use the uninstall feature of "Add/Remove Programs" in the Control Panel. Otherwise, to uninstall Setuptools or Distribute, regardless of the Python version, delete all ``setuptools*`` and ``distribute*`` files and directories from your system's ``site-packages`` directory (and any other ``sys.path`` directories) FIRST. If you are upgrading or otherwise plan to re-install Setuptools or Distribute, nothing further needs to be done. If you want to completely remove Setuptools, you may also want to remove the 'easy_install' and 'easy_install-x.x' scripts and associated executables installed to the Python scripts directory. -------------------------------- Using Setuptools and EasyInstall -------------------------------- Here are some of the available manuals, tutorials, and other resources for learning about Setuptools, Python Eggs, and EasyInstall: * `The EasyInstall user's guide and reference manual`_ * `The setuptools Developer's Guide`_ * `The pkg_resources API reference`_ * `The Internal Structure of Python Eggs`_ Questions, comments, and bug reports should be directed to the `distutils-sig mailing list`_. If you have written (or know of) any tutorials, documentation, plug-ins, or other resources for setuptools users, please let us know about them there, so this reference list can be updated. If you have working, *tested* patches to correct problems or add features, you may submit them to the `setuptools bug tracker`_. .. _setuptools bug tracker: https://github.com/pypa/setuptools/issues .. _The Internal Structure of Python Eggs: https://pythonhosted.org/setuptools/formats.html .. _The setuptools Developer's Guide: https://pythonhosted.org/setuptools/setuptools.html .. _The pkg_resources API reference: https://pythonhosted.org/setuptools/pkg_resources.html .. _The EasyInstall user's guide and reference manual: https://pythonhosted.org/setuptools/easy_install.html .. _distutils-sig mailing list: http://mail.python.org/pipermail/distutils-sig/ ------- Credits ------- * The original design for the ``.egg`` format and the ``pkg_resources`` API was co-created by Phillip Eby and Bob Ippolito. Bob also implemented the first version of ``pkg_resources``, and supplied the OS X operating system version compatibility algorithm. * Ian Bicking implemented many early "creature comfort" features of easy_install, including support for downloading via Sourceforge and Subversion repositories. Ian's comments on the Web-SIG about WSGI application deployment also inspired the concept of "entry points" in eggs, and he has given talks at PyCon and elsewhere to inform and educate the community about eggs and setuptools. * Jim Fulton contributed time and effort to build automated tests of various aspects of ``easy_install``, and supplied the doctests for the command-line ``.exe`` wrappers on Windows. * Phillip J. Eby is the seminal author of setuptools, and first proposed the idea of an importable binary distribution format for Python application plug-ins. * Significant parts of the implementation of setuptools were funded by the Open Source Applications Foundation, to provide a plug-in infrastructure for the Chandler PIM application. In addition, many OSAF staffers (such as Mike "Code Bear" Taylor) contributed their time and stress as guinea pigs for the use of eggs and setuptools, even before eggs were "cool". (Thanks, guys!) * Tarek Ziadé is the principal author of the Distribute fork, which re-invigorated the community on the project, encouraged renewed innovation, and addressed many defects. * Since the merge with Distribute, Jason R. Coombs is the maintainer of setuptools. The project is maintained in coordination with the Python Packaging Authority (PyPA) and the larger Python community. .. _files: --------------- Code of Conduct --------------- Everyone interacting in the setuptools project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_. .. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/ Keywords: CPAN PyPI distutils eggs package management Platform: UNKNOWN Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Operating System :: OS Independent Classifier: Programming Language :: Python :: 2.6 Classifier: Programming Language :: Python :: 2.7 Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.3 Classifier: Programming Language :: Python :: 3.4 Classifier: Programming Language :: Python :: 3.5 Classifier: Topic :: Software Development :: Libraries :: Python Modules Classifier: Topic :: System :: Archiving :: Packaging Classifier: Topic :: System :: Systems Administration Classifier: Topic :: Utilities setuptools-20.7.0/setuptools.egg-info/SOURCES.txt0000664000175000017500000000767412702524134022502 0ustar travistravis00000000000000MANIFEST.in README.rst bootstrap.py conftest.py easy_install.py ez_setup.py launcher.c msvc-build-launcher.cmd pavement.py pytest.ini setup.cfg setup.py docs/Makefile docs/conf.py docs/developer-guide.txt docs/development.txt docs/easy_install.txt docs/formats.txt docs/history.txt docs/index.txt docs/pkg_resources.txt docs/python3.txt docs/releases.txt docs/roadmap.txt docs/setuptools.txt docs/_templates/indexsidebar.html docs/_theme/nature/theme.conf docs/_theme/nature/static/nature.css_t docs/_theme/nature/static/pygments.css pkg_resources/__init__.py pkg_resources/api_tests.txt pkg_resources/_vendor/__init__.py pkg_resources/_vendor/pyparsing.py pkg_resources/_vendor/six.py pkg_resources/_vendor/vendored.txt pkg_resources/_vendor/packaging/__about__.py pkg_resources/_vendor/packaging/__init__.py pkg_resources/_vendor/packaging/_compat.py pkg_resources/_vendor/packaging/_structures.py pkg_resources/_vendor/packaging/markers.py pkg_resources/_vendor/packaging/requirements.py pkg_resources/_vendor/packaging/specifiers.py pkg_resources/_vendor/packaging/utils.py pkg_resources/_vendor/packaging/version.py pkg_resources/extern/__init__.py pkg_resources/tests/__init__.py pkg_resources/tests/test_markers.py pkg_resources/tests/test_pkg_resources.py pkg_resources/tests/test_resources.py setuptools/__init__.py setuptools/archive_util.py setuptools/cli-32.exe setuptools/cli-64.exe setuptools/cli-arm-32.exe setuptools/cli.exe setuptools/depends.py setuptools/dist.py setuptools/extension.py setuptools/gui-32.exe setuptools/gui-64.exe setuptools/gui-arm-32.exe setuptools/gui.exe setuptools/launch.py setuptools/lib2to3_ex.py setuptools/msvc9_support.py setuptools/package_index.py setuptools/py26compat.py setuptools/py27compat.py setuptools/py31compat.py setuptools/sandbox.py setuptools/script (dev).tmpl setuptools/script.tmpl setuptools/site-patch.py setuptools/ssl_support.py setuptools/unicode_utils.py setuptools/utils.py setuptools/version.py setuptools/windows_support.py setuptools.egg-info/PKG-INFO setuptools.egg-info/SOURCES.txt setuptools.egg-info/dependency_links.txt setuptools.egg-info/entry_points.txt setuptools.egg-info/requires.txt setuptools.egg-info/top_level.txt setuptools.egg-info/zip-safe setuptools/command/__init__.py setuptools/command/alias.py setuptools/command/bdist_egg.py setuptools/command/bdist_rpm.py setuptools/command/bdist_wininst.py setuptools/command/build_ext.py setuptools/command/build_py.py setuptools/command/develop.py setuptools/command/easy_install.py setuptools/command/egg_info.py setuptools/command/install.py setuptools/command/install_egg_info.py setuptools/command/install_lib.py setuptools/command/install_scripts.py setuptools/command/launcher manifest.xml setuptools/command/register.py setuptools/command/rotate.py setuptools/command/saveopts.py setuptools/command/sdist.py setuptools/command/setopt.py setuptools/command/test.py setuptools/command/upload.py setuptools/command/upload_docs.py setuptools/extern/__init__.py setuptools/tests/__init__.py setuptools/tests/contexts.py setuptools/tests/environment.py setuptools/tests/files.py setuptools/tests/fixtures.py setuptools/tests/py26compat.py setuptools/tests/script-with-bom.py setuptools/tests/server.py setuptools/tests/test_bdist_egg.py setuptools/tests/test_build_ext.py setuptools/tests/test_develop.py setuptools/tests/test_dist_info.py setuptools/tests/test_easy_install.py setuptools/tests/test_egg_info.py setuptools/tests/test_find_packages.py setuptools/tests/test_integration.py setuptools/tests/test_msvc9compiler.py setuptools/tests/test_packageindex.py setuptools/tests/test_sandbox.py setuptools/tests/test_sdist.py setuptools/tests/test_setuptools.py setuptools/tests/test_test.py setuptools/tests/test_unicode_utils.py setuptools/tests/test_upload_docs.py setuptools/tests/test_windows_wrappers.py setuptools/tests/textwrap.py setuptools/tests/indexes/test_links_priority/external.html setuptools/tests/indexes/test_links_priority/simple/foobar/index.html tests/manual_test.pysetuptools-20.7.0/setuptools.egg-info/dependency_links.txt0000664000175000017500000000034212702524134024656 0ustar travistravis00000000000000https://pypi.python.org/packages/source/c/certifi/certifi-2015.11.20.tar.gz#md5=25134646672c695c1ff1593c2dd75d08 https://pypi.python.org/packages/source/w/wincertstore/wincertstore-0.2.zip#md5=ae728f2f007185648d0c7a8679b361e2 setuptools-20.7.0/setuptools.egg-info/entry_points.txt0000664000175000017500000000542312702524134024102 0ustar travistravis00000000000000[console_scripts] easy_install = setuptools.command.easy_install:main easy_install-2.7 = setuptools.command.easy_install:main [distutils.commands] alias = setuptools.command.alias:alias bdist_egg = setuptools.command.bdist_egg:bdist_egg bdist_rpm = setuptools.command.bdist_rpm:bdist_rpm bdist_wininst = setuptools.command.bdist_wininst:bdist_wininst build_ext = setuptools.command.build_ext:build_ext build_py = setuptools.command.build_py:build_py develop = setuptools.command.develop:develop easy_install = setuptools.command.easy_install:easy_install egg_info = setuptools.command.egg_info:egg_info install = setuptools.command.install:install install_egg_info = setuptools.command.install_egg_info:install_egg_info install_lib = setuptools.command.install_lib:install_lib install_scripts = setuptools.command.install_scripts:install_scripts register = setuptools.command.register:register rotate = setuptools.command.rotate:rotate saveopts = setuptools.command.saveopts:saveopts sdist = setuptools.command.sdist:sdist setopt = setuptools.command.setopt:setopt test = setuptools.command.test:test upload = setuptools.command.upload:upload upload_docs = setuptools.command.upload_docs:upload_docs [distutils.setup_keywords] convert_2to3_doctests = setuptools.dist:assert_string_list dependency_links = setuptools.dist:assert_string_list eager_resources = setuptools.dist:assert_string_list entry_points = setuptools.dist:check_entry_points exclude_package_data = setuptools.dist:check_package_data extras_require = setuptools.dist:check_extras include_package_data = setuptools.dist:assert_bool install_requires = setuptools.dist:check_requirements namespace_packages = setuptools.dist:check_nsp package_data = setuptools.dist:check_package_data packages = setuptools.dist:check_packages setup_requires = setuptools.dist:check_requirements test_loader = setuptools.dist:check_importable test_runner = setuptools.dist:check_importable test_suite = setuptools.dist:check_test_suite tests_require = setuptools.dist:check_requirements use_2to3 = setuptools.dist:assert_bool use_2to3_exclude_fixers = setuptools.dist:assert_string_list use_2to3_fixers = setuptools.dist:assert_string_list zip_safe = setuptools.dist:assert_bool [egg_info.writers] PKG-INFO = setuptools.command.egg_info:write_pkg_info dependency_links.txt = setuptools.command.egg_info:overwrite_arg depends.txt = setuptools.command.egg_info:warn_depends_obsolete eager_resources.txt = setuptools.command.egg_info:overwrite_arg entry_points.txt = setuptools.command.egg_info:write_entries namespace_packages.txt = setuptools.command.egg_info:overwrite_arg requires.txt = setuptools.command.egg_info:write_requirements top_level.txt = setuptools.command.egg_info:write_toplevel_names [setuptools.installation] eggsecutable = setuptools.command.easy_install:bootstrap setuptools-20.7.0/setuptools.egg-info/requires.txt0000664000175000017500000000011412702524134023174 0ustar travistravis00000000000000 [certs] certifi==2015.11.20 [ssl:sys_platform=='win32'] wincertstore==0.2 setuptools-20.7.0/setuptools.egg-info/top_level.txt0000664000175000017500000000004612702524134023332 0ustar travistravis00000000000000easy_install pkg_resources setuptools setuptools-20.7.0/setuptools.egg-info/zip-safe0000664000175000017500000000000112702524027022231 0ustar travistravis00000000000000 setuptools-20.7.0/tests/0000775000175000017500000000000012702524134016027 5ustar travistravis00000000000000setuptools-20.7.0/tests/manual_test.py0000664000175000017500000000447712702524020020723 0ustar travistravis00000000000000#!/usr/bin/env python import sys import os import shutil import tempfile import subprocess from distutils.command.install import INSTALL_SCHEMES from string import Template from six.moves import urllib def _system_call(*args): assert subprocess.call(args) == 0 def tempdir(func): def _tempdir(*args, **kwargs): test_dir = tempfile.mkdtemp() old_dir = os.getcwd() os.chdir(test_dir) try: return func(*args, **kwargs) finally: os.chdir(old_dir) shutil.rmtree(test_dir) return _tempdir SIMPLE_BUILDOUT = """\ [buildout] parts = eggs [eggs] recipe = zc.recipe.egg eggs = extensions """ BOOTSTRAP = 'http://downloads.buildout.org/1/bootstrap.py' PYVER = sys.version.split()[0][:3] _VARS = {'base': '.', 'py_version_short': PYVER} scheme = 'nt' if sys.platform == 'win32' else 'unix_prefix' PURELIB = INSTALL_SCHEMES[scheme]['purelib'] @tempdir def test_virtualenv(): """virtualenv with setuptools""" purelib = os.path.abspath(Template(PURELIB).substitute(**_VARS)) _system_call('virtualenv', '--no-site-packages', '.') _system_call('bin/easy_install', 'setuptools==dev') # linux specific site_pkg = os.listdir(purelib) site_pkg.sort() assert 'setuptools' in site_pkg[0] easy_install = os.path.join(purelib, 'easy-install.pth') with open(easy_install) as f: res = f.read() assert 'setuptools' in res @tempdir def test_full(): """virtualenv + pip + buildout""" _system_call('virtualenv', '--no-site-packages', '.') _system_call('bin/easy_install', '-q', 'setuptools==dev') _system_call('bin/easy_install', '-qU', 'setuptools==dev') _system_call('bin/easy_install', '-q', 'pip') _system_call('bin/pip', 'install', '-q', 'zc.buildout') with open('buildout.cfg', 'w') as f: f.write(SIMPLE_BUILDOUT) with open('bootstrap.py', 'w') as f: f.write(urllib.request.urlopen(BOOTSTRAP).read()) _system_call('bin/python', 'bootstrap.py') _system_call('bin/buildout', '-q') eggs = os.listdir('eggs') eggs.sort() assert len(eggs) == 3 assert eggs[1].startswith('setuptools') del eggs[1] assert eggs == ['extensions-0.3-py2.6.egg', 'zc.recipe.egg-1.2.2-py2.6.egg'] if __name__ == '__main__': test_virtualenv() test_full() setuptools-20.7.0/MANIFEST.in0000664000175000017500000000066012702524020016417 0ustar travistravis00000000000000recursive-include setuptools *.py *.exe *.xml recursive-include tests *.py recursive-include setuptools/tests *.html recursive-include docs *.py *.txt *.conf *.css *.css_t Makefile indexsidebar.html recursive-include _markerlib *.py recursive-include setuptools/_vendor * recursive-include pkg_resources *.py *.txt include *.py include *.txt include MANIFEST.in include launcher.c include msvc-build-launcher.cmd include pytest.ini setuptools-20.7.0/README.rst0000775000175000017500000002332712702524020016360 0ustar travistravis00000000000000=============================== Installing and Using Setuptools =============================== .. contents:: **Table of Contents** `Change History `_. ------------------------- Installation Instructions ------------------------- The recommended way to bootstrap setuptools on any system is to download `ez_setup.py`_ and run it using the target Python environment. Different operating systems have different recommended techniques to accomplish this basic routine, so below are some examples to get you started. Setuptools requires Python 2.6 or later. To install setuptools on Python 2.4 or Python 2.5, use the `bootstrap script for Setuptools 1.x `_. The link provided to ez_setup.py is a bookmark to bootstrap script for the latest known stable release. .. _ez_setup.py: https://bootstrap.pypa.io/ez_setup.py Windows (Powershell 3 or later) =============================== For best results, uninstall previous versions FIRST (see `Uninstalling`_). Using Windows 8 (which includes PowerShell 3) or earlier versions of Windows with PowerShell 3 installed, it's possible to install with one simple Powershell command. Start up Powershell and paste this command:: > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | python - You must start the Powershell with Administrative privileges or you may choose to install a user-local installation:: > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | python - --user If you have Python 3.3 or later, you can use the ``py`` command to install to different Python versions. For example, to install to Python 3.3 if you have Python 2.7 installed:: > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | py -3 - The recommended way to install setuptools on Windows is to download `ez_setup.py`_ and run it. The script will download the appropriate distribution file and install it for you. Once installation is complete, you will find an ``easy_install`` program in your Python ``Scripts`` subdirectory. For simple invocation and best results, add this directory to your ``PATH`` environment variable, if it is not already present. If you did a user-local install, the ``Scripts`` subdirectory is ``$env:APPDATA\Python\Scripts``. Windows (simplified) ==================== For Windows without PowerShell 3 or for installation without a command-line, download `ez_setup.py`_ using your preferred web browser or other technique and "run" that file. Unix (wget) =========== Most Linux distributions come with wget. Download `ez_setup.py`_ and run it using the target Python version. The script will download the appropriate version and install it for you:: > wget https://bootstrap.pypa.io/ez_setup.py -O - | python Note that you will may need to invoke the command with superuser privileges to install to the system Python:: > wget https://bootstrap.pypa.io/ez_setup.py -O - | sudo python Alternatively, Setuptools may be installed to a user-local path:: > wget https://bootstrap.pypa.io/ez_setup.py -O - | python - --user Note that on some older systems (noted on Debian 6 and CentOS 5 installations), `wget` may refuse to download `ez_setup.py`, complaining that the certificate common name `*.c.ssl.fastly.net` does not match the host name `bootstrap.pypa.io`. In addition, the `ez_setup.py` script may then encounter similar problems using `wget` internally to download `setuptools-x.y.zip`, complaining that the certificate common name of `www.python.org` does not match the host name `pypi.python.org`. Those are known issues, related to a bug in the older versions of `wget` (see `Issue 59 `_). If you happen to encounter them, install Setuptools as follows:: > wget --no-check-certificate https://bootstrap.pypa.io/ez_setup.py > python ez_setup.py --insecure Unix including Mac OS X (curl) ============================== If your system has curl installed, follow the ``wget`` instructions but replace ``wget`` with ``curl`` and ``-O`` with ``-o``. For example:: > curl https://bootstrap.pypa.io/ez_setup.py -o - | python Advanced Installation ===================== For more advanced installation options, such as installing to custom locations or prefixes, download and extract the source tarball from `Setuptools on PyPI `_ and run setup.py with any supported distutils and Setuptools options. For example:: setuptools-x.x$ python setup.py install --prefix=/opt/setuptools Use ``--help`` to get a full options list, but we recommend consulting the `EasyInstall manual`_ for detailed instructions, especially `the section on custom installation locations`_. .. _EasyInstall manual: https://pythonhosted.org/setuptools/EasyInstall .. _the section on custom installation locations: https://pythonhosted.org/setuptools/EasyInstall#custom-installation-locations Downloads ========= All setuptools downloads can be found at `the project's home page in the Python Package Index`_. Scroll to the very bottom of the page to find the links. .. _the project's home page in the Python Package Index: https://pypi.python.org/pypi/setuptools In addition to the PyPI downloads, the development version of ``setuptools`` is available from the `Bitbucket repo`_, and in-development versions of the `0.6 branch`_ are available as well. .. _Bitbucket repo: https://bitbucket.org/pypa/setuptools/get/default.tar.gz#egg=setuptools-dev .. _0.6 branch: http://svn.python.org/projects/sandbox/branches/setuptools-0.6/#egg=setuptools-dev06 Uninstalling ============ On Windows, if Setuptools was installed using an ``.exe`` or ``.msi`` installer, simply use the uninstall feature of "Add/Remove Programs" in the Control Panel. Otherwise, to uninstall Setuptools or Distribute, regardless of the Python version, delete all ``setuptools*`` and ``distribute*`` files and directories from your system's ``site-packages`` directory (and any other ``sys.path`` directories) FIRST. If you are upgrading or otherwise plan to re-install Setuptools or Distribute, nothing further needs to be done. If you want to completely remove Setuptools, you may also want to remove the 'easy_install' and 'easy_install-x.x' scripts and associated executables installed to the Python scripts directory. -------------------------------- Using Setuptools and EasyInstall -------------------------------- Here are some of the available manuals, tutorials, and other resources for learning about Setuptools, Python Eggs, and EasyInstall: * `The EasyInstall user's guide and reference manual`_ * `The setuptools Developer's Guide`_ * `The pkg_resources API reference`_ * `The Internal Structure of Python Eggs`_ Questions, comments, and bug reports should be directed to the `distutils-sig mailing list`_. If you have written (or know of) any tutorials, documentation, plug-ins, or other resources for setuptools users, please let us know about them there, so this reference list can be updated. If you have working, *tested* patches to correct problems or add features, you may submit them to the `setuptools bug tracker`_. .. _setuptools bug tracker: https://github.com/pypa/setuptools/issues .. _The Internal Structure of Python Eggs: https://pythonhosted.org/setuptools/formats.html .. _The setuptools Developer's Guide: https://pythonhosted.org/setuptools/setuptools.html .. _The pkg_resources API reference: https://pythonhosted.org/setuptools/pkg_resources.html .. _The EasyInstall user's guide and reference manual: https://pythonhosted.org/setuptools/easy_install.html .. _distutils-sig mailing list: http://mail.python.org/pipermail/distutils-sig/ ------- Credits ------- * The original design for the ``.egg`` format and the ``pkg_resources`` API was co-created by Phillip Eby and Bob Ippolito. Bob also implemented the first version of ``pkg_resources``, and supplied the OS X operating system version compatibility algorithm. * Ian Bicking implemented many early "creature comfort" features of easy_install, including support for downloading via Sourceforge and Subversion repositories. Ian's comments on the Web-SIG about WSGI application deployment also inspired the concept of "entry points" in eggs, and he has given talks at PyCon and elsewhere to inform and educate the community about eggs and setuptools. * Jim Fulton contributed time and effort to build automated tests of various aspects of ``easy_install``, and supplied the doctests for the command-line ``.exe`` wrappers on Windows. * Phillip J. Eby is the seminal author of setuptools, and first proposed the idea of an importable binary distribution format for Python application plug-ins. * Significant parts of the implementation of setuptools were funded by the Open Source Applications Foundation, to provide a plug-in infrastructure for the Chandler PIM application. In addition, many OSAF staffers (such as Mike "Code Bear" Taylor) contributed their time and stress as guinea pigs for the use of eggs and setuptools, even before eggs were "cool". (Thanks, guys!) * Tarek Ziadé is the principal author of the Distribute fork, which re-invigorated the community on the project, encouraged renewed innovation, and addressed many defects. * Since the merge with Distribute, Jason R. Coombs is the maintainer of setuptools. The project is maintained in coordination with the Python Packaging Authority (PyPA) and the larger Python community. .. _files: --------------- Code of Conduct --------------- Everyone interacting in the setuptools project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_. .. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/ setuptools-20.7.0/bootstrap.py0000664000175000017500000000307112702524020017247 0ustar travistravis00000000000000""" If setuptools is not already installed in the environment, it's not possible to invoke setuptools' own commands. This routine will bootstrap this local environment by creating a minimal egg-info directory and then invoking the egg-info command to flesh out the egg-info directory. """ import os import sys import textwrap import subprocess minimal_egg_info = textwrap.dedent(""" [distutils.commands] egg_info = setuptools.command.egg_info:egg_info [distutils.setup_keywords] include_package_data = setuptools.dist:assert_bool install_requires = setuptools.dist:check_requirements extras_require = setuptools.dist:check_extras entry_points = setuptools.dist:check_entry_points [egg_info.writers] dependency_links.txt = setuptools.command.egg_info:overwrite_arg entry_points.txt = setuptools.command.egg_info:write_entries requires.txt = setuptools.command.egg_info:write_requirements """) def ensure_egg_info(): if os.path.exists('setuptools.egg-info'): return print("adding minimal entry_points") build_egg_info() def build_egg_info(): """ Build a minimal egg-info, enough to invoke egg_info """ os.mkdir('setuptools.egg-info') with open('setuptools.egg-info/entry_points.txt', 'w') as ep: ep.write(minimal_egg_info) def run_egg_info(): cmd = [sys.executable, 'setup.py', 'egg_info'] print("Regenerating egg_info") subprocess.check_call(cmd) print("...and again.") subprocess.check_call(cmd) if __name__ == '__main__': ensure_egg_info() run_egg_info() setuptools-20.7.0/conftest.py0000664000175000017500000000005512702524020017056 0ustar travistravis00000000000000pytest_plugins = 'setuptools.tests.fixtures' setuptools-20.7.0/easy_install.py0000775000175000017500000000017612702524020017727 0ustar travistravis00000000000000"""Run the EasyInstall command""" if __name__ == '__main__': from setuptools.command.easy_install import main main() setuptools-20.7.0/ez_setup.py0000664000175000017500000002765012702524020017101 0ustar travistravis00000000000000#!/usr/bin/env python """ Setuptools bootstrapping installer. Run this script to install or upgrade setuptools. """ import os import shutil import sys import tempfile import zipfile import optparse import subprocess import platform import textwrap import contextlib import json import codecs from distutils import log try: from urllib.request import urlopen except ImportError: from urllib2 import urlopen try: from site import USER_SITE except ImportError: USER_SITE = None LATEST = object() DEFAULT_VERSION = LATEST DEFAULT_URL = "https://pypi.python.org/packages/source/s/setuptools/" DEFAULT_SAVE_DIR = os.curdir def _python_cmd(*args): """ Execute a command. Return True if the command succeeded. """ args = (sys.executable,) + args return subprocess.call(args) == 0 def _install(archive_filename, install_args=()): """Install Setuptools.""" with archive_context(archive_filename): # installing log.warn('Installing Setuptools') if not _python_cmd('setup.py', 'install', *install_args): log.warn('Something went wrong during the installation.') log.warn('See the error message above.') # exitcode will be 2 return 2 def _build_egg(egg, archive_filename, to_dir): """Build Setuptools egg.""" with archive_context(archive_filename): # building an egg log.warn('Building a Setuptools egg in %s', to_dir) _python_cmd('setup.py', '-q', 'bdist_egg', '--dist-dir', to_dir) # returning the result log.warn(egg) if not os.path.exists(egg): raise IOError('Could not build the egg.') class ContextualZipFile(zipfile.ZipFile): """Supplement ZipFile class to support context manager for Python 2.6.""" def __enter__(self): return self def __exit__(self, type, value, traceback): self.close() def __new__(cls, *args, **kwargs): """Construct a ZipFile or ContextualZipFile as appropriate.""" if hasattr(zipfile.ZipFile, '__exit__'): return zipfile.ZipFile(*args, **kwargs) return super(ContextualZipFile, cls).__new__(cls) @contextlib.contextmanager def archive_context(filename): """ Unzip filename to a temporary directory, set to the cwd. The unzipped target is cleaned up after. """ tmpdir = tempfile.mkdtemp() log.warn('Extracting in %s', tmpdir) old_wd = os.getcwd() try: os.chdir(tmpdir) with ContextualZipFile(filename) as archive: archive.extractall() # going in the directory subdir = os.path.join(tmpdir, os.listdir(tmpdir)[0]) os.chdir(subdir) log.warn('Now working in %s', subdir) yield finally: os.chdir(old_wd) shutil.rmtree(tmpdir) def _do_download(version, download_base, to_dir, download_delay): """Download Setuptools.""" egg = os.path.join(to_dir, 'setuptools-%s-py%d.%d.egg' % (version, sys.version_info[0], sys.version_info[1])) if not os.path.exists(egg): archive = download_setuptools(version, download_base, to_dir, download_delay) _build_egg(egg, archive, to_dir) sys.path.insert(0, egg) # Remove previously-imported pkg_resources if present (see # https://bitbucket.org/pypa/setuptools/pull-request/7/ for details). if 'pkg_resources' in sys.modules: _unload_pkg_resources() import setuptools setuptools.bootstrap_install_from = egg def use_setuptools( version=DEFAULT_VERSION, download_base=DEFAULT_URL, to_dir=DEFAULT_SAVE_DIR, download_delay=15): """ Ensure that a setuptools version is installed. Return None. Raise SystemExit if the requested version or later cannot be installed. """ version = _resolve_version(version) to_dir = os.path.abspath(to_dir) # prior to importing, capture the module state for # representative modules. rep_modules = 'pkg_resources', 'setuptools' imported = set(sys.modules).intersection(rep_modules) try: import pkg_resources pkg_resources.require("setuptools>=" + version) # a suitable version is already installed return except ImportError: # pkg_resources not available; setuptools is not installed; download pass except pkg_resources.DistributionNotFound: # no version of setuptools was found; allow download pass except pkg_resources.VersionConflict as VC_err: if imported: _conflict_bail(VC_err, version) # otherwise, unload pkg_resources to allow the downloaded version to # take precedence. del pkg_resources _unload_pkg_resources() return _do_download(version, download_base, to_dir, download_delay) def _conflict_bail(VC_err, version): """ Setuptools was imported prior to invocation, so it is unsafe to unload it. Bail out. """ conflict_tmpl = textwrap.dedent(""" The required version of setuptools (>={version}) is not available, and can't be installed while this script is running. Please install a more recent version first, using 'easy_install -U setuptools'. (Currently using {VC_err.args[0]!r}) """) msg = conflict_tmpl.format(**locals()) sys.stderr.write(msg) sys.exit(2) def _unload_pkg_resources(): sys.meta_path = [importer for importer in sys.meta_path if importer.__class__.__module__ != 'pkg_resources.extern'] del_modules = [ name for name in sys.modules if name.startswith('pkg_resources') ] for mod_name in del_modules: del sys.modules[mod_name] def _clean_check(cmd, target): """ Run the command to download target. If the command fails, clean up before re-raising the error. """ try: subprocess.check_call(cmd) except subprocess.CalledProcessError: if os.access(target, os.F_OK): os.unlink(target) raise def download_file_powershell(url, target): """ Download the file at url to target using Powershell. Powershell will validate trust. Raise an exception if the command cannot complete. """ target = os.path.abspath(target) ps_cmd = ( "[System.Net.WebRequest]::DefaultWebProxy.Credentials = " "[System.Net.CredentialCache]::DefaultCredentials; " '(new-object System.Net.WebClient).DownloadFile("%(url)s", "%(target)s")' % locals() ) cmd = [ 'powershell', '-Command', ps_cmd, ] _clean_check(cmd, target) def has_powershell(): """Determine if Powershell is available.""" if platform.system() != 'Windows': return False cmd = ['powershell', '-Command', 'echo test'] with open(os.path.devnull, 'wb') as devnull: try: subprocess.check_call(cmd, stdout=devnull, stderr=devnull) except Exception: return False return True download_file_powershell.viable = has_powershell def download_file_curl(url, target): cmd = ['curl', url, '--silent', '--output', target] _clean_check(cmd, target) def has_curl(): cmd = ['curl', '--version'] with open(os.path.devnull, 'wb') as devnull: try: subprocess.check_call(cmd, stdout=devnull, stderr=devnull) except Exception: return False return True download_file_curl.viable = has_curl def download_file_wget(url, target): cmd = ['wget', url, '--quiet', '--output-document', target] _clean_check(cmd, target) def has_wget(): cmd = ['wget', '--version'] with open(os.path.devnull, 'wb') as devnull: try: subprocess.check_call(cmd, stdout=devnull, stderr=devnull) except Exception: return False return True download_file_wget.viable = has_wget def download_file_insecure(url, target): """Use Python to download the file, without connection authentication.""" src = urlopen(url) try: # Read all the data in one block. data = src.read() finally: src.close() # Write all the data in one block to avoid creating a partial file. with open(target, "wb") as dst: dst.write(data) download_file_insecure.viable = lambda: True def get_best_downloader(): downloaders = ( download_file_powershell, download_file_curl, download_file_wget, download_file_insecure, ) viable_downloaders = (dl for dl in downloaders if dl.viable()) return next(viable_downloaders, None) def download_setuptools( version=DEFAULT_VERSION, download_base=DEFAULT_URL, to_dir=DEFAULT_SAVE_DIR, delay=15, downloader_factory=get_best_downloader): """ Download setuptools from a specified location and return its filename. `version` should be a valid setuptools version number that is available as an sdist for download under the `download_base` URL (which should end with a '/'). `to_dir` is the directory where the egg will be downloaded. `delay` is the number of seconds to pause before an actual download attempt. ``downloader_factory`` should be a function taking no arguments and returning a function for downloading a URL to a target. """ version = _resolve_version(version) # making sure we use the absolute path to_dir = os.path.abspath(to_dir) zip_name = "setuptools-%s.zip" % version url = download_base + zip_name saveto = os.path.join(to_dir, zip_name) if not os.path.exists(saveto): # Avoid repeated downloads log.warn("Downloading %s", url) downloader = downloader_factory() downloader(url, saveto) return os.path.realpath(saveto) def _resolve_version(version): """ Resolve LATEST version """ if version is not LATEST: return version resp = urlopen('https://pypi.python.org/pypi/setuptools/json') with contextlib.closing(resp): try: charset = resp.info().get_content_charset() except Exception: # Python 2 compat; assume UTF-8 charset = 'UTF-8' reader = codecs.getreader(charset) doc = json.load(reader(resp)) return str(doc['info']['version']) def _build_install_args(options): """ Build the arguments to 'python setup.py install' on the setuptools package. Returns list of command line arguments. """ return ['--user'] if options.user_install else [] def _parse_args(): """Parse the command line for options.""" parser = optparse.OptionParser() parser.add_option( '--user', dest='user_install', action='store_true', default=False, help='install in user site package (requires Python 2.6 or later)') parser.add_option( '--download-base', dest='download_base', metavar="URL", default=DEFAULT_URL, help='alternative URL from where to download the setuptools package') parser.add_option( '--insecure', dest='downloader_factory', action='store_const', const=lambda: download_file_insecure, default=get_best_downloader, help='Use internal, non-validating downloader' ) parser.add_option( '--version', help="Specify which version to download", default=DEFAULT_VERSION, ) parser.add_option( '--to-dir', help="Directory to save (and re-use) package", default=DEFAULT_SAVE_DIR, ) options, args = parser.parse_args() # positional arguments are ignored return options def _download_args(options): """Return args for download_setuptools function from cmdline args.""" return dict( version=options.version, download_base=options.download_base, downloader_factory=options.downloader_factory, to_dir=options.to_dir, ) def main(): """Install or upgrade setuptools and EasyInstall.""" options = _parse_args() archive = download_setuptools(**_download_args(options)) return _install(archive, _build_install_args(options)) if __name__ == '__main__': sys.exit(main()) setuptools-20.7.0/launcher.c0000775000175000017500000002411512702524020016632 0ustar travistravis00000000000000/* Setuptools Script Launcher for Windows This is a stub executable for Windows that functions somewhat like Effbot's "exemaker", in that it runs a script with the same name but a .py extension, using information from a #! line. It differs in that it spawns the actual Python executable, rather than attempting to hook into the Python DLL. This means that the script will run with sys.executable set to the Python executable, where exemaker ends up with sys.executable pointing to itself. (Which means it won't work if you try to run another Python process using sys.executable.) To build/rebuild with mingw32, do this in the setuptools project directory: gcc -DGUI=0 -mno-cygwin -O -s -o setuptools/cli.exe launcher.c gcc -DGUI=1 -mwindows -mno-cygwin -O -s -o setuptools/gui.exe launcher.c To build for Windows RT, install both Visual Studio Express for Windows 8 and for Windows Desktop (both freeware), create "win32" application using "Windows Desktop" version, create new "ARM" target via "Configuration Manager" menu and modify ".vcxproj" file by adding "true" tag as child of "PropertyGroup" tags that has "Debug|ARM" and "Release|ARM" properties. It links to msvcrt.dll, but this shouldn't be a problem since it doesn't actually run Python in the same process. Note that using 'exec' instead of 'spawn' doesn't work, because on Windows this leads to the Python executable running in the *background*, attached to the same console window, meaning you get a command prompt back *before* Python even finishes starting. So, we have to use spawnv() and wait for Python to exit before continuing. :( */ #include #include #include #include #include #include int child_pid=0; int fail(char *format, char *data) { /* Print error message to stderr and return 2 */ fprintf(stderr, format, data); return 2; } char *quoted(char *data) { int i, ln = strlen(data), nb; /* We allocate twice as much space as needed to deal with worse-case of having to escape everything. */ char *result = calloc(ln*2+3, sizeof(char)); char *presult = result; *presult++ = '"'; for (nb=0, i=0; i < ln; i++) { if (data[i] == '\\') nb += 1; else if (data[i] == '"') { for (; nb > 0; nb--) *presult++ = '\\'; *presult++ = '\\'; } else nb = 0; *presult++ = data[i]; } for (; nb > 0; nb--) /* Deal w trailing slashes */ *presult++ = '\\'; *presult++ = '"'; *presult++ = 0; return result; } char *loadable_exe(char *exename) { /* HINSTANCE hPython; DLL handle for python executable */ char *result; /* hPython = LoadLibraryEx(exename, NULL, LOAD_WITH_ALTERED_SEARCH_PATH); if (!hPython) return NULL; */ /* Return the absolute filename for spawnv */ result = calloc(MAX_PATH, sizeof(char)); strncpy(result, exename, MAX_PATH); /*if (result) GetModuleFileNameA(hPython, result, MAX_PATH); FreeLibrary(hPython); */ return result; } char *find_exe(char *exename, char *script) { char drive[_MAX_DRIVE], dir[_MAX_DIR], fname[_MAX_FNAME], ext[_MAX_EXT]; char path[_MAX_PATH], c, *result; /* convert slashes to backslashes for uniform search below */ result = exename; while (c = *result++) if (c=='/') result[-1] = '\\'; _splitpath(exename, drive, dir, fname, ext); if (drive[0] || dir[0]=='\\') { return loadable_exe(exename); /* absolute path, use directly */ } /* Use the script's parent directory, which should be the Python home (This should only be used for bdist_wininst-installed scripts, because easy_install-ed scripts use the absolute path to python[w].exe */ _splitpath(script, drive, dir, fname, ext); result = dir + strlen(dir) -1; if (*result == '\\') result--; while (*result != '\\' && result>=dir) *result-- = 0; _makepath(path, drive, dir, exename, NULL); return loadable_exe(path); } char **parse_argv(char *cmdline, int *argc) { /* Parse a command line in-place using MS C rules */ char **result = calloc(strlen(cmdline), sizeof(char *)); char *output = cmdline; char c; int nb = 0; int iq = 0; *argc = 0; result[0] = output; while (isspace(*cmdline)) cmdline++; /* skip leading spaces */ do { c = *cmdline++; if (!c || (isspace(c) && !iq)) { while (nb) {*output++ = '\\'; nb--; } *output++ = 0; result[++*argc] = output; if (!c) return result; while (isspace(*cmdline)) cmdline++; /* skip leading spaces */ if (!*cmdline) return result; /* avoid empty arg if trailing ws */ continue; } if (c == '\\') ++nb; /* count \'s */ else { if (c == '"') { if (!(nb & 1)) { iq = !iq; c = 0; } /* skip " unless odd # of \ */ nb = nb >> 1; /* cut \'s in half */ } while (nb) {*output++ = '\\'; nb--; } if (c) *output++ = c; } } while (1); } void pass_control_to_child(DWORD control_type) { /* * distribute-issue207 * passes the control event to child process (Python) */ if (!child_pid) { return; } GenerateConsoleCtrlEvent(child_pid,0); } BOOL control_handler(DWORD control_type) { /* * distribute-issue207 * control event handler callback function */ switch (control_type) { case CTRL_C_EVENT: pass_control_to_child(0); break; } return TRUE; } int create_and_wait_for_subprocess(char* command) { /* * distribute-issue207 * launches child process (Python) */ DWORD return_value = 0; LPSTR commandline = command; STARTUPINFOA s_info; PROCESS_INFORMATION p_info; ZeroMemory(&p_info, sizeof(p_info)); ZeroMemory(&s_info, sizeof(s_info)); s_info.cb = sizeof(STARTUPINFO); // set-up control handler callback funciotn SetConsoleCtrlHandler((PHANDLER_ROUTINE) control_handler, TRUE); if (!CreateProcessA(NULL, commandline, NULL, NULL, TRUE, 0, NULL, NULL, &s_info, &p_info)) { fprintf(stderr, "failed to create process.\n"); return 0; } child_pid = p_info.dwProcessId; // wait for Python to exit WaitForSingleObject(p_info.hProcess, INFINITE); if (!GetExitCodeProcess(p_info.hProcess, &return_value)) { fprintf(stderr, "failed to get exit code from process.\n"); return 0; } return return_value; } char* join_executable_and_args(char *executable, char **args, int argc) { /* * distribute-issue207 * CreateProcess needs a long string of the executable and command-line arguments, * so we need to convert it from the args that was built */ int len,counter; char* cmdline; len=strlen(executable)+2; for (counter=1; counterscript && *end != '.') *end-- = '\0'; *end-- = '\0'; strcat(script, (GUI ? "-script.pyw" : "-script.py")); /* figure out the target python executable */ scriptf = open(script, O_RDONLY); if (scriptf == -1) { return fail("Cannot open %s\n", script); } end = python + read(scriptf, python, sizeof(python)); close(scriptf); ptr = python-1; while(++ptr < end && *ptr && *ptr!='\n' && *ptr!='\r') {;} *ptr-- = '\0'; if (strncmp(python, "#!", 2)) { /* default to python.exe if no #! header */ strcpy(python, "#!python.exe"); } parsedargs = parse_argv(python+2, &parsedargc); /* Using spawnv() can fail strangely if you e.g. find the Cygwin Python, so we'll make sure Windows can find and load it */ ptr = find_exe(parsedargs[0], script); if (!ptr) { return fail("Cannot find Python executable %s\n", parsedargs[0]); } /* printf("Python executable: %s\n", ptr); */ /* Argument array needs to be parsedargc + argc, plus 1 for null sentinel */ newargs = (char **)calloc(parsedargc + argc + 1, sizeof(char *)); newargsp = newargs; *newargsp++ = quoted(ptr); for (i = 1; inul 2>&1 if "%ERRORLEVEL%"=="0" ( echo Building Windows RT Version ... cl /D "GUI=0" /D "WIN32_LEAN_AND_MEAN" /D _ARM_WINAPI_PARTITION_DESKTOP_SDK_AVAILABLE launcher.c /O2 /link /MACHINE:ARM /SUBSYSTEM:CONSOLE /out:setuptools/cli-arm-32.exe cl /D "GUI=1" /D "WIN32_LEAN_AND_MEAN" /D _ARM_WINAPI_PARTITION_DESKTOP_SDK_AVAILABLE launcher.c /O2 /link /MACHINE:ARM /SUBSYSTEM:WINDOWS /out:setuptools/gui-arm-32.exe ) else ( echo Visual Studio ^(Express^) 2012 not found to build Windows RT Version ) set PATH=%PATH_OLD% setuptools-20.7.0/pavement.py0000664000175000017500000000132212702524020017046 0ustar travistravis00000000000000import re from paver.easy import task, path as Path import pip def remove_all(paths): for path in paths: path.rmtree() if path.isdir() else path.remove() @task def update_vendored(): vendor = Path('pkg_resources/_vendor') remove_all(vendor.glob('packaging*')) remove_all(vendor.glob('six*')) remove_all(vendor.glob('pyparsing*')) install_args = [ 'install', '-r', str(vendor/'vendored.txt'), '-t', str(vendor), ] pip.main(install_args) packaging = vendor / 'packaging' for file in packaging.glob('*.py'): text = file.text() text = re.sub(r' (pyparsing|six)', r' pkg_resources.extern.\1', text) file.write_text(text) remove_all(vendor.glob('*.dist-info')) remove_all(vendor.glob('*.egg-info')) setuptools-20.7.0/pytest.ini0000775000175000017500000000050612702524020016714 0ustar travistravis00000000000000[pytest] addopts=--doctest-modules --ignore release.py --ignore setuptools/lib2to3_ex.py --ignore tests/manual_test.py --ignore tests/shlib_test --doctest-glob=pkg_resources/api_tests.txt --ignore scripts/upload-old-releases-as-zip.py --ignore pavement.py norecursedirs=dist build *.egg setuptools/extern pkg_resources/extern setuptools-20.7.0/setup.py0000775000175000017500000001503112702524020016374 0ustar travistravis00000000000000#!/usr/bin/env python """ Distutils setup file, used to install or test 'setuptools' """ import io import os import sys import textwrap # Allow to run setup.py from another directory. os.chdir(os.path.dirname(os.path.abspath(__file__))) src_root = None from distutils.util import convert_path command_ns = {} init_path = convert_path('setuptools/command/__init__.py') with open(init_path) as init_file: exec(init_file.read(), command_ns) SETUP_COMMANDS = command_ns['__all__'] import setuptools scripts = [] def _gen_console_scripts(): yield "easy_install = setuptools.command.easy_install:main" # Gentoo distributions manage the python-version-specific scripts # themselves, so those platforms define an environment variable to # suppress the creation of the version-specific scripts. var_names = ( 'SETUPTOOLS_DISABLE_VERSIONED_EASY_INSTALL_SCRIPT', 'DISTRIBUTE_DISABLE_VERSIONED_EASY_INSTALL_SCRIPT', ) if any(os.environ.get(var) not in (None, "", "0") for var in var_names): return yield ("easy_install-{shortver} = setuptools.command.easy_install:main" .format(shortver=sys.version[:3])) console_scripts = list(_gen_console_scripts()) readme_file = io.open('README.rst', encoding='utf-8') with readme_file: long_description = readme_file.read() package_data = { 'setuptools': ['script (dev).tmpl', 'script.tmpl', 'site-patch.py']} force_windows_specific_files = ( os.environ.get("SETUPTOOLS_INSTALL_WINDOWS_SPECIFIC_FILES") not in (None, "", "0") ) if (sys.platform == 'win32' or (os.name == 'java' and os._name == 'nt')) \ or force_windows_specific_files: package_data.setdefault('setuptools', []).extend(['*.exe']) package_data.setdefault('setuptools.command', []).extend(['*.xml']) needs_pytest = set(['ptr', 'pytest', 'test']).intersection(sys.argv) pytest_runner = ['pytest-runner'] if needs_pytest else [] needs_sphinx = set(['build_sphinx', 'upload_docs', 'release']).intersection(sys.argv) sphinx = ['sphinx', 'rst.linker>=1.5'] if needs_sphinx else [] needs_wheel = set(['release', 'bdist_wheel']).intersection(sys.argv) wheel = ['wheel'] if needs_wheel else [] setup_params = dict( name="setuptools", version="20.7.0", description="Easily download, build, install, upgrade, and uninstall " "Python packages", author="Python Packaging Authority", author_email="distutils-sig@python.org", long_description=long_description, keywords="CPAN PyPI distutils eggs package management", url="https://github.com/pypa/setuptools", src_root=src_root, packages=setuptools.find_packages(exclude=['*.tests']), package_data=package_data, py_modules=['easy_install'], zip_safe=True, entry_points={ "distutils.commands": [ "%(cmd)s = setuptools.command.%(cmd)s:%(cmd)s" % locals() for cmd in SETUP_COMMANDS ], "distutils.setup_keywords": [ "eager_resources = setuptools.dist:assert_string_list", "namespace_packages = setuptools.dist:check_nsp", "extras_require = setuptools.dist:check_extras", "install_requires = setuptools.dist:check_requirements", "tests_require = setuptools.dist:check_requirements", "setup_requires = setuptools.dist:check_requirements", "entry_points = setuptools.dist:check_entry_points", "test_suite = setuptools.dist:check_test_suite", "zip_safe = setuptools.dist:assert_bool", "package_data = setuptools.dist:check_package_data", "exclude_package_data = setuptools.dist:check_package_data", "include_package_data = setuptools.dist:assert_bool", "packages = setuptools.dist:check_packages", "dependency_links = setuptools.dist:assert_string_list", "test_loader = setuptools.dist:check_importable", "test_runner = setuptools.dist:check_importable", "use_2to3 = setuptools.dist:assert_bool", "convert_2to3_doctests = setuptools.dist:assert_string_list", "use_2to3_fixers = setuptools.dist:assert_string_list", "use_2to3_exclude_fixers = setuptools.dist:assert_string_list", ], "egg_info.writers": [ "PKG-INFO = setuptools.command.egg_info:write_pkg_info", "requires.txt = setuptools.command.egg_info:write_requirements", "entry_points.txt = setuptools.command.egg_info:write_entries", "eager_resources.txt = setuptools.command.egg_info:overwrite_arg", "namespace_packages.txt = setuptools.command.egg_info:overwrite_arg", "top_level.txt = setuptools.command.egg_info:write_toplevel_names", "depends.txt = setuptools.command.egg_info:warn_depends_obsolete", "dependency_links.txt = setuptools.command.egg_info:overwrite_arg", ], "console_scripts": console_scripts, "setuptools.installation": ['eggsecutable = setuptools.command.easy_install:bootstrap'], }, classifiers=textwrap.dedent(""" Development Status :: 5 - Production/Stable Intended Audience :: Developers License :: OSI Approved :: MIT License Operating System :: OS Independent Programming Language :: Python :: 2.6 Programming Language :: Python :: 2.7 Programming Language :: Python :: 3 Programming Language :: Python :: 3.3 Programming Language :: Python :: 3.4 Programming Language :: Python :: 3.5 Topic :: Software Development :: Libraries :: Python Modules Topic :: System :: Archiving :: Packaging Topic :: System :: Systems Administration Topic :: Utilities """).strip().splitlines(), extras_require={ "ssl:sys_platform=='win32'": "wincertstore==0.2", "certs": "certifi==2015.11.20", }, dependency_links=[ 'https://pypi.python.org/packages/source/c/certifi/certifi-2015.11.20.tar.gz#md5=25134646672c695c1ff1593c2dd75d08', 'https://pypi.python.org/packages/source/w/wincertstore/wincertstore-0.2.zip#md5=ae728f2f007185648d0c7a8679b361e2', ], scripts=[], tests_require=[ 'setuptools[ssl]', 'pytest>=2.8', ] + (['mock'] if sys.version_info[:2] < (3, 3) else []), setup_requires=[ ] + sphinx + pytest_runner + wheel, ) if __name__ == '__main__': dist = setuptools.setup(**setup_params) setuptools-20.7.0/PKG-INFO0000664000175000017500000003114212702524134015763 0ustar travistravis00000000000000Metadata-Version: 1.1 Name: setuptools Version: 20.7.0 Summary: Easily download, build, install, upgrade, and uninstall Python packages Home-page: https://github.com/pypa/setuptools Author: Python Packaging Authority Author-email: distutils-sig@python.org License: UNKNOWN Description: =============================== Installing and Using Setuptools =============================== .. contents:: **Table of Contents** `Change History `_. ------------------------- Installation Instructions ------------------------- The recommended way to bootstrap setuptools on any system is to download `ez_setup.py`_ and run it using the target Python environment. Different operating systems have different recommended techniques to accomplish this basic routine, so below are some examples to get you started. Setuptools requires Python 2.6 or later. To install setuptools on Python 2.4 or Python 2.5, use the `bootstrap script for Setuptools 1.x `_. The link provided to ez_setup.py is a bookmark to bootstrap script for the latest known stable release. .. _ez_setup.py: https://bootstrap.pypa.io/ez_setup.py Windows (Powershell 3 or later) =============================== For best results, uninstall previous versions FIRST (see `Uninstalling`_). Using Windows 8 (which includes PowerShell 3) or earlier versions of Windows with PowerShell 3 installed, it's possible to install with one simple Powershell command. Start up Powershell and paste this command:: > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | python - You must start the Powershell with Administrative privileges or you may choose to install a user-local installation:: > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | python - --user If you have Python 3.3 or later, you can use the ``py`` command to install to different Python versions. For example, to install to Python 3.3 if you have Python 2.7 installed:: > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | py -3 - The recommended way to install setuptools on Windows is to download `ez_setup.py`_ and run it. The script will download the appropriate distribution file and install it for you. Once installation is complete, you will find an ``easy_install`` program in your Python ``Scripts`` subdirectory. For simple invocation and best results, add this directory to your ``PATH`` environment variable, if it is not already present. If you did a user-local install, the ``Scripts`` subdirectory is ``$env:APPDATA\Python\Scripts``. Windows (simplified) ==================== For Windows without PowerShell 3 or for installation without a command-line, download `ez_setup.py`_ using your preferred web browser or other technique and "run" that file. Unix (wget) =========== Most Linux distributions come with wget. Download `ez_setup.py`_ and run it using the target Python version. The script will download the appropriate version and install it for you:: > wget https://bootstrap.pypa.io/ez_setup.py -O - | python Note that you will may need to invoke the command with superuser privileges to install to the system Python:: > wget https://bootstrap.pypa.io/ez_setup.py -O - | sudo python Alternatively, Setuptools may be installed to a user-local path:: > wget https://bootstrap.pypa.io/ez_setup.py -O - | python - --user Note that on some older systems (noted on Debian 6 and CentOS 5 installations), `wget` may refuse to download `ez_setup.py`, complaining that the certificate common name `*.c.ssl.fastly.net` does not match the host name `bootstrap.pypa.io`. In addition, the `ez_setup.py` script may then encounter similar problems using `wget` internally to download `setuptools-x.y.zip`, complaining that the certificate common name of `www.python.org` does not match the host name `pypi.python.org`. Those are known issues, related to a bug in the older versions of `wget` (see `Issue 59 `_). If you happen to encounter them, install Setuptools as follows:: > wget --no-check-certificate https://bootstrap.pypa.io/ez_setup.py > python ez_setup.py --insecure Unix including Mac OS X (curl) ============================== If your system has curl installed, follow the ``wget`` instructions but replace ``wget`` with ``curl`` and ``-O`` with ``-o``. For example:: > curl https://bootstrap.pypa.io/ez_setup.py -o - | python Advanced Installation ===================== For more advanced installation options, such as installing to custom locations or prefixes, download and extract the source tarball from `Setuptools on PyPI `_ and run setup.py with any supported distutils and Setuptools options. For example:: setuptools-x.x$ python setup.py install --prefix=/opt/setuptools Use ``--help`` to get a full options list, but we recommend consulting the `EasyInstall manual`_ for detailed instructions, especially `the section on custom installation locations`_. .. _EasyInstall manual: https://pythonhosted.org/setuptools/EasyInstall .. _the section on custom installation locations: https://pythonhosted.org/setuptools/EasyInstall#custom-installation-locations Downloads ========= All setuptools downloads can be found at `the project's home page in the Python Package Index`_. Scroll to the very bottom of the page to find the links. .. _the project's home page in the Python Package Index: https://pypi.python.org/pypi/setuptools In addition to the PyPI downloads, the development version of ``setuptools`` is available from the `Bitbucket repo`_, and in-development versions of the `0.6 branch`_ are available as well. .. _Bitbucket repo: https://bitbucket.org/pypa/setuptools/get/default.tar.gz#egg=setuptools-dev .. _0.6 branch: http://svn.python.org/projects/sandbox/branches/setuptools-0.6/#egg=setuptools-dev06 Uninstalling ============ On Windows, if Setuptools was installed using an ``.exe`` or ``.msi`` installer, simply use the uninstall feature of "Add/Remove Programs" in the Control Panel. Otherwise, to uninstall Setuptools or Distribute, regardless of the Python version, delete all ``setuptools*`` and ``distribute*`` files and directories from your system's ``site-packages`` directory (and any other ``sys.path`` directories) FIRST. If you are upgrading or otherwise plan to re-install Setuptools or Distribute, nothing further needs to be done. If you want to completely remove Setuptools, you may also want to remove the 'easy_install' and 'easy_install-x.x' scripts and associated executables installed to the Python scripts directory. -------------------------------- Using Setuptools and EasyInstall -------------------------------- Here are some of the available manuals, tutorials, and other resources for learning about Setuptools, Python Eggs, and EasyInstall: * `The EasyInstall user's guide and reference manual`_ * `The setuptools Developer's Guide`_ * `The pkg_resources API reference`_ * `The Internal Structure of Python Eggs`_ Questions, comments, and bug reports should be directed to the `distutils-sig mailing list`_. If you have written (or know of) any tutorials, documentation, plug-ins, or other resources for setuptools users, please let us know about them there, so this reference list can be updated. If you have working, *tested* patches to correct problems or add features, you may submit them to the `setuptools bug tracker`_. .. _setuptools bug tracker: https://github.com/pypa/setuptools/issues .. _The Internal Structure of Python Eggs: https://pythonhosted.org/setuptools/formats.html .. _The setuptools Developer's Guide: https://pythonhosted.org/setuptools/setuptools.html .. _The pkg_resources API reference: https://pythonhosted.org/setuptools/pkg_resources.html .. _The EasyInstall user's guide and reference manual: https://pythonhosted.org/setuptools/easy_install.html .. _distutils-sig mailing list: http://mail.python.org/pipermail/distutils-sig/ ------- Credits ------- * The original design for the ``.egg`` format and the ``pkg_resources`` API was co-created by Phillip Eby and Bob Ippolito. Bob also implemented the first version of ``pkg_resources``, and supplied the OS X operating system version compatibility algorithm. * Ian Bicking implemented many early "creature comfort" features of easy_install, including support for downloading via Sourceforge and Subversion repositories. Ian's comments on the Web-SIG about WSGI application deployment also inspired the concept of "entry points" in eggs, and he has given talks at PyCon and elsewhere to inform and educate the community about eggs and setuptools. * Jim Fulton contributed time and effort to build automated tests of various aspects of ``easy_install``, and supplied the doctests for the command-line ``.exe`` wrappers on Windows. * Phillip J. Eby is the seminal author of setuptools, and first proposed the idea of an importable binary distribution format for Python application plug-ins. * Significant parts of the implementation of setuptools were funded by the Open Source Applications Foundation, to provide a plug-in infrastructure for the Chandler PIM application. In addition, many OSAF staffers (such as Mike "Code Bear" Taylor) contributed their time and stress as guinea pigs for the use of eggs and setuptools, even before eggs were "cool". (Thanks, guys!) * Tarek Ziadé is the principal author of the Distribute fork, which re-invigorated the community on the project, encouraged renewed innovation, and addressed many defects. * Since the merge with Distribute, Jason R. Coombs is the maintainer of setuptools. The project is maintained in coordination with the Python Packaging Authority (PyPA) and the larger Python community. .. _files: --------------- Code of Conduct --------------- Everyone interacting in the setuptools project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_. .. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/ Keywords: CPAN PyPI distutils eggs package management Platform: UNKNOWN Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Operating System :: OS Independent Classifier: Programming Language :: Python :: 2.6 Classifier: Programming Language :: Python :: 2.7 Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.3 Classifier: Programming Language :: Python :: 3.4 Classifier: Programming Language :: Python :: 3.5 Classifier: Topic :: Software Development :: Libraries :: Python Modules Classifier: Topic :: System :: Archiving :: Packaging Classifier: Topic :: System :: Systems Administration Classifier: Topic :: Utilities setuptools-20.7.0/setup.cfg0000775000175000017500000000077512702524134016522 0ustar travistravis00000000000000[bumpversion] current_version = 20.7.0 commit = True tag = True [egg_info] tag_build = tag_date = 0 tag_svn_revision = 0 [aliases] clean_egg_info = egg_info -RDb '' release = clean_egg_info sdist bdist_wheel build_sphinx source = register sdist binary binary = bdist_egg upload --show-response test = pytest [build_sphinx] source-dir = docs/ build-dir = docs/build all_files = 1 [upload_docs] upload-dir = docs/build/html [sdist] formats = gztar zip [wheel] universal = 1 [bumpversion:file:setup.py]