brave-releases-checker 0.3.0

Checks for new Brave Browser releases

Brave Releases Checker

A simple command-line tool to check for the latest Brave Browser releases from GitHub. It supports selecting a specific channel (stable, beta, nightly), filtering by architecture, file suffix, and even listing all available releases based on your criteria. Configuration can be managed through a config.ini file for persistent settings.

Features

• Latest Release Checking: Fetches the most recent Brave Browser releases from the official GitHub repository.
• Release Channel Selection: Filter releases by channel: stable, beta, or nightly.
• Architecture Filtering: Display assets for a specific architecture (e.g., amd64, arm64, aarch64, x86_64).
• File Suffix Filtering: Specify the asset file type to filter (e.g., .deb, .rpm, .tar.gz, .apk, .zip, .dmg, .pkg).
• List Available Releases: Option to list all matching releases on a specific page or a range of pages without checking for an installed version.
• Page Range Search: Ability to search for releases across a specified range of pages on the GitHub API.
• Flexible Configuration: Default settings can be configured and persisted in a config.ini file.
• Console Script: Provides a convenient brc command-line script for easy use.

Installation

pip install brave-releases-checker

Usage

Use the brc script from your command line with various options to tailor your release checks.

brc --help

Basic Checks

• Check the latest stable release for the default architecture (configured in config.ini or defaults to amd64):

  brc
  

• Check the latest stable release for a specific architecture:

  brc --channel stable --arch arm64
  

• Check the latest nightly release for the default architecture:

  brc --channel nightly
  

Filtering by File Suffix

• Check for the latest beta .rpm package for the default architecture:

  brc --channel beta --suffix .rpm
  

Listing Available Releases

The --list option allows you to see all available releases that match your specified criteria without comparing against an installed version.

• List all stable .deb releases on the first page:

  brc --list --channel stable --suffix .deb --page 1
  

• List all beta .rpm releases across pages 1 to 3:

  brc --list --channel beta --suffix .rpm --pages 1-3
  

Specifying Page or Page Range

The --page option (when not using --list) specifies which page of releases to check. The --pages option (especially useful with --list) allows you to define a range of pages to search.

• Check the latest stable release on the second page:

  brc --channel stable --page 2
  

• List all nightly releases across pages 1 to 5:

  brc --list --channel nightly --pages 1-5
  

Specifying an Asset Version

• You can target a specific asset version:

  brc --asset-version 1.79.105
  

Combine this with other options to find a specific release for a channel and architecture.

Configuration

The config.ini file allows you to set default values for various options, so you don't have to specify them every time you run the script. The program searches for this file in the following order:

1. /etc/brave-releases-checker/config.ini
2. ~/.config/brave-releases-checker/config.ini

If no configuration file is found, default values are used.

To customize, create the config.ini file (you might find a sample in the project repository) in one of these locations. For the second location, you might need to create the brave-releases-checker directory inside your ~/.config directory first.

Here's an example config.ini file:

[DEFAULT]
channel = beta
suffix = .rpm
arch = arm64
pages = 1
download_path = /tmp/brave_downloads

You can define default values for channel, suffix, arch, download_path, and the default pages to check. Command-line arguments will always override the settings in the config.ini file.

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Feel free to report issues or submit pull requests to the repository.

Regarding Unsupported Distributions:

This tool has been primarily tested on Debian-based (apt, snap), Fedora (dnf), Arch-based (pacman), openSUSE (zypper), and Slackware systems for automatic installed version detection.

If you encounter issues or wish to use this tool on a distribution without full support for automatic installed version detection:

1. Open a new issue detailing your operating system and the problem.
2. Include information on how to retrieve the installed Brave Browser version on your distribution (e.g., commands, file paths).
3. Pull requests adding support for other distributions are highly encouraged. Please adhere to the existing code structure and provide clear explanations of your changes.

Your feedback and contributions are invaluable for expanding the tool's compatibility.