diff --git a/README.md b/README.md index 0bd1994..9dd2647 100644 --- a/README.md +++ b/README.md @@ -57,54 +57,58 @@ jobs: ``` + ## Inputs -| name | description | required | default | -| --- | --- | --- | --- | -| `working-directory` |

Working directory for run commands

| `false` | `.` | -| `stack-yaml` |

Override stack.yaml, relative to working-directory

| `false` | `stack.yaml` | -| `test` |

Whether to run tests

| `false` | `true` | -| `stack-arguments` |

Additional arguments for all top-level stack command invocations.

| `false` | `--no-terminal` | -| `stack-query-arguments` |

Additional arguments in stack query invocations.

| `false` | `""` | -| `stack-path-arguments` |

Additional arguments in stack path invocations.

| `false` | `""` | -| `stack-setup-arguments` |

Additional arguments in stack setup invocations.

| `false` | `""` | -| `stack-build-arguments` |

Additional arguments for all stack build invocations.

| `false` | `--fast --pedantic` | -| `stack-build-arguments-dependencies` |

Additional arguments passed after stack-build-arguments in stack build invocations on the Dependencies step.

| `false` | `""` | -| `stack-build-arguments-build` |

Additional arguments passed after stack-build-arguments in stack build invocations on the Build step.

| `false` | `""` | -| `stack-build-arguments-test` |

Additional arguments passed after stack-build-arguments in stack build invocations on the Test step.

| `false` | `""` | -| `cache-prefix` |

Prefix applied to all cache keys. This can be any value you like, but teams often use v{N} and bump it to v{N+1} when/if they need to explicitly bust caches.

| `false` | `""` | -| `cache-save-always` |

Save artifacts to the cache even if the build fails. This may speed up builds in subsequent runs at the expense of slightly-longer builds when a full cache-hit occurs. Since @v4.2.0

| `false` | `false` | +| name | description | required | default | +| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------- | +| `working-directory` |

Working directory for run commands

| `false` | `.` | +| `stack-yaml` |

Override stack.yaml, relative to working-directory

| `false` | `stack.yaml` | +| `test` |

Whether to run tests

| `false` | `true` | +| `stack-arguments` |

Additional arguments for all top-level stack command invocations.

| `false` | `--no-terminal` | +| `stack-query-arguments` |

Additional arguments in stack query invocations.

| `false` | `""` | +| `stack-path-arguments` |

Additional arguments in stack path invocations.

| `false` | `""` | +| `stack-setup-arguments` |

Additional arguments in stack setup invocations.

| `false` | `""` | +| `stack-build-arguments` |

Additional arguments for all stack build invocations.

| `false` | `--fast --pedantic` | +| `stack-build-arguments-dependencies` |

Additional arguments passed after stack-build-arguments in stack build invocations on the Dependencies step.

| `false` | `""` | +| `stack-build-arguments-build` |

Additional arguments passed after stack-build-arguments in stack build invocations on the Build step.

| `false` | `""` | +| `stack-build-arguments-test` |

Additional arguments passed after stack-build-arguments in stack build invocations on the Test step.

| `false` | `""` | +| `cache-prefix` |

Prefix applied to all cache keys. This can be any value you like, but teams often use v{N} and bump it to v{N+1} when/if they need to explicitly bust caches.

| `false` | `""` | +| `cache-save-always` |

Save artifacts to the cache even if the build fails. This may speed up builds in subsequent runs at the expense of slightly-longer builds when a full cache-hit occurs. Since @v4.2.0

| `false` | `false` | + + ## Outputs -| name | description | -| --- | --- | -| `compiler` |

compiler.actual value from stack query

| -| `compiler-version` |

The GHC version part of compiler

| -| `snapshot-doc-root` |

snapshot-doc-root value from stack path

| -| `local-doc-root` |

local-doc-root value from stack path

| -| `local-hoogle-root` |

local-hoogle-root value from stack path

| -| `stack-root` |

stack-root value from stack path

| -| `project-root` |

project-root value from stack path

| -| `config-location` |

config-location value from stack path

| -| `bin-path` |

bin-path value from stack path

| -| `programs` |

programs value from stack path

| -| `compiler-exe` |

compiler-exe value from stack path

| -| `compiler-bin` |

compiler-bin value from stack path

| -| `compiler-tools-bin` |

compiler-tools-bin value from stack path

| -| `local-bin` |

local-bin value from stack path

| -| `extra-include-dirs` |

extra-include-dirs value from stack path

| -| `extra-library-dirs` |

extra-library-dirs value from stack path

| -| `snapshot-pkg-db` |

snapshot-pkg-db value from stack path

| -| `local-pkg-db` |

local-pkg-db value from stack path

| -| `global-pkg-db` |

global-pkg-db value from stack path

| -| `ghc-package-path` |

ghc-package-path value from stack path

| +| name | description | +| ----------------------- | ---------------------------------------------------------------------------- | +| `compiler` |

compiler.actual value from stack query

| +| `compiler-version` |

The GHC version part of compiler

| +| `snapshot-doc-root` |

snapshot-doc-root value from stack path

| +| `local-doc-root` |

local-doc-root value from stack path

| +| `local-hoogle-root` |

local-hoogle-root value from stack path

| +| `stack-root` |

stack-root value from stack path

| +| `project-root` |

project-root value from stack path

| +| `config-location` |

config-location value from stack path

| +| `bin-path` |

bin-path value from stack path

| +| `programs` |

programs value from stack path

| +| `compiler-exe` |

compiler-exe value from stack path

| +| `compiler-bin` |

compiler-bin value from stack path

| +| `compiler-tools-bin` |

compiler-tools-bin value from stack path

| +| `local-bin` |

local-bin value from stack path

| +| `extra-include-dirs` |

extra-include-dirs value from stack path

| +| `extra-library-dirs` |

extra-library-dirs value from stack path

| +| `snapshot-pkg-db` |

snapshot-pkg-db value from stack path

| +| `local-pkg-db` |

local-pkg-db value from stack path

| +| `global-pkg-db` |

global-pkg-db value from stack path

| +| `ghc-package-path` |

ghc-package-path value from stack path

| | `snapshot-install-root` |

snapshot-install-root value from stack path

| -| `local-install-root` |

local-install-root value from stack path

| -| `dist-dir` |

dist-dir value from stack path

| -| `local-hpc-root` |

local-hpc-root value from stack path

| +| `local-install-root` |

local-install-root value from stack path

| +| `dist-dir` |

dist-dir value from stack path

| +| `local-hpc-root` |

local-hpc-root value from stack path

| + ## Generating a Build Matrix of `stack.yaml`s diff --git a/package-lock.json b/package-lock.json index 0cf8a6a..01f6b62 100644 --- a/package-lock.json +++ b/package-lock.json @@ -8,6 +8,7 @@ "action-docs": "git+https://github.com/deemp/action-docs.git#0cb0ac2c40736aba24c4fd5097f1074b5a7c7a4b" }, "devDependencies": { + "prettier": "^3.2.4", "typescript": "^5.3.0" } }, @@ -1997,6 +1998,21 @@ "node": ">= 0.8.0" } }, + "node_modules/prettier": { + "version": "3.2.4", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.2.4.tgz", + "integrity": "sha512-FWu1oLHKCrtpO1ypU6J0SbK2d9Ckwysq6bHj/uaCP26DxrPpppCLQRGVuqAxSTvhF00AcvDRyYrLNW7ocBhFFQ==", + "dev": true, + "bin": { + "prettier": "bin/prettier.cjs" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/prettier/prettier?sponsor=1" + } + }, "node_modules/punycode": { "version": "2.3.1", "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", diff --git a/package.json b/package.json index ee77b37..38b87d6 100644 --- a/package.json +++ b/package.json @@ -3,9 +3,10 @@ "action-docs": "git+https://github.com/deemp/action-docs.git#0cb0ac2c40736aba24c4fd5097f1074b5a7c7a4b" }, "devDependencies": { - "typescript": "^5.3.0" + "typescript": "^5.3.0", + "prettier": "^3.2.4" }, "scripts": { - "readme": "npx action-docs -u" + "readme": "npx action-docs -u && prettier --write README.md" } }