cal-gitlab-releases

Download and upload release assets for GitLab projects and groups.

Installation

pip install cal-gitlab-releases

Usage

# Download release assets from a group
cal-gitlab-releases download -u https://gitlab.com -p myorg/public -o ./releases

# Upload release assets to a target GitLab
cal-gitlab-releases upload -u https://gitlab.example.com -p target-group -i ./releases -t TOKEN

Commands

download

Download release assets from GitLab projects or groups. Supports version filtering, manifest-based incremental downloads, and parallel threads.

Use --flat to download all files into a single directory (useful for manual inspection). Note that flat output cannot be used with the upload command, which requires the project/tag directory structure.

Size limits

Use --max-file-size (-S) to skip individual files larger than a threshold, and --max-total-size (-T) to cap the total bytes downloaded in a single session. Both accept human-readable suffixes: K, M, G, T (e.g., 500M, 10G). Files skipped due to size limits are recorded in the manifest so they are not re-attempted on subsequent runs. Files skipped by the total size budget are not recorded, so the next run will pick them up.

upload

Upload release assets to GitLab. Reads the same directory structure produced by download, creates releases if they don't exist, and attaches asset files as release links.

Configuration

Settings can be provided via CLI args, environment variables, or a config file at ~/.config/cal-gitlab-releases/config.json:

{
    "gitlab_url": "https://gitlab.example.com",
    "token": "glpat-xxxxxxxxxxxx",
    "base_group": "myorg",
    "output": "./downloads",
    "version_filter": "release",
    "parallel": 32,
    "max_file_size": "500M",
    "max_total_size": "10G",
    "project_exclude": ["private/tools/harproxy"]
}

Licence

MIT License — Copyright (c) 2026 Cyber Assessment Labs