{"id":21749036,"url":"https://github.com/adamperkowski/nvrs","last_synced_at":"2025-04-05T19:09:08.252Z","repository":{"id":263199695,"uuid":"889504440","full_name":"adamperkowski/nvrs","owner":"adamperkowski","description":"🚦 fast new version checker for software releases 🦀","archived":false,"fork":false,"pushed_at":"2025-04-01T12:28:51.000Z","size":2212,"stargazers_count":51,"open_issues_count":6,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-03T10:16:59.939Z","etag":null,"topics":["api","cli","package-tracker","packaging","release-tracking","rust","software"],"latest_commit_sha":null,"homepage":"https://nvrs.adamperkowski.dev","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adamperkowski.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"adamperkowski","custom":"https://adamperkowski.dev/donate"}},"created_at":"2024-11-16T13:55:13.000Z","updated_at":"2025-04-01T12:28:52.000Z","dependencies_parsed_at":"2024-11-16T23:17:59.015Z","dependency_job_id":"351ca86a-b6a8-42f1-8a7c-8eaee15102a5","html_url":"https://github.com/adamperkowski/nvrs","commit_stats":{"total_commits":102,"total_committers":5,"mean_commits":20.4,"dds":"0.11764705882352944","last_synced_commit":"f57c3ab39fc9a3db68cbd26fc7ac6a93b1c89c20"},"previous_names":["adamperkowski/nvrs"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamperkowski%2Fnvrs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamperkowski%2Fnvrs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamperkowski%2Fnvrs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamperkowski%2Fnvrs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adamperkowski","download_url":"https://codeload.github.com/adamperkowski/nvrs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246988141,"owners_count":20865211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","cli","package-tracker","packaging","release-tracking","rust","software"],"created_at":"2024-11-26T08:16:11.480Z","updated_at":"2025-04-05T19:09:08.228Z","avatar_url":"https://github.com/adamperkowski.png","language":"Rust","funding_links":["https://github.com/sponsors/adamperkowski","https://adamperkowski.dev/donate"],"categories":["Rust"],"sub_categories":[],"readme":"\u003cdiv align='center'\u003e\n\n# nvrs\n🚦 fast new version checker for software releases 🦀\n\n[![Grind Compliant](https://img.shields.io/badge/Grind-Compliant-blue?style=for-the-badge\u0026labelColor=%23a8127d\u0026color=%23336795)](https://github.com/The-Grindhouse/guidelines)\u003cbr\u003e\n![Build Status](https://img.shields.io/github/actions/workflow/status/adamperkowski/nvrs/rust.yml?style=for-the-badge\u0026labelColor=%23a8127d\u0026color=%23336795) [![docs.rs](https://img.shields.io/docsrs/nvrs?style=for-the-badge\u0026labelColor=%23a8127d\u0026color=%23336795)](#documentation)\u003cbr\u003e\n[![GitHub Contributors](https://img.shields.io/github/contributors-anon/adamperkowski/nvrs?style=for-the-badge\u0026labelColor=%23a8127d\u0026color=%23336795)](https://github.com/adamperkowski/nvrs/graphs/contributors) ![GitHub Repo Size](https://img.shields.io/github/repo-size/adamperkowski/nvrs?style=for-the-badge\u0026labelColor=%23a8127d\u0026color=%23336795) ![Repo Created At](https://img.shields.io/github/created-at/adamperkowski/nvrs?style=for-the-badge\u0026labelColor=%23a8127d\u0026color=%23336795)\n\n![banner](/banner.webp)\n\n\u003c/div\u003e\n\n## Features\n### [nvchecker](https://github.com/lilydjwg/nvchecker) compatibility\ncheck the [release notes](https://github.com/adamperkowski/nvrs/releases) and [configuration docs](#configuration) for compatibility updates and instructions.\n\n### Speed\n\u003cimg align='right' src='https://media1.tenor.com/m/mMWXOkCEndoAAAAC/ka-chow-lightning-mcqueen.gif' alt='ka-chow' width=80 height=45\u003e\n\n| command       | time per **updated** package | details                                                |\n|---------------|------------------------------|--------------------------------------------------------|\n| `nvrs`        | ~ 0.03s                      | **API requests included**\u003cbr\u003edepends on internet speed |\n| `nvrs --cmp`  | ~ 0.0008s                    | depends on disk speed                                  |\n| `nvrs --take` | ~ 0.001s                     | depends on disk speed                                  |\n\n### Sources\n- `aur`\n- `cratesio`\n- `gitea`\n- `github`\n- `gitlab` (with custom hosts)\n- `website` (regex)\n\n### QOL improvements\n- `ALL` argument for the `--take` command\n- `--no-fail` flag to prevent exiting on recoverable errors\n- `--nuke` command to delete packages from all files\n- `--list-sources` command to list all available sources\n\n## Installation\n\u003ca href=\"https://repology.org/project/nvrs/versions\"\u003e\u003cimg align=\"right\" src=\"https://repology.org/badge/vertical-allrepos/nvrs.svg\" alt=\"Packaging status\"\u003e\u003c/a\u003e\n\nsee the [installation guide](https://nvrs.adamperkowski.dev/installation.html) for instructions on how to install nvrs.\n\n## Usage\nnvrs relies on a configuration file. see [configuration](https://nvrs.adamperkowski.dev/configuration.html). \n\n\u003cimg align='center' src='https://vhs.charm.sh/vhs-7j0ZLSJUnq5W8xwqjK14W4.gif' alt='Packaging status'\u003e\n\nthe core commands are:\n- `nvrs` - fetches latest versions of defined packages\n- `nvrs --cmp` - compares newver with oldver and displays differences\n- `nvrs --take` - automatically updates oldver. takes in a comma-separated list of package names (`ALL` for all packages)\n- `nvrs --nuke` - deletes packages from all files. takes in a comma-separated list of names (yes, just like a hitman)\n- the `--no-fail` flag - as the name suggests, specifying this will make nvrs not exit on recoverable errors\n\n### Example usage\n```sh\n# download the example configuration file\ncurl -L 'https://github.com/adamperkowski/nvrs/raw/main/nvrs.toml' -o nvrs.toml\n\n# fetch latest package versions (should return `NONE -\u003e version` for all packages)\nnvrs --no-fail\n\n# compare them to latest known versions (should also return `NONE -\u003e version`)\nnvrs -c\n\n# update the known versions\nnvrs -t ALL\n```\n\nfor all available commands, options and flags, see `nvrs --help` and the [manual page](/man/nvrs.1).\n\n## Documentation\nfull documentation can be found at [nvrs.adamperkowski.dev](https://nvrs.adamperkowski.dev).\nnvrs library documentation can be found at [docs.rs/nvrs](https://docs.rs/nvrs/latest/nvrs)\n\n## Contributing\nif you want to contribute to the project, please read the [Contributing Guidelines](/CONTRIBUTING.md) before doing so.\n\nif 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).\n\n## Credits\n- [依云](https://github.com/lilydjwg) | the original [nvchecker](https://github.com/lilydjwg/nvchecker)\n- [orhun](https://github.com/orhun) | the idea\n\n\u003cdiv align='center'\u003e\n\n\u003csub align='center'\u003eCopyright (c) 2025 Adam Perkowski\u003cbr\u003esee [LICENSE](/LICENSE)\u003c/sub\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamperkowski%2Fnvrs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadamperkowski%2Fnvrs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamperkowski%2Fnvrs/lists"}