{"id":18459197,"url":"https://github.com/smartbear/readyapi-testengine-maven-plugin","last_synced_at":"2025-04-08T05:35:02.601Z","repository":{"id":40338621,"uuid":"49598598","full_name":"SmartBear/readyapi-testengine-maven-plugin","owner":"SmartBear","description":"Maven plugin for Ready! API TestServer","archived":false,"fork":false,"pushed_at":"2024-11-22T14:56:26.000Z","size":85,"stargazers_count":1,"open_issues_count":13,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-23T07:12:17.767Z","etag":null,"topics":["on-prem","readyapi-testengine","saas"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SmartBear.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2016-01-13T20:06:21.000Z","updated_at":"2025-01-14T10:48:19.000Z","dependencies_parsed_at":"2024-11-06T08:26:45.153Z","dependency_job_id":"f76953a5-042f-4630-91f0-1dfcbdb30fc5","html_url":"https://github.com/SmartBear/readyapi-testengine-maven-plugin","commit_stats":null,"previous_names":["olensmar/readyapi-testserver-maven-plugin"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartBear%2Freadyapi-testengine-maven-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartBear%2Freadyapi-testengine-maven-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartBear%2Freadyapi-testengine-maven-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartBear%2Freadyapi-testengine-maven-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SmartBear","download_url":"https://codeload.github.com/SmartBear/readyapi-testengine-maven-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247785918,"owners_count":20995641,"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":["on-prem","readyapi-testengine","saas"],"created_at":"2024-11-06T08:22:13.804Z","updated_at":"2025-04-08T05:34:57.587Z","avatar_url":"https://github.com/SmartBear.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ReadyAPI TestEngine Maven Plugin\n\nA maven plugin that runs a set of SoapUI/ReadyAPI projects with [ReadyAPI TestEngine](https://smartbear.com/product/ready-api/testengine/overview/) - \nconfigure it to run in whatever build phase you might find relevant, for example;\n\n```\n\u003cplugin\u003e\n    \u003cgroupId\u003ecom.smartbear.readyapi\u003c/groupId\u003e\n    \u003cartifactId\u003etestengine-maven-plugin\u003c/artifactId\u003e\n    \u003cversion\u003e1.0.1\u003c/version\u003e\n    \u003cconfiguration\u003e\n        \u003cusername\u003edefaultUser\u003c/username\u003e\n        \u003cpassword\u003edefaultPassword\u003c/password\u003e\n        \u003cserver\u003e...ReadyAPI TestEngine endpoint...\u003c/server\u003e\n    \u003c/configuration\u003e\n    \u003cexecutions\u003e\n        \u003cexecution\u003e\n            \u003cid\u003erun\u003c/id\u003e\n            \u003cphase\u003eintegration-test\u003c/phase\u003e\n            \u003cgoals\u003e\n                \u003cgoal\u003erun\u003c/goal\u003e\n            \u003c/goals\u003e\n        \u003c/execution\u003e\n    \u003c/executions\u003e\n\u003c/plugin\u003e\n```\n\nThe only goal exposed by the plugin is \"run\" - you can invoke it as above or directly from the command-line, for example\n\n```\nmvn testengine:run \n```\n\nThe plugin will look for files with either json or xml extensions.\n\n## Configuration\n\nConfiguration parameters are:\n\n* username (required) : the TestEngine username to use for authentication\n* password (required) : the TestEngine password to use for authentication\n* server (required) : endpoint of the TestEngine (no trailing slash!)\n* projectsDirectory : the folder to scan recursively for projects and recipes, defaults to ${project.basedir}/src/test/resources/test-projects\n* targetDirectory : the folder to which filtered recipes will be copied before executing, defaults\nto ${project.basedir}/target/test-recipes\n* properties : an optional set of additional properties that will be used during filtering (see below)\n* disableFiltering : disables filtering of recipes - if set to true the recipes will not be copied and filtered\nto the target directory, instead they will run directly from the source directory.\n* reportTarget : the folder to which a junit-report.xml file will be generated (as can be processed by \nthe surefire plugin), defaults to ${basedir}/target/surefire-reports\n* environment : if you're submitting existing SoapUI/Ready!API project files this allows you to select which environment \nto target\n* async : toggle if tests should be executed asynchronously - default is false which will wait for tests to finish \n to be able to create test-reports. Setting this to true will disable reporting functionality, but allow you \nto specify an optional callback that will be called by the TestEngine with test results when they are finished.\n* callback : an optional url to call with finished test results if async is set to true \n* hostAndPort: an optional string in the format host:port which will replace the host and port in all HTTP requests sent by the test.\n\nSpecifying a skipApiTests system property will bypass this plugin altogether.\n\nThe plugin will also look for standard properties file named testengine.properties in the projectsDirectory folder and\nload any properties in this file before applying the properties specified in the configuration.\n\n## Filtering\n\nJson recipes will be filtered and copied to the folder specified by targetDirectory before getting executed. \nAny available property will be replaced, which makes it easy to parameterize your tests.\n\nFor example the following simple recipe:\n\n```\n{\n    \"testSteps\": [\n        {\n            \"type\": \"REST Request\",\n            \"method\": \"GET\",\n            \"URI\": \"${apitest.host}/apis\",\n            \"assertions\": [\n                {\n                    \"type\": \"Valid HTTP Status Codes\",\n                    \"validStatusCodes\": [200]\n                }\n            ]\n        }\n    ]\n}\n```\n\nwould use a property defined as \n\n```\n...\n\u003capitest.host\u003e...\u003c/apitest.host\u003e\n...\n```              \n\nwhen assembling the URI. You can simply look in the targetDirectory folder after your tests were run to see what was \nactually executed.\n\n## Error reporting\n\nCurrently the plugin simple fails the build if any tests fail and dumps the ReadyAPI TestEngine \nresponse to the console. A surefire xml file is generated for inclusion in generated reports.\n\n## Building the plugin\n\nSimply pull this repo and run \n\n```\nmvn clean install\n```\n\nto install the latest version of the plugin locally. It will eventually be made available on maven central also.\n\n\n## Next steps?\n\nObviously huge list of things to improve:\n- support datadriven tests\n- improved surefire reports\n- etc..\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartbear%2Freadyapi-testengine-maven-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmartbear%2Freadyapi-testengine-maven-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartbear%2Freadyapi-testengine-maven-plugin/lists"}