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:
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:
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:
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.
Zusammenfassung
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