|
2 | 2 | This actions generates cross-platform executable files from a Go module.
|
3 | 3 |
|
4 | 4 | 
|
| 5 | +> Automatic release management of the [**tree**](https://github.com/thatisuday/tree/releases) CLI tool using **go-build-action** action. |
5 | 6 |
|
6 |
| -# Workflow setup |
| 7 | + |
| 8 | +## Workflow setup |
7 | 9 |
|
8 | 10 | ```yaml
|
9 | 11 | # workflow name
|
@@ -33,17 +35,48 @@ jobs:
|
33 | 35 | dest: 'dist'
|
34 | 36 | ```
|
35 | 37 |
|
36 |
| -### option: **platforms** |
| 38 | +#### ☉ option: **platforms** |
37 | 39 | The `platforms` option specifies comma-separated platform names to create binary-executable files for. To see the list of supported platforms, use `go tool dist list` command.
|
38 | 40 |
|
39 |
| -### option: **package** |
| 41 | +#### ☉ option: **package** |
40 | 42 | If the module (_repository_) itself is a Go package, then `package` option value should be an empty string (''). If the repository contains a package directory, then `package` value should be the directory name.
|
41 | 43 |
|
42 |
| -### option: **compress** |
| 44 | +#### ☉ option: **compress** |
43 | 45 | The `compress` option if set to `'true'` will generate **compressed-tar** archive files for the each platform-build file. The resulting archive file also contains `README.md` and `LICENSE` file if they exist inside the root of the repository. In this mode, the binary executable file name is taken from the `name` option value.
|
44 | 46 |
|
45 |
| -### option: **name** |
| 47 | +#### ☉ option: **name** |
46 | 48 | The `name` option sets a prefix for the build filenames. In compression mode, this prefix is applied to archive files and binary executable filename is set to this value.
|
47 | 49 |
|
48 |
| -### option: **dest** |
49 |
| -The `dest` option sets the output directory for the build files. This should be a relative directory without leading `./`. |
| 50 | +#### ☉ option: **dest** |
| 51 | +The `dest` option sets the output directory for the build files. This should be a relative directory without leading `./`. |
| 52 | + |
| 53 | + |
| 54 | +## Build Artifacts |
| 55 | +This action produces following build-artifacts. |
| 56 | + |
| 57 | +#### In non-compression mode |
| 58 | +``` |
| 59 | +./<dest>/ |
| 60 | + ├── <name>-darwin-amd64 |
| 61 | + ├── <name>-linux-amd64 |
| 62 | + ├── ... |
| 63 | + └── <name>-windows-amd64.exe |
| 64 | +``` |
| 65 | +
|
| 66 | +#### In compression mode |
| 67 | +``` |
| 68 | +./<dest>/ |
| 69 | + ├── <name>-darwin-amd64.tar.gz |
| 70 | + | ├── <name> |
| 71 | + | ├── LICENSE |
| 72 | + | └── README.md |
| 73 | + ├── <name>-linux-amd64.tar.gz |
| 74 | + | ├── <name> |
| 75 | + | ├── LICENSE |
| 76 | + | └── README.md |
| 77 | + ├── ... |
| 78 | + └── <name>-windows-amd64.tar.gz |
| 79 | + ├── <name>.exe |
| 80 | + ├── LICENSE |
| 81 | + └── README.md |
| 82 | +``` |
0 commit comments