Mercurial > repos > bcclaywell > argo_navis

comparison venv/lib/python2.7/site-packages/setuptools-15.0.dist-info/METADATA @ 0:d67268158946 draft

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload commit a3f181f5f126803c654b3a66dd4e83a48f7e203b
author bcclaywell
date Mon, 12 Oct 2015 17:43:33 -0400
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:d67268158946
1 Metadata-Version: 2.0
2 Name: setuptools
3 Version: 15.0
4 Summary: Easily download, build, install, upgrade, and uninstall Python packages
5 Home-page: https://bitbucket.org/pypa/setuptools
6 Author: Python Packaging Authority
7 Author-email: distutils-sig@python.org
8 License: PSF or ZPL
9 Keywords: CPAN PyPI distutils eggs package management
10 Platform: UNKNOWN
11 Classifier: Development Status :: 5 - Production/Stable
12 Classifier: Intended Audience :: Developers
13 Classifier: License :: OSI Approved :: Python Software Foundation License
14 Classifier: License :: OSI Approved :: Zope Public License
15 Classifier: Operating System :: OS Independent
16 Classifier: Programming Language :: Python :: 2.6
17 Classifier: Programming Language :: Python :: 2.7
18 Classifier: Programming Language :: Python :: 3
19 Classifier: Programming Language :: Python :: 3.1
20 Classifier: Programming Language :: Python :: 3.2
21 Classifier: Programming Language :: Python :: 3.3
22 Classifier: Programming Language :: Python :: 3.4
23 Classifier: Topic :: Software Development :: Libraries :: Python Modules
24 Classifier: Topic :: System :: Archiving :: Packaging
25 Classifier: Topic :: System :: Systems Administration
26 Classifier: Topic :: Utilities
27 Provides-Extra: certs
28 Requires-Dist: certifi (==1.0.1); extra == 'certs'
29 Provides-Extra: ssl
30 Requires-Dist: wincertstore (==0.2); sys_platform=='win32' and extra == 'ssl'
31
32 ===============================
33 Installing and Using Setuptools
34 ===============================
35
36 .. contents:: **Table of Contents**
37
38
39 `Change History <https://pythonhosted.org/setuptools/history.html>`_.
40
41 -------------------------
42 Installation Instructions
43 -------------------------
44
45 The recommended way to bootstrap setuptools on any system is to download
46 `ez_setup.py`_ and run it using the target Python environment. Different
47 operating systems have different recommended techniques to accomplish this
48 basic routine, so below are some examples to get you started.
49
50 Setuptools requires Python 2.6 or later. To install setuptools
51 on Python 2.4 or Python 2.5, use the `bootstrap script for Setuptools 1.x
52 <https://bitbucket.org/pypa/setuptools/raw/bootstrap-py24/ez_setup.py>`_.
53
54 The link provided to ez_setup.py is a bookmark to bootstrap script for the
55 latest known stable release.
56
57 .. _ez_setup.py: https://bootstrap.pypa.io/ez_setup.py
58
59 Windows (Powershell 3 or later)
60 ===============================
61
62 For best results, uninstall previous versions FIRST (see `Uninstalling`_).
63
64 Using Windows 8 (which includes PowerShell 3) or earlier versions of Windows
65 with PowerShell 3 installed, it's possible to install with one simple
66 Powershell command. Start up Powershell and paste this command::
67
68 > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | python -
69
70 You must start the Powershell with Administrative privileges or you may choose
71 to install a user-local installation::
72
73 > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | python - --user
74
75 If you have Python 3.3 or later, you can use the ``py`` command to install to
76 different Python versions. For example, to install to Python 3.3 if you have
77 Python 2.7 installed::
78
79 > (Invoke-WebRequest https://bootstrap.pypa.io/ez_setup.py).Content | py -3 -
80
81 The recommended way to install setuptools on Windows is to download
82 `ez_setup.py`_ and run it. The script will download the appropriate
83 distribution file and install it for you.
84
85 Once installation is complete, you will find an ``easy_install`` program in
86 your Python ``Scripts`` subdirectory. For simple invocation and best results,
87 add this directory to your ``PATH`` environment variable, if it is not already
88 present. If you did a user-local install, the ``Scripts`` subdirectory is
89 ``$env:APPDATA\Python\Scripts``.
90
91
92 Windows (simplified)
93 ====================
94
95 For Windows without PowerShell 3 or for installation without a command-line,
96 download `ez_setup.py`_ using your preferred web browser or other technique
97 and "run" that file.
98
99
100 Unix (wget)
101 ===========
102
103 Most Linux distributions come with wget.
104
105 Download `ez_setup.py`_ and run it using the target Python version. The script
106 will download the appropriate version and install it for you::
107
108 > wget https://bootstrap.pypa.io/ez_setup.py -O - | python
109
110 Note that you will may need to invoke the command with superuser privileges to
111 install to the system Python::
112
113 > wget https://bootstrap.pypa.io/ez_setup.py -O - | sudo python
114
115 Alternatively, Setuptools may be installed to a user-local path::
116
117 > wget https://bootstrap.pypa.io/ez_setup.py -O - | python - --user
118
119 Note that on some older systems (noted on Debian 6 and CentOS 5 installations),
120 `wget` may refuse to download `ez_setup.py`, complaining that the certificate common name `*.c.ssl.fastly.net`
121 does not match the host name `bootstrap.pypa.io`. In addition, the `ez_setup.py` script may then encounter similar problems using
122 `wget` internally to download `setuptools-x.y.zip`, complaining that the certificate common name of `www.python.org` does not match the
123 host name `pypi.python.org`. Those are known issues, related to a bug in the older versions of `wget`
124 (see `Issue 59 <https://bitbucket.org/pypa/pypi/issue/59#comment-5881915>`_). If you happen to encounter them,
125 install Setuptools as follows::
126
127 > wget --no-check-certificate https://bootstrap.pypa.io/ez_setup.py
128 > python ez_setup.py --insecure
129
130
131 Unix including Mac OS X (curl)
132 ==============================
133
134 If your system has curl installed, follow the ``wget`` instructions but
135 replace ``wget`` with ``curl`` and ``-O`` with ``-o``. For example::
136
137 > curl https://bootstrap.pypa.io/ez_setup.py -o - | python
138
139
140 Advanced Installation
141 =====================
142
143 For more advanced installation options, such as installing to custom
144 locations or prefixes, download and extract the source
145 tarball from `Setuptools on PyPI <https://pypi.python.org/pypi/setuptools>`_
146 and run setup.py with any supported distutils and Setuptools options.
147 For example::
148
149 setuptools-x.x$ python setup.py install --prefix=/opt/setuptools
150
151 Use ``--help`` to get a full options list, but we recommend consulting
152 the `EasyInstall manual`_ for detailed instructions, especially `the section
153 on custom installation locations`_.
154
155 .. _EasyInstall manual: https://pythonhosted.org/setuptools/EasyInstall
156 .. _the section on custom installation locations: https://pythonhosted.org/setuptools/EasyInstall#custom-installation-locations
157
158
159 Downloads
160 =========
161
162 All setuptools downloads can be found at `the project's home page in the Python
163 Package Index`_. Scroll to the very bottom of the page to find the links.
164
165 .. _the project's home page in the Python Package Index: https://pypi.python.org/pypi/setuptools
166
167 In addition to the PyPI downloads, the development version of ``setuptools``
168 is available from the `Bitbucket repo`_, and in-development versions of the
169 `0.6 branch`_ are available as well.
170
171 .. _Bitbucket repo: https://bitbucket.org/pypa/setuptools/get/default.tar.gz#egg=setuptools-dev
172 .. _0.6 branch: http://svn.python.org/projects/sandbox/branches/setuptools-0.6/#egg=setuptools-dev06
173
174 Uninstalling
175 ============
176
177 On Windows, if Setuptools was installed using an ``.exe`` or ``.msi``
178 installer, simply use the uninstall feature of "Add/Remove Programs" in the
179 Control Panel.
180
181 Otherwise, to uninstall Setuptools or Distribute, regardless of the Python
182 version, delete all ``setuptools*`` and ``distribute*`` files and
183 directories from your system's ``site-packages`` directory
184 (and any other ``sys.path`` directories) FIRST.
185
186 If you are upgrading or otherwise plan to re-install Setuptools or Distribute,
187 nothing further needs to be done. If you want to completely remove Setuptools,
188 you may also want to remove the 'easy_install' and 'easy_install-x.x' scripts
189 and associated executables installed to the Python scripts directory.
190
191 --------------------------------
192 Using Setuptools and EasyInstall
193 --------------------------------
194
195 Here are some of the available manuals, tutorials, and other resources for
196 learning about Setuptools, Python Eggs, and EasyInstall:
197
198 * `The EasyInstall user's guide and reference manual`_
199 * `The setuptools Developer's Guide`_
200 * `The pkg_resources API reference`_
201 * `The Internal Structure of Python Eggs`_
202
203 Questions, comments, and bug reports should be directed to the `distutils-sig
204 mailing list`_. If you have written (or know of) any tutorials, documentation,
205 plug-ins, or other resources for setuptools users, please let us know about
206 them there, so this reference list can be updated. If you have working,
207 *tested* patches to correct problems or add features, you may submit them to
208 the `setuptools bug tracker`_.
209
210 .. _setuptools bug tracker: https://bitbucket.org/pypa/setuptools/issues
211 .. _The Internal Structure of Python Eggs: https://pythonhosted.org/setuptools/formats.html
212 .. _The setuptools Developer's Guide: https://pythonhosted.org/setuptools/setuptools.html
213 .. _The pkg_resources API reference: https://pythonhosted.org/setuptools/pkg_resources.html
214 .. _The EasyInstall user's guide and reference manual: https://pythonhosted.org/setuptools/easy_install.html
215 .. _distutils-sig mailing list: http://mail.python.org/pipermail/distutils-sig/
216
217
218 -------
219 Credits
220 -------
221
222 * The original design for the ``.egg`` format and the ``pkg_resources`` API was
223 co-created by Phillip Eby and Bob Ippolito. Bob also implemented the first
224 version of ``pkg_resources``, and supplied the OS X operating system version
225 compatibility algorithm.
226
227 * Ian Bicking implemented many early "creature comfort" features of
228 easy_install, including support for downloading via Sourceforge and
229 Subversion repositories. Ian's comments on the Web-SIG about WSGI
230 application deployment also inspired the concept of "entry points" in eggs,
231 and he has given talks at PyCon and elsewhere to inform and educate the
232 community about eggs and setuptools.
233
234 * Jim Fulton contributed time and effort to build automated tests of various
235 aspects of ``easy_install``, and supplied the doctests for the command-line
236 ``.exe`` wrappers on Windows.
237
238 * Phillip J. Eby is the seminal author of setuptools, and
239 first proposed the idea of an importable binary distribution format for
240 Python application plug-ins.
241
242 * Significant parts of the implementation of setuptools were funded by the Open
243 Source Applications Foundation, to provide a plug-in infrastructure for the
244 Chandler PIM application. In addition, many OSAF staffers (such as Mike
245 "Code Bear" Taylor) contributed their time and stress as guinea pigs for the
246 use of eggs and setuptools, even before eggs were "cool". (Thanks, guys!)
247
248 * Tarek Ziadé is the principal author of the Distribute fork, which
249 re-invigorated the community on the project, encouraged renewed innovation,
250 and addressed many defects.
251
252 * Since the merge with Distribute, Jason R. Coombs is the
253 maintainer of setuptools. The project is maintained in coordination with
254 the Python Packaging Authority (PyPA) and the larger Python community.
255
256 .. _files:
257
258