Scroll to navigation

USCAN-TEMPLATES(5) USCAN-TEMPLATES(5)

NAME

uscan templates - Available templates for uscan(1).

USING TEMPLATES

Templates simplify the debian/watch file. You just have to indicate the template to use and the specific arguments. Example:

  Version: 5
  Template: Github
  Owner: guimard
  Project: llng-docker

Other parameters can be added as usual. Example:

  Version: 5
  Template: Github
  Owner: guimard
  Project: llng-docker
  Version-Mangle: auto

AVAILABLE TEMPLATES

Here is the list of available templates:

  • "Github"
  • "Metacpan"
  • "Npmregistry"
  • Gitlab

Github

This template uses GitHub API to find archives to download.

Specific parameters

  • Owner <owner>
  • Project <project>
  • Release-Only <yes>: when set, search only in "/release" instead of "/tags"

Example

Example for https://github.com/guimard/llng-docker:

  Version: 5
  Template: Github
  Owner: guimard
  Project: llng-docker

Metacpan

This template uses MetaCPAN::Client(3pm) to download package.

Specific parameters

•
Dist: distribution name (with "::" or "-")

Example

  Version: 5
  Template: Metacpan
  Dist: MetaCPAN-Client

Npmregistry

This template just replaces:

  Version: 5
  Template: Npmregistry
  Dist: @lemonldapng/handler

by:

  Version: 5
  Source: https://registry.npmjs.org/@lemonldapng/handler
  Matching-Pattern: https://registry.npmjs.org/@lemonldapng/handler/-/handler-@ANY_VERSION@@ARCHIVE_EXT@
  Searchmode: plain

Specific parameters

•
Dist: distribution name

Gitlab

This template uses Mode: gitlab to download package.

Specific parameters

  • Dist: URL to the project
  • Release-Only <yes>: when set, search only in "/release" instead of "/tags"

Example

  Version: 5
  Template: Gitlab
  Dist: https://salsa.debian.org/debian/devscripts

Adding templates

If you want to add a template in uscan, you can find the documentation here:

  $ perldoc /usr/share/perl5/Devscripts/Uscan/Templates.pod

Then build a merge-request into the devscripts project <https://salsa.debian.org/debian/devscripts>.

Authors

•
Xavier Guimard <yadd@debian.org>
2025-08-22 Debian Utilities