{"id":21125879,"url":"https://github.com/salt-labs/action-its-shipping-time","last_synced_at":"2026-05-17T15:33:29.933Z","repository":{"id":132957465,"uuid":"608509314","full_name":"salt-labs/action-its-shipping-time","owner":"salt-labs","description":"It's shipping time!","archived":false,"fork":false,"pushed_at":"2023-05-22T06:36:58.000Z","size":30,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"trunk","last_synced_at":"2025-02-24T21:18:42.474Z","etag":null,"topics":["actions","calver","ship"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/salt-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"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},"funding":{"github":"MAHDTech"}},"created_at":"2023-03-02T06:52:19.000Z","updated_at":"2023-03-13T11:06:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"8366b6a9-ae77-4393-9862-b7d730927f56","html_url":"https://github.com/salt-labs/action-its-shipping-time","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salt-labs%2Faction-its-shipping-time","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salt-labs%2Faction-its-shipping-time/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salt-labs%2Faction-its-shipping-time/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salt-labs%2Faction-its-shipping-time/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/salt-labs","download_url":"https://codeload.github.com/salt-labs/action-its-shipping-time/tar.gz/refs/heads/trunk","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243573168,"owners_count":20312879,"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":["actions","calver","ship"],"created_at":"2024-11-20T04:37:23.146Z","updated_at":"2025-10-12T05:06:49.265Z","avatar_url":"https://github.com/salt-labs.png","language":"Shell","funding_links":["https://github.com/sponsors/MAHDTech"],"categories":[],"sub_categories":[],"readme":"# Readme\n\n## Table of Contents\n\n\u003c!-- TOC --\u003e\n\n- [Readme](#readme)\n  - [Table of Contents](#table-of-contents)\n  - [Workflow Status](#workflow-status)\n  - [Description](#description)\n  - [Inputs](#inputs)\n  - [Outputs](#outputs)\n  - [Secrets](#secrets)\n  - [Environment Variable](#environment-variable)\n  - [Example](#example)\n  - [Further Information](#further-information)\n    - [Calendar Versioning Scheme](#calendar-versioning-scheme)\n      - [Available options](#available-options)\n      - [Examples](#examples)\n      - [TimeZones](#timezones)\n\n\u003c!-- /TOC --\u003e\n\n## Workflow Status\n\n| Status                                                                                            | Description                                 |\n| :------------------------------------------------------------------------------------------------ | :------------------------------------------ |\n| ![Dependabot](https://api.dependabot.com/badges/status?host=github\u0026repo=salt-labs/action-its-shipping-time) | Automated dependency updates                |\n| ![Greetings](https://github.com/salt-labs/action-its-shipping-time/workflows/Greetings/badge.svg)           | Greets new users to the project.            |\n| ![Docker](https://github.com/salt-labs/action-its-shipping-time/workflows/Docker/badge.svg)                 | Testing and building containers with Docker |\n| ![Labeler](https://github.com/salt-labs/action-its-shipping-time/workflows/Labeler/badge.svg)               | Automates label addition to issues and PRs  |\n| ![Release](https://github.com/salt-labs/action-its-shipping-time/workflows/Release/badge.svg)               | Ships new releases :ship:                   |\n| ![Stale](https://github.com/salt-labs/action-its-shipping-time/workflows/Stale/badge.svg)                   | Checks for Stale issues and PRs             |\n\n## Description\n\n\u003c!--\nA detailed description of what the action does.\n--\u003e\n\nA GitHub Action to prepare for shipping time. 🚢\n\nThis is a simple and opinionated Action that works by automating release tags using a [Calendar Versioning](https://calver.org) scheme.\n\nThe Action can also generate a basic Changelog between `HEAD` and the last applied tag.\n\nThe outputs from this Action can then be used to pass to `actions/create-release`.\n\n## Inputs\n\n\u003c!--\nDescriptions for all the inputs available in this Action\n--\u003e\n\nThe following inputs are available:\n\n| Input             | Required | Description                                                                                                                                                                                                            | Default            | Examples                                                                                         |     |\n| :---------------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------- | :----------------------------------------------------------------------------------------------- | --- |\n| log_level         | False    | Sets the log level for debugging purposes                                                                                                                                                                              | `INFO`             | `DEBUG`\u003c/br\u003e`INFO`\u003c/br\u003e`WARN`\u003c/br\u003e`ERR`                                                          |     |\n| tag_enable        | False    | Enable to apply a git tag. Disable if you just want release notes output.                                                                                                                                              | `FALSE`            | `TRUE`\u003c/br\u003e`FALSE`                                                                               |     |\n| tag_force         | False    | Enable to force applying the tag. This will move a past tag if there was a CalVer scheme collision. \u003c/br\u003e\u003c/br\u003eWhen disabled an error will not be thrown so the build will pass, there will just be no new tag applied. | `FALSE`            | `TRUE`\u003c/br\u003e`FALSE`                                                                               |     |\n| git_pretty_format | False    | The format to provide to `git log --pretty`                                                                                                                                                                            | `* %G? %h %aN %s\"` |                                                                                                  |     |\n| calver_scheme     | False    | The CalVer scheme to use. Refer to the details below.                                                                                                                                                                  | `YYYY.0M.0D-GEN`   | `YYYY.0M.0D-GEN-dev`                                                                             |     |\n| calver_split      | False    | The separator to use between `MAJOR MINOR MICRO MODIFIER`                                                                                                                                                              | `.`                | `-`                                                                                              | `.` |\n| calver_split_mod  | False    | The separator to use between `MICRO` and `MODIFIER`. \u003c/br\u003e\u003c/br\u003eDefaults to the same as `calver_split`                                                                                                                  | `.`                | `-`                                                                                              | `.` |\n| timezone          | False    | The timezone to export the CalVer in                                                                                                                                                                                   | UTC-0              | [Examples](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones \"TZ Database Time Zone\") |     |\n\n## Outputs\n\n\u003c!--\nDescriptions for all the outputs available in this Action\n--\u003e\n\nThe following outputs are available:\n\n| Output     | Description                                       | Example                               |\n| :--------- | :------------------------------------------------ | :------------------------------------ |\n| changelog  | A Changelog between `HEAD` and the last tag       | `* This is an amazing commit message` |\n| calver     | Calendar Version generated in the provided scheme | `2020.05.01-alpha`                    |\n| repo_owner | The GitHub repository organisation or owner       | `salt-labs`                           |\n| repo_name  | The GitHub repository name                        | `action-its-shipping-time`                      |\n\n## Secrets\n\n\u003c!--\nDescriptions for all the secrets required by this Action\n--\u003e\n\nThe following secrets are used by the Action:\n\n| Secret       | Description                                | Example                     |\n| :----------- | :----------------------------------------- | :-------------------------- |\n| GITHUB_TOKEN | The GitHub Token to push the modified tags | `${{secrets.GITHUB_TOKEN}}` |\n\n## Environment Variable\n\n\u003c!--\nDescriptions for all the environment variables used by the Action\n--\u003e\n\n- None\n\n## Example\n\nRefer to the included [examples](./examples \"examples\") directory.\n\n## Further Information\n\n### Calendar Versioning Scheme\n\nThe [CalVer scheme](https://calver.org) is summarised as follows: `MAJOR.MINOR.MICRO.MODIFIER`\n\n- **Major** - The first number in the version. The major segment is the most common calendar-based component.\n- **Minor** - The second number in the version.\n- **Micro** - The third and usually final number in the version. Sometimes\n  referred to as the \"patch\" segment.\n- **Modifier** - An _optional_ text tag or revision number, such as \"dev\", \"alpha\", \"beta\",\n  \"rc1\", \"3\".\n\nThe vast majority of modern version identifiers are composed of two or\nthree numeric segments, plus the optional modifier. Convention\nsuggests that four-numeric-segment versions are discouraged.\n\n#### Available options\n\n- **`YYYY`** - Full year - 2006, 2016, 2106\n- **`YY`** - Short year - 6, 16, 106\n- **`0Y`** - Zero-padded year - 06, 16, 106\n- **`MM`** - Short month - 1, 2 ... 11, 12\n- **`0M`** - Zero-padded month - 01, 02 ... 11, 12\n- **`WW`** - Short week (since start of year) - 1, 2, 33, 52\n- **`0W`** - Zero-padded week - 01, 02, 33, 52\n- **`DD`** - Short day - 1, 2 ... 30, 31\n- **`0D`** - Zero-padded day - 01, 02 ... 30, 31\n- **`GEN`** - Increment a number based on the last found Git tag for this numeric segment.\n\n#### Examples\n\n| Syntax           | Output         |\n| :--------------- | :------------- |\n| `YYYY.MM.GEN`    | `2020.6.1`     |\n| `YYYY.0D.0M-GEN` | `2020.25.05-1` |\n| `YYYY.0D.GEN`    | `2020.25.1`    |\n| `YY-MM-0W`       | `20-5-21`      |\n| `YY-MM-0W.GEN`   | `20-5-21.1`    |\n| `YY.MM-GEN`      | `20.5-1`       |\n\n#### TimeZones\n\nA list of available TZ Database time zones are available [HERE](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones \"TZ Database Time Zone\").\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalt-labs%2Faction-its-shipping-time","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsalt-labs%2Faction-its-shipping-time","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalt-labs%2Faction-its-shipping-time/lists"}