blob: dfe4689b8d3294c8262808af363c74460158d86f (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
Set up Cygwin
=============
[](https://github.com/egor-tensin/setup-cygwin/actions/workflows/test.yml)
This GitHub action sets up Cygwin in your workflow run.
1. Installs Cygwin.
2. Installs any additional packages specified.
Use it in your workflow like this:
- name: Set up Cygwin
uses: egor-tensin/setup-cygwin@v3
with:
platform: x64
packages: cmake gcc
# Cygwin executables are added to PATH, so you can call them directly:
- run: |
ls.exe -Al
pwd.exe
# Alternatively, you can set Cygwin's bash as the shell to use:
- run: |
# This is a real bash script!
basic() {
ls -Al
pwd
}
basic
shell: C:\tools\cygwin\bin\bash.exe --login --norc -eo pipefail -o igncr '{0}'
* `x64` is the default value for the `platform` parameter and can be omitted.
Use `x86` if you want to install the 32-bit Cygwin.
* Specify any additional packages to be installed as a space-separated list in
the `packages` parameter.
* Set the installation directory using the `install-dir` parameter
(C:\tools\cygwin is the default).
* The `CYGWIN` environment variable is set to an empty string by default.
Provide a custom value using the `env` parameter.
API
---
| Input | Value | Default | Description
| ----------- | ------- | ------- | -----------
| platform | x64 | ✓ | Install the 64-bit version.
| | *any* | | Install the 32-bit version.
| install-dir | *empty* | ✓ | Install to C:\tools\cygwin.
| | *any* | | Install to the specified directory.
| packages | *empty* | ✓ | Don't install any additional packages.
| | *any* | | Space-separated package names.
| env | *empty* | ✓ | Set `%CYGWIN%` to an empty string.
| | *any* | | Set `%CYGWIN%` to the specified value.
| hardlinks | *any* | ✓ | Don't convert any symlinks.
| | 1 | | Convert symlinks in /usr/bin to hardlinks.
The paths to the Cygwin binaries are added to the PATH variable.
Line terminators
----------------
When using Cygwin's `bash` as the shell to run the step script (or if you see
something like `\r': command not found` in logs), make sure that `igncr` is
present in the SHELLOPTS variable be either:
* passing `-o igncr` to bash.exe,
job:
name: Test job
runs-on: windows-latest
defaults:
run:
shell: C:\tools\cygwin\bin\bash.exe --login -o igncr '{0}'
steps:
- ...
* or setting the SHELLOPTS variable in the `env:` block.
job:
name: Test job
runs-on: windows-latest
env:
SHELLOPTS: igncr
defaults:
run:
shell: C:\tools\cygwin\bin\bash.exe --login '{0}'
steps:
- ...
Please avoid using \r\n as line separators in your shell scripts, as Linux
shells will choke on them.
Executable symlinks
-------------------
Some packages install symlinks in /usr/bin along with real executables.
An example is package "gcc", which (as of November 2021) installs symlink `cc`,
pointing to the real executable `gcc.exe`.
Calling Cygwin symlinks from Windows' command prompt is unsupported, but might
be convenient so there's an option to convert them to hardlinks instead (the
`hardlinks` parameter).
License
-------
Distributed under the MIT License.
See [LICENSE.txt] for details.
[LICENSE.txt]: LICENSE.txt
|
