{"id":20308328,"url":"https://github.com/suse-enceladus/img-proof","last_synced_at":"2025-10-30T09:32:16.257Z","repository":{"id":23791296,"uuid":"97205306","full_name":"SUSE-Enceladus/img-proof","owner":"SUSE-Enceladus","description":"img-proof provides a command line utility to test images in the Public Cloud","archived":false,"fork":false,"pushed_at":"2024-12-04T14:47:41.000Z","size":1633,"stargazers_count":15,"open_issues_count":11,"forks_count":7,"subscribers_count":19,"default_branch":"main","last_synced_at":"2024-12-04T15:36:56.512Z","etag":null,"topics":["infrastructure-testing","pytest","python","testinfra"],"latest_commit_sha":null,"homepage":"https://img-proof.readthedocs.io/en/latest/","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/SUSE-Enceladus.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":"CONTRIBUTING.md","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":"2017-07-14T07:19:33.000Z","updated_at":"2024-12-04T14:48:05.000Z","dependencies_parsed_at":"2023-01-13T23:52:58.766Z","dependency_job_id":"72fbf4c0-bd7d-45d3-9689-ee6cefb2e2e9","html_url":"https://github.com/SUSE-Enceladus/img-proof","commit_stats":{"total_commits":768,"total_committers":11,"mean_commits":69.81818181818181,"dds":0.05598958333333337,"last_synced_commit":"f8a6cbe5f23a48a000671134b21283d5f17b285a"},"previous_names":[],"tags_count":113,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE-Enceladus%2Fimg-proof","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE-Enceladus%2Fimg-proof/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE-Enceladus%2Fimg-proof/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE-Enceladus%2Fimg-proof/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SUSE-Enceladus","download_url":"https://codeload.github.com/SUSE-Enceladus/img-proof/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230367928,"owners_count":18215338,"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":["infrastructure-testing","pytest","python","testinfra"],"created_at":"2024-11-14T17:21:44.552Z","updated_at":"2025-10-30T09:32:16.252Z","avatar_url":"https://github.com/SUSE-Enceladus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Continuous testing \u0026 Linting](https://github.com/SUSE-Enceladus/img-proof/workflows/Continuous%20testing%20\u0026%20Linting/badge.svg)\n[![Documentation Status](https://readthedocs.org/projects/img-proof/badge/?version=latest)](https://img-proof.readthedocs.io/en/latest/?badge=latest)\n![Build Status](https://build.opensuse.org/projects/Cloud:Tools:CI/packages/python-img-proof/badge.svg)\n[![Py Versions](https://img.shields.io/pypi/pyversions/img-proof.svg)](https://pypi.org/project/img-proof/)\n[![License](https://img.shields.io/pypi/l/img-proof.svg)](https://pypi.org/project/img-proof/)\n\n[![img-proof](https://raw.githubusercontent.com/SUSE-Enceladus/img-proof/master/docs/source/_images/logo.png \"img-proof Logo\")](https://github.com/SUSE-Enceladus/img-proof)\n\noverview\n========\n\n**img-proof** (IPA) provides a command line utility to test\nimages in the Public Cloud (AWS, Azure, GCE, etc.).\n\nWith **img-proof** you can now test custom images in a cloud framework agnostic way\nwith one tool and one API. In the first release, **img-proof** supports the\nopenSUSE and SLES distributions. It also supports the three largest\ncloud frameworks (AWS, Azure and GCE). However, it is intended to be\ndistribution agnostic and framework transparent so both are easily\nextensible.\n\nFor each distribution there are specific synchronization points that\nmust be provided. These currently include soft reboot and system update.\nThe synch points not only test functionality but also act as dividers to\nseparate distinct sections of a test suite. For example you can run a\ntest to ensure the proper repos exist before and after a system update.\nThe system update synch point will guarantee the order of tests.\nSpeaking of tests, if you're already familiar with Pytest conventions\nthere's no need to learn a whole new unit testing framework. **img-proof** is\nwritten in Python and leverages the Pytest framework through Testinfra.\n\nInstallation\n============\n\nTo install the package use the following commands as root:\n\n```shell\n$ zypper ar http://download.opensuse.org/repositories/Cloud:/Tools:/CI/\u003cdistribution\u003e\n$ zypper refresh\n$ zypper in python-img-proof\n```\n\nRequirements\n============\n\n-   boto3\n-   apache-libcloud\n-   azure-common\n-   azure-mgmt-compute\n-   azure-mgmt-network\n-   azure-mgmt-resource\n-   Click\n-   paramiko\n-   pytest\n-   PyYaml\n-   testinfra\n-   oci\n\n# [Docs](https://img-proof.readthedocs.io/en/latest/)\n\nTests\n=====\n\n**img-proof** uses the Testinfra package for writing unit tests. Testinfra\nleverages Pytest and provides modules such as Package, Process and\nService to test the state of images. See the [Testinfra\nDocs](https://testinfra.readthedocs.io/en/latest/) for more information\non writing infrastructure tests.\n\n\u003e **img-proof** currently passes the Pytest option `-x` (stop on first\n\u003e failure) through as `--early-exit`. If there's an interest or need for\n\u003e any other options/args please submit an issue to\n\u003e [Github](https://github.com/SUSE-Enceladus/img-proof/issues).\n\nCLI Overview\n============\n\nThe CLI provides multiple subcommands to initiate image testing:\n\n* `img-proof test`\n\n   Test image in the given framework using the supplied test files.\n\n* `img-proof results`\n\n   Invokes the default show subcommand `img-proof results show 1`.\n\n* `img-proof results clear`\n\n   Clear the results from the history file.\n\n* `img-proof results delete`\n\n   Delete the specified history item from the history log.\n\n* img-proof results list`\n\n   Display list of results history.\n\n* `img-proof results show`\n\n   Display the results or log file for a history item.\n\n* `img-proof list`\n\n   Print a list of test files or test cases.\n\nIssues/Enhancements\n===================\n\nPlease submit issues and requests to\n[Github](https://github.com/SUSE-Enceladus/img-proof/issues).\n\nContributing\n============\n\nContributions to **ipa** are welcome and encouraged. See\n[CONTRIBUTING](https://github.com/SUSE-Enceladus/img-proof/blob/master/CONTRIBUTING.md)\nfor info on getting started.\n\nLicense\n=======\n\nCopyright (c) 2018 SUSE LLC.\n\nDistributed under the terms of GPL-3.0+ license, see\n[LICENSE](https://github.com/SUSE-Enceladus/img-proof/blob/master/LICENSE)\nfor details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuse-enceladus%2Fimg-proof","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuse-enceladus%2Fimg-proof","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuse-enceladus%2Fimg-proof/lists"}