new blog post: introducing sources.debian.net
[homepage.git] / blog / posts / 2013 / 07 / introducing_sources.debian.net.mdwn
1 # all Debian source are belong to us
2
3 **TL;DR**: go to **<http://sources.debian.net>** and enjoy.
4
5 ----
6
7 [**Debsources**](http://anonscm.debian.org/gitweb/?p=qa/debsources.git) is a
8 new toy I've been working on at [IRILL](http://www.irill.org) together with
9 [Matthieu Caneill](http://matthieu-blog.fr/). In essence, debsources is a
10 simple web application that allows to **publish an unpacked Debian source
11 mirror on the Web**.
12
13 You can deploy Debsources where you please, but there is a main instance at
14 **<http://sources.debian.net>** (`sources.d.n` for short) that you will
15 probably find interesting. `sources.d.n` follows closely the Debian archive in
16 two ways:
17
18 1. it is updated 4 times a day to reflect the content of the Debian archive
19 2. it contains sources coming from official Debian suites: the usual ones
20    (from oldstable to experimental), `*-updates` (ex volatile),
21    `*-proposed-updates`, and `*-backports` (from Wheezy on)
22
23 Via `sources.d.n` you can therefore browse the content of Debian source
24 packages with usual code viewing features like **syntax highlighting**. More
25 interestingly, you can **search through** the source code (of unstable only,
26 though) via integration with <http://codesearch.debian.net>. You can also use
27 `sources.d.n` programmatically to
28 [query available versions](http://sources.debian.net/doc/api/) or
29 [**link to specific lines**](http://sources.debian.net/doc/url/), with the
30 possibility of adding contextual **pop-up messages**
31 ([example](http://sources.debian.net/src/cowsay/3.03%2Bdfsg1-4/cowsay?hl=22:28&msg=22:Cowsay:See?%20Cowsay%20variables%20are%20declared%20here.#L22)).
32
33 In fact, you might have stumbled upon `sources.d.n` already in the past few
34 days, via other popular Debian services where it has already been integrated.
35 In particular: `codesearch.d.n` now defaults to show results via `sources.d.n`,
36 and the [PTS](http://packages.qa.debian.org/) has grown new "browse source
37 code" hyperlinks that point to it. If you've ideas of other Debian services
38 where `sources.d.n` should be integrated, please let me know.
39
40 I find Debsources and `sources.d.n` already quite useful but, as it often
41 happens, there is still a lot
42 [**TODO**](http://anonscm.debian.org/gitweb/?p=qa/debsources.git;a=blob;f=TODO;hb=HEAD).
43 Obviously, it is all Free Software (released under GNU AGPLv3). Do not hesitate
44 to report new bugs and, better, to submit patches for the outstanding ones.
45
46
47 ## Acknowledgements
48
49 * [Matthieu Caneill](http://matthieu-blog.fr/) is the main developer of
50   Debsources web front-end; `sources.d.n` wouldn't exist without him.
51 * others have already contributed patches to integrate `sources.d.n` with other
52   services, in particular:
53   * many thanks to Michael Stapelberg (for `codesearch.d.n` integration), and
54   * Paul Wise (for PTS integration).
55 * a full list of
56   [contributors](http://anonscm.debian.org/gitweb/?p=qa/debsources.git;a=blob;f=AUTHORS;hb=HEAD)
57   is available and eagerly waiting for new additions
58 * [IRILL](http://www.irill.org) has kindly provided sponsoring for Matthieu's
59   initial development work on Debsources, and offered both the server and
60   hosting facilities that power `sources.d.n`
61
62 **PS** in case you were wondering: at present `sources.d.n` requires **~381
63 GB** of disk space to hold all uncompressed source packages, plus ~83 GB for
64 the local (compressed) source mirror
65
66 [[!tag lang/english planet-debian debian qa debsources irill pts]]