FoBiSThe Fortran Building System

Builds modern Fortran projects with no makefile, by reading the sources. Then tests them, checks their numerical results, lints and reviews them, and gives an AI assistant the facts to work on them, with every claim checked.

Tutorials

Install

Cookbook

Reference

View on GitHub

⚡

Builds with no makefile

FoBiS parses every source for modules, uses and includes, and compiles in dependency order, incrementally, in parallel, C files included. fobis new starts a project; a fobos file names the modes (debug, release, a library); editors get a compile_commands.json.

A first build

📦

Dependencies from GitHub

Declare FoBiS projects in [dependencies]; fobis fetch clones them at a tag, branch, commit or semver range and locks the commits. Build them with your sources, or as libraries with their own fobos; use a local directory as is, or a dependency for the tests only.

Dependencies

🧪

Tests, doctests, coverage

Every program in test/ is a test, run in parallel or through mpirun; checks in the documentation comments are doctests; an instrumented mode and fobis coverage give the report, and a threshold for CI.

Tests

🎯

Verified numerical results

Declare cases and the quantities they print; compare them with references within tolerances, across compilers and checked builds, against the previous revision, with confidence intervals on timings and estimates of rounding and discretisation error.

Verification

🩺

A linter that sees the build

Bug-prone, obsolescent and non-portable constructs, OpenMP data races, OpenACC and MPI defects, analysed with the defines of the mode you build. Baselines, inline suppressions with reasons, automatic fixes, SARIF, reviews of the lines a change touches.

Linting

🤖

AI assistance on facts

Explanations of failed builds and crashes, answers cited from the standards and your sources, tests kept only when they build, run and check. Local open models; an MCP server gives any agent the same tools.

Analysis and AI

🧭

Many repositories as one

A dashboard of releases due, CI, drift and stale pins across your projects; commands in dependency order; a check of everything downstream before you release; the release train.

Ecosystem

🖥️

From a laptop to a cluster

The same cases, tests and benchmarks submitted through Slurm, with the node's facts in the provenance; profiles from gprof, callgrind and Nsight Systems mapped to your procedures. One offline file for air-gapped machines.

Clusters

Quick start

bash

pip install FoBiS.py
cd my-fortran-project
fobis build

FoBiS finds the sources (in src/, source/, app/, or the current directory), resolves the modules every file uses, compiles them in order and links every program it found. The first tutorial starts here; the tutorials go on, track by track, to verified results, code review and AI assistance.