github · ncalteen · Jul 7, 2025 · Jul 7, 2025 · Jul 7, 2025 · Jul 7, 2025
@@ -1,5 +1,16 @@
 # Changelog
 
+## v4
+
+This version adds support for
+[`pre`](https://docs.github.com/en/actions/reference/metadata-syntax-for-github-actions#runspre)
+and
+[`post`](https://docs.github.com/en/actions/reference/metadata-syntax-for-github-actions#runspost)
+scripts for actions. These should follow the same structure as the `run` action
+code (see the
+[`README.md`](https://github.com/github/local-action#action-structure) for more
+details).
+
 ## v3
 
 This version adds **experimental** support for [pnpm](https://pnpm.io/) and

@@ -182,31 +182,35 @@ For additional information about transpiled action code, see
 | `-h`, `--help`    | Display help information    |
 | `-V`, `--version` | Display version information |
 
-### `local-action run <path> <logic entrypoint> <dotenv file>`
-
-| Argument           | Description                                            |
-| ------------------ | ------------------------------------------------------ |
-| `path`             | Path to the local action directory                     |
-|                    | Example: `/path/to/action.yml`                         |
-| `logic entrypoint` | Action logic entrypoint (relative to action directory) |
-|                    | Example: `src/main.ts`                                 |
-| `dotenv file`      | Path to the local `.env` file for action inputs        |
-|                    | Example: `/path/to/.env`                               |
-|                    | See the example [`.env.example`](.env.example)         |
+### `local-action run <path> <logic entrypoint> <dotenv file> [--pre <pre entrypoint>] [--post <post entrypoint>]`
+
+| Argument                   | Description                                                         |
+| -------------------------- | ------------------------------------------------------------------- |
+| `path`                     | Path to the local action directory                                  |
+|                            | Example: `/path/to/action.yml`                                      |
+| `logic entrypoint`         | Action logic entrypoint (relative to action directory)              |
+|                            | Example: `src/main.ts`                                              |
+| `dotenv file`              | Path to the local `.env` file for action inputs                     |
+|                            | Example: `/path/to/.env`                                            |
+|                            | See the example [`.env.example`](.env.example)                      |
+| `--pre <pre entrypoint>`   | (Optional) `pre` command entrypoint (relative to action directory)  |
+|                            | Example: `pre/main.ts`                                              |
+| `--post <post entrypoint>` | (Optional) `post` command entrypoint (relative to action directory) |
+|                            | Example: `post/main.ts`                                             |
 
 Examples:
 
 ```bash
-local-action run /path/to/typescript-action src/main.ts .env
+local-action run /path/to/typescript-action src/main.ts .env --pre pre/main.ts --post post/main.ts
 
 # The `run` action is invoked by default as well
-local-action /path/to/typescript-action src/main.ts .env
+local-action /path/to/typescript-action src/main.ts .env --pre pre/main.ts --post post/main.ts
 ```
 
 #### Output
 
 ```console
-$ local-action run /path/to/typescript-action src/main.ts .env
+$ local-action run /path/to/typescript-action src/main.ts .env --pre pre/main.ts --post post/main.ts
      _        _   _               ____       _
     / \   ___| |_(_) ___  _ __   |  _ \  ___| |__  _   _  __ _  __ _  ___ _ __
    / _ \ / __| __| |/ _ \| '_ \  | | | |/ _ \ '_ \| | | |/ _` |/ _` |/ _ \ '__|

@@ -0,0 +1,3 @@
+const { run } = require('./main')
+
+run()
@@ -0,0 +1,13 @@
+const { getInput, info, setOutput } = require('@actions/core')
+
+async function run() {
+  const myInput = getInput('myInput')
+
+  setOutput('myOutput', myInput)
+
+  info('JavaScript Action Succeeded!')
+}
+
+module.exports = {
+  run
+}
@@ -0,0 +1,3 @@
+const { run } = require('./main')
+
+run()
@@ -0,0 +1,13 @@
+const { getInput, info, setOutput } = require('@actions/core')
+
+async function run() {
+  const myInput = getInput('myInput')
+
+  setOutput('myOutput', myInput)
+
+  info('JavaScript Action Succeeded!')
+}
+
+module.exports = {
+  run
+}
@@ -0,0 +1,3 @@
+const { run } = require('./main')
+
+run()
@@ -0,0 +1,13 @@
+const { getInput, info, setOutput } = require('@actions/core')
+
+async function run() {
+  const myInput = getInput('myInput')
+
+  setOutput('myOutput', myInput)
+
+  info('JavaScript Action Succeeded!')
+}
+
+module.exports = {
+  run
+}
@@ -0,0 +1,3 @@
+const { run } = require('./main')
+
+run()
@@ -0,0 +1,13 @@
+const { getInput, info, setOutput } = require('@actions/core')
+
+async function run() {
+  const myInput = getInput('myInput')
+
+  setOutput('myOutput', myInput)
+
+  info('JavaScript Action Succeeded!')
+}
+
+module.exports = {
+  run
+}
@@ -0,0 +1,7 @@
+import { jest } from '@jest/globals'
+
+export const resolve = jest.fn()
+
+export default {
+  resolve
+}
@@ -0,0 +1,3 @@
+import { run } from './main.js'
+
+run()
@@ -0,0 +1,9 @@
+import { getInput, info, setOutput } from '@actions/core'
+
+export async function run(): Promise<void> {
+  const myInput: string = getInput('myInput')
+
+  setOutput('myOutput', myInput)
+
+  info('TypeScript ESM Action Succeeded!')
+}
@@ -0,0 +1,3 @@
+import { run } from './main.js'
+
+run()
@@ -0,0 +1,9 @@
+import { getInput, info, setOutput } from '@actions/core'
+
+export async function run(): Promise<void> {
+  const myInput: string = getInput('myInput')
+
+  setOutput('myOutput', myInput)
+
+  info('TypeScript ESM Action Succeeded!')
+}
@@ -0,0 +1,3 @@
+import { run } from './main'
+
+run()
@@ -0,0 +1,9 @@
+import { getInput, info, setOutput } from '@actions/core'
+
+export async function run(): Promise<void> {
+  const myInput: string = getInput('myInput')
+
+  setOutput('myOutput', myInput)
+
+  info('TypeScript Action Succeeded!')
+}
@@ -0,0 +1,3 @@
+import { run } from './main'
+
+run()
@@ -0,0 +1,9 @@
+import { getInput, info, setOutput } from '@actions/core'
+
+export async function run(): Promise<void> {
+  const myInput: string = getInput('myInput')
+
+  setOutput('myOutput', myInput)
+
+  info('TypeScript Action Succeeded!')
+}
@@ -0,0 +1,3 @@
+import { run } from './main'
+
+run()
@@ -0,0 +1,9 @@
+import { getInput, info, setOutput } from '@actions/core'
+
+export async function run(): Promise<void> {
+  const myInput: string = getInput('myInput')
+
+  setOutput('myOutput', myInput)
+
+  info('TypeScript Action Succeeded!')
+}
@@ -0,0 +1,3 @@
+import { run } from './main'
+
+run()
@@ -0,0 +1,9 @@
+import { getInput, info, setOutput } from '@actions/core'
+
+export async function run(): Promise<void> {
+  const myInput: string = getInput('myInput')
+
+  setOutput('myOutput', myInput)
+
+  info('TypeScript Action Succeeded!')
+}