action-zip/README.md

64 lines
1.3 KiB
Markdown
Raw Normal View History

2020-03-20 14:31:44 -07:00
# action-zip
2020-03-21 07:02:44 -07:00
> Action for zipping files easily
## Usage
The only requirement is to use the official `actions/checkout@v2` first so the zip action has access to the repo files.
```yaml
name: Zip Files
on:
release:
types: [published]
jobs:
zip-files:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: papeloto/action-zip@v1
with:
files: dist/ manifest.json
dest: result.zip
```
In this example, after a release is published, a new file named `result.zip` will be created with both the file `manifest.json` and the folder `dist` (files included).
## Inputs
#### `files`
Files or directories to zip.
- **Required:** Yes
#### `dest`
Name of the output zip file.
- **Required:** No
- **Default:** result.zip
#### `recursive`
Whether to add subdirectories to simply zip all files to the root.
- **Required:** No
- **Default:** true
2020-03-21 08:11:51 -07:00
If for example, you do the following:
```yaml
- uses: papeloto/action-zip@v1
with:
files: dist/ manifest.json
recursive: false
dest: result.zip
```
All the files inside the `dist` folder will be added at the root of the zip along with `manifest.json`. By contrast, if `recursive: true` (by default), the folder `dist` is included.
Also if you want a nested file at the root, `recursive: false` is your guy.