root / env / lib / python2.7 / site-packages / distribute-0.6.19-py2.7.egg / EGG-INFO / PKG-INFO @ 1a305335
History | View | Annotate | Download (22.4 KB)
1 |
Metadata-Version: 1.0 |
---|---|
2 |
Name: distribute |
3 |
Version: 0.6.19 |
4 |
Summary: Easily download, build, install, upgrade, and uninstall Python packages |
5 |
Home-page: http://packages.python.org/distribute |
6 |
Author: The fellowship of the packaging |
7 |
Author-email: distutils-sig@python.org |
8 |
License: PSF or ZPL |
9 |
Description: =============================== |
10 |
Installing and Using Distribute |
11 |
=============================== |
12 |
|
13 |
.. contents:: **Table of Contents** |
14 |
|
15 |
----------- |
16 |
Disclaimers |
17 |
----------- |
18 |
|
19 |
About the fork |
20 |
============== |
21 |
|
22 |
`Distribute` is a fork of the `Setuptools` project. |
23 |
|
24 |
Distribute is intended to replace Setuptools as the standard method |
25 |
for working with Python module distributions. |
26 |
|
27 |
The fork has two goals: |
28 |
|
29 |
- Providing a backward compatible version to replace Setuptools |
30 |
and make all distributions that depend on Setuptools work as |
31 |
before, but with less bugs and behaviorial issues. |
32 |
|
33 |
This work is done in the 0.6.x series. |
34 |
|
35 |
Starting with version 0.6.2, Distribute supports Python 3. |
36 |
Installing and using distribute for Python 3 code works exactly |
37 |
the same as for Python 2 code, but Distribute also helps you to support |
38 |
Python 2 and Python 3 from the same source code by letting you run 2to3 |
39 |
on the code as a part of the build process, by setting the keyword parameter |
40 |
``use_2to3`` to True. See http://packages.python.org/distribute for more |
41 |
information. |
42 |
|
43 |
- Refactoring the code, and releasing it in several distributions. |
44 |
This work is being done in the 0.7.x series but not yet released. |
45 |
|
46 |
The roadmap is still evolving, and the page that is up-to-date is |
47 |
located at : `http://packages.python.org/distribute/roadmap`. |
48 |
|
49 |
If you install `Distribute` and want to switch back for any reason to |
50 |
`Setuptools`, get to the `Uninstallation instructions`_ section. |
51 |
|
52 |
More documentation |
53 |
================== |
54 |
|
55 |
You can get more information in the Sphinx-based documentation, located |
56 |
at http://packages.python.org/distribute. This documentation includes the old |
57 |
Setuptools documentation that is slowly replaced, and brand new content. |
58 |
|
59 |
About the installation process |
60 |
============================== |
61 |
|
62 |
The `Distribute` installer modifies your installation by de-activating an |
63 |
existing installation of `Setuptools` in a bootstrap process. This process |
64 |
has been tested in various installation schemes and contexts but in case of a |
65 |
bug during this process your Python installation might be left in a broken |
66 |
state. Since all modified files and directories are copied before the |
67 |
installation starts, you will be able to get back to a normal state by reading |
68 |
the instructions in the `Uninstallation instructions`_ section. |
69 |
|
70 |
In any case, it is recommended to save you `site-packages` directory before |
71 |
you start the installation of `Distribute`. |
72 |
|
73 |
------------------------- |
74 |
Installation Instructions |
75 |
------------------------- |
76 |
|
77 |
Distribute is only released as a source distribution. |
78 |
|
79 |
It can be installed using pip, and can be done so with the source tarball, |
80 |
or by using the ``distribute_setup.py`` script provided online. |
81 |
|
82 |
``distribute_setup.py`` is the simplest and preferred way on all systems. |
83 |
|
84 |
distribute_setup.py |
85 |
=================== |
86 |
|
87 |
Download |
88 |
`distribute_setup.py <http://python-distribute.org/distribute_setup.py>`_ |
89 |
and execute it, using the Python interpreter of your choice. |
90 |
|
91 |
If your shell has the ``curl`` program you can do:: |
92 |
|
93 |
$ curl -O http://python-distribute.org/distribute_setup.py |
94 |
$ python distribute_setup.py |
95 |
|
96 |
Notice this file is also provided in the source release. |
97 |
|
98 |
pip |
99 |
=== |
100 |
|
101 |
Run easy_install or pip:: |
102 |
|
103 |
$ pip install distribute |
104 |
|
105 |
Source installation |
106 |
=================== |
107 |
|
108 |
Download the source tarball, uncompress it, then run the install command:: |
109 |
|
110 |
$ curl -O http://pypi.python.org/packages/source/d/distribute/distribute-0.6.19.tar.gz |
111 |
$ tar -xzvf distribute-0.6.19.tar.gz |
112 |
$ cd distribute-0.6.19 |
113 |
$ python setup.py install |
114 |
|
115 |
--------------------------- |
116 |
Uninstallation Instructions |
117 |
--------------------------- |
118 |
|
119 |
Like other distutils-based distributions, Distribute doesn't provide an |
120 |
uninstaller yet. It's all done manually! We are all waiting for PEP 376 |
121 |
support in Python. |
122 |
|
123 |
Distribute is installed in three steps: |
124 |
|
125 |
1. it gets out of the way an existing installation of Setuptools |
126 |
2. it installs a `fake` setuptools installation |
127 |
3. it installs distribute |
128 |
|
129 |
Distribute can be removed like this: |
130 |
|
131 |
- remove the ``distribute*.egg`` file located in your site-packages directory |
132 |
- remove the ``setuptools.pth`` file located in you site-packages directory |
133 |
- remove the easy_install script located in you ``sys.prefix/bin`` directory |
134 |
- remove the ``setuptools*.egg`` directory located in your site-packages directory, |
135 |
if any. |
136 |
|
137 |
If you want to get back to setuptools: |
138 |
|
139 |
- reinstall setuptools using its instruction. |
140 |
|
141 |
Lastly: |
142 |
|
143 |
- remove the *.OLD.* directory located in your site-packages directory if any, |
144 |
**once you have checked everything was working correctly again**. |
145 |
|
146 |
------------------------- |
147 |
Quick help for developers |
148 |
------------------------- |
149 |
|
150 |
To create an egg which is compatible with Distribute, use the same |
151 |
practice as with Setuptools, e.g.:: |
152 |
|
153 |
from setuptools import setup |
154 |
|
155 |
setup(... |
156 |
) |
157 |
|
158 |
To use `pkg_resources` to access data files in the egg, you should |
159 |
require the Setuptools distribution explicitly:: |
160 |
|
161 |
from setuptools import setup |
162 |
|
163 |
setup(... |
164 |
install_requires=['setuptools'] |
165 |
) |
166 |
|
167 |
Only if you need Distribute-specific functionality should you depend |
168 |
on it explicitly. In this case, replace the Setuptools dependency:: |
169 |
|
170 |
from setuptools import setup |
171 |
|
172 |
setup(... |
173 |
install_requires=['distribute'] |
174 |
) |
175 |
|
176 |
----------- |
177 |
Install FAQ |
178 |
----------- |
179 |
|
180 |
- **Why is Distribute wrapping my Setuptools installation?** |
181 |
|
182 |
Since Distribute is a fork, and since it provides the same package |
183 |
and modules, it renames the existing Setuptools egg and inserts a |
184 |
new one which merely wraps the Distribute code. This way, full |
185 |
backwards compatibility is kept for packages which rely on the |
186 |
Setuptools modules. |
187 |
|
188 |
At the same time, packages can meet their dependency on Setuptools |
189 |
without actually installing it (which would disable Distribute). |
190 |
|
191 |
- **How does Distribute interact with virtualenv?** |
192 |
|
193 |
Everytime you create a virtualenv it will install setuptools by default. |
194 |
You either need to re-install Distribute in it right after or pass the |
195 |
``--distribute`` option when creating it. |
196 |
|
197 |
Once installed, your virtualenv will use Distribute transparently. |
198 |
|
199 |
Although, if you have Setuptools installed in your system-wide Python, |
200 |
and if the virtualenv you are in was generated without the `--no-site-packages` |
201 |
option, the Distribute installation will stop. |
202 |
|
203 |
You need in this case to build a virtualenv with the `--no-site-packages` |
204 |
option or to install `Distribute` globally. |
205 |
|
206 |
- **How does Distribute interacts with zc.buildout?** |
207 |
|
208 |
You can use Distribute in your zc.buildout, with the --distribute option, |
209 |
starting at zc.buildout 1.4.2:: |
210 |
|
211 |
$ python bootstrap.py --distribute |
212 |
|
213 |
For previous zc.buildout versions, *the only thing* you need to do |
214 |
is use the bootstrap at `http://python-distribute.org/bootstrap.py`. Run |
215 |
that bootstrap and ``bin/buildout`` (and all other buildout-generated |
216 |
scripts) will transparently use distribute instead of setuptools. You do |
217 |
not need a specific buildout release. |
218 |
|
219 |
A shared eggs directory is no problem (since 0.6.6): the setuptools egg is |
220 |
left in place unmodified. So other buildouts that do not yet use the new |
221 |
bootstrap continue to work just fine. And there is no need to list |
222 |
``distribute`` somewhere in your eggs: using the bootstrap is enough. |
223 |
|
224 |
The source code for the bootstrap script is located at |
225 |
`http://bitbucket.org/tarek/buildout-distribute`. |
226 |
|
227 |
|
228 |
|
229 |
----------------------------- |
230 |
Feedback and getting involved |
231 |
----------------------------- |
232 |
|
233 |
- Mailing list: http://mail.python.org/mailman/listinfo/distutils-sig |
234 |
- Issue tracker: http://bitbucket.org/tarek/distribute/issues/ |
235 |
- Code Repository: http://bitbucket.org/tarek/distribute |
236 |
|
237 |
======= |
238 |
CHANGES |
239 |
======= |
240 |
|
241 |
------ |
242 |
0.6.19 |
243 |
------ |
244 |
|
245 |
* Issue 206: AttributeError: 'HTTPMessage' object has no attribute 'getheaders' |
246 |
|
247 |
|
248 |
------ |
249 |
0.6.18 |
250 |
------ |
251 |
|
252 |
* Issue 210: Fixed a regression introduced by Issue 204 fix. |
253 |
|
254 |
------ |
255 |
0.6.17 |
256 |
------ |
257 |
|
258 |
* Support 'DISTRIBUTE_DISABLE_VERSIONED_EASY_INSTALL_SCRIPT' environment |
259 |
variable to allow to disable installation of easy_install-${version} script. |
260 |
* Support Python >=3.1.4 and >=3.2.1. |
261 |
* Issue 204: Don't try to import the parent of a namespace package in |
262 |
declare_namespace |
263 |
* Issue 196: Tolerate responses with multiple Content-Length headers |
264 |
* Issue 205: Sandboxing doesn't preserve working_set. Leads to setup_requires |
265 |
problems. |
266 |
|
267 |
------ |
268 |
0.6.16 |
269 |
------ |
270 |
|
271 |
* Builds sdist gztar even on Windows (avoiding Issue 193). |
272 |
* Issue 192: Fixed metadata omitted on Windows when package_dir |
273 |
specified with forward-slash. |
274 |
* Issue 195: Cython build support. |
275 |
* Issue 200: Issues with recognizing 64-bit packages on Windows. |
276 |
|
277 |
------ |
278 |
0.6.15 |
279 |
------ |
280 |
|
281 |
* Fixed typo in bdist_egg |
282 |
* Several issues under Python 3 has been solved. |
283 |
* Issue 146: Fixed missing DLL files after easy_install of windows exe package. |
284 |
|
285 |
------ |
286 |
0.6.14 |
287 |
------ |
288 |
|
289 |
* Issue 170: Fixed unittest failure. Thanks to Toshio. |
290 |
* Issue 171: Fixed race condition in unittests cause deadlocks in test suite. |
291 |
* Issue 143: Fixed a lookup issue with easy_install. |
292 |
Thanks to David and Zooko. |
293 |
* Issue 174: Fixed the edit mode when its used with setuptools itself |
294 |
|
295 |
------ |
296 |
0.6.13 |
297 |
------ |
298 |
|
299 |
* Issue 160: 2.7 gives ValueError("Invalid IPv6 URL") |
300 |
* Issue 150: Fixed using ~/.local even in a --no-site-packages virtualenv |
301 |
* Issue 163: scan index links before external links, and don't use the md5 when |
302 |
comparing two distributions |
303 |
|
304 |
------ |
305 |
0.6.12 |
306 |
------ |
307 |
|
308 |
* Issue 149: Fixed various failures on 2.3/2.4 |
309 |
|
310 |
------ |
311 |
0.6.11 |
312 |
------ |
313 |
|
314 |
* Found another case of SandboxViolation - fixed |
315 |
* Issue 15 and 48: Introduced a socket timeout of 15 seconds on url openings |
316 |
* Added indexsidebar.html into MANIFEST.in |
317 |
* Issue 108: Fixed TypeError with Python3.1 |
318 |
* Issue 121: Fixed --help install command trying to actually install. |
319 |
* Issue 112: Added an os.makedirs so that Tarek's solution will work. |
320 |
* Issue 133: Added --no-find-links to easy_install |
321 |
* Added easy_install --user |
322 |
* Issue 100: Fixed develop --user not taking '.' in PYTHONPATH into account |
323 |
* Issue 134: removed spurious UserWarnings. Patch by VanLindberg |
324 |
* Issue 138: cant_write_to_target error when setup_requires is used. |
325 |
* Issue 147: respect the sys.dont_write_bytecode flag |
326 |
|
327 |
------ |
328 |
0.6.10 |
329 |
------ |
330 |
|
331 |
* Reverted change made for the DistributionNotFound exception because |
332 |
zc.buildout uses the exception message to get the name of the |
333 |
distribution. |
334 |
|
335 |
----- |
336 |
0.6.9 |
337 |
----- |
338 |
|
339 |
* Issue 90: unknown setuptools version can be added in the working set |
340 |
* Issue 87: setupt.py doesn't try to convert distribute_setup.py anymore |
341 |
Initial Patch by arfrever. |
342 |
* Issue 89: added a side bar with a download link to the doc. |
343 |
* Issue 86: fixed missing sentence in pkg_resources doc. |
344 |
* Added a nicer error message when a DistributionNotFound is raised. |
345 |
* Issue 80: test_develop now works with Python 3.1 |
346 |
* Issue 93: upload_docs now works if there is an empty sub-directory. |
347 |
* Issue 70: exec bit on non-exec files |
348 |
* Issue 99: now the standalone easy_install command doesn't uses a |
349 |
"setup.cfg" if any exists in the working directory. It will use it |
350 |
only if triggered by ``install_requires`` from a setup.py call |
351 |
(install, develop, etc). |
352 |
* Issue 101: Allowing ``os.devnull`` in Sandbox |
353 |
* Issue 92: Fixed the "no eggs" found error with MacPort |
354 |
(platform.mac_ver() fails) |
355 |
* Issue 103: test_get_script_header_jython_workaround not run |
356 |
anymore under py3 with C or POSIX local. Contributed by Arfrever. |
357 |
* Issue 104: remvoved the assertion when the installation fails, |
358 |
with a nicer message for the end user. |
359 |
* Issue 100: making sure there's no SandboxViolation when |
360 |
the setup script patches setuptools. |
361 |
|
362 |
----- |
363 |
0.6.8 |
364 |
----- |
365 |
|
366 |
* Added "check_packages" in dist. (added in Setuptools 0.6c11) |
367 |
* Fixed the DONT_PATCH_SETUPTOOLS state. |
368 |
|
369 |
----- |
370 |
0.6.7 |
371 |
----- |
372 |
|
373 |
* Issue 58: Added --user support to the develop command |
374 |
* Issue 11: Generated scripts now wrap their call to the script entry point |
375 |
in the standard "if name == 'main'" |
376 |
* Added the 'DONT_PATCH_SETUPTOOLS' environment variable, so virtualenv |
377 |
can drive an installation that doesn't patch a global setuptools. |
378 |
* Reviewed unladen-swallow specific change from |
379 |
http://code.google.com/p/unladen-swallow/source/detail?spec=svn875&r=719 |
380 |
and determined that it no longer applies. Distribute should work fine with |
381 |
Unladen Swallow 2009Q3. |
382 |
* Issue 21: Allow PackageIndex.open_url to gracefully handle all cases of a |
383 |
httplib.HTTPException instead of just InvalidURL and BadStatusLine. |
384 |
* Removed virtual-python.py from this distribution and updated documentation |
385 |
to point to the actively maintained virtualenv instead. |
386 |
* Issue 64: use_setuptools no longer rebuilds the distribute egg every |
387 |
time it is run |
388 |
* use_setuptools now properly respects the requested version |
389 |
* use_setuptools will no longer try to import a distribute egg for the |
390 |
wrong Python version |
391 |
* Issue 74: no_fake should be True by default. |
392 |
* Issue 72: avoid a bootstrapping issue with easy_install -U |
393 |
|
394 |
----- |
395 |
0.6.6 |
396 |
----- |
397 |
|
398 |
* Unified the bootstrap file so it works on both py2.x and py3k without 2to3 |
399 |
(patch by Holger Krekel) |
400 |
|
401 |
----- |
402 |
0.6.5 |
403 |
----- |
404 |
|
405 |
* Issue 65: cli.exe and gui.exe are now generated at build time, |
406 |
depending on the platform in use. |
407 |
|
408 |
* Issue 67: Fixed doc typo (PEP 381/382) |
409 |
|
410 |
* Distribute no longer shadows setuptools if we require a 0.7-series |
411 |
setuptools. And an error is raised when installing a 0.7 setuptools with |
412 |
distribute. |
413 |
|
414 |
* When run from within buildout, no attempt is made to modify an existing |
415 |
setuptools egg, whether in a shared egg directory or a system setuptools. |
416 |
|
417 |
* Fixed a hole in sandboxing allowing builtin file to write outside of |
418 |
the sandbox. |
419 |
|
420 |
----- |
421 |
0.6.4 |
422 |
----- |
423 |
|
424 |
* Added the generation of `distribute_setup_3k.py` during the release. |
425 |
This close http://bitbucket.org/tarek/distribute/issue/52. |
426 |
|
427 |
* Added an upload_docs command to easily upload project documentation to |
428 |
PyPI's http://packages.python.org. |
429 |
This close http://bitbucket.org/tarek/distribute/issue/56. |
430 |
|
431 |
* Fixed a bootstrap bug on the use_setuptools() API. |
432 |
|
433 |
----- |
434 |
0.6.3 |
435 |
----- |
436 |
|
437 |
setuptools |
438 |
========== |
439 |
|
440 |
* Fixed a bunch of calls to file() that caused crashes on Python 3. |
441 |
|
442 |
bootstrapping |
443 |
============= |
444 |
|
445 |
* Fixed a bug in sorting that caused bootstrap to fail on Python 3. |
446 |
|
447 |
----- |
448 |
0.6.2 |
449 |
----- |
450 |
|
451 |
setuptools |
452 |
========== |
453 |
|
454 |
* Added Python 3 support; see docs/python3.txt. |
455 |
This closes http://bugs.python.org/setuptools/issue39. |
456 |
|
457 |
* Added option to run 2to3 automatically when installing on Python 3. |
458 |
This closes http://bitbucket.org/tarek/distribute/issue/31. |
459 |
|
460 |
* Fixed invalid usage of requirement.parse, that broke develop -d. |
461 |
This closes http://bugs.python.org/setuptools/issue44. |
462 |
|
463 |
* Fixed script launcher for 64-bit Windows. |
464 |
This closes http://bugs.python.org/setuptools/issue2. |
465 |
|
466 |
* KeyError when compiling extensions. |
467 |
This closes http://bugs.python.org/setuptools/issue41. |
468 |
|
469 |
bootstrapping |
470 |
============= |
471 |
|
472 |
* Fixed bootstrap not working on Windows. |
473 |
This closes http://bitbucket.org/tarek/distribute/issue/49. |
474 |
|
475 |
* Fixed 2.6 dependencies. |
476 |
This closes http://bitbucket.org/tarek/distribute/issue/50. |
477 |
|
478 |
* Make sure setuptools is patched when running through easy_install |
479 |
This closes http://bugs.python.org/setuptools/issue40. |
480 |
|
481 |
----- |
482 |
0.6.1 |
483 |
----- |
484 |
|
485 |
setuptools |
486 |
========== |
487 |
|
488 |
* package_index.urlopen now catches BadStatusLine and malformed url errors. |
489 |
This closes http://bitbucket.org/tarek/distribute/issue/16 and |
490 |
http://bitbucket.org/tarek/distribute/issue/18. |
491 |
|
492 |
* zip_ok is now False by default. This closes |
493 |
http://bugs.python.org/setuptools/issue33. |
494 |
|
495 |
* Fixed invalid URL error catching. http://bugs.python.org/setuptools/issue20. |
496 |
|
497 |
* Fixed invalid bootstraping with easy_install installation |
498 |
http://bitbucket.org/tarek/distribute/issue/40. |
499 |
Thanks to Florian Schulze for the help. |
500 |
|
501 |
* Removed buildout/bootstrap.py. A new repository will create a specific |
502 |
bootstrap.py script. |
503 |
|
504 |
|
505 |
bootstrapping |
506 |
============= |
507 |
|
508 |
* The boostrap process leave setuptools alone if detected in the system |
509 |
and --root or --prefix is provided, but is not in the same location. |
510 |
This closes http://bitbucket.org/tarek/distribute/issue/10. |
511 |
|
512 |
--- |
513 |
0.6 |
514 |
--- |
515 |
|
516 |
setuptools |
517 |
========== |
518 |
|
519 |
* Packages required at build time where not fully present at install time. |
520 |
This closes http://bitbucket.org/tarek/distribute/issue/12. |
521 |
|
522 |
* Protected against failures in tarfile extraction. This closes |
523 |
http://bitbucket.org/tarek/distribute/issue/10. |
524 |
|
525 |
* Made Jython api_tests.txt doctest compatible. This closes |
526 |
http://bitbucket.org/tarek/distribute/issue/7. |
527 |
|
528 |
* sandbox.py replaced builtin type file with builtin function open. This |
529 |
closes http://bitbucket.org/tarek/distribute/issue/6. |
530 |
|
531 |
* Immediately close all file handles. This closes |
532 |
http://bitbucket.org/tarek/distribute/issue/3. |
533 |
|
534 |
* Added compatibility with Subversion 1.6. This references |
535 |
http://bitbucket.org/tarek/distribute/issue/1. |
536 |
|
537 |
pkg_resources |
538 |
============= |
539 |
|
540 |
* Avoid a call to /usr/bin/sw_vers on OSX and use the official platform API |
541 |
instead. Based on a patch from ronaldoussoren. This closes |
542 |
http://bitbucket.org/tarek/distribute/issue/5. |
543 |
|
544 |
* Fixed a SandboxViolation for mkdir that could occur in certain cases. |
545 |
This closes http://bitbucket.org/tarek/distribute/issue/13. |
546 |
|
547 |
* Allow to find_on_path on systems with tight permissions to fail gracefully. |
548 |
This closes http://bitbucket.org/tarek/distribute/issue/9. |
549 |
|
550 |
* Corrected inconsistency between documentation and code of add_entry. |
551 |
This closes http://bitbucket.org/tarek/distribute/issue/8. |
552 |
|
553 |
* Immediately close all file handles. This closes |
554 |
http://bitbucket.org/tarek/distribute/issue/3. |
555 |
|
556 |
easy_install |
557 |
============ |
558 |
|
559 |
* Immediately close all file handles. This closes |
560 |
http://bitbucket.org/tarek/distribute/issue/3. |
561 |
|
562 |
|
563 |
Keywords: CPAN PyPI distutils eggs package management |
564 |
Platform: UNKNOWN |
565 |
Classifier: Development Status :: 5 - Production/Stable |
566 |
Classifier: Intended Audience :: Developers |
567 |
Classifier: License :: OSI Approved :: Python Software Foundation License |
568 |
Classifier: License :: OSI Approved :: Zope Public License |
569 |
Classifier: Operating System :: OS Independent |
570 |
Classifier: Programming Language :: Python |
571 |
Classifier: Programming Language :: Python :: 3 |
572 |
Classifier: Topic :: Software Development :: Libraries :: Python Modules |
573 |
Classifier: Topic :: System :: Archiving :: Packaging |
574 |
Classifier: Topic :: System :: Systems Administration |
575 |
Classifier: Topic :: Utilities |