Mercurial > hg > fetch
annotate README.txt @ 52:c9f2311dedea
inherit from the right ABC
| author | Jeff Hammel <jhammel@mozilla.com> |
|---|---|
| date | Tue, 15 Nov 2011 15:14:45 -0800 |
| parents | 738d84b4de52 |
| children | 81fe0523a078 |
| rev | line source |
|---|---|
| 0 | 1 fetch |
| 20 | 2 ===== |
| 0 | 3 |
| 4 fetch stuff from the interwebs | |
| 5 | |
| 20 | 6 |
| 0 | 7 Format |
| 8 ------ | |
| 9 | |
| 20 | 10 `fetch` fetches from a manifest of the format:: |
| 11 | |
| 12 [URL] [Destination] [Type] | |
| 13 | |
| 14 A URL can contain a hash tag (e.g. http://example.com/foo#bar/fleem) | |
| 15 which is used to extract the subdirectories from a multi-directory | |
| 16 resource. | |
| 17 | |
| 18 The `Type` of the resource is used to dispatch to the included | |
| 19 Fetchers that take care of fetching the object. | |
| 20 | |
| 21 | |
| 22 Fetchers | |
| 23 -------- | |
| 24 | |
| 25 `fetch` includes several objects for fetching resources:: | |
|
13
3fee8ecd1af8
restructure while we still just have one module
Jeff Hammel <jhammel@mozilla.com>
parents:
0
diff
changeset
|
26 |
| 20 | 27 file : fetch a single file |
| 28 tar : fetch and extract a tarball | |
| 29 hg : checkout a mercurial repository | |
| 30 git : checkout a git repository | |
| 31 | |
| 32 The `file` fetcher cannot have a hash tag subpath since it is a single | |
| 33 resource. | |
| 34 | |
| 35 Though `fetch` has a set of fetchers included, you can pass an | |
| 36 arbitrary list into `fetch.Fetch`'s constructor. | |
| 37 | |
| 38 | |
| 39 Version Control | |
| 40 --------------- | |
| 41 | |
| 42 The `hg` and the `git` fetchers fetch from version control systems and | |
| 43 have additional options. | |
| 0 | 44 |
| 45 | |
| 46 ---- | |
| 47 | |
| 48 Jeff Hammel | |
|
13
3fee8ecd1af8
restructure while we still just have one module
Jeff Hammel <jhammel@mozilla.com>
parents:
0
diff
changeset
|
49 http://k0s.org/mozilla/hg/fetch |