TOML Fortran library#
This project provides a library to work with TOML files and data structures and allows to define data serialization and deserialization in Fortran. The currently supported TOML standard is version 1.0.0. The TOML Fortran project is hosted at GitHub at toml-f/toml-f.
Tutorials
Guides and courses for using TOML with complete and self-contained examples.
Recipes
Examples and recipes for solving common tasks with TOML Fortran.
Reference
Generated documentation of all procedures and derived types available.
Installation
Instructions for installing, updating or compiling TOML Fortran.
Repository
GitHub repository for the development of TOML Fortran.
External
External links to other resources, blogs, etc.
News
05 March - TOML Fortran 0.5.0 released
Support for TOML 1.1.0 is here! With this release TOML Fortran introduces full support for the new TOML release, which adds support for newlines and trailing commas to inline tables, new escape sequences, and extends the datetime format with making seconds optional.
03 December - TOML Fortran 0.4.2 released
Maintenance and bugfix release to address issues found for GFortran on MacOS/ppc32 and Cray compilers. Furthermore, parsing the header of an array of tables with whitespace and the tokenization of multiline strings with escape characters was fixed.
01 April - TOML Fortran 0.4.0 released
This release refactors the internal access of the storage structures to allow more efficient operations like deletion or renaming. Additionally, the serialization functionality has been reworked to allow writing to files, units or strings using similar interfaces.
03 August - Jonquil: Bringing TOML blooms to JSON land
Jonquil started out of the idea to make a TOML parser speak JSON. First explored as a way to connect to the toml-test validation suite, the implementation was brief and expressive enough to be explored as a tutorial. Since the implementation was taken serious enough to enter into JSON Fortran’s benchmarks and turned out to actually be competitive with JSON Fortran, revisiting the idea of a JSON parser in TOML Fortran was warranted.
01 August - TOML Fortran 0.3.0 released
This release comes with a new backend for the deserialization of TOML documents, making the parser more robust against unclosed inline tables and arrays. Furthermore, a context can now be captured which allows reporting messages like errors as annotations in TOML document, making both the default errors produced by the parsers more useful and also enabling users of TOML Fortran to create consistently formatted reports. Together with the refactoring of the internal representation for storing TOML values, the low-level interface to TOML values becomes more consistent and easier to use. A long-standing issue with supporting Unicode escape sequences in strings has been resolved and TOML Fortran now fully supports all TOML 1.0.0 escape sequences.
Users
TOML Fortran is used for example in the Fortran package manager (fpm), a typical package manifest specified in TOML is shown below
name = "toml-f"
version = "0.5.0"
license = "Apache-2.0 OR MIT"
maintainer = ["@awvwgk"]
author = ["Sebastian Ehlert"]
copyright = "2019-2026 Sebastian Ehlert"
homepage = "https://toml-f.readthedocs.org"
keywords = ["toml", "io", "serde"]
description = "TOML parser implementation for data serialization and deserialization"
[library]
source-dir = "src"
[build]
auto-tests = false
[[test]]
name = "tftest"
source-dir = "test/unit"
[test.dependencies]
test-drive.git = "https://github.com/fortran-lang/test-drive.git"
[[executable]]
name = "toml2json"
source-dir = "test/compliance"
main = "toml2json.f90"
[[executable]]
name = "json2toml"
source-dir = "test/compliance"
main = "json2toml.f90"
# FORD documentation settings
[extra.ford]
project = "TOML-Fortran"
summary = "TOML parser implementation for data serialization and deserialization in Fortran."
favicon = "./assets/toml-f-64x64.png"
project_github = "https://github.com/toml-f/toml-f"
project_download = "https://github.com/toml-f/toml-f/releases"
project_website = "https://toml-f.readthedocs.io"
author = "Sebastian Ehlert"
github = "https://github.com/awvwgk"
src_dir = ["./src"]
exclude_dir = ["./test"]
media_dir = "./assets"
docmark = "<"
predocmark = ">"
source = true
graph = true
sort = "alpha"
print_creation_date = true
creation_date = "%Y-%m-%d %H:%M %z"
md_extensions = ["markdown.extensions.toc", "markdown.extensions.smarty"]
externalize = true
[extra.ford.extra_mods]
iso_fortran_env = "https://gcc.gnu.org/onlinedocs/gfortran/ISO_005fFORTRAN_005fENV.html"
A collection of projects using TOML Fortran is shown below:
Fortran package manager and build system.
Light-weight tight-binding framework.
Gaussian Process Regression engine written in Fortran90 designed to produce models for atomistic simulations.
Signed distance fields in Monte Carlo Radiative Transfer for modelling of smooth surfaces without the need to use triangle or similar meshes.
Your project is using TOML Fortran but not listed here? Let us know of your work by opening a discussion on GitHub or create a pull request to add it to the selection above.