cupage
integration¶
cupage is used to keep packages in sync with their releases. cupage
v0.5.4, or above, is required if you wish to make use of this functionality.
All packages in this repository must have an entry in cupage
configuration
file support/cupage.conf
, and those entries are generated from the
watch
files in package directories.
watch
file format¶
For packages hosted on one of the hosting sites supported by cupage
a
watch
file can be very simple [1]. For example, the watch
file
for dev-python/aaargh
contains only one line:
site = pypi
The above definition tells cupage
to check for updates to the package named
argh
on PyPI.
For packages where the name differs between upstream and this repository for
some reason you must specify the name in the watch
file. From
dev-python/pyscss
:
[pyScss]
site = pypi
If the package you are adding is not in the list of supported sites then you’ll
need to manually define the watch
information.
app-misc/weatherspect
provides a useful example:
url = http://www.robobunny.com/projects/weatherspect/
select = td a
match_type = re
match = weatherspect_v[\d\.]+\.tar\.gz
This tells cupage
to search the defined URL for a
elements that are
children of td
in the HTML, and to match their href
attributes against
the match
regular expression.
A more thorough explanation of the format and available options can be found in the cupage documentation.
[1] | Use cupage.py --list-sites to see the list supported sites
in your version of cupage |