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>

Debian Utilities                                   2025-09-02                                 USCAN-TEMPLATES(5)