feat(build-workspace-matrix): build dynamic work matrix based on glob…

…s and changed files (#4)

build-workspace-matrix/README.md

@@ -0,0 +1,52 @@
+# build-workspace-matrix
+
+Builds a matrix of workspaces based on glob patterns and analysis of which files have changed
+
+## Inputs
+
+### `github-token`
+
+**Required** The GitHub API token to use.
+
+### `workspaces`
+
+**Required** A newline-separated list of globs representing specific workspaces.
+
+### `global_dependencies`
+
+A newline-separated list of globs representing dependencies of each workspace. If any of the dependencies have changed then all workspaces will be returned.
+
+## Outputs
+
+### `matrix`
+
+The matrix object of the following shape:
+
+```json
+{
+  "workspace": [
+    "match1",
+    "match2"
+  ]
+}
+```
+
+## Example usage
+
+````
+determine-matrix:
+  runs-on: ubuntu-latest
+  outputs:
+    matrix: ${{ steps.build-workspace-matrix.outputs.matrix }}
+  steps:
+  - uses: actions/checkout@master
+  - id: build-workspace-matrix
+    uses: iStreamPlanet/github-actions/build-workspace-matrix@master
+    with:
+      github-token: ${{secrets.GITHUB_TOKEN}}
+      workspace_globs: |
+        terraform/clusters/*/
+      dependency_globs: |
+        terraform/modules/**/*.tf
+        .github/workflows/terraform_diff.yml
+````

build-workspace-matrix/action.yml

@@ -0,0 +1,18 @@
+name: "build-workspace-matrix"
+description: "Builds a matrix of workspaces based on glob patterns and analysis of which files have changed"
+inputs:
+  github-token:
+    description: The GitHub token used to create an authenticated client
+    required: true
+  workspaces:
+    description: "A newline-separated list of globs representing specific workspaces"
+    required: true
+  global_dependencies:
+    description: "A newline-separated list of globs representing dependencies of each workspace. If any of the dependencies have changed then all workspaces will be returned."
+    required: false
+outputs:
+  matrix:
+    description: "The matrix object of the shape: { workspace: [] }"
+runs:
+  using: "node12"
+  main: "dist/index.js"