Erste Schritte mit fpm

Erste Schritte mit fpm

Dieses Tutorial behandelt die grundlegende Verwendung der Befehlszeile des Fortran-Paketmanagers (fpm). Es behandelt die Erstellung eines neuen Projekts und die Möglichkeit, ein Projekt in eine ausführbare Datei zu kompilieren sowie die Möglichkeit, das resultierende Programm auszuführen.

Um ein neues Projekt mit fpm zu starten, verwende den Befehl fpm new

❯ fpm new first_steps

Standardmäßig erstellt fpm ein Git-Repository mit einem Dummy-Projekt im fpm-Standardlayout

❯ cd first_steps
❯ tree .
.
├── README.md
├── app
│   └── main.f90
├── fpm.toml
├── src
│   └── first_steps.f90
└── test
    └── check.f90

3 directories, 5 files

Das ist alles, was wir brauchen, um unser neues Projekt zu starten. Zuerst inspizieren wir das Paketmanifest fpm.toml, das mit Platzhaltern für uns gefüllt ist:

fpm.toml
name = "first_steps"
version = "0.1.0"
license = "license"
author = "Jane Doe"
maintainer = "jane.doe@example.com"
copyright = "Copyright 2021, Jane Doe"
[build]
auto-executables = true
auto-tests = true
auto-examples = true
[install]
library = false

Das Paketmanifest enthält alle erforderlichen Metadaten für das neue Projekt. Als nächstes überprüfen wir die ausführbare Hauptdatei app/main.f90, die fpm für uns erzeugt hat:

app/main.f90
program main
  use first_steps, only: say_hello
  implicit none

  call say_hello()
end program main

Das Programm verwendet bereits ein Modul aus unserer Bibliothek, das wir unter src/first_steps.f90 finden:

src/first_steps.f90
module first_steps
  implicit none
  private

  public :: say_hello
contains
  subroutine say_hello
    print *, "Hello, first_steps!"
  end subroutine say_hello
end module first_steps

Wir können die ausführbare Datei direkt mit dem Befehl fpm run ausführen:

❯ fpm run
...
 Hello, first_steps!

In ähnlicher Weise hat fpm bereits einen Platzhalter zum Testen erstellt, der mit fpm test aufgerufen werden kann:

❯ fpm test
...
 Put some tests in here!

Fpm verfolgt automatisch die Änderungen in Ihrem Projekt, wenn die Befehle run and test ausführt werden.

Zusammenfassing

In diesem Kurs haben wir gelernt, wie man

  • ein neues Projekt über die fpm-Befehlszeile erstellt

  • Projekt-Programme mit fpm erstellt und ausführt

  • Tests mit fpm startet