https://github.com/adamperkowski/nvrs
π¦ fast new version checker for software releases π¦
https://github.com/adamperkowski/nvrs
api cli package-tracker packaging release-tracking rust software
Last synced: 24 days ago
JSON representation
π¦ fast new version checker for software releases π¦
- Host: GitHub
- URL: https://github.com/adamperkowski/nvrs
- Owner: adamperkowski
- License: mit
- Created: 2024-11-16T13:55:13.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-04-01T12:28:51.000Z (28 days ago)
- Last Synced: 2025-04-03T10:16:59.939Z (26 days ago)
- Topics: api, cli, package-tracker, packaging, release-tracking, rust, software
- Language: Rust
- Homepage: https://nvrs.adamperkowski.dev
- Size: 2.11 MB
- Stars: 51
- Watchers: 3
- Forks: 3
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome-starred - adamperkowski/nvrs - π¦ fast new version checker for software releases π¦ (Rust)
- awesome-starred - adamperkowski/nvrs - π¦ fast new version checker for software releases π¦ (Rust)
README
# nvrs
π¦ fast new version checker for software releases π¦
[](https://github.com/The-Grindhouse/guidelines)
 [](#documentation)
[](https://github.com/adamperkowski/nvrs/graphs/contributors)  
## Features
### [nvchecker](https://github.com/lilydjwg/nvchecker) compatibility
check the [release notes](https://github.com/adamperkowski/nvrs/releases) and [configuration docs](#configuration) for compatibility updates and instructions.
### Speed
| command | time per **updated** package | details |
|---------------|------------------------------|--------------------------------------------------------|
| `nvrs` | ~ 0.03s | **API requests included**
depends on internet speed |
| `nvrs --cmp` | ~ 0.0008s | depends on disk speed |
| `nvrs --take` | ~ 0.001s | depends on disk speed |
### Sources
- `aur`
- `cratesio`
- `gitea`
- `github`
- `gitlab` (with custom hosts)
- `website` (regex)
### 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
see the [installation guide](https://nvrs.adamperkowski.dev/installation.html) for instructions on how to install nvrs.
## Usage
nvrs relies on a configuration file. see [configuration](https://nvrs.adamperkowski.dev/configuration.html).
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
```sh
# 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
```
for all available commands, options and flags, see `nvrs --help` and the [manual page](/man/nvrs.1).
## Documentation
full documentation can be found at [nvrs.adamperkowski.dev](https://nvrs.adamperkowski.dev).
nvrs library documentation can be found at [docs.rs/nvrs](https://docs.rs/nvrs/latest/nvrs)
## Contributing
if you want to contribute to the project, please read the [Contributing Guidelines](/CONTRIBUTING.md) before doing so.
if you find any parts of the code or the documentation unclear, or have any suggestions, feel free to [open an issue](https://github.com/adamperkowski/nvrs/issues/new/choose) or a [pull request](https://github.com/adamperkowski/nvrs/pull/new).
## Credits
- [δΎδΊ](https://github.com/lilydjwg) | the original [nvchecker](https://github.com/lilydjwg/nvchecker)
- [orhun](https://github.com/orhun) | the idea
Copyright (c) 2025 Adam Perkowski
see [LICENSE](/LICENSE)