Features

nvchecker compatibility

check the release notes for compatibility updates

Speed

Sources

• aur
• github
• gitlab (with custom hosts)

QOL improvements

• ALL argument for the --take command
• --no-fail flag to prevent exiting on recoverable errors
• --nuke command to delete packages from all files
• --list-sources command to list all available sources

Installation

paru -S nvrs

git clone https://aur.archlinux.org/nvrs.git
cd nvrs
makepkg -si

cargo install nvrs

chmod +x nvrs

sudo mv nvrs /usr/bin/nvrs

Usage

nvrs relies on a configuration file. see configuration.

the core commands are:

• nvrs - fetches latest versions of defined packages
• nvrs --cmp - compares newver with oldver and displays differences
• nvrs --take - automatically updates oldver. takes in a comma-separated list of package names (ALL for all packages)
• nvrs --nuke - deletes packages from all files. takes in a comma-separated list of names (yes, just like a hitman)
• the --no-fail flag - as the name suggests, specifying this will make nvrs not exit on recoverable errors

Example usage

# download the example configuration file
curl -L 'https://github.com/adamperkowski/nvrs/raw/main/nvrs.toml' -o nvrs.toml

# fetch latest package versions (should return `NONE -> version` for all packages)
nvrs --no-fail

# compare them to latest known versions (should also return `NONE -> version`)
nvrs -c

# update the known versions
nvrs -t ALL

Configuration

nvrs relies on a configuration file (example) containing basic settings, such as oldver, newver & keyfile paths, as well as package entries. supported config paths:

• $XDG_CONFIG_HOME/nvrs.toml (~/.config/nvrs.toml if the variable is not set)
• ./nvrs.toml
• custom paths set with nvrs --config

__config__ table

this configures the behavior of nvrs. see the example config.

available fields:

Package entries

example

package entries are custom entries in the main config file. they contain values such as:

Keyfile structure

this file contains API keys for various sources. example can be found here.

[keys]
github = "your_secret_github_api_key_that_you_shouldnt_push_to_a_public_nor_a_private_remote_repo_because_there_will_definitely_be_serious_consequences_sooner_or_later_if_you_do_trust_me_just_dont"
gitlab = "remember_to_replace_the_example_values_here_here_with_your_actual_keys_otherwise_it_wont_work_but_dont_push_keyfiles_to_remote_repos"

_{"I think that example value is not long enough" - orhun}

Documentation

the nvrs library documentation can be found at docs.rs/nvrs

Credits

• 依云 | the original nvchecker
• orhun | the idea