Implementation of saucectl-run-action (saucelabs#2)

Author: FriggaHel

.github/workflows/test.yml

@@ -0,0 +1,39 @@
+name: Tests
+
+on:
+  pull_request:
+    branches:
+      - master
+  push:
+    branches: ['*']
+
+jobs:
+  sanity:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v1
+        with:
+          node-version: 12.x
+      - name: install devDependencies
+        run: npm ci
+      - name: run the tests
+        run: npm test
+      - name: build new dist
+        run: npx ncc build src/index.js -o dist/reference
+      - name: compare actual build with expected
+        run: diff -U 5 dist/reference/index.js dist/main/index.js
+  build:
+    strategy:
+      matrix:
+        platform: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.platform }}
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v1
+        with:
+          node-version: 12.x
+      - name: install devDependencies
+        run: npm ci
+      - name: run the tests
+        run: npm test

.gitignore

@@ -0,0 +1,2 @@
+node_modules
+coverage

README.md

@@ -0,0 +1,87 @@
+# Saucectl
+
+This action install and launch [saucectl](https://github.com/saucelabs/saucectl/) tests.
+
+## Example
+
+### Basic
+
+```
+jobs:
+    test:
+        runs-on: ubuntu-latest
+        name: Action Test
+        steps:
+            # ...
+            - uses: saucelabs/saucectl-action@v1
+            # ...
+```
+
+### Advanced
+
+```
+jobs:
+    test:
+        runs-on: ubuntu-latest
+        name: Action Test
+        steps:
+        - uses: saucelabs/saucectl-action@master
+            with:
+                sauce-username: ${{ secrets.SAUCE_USERNAME }}
+                sauce-access-key: ${{ secrets.SAUCE_ACCESS_KEY }}
+                saucectl-version: v0.25.1
+                working-directory: ./testrunner-toolkit/cypress/
+                testing-environment: sauce
+
+```
+
+## Inputs
+
+## saucectl-version
+
+Version of saucectl to use. \
+Default: latest
+
+## sauce-username
+
+Sauce Labs user name.
+
+## sauce-access-key
+
+Sauce Labs Access Key.
+
+##  working-directory
+
+Folder in-which saucectl will be run.\
+Default: `.`
+
+## config-file
+
+Configuration file to use with saucectl.\
+Default: `.sauce/config.yml`
+
+> This value is relative to `working-directory`.
+
+
+## region
+
+Region flag to pass to saucectl.
+
+> Similar to `--region <region>` parameter available in saucectl.
+
+## testing-environment
+
+Testing Environment to use.\
+Default: `docker`
+
+> Similar to `--test-env <env>` parameter available in saucectl.
+
+## skip-run
+
+Skip execution of saucectl (only install binary).
+
+## suite
+
+Suite to run.
+
+> Similar to `--suite <suite>` parameter available in saucectl.

action.yml

@@ -0,0 +1,42 @@
+name: Saucectl Run Action
+description: A GitHub action to run your saucectl tests
+author: [email protected]
+branding:
+    icon: tool
+    color: red
+inputs:
+  saucectl-version:
+    description: 'Version of saucectl to use. Example: v0.25.1'
+    default: latest
+    required: false
+  sauce-username:
+    description: Sauce Labs user name.
+    required: false
+  sauce-access-key:
+    description: Sauce Labs API Key.
+    required: false
+  working-directory:
+    description: Folder in-which saucectl will be run.
+    default: .
+    required: false
+  config-file:
+    description: Configuration file to use with saucectl
+    default: .sauce/config.yml
+    required: false
+  region:
+    description: gion to pass to saucectl.
+    required: false
+  testing-environment:
+    description: Testing Environment
+    default: docker
+    required: false
+  skip-run:
+    description: Skip execution of saucectl (only install binary)
+    default: false
+    required: false
+  suite:
+    description: Suite to be tested
+    required: false
+runs:
+  using: 'node12'
+  main: 'dist/main/index.js'