Skip to main content

GitLab Artifact Puller / Downloader

Project description


Python package PyPI

A GitLab Artifact Puller / Downloader

Quick Start

glap is a convenience tool to download artifacts of your frequently used GitLab repositories. Install via

pip install glap

Before you can use glap, you have to setup a configuration file named glap.toml. glap searches the file at the following locations (in this order):

  1. ./glap.toml
  2. ~/.config/glap/glap.toml (default location for configuration files on your OS; here for Linux)

It contains the following information:

  • Remotes with corresponding urls and access-tokens:
url = ""
private_token = "<my-private-token>"
oauth_token = "<my-oauth-token>"
job_token = "<my-job-token>"

Note that there must be exactly one authentication token specified.

  • Shortcuts for specific repositories. For example, the following shortcut points at the PDFs job of the main branch of
remote = "myremote"
namespace = "name"
repository = "repo"
ref = "main"
job = "PDFs"

Any configured shortcut will appear as a subcommand, i.e. you can use it as follows

glap myshortcut

Alternatively, you can specify the namespace and repository directly

glap download <namespace> <repository> -j <job> --ref <branch or tag>

If no remote is given, glap will use the first one in the configuration file. Otherwise, you can use

glap download <namespace> <repository> -r myremote

where myremote is the name of the remote in the configuration file.


  • --job (-j) specifies the job's name.
  • --ref specifies the name of the branch or tag from where the job is located.
  • --output (-o) specifies the download location.
  • --temp (-t) downloads the artifact to a temporary location and opens the directory.
  • --silent (-s) enables silent mode (exceptions only).
  • --verbose (-v) enables verbose mode (e.g. print file list).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

glap-0.3.1.tar.gz (5.1 kB view hashes)

Uploaded source

Built Distribution

glap-0.3.1-py3-none-any.whl (5.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page