Fortran Package Manager

This is the repository of the Fortran Package Manager (fpm). If you are looking for fpm – packaging made simple instead, see jordansissel/fpm.

Fortran Package Manager is an early prototype. You can use it to build and package your Fortran projects, as well as to include supported Fortran dependency projects. As a prototype, changes to fpm’s behavior and inputs may occur as development continues. Please follow the issues to contribute and/or stay up to date with the development. As the prototype matures and we enter production, we will do our best to stay backwards compatible.

To report a bug report or suggest a feature, please read our contributor guidelines.

Getting started

Binary download

x86-64

Note: On Linux and MacOS, you will need to enable executable permission before you can use the binary.

e.g.

$ chmod u+x fpm-v0.1.0-linux-x86_64

Github actions: to setup fpm within Github actions for automated testing, you can use the fortran-lang/setup-fpm action.

For other platforms and architectures have a look at the bootstrapping instructions.

Creating a new project

Creating a new fpm project is as simple as running the command

fpm new project_name

• fpm.toml

  – with your project’s name and some default standard meta-data

• README.md

  – with your project’s name

• .gitignore

• src/project_name.f90

  – with a simple hello world subroutine

• app/main.f90

  (if

  --with-executable

  flag used) – a program that calls the subroutine

• test/main.f90

  (if

  --with-test

  flag used) – an empty test program

Building your Fortran project with fpm

fpm understands the basic commands:

• fpm build

  – build your library, executables and tests

• fpm run

  – run executables

• fpm test

  – run tests

The command

fpm run

fpm test

fpm run specific_executable

-- some arguments

See additional instructions in the Packaging guide or the manifest reference.

Bootstrapping instructions

This guide explains the process of building fpm on a platform for the first time. If your platform and architecture are already supported, download the binary from the release page instead.

Download this repository

$ git clone https://github.com/fortran-lang/fpm
$ cd fpm/

Build a bootstrap version of fpm

You can use the install script to perform the build of the Haskell version of fpm with:

$ ./install.sh

On Linux, the above command installs

fpm

${HOME}/.local/bin/

Now you can build the Fortran fpm version with

$ cd fpm/
$ fpm build

Test that everything is working as expected

$ fpm test

Finally, install the Fortran fpm version with

$ fpm run --runner mv -- ~/.local/bin

Or choose another location if you do not want to overwrite the bootstrapping version. From now on you can rebuild fpm with your Fortran fpm version.