Setup Fortran

Action to setup a Fortran compiler.

• Usage
• Options
• Outputs
• Environment variables
• Runner compatibility
• License

Usage

This action sets up a Fortran compiler on Ubuntu, MacOS and Windows runners.

jobs:
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, macos-latest, windows-latest]
        toolchain:
          - {compiler: gcc, version: 11}
          - {compiler: intel-classic, version: '2021.10'}
        include:
          - os: ubuntu-latest
            toolchain: {compiler: intel, version: '2023.2'}
        exclude:
          - os: windows-latest
            toolchain: {compiler: intel-classic, version: '2021.10'}

    steps:
      - uses: awvwgk/setup-fortran@v1
        id: setup-fortran
        with:
          compiler: ${{ matrix.toolchain.compiler }}
          version: ${{ matrix.toolchain.version }}

      - run: ${{ env.FC }} --version
        env:
          FC: ${{ steps.setup-fortran.outputs.fc }}

Options

• compiler: Compiler toolchain to setup, available options are
  • gcc (for gfortran)
  • intel (for ifx)
  • intel-classic (for ifort)
• version: Version of the compiler toolchain. See runner compatibility chart below.

Outputs

The action sets the following outputs:

• cc: C compiler executable, e.g. gcc
• fc: Fortran compiler executable, e.g. gfortran

Environment variables

The same values are also set as environment variables:

• CC
• FC

These are made available to subsequent workflow steps via the GITHUB_ENV environment file mechanism.

Runner compatibility

Support for the GCC toolchain varies across GitHub-hosted runner images.

runner	6	7	8	9	10	11	12	13
macos-11	✓	✓	✓	✓	✓	✓	✓	✓
macos-12	✓	✓	✓	✓	✓	✓	✓	✓
macos-13		✓	✓	✓	✓	✓	✓	✓
ubuntu-20.04		✓	✓	✓	✓	✓		✓
ubuntu-22.04				✓	✓	✓	✓	✓
windows-2019			✓	✓	✓	✓	✓
windows-2022			✓	✓	✓	✓	✓

Note: version 13 of the GNU toolchain is not yet available on Windows.

Note: on macos-13, gcc 7-9 require flag -L/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/lib.

Supported Intel toolchains:

runner	compiler	version
ubuntu-*	intel	2023.2, 2023.1, 2023.0, 2022.2.1, 2022.2, 2022.1, 2022.0, 2021.4, 2021.2, 2021.1.2, 2021.1
ubuntu-*	intel-classic	2021.10, 2021.9, 2021.8, 2021.7.1, 2021.7, 2021.6, 2021.5, 2021.4, 2021.3, 2021.2, 2021.1.2, 2021.1
macos-*	intel-classic	2021.10, 2021.9, 2021.8, 2021.7.1, 2021.7, 2021.6, 2021.5, 2021.4, 2021.3, 2021.2, 2021.1
windows-*	intel	2023.2, 2023.1, 2023.0, 2022.2.0, 2022.1.0
windows-*	intel-classic	2021.10.0, 2021.9.0, 2021.8.0, 2021.7.0, 2021.6.0

Note: on macOS ifx is not supported, so the intel option redirects to intel-classic (ifort).

License

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “as is” basis, without warranties or conditions of any kind, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.