FiNeRFortran INI ParseR

A pure Fortran 2003+ OOP library for reading and writing INI configuration files.

Guide

API Reference

View on GitHub

📄

INI Parsing

Load INI files from disk or from an in-memory string. Sections and options are auto-detected — no schema required.

✏️

INI Generation

Build INI files programmatically with add/del methods. Save to disk or print to any Fortran unit.

🔍

Introspection

Query the presence of sections and options by name, loop over all options, count multi-value entries, and get section/option indices.

🛠️

Multi Build System

Build with CMake (preferred) or FoBiS.py. Integrate into your CMake project via add_subdirectory and target_link_libraries.

🧪

OOP / TDD Designed

A single file_ini type exposes all functionality as type-bound procedures. Designed with a test-driven approach — each feature is covered by automated tests.

🆓

Free & Open Source

Multi-licensed — GPLv3 for FOSS projects, BSD 2/3-Clause or MIT for commercial use. Fortran 2003+ standard compliant.

Quick start

Parse an INI source string and retrieve a multi-value option:

fortran

use finer
use penf, only: R4P, I4P
type(file_ini)                :: fini
character(len=:), allocatable :: source
real(R4P), allocatable        :: array(:)
integer(I4P)                  :: error

source = '[section-1]'//new_line('A')// &
         'option-1 = one'//new_line('A')// &
         'option-2 = 2.'//new_line('A')// &
         '           3.'//new_line('A')// &
         '[section-2]'//new_line('A')// &
         'option-1 = foo'

call fini%load(source=source)
allocate(array(1:fini%count_values(section='section-1', option='option-2')))
call fini%get(section='section-1', option='option-2', val=array, error=error)
if (error == 0) print *, array   ! 2.0  3.0

Authors

Stefano Zaghi — @szaghi

Contributions are welcome — see the Contributing page.

Copyrights

FiNeR is distributed under a multi-licensing system:

Use case	License
FOSS projects	GPL v3
Closed source / commercial	BSD 2-Clause
Closed source / commercial	BSD 3-Clause
Closed source / commercial	MIT

Anyone interested in using, developing, or contributing to FiNeR is welcome — pick the license that best fits your needs.