mirror of https://github.com/actions/toolkit
a26c57109e | ||
---|---|---|
.github | ||
packages | ||
.gitignore | ||
.prettierrc.json | ||
LICENSE.md | ||
README.md | ||
jest.config.js | ||
lerna.json | ||
package-lock.json | ||
package.json | ||
tsconfig.json |
README.md
Actions Toolkit 🛠
Packages
Package | Description |
---|---|
@actions/exit | Provides utilities for exiting from an action |
@actions/toolkit | A general-purpose toolkit for writing actions |
Development
This repository uses Lerna to manage multiple packages. Read the documentation there to begin contributing.
Useful Scripts
npm run bootstrap
This runslerna bootstrap
which will install dependencies in this repository's packages and cross-link packages where necessary.npm run build
This compiles TypeScript code in each package (this is especially important if one package relies on changes in another when you're running tests). This is just an alias forlerna run tsc
.npm run format
This checks that formatting has been applied with Prettier.npm test
This runs all Jest tests in all packages in this repository.- If you need to run tests for only one package, you can pass normal Jest CLI options:
$ npm test -- packages/toolkit
- If you need to run tests for only one package, you can pass normal Jest CLI options:
Creating a Package
- In a new branch, create a new Lerna package:
$ lerna create @actions/new-package
This will ask you some questions about the new package. Start with 0.0.0
as the first version (look generally at some of the other packages for how the package.json is structured).
- Add a
tsconfig.json
file for the new package (you can probably just reuse one from another existing package):
$ cp packages/toolkit/tsconfig.json packages/new-package/tsconfig.json
- Add
tsc
script to the new package's package.json file:
"scripts": {
"tsc": "tsc"
}
- Start developing 😄