{"id":16700500,"url":"https://github.com/glasswalk3r/awsecr","last_synced_at":"2026-02-01T22:31:42.876Z","repository":{"id":44915850,"uuid":"431654311","full_name":"glasswalk3r/awsecr","owner":"glasswalk3r","description":"CLI to interact with AWS ECR service","archived":false,"fork":false,"pushed_at":"2024-09-21T21:17:03.000Z","size":163,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-09-23T09:09:46.194Z","etag":null,"topics":["aws","cli","client","docker","ecr"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/glasswalk3r.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}},"created_at":"2021-11-24T23:20:37.000Z","updated_at":"2024-09-21T21:17:03.000Z","dependencies_parsed_at":"2024-04-15T22:39:23.332Z","dependency_job_id":"2b884da4-00e9-4181-8803-5e51d5c0d0a3","html_url":"https://github.com/glasswalk3r/awsecr","commit_stats":{"total_commits":104,"total_committers":2,"mean_commits":52.0,"dds":"0.22115384615384615","last_synced_commit":"e1f589d351e4e6d18812e189da13213f5de82435"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glasswalk3r%2Fawsecr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glasswalk3r%2Fawsecr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glasswalk3r%2Fawsecr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glasswalk3r%2Fawsecr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/glasswalk3r","download_url":"https://codeload.github.com/glasswalk3r/awsecr/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239132545,"owners_count":19587106,"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":["aws","cli","client","docker","ecr"],"created_at":"2024-10-12T18:10:49.910Z","updated_at":"2025-10-31T06:30:41.975Z","avatar_url":"https://github.com/glasswalk3r.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# awsecr\n\n[![Python application](https://github.com/glasswalk3r/awsecr/actions/workflows/python-app.yml/badge.svg)](https://github.com/glasswalk3r/awsecr/actions/workflows/python-app.yml)\n\nCLI to interact with AWS ECR service.\n\n## Description\n\nawsecr is a Python module that allows an end user to access an AWS ECR\nrepository to do the following:\n\n- pull/push images\n- list available repositories\n- list available images per repository, summarizing all founded vulnerabilities.\n\nAuthentication between AWS ECR and the local Docker client is automatic.\n\nSee `TODO.txt` for next planned features.\n\n## Samples outputs\n\nThe output samples will *roughly* look like the ones generated at the terminal\nby the CLI. Expect to have better output in the terminal.\n\nListing repositories available:\n\n```\n$ awsecr repos\n┌ All ECR repositories ───────┬────────────────────────────────────────────────────────────────┬────────────────┬───────────────┐\n│ Name                        │ URI                                                            │ Tag Mutability │ Scan on push? │\n├─────────────────────────────┼────────────────────────────────────────────────────────────────┼────────────────┼───────────────┤\n│ nodejs                      │ 012345678910.dkr.ecr.us-east-1.amazonaws.com/nodejs            │ IMMUTABLE      │ True          │\n│ spark-py                    │ 012345678910.dkr.ecr.us-east-1.amazonaws.com/spark-py          │ MUTABLE        │ False         │\n│ hive-metastore              │ 012345678910.dkr.ecr.us-east-1.amazonaws.com/hive-metastore    │ IMMUTABLE      │ True          │\n└─────────────────────────────┴────────────────────────────────────────────────────────────────┴────────────────┴───────────────┘\n```\n\nListing images from a repository:\n\n```\n┌ Docker images at api-foobar123  ─────────────────────────────────┬─────────────┬────────────┬───────────────────────────┬────────────────────┐\n│ Image                                                            │ Scan status │ Size (MB)  │ Pushed at                 │  Vulnerabilities   │\n├──────────────────────────────────────────────────────────────────┼─────────────┼────────────┼───────────────────────────┼────────────────────┤\n│ 012345678910.dkr.ecr.us-east-1.amazonaws.com/api-foobar123:1.3.5 │ COMPLETE    │ 205.1      │ 2021-12-09 18:06:20-03:00 │ 1/10/118/51/274/22 │\n│ 012345678910.dkr.ecr.us-east-1.amazonaws.com/api-foobar123:1.3.6 │ COMPLETE    │ 133.8      │ 2021-12-09 15:42:28-03:00 │ 1/10/118/51/274/22 │\n└──────────────────────────────────────────────────────────────────┴─────────────┴────────────┴───────────────────────────┴────────────────────┘\n```\n\nExcept that the *Vulnerabilities* column will have `1/10/118/51/274/22` as\nvalues in the terminal using colors to indicate severity, being highest to\nlesser, left to right.\n\n## How to install\n\nThe preferred way is to install it from https://pypi.org with:\n\n```\npip install awsecr\n```\n\n## How to use it\n\nYou can check the `awsecr` CLI online help:\n\n```\n$ awsecr -h\nusage: awsecr [OPERATION]\n\nEasier interaction with AWS ECR to manage Docker images.\n\npositional arguments:\n  {repos,image}      the desired operation with the registry.\n\noptional arguments:\n  -h, --help         show this help message and exit.\n  --image IMAGE      the local Docker image to use together with the image --push sub operation.\n  --list REPOSITORY  sub operation for \"image\" operation. List all images from the repository.\n  --push REPOSITORY  sub operation for \"image\" operation. Pushes a Docker image to the repository.\n\nThe \"repos\" operation requires no additional options. It lists the available\nECR repositories for the current AWS user credentials.\n```\n\n## References\n\nOther open source projects that are related to awsecr:\n\n- https://pypi.org/project/ecrtools/\n- https://pypi.org/project/ecr-scan-reporter/\n- https://github.com/muckamuck/ecrscan\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglasswalk3r%2Fawsecr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglasswalk3r%2Fawsecr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglasswalk3r%2Fawsecr/lists"}