Primeros pasos con fpm

Primeros pasos con fpm

Este tutorial cubre el uso básico de la línea de comandos de Administrador de paquetes de Fortran (fpm). Cubrirá la construcción de un nuevo proyecto y la posibilidad de compilar un proyecto en un ejecutable, así como el posibilidad de ejecutar el programa resultante.

Para iniciar un nuevo proyecto con fpm use el comando fpm new

❯ fpm new first_steps

De forma predeterminada, fpm crea un repositorio git con un proyecto ficticio en la configuración usual de fpm.

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

3 directories, 5 files

Esto es todo lo que necesitamos para comenzar nuestro nuevo proyecto. Primero, inspeccionamos el manifiesto del paquete, fpm.toml, que se completa con entradas de código auxiliar para nosotros:

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

El manifiesto del paquete contiene todos los metadatos necesarios para el nuevo proyecto. A continuación, verificamos el ejecutable principal app/main.f90 que fpm ha generado para nosotros:

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

  call say_hello()
end program main

El programa ya usa un módulo desde nuestra biblioteca, que podemos encontrar en src/first_steps.f90:

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

Podemos usar directamente el ejecutable con el comando fpm run:

❯ fpm run
...
 Hello, first_steps!

Del mismo modo, fpm ya ha creado un código auxiliar para realizar pruebas, que puede ser usado con fpm test:

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

Fpm rastreará automáticamente los cambios en su proyecto cuando ejecute este usando los comandos run y test.

Resumen

En este tutorial aprenderas cómo

  • crear un nuevo proyecto desde la línea de comando de fpm

  • construir y usar los ejecutables de su proyecto con fpm

  • ejecutar pruebas con fpm