CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[0.10.1] - 2026-01-02

Fixed

• Statically link liblzma and bzip2 dependencies to avoid missing shared library errors (#339)

[0.10.0] - 2025-12-08

Added

• Install RPM assets (#335)

• Download selection mode now supports wildcard pattern, using * and ? special characters, to select the first asset matching the given pattern (#271).

  This new feature is useful when release assets contain sections that change for each release (e.g. a build number or timestamp).

  For example, dra download -s 'helloworld*_amd64.deb' devmatteini/dra-tests.

  Selection mode is backward compatible with previous versions. You can still pass literal or untagged patterns.

Changed

• Rewrite download automatic mode, without any breaking change, to be more customizable, reliable and easier to maintain.

Fixed

• Handle more Windows OS formats in install script (#336)

Updated dependencies

• bump zip from 2.6.1 to 6.0.0
• bump uuid from 1.16.0 to 1.18.1
• bump url from 2.5.4 to 2.5.7
• bump ureq from 3.0.12 to 3.1.4
• bump serde from 1.0.219 to 1.0.228
• bump indicatif from 0.18.0 to 0.18.3
• bump flate2 from 1.1.2 to 1.1.5
• bump dialoguer from 0.11.0 to 0.12.0
• bump ctrlc from 3.4.7 to 3.5.1
• bump clap from 4.5.48 to 4.5.53
• bump clap_complete from 4.5.57 to 4.5.61
• bump bzip2 from 0.6.0 to 0.6.1
• bump assert_cmd from 2.0.17 to 2.1.1

[0.9.1] - 2025-11-11

Fixed

• Asset detection for automatic download on windows when win-64bit is used for both OS and ARCH (#333)

[0.9.0] - 2025-08-14

Added

• You can now also pass GitHub URL as repository argument to every subcommand (#307)

dra download https://github.com/devmatteini/dra-tests

[0.8.2] - 2025-05-28

• Fix windows executable by including static crt (#302)
• Improve bug report for automatic download error

Updated dependencies

• bump zip from 2.3.0 to 2.6.1
• bump uuid from 1.15.1 to 1.16.0
• bump ureq from 2.12.1 to 3.0.11
• bump serde from 1.0.218 to 1.0.219
• bump flate2 from 1.1.0 to 1.1.1
• bump ctrlc from 3.4.5 to 3.4.6
• bump clap from 4.5.31 to 4.5.37
• bump clap_complete from 4.5.46 to 4.5.48
• bump assert_cmd from 2.0.16 to 2.0.17

[0.8.1] - 2025-03-18

This is a maintenance release that updates our dependencies.

Updated dependencies

• bump zip from 2.2.2 to 2.3.0
• bump uuid from 1.11.0 to 1.15.1
• bump tar from 0.4.43 to 0.4.44
• bump serde from 1.0.217 to 1.0.218
• bump ring from 0.17.3 to 0.17.13
• bump indicatif from 0.17.9 to 0.17.11
• bump flate2 from 1.0.35 to 1.1.0
• bump clap from 4.5.23 to 4.5.31
• bump clap_complete from 4.5.40 to 4.5.46
• bump bzip2 from 0.5.0 to 0.5.2

[0.8.0] - 2025-01-21

Added

Before, you needed to export environment variable GITHUB_TOKEN to make authenticated requests to download assets from private repositories and avoid rate limit issues.

Now, you can also export one of the following environment variables:

1. DRA_GITHUB_TOKEN
2. GITHUB_TOKEN (same as before)
3. GH_TOKEN

If none of the above environment variables are set, the GitHub cli token (if available) will be used as default value.

If you would like to disable GitHub authentication, you can export the environment variable DRA_DISABLE_GITHUB_AUTHENTICATION=true

[0.7.1] - 2025-01-15

Added

Automated bash script for initial dra download (see README.md for more information)

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/devmatteini/dra/refs/heads/main/install.sh | bash -s -- --to <DESTINATION>

Changed

Improve install feature error message when no executables are found to provide more context to the user (based on #232)

Fixed

Automatic download on Linux prioritize musl-based archives when multiple musl assets are available, ensuring better compatibility across distributions. (#267)

Updated dependencies

• bump zip from 2.2.0 to 2.2.2
• bump ureq from 2.10.1 to 2.12.1
• bump tar from 0.4.42 to 0.4.43
• bump serde from 1.0.214 to 1.0.217
• bump predicates from 3.1.2 to 3.1.3
• bump itertools from 0.13.0 to 0.14.0
• bump indicatif from 0.17.8 to 0.17.9
• bump hashbrown from 0.15.0 to 0.15.2
• bump flate2 from 1.0.34 to 1.0.35
• bump clap from 4.5.20 to 4.5.23
• bump clap_complete from 4.5.34 to 4.5.40
• bump bzip2 from 0.4.4 to 0.5.0

[0.7.0] - 2024-11-22

Added

Install multiple executables from tar/zip archives in one command (#234, thanks @duong-dt for the initial implementation).

You can now specify -I/--install-file option multiple times:

$ dra download -s helloworld-many-executables-unix.tar.gz -I helloworld-v2 -I random-script devmatteini/dra-tests
# [...]
Extracted archive executable to '/home/<user>/helloworld-v2'
Extracted archive executable to '/home/<user>/random-script'
Installation completed!

Note that the following syntax is not valid as it's not backward compatible:

dra download -s helloworld-many-executables-unix.tar.gz -I helloworld-v2 random-script devmatteini/dra-tests
#                                                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#                                                       you can't pass space-separated values to -I

When you install multiple executables, --output must be a directory path.

Updated dependencies

• bump serde from 1.0.210 to 1.0.214
• bump clap from 4.5.18 to 4.5.20
• bump clap_complete from 4.5.29 to 4.5.34

[0.6.3] - 2024-10-27

Added

• dra is available on Homebrew for macOS/Linux
• install feature now works with 7-Zip files (#235)

Changed

• Review and improve dra [command] --help messages to be clearer

Updated dependencies

• bump zip from 0.6.6 to 2.2.0
• bump uuid from 1.10.0 to 1.11.0
• bump tar from 0.4.40 to 0.4.42
• bump serde from 1.0.209 to 1.0.210
• bump flate2 from 1.0.33 to 1.0.34
• bump clap from 4.5.16 to 4.5.18
• bump clap_complete from 4.5.24 to 4.5.29

[0.6.2] - 2024-09-07

Fixed

• Asset detection for automatic download on windows when win64 is used for both OS and ARCH (#224)

Updated dependencies

• bump ureq from 2.10.0 to 2.10.1
• bump serde from 1.0.204 to 1.0.209
• bump flate2 from 1.0.30 to 1.0.33
• bump ctrlc from 3.4.4 to 3.4.5
• bump clap from 4.5.13 to 4.5.16
• bump clap_complete from 4.5.8 to 4.5.24
• bump assert_cmd from 2.0.15 to 2.0.16

[0.6.1] - 2024-08-24

Added

• Show more information about the installed asset. For example, when installing an executable from a tar archive, you will see a message like Extracted archive executable to '/home/<user>/Downloads/helloworld'.

[0.6.0] - 2024-08-18

This release focuses on improving the install feature and adds support for more assets types (#205). The install system is now more reliable and can handle more complex scenarios.

Thanks @sandreas and @adriangalilea for the help testing this release.

Added

New supported assets to install are:

• Compressed executable files
• Executable files
• AppImage files

A new option --install-file/-I <INSTALL_FILE> has been added to dra-download command. This option is useful when a tar archive or zip file contains many executables:

• dra can't automatically detect which one to install
• The repository provides more than one executable and you want to install them

See Examples section on for more information.

Changed

• The --output option of dra-download now also accepts file paths when used with install feature. This allows to rename the installed executable file (examples)

Development

• Extend release infrastructure to be able to create alpha/beta releases.

Updated dependencies

• bump uuid from 1.9.1 to 1.10.0
• bump ureq from 2.9.7 to 2.10.0
• bump serde from 1.0.203 to 1.0.204
• bump predicates from 3.1.0 to 3.1.2
• bump clap from 4.5.8 to 4.5.13
• bump clap_complete from 4.5.3 to 4.5.8
• bump assert_cmd from 2.0.14 to 2.0.15

[0.5.4] - 2024-07-20

Added

• Download and install assets from .tbz and .txz archives

Fixed

• Ignore some assets when using automatic download (for example, sha256sum files)

Updated dependencies

• bump uuid from 1.7.0 to 1.9.1
• bump ureq from 2.9.6 to 2.9.7
• bump serde from 1.0.197 to 1.0.203
• bump rustls from 0.22.2 to 0.22.4
• bump flate2 from 1.0.28 to 1.0.30
• bump clap from 4.5.2 to 4.5.8
• bump clap_complete from 4.5.1 to 4.5.3

[0.5.3] - 2024-03-12

This is a maintenance release that updates our dependencies.

Documentation

• Add missing commas, correction of spelling errors by @patsevanton (#184)
• Add more usage examples to dra --help

Updated dependencies

• bump walkdir from 2.4.0 to 2.5.0
• bump ureq from 2.9.1 to 2.9.6
• bump indicatif from 0.17.7 to 0.17.8
• bump predicates from 3.0.4 to 3.1.0
• bump serde from 1.0.193 to 1.0.197
• bump uuid from 1.6.1 to 1.7.0
• bump assert_cmd from 2.0.12 to 2.0.14
• bump ctrlc from 3.4.1 to 3.4.4
• bump clap from 4.4.10 to 4.5.2
• bump clap_complete from 4.4.4 to 4.5.1

[0.5.2] - 2023-12-21

Added

• dra now supports proxy environment variables like all_proxy (#171)

Fixed

• update sct from 0.7.0 to 0.7.1 to improve support for RISCV64 architecture by @Xunop (#172)

[0.5.1] - 2023-12-10

Added

• dra now provides release asset for macOS arm64

Changed

• dra-download option --output <OUTPUT> now also support directory paths.

  dra download -s helloworld.tar.gz --output ~/Downloads devmatteini/dra-tests
  # output: ~/Downloads/helloworld.tar.gz

[0.5.0] - 2023-12-07

Added

• Automatically select and download an asset based on your operating system and architecture with dra download -a <REPO>

Updated dependencies

• bump serde from 1.0.190 to 1.0.193
• bump clap from 4.4.7 to 4.4.10

[0.4.8] - 2023-11-25

This is a maintenance release that updates our dependencies.

Updated dependencies

• bump dialoguer from 0.10.4 to 0.11.0
• bump walkdir from 2.3.3 to 2.4.0
• bump test-case from 3.1.0 to 3.3.1
• bump predicates from 3.0.3 to 3.0.4
• bump flate2 from 1.0.26 to 1.0.28
• bump tar from 0.4.38 to 0.4.40
• bump assert_cmd from 2.0.5 to 2.0.12
• bump serde from 1.0.160 to 1.0.190
• bump ureq from 2.6.2 to 2.9.1
• bump indicatif from 0.17.4 to 0.17.7
• bump clap_complete from 4.2.1 to 4.4.4
• bump clap from 4.2.5 to 4.4.7
• bump ctrlc from 3.2.5 to 3.4.1
• bump zip from 0.6.4 to 0.6.6
• bump uuid from 1.3.2 to 1.6.1
• bump actions/checkout from 3 to 4
• bump dependabot/fetch-metadata from 1.4.0 to 1.6.0

[0.4.7] - 2023-05-20

Fixed

Install release asset when tmp directory is on a different file system (#121)

Updated dependencies

• bump predicates from 2.1.5 to 3.0.3
• bump test-case from 2.2.2 to 3.1.0
• bump dependabot/fetch-metadata from 1.3.6 to 1.4.0
• bump uuid from 1.3.0 to 1.3.2
• bump dialoguer from 0.10.3 to 0.10.4
• bump flate2 from 1.0.25 to 1.0.26
• bump clap from 4.1.11 to 4.2.5
• bump clap_complete from 4.1.5 to 4.2.1
• bump serde from 1.0.158 to 1.0.160

[0.4.6] - 2023-03-26

Added

• Download and install .tgz assets.

Development

• Use dtolnay/rust-toolchain GitHub Actions instead of actions-rs/toolchain which is not maintained anymore

Updated dependencies

• bump serde from 1.0.152 to 1.0.158
• bump clap from 4.1.4 to 4.1.11
• bump clap_complete from 4.1.1 to 4.1.5
• bump walkdir from 2.3.2 to 2.3.3
• bump uuid from 1.2.2 to 1.3.0
• bump ctrlc from 3.2.4 to 3.2.5

[0.4.5] - 2023-02-04

Added

• dra now provides release for linux x86_64 musl (#94)

[0.4.4] - 2023-02-04

Removed ⚠️ Breaking Changes ⚠️

The --copy flag of dra-untag added in the previous release has been removed for some issues on different linux desktop environments. There was no good solution that worked reliably everywhere, so it was decided to completely remove it since it's not worth the hassle for a "nice to have" feature like this (055a4bc).

[0.4.3] - 2023-01-31

Added

• dra untag now has --copy flag to copy the untagged asset to clipboard (available on Linux Wayland & X11, macOS, Windows) (#90)

Development

• devmatteini/dra-ubuntu-base docker image now uses ubuntu22.04 as base image

Updated dependencies

• ureq from 2.5.0 to 2.6.2
• bumpalo from 3.8.0 to 3.12.0
• clap_complete from 4.0.5 to 4.1.1
• clap from 4.0.26 to 4.1.4
• dialoguer from 0.10.2 to 0.10.3
• indicatif from 0.17.2 to 0.17.3
• serde from 1.0.147 to 1.0.152
• predicates from 2.1.3 to 2.1.5
• ctrlc from 3.2.3 to 3.2.4
• flate2 from 1.0.24 to 1.0.25
• bzip2 from 0.4.3 to 0.4.4

[0.4.2] - 2022-11-27

dra now provides releases for linux on armv6 and arm64!

Changed

dra on Arch Linux has been moved to the community repository (thanks @orhun). You can now install it via pacman -S dra.

Updated dependencies

• uuid from 1.2.1 to 1.2.2
• clap from 4.0.22 to 4.0.26
• predicates from 2.1.2 to 2.1.3

[0.4.1] - 2022-11-10

Added

• Download release source code archives (interactive/non-interactive), by @tranzystorek-io (#52)

Development

After the cross-platform release (0.4.0), a lot of works was done to improve dra test suite to make sure all supported os works. We are now able to run integration tests on macOS and Windows as well!

Updated dependencies

• indicatif from 0.17.1 to 0.17.2
• predicates from 2.1.1 to 2.1.2
• serde from 1.0.145 to 1.0.147
• clap from 4.0.15 to 4.0.22
• clap_complete from 4.0.2 to 4.0.5

[0.4.0] - 2022-10-19

dra is now a cross-platform command line that works on Linux, macOS and Windows 🎉!

Changed

The install feature for tar and zip archives no longer rely on tar and unzip command lines. This change was needed to ensure that it behaves the same on all supported platforms (commits).

Updated dependencies

• clap migration to v4, by @tranzystorek-io
• ctrlc from 3.2.2 to 3.2.3
• uuid from 1.1.2 to 1.2.1
• dependabot/fetch-metadata from 1.3.3 to 1.3.4
• test-case from 2.2.1 to 2.2.2
• serde from 1.0.144 to 1.0.145
• clap_complete from 3.2.4 to 3.2.5
• indicatif from 0.17.0 to 0.17.1

[0.3.8] - 2022-09-17

This is a maintenance release that updates our dependencies.

Updated dependencies

• serde from 1.0.138 to 1.0.144
• ureq from 2.4.0 to 2.5.0
• clap from 3.2.8 to 3.2.20
• clap_complete from 3.2.3 to 3.2.4
• indicatif from 0.16.2 to 0.17.0
• dialoguer from 0.10.1 to 0.10.2

[0.3.7] - 2022-07-09

Development

• Fix clap deprecation warnings for upcoming v4 release (e7d6997)
• Add github action to auto merge dependabot pull requests of patch updates

Updated dependencies

• test-case from 1.2.3 to 2.1.0
• uuid from 0.8.2 to 1.1.2
• clap_complete from 3.1.4 to 3.2.3
• serde from 1.0.137 to 1.0.138
• clap from 3.1.18 to 3.2.8

[0.3.6] - 2022-06-07

Security

CVE-2022-24713 - Updated regex crate to 1.5.6 (#23)

Updated dependencies

• clap from 3.1.17 to 3.1.18

[0.3.5] - 2022-05-12

Added

• Show download progress, by @orhun (#17)

Updated dependencies

• clap_complete from 3.1.3 to 3.1.4
• clap from 3.1.14 to 3.1.17
• dialoguer from 0.10.0 to 0.10.1

[0.3.4] - 2022-05-07

Added

• More useful error message on rate limit exceeded and unauthorized errors from GitHub API
• dra --help and dra help now display examples of the most common commands used.

Fixed

Previously, when installing a tar/zip archive without a root directory it would result in an error.

Now this type of structures inside tar/zip archives are supported.

More info on commit 5f73077

Development

In order to speed up integration tests on CI it was created a custom docker image with all runtime dependencies already installed (devmatteini/dra-ubuntu-base).

Updated dependencies

• clap from 3.1.12 to 3.1.14
• clap_complete from 3.1.2 to 3.1.3
• serde from 1.0.136 to 1.0.137

[0.3.3] - 2022-04-25

Changed

• The release workflow is now using github cli to create github release and upload assets, since actions/create-release and actions/upload-release-asset are not maintained anymore.

Development

• Dependabot is now used to weekly update cargo crates and github actions
• Integration tests are now faster to run on both host machine and CI (see 1f36ffc12e4bb2da07be3106bc982d76419c7bf0 for more details)

Updated dependencies

• test-case from 1.2.1 to 1.2.3
• dialoguer from 0.9.0 to 0.10.0
• ctrlc from 3.2.1 to 3.2.2
• clap from 3.1.6 to 3.1.12
• clap_complete from 3.1.1 to 3.1.2

[0.3.2] - 2022-03-31

⚠️ Breaking Changes ⚠️

The command line interface has changed to dra <SUBCOMMAND>.

The <REPO> positional argument must be passed after choosing download or untag subcommand ( e.g dra download <REPO>)

This change was needed in order to add subcommands/flags that didn't require <REPO>, like the newly added completion.

Added

• Generate shell completion with dra completion <SHELL>

Updated dependencies

• clap 3.0.13 -> 3.1.6

[0.3.1] - 2022-03-19

Changed

• Improve dra-download and dra-untag UX by showing a spinner while fetching the release information
• dra-download and dra-untag now print which release tag is currently used

Fixed

• GitHub releases with no assets are now handled properly

• If CTRL+C was pressed during the asset selection the cursor would not be restored (in both dra-download and dra-untag sub commands).

  The issue and solution that we implemented is described here mitsuhiko/dialoguer/issues/77.

[0.3.0] - 2022-03-15

Added

• Download and install some supported assets (dra <repo> download --[i]nstall).

  The supported assets are:

  • Debian packages (.deb)
  • Tar archive with executable inside (.tar.[gz|bz2|xz])
  • Zip file with executable inside (.zip)

Internals

Integration tests have been added to test the installation methods for the various supported assets. For more information on how this tests works, read the docs.

[0.2.3] - 2022-02-05

This release update some of our dependencies and migrates to clap v3 as args parser.

Changed

• Migration to clap v3 instead of using structopt (fe132c1).

Updated dependencies

• serde 1.0.130 -> 1.0.136
• ureq 2.3.1 -> 2.4.0

[0.2.2] - 2022-01-08

Added

• Download assets from a specific release, by @orhun (see issue 3). If none is specified, the latest release is used.

  e.g: dra <repo> download --tag <tag>

• Download assets from private repositories by exporting GITHUB_TOKEN environment variable

[0.2.1] - 2022-01-06

Added

• Created CONTRIBUTING.md guidelines
• Instructions for installing on Arch Linux from AUR, by @orhun (See pull request)
• Instructions for installing on Debian-based distributions.

[0.2.0] - 2021-12-27

Change application name from dag to dra.

dag is widely used as the acronym of Directed Acyclic Graph.

To avoid any confusion I decided to rename this application to dra. The new name is the acronym of Download Release Asset.

The repository url has changed as well: https://github.com/devmatteini/dra

[0.1.0] - 2021-12-21

Initial release of dag.

Added

• Select and download an asset from a repository (interactive)

• Save a downloaded asset to custom file path (dag <repo> download --output <path>)

• Generate a pattern to auto select an asset to download (dag <repo> untag)

• Auto select and download an asset (dag <repo> download --select <pattern>).

  The --select value is the pattern generated by dag-untag command