From f86ccb21e7a2ba792c837fb9a2b267a9d6335531 Mon Sep 17 00:00:00 2001 From: Egor Tensin Date: Sat, 28 Nov 2020 03:16:05 +0300 Subject: add README --- README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..8ce98b2 --- /dev/null +++ b/README.md @@ -0,0 +1,48 @@ +Set up Cygwin +============= + +[![Test](https://github.com/egor-tensin/setup-cygwin/workflows/Test/badge.svg)](https://github.com/egor-tensin/setup-cygwin/actions?query=workflow%3ATest) + +This is a GitHub action that 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@v1 + with: + platform: x64 + packages: cmake python3 + +`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). + +API +--- + +| Input | Value | Default | Description +| ----------- | ------- | ------- | ----------- +| platform | x64 | Yes | Install the 64-bit version. +| | *Other* | No | Install the 32-bit version. +| install-dir | *Empty* | Yes | Install to C:\tools\cygwin. +| | *Other* | No | Install to the specified directory. +| packages | *Empty* | Yes | Don't install any additional packages. +| | *Other* | No | Space-separated package names. + +The paths to the Cygwin binaries are added to the PATH variable. + +License +------- + +Distributed under the MIT License. +See [LICENSE.txt] for details. + +[LICENSE.txt]: LICENSE.txt -- cgit v1.2.3