{"id":15023720,"url":"https://github.com/marketsquare/roboswag","last_synced_at":"2025-04-10T23:51:01.621Z","repository":{"id":39653568,"uuid":"418146800","full_name":"MarketSquare/roboswag","owner":"MarketSquare","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-14T07:49:57.000Z","size":220,"stargazers_count":27,"open_issues_count":14,"forks_count":3,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-03-24T20:38:17.366Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MarketSquare.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-17T13:52:00.000Z","updated_at":"2025-03-19T07:57:13.000Z","dependencies_parsed_at":"2024-09-24T21:31:28.227Z","dependency_job_id":null,"html_url":"https://github.com/MarketSquare/roboswag","commit_stats":{"total_commits":75,"total_committers":4,"mean_commits":18.75,"dds":"0.18666666666666665","last_synced_commit":"5558d0289cb21d50cdddcd64fe9f45513516b3d6"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarketSquare%2Froboswag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarketSquare%2Froboswag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarketSquare%2Froboswag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarketSquare%2Froboswag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MarketSquare","download_url":"https://codeload.github.com/MarketSquare/roboswag/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248317707,"owners_count":21083528,"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":[],"created_at":"2024-09-24T19:59:22.516Z","updated_at":"2025-04-10T23:51:01.603Z","avatar_url":"https://github.com/MarketSquare.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Roboswag \n\n- [Introduction](#introduction)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Limitations](#limitations)\n\n## Introduction\n\n:robot: Roboswag is a tool that automatically generates Python libraries out of your Swagger (OpenAPI specification \nfile). These libraries can be used to create tests with various payload content and its validation. It also supports \nresponse validation against schema and verification of different status codes.\n\n\u003e **Note**\n\u003e\n\u003e The tool is in the ***Alpha*** state, which means it may be unstable and should be used at your own risk. Some \n\u003e features may be broken and there are still many things to be developed. Happy testing!\n\nThe OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs.\nClick [here for v3 documentation](https://swagger.io/specification/) and\n[here for v2 documentation](https://swagger.io/specification/v2).\n\n\u003e Hosted on [GitHub](https://github.com/MarketSquare/roboswag). :medal_military:\n\n## Installation\n\nYou can install Roboswag simply by running::\n\n    pip install roboswag\n\n## Usage\n\nRoboswag can be easily run from command line. To check if it's installed, run this to see the current version:\n\n```commandline\nroboswag -v\n```\n\nTo execute Roboswag with its full capabilities, run it with provided path to the Swagger (OpenAPI specification) file:\n\n```commandline\nroboswag generate -s \u003cpath_to_swagger\u003e\n```\n\n\u003e You can try out the tool using the example of swagger file located in `swaggers/petstore.json`.\n\nSuccessful execution should result in printing the information about generated files and a whole new directory (named \nby the value of `info.title` from your Swagger file) consisting of:\n- `endpoints` directory with files representing each `tag` as a class with methods representing its endpoints,\n- `models` directory with API models represented as Python classes,\n- `schemas` directory with every possible schema from your API as JSON file used for validating payload and responses. \n\nNow you can just create a test file, import desired endpoint and start automating the testing!\n\n## Limitations\n\nThe tool is already able to generate libraries but...\n- Not all fields from the swagger specification may be supported. This means that a specific file may break the tool \n  and flood the terminal with stack trace (we will be really grateful to receive bug issues in our Github project!)\n- Authorization to access the API is not yet fully covered\n- There is not much to be configured here - it always works the same\n- There is no real documentation apart from this file\n\nPlease be forgiving and submit an issue, if you struggle with something or just contact us on our\n[Slack channel](https://robotframework.slack.com/archives/C035KMZ2FGA). It's more than welcome also to support us by \ncode contribution! :keyboard:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarketsquare%2Froboswag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarketsquare%2Froboswag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarketsquare%2Froboswag/lists"}