{"id":19541321,"url":"https://github.com/wingify/marque","last_synced_at":"2025-04-26T17:30:43.970Z","repository":{"id":42632644,"uuid":"268724441","full_name":"wingify/marque","owner":"wingify","description":"Tag Versioning Helper","archived":false,"fork":false,"pushed_at":"2023-07-18T22:27:16.000Z","size":788,"stargazers_count":4,"open_issues_count":3,"forks_count":0,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-06-13T11:55:57.686Z","etag":null,"topics":["hacktoberfest","semver","tagging","versioning","versioning-workflow"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/marque","language":"JavaScript","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/wingify.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2020-06-02T06:54:47.000Z","updated_at":"2022-03-30T07:25:03.000Z","dependencies_parsed_at":"2024-11-11T03:09:41.316Z","dependency_job_id":"43b0b5df-e250-4204-8429-a5ed90e50934","html_url":"https://github.com/wingify/marque","commit_stats":{"total_commits":11,"total_committers":2,"mean_commits":5.5,"dds":0.2727272727272727,"last_synced_commit":"7121e7e22d8b1b572166f9131a7be933e62f561e"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wingify%2Fmarque","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wingify%2Fmarque/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wingify%2Fmarque/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wingify%2Fmarque/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wingify","download_url":"https://codeload.github.com/wingify/marque/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251025555,"owners_count":21524824,"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":["hacktoberfest","semver","tagging","versioning","versioning-workflow"],"created_at":"2024-11-11T03:09:38.725Z","updated_at":"2025-04-26T17:30:43.680Z","avatar_url":"https://github.com/wingify.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## \u003cimg src=\"https://raw.githubusercontent.com/wingify/marque/master/marque.png\" alt=\"Marque\" width=\"50\" height=\"50\"/\u003e Marque - Tag Versioning Helper\n\n[![npm version](https://badge.fury.io/js/marque.svg)](https://www.npmjs.com/package/marque) [![npm](https://img.shields.io/npm/dt/marque.svg)](https://www.npmjs.com/package/marque)\n\n[![NPM](https://nodei.co/npm/marque.png?downloads=true)](https://nodei.co/npm/marque/)\n\nThis open-source library helps in fetching and versioning the tags of your GIT repositories and Google Cloud Platform images. \n\nIt can be used either inside a node repository or as a CLI tool.\n\n### Requirements\n\n- Node 7.0.0 or later\n- Git or gcloud as per the usage\n\n### Installation\n\nIt can be installed locally or globally or both as per different use cases. Local installation is preferred if this library will be used inside a node module. Global installation is preferred if it will be used as a CLI tool.\n\n**For Local Repository**\n\n```bash\n# via npm\nnpm install marque\n\n# via yarn\nyarn add marque\n```\n\n**Global Installation**\n\n```bash\n# via npm\nnpm install -g marque\n\n# via yarn\nyarn global add marque\n```\n\n### Usage\n\nAs per the use case, this library can be used in multiple ways:\n\n**Node Module**\n\nIt can be integrated with any Node.js service. It will return the incremented tag version based on the configuration.\n\n```js\nconst marque = require('marque');\n\nmarque.increment({ type: 'git', version: 'minor' })\n```\n\n`Options:`\n\n- `type`: Usage type i.e. _git_ or _gcloud_\n- `version`: Version type to increment i.e. _major_, _minor_ or _patch_\n- `imageName`: Image or resource name on gcloud. (Only for GCP)\n- `limit`: Number of previous tags to fetch from gcloud to evaluate the latest tag. Normally this won't be required. (Only for GCP)\n\n| Config Keys         | default        | accepts                      |\n| ------------------- | -------------- | ---------------------------- |\n| **type**            | git            | git or gcloud                |\n| **version**         | patch          | major, minor or patch        |\n| **imageName**       | undefined      | string                       |\n| **limit**           | 10             | number                       |\n\n\u003cbr\u003e\u003c/br\u003e\n\n**Command line interface**\n\nIt can be used in your terminal with interactive CLI just using the command:\n\n```bash\nmarque\n```\n\n\nIt can also be used directly using:\n\n```bash\n# GIT\n\nmarque git \u003cversion\u003e\n\nmarque \u003cversion\u003e # Can omit git as it's default\n```\n\n```bash\n# Google Cloud Platform\n\nmarque gcloud \u003cversion\u003e \u003cimage-name\u003e\n\nmarque gcloud \u003cversion\u003e \u003cimage-name\u003e --limit=50 # with limit\n```\n\n**Tools like Jenkins**\n\n```bash\nnewTag=$(marque gcloud \u003cversion\u003e \u003cimage-name\u003e)\n\nif [[ $newTag == *\"Error\"* ]]; then\n  exit 0\nfi\n```\n\n### Third-party Resources and Credits\n\nRefer [third-party-attributions.txt](https://github.com/wingify/marque/blob/master/third-party-attributions.txt)\n\n### Authors\n\n* [Punit Gupta](https://github.com/pntgupta)\n* [Gaurav Nanda](https://github.com/gauravmuk)\n\n### Contributing\n\nPlease go through our [contributing guidelines](https://github.com/wingify/marque/blob/master/CONTRIBUTING.md)\n\n### Code of Conduct\n\n[Code of Conduct](https://github.com/wingify/marque/blob/master/CODE_OF_CONDUCT.md)\n\n### License\n\n[MIT](https://github.com/wingify/marque/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwingify%2Fmarque","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwingify%2Fmarque","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwingify%2Fmarque/lists"}