{"id":18002317,"url":"https://github.com/passsy/git-revision","last_synced_at":"2025-08-30T14:31:57.571Z","repository":{"id":37933471,"uuid":"116044672","full_name":"passsy/git-revision","owner":"passsy","description":"Git extension to generate a meaningful, human readable revision for each commit in a git repository.","archived":false,"fork":false,"pushed_at":"2022-11-02T20:17:46.000Z","size":143,"stargazers_count":25,"open_issues_count":2,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-12-19T03:33:15.877Z","etag":null,"topics":["dart","git"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/passsy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["passsy"]}},"created_at":"2018-01-02T18:27:27.000Z","updated_at":"2024-02-14T01:27:04.000Z","dependencies_parsed_at":"2022-08-26T01:01:55.254Z","dependency_job_id":null,"html_url":"https://github.com/passsy/git-revision","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/passsy%2Fgit-revision","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/passsy%2Fgit-revision/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/passsy%2Fgit-revision/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/passsy%2Fgit-revision/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/passsy","download_url":"https://codeload.github.com/passsy/git-revision/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231494452,"owners_count":18385248,"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":["dart","git"],"created_at":"2024-10-29T23:21:03.249Z","updated_at":"2024-12-27T14:13:31.460Z","avatar_url":"https://github.com/passsy.png","language":"Dart","funding_links":["https://github.com/sponsors/passsy"],"categories":[],"sub_categories":[],"readme":"# git revision\n\nGit extension to generate a meaningful, human-readable revision for each commit in a git repository. \n\n## Installing\n\n```bash\ndart pub global activate git_revision\n```\n\nor download the archive from [releases](https://github.com/passsy/git-revision/releases) and install it manually\n\n## Usage\n\n```\n\u003e git revision\n73_feature/user_profile+0_996321c-dirty\n```\n\n```\n\u003e git revision --full\nversionCode: 73\nversionName: 73_feature/user_profile+0_996321c-dirty\nbaseBranch: master\ncurrentBranch: feature/user_profile\nsha1: 996321c8a38c0cd0c9ebeb4e9f82615796005202\nsha1Short: 996321c\nbaseBranchCommitCount first-only: 50\nbaseBranchCommitCount: 50\nbaseBranchTimeComponent: 23\nfeatureBranchCommitCount: 0\nfeatureBranchTimeComponent: 0\nfeatureOrigin: 996321c8a38c0cd0c9ebeb4e9f82615796005202\nyearFactor: 1000\nlocalChanges: 4 +35 -12\n```\n\n### Possible revisions\n\n#### Examples\n\n```\n1_a541234\n\n1235+1_1234567\n\n432+43_a342123-dirty\n\n1234_someBranch+43_3423123\n\n1234_someBranch+43_3423123-dirty\n\n1234_feature/topic_branch-something1234_cool+43_3423123-dirty\n\n1234_topic_branch_name+0_3423123-dirty\n```\n\n#### Schema\n\nRegex matching any possible revision (above)\n\n```\n(\\d+)(?\u003e_([\\w_\\-\\/]+))?(?\u003e\\+(\\d+))?_([0-9a-f]{7})(-dirty)?\n```\n\n\n### Help\n\n```\n\u003e git revision -h\ngit revision creates a useful revision for your project beyond 'git describe'\n-h, --help            Print this usage information.\n-v, --version         Shows the version information of git revision\n-C, --context         \u003cpath\u003e Run as if git was started in \u003cpath\u003e instead of the current working directory\n-b, --baseBranch      The base branch where most of the development happens, (defaults to master, or main). Often what is set as baseBranch in github. Only on the baseBranch the revision can become only digits.\n-y, --yearFactor      revision increment count per year\n                      (defaults to \"1000\")\n-d, --stopDebounce    time between two commits which are further apart than this stopDebounce (in hours) will not be included into the timeComponent. A project on hold for a few months will therefore not increase the revision drastically when development starts again.\n                      (defaults to \"48\")\n-n, --name            a human readable name and identifier of a revision ('73_\u003cname\u003e+21_996321c'). Can be anything which gives the revision more meaning i.e. the number of the PullRequest when building on CI. Allowed characters: [a-zA-Z0-9_-/] any letter, digits, underscore, dash and slash. Invalid characters will be removed.\n    --full            shows full information about the current revision and extracted information\n```\n\n# License\n\n```\nCopyright 2018 Pascal Welsch\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpasssy%2Fgit-revision","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpasssy%2Fgit-revision","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpasssy%2Fgit-revision/lists"}