# ghcr-badge: Generate ghcr.io container's status badge
[![1] ![2] ![3]](https://github.com/eggplants/ghcr-badge/pkgs/container/ghcr-badge)
[](
<https://badge.fury.io/py/ghcr-badge>
) [](
<https://results.pre-commit.ci/latest/github/eggplants/ghcr-badge/master>
) [](
<https://codeclimate.com/github/eggplants/ghcr-badge/maintainability>
) [](
<https://github.com/eggplants/ghcr-badge/actions/workflows/release.yml>
)
## Motivation
<https://github.com/badges/shields/issues/5594>
## Deployment
[![Deploy to Render]](https://render.com/deploy?repo=https://github.com/eggplants/ghcr-badge)
- <https://ghcr-badge.egpl.dev/>
- [](https://ghcr-badge.egpl.dev)
- ~<https://ghcr-badge.deta.dev/>~
- Deta Space [will be closed](https://deta.space/sunset) at 2024-10-17
[Deploy to Render]: <https://render.com/images/deploy-to-render-button.svg>
## Available paths
- `/<package_owner>/<package_name>/tags?color=...&ignore=...&n=...&label=...&trim=...`
- defaults: `color=#44cc11`, `ignore=latest`, `n=3`, `label=image tags`
- <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/tags?trim=major>
- 👉: ![1]
- `/<package_owner>/<package_name>/latest_tag?color=...&ignore=...&label=...&trim=...`
- defaults: `color=#44cc11`, `ignore=latest`, `label=version`
- <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/latest_tag?trim=major&label=latest>
- 👉: ![2]
- `/<package_owner>/<package_name>/size?color=...&tag=...&label=...&trim=...`
- defaults: `color=#44cc11`, `tag=latest`, `label=image size`
- <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/size>
- 👉: ![3]
## Common parameters
### `label` parameter
- `label=hello`: 
### `ignore` parameter
Use the ignore parameter to filter returned tags, supports pattern matching and a comma separated list.
- `ignore=latest` ignores the `latest` tag (default).
- `ignore=sha256*` ignores all tags prefixed with `sha256`.
- `ignore=v0.0.1,latest,sha256*` ignores the `latest` and `v0.0.1` tags, and all tags prefixed with `sha256*`.
### `trim` parameter
- `trim=patch` trims `^v?\d+\.\d+\.\d+[^.]*$` tags.
- `trim=major` trims `^v?\d+\.\d+[^.]*$` tags.
### `color` parameter
Available color names and hex codes are listed on [here](https://github.com/jongracecox/anybadge#colors).
## Note
Generated badge will be cached for 3666 seconds in GitHub's [Camo](https://github.com/atmos/camo) server.
To update immediately, send PURGE request to the badge Camo link.
```bash
curl -X PURGE "https://camo.githubusercontent.com/..."
```
[1]: <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/tags?trim=major>
[2]: <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/latest_tag?trim=major&label=latest>
[3]: <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/size>
## Development
1. Install [`poetry`](https://python-poetry.org/docs/#installation)
1. Run `poetry install && poetry shell && pre-commit install`
1. Launch live server with `task dev`
Raw data
{
"_id": null,
"home_page": "https://github.com/eggplants/ghcr-badge",
"name": "ghcr_badge",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.8",
"maintainer_email": null,
"keywords": "github-container-registry, badge, ghcr",
"author": "eggplants",
"author_email": "w10776e8w@yahoo.co.jp",
"download_url": "https://files.pythonhosted.org/packages/97/16/79cc716429a29e887d17aa7ab5f826fac08563ede3b0b203f9960e3b86fb/ghcr_badge-0.5.0.tar.gz",
"platform": null,
"description": "# ghcr-badge: Generate ghcr.io container's status badge\n\n[![1] ![2] ![3]](https://github.com/eggplants/ghcr-badge/pkgs/container/ghcr-badge)\n\n[](\n <https://badge.fury.io/py/ghcr-badge>\n) [](\n <https://results.pre-commit.ci/latest/github/eggplants/ghcr-badge/master>\n) [](\n <https://codeclimate.com/github/eggplants/ghcr-badge/maintainability>\n) [](\n <https://github.com/eggplants/ghcr-badge/actions/workflows/release.yml>\n)\n\n## Motivation\n\n<https://github.com/badges/shields/issues/5594>\n\n## Deployment\n\n[![Deploy to Render]](https://render.com/deploy?repo=https://github.com/eggplants/ghcr-badge)\n\n- <https://ghcr-badge.egpl.dev/>\n - [](https://ghcr-badge.egpl.dev)\n\n- ~<https://ghcr-badge.deta.dev/>~\n - Deta Space [will be closed](https://deta.space/sunset) at 2024-10-17\n\n[Deploy to Render]: <https://render.com/images/deploy-to-render-button.svg>\n\n## Available paths\n\n- `/<package_owner>/<package_name>/tags?color=...&ignore=...&n=...&label=...&trim=...`\n - defaults: `color=#44cc11`, `ignore=latest`, `n=3`, `label=image tags`\n - <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/tags?trim=major>\n - \ud83d\udc49: ![1]\n- `/<package_owner>/<package_name>/latest_tag?color=...&ignore=...&label=...&trim=...`\n - defaults: `color=#44cc11`, `ignore=latest`, `label=version`\n - <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/latest_tag?trim=major&label=latest>\n - \ud83d\udc49: ![2]\n- `/<package_owner>/<package_name>/size?color=...&tag=...&label=...&trim=...`\n - defaults: `color=#44cc11`, `tag=latest`, `label=image size`\n - <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/size>\n - \ud83d\udc49: ![3]\n\n## Common parameters\n\n### `label` parameter\n\n- `label=hello`: \n\n### `ignore` parameter\n\nUse the ignore parameter to filter returned tags, supports pattern matching and a comma separated list.\n\n- `ignore=latest` ignores the `latest` tag (default).\n- `ignore=sha256*` ignores all tags prefixed with `sha256`.\n- `ignore=v0.0.1,latest,sha256*` ignores the `latest` and `v0.0.1` tags, and all tags prefixed with `sha256*`.\n\n### `trim` parameter\n\n- `trim=patch` trims `^v?\\d+\\.\\d+\\.\\d+[^.]*$` tags.\n- `trim=major` trims `^v?\\d+\\.\\d+[^.]*$` tags.\n\n### `color` parameter\n\nAvailable color names and hex codes are listed on [here](https://github.com/jongracecox/anybadge#colors).\n\n## Note\n\nGenerated badge will be cached for 3666 seconds in GitHub's [Camo](https://github.com/atmos/camo) server.\nTo update immediately, send PURGE request to the badge Camo link.\n\n```bash\ncurl -X PURGE \"https://camo.githubusercontent.com/...\"\n```\n\n[1]: <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/tags?trim=major>\n[2]: <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/latest_tag?trim=major&label=latest>\n[3]: <https://ghcr-badge.egpl.dev/eggplants/ghcr-badge/size>\n\n## Development\n\n1. Install [`poetry`](https://python-poetry.org/docs/#installation)\n1. Run `poetry install && poetry shell && pre-commit install`\n1. Launch live server with `task dev`\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Generate ghcr.io container's status badge",
"version": "0.5.0",
"project_urls": {
"Homepage": "https://github.com/eggplants/ghcr-badge",
"Repository": "https://github.com/eggplants/ghcr-badge"
},
"split_keywords": [
"github-container-registry",
" badge",
" ghcr"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "af6ea68ba6cbf760dccb43338db45c0a7e68868108e3d0cf8c007fe0336920e8",
"md5": "64bfc96d61f3777cce934213020d7d93",
"sha256": "9bfe9e85ac910617ae5d695e6f7e69a7690760e2c172537b7f1117f2c4b19228"
},
"downloads": -1,
"filename": "ghcr_badge-0.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "64bfc96d61f3777cce934213020d7d93",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.8",
"size": 56352,
"upload_time": "2024-09-03T11:18:33",
"upload_time_iso_8601": "2024-09-03T11:18:33.943712Z",
"url": "https://files.pythonhosted.org/packages/af/6e/a68ba6cbf760dccb43338db45c0a7e68868108e3d0cf8c007fe0336920e8/ghcr_badge-0.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "971679cc716429a29e887d17aa7ab5f826fac08563ede3b0b203f9960e3b86fb",
"md5": "29c88f23305020c9d251017e3eaa6406",
"sha256": "aa5d97c6d8121f9f08350a056189395972dcc27a1d72ce2f50fed43b165894a9"
},
"downloads": -1,
"filename": "ghcr_badge-0.5.0.tar.gz",
"has_sig": false,
"md5_digest": "29c88f23305020c9d251017e3eaa6406",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.8",
"size": 57371,
"upload_time": "2024-09-03T11:18:35",
"upload_time_iso_8601": "2024-09-03T11:18:35.601495Z",
"url": "https://files.pythonhosted.org/packages/97/16/79cc716429a29e887d17aa7ab5f826fac08563ede3b0b203f9960e3b86fb/ghcr_badge-0.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-03 11:18:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "eggplants",
"github_project": "ghcr-badge",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ghcr_badge"
}
JSON
