/usr/share/doc/ruby-iniparse/README.rdoc is in ruby-iniparse 1.4.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 | = IniParse {<img src="https://secure.travis-ci.org/antw/iniparse.png" alt="Build Status" />}[http://travis-ci.org/antw/iniparse]
IniParse is a pure Ruby library for parsing
INI[http://en.wikipedia.org/wiki/INI_file] configuration and data
files.
=== Main features
* <b>Support for duplicate options.</b> While not common, some INI files
contain an option more than once. IniParse does not overwrite previous
options, but allows you to access all of the duplicate values.
* <b>Preservation of white space and blank lines.</b> When writing back to
your INI file, line indents, white space and comments (and their indents)
are preserved. Only trailing white space (which has no significance in INI
files) will be removed.
* <b>Preservation of section and option ordering.</b> Sections and options
are kept in the same order they are in the original document ensuring that
nothing gets mangled when writing back to the file.
If you don't need the above mentioned features, you may find the simpler
IniFile gem does all you need.
=== Opening an INI file
Parsing an INI file is fairly simple:
IniParse.parse( File.read('path/to/my/file.ini') ) # => IniParse::Document
IniParse.parse returns an IniParse::Document instance which represents the
passed "INI string". Assuming you know the structure of the document, you can
access the sections in the INI document with IniParse::Document#[]. For
example:
document = IniParse.parse( File.read('path/to/my/file.ini') )
document['a_section']
# => IniParse::Lines::Section
document['a_section']['an_option']
# => "a value"
document['a_section']['another_option']
# => "another value"
In the event that duplicate options were found, an array of the values will
be supplied to you.
document = IniParse.parse <<-EOS
[my_section]
key = value
key = another value
key = a third value
EOS
document['my_section']['key']
# => ['value', 'another value', 'third value']
Options which appear before the first section will be added to a section called
"__anonymous__".
document = IniParse.parse <<-EOS
driver = true
[driver]
key = value
EOS
document['__anonymous__']['driver']
# => true
document['driver']['key']
# => 'value'
=== Updating an INI file
document['a_section']['an_option']
# => "a value"
document['a_section']['an_option'] = 'a new value'
document['a_section']['an_option']
# => "a new value"
Delete entire sections by calling `#delete` with the section name...
document.delete('a_section')
... or a single option with `#delete` on the section object:
document['a_section'].delete('an_option')
=== Creating a new INI file
See IniParse::Generator.
|