FoBiS — Fortran Building System

Automatic dependency-resolving build tool for modern Fortran projects — no makefiles, no boilerplate. Package manger highly integrated with GitHub, install and fetch project dependencies. Add instrospective doctests to your Fortran project and exploit AI-powered programmatic buildings with the provided AI skill.

⚡ Zero-configuration builds _{Drop FoBiS into any Fortran project and run fobis build. It scans sources, resolves all use, include, and module dependencies automatically, and compiles in the correct order — no makefiles, no boilerplate. Convention-based discovery finds src/, source/, and app/ directories automatically. Quick start}	📄 fobos — the FoBiS makefile _{A concise INI-style configuration file replaces makefiles entirely. Define multiple build modes, templates, variables, custom rules, feature flags, multi-target sections, and hooks — all in one readable file. fobos reference}
🌐 GitHub integration _{Declare dependencies in a [dependencies] fobos section — fobis fetch clones, pins to branch/tag/rev/semver, and pre-builds them; fobis build picks them up automatically. Reproducible builds via fobos.lock. Install any GitHub-hosted FoBiS project directly with fobis install user/repo. Fetch deps · Lock file}	🏗️ Named build profiles & feature flags _{One-word compiler flag presets (debug, release, asan, coverage) for every supported compiler. Feature flags let you activate named compile-time options without separate build modes — mix and match freely. Build profiles · Feature flags}
🧪 Integrated test runner & coverage _{fobis test discovers, compiles, and runs all Fortran test programs — no external harness needed. fobis coverage generates HTML/XML reports via gcovr or lcov and can fail CI when coverage drops below a threshold. Test runner · Coverage}	🔬 Introspective doctests _{Embed micro-unit-tests directly inside Fortran comment docstrings. FoBiS generates, compiles, and runs volatile test programs automatically — inspired by Python's doctest module, no test harness needed. Doctests}
⚡ Build cache _{Content-addressed cache keyed on source commit, compiler, and flags — reuses object files across clean builds and branch switches. fobis cache list/clean for housekeeping. Build cache}	🤖 Introspect & Claude Code skill _{fobis introspect --all emits machine-readable JSON of the full project graph — sources, compiler flags, dependencies, targets. Powers the bundled /fobis Claude Code skill for AI-assisted builds right in your editor. introspect · Claude skill}
📋 Scaffold — boilerplate sync _{Keep CI workflows, docs configs, license files, and scripts identical across all your Fortran repos. fobis scaffold status shows drift; fobis scaffold sync fixes it; fobis scaffold init bootstraps new projects. All templates bundled inside FoBiS — no extra dependencies. Scaffold reference}	🧠 LLM commit messages _{Generate well-formed Conventional Commits messages for staged changes via a local LLM. Supports Ollama and any OpenAI-compatible endpoint (LM Studio, vLLM, llama.cpp) — no cloud account, no API key, no data leaving your machine. LLM commit guide}

Full documentation

Why FoBiS?

Modern Fortran's module system is powerful — but tracking inter-module compilation order by hand in a makefile quickly becomes a nightmare as project size grows. Every time you add a module, rename a file, or restructure directories, the makefile needs manual updates.

FoBiS solves this completely. It parses source files on every invocation, rebuilds the dependency graph from scratch, and compiles in the correct order — with no configuration required for simple projects.

# That's it. FoBiS finds all programs, resolves all dependencies, compiles.
fobis build

For complex projects, a single fobos file in the project root replaces makefiles entirely:

[modes]
modes = debug release

[debug]
compiler  = gnu
cflags    = -c -O0 -g -Wall
build_dir = ./build/debug/

[release]
compiler  = gnu
cflags    = -c -O3
build_dir = ./build/release/

fobis build -mode release

zero-configuration build	simplify complex dependency

GH integration, project install	GH integration, dependancies fetch

Scaffold — boilerplate management

fobis scaffold keeps CI workflows, docs configs, license files, and other boilerplate in sync across all your Fortran repos. All templates are bundled inside FoBiS — no external dependencies.

fobis scaffold status          # drift report: OK / OUTDATED / MISSING per file
fobis scaffold sync --dry-run  # preview diffs without writing
fobis scaffold sync --yes      # apply all updates silently
fobis scaffold init            # bootstrap a new project (creates src/, docs/, .github/, …)
fobis scaffold list            # list all managed files and their categories

Project variables ({{NAME}}, {{AUTHORS}}, {{REPOSITORY}}, …) are resolved from the fobos [project] section, the git remote URL, and git config. See the scaffold reference for full details.

LLM-assisted commit messages

fobis commit generates Conventional Commits messages for your staged changes using a local LLM — no cloud account, no API key, no data leaving your machine.

# Stage your changes as usual
git add fobis/Commit.py fobis/cli/commit.py

# Generate the message (print only — you review before committing)
fobis commit

# Generate and commit in one step after interactive review
fobis commit --apply

# Persist your LLM settings
fobis commit --init-config     # creates ~/.config/fobis/config.ini
fobis commit --show-config     # inspect effective settings

Works with Ollama (default) and any OpenAI-compatible server (LM Studio, vLLM, llama.cpp). The default model is qwen3-coder:30b-a3b-q4_K_M — a fast mixture-of-experts model that produces excellent commit messages.

See the LLM commit messages guide for setup instructions, model recommendations, and worked examples.

Showcases

Projects using FoBiS:

ADAM — Accelerated fluid Dynamics on Adaptive Mesh refinement grids | GitHub
BeFoR64 — Base64 encoding/decoding library for Fortran | GitHub
FACE — Fortran ANSI Colors and Escape sequences | GitHub
FiNeR — Fortran INI ParseR and generator | GitHub
FLAP — Fortran command Line Arguments Parser | GitHub
FUNDAL — Fortran UNified Device Acceleration Library | GitHub
FOSSIL — FOrtran Stereo (si) Litography parser | GitHub
MORTIF — MORTon Indexer (Z-order) Fortran environment | GitHub
MOTIOn — Modular (HPC) Optimized Toolkit (for) IO (in fortra)n | GitHub
PENF — Portability Environment for Fortran | GitHub
StringiFor — Strings Fortran Manipulator with steroids | GitHub
VecFor — Vector algebra class for Fortran | GitHub
VTKFortran — pure Fortran VTK (XML) API | GitHub

Author

Stefano Zaghi — stefano.zaghi@gmail.com · GitHub

Copyrights

FoBiS is an open source project distributed under the GPL v3 license. Anyone interested in using, developing, or contributing to FoBiS is welcome — see the contributing guidelines.

Metadata

Release files for FoBiS.py 3.8.25

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for FoBiS.py 3.8.25
File	Size	Uploaded
fobis_py-3.8.25.tar.gz	214.0 kB	Oct 3, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for FoBiS.py 3.8.25
File	Interpreter	ABI	Platform	Reset
fobis_py-3.8.25-py3-none-any.whl 190.2 kB Oct 3, 2026	Python 3	none	any	Details

Total release size: 404.2 kB

Release files / fobis_py-3.8.25.tar.gz

Download URL	fobis_py-3.8.25.tar.gz
Size	214.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`797bdb4ba29436a06fba6628f102875696b78a9c4400126fbaa9042b5d70c548`
BLAKE2b-256 checksum How to use checksums	`733ed42589f2b93b09241e536338bb681908e6e2f41fdb44f1813d198a5febbe`
Upload date	Oct 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/szaghi/FoBiS
Publishing commit: github.com/szaghi/FoBiS/tree/6bb1761a57f5c755869bce7482d718dcd90ddf55

Workflow

Publishing configuration: github.com/szaghi/FoBiS/blob/6bb1761a57f5c755869bce7482d718dcd90ddf55/.github/workflows/python-package.yml
Publishing logs: github.com/szaghi/FoBiS/actions/runs/37101185995/attempts/1

Artifact

Subject: fobis_py-3.8.25.tar.gz
SHA-256 checksum: 797bdb4ba29436a06fba6628f102875696b78a9c4400126fbaa9042b5d70c548 Verifying attestations

Release files / fobis_py-3.8.25-py3-none-any.whl

Download URL	fobis_py-3.8.25-py3-none-any.whl
Size	190.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`12af90b41d1ee9cf27efcddb9c6ac5d4f64c56c79d6dbe5dd1b750ccff5d8763`
BLAKE2b-256 checksum How to use checksums	`fb05383d47e120cd5e1d556e1063d1050109cf0255dc078734f625e815efdc86`
Upload date	Oct 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/szaghi/FoBiS
Publishing commit: github.com/szaghi/FoBiS/tree/6bb1761a57f5c755869bce7482d718dcd90ddf55

Workflow

Publishing configuration: github.com/szaghi/FoBiS/blob/6bb1761a57f5c755869bce7482d718dcd90ddf55/.github/workflows/python-package.yml
Publishing logs: github.com/szaghi/FoBiS/actions/runs/37101185995/attempts/1

Artifact

Subject: fobis_py-3.8.25-py3-none-any.whl
SHA-256 checksum: 12af90b41d1ee9cf27efcddb9c6ac5d4f64c56c79d6dbe5dd1b750ccff5d8763 Verifying attestations