Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/szaghi/finer
Fortran INI ParseR and generator
https://github.com/szaghi/finer
configparser configuration-file fortran ini-emitter ini-parser oop
Last synced: 3 days ago
JSON representation
Fortran INI ParseR and generator
- Host: GitHub
- URL: https://github.com/szaghi/finer
- Owner: szaghi
- Created: 2015-03-25T17:45:37.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2023-10-30T15:02:30.000Z (over 1 year ago)
- Last Synced: 2024-07-30T18:27:51.217Z (7 months ago)
- Topics: configparser, configuration-file, fortran, ini-emitter, ini-parser, oop
- Language: Fortran
- Homepage:
- Size: 5.07 MB
- Stars: 36
- Watchers: 6
- Forks: 5
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.bsd-2.md
Awesome Lists containing this project
README
# FiNeR [](https://github.com/szaghi/FiNeR/releases)
[]()
[]()
[]()
[]()
[]()
[](https://github.com/szaghi/FiNeR/actions)
[](https://app.codecov.io/gh/szaghi/FiNeR)
### FiNeR, Fortran INI ParseR and generator for FoRtraners
+ FiNeR is a pure Fortran (KISS) library for IO of INI (config) files for modern (2003+) Fortran projects;
+ FiNeR is Fortran 2003+ standard compliant;
- FiNeR is OOP designed;
- FiNeR is TDD designed;
+ FiNeR is a Free, Open Source Project.
#### Issues
[]()
#### Compiler Support
[]()
[]()
[]()
[]()
[]()
[]()
---
[What is FiNeR?](#what-is-finer?) | [Main features](#main-features) | [Copyrights](#copyrights) | [Documentation](#documentation) | [A Taste of FiNeR](#a-taste-of-finer)
---
## What is FiNeR?
Modern Fortran standards (2003+) have introduced better support for strings manipulations. Exploiting such new Fortran capabilities, FiNeR provides an easy to use module library for input (parsing) and output (generating) [INI](http://en.wikipedia.org/wiki/INI_file) (config) files.
Go to [Top](#top)
## Main features
* [X] User-friendly methods for IO INI files:
* [x] parsing files:
* [x] automatic parsing of all sections (whose number is auto-detected);
* [x] automatic parsing of all options of each section (whose number is auto-detected);
* [x] unlimited polymorphic option-values extraction;
* [x] generating files:
* [x] user-friendly add/remove sections/options;
* [x] unlimited polymorphic option-values setting;
* [x] introspection:
* [x] self-consistency checks;
* [x] pretty-printings;
* [x] loop over options;
* [x] inquiring the presence of sections/options by name;
* [ ] errors trapping mechanism.
Any feature request is welcome.
Go to [Top](#top)
## Copyrights
FiNeR is an open source project, it is distributed under a multi-licensing system:
+ for FOSS projects:
- [GPL v3](http://www.gnu.org/licenses/gpl-3.0.html);
+ for closed source/commercial projects:
- [BSD 2-Clause](http://opensource.org/licenses/BSD-2-Clause);
- [BSD 3-Clause](http://opensource.org/licenses/BSD-3-Clause);
- [MIT](http://opensource.org/licenses/MIT).
Anyone is interest to use, to develop or to contribute to FiNeR is welcome, feel free to select the license that best matches your soul!
More details can be found on [wiki](https://github.com/szaghi/FiNeR/wiki/Copyrights).
Go to [Top](#top)
## Documentation
Besides this README file the FiNeR documentation is contained into its own [wiki](https://github.com/szaghi/FiNeR/wiki). Detailed documentation of the API is contained into the [GitHub Pages](http://szaghi.github.io/FiNeR/index.html) that can also be created locally by means of [ford tool](https://github.com/cmacmackin/ford).
### A Taste of FiNeR
Let us assume our goal is to parse a config file. It is as simple as
```fortran
use finer
...
type(file_ini) :: fini !< INI file handler.
character(len=:), allocatable :: source ! Testing string.
real(R4P), allocatable :: array(:) ! Array option.
integer(I4P) :: error ! Error code.
...
source='[section-1]'//new_line('A')// &
'option-1 = one'//new_line('A')// &
'option-2 = 2.'//new_line('A')// &
' 3.'//new_line('A')// &
'option-3 = bar'//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) then
print*,array
else
! errors occur...
endif
```
And what about the generation of an INI file? It is simple as parsing an old one:
```fortran
use finer
...
type(file_ini) :: fini !< INI file handler.
...
call fini%add(section='sec-foo')
call fini%add(section='sec-foo',option='bar',val=-32.1_R8P)
call fini%add(section='sec-foo',option='baz',val=' hello FiNeR! ')
call fini%add(section='sec-foo',option='array',val=[1,2,3,4])
call fini%add(section='sec-bar')
call fini%add(section='sec-bar',option='bools',val=[.true.,.false.,.false.])
call fini%save(filename='foo.ini')
```
A file named *foo.ini* is created. It contains something like:
```ini
[sec-foo]
bar = -0.321000000000000E+002
baz = hello FiNeR!
array = +1 +2 +3 +4
[sec-bar]
bools = T F F
```
Go to [Top](#top)