Easily download releases from sites like Github and Gitea
Go to file
Ian Fijolek e147fad63c
All checks were successful
continuous-integration/drone/tag Build is passing
Bump version to 1.2.0
2022-10-11 12:41:30 -07:00
docs/source Update pre-commit and get tests passing 2022-01-05 20:27:37 -08:00
sample_pseudo_bin Add sample packaging implementation 2022-01-06 15:10:17 -08:00
.drone.star Deploy to test pypi for pushes to main 2022-07-08 12:52:24 -07:00
.gitignore Initial commit 2022-01-05 23:20:28 +00:00
.pre-commit-config.yaml Update pre-commit hooks 2022-04-04 20:14:57 -07:00
LICENSE Initial commit 2022-01-05 23:20:28 +00:00
Makefile Skip existing files in test pypi and do twine check every time 2022-08-31 13:20:23 -07:00
pseudo_builder.py Fix missing removeprefix in pseudo_builder.py 2022-06-30 19:48:35 -07:00
README.md Add new fetching of git tags 2022-01-07 11:08:37 -08:00
release_gitter_test.py Improve content type detection 2022-10-11 12:20:57 -07:00
release_gitter.py Improve content type detection 2022-10-11 12:20:57 -07:00
requirements-dev.txt Initial commit 2022-01-05 23:20:28 +00:00
setup.py Bump version to 1.2.0 2022-10-11 12:41:30 -07:00
tox.ini Support for python3.7 and python3.8 2022-06-30 15:37:24 -07:00

release-gitter

Easily download releases from sites like Github and Gitea

Original repo

Originally hosted at https://git.iamthefij.com/iamthefij/release-gitter.git

Installation

From pypi pip install release-gitter

Alternatively, you can download release_gitter.py and run that file as long as you have requests installed.

Usage

At minimum, release-gitter can be used to download the latest release file for a given repo using something like the following:

release-gitter --git-url https://github.com/coder/super-tool "super-tool-{version}-{system}-{arch}"

Originally created for downloading binary releases for pre-commit hooks, so it also has features to detect the remote repo automatically using git remote get-url origin, as well as detecting the currently checked out version by parsing metadata files (currently only Cargo.toml).

In practice, it means that for a project like StyLua, when run within the repo one would only need to provide:

release-gitter --extract-files "stylua" --exec "chmod +x stylua" \
    --map-system Windows=win64 --map-system Darwin=macos --map-system=linux=Linux \
    "stylua-{version}-{system}.zip"

And release-gitter will get the release version from the Cargo.toml, get the URL from the git remote, call the Github API and look for a release matching the templated file name, extract the stylua file from the archive, and then make it executable. Alternatively, if you're project --version-git-tag can be used to pull the version from the latest tag. This will automatically do a shallow fetch (depth = 1), but this can be supressed with --version-git-no-fetch.

This allows a single command to be run from a checked out repo from pre-commit on any system to fetch the appropriate binary.

Additionally, it can be used to simplify install instructions for users by providing the --git-url option so it can be run from outside the repo.

Full usage is as follows:

usage: release-gitter [-h] [--hostname HOSTNAME] [--owner OWNER] [--repo REPO]
                      [--git-url GIT_URL] [--version VERSION]
                      [--version-git-tag] [--version-git-no-fetch]
                      [--map-system MAP_SYSTEM] [--map-arch MAP_ARCH]
                      [--exec EXEC] [--extract-files EXTRACT_FILES]
                      [--extract-all] [--url-only]
                      format

positional arguments:
  format                Format template to match assets. Eg
                        `foo-{version}-{system}-{arch}.zip`

optional arguments:
  -h, --help            show this help message and exit
  --hostname HOSTNAME   Git repository hostname
  --owner OWNER         Owner of the repo. If not provided, it will be
                        retrieved from the git url
  --repo REPO           Repo name. If not provided, it will be retrieved from
                        the git url
  --git-url GIT_URL     Git repository URL. Overrides `git remote` detection,
                        but not command line options for hostname, owner, and
                        repo
  --version VERSION     Release version to download. If not provied, it will
                        look for project metadata
  --version-git-tag, -t
                        Get the release version from a git tag
  --version-git-no-fetch
                        Shallow fetch tags prior to checking versions
  --map-system MAP_SYSTEM, -s MAP_SYSTEM
                        Map a platform.system() value to a custom value
  --map-arch MAP_ARCH, -a MAP_ARCH
                        Map a platform.machine() value to a custom value
  --exec EXEC, -c EXEC  Shell commands to execute after download or extraction
  --extract-files EXTRACT_FILES, -e EXTRACT_FILES
                        A list of file name to extract from downloaded archive
  --extract-all, -x     Shell commands to execute after download or extraction
  --url-only            Only print the URL and do not download

Pre-Commit usage

This can be used a way to wrap a binary release from a Github or Gitea by adding a pyproject.toml file to your current project directory and adding a .pre-commit-hooks.yaml file.

Take a look at the ./sample_pseudo_bin directory to see an example.