for managing repositories¶

pushrepo

Creates a new repository in the modules subgroup (with createrepo() and configurerepo()) and pushes the local repository.

createrepo repositoryname

Creates a new empty repository in the modules subgroup and calls configurerepo().

Parameters:

repositoryname

Name of the repository to be added; usually the package name. Required.

configurerepo repositoryid|repositoryname [--verbose]

Sets up the default webhooks and services for one repository.

Parameters:

repositoryid|repositoryname

The repository to be configured. Either its id (\d+) or name (\w+). Required.

Silent on success unless "--verbose" is given.

configurerepo --all [--attic] [--verbose] [--parallel N] [-j N]

Sets up the default webhooks and services for all active (or, with "--attic", archived) repositories.

Silent on success unless "--verbose" is given.

With "--parallel" Parallel::ForkManager is employed for parallelism.

changerepo repositoryid|repositoryname "name"|"description" "parameter"

Changes the name (and the path) or the description of a repository.

Parameters:

repositoryid|repositoryname

The repository to be configured. Either its id (\d+) or name (\w+). Required.

"name"|"description"

What should be changed? The "name" or the "description" of the repository. Required.

parameter

The new name or description. Required.

deleterepo repositoryid|repositoryname

Delete a repository (a.k.a project).

Parameters:

repositoryid|repositoryname

The repository to be deleted. Either its id (\d+) or name (\w+). Required.

listrepos [--json] [--attic]

Show all active (or, with "--attic", archived) repositories in the modules subgroup.

If used with "--all", returns repository ids and does not output anything; for internal use.

kgb repositoryid|repositoryname|--all [--attic] --on|--off

Install ("--on") or remove ("--off") the KGB IRC notification webhook for the given, all active ("--all"), or all archived ("--attic") repositories.

"--on" removes any legacy hooks (plain http, explicit port number) and replaces them with the canonical one. If the repository already uses the right hook, "--on" does nothing.

Parameters:

repositoryid|repositoryname

The repository to be configured. Either its id (\d+) or name (\w+). Required unless "--all" is used.

toattic|fromattic repositoryid|repositoryname

Moves a repository to/from the attic sub-group of the modules sub-group. Useful when a package is removed from the archive or added back.

Probably needs appropriate permissions.

for managing users¶

adduser username|userid [access_level]

Adds a user to the modules subgroup of the perl-team group.

Parameters:

username|userid

The user to be added. Either their id (\d+) or their username (\w+). Required.

access_level

One of GitLab's access levels: no_access, guest, reporter, developer, maintainer, owner. Optional, defaults to "maintainer".

removeuser username|userid

Removes a user from the modules subgroup of the perl-team group.

Parameters:

username|userid

The user to be removed. Either their id (\d+) or their username (\w+). Required.

changeuser access_level username|userid|--all

Change the access level of one or all user(s) in the modules subgroup of the perl-team group.

Parameters:

access_level

One of GitLab's access levels: guest, reporter, developer, maintainer, owner. Required.

username|userid

The user whose access level is to be changed. Either their id (\d+) or their username (\w+). Required, unless "--all" is used.

listmembers [--json]

Show all members of the modules subgroup of the perl-team group.

If used with "--all", returns user ids and does not output anything; for internal use.

others¶

mrconfig [--parallel N] [-j N]

Helper for creating

• a .mrconfig.packages file in the local clone of "meta.git" for all active packages of the modules subgroup of the perl-team group. Also writes to stdout which can be included from .mrconfig.
• .lastactivity/PKGNAME files in the local clone of "meta.git" for all active packages of the modules subgroup of the perl-team group which are then used by compare-lastactivity in .mrconfig.

With "--parallel" Parallel::ForkManager is employed for parallelism.

Additionally, the option will also output a list of repositories that potentially have not been configured with dpt-salsa.

current_user [--json]

Outputs information about the user whose GitLab token is used.

help

Same as option --help.

version [--json]

Returns the version of the GitLab instance running on salsa.debian.org.

This subcommand is pretty useless, the only excuse for its existence is the ability to test if everything is working fine.