comparison README.txt @ 79:f42df1456565

add a giant example section
author Jeff Hammel <jhammel@mozilla.com>
date Fri, 02 Mar 2012 16:25:05 -0800
parents d5c3fdceb718
children 0f3603a3d37d
comparison
equal deleted inserted replaced
78:d5c3fdceb718 79:f42df1456565
29 under ``/index/`` and the ``SimPyPI`` app at ``/``. Additionally, a 29 under ``/index/`` and the ``SimPyPI`` app at ``/``. Additionally, a
30 ``simpypi`` command line program is provided that front-ends this. 30 ``simpypi`` command line program is provided that front-ends this.
31 31
32 Currently ``simpypi`` only works on source distributions (that is, 32 Currently ``simpypi`` only works on source distributions (that is,
33 packages made with ``python setup.py sdist``). 33 packages made with ``python setup.py sdist``).
34
35 Example
36 -------
37
38 I installed an instance of ``simpypi`` at http://k0s.org:8080 for
39 demonstration purposes with a package index at http://k0s.org:8080/index/ .
40 For testing purposes, I made a script,
41 `upload_mobase.py <http://k0s.org/mozilla/hg/simpypi/file/tip/tests/upload_mozbase.py>`_
42 that uploads the
43 `mozbase <https://github.com/mozilla/mozbase>`_ packages to
44 ``simpypi``. So the
45 `index <http://k0s.org:8080/index/>`_ is now populated with them.
46
47 You can upload packages with
48 `curl <http://www.cs.sunysb.edu/documentation/curl/>`_ ::
49
50 > wget http://pypi.python.org/packages/source/P/PyYAML/PyYAML-3.10.tar.gz
51 > curl -F 'package=@PyYAML-3.10.tar.gz' http://k0s.org:8080/
52
53 You can ``easy_install`` mozbase from http://k0s.org:8080/index/ .
54 If a package's dependencies can be found from the ``simpypi`` package
55 index, they will also be installed from the index::
56
57 > virtualenv.py tmp
58 New python executable in tmp/bin/python
59 Installing setuptools............done.
60 Installing pip...............done.
61 > cd tmp/
62 (tmp)│easy_install -i http://k0s.org:8080/index/ mozrunner
63 Searching for mozrunner
64 Reading http://k0s.org:8080/index/mozrunner/
65 Best match: mozrunner 5.1
66 Downloading http://k0s.org:8080/index/mozrunner/mozrunner-5.1.tar.gz
67 Processing mozrunner-5.1.tar.gz
68 Running mozrunner-5.1/setup.py -q bdist_egg --dist-dir
69 /tmp/easy_install-gqerOV/mozrunner-5.1/egg-dist-tmp-Qyx3Cr
70 Adding mozrunner 5.1 to easy-install.pth file
71 Installing mozrunner script to /home/jhammel/tmp/bin
72 Installed
73 /home/jhammel/tmp/lib/python2.7/site-packages/mozrunner-5.1-py2.7.egg
74 Processing dependencies for mozrunner
75 Searching for mozprofile>=0.1
76 Reading http://k0s.org:8080/index/mozprofile/
77 Best match: mozprofile 0.1
78 Downloading http://k0s.org:8080/index/mozprofile/mozprofile-0.1.tar.gz
79 Processing mozprofile-0.1.tar.gz
80 Running mozprofile-0.1/setup.py -q bdist_egg --dist-dir
81 /tmp/easy_install-4Im6x0/mozprofile-0.1/egg-dist-tmp-9Jp5TR
82 Adding mozprofile 0.1 to easy-install.pth file
83 Installing mozprofile script to /home/jhammel/tmp/bin
84 Installed
85 /home/jhammel/tmp/lib/python2.7/site-packages/mozprofile-0.1-py2.7.egg
86 Searching for mozprocess
87 Reading http://k0s.org:8080/index/mozprocess/
88 Best match: mozprocess 0.1b2
89 Downloading
90 http://k0s.org:8080/index/mozprocess/mozprocess-0.1b2.tar.gz
91 Processing mozprocess-0.1b2.tar.gz
92 Running mozprocess-0.1b2/setup.py -q bdist_egg --dist-dir
93 /tmp/easy_install-KU6AiF/mozprocess-0.1b2/egg-dist-tmp-4j5CMP
94 Adding mozprocess 0.1b2 to easy-install.pth file
95 Installed
96 /home/jhammel/tmp/lib/python2.7/site-packages/mozprocess-0.1b2-py2.7.egg
97 Searching for mozinfo
98 Reading http://k0s.org:8080/index/mozinfo/
99 Best match: mozinfo 0.3.3
100 Downloading http://k0s.org:8080/index/mozinfo/mozinfo-0.3.3.tar.gz
101 Processing mozinfo-0.3.3.tar.gz
102 Running mozinfo-0.3.3/setup.py -q bdist_egg --dist-dir
103 /tmp/easy_install-JaKeaz/mozinfo-0.3.3/egg-dist-tmp-xWojez
104 Adding mozinfo 0.3.3 to easy-install.pth file
105 Installing mozinfo script to /home/jhammel/tmp/bin
106 Installed
107 /home/jhammel/tmp/lib/python2.7/site-packages/mozinfo-0.3.3-py2.7.egg
108 Searching for ManifestDestiny>=0.5.4
109 Reading http://k0s.org:8080/index/ManifestDestiny/
110 Best match: ManifestDestiny 0.5.4
111 Downloading
112 http://k0s.org:8080/index/ManifestDestiny/ManifestDestiny-0.5.4.tar.gz
113 Processing ManifestDestiny-0.5.4.tar.gz
114 Running ManifestDestiny-0.5.4/setup.py -q bdist_egg --dist-dir
115 /tmp/easy_install-2blF3S/ManifestDestiny-0.5.4/egg-dist-tmp-R3KZde
116 Adding ManifestDestiny 0.5.4 to easy-install.pth file
117 Installing manifestparser script to /home/jhammel/tmp/bin
118 Installed
119 /home/jhammel/tmp/lib/python2.7/site-packages/ManifestDestiny-0.5.4-py2.7.egg
120 Finished processing dependencies for mozrunner
121
122 Note that all of the packages come from the k0s.org installation and
123 not from http://pypi.python.org/ .
124
34 125
35 Running the Tests 126 Running the Tests
36 ----------------- 127 -----------------
37 128
38 The 129 The