{"id":20359421,"url":"https://github.com/saidsef/bump-api","last_synced_at":"2025-05-08T06:32:23.375Z","repository":{"id":46564688,"uuid":"150899249","full_name":"saidsef/bump-api","owner":"saidsef","description":"This Bump API is aimed at making stateless version numbering available via API endpoint","archived":false,"fork":false,"pushed_at":"2024-06-19T15:08:23.000Z","size":109,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-06-20T02:22:37.950Z","etag":null,"topics":["docker-container","docker-image","hacktoberfest","version-control-system","version-tracker","versioning","versioning-api"],"latest_commit_sha":null,"homepage":"","language":"Python","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/saidsef.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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},"funding":{"custom":["https://revolut.me/saidsef"]}},"created_at":"2018-09-29T20:09:50.000Z","updated_at":"2024-06-19T15:07:02.000Z","dependencies_parsed_at":"2023-10-02T13:43:54.807Z","dependency_job_id":"50a838e8-8f46-4365-8291-1f52e5d9cc0d","html_url":"https://github.com/saidsef/bump-api","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saidsef%2Fbump-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saidsef%2Fbump-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saidsef%2Fbump-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saidsef%2Fbump-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saidsef","download_url":"https://codeload.github.com/saidsef/bump-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224708852,"owners_count":17356521,"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":["docker-container","docker-image","hacktoberfest","version-control-system","version-tracker","versioning","versioning-api"],"created_at":"2024-11-14T23:33:50.540Z","updated_at":"2024-11-14T23:33:51.139Z","avatar_url":"https://github.com/saidsef.png","language":"Python","funding_links":["https://revolut.me/saidsef"],"categories":[],"sub_categories":[],"readme":"# Bump API\n\nThis Bump API is aimed at making stateless version numbering available via API endpoint.\n\nBump API is build on top of [treeder/bump](https://hub.docker.com/r/treeder/bump/)\n\n## Documentation\n\nSoftware versioning is the process of assigning either unique version names or unique version numbers to unique states of computer software. Within a given version number category (major, minor and patch), these numbers are generally assigned in increasing order and correspond to new developments in the software. \n\nSemantic versioning (aka SemVer), currently the best known and most widely adopted version scheme in this category, uses a sequence of three digits (Major.Minor.Patch), an optional prerelease tag and optional build meta tag. In this scheme, risk and functionality are the measures of significance.\n\nFor further [information](https://en.wikipedia.org/wiki/Software_versioning)\n\n## Deployment\n\nAs a container:\n\n```shell\ndocker run -d -p 7070:7070 docker.io/saidsef/bump-api:latest\n```\n\nAs a Python application:\n\n```shell\npip install -r requirements.txt\n\nPORT=7070 bump-api.py\n```\n\n## The Request\n\nThe quest must be POST method:\n\n```shell\ncurl -XPOST http://localhost:7070/api/v1/version -H 'Content-Type: application/json' @test/bump-api.json\n```\n\nAnd the response will look like:\n\n```shell\n{\n  \"new_version\": \"2.3.1\",\n}\n```\n\n## Kubernetes Deployment\n\n```shell\nkubectl apply -k ./deployment\n```\n\n## Source\n\nOur latest and greatest source of Jenkins can be found on [GitHub](#deployment). Fork us!\n\n## Contributing\n\nWe would :heart:  you to contribute by making a [pull request](https://github.com/saidsef/bump-api/pulls).\n\nPlease read the official [Contribution Guide](./CONTRIBUTING.md) for more information on how you can contribute.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaidsef%2Fbump-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaidsef%2Fbump-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaidsef%2Fbump-api/lists"}