brain-dead simple config-ini parsing
Project Links
Meta
Author: Ronny Pfannschmidt, Holger Krekel
Requires Python: >=3.8
Classifiers
Development Status
- 4 - Beta
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Operating System
- MacOS :: MacOS X
- Microsoft :: Windows
- POSIX
Programming Language
- Python :: 3
- Python :: 3 :: Only
- Python :: 3.8
- Python :: 3.9
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
Topic
- Software Development :: Libraries
- Utilities
iniconfig: brain-dead simple parsing of ini files
iniconfig is a small and simple INI-file parser module having a unique set of features:
maintains order of sections and entries
supports multi-line values with or without line-continuations
supports “#” comments everywhere
raises errors with proper line-numbers
no bells and whistles like automatic substitutions
iniconfig raises an Error if two sections have the same name.
If you encounter issues or have feature wishes please report them to:
Basic Example
If you have an ini file like this:
# content of example.ini
[section1] # comment
name1=value1 # comment
name1b=value1,value2 # comment
[section2]
name2=
line1
line2
then you can do:
>>> import iniconfig
>>> ini = iniconfig.IniConfig("example.ini")
>>> ini['section1']['name1'] # raises KeyError if not exists
'value1'
>>> ini.get('section1', 'name1b', [], lambda x: x.split(","))
['value1', 'value2']
>>> ini.get('section1', 'notexist', [], lambda x: x.split(","))
[]
>>> [x.name for x in list(ini)]
['section1', 'section2']
>>> list(list(ini)[0].items())
[('name1', 'value1'), ('name1b', 'value1,value2')]
>>> 'section1' in ini
True
>>> 'inexistendsection' in ini
False
Mar 19, 2025
2.1.0
Jan 07, 2023
2.0.0
Oct 14, 2020
1.1.1
Oct 14, 2020
1.1.0
Jul 31, 2020
1.0.1
Sep 23, 2016
1.0.0
Oct 14, 2010
0.2.dev0
Oct 12, 2010
0.1
Wheel compatibility matrix
Files in release
No dependencies