|
1 Metadata-Version: 1.0 |
|
2 Name: infrae.subversion |
|
3 Version: 1.4.5 |
|
4 Summary: Buildout recipe for checking out from subversion |
|
5 Home-page: https://svn.infrae.com/buildout/infrae.subversion/trunk/ |
|
6 Author: Eric Casteleijn, Guido Wesdorp, Daniel Nouri, Sylvain Viollon and Reinout van Rees |
|
7 Author-email: info@infrae.com |
|
8 License: ZPL 2.1 |
|
9 Description: infrae.subversion |
|
10 ================= |
|
11 |
|
12 This zc.buildout recipe will check out a *number* of URLs into its |
|
13 parts directory. It won't remove its parts directory if there are any |
|
14 changes in the checkout, so it's safe to work with that checkout for |
|
15 development. |
|
16 |
|
17 This is an example buildout part that uses this recipe:: |
|
18 |
|
19 [development-products] |
|
20 recipe = infrae.subversion |
|
21 urls = |
|
22 https://svn.plone.org/svn/collective/PDBDebugMode/trunk PDBDebugMode |
|
23 |
|
24 This will maintain a working copy of ``PDBDebugMode`` in the |
|
25 ``parts/development-products/PDBDebugMode`` directory (*not* in the |
|
26 parts directory itself). Thus, the recipe handles multiple URLs fine. |
|
27 |
|
28 You can select a different location with ``location``, for instance:: |
|
29 |
|
30 location = src |
|
31 |
|
32 Will extract ``PDBDebugMode`` in ``src/PDBDebugMode`` instead of |
|
33 ``parts``. |
|
34 |
|
35 If you have ``pysvn`` installed on the computer, it will be used. This |
|
36 implies better performances. |
|
37 |
|
38 Update |
|
39 ------ |
|
40 |
|
41 By default, when buildout update the part, an ``svn up`` is done for |
|
42 each link. However, when a revision number is specified like this:: |
|
43 |
|
44 https://svn.infrae.com/buildout/infrae.subversion/trunk@27829 |
|
45 |
|
46 The SVN link is skipped for update. If you want to prevent update for |
|
47 all SVN link of the part even if they do not contain revision number, |
|
48 you can add the following option:: |
|
49 |
|
50 ignore_updates = true |
|
51 |
|
52 Export |
|
53 ------ |
|
54 |
|
55 With ``pysvn`` installed, you can specify:: |
|
56 |
|
57 export = true |
|
58 |
|
59 in your buildout part to get an SVN export instead of an SVN checkout. |
|
60 |
|
61 Verification |
|
62 ------------ |
|
63 |
|
64 By default, your checkout are checked against local modification |
|
65 before any uninstallation step. This can take time on large checkouts, |
|
66 and you may don't want it in some case (like when used on buildbot for |
|
67 instance). To prevent this step, you can use this option:: |
|
68 |
|
69 ignore_verification = true |
|
70 |
|
71 As well, when the recipe update it can emit some warnings because a |
|
72 directory have been removed. You can suppress that warning with:: |
|
73 |
|
74 no_warnings = true |
|
75 |
|
76 The verification will still be done, and the directory will be checked |
|
77 out again to replace the missing one. |
|
78 |
|
79 Eggs |
|
80 ---- |
|
81 |
|
82 If you set the option ``as_eggs`` in your configuration file, |
|
83 checkouted URLs will be registered as development eggs in your |
|
84 buildout. This only work for non-recipe development eggs. |
|
85 |
|
86 .. warning:: If you add a new egg, this will trigger a new |
|
87 uninstall-reinstall cycle. You may want to use that option to setup |
|
88 eggs coming from SVN for production, but not for development. |
|
89 |
|
90 Exported Variables |
|
91 ------------------ |
|
92 |
|
93 If you set:: |
|
94 |
|
95 export_info = true |
|
96 |
|
97 Two variables will be exported by this recipe: |
|
98 |
|
99 - ``revisions`` which gives for each URL the corresponding revision |
|
100 number, |
|
101 |
|
102 - ``updated`` which gives a list of URLs which have been updated with |
|
103 new code. |
|
104 |
|
105 Since values to these variables changes each time you run buildout |
|
106 (revision number changes), this trigger an uninstall/reinstall of the |
|
107 part. We recommand to activate it only if you need it. |
|
108 |
|
109 Is always exported a variable ``location`` to say where are done the |
|
110 checkouts, and a variable ``eggs`` which contains a list of |
|
111 checkouted eggs. |
|
112 |
|
113 Sample |
|
114 ------ |
|
115 |
|
116 For an example buildout that uses this recipe, please see the `Silva |
|
117 buildout <https://svn.infrae.com/buildout/silva/trunk>`_. |
|
118 |
|
119 As well, the `doctest file |
|
120 <https://svn.infrae.com/buildout/infrae.subversion/trunk/infrae/subversion/tests/IMPL.txt>`_ |
|
121 can provide more sample. |
|
122 |
|
123 Latest version |
|
124 -------------- |
|
125 |
|
126 The latest version is available in a `Subversion repository |
|
127 <https://svn.infrae.com/buildout/infrae.subversion/trunk#egg=infrae.subversion-dev>`_. |
|
128 |
|
129 |
|
130 Changes |
|
131 ------- |
|
132 |
|
133 1.4.5 (2009-01-29) |
|
134 ~~~~~~~~~~~~~~~~~~ |
|
135 |
|
136 - Fix an error when some path have been added to the checkout |
|
137 path. [eric] |
|
138 |
|
139 - Still eggify and export information on update when running as |
|
140 non-newest mode. [sylvain] |
|
141 |
|
142 1.4.4 (2009-01-28) |
|
143 ~~~~~~~~~~~~~~~~~~ |
|
144 |
|
145 - Add a ``no_warnings`` options which remove some warnings when |
|
146 updating a part. [sylvain] |
|
147 |
|
148 1.4.3 (2009-01-21) |
|
149 ~~~~~~~~~~~~~~~~~~ |
|
150 |
|
151 - Add a login callback for people using PySVN. This let users |
|
152 authenticate to an unauthorized svn. Thanks to Martin Stadler |
|
153 (martin at siarp.de) for this fix. [sylvain] |
|
154 |
|
155 1.4.2 (2009-01-05) |
|
156 ~~~~~~~~~~~~~~~~~~ |
|
157 |
|
158 - Automatically ignore ``.pyc`` and ``.pyo`` files while checking for |
|
159 modified/added/removed files. [sylvain] |
|
160 |
|
161 - Fix bug so ``.svn`` directory is really ignored when checking for |
|
162 added paths in the checkout directory. [sylvain] |
|
163 |
|
164 1.4.1 (2008-10-31) |
|
165 ~~~~~~~~~~~~~~~~~~ |
|
166 |
|
167 Bug fix: |
|
168 |
|
169 - Correct typo in README.txt. [sylvain] |
|
170 |
|
171 - Ignore ``.svn`` directory when checking for added ones at |
|
172 uninstall. [sylvain] |
|
173 |
|
174 1.4 (2008-10-31) |
|
175 ~~~~~~~~~~~~~~~~ |
|
176 |
|
177 New features: |
|
178 |
|
179 - Added ``location`` option that allows you to override the default |
|
180 /parts/partname location. [reinout] |
|
181 |
|
182 - Added ``as_eggs`` option that installs the checkouts as development |
|
183 eggs. [reinout] |
|
184 |
|
185 Bug fix: |
|
186 |
|
187 - Don't export revisions information if you're offline with Py. Py |
|
188 tries to connect to the SVN repository to do a 'svn info'. [sylvain] |
|
189 |
|
190 1.3.1 |
|
191 ~~~~~ |
|
192 |
|
193 Bug fix: |
|
194 |
|
195 - don't try to collect export information if you have a svn |
|
196 export. [sylvain] |
|
197 |
|
198 - path were exported instead of URLs in the Native |
|
199 implementation. [sylvain] |
|
200 |
|
201 1.3 |
|
202 ~~~ |
|
203 |
|
204 - Remove the restriction to py 0.9.0, now that py 0.9.2 is out and fix |
|
205 problems on svn status with strange userid. [sylvain] |
|
206 |
|
207 - Correct an error rendering. [sylvain] |
|
208 |
|
209 - Export information only for top level svn URLs in the native |
|
210 implementation, this used to inject information from svn:externals |
|
211 links included in URL list. [sylvain] |
|
212 |
|
213 - Add tests for export information feature. [tlotze] |
|
214 |
|
215 - Correct URL in setup.py [sylvain]. |
|
216 |
|
217 1.2 |
|
218 ~~~ |
|
219 |
|
220 - Refactor code, performances should be better at uninstall with Py |
|
221 implementation [sylvain]. |
|
222 |
|
223 - Look for the environment variable ``INFRAE_SUBVERSION_IMPL`` to |
|
224 select which implementation to use. Possible values are ``PYSVN`` |
|
225 (default) and ``PY`` [sylvain]. |
|
226 |
|
227 - Uninstall only look at directory which have been created by the |
|
228 recipe in the part. Other are just reported [sylvain]. |
|
229 |
|
230 - Export two new variables, if ``export_info`` is set to true: |
|
231 |
|
232 ``revisions`` |
|
233 |
|
234 Which is lines formatted:: |
|
235 |
|
236 link current_revision |
|
237 |
|
238 ``updated`` |
|
239 |
|
240 Which is lines containing updated links. |
|
241 |
|
242 |
|
243 [sylvain]. |
|
244 |
|
245 1.1 |
|
246 ~~~ |
|
247 |
|
248 - Add the ``ignore_verification`` option [sylvain]. |
|
249 |
|
250 1.0 |
|
251 ~~~ |
|
252 |
|
253 - Base version of the recipe. |
|
254 |
|
255 Keywords: subversion buildout |
|
256 Platform: UNKNOWN |
|
257 Classifier: Framework :: Buildout |
|
258 Classifier: License :: OSI Approved :: Zope Public License |
|
259 Classifier: Topic :: Software Development :: Version Control |