{"id":42177004,"url":"https://github.com/tomphp/versioned-files","last_synced_at":"2026-01-26T21:54:28.299Z","repository":{"id":202651181,"uuid":"707811900","full_name":"tomphp/versioned-files","owner":"tomphp","description":"A tool which updates files in your project with the current version number.","archived":false,"fork":false,"pushed_at":"2024-11-21T00:07:32.000Z","size":155,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-21T01:18:40.589Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/tomphp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-20T18:01:53.000Z","updated_at":"2023-10-21T07:52:47.000Z","dependencies_parsed_at":"2023-10-21T09:22:38.450Z","dependency_job_id":"666d5b8a-2a78-4af9-959f-8cc7332e9da3","html_url":"https://github.com/tomphp/versioned-files","commit_stats":null,"previous_names":["tomphp/bump-version","tomphp/versioned-files"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/tomphp/versioned-files","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomphp%2Fversioned-files","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomphp%2Fversioned-files/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomphp%2Fversioned-files/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomphp%2Fversioned-files/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tomphp","download_url":"https://codeload.github.com/tomphp/versioned-files/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomphp%2Fversioned-files/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28789321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T21:49:50.245Z","status":"ssl_error","status_checked_at":"2026-01-26T21:48:29.455Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-01-26T21:54:27.571Z","updated_at":"2026-01-26T21:54:28.283Z","avatar_url":"https://github.com/tomphp.png","language":"Rust","readme":"# Versioned Files\n\nA tool which updates files in your project with the current version number.\n\n\u003e ⚠️ **CURRENT STATUS** ⚠️\n\u003e\n\u003e This project is in the early development stage. It is currently not functional or useful.\n\u003e Please check back soon.\n\n## Example\n\nGiven a file `README.md` which contains:\n\n```text, file(path=\"README.md\")\n# Example Project Docs\n\nThe current version is `v2.3.16`\n```\n\nAnd a `versioned-files.yml` file which contains:\n\n```yaml, file(path=\"versioned-files.yml\")\nlocations:\n  - !string-pattern\n    file: README.md\n    pattern: The current version is `v{{version}}`\n```\n\nRunning:\n\n```shell, script(expected_exit_code=0)\nversioned-files update 2.4.1\n```\n\nWill output:\n\n```text, verify()\nUpdating README.md...success\n```\n\nAnd will update `README.md` so that:\n\n```shell, script()\ncat README.md\n```\n\nWill output:\n\n```text, verify()\n# Example Project Docs\n\nThe current version is `v2.4.1`\n```\n\n## Getting Help\n\nFor help on available commands you can run:\n\n```shell, script()\nversioned-files help\n```\n\nThis will give you all the details you need:\n\n(Non-windows)\n```text, verify(target_os=\"!windows\")\nA tool which updates files in your project with the current version number.\n\nUsage: versioned-files \u003cCOMMAND\u003e\n\nCommands:\n  update  Updates the version in all known locations\n  help    Print this message or the help of the given subcommand(s)\n\nOptions:\n  -h, --help     Print help\n  -V, --version  Print version\n```\n\n(Windows)\n```text, verify(target_os=\"windows\")\nA tool which updates files in your project with the current version number.\n\nUsage: versioned-files.exe \u003cCOMMAND\u003e\n\nCommands:\n  update  Updates the version in all known locations\n  help    Print this message or the help of the given subcommand(s)\n\nOptions:\n  -h, --help     Print help\n  -V, --version  Print version\n```\n\n## Current Version\n\nTo find out what version you are running, you can run:\n```shell, script()\nversioned-files --version\n```\n\n```text, verify()\nversioned-files 0.4.4\n```\n\n## Configuration\n\nWhen running the `update` command, a configuration file is required.\nBy default, `versioned-files` looks for a file named `versioned-files.yml` in the current directory.\n\n### Missing Configuration\n\nIf you run `versioned-files update` without a configuration file present like this:\n\n```shell, script(expected_exit_code=1)\nrm -f versioned-files.yml # TODO extract section into another doc and remove this\nversioned-files update 1.2.3\n```\n\nThen you will see the following error:\n\n```text, verify(stream=stderr)\nError: No versioned-files.yml file found.\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomphp%2Fversioned-files","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomphp%2Fversioned-files","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomphp%2Fversioned-files/lists"}