Using uscan with VCS hosting sites

[Ben Finney <ben+debian@benfinney.id.au>]

Howdy all,

I have an upstream for a package who has started using a VCS hosting
site for publishing the code. It's possible they will continue to make
tarball releases, but in case they don't at some point in the future,
I'd like to use this as an opportunity to learn the capabilities of
‘uscan’.

The package in question is ‘python-coverage’, and already has a
‘debian/watch’ file:

=====
[…]
# Current version from Ned Batchelder's site
http://nedbatchelder.com/code/modules/coverage.html \
    code/modules/coverage-(.*).tar.gz
=====

The author is now publishing their source code for this package at
<URL:http://bitbucket.org/ned/coveragepy/>, a project hosting site using
Mercurial for VCS. That service makes available URLs for tags in VCS
repositories, but the tags are not in the URLs themselves, only in the
text of the ‘A’ elements:

=====
<li class="icon-tags">
    tags &raquo;
    <ul>
        <li><a href="/ned/coveragepy/src/b24b35f0448b/">tip</a></li>
        <li><a href="/ned/coveragepy/src/79dd373074de/">coverage-3.0b2</a></li>
        <li><a href="/ned/coveragepy/src/4105a4de000e/">coverage-3.0b1</a></li>
    </ul>
</li>
=====

The page at the URL for a specific tag (e.g. that for ‘coverage-3.0b2’,
<URL:http://bitbucket.org/ned/coveragepy/src/79dd373074de/>) has URLs
for “get source”, including tarball:

=====
<li><a class="link-download">get source »</a>
    <ul>
        <li><a rel="nofollow" href="/ned/coveragepy/get/79dd373074de.zip" class="zip">zip</a></li>
        <li><a rel="nofollow" href="/ned/coveragepy/get/79dd373074de.gz" class="compressed">gz</a></li>
        <li><a rel="nofollow" href="/ned/coveragepy/get/79dd373074de.bz2" class="compressed">bz2</a></li>
    </ul>
</li>
=====

So, how do I go from “the URL for the project source is
<URL:http://bitbucket.org/ned/coveragepy/>”, to a ‘debian/watch’ file
that will enable ‘uscan’ to know the current version is
‘coverage-3.0b2’, and its original source tarball is downloadable from
<URL:http://bitbucket.org/ned/coveragepy/get/79dd373074de.gz>?

-- 
 \     “Unix is an operating system, OS/2 is half an operating system, |
  `\    Windows is a shell, and DOS is a boot partition virus.” —Peter |
_o__)                                                        H. Coffin |
Ben Finney