https://github.com/sbrunner/applications-download
https://github.com/sbrunner/applications-download
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/sbrunner/applications-download
- Owner: sbrunner
- License: bsd-2-clause
- Created: 2024-11-06T07:24:36.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-02-11T11:30:18.000Z (5 months ago)
- Last Synced: 2025-02-11T12:31:24.878Z (5 months ago)
- Language: Python
- Size: 201 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Applications Download
This tool can be used to maintain a version file (eventually also an application file) for a given application.
The version file is a YAML file that contains the version number of the application.
The version file respect the schema describe in application.md and provided in applications_download/application-schema.json.
The application file is also a YAML file that contains how to download and install the application.
This is a simple key value file with the application as key and the version as value.
## Install
```bash
pip install applications-download
```
## Usage
```bash
applications-download --help
```
## Applications configuration
In case some executables or applications from GitHub releases or any other URLs are required on the CI host
and are not handled by any dependency manager, we provide a set of tools to install them and manage upgrades
through Renovate.
Create an application file (e.-g. `applications.yaml`) with:
```yaml
# yaml-language-server: $schema=https://raw.githubusercontent.com/camptocamp/c2cciutils/master/c2cciutils/schema-applications.json
# Application from GitHub release
/:
get-file-name:
to-file-name:
finish-command: # The command you want to run after the file is downloaded
- - chmod # To be executable (usually required)
- +x
-
- - # Print the version of the application
- --version
# Application from GitHub release in a tar file (or tar.gz)
/:
get-file-name:
type: tar
tar-file-name:
to-file-name:
finish-command: [...] # The command you want to run after the file is downloaded
# Application from an URL
:
url-pattern:
to-file-name:
finish-command: [...] # The command you want to run after the file is downloaded
```
In the attributes `url-pattern`, `get-file-name` you can use the following variables:
- `{version}`: The version of the application present in the version file.
- `{version_quote}`: The URL encoded version.
- `{short_version}`: The version without the `v` prefix.
The `applications-versions.yaml` file is a map of applications and their versions.
Add in your Renovate configuration:
```json5
regexManagers: [
{
fileMatch: ['^applications-versions.yaml$'],
matchStrings: [
'(?[^\\s]+): (?[^\\s]+) # (?[^\\s]+)',
],
},
],
```
Now you need to call `c2cciutils-download-applications --applications-file=applications.yaml --versions-file=applications-version.yaml`
to install required applications on CI host before using them (an already installed application is installed only if needed).
## Contributing
Install the pre-commit hooks:
```bash
pip install pre-commit
pre-commit install --allow-missing-config
```