{"id":20280350,"url":"https://github.com/yezz123/coveapi","last_synced_at":"2025-04-11T06:35:58.698Z","repository":{"id":180495796,"uuid":"664571822","full_name":"yezz123/CoveAPI","owner":"yezz123","description":"OpenAPI-based test coverage analysis tool that helps teams improve integration test coverage in CI/CD pipelines","archived":false,"fork":false,"pushed_at":"2024-04-29T23:21:09.000Z","size":741,"stargazers_count":20,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-02T22:07:17.671Z","etag":null,"topics":["actions","api","coverage","github-actions","openapi","rust","swagger","swagger-api","swagger-codegen"],"latest_commit_sha":null,"homepage":"https://coveapi.yezz.me","language":"Rust","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/yezz123.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"docs/code_of_conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"yezz123"}},"created_at":"2023-07-10T09:19:29.000Z","updated_at":"2024-06-03T04:05:35.205Z","dependencies_parsed_at":null,"dependency_job_id":"b00e925b-51d3-4703-8da8-74a4db7a0eb9","html_url":"https://github.com/yezz123/CoveAPI","commit_stats":null,"previous_names":["yezz123/coveapi"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yezz123%2FCoveAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yezz123%2FCoveAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yezz123%2FCoveAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yezz123%2FCoveAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yezz123","download_url":"https://codeload.github.com/yezz123/CoveAPI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248358289,"owners_count":21090400,"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","api","coverage","github-actions","openapi","rust","swagger","swagger-api","swagger-codegen"],"created_at":"2024-11-14T13:35:24.165Z","updated_at":"2025-04-11T06:35:58.669Z","avatar_url":"https://github.com/yezz123.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/yezz123/CoveAPI\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/yezz123/CoveAPI/main/docs/img/cover.png\"\u003e\n\u003c/a\u003e\n\u003cp align=\"center\"\u003e\n    \u003cem\u003eReady-to-use OpenAPI test coverage analysis tool that helps teams improve integration\u003c/em\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/yezz123/CoveAPI/actions/workflows/ci.yml\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://github.com/yezz123/CoveAPI/actions/workflows/ci.yml/badge.svg\" alt=\"lint\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://codecov.io/gh/yezz123/CoveAPI\" \u003e\n    \u003cimg src=\"https://codecov.io/gh/yezz123/CoveAPI/branch/main/graph/badge.svg\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/yezz123/CoveAPI/blob/main/LICENSE\" \u003e\n    \u003cimg src=\"https://img.shields.io/github/license/yezz123/CoveAPI.svg\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/yezz123/CoveAPI\" \u003e\n    \u003cimg src=\"https://img.shields.io/github/repo-size/yezz123/coveapi\"/\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\u003c/p\u003e\n\nCoveAPI is an advanced test coverage analysis tool based on the OpenAPI standard. It offers a comprehensive solution for teams to effectively measure and improve their integration test coverage within CI/CD pipelines.\n\nWith CoveAPI, teams can easily establish and enforce specific coverage thresholds, ensuring that critical parts of their application are thoroughly tested. By integrating CoveAPI into their existing CI/CD workflows, teams can automatically track and monitor test coverage metrics, making it easier to identify areas that require additional testing.\n\n## Help\n\nSee [documentation](https://coveapi.yezz.me/) for more details.\n\n## Usage\n\n### Integrate CoveAPI into your CI/CD pipeline\n\nDirect your integration tests towards the CoveAPI reverse proxy to enable analysis and interpretation of requests that occur during the testing process. This ensures that CoveAPI effectively handles requests during integration testing.\n\nConfigure your tests to target either `http://localhost:13750` (without Docker) or `http://coveapi:13750` (with Docker). If you are using Docker, CoveAPI will automatically set up the networking for your container to establish a connection with it.\n\n### Setup Preparation Stage\n\nTo ensure CoveAPI is properly configured for later use, follow these steps. Place this preparation stage after starting your service and before running your integration tests.\n\nPlease remember to replace the location of your OpenAPI spec and the instance URL. You can provide the OpenAPI spec as either a local file path or a URL.\n\n```yaml\n- name: Initialize CoveAPI\n  uses: yezz123/coveapi@2.1.0\n  with:\n    stage: \"preparation\"\n    openapi-source: \"docs/swagger.json\"\n    instance-url: \"http://localhost:8080\"\n    test-coverage: \"75%\"\n```\n\nMake sure to modify the `openapi-source` parameter to point to the location of your OpenAPI or Swagger specification. This can be either a local file path or a URL.\n\nSimilarly, adjust the `instance-url` parameter to match the base URL of your service, excluding the base path specified in your OpenAPI spec.\n\nOptionally, you can set a desired `test-coverage` value for your endpoints.\n\nBy following these steps, CoveAPI will be properly prepared for integration testing, ensuring accurate analysis and interpretation of requests.\n\n### Setup Evaluation Stage\n\nPlace the CoveAPI evaluation stage somewhere after your integration tests have run.\n\n```yaml\n  - uses: yezz123/coveapi@2.1.0\n    name: Evaluate CoveAPI\n    with:\n      stage: \"evaluation\"\n```\n\nThis stage will fail if test coverage isn't met and can display additional information gathered during the integration tests.\n\n## Contributing\n\nFor guidance on setting up a development environment and how to make a contribution to CoveAPI, see [Contributing to CoveAPI](https://coveapi.yezz.me/contributing).\n\n## Reporting a Security Vulnerability\n\nSee our [security policy](https://github.com/yezz123/CoveAPI/security/policy).\n","funding_links":["https://github.com/sponsors/yezz123"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyezz123%2Fcoveapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyezz123%2Fcoveapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyezz123%2Fcoveapi/lists"}