blob: 64ea97577a015cb9d5b147ef3cf9fdb0cd1e4d5f (
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
|
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 python3
# 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, 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 "python3", which (as of January 2021) installs symlink
`python3`, pointing to the real executable `python3.8.exe`.
Calling Cygwin symlinks from Windows' command prompt is unsupported, but might
be convenient (e.g. if you don't know the exact Python version), 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
|
