{"id":22308823,"url":"https://github.com/ratson/cordova-paramedic-runner","last_synced_at":"2025-06-20T14:10:41.878Z","repository":{"id":57207626,"uuid":"98730357","full_name":"ratson/cordova-paramedic-runner","owner":"ratson","description":null,"archived":false,"fork":false,"pushed_at":"2017-07-30T12:26:46.000Z","size":309,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-01T05:17:08.949Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/ratson.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}},"created_at":"2017-07-29T12:13:55.000Z","updated_at":"2017-08-02T11:11:54.000Z","dependencies_parsed_at":"2022-09-11T05:30:28.591Z","dependency_job_id":null,"html_url":"https://github.com/ratson/cordova-paramedic-runner","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ratson/cordova-paramedic-runner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ratson%2Fcordova-paramedic-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ratson%2Fcordova-paramedic-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ratson%2Fcordova-paramedic-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ratson%2Fcordova-paramedic-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ratson","download_url":"https://codeload.github.com/ratson/cordova-paramedic-runner/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ratson%2Fcordova-paramedic-runner/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260959043,"owners_count":23088815,"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-12-03T20:15:28.998Z","updated_at":"2025-06-20T14:10:36.865Z","avatar_url":"https://github.com/ratson.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"cordova-paramedic\n=================\n\n[![Build Status](https://travis-ci.org/apache/cordova-paramedic.svg?branch=master)](https://travis-ci.org/apache/cordova-paramedic)\n[![Build status](https://ci.appveyor.com/api/projects/status/iufmfjo0j0dd4c1w?svg=true)](https://ci.appveyor.com/project/ApacheSoftwareFoundation/cordova-paramedic)\n\nRuns cordova medic/buildbot tests locally.\n\n... provides advanced levels of care at the point of illness or injury, including out of hospital treatment, and diagnostic services\n\n# To install :\n``` $npm install cordova-paramedic ```\n\n## Supported Cordova Platforms\n\n- Android\n- iOS\n- Windows Phone 8\n- Windows (Windows 8.1, Windows Phone 8.1, Windows 10 Tablet/PC)\n- Browser\n- OSX\n\n# Usage\n\nParamedic parameters could be passed via command line arguments or via separate configuration file:\n\n```\ncordova-paramedic --platform PLATFORM --plugin PATH \u003cother parameters\u003e\ncordova-paramedic --config ./sample-config/.paramedic.config.js\n```\n\n## Command Line Interface\n\n####`--platform` (required)\n\nSpecifies target cordova platform (could refer to local directory, npm or git)\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser\ncordova-paramedic --platform ios@4.0 --plugin cordova-plugin-inappbrowser\ncordova-paramedic --platform ios@../cordova-ios --plugin cordova-plugin-inappbrowser\ncordova-paramedic --platform ios@https://github.com/apache/cordova-ios.git#4.1.0 --plugin cordova-plugin-inappbrowser\n```\n\n####`--plugin` (required)\n\nSpecifies test plugin, you may specify multiple --plugin flags and they will all be installed and tested together. You can refer to absolute path, npm registry or git repo.\nIf the plugin requires variables to install, you can specify them along with its name.\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser\ncordova-paramedic --platform ios --plugin 'azure-mobile-engagement-cordova --variable AZME_IOS_CONNECTION_STRING=Endpoint=0;AppId=0;SdkKey=0'\ncordova-paramedic --platform ios --plugin https://github.com/apache/cordova-plugin-inappbrowser\n// several plugins\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --plugin cordova-plugin-contacts\n```\n####--justbuild (optional)\n\nJust builds the project, without running the tests.\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --justbuild\n```\n\n####--externalServerUrl (optional)\n\nUseful when testing on real device (`--device` parameter) so that tests results from device could be posted back to paramedic server.\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --externalServerUrl http://10.0.8.254\n```\n\n####--useTunnel (optional)\n\nUse [tunneling](https://www.npmjs.com/package/localtunnel) instead of local address (default is false).\nUseful when testing on real devices and don't want to specify external ip address (see `--externalServerUrl` above) of paramedic server.\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --useTunnel\n```\n\n####--browserify (optional)\n\nPlugins are browserified into cordova.js.\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --browserify\n```\n\n####--port (optional)\n\nPort to use for posting results from emulator back to paramedic server (default is from `8008`). You can also specify a range using `--startport` and `endport` and paramedic will select the first available.\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --port 8010\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --startport 8000 endport 8020\n```\n\n####--verbose (optional)\n\nVerbose mode. Display more information output\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --verbose\n```\n\n####--cli (optional)\n\nA path to Cordova CLI. Useful when you're testing against locally installed Cordova version.\n\n```\ncordova-paramedic --platform android --plugin cordova-plugin-device --cli ./cordova-cli/bin/cordova\n```\n\n####--timeout (optional)\n\nTime in millisecs to wait for tests to pass|fail (defaults to 10 minutes).\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --timeout 30000\n```\n\n####--outputDir (optional)\n\nDirectory location to store test results in junit format and the device logs\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --outputDir /Users/sampleuser/testresults\n```\n\n####--cleanUpAfterRun (optional)\n\nFlag to indicate the sample application folder must be deleted.\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-inappbrowser --cleanUpAfterRun\n```\n\n####--logMins (optional)\n\nWindows only parameter to indicate the duration for which the device logs to be fetched.\n\n```\ncordova-paramedic --platform windows --plugin cordova-plugin-inappbrowser --logMins 15\n```\n\n####--tccDb (optional)\n\niOS only parameter. The path to the sample TCC DB file, with permissions, to be copied to the simulator.\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-contacts --tccDbPath tcc.db\n```\n\n###Sauce-only arguments\n\n####--shouldUseSauce (optional)\n\nRun tests on [Sauce Labs](https://saucelabs.com/). You'll need to specify Sauce Labs username and access key using either --sauceUser and --sauceKey arguments or `SAUCE_USERNAME` and `SAUCE_ACCESS_KEY` environment variables.\n\n####--buildName (optional)\n\nBuild name to show on Sauce Labs dashboard. If omitted, will use \"Paramedic sauce test\" and a timestamp.\n\n####--sauceUser (optional)\n\nSauce Labs username.\n\n####--sauceKey (optional)\n\nSauce Labs access key.\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-contacts --shouldUseSauce --sauceUser ***** --sauceKey ***** --buildName \"paramedic-test-01\"\n```\n\n####--sauceDeviceName (optional)\n\nName of the Sauce Labs emulator or browser. For example, \"iPhone Simulator\" or \"firefox\". Please refer to the [Sauce Labs platforms list](https://saucelabs.com/platforms) to see available device names.\n\n####--saucePlatformVersion (optional)\n\nPlatform version of the Sauce Labs emulator OS, or version of the browser (if testing `browser` platform). For example, \"9.3\" or \"54.0\". Please refer to the [Sauce Labs platforms list](https://saucelabs.com/platforms) to see available platform versions.\n\n####--sauceAppiumVersion (optional)\n\nAppium version to use when running on Sauce Labs. For example, \"1.5.3\".\n\n```\ncordova-paramedic --platform ios --plugin cordova-plugin-contacts --shouldUseSauce --sauceUser ***** --sauceKey ***** --sauceDeviceName 'iPad Simulator\" --saucePlatformVersion 9.1 --appiumVersion 1.5.2\n```\n\n## Paramedic configuration file\n\nConfiguration file is used when no parameters are passed to `cordova-paramedic` call or explicitly specified via `--config` parameter:\n```\ncordova-paramedic  \u003c- paramedic will attempt to find .paramedic.config.js in working directory\ncordova-paramedic --config ./sample-config/.paramedic.config.js\n```\nExample configuration file is showed below.\n```\nmodule.exports = {\n    // \"externalServerUrl\": \"http://10.0.8.254\",\n    \"useTunnel\": true,\n    \"plugins\": [\n        \"https://github.com/apache/cordova-plugin-inappbrowser\"\n    ],\n    \"platform\": \"windows\",\n    \"action\": \"run\",\n    \"args\": \"--archs=x64 -- --appx=uap\"\n}\n```\nMore configuration file examples could be found in `sample-config` folder.\n\n## Windows quirks\n\nFor paramedic to work correctly on Windows you'll need to allow the loopback for \"HelloCordova\" app using [Windows Loopback Exemption Manager](https://loopback.codeplex.com/).\n\n## API Interface\n\nYou can also use cordova-paramedic as a module directly :\n\n```\n  var paramedic = require('cordova-paramedic');\n  paramedic.run(config);\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fratson%2Fcordova-paramedic-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fratson%2Fcordova-paramedic-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fratson%2Fcordova-paramedic-runner/lists"}