github-release-downloader

GitHub Release Downloader

Python package to download/filter any release assets from the latest compatible version.

Installation

pip install github-release-downloader

Usage

This tool can be used as library:

from semantic_version import SimpleSpec
from github_release_downloader import check_and_download_updates, GitHubRepo
from pathlib import Path
import re


check_and_download_updates(
    GitHubRepo("OwnerName", "RepoName", "OptionallyToken"),  # Releases source
    SimpleSpec("~1.1"),  # Search 1.1.0 compatible version
    assets_mask=re.compile(".*\\.exe"),  # Download *.exe only
    downloads_dir=Path("downloads"),  # Where to download
)

Or either it can be used as cli-tool:

python -m github_release_downloader -u OwnerName -n RepoName -r ~1.1 -m .*\.exe -o .\downloads

Features

• Downloads compatible releases (or latest if no requirements set)
• Filters assets using regex
• Has optional download_callback
• CLI tool can be used in CI
• Handles token from GITHUB_TOKEN env
• Loads updates only when it's needed (caches last version used)
• Loggs own actions
• Uses only few GitHub API endpoints (don't download code, you've never needed)