Gini

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 8)

INI File Format Parser

Gini Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Gini

Gini is an [INI file format][1] parser written in C#. It is a distributed as a
[NuGet package][2].

## Usage

The most basic method in Gini is called `Parse` that parses the INI file
format and yields [groups][3] of [key-value pairs][4]. So sections in an INI
file format become groups where the group key is the section name and the
entries of the section become key-value pairs of the group.

The following code C# example:

```c#
const string ini = @"
    ; last modified 1 April 2001 by John Doe
    [owner]
    name=John Doe
    organization=Acme Widgets Inc.

[database]
    ; use IP address in case network name resolution is not working
    server=192.0.2.62
    port=143
    file=payroll.dat";

foreach (var g in Ini.Parse(ini))
{
    Console.WriteLine("[{0}]", g.Key);
    foreach (var e in g)
        Console.WriteLine("{0}={1}", e.Key, e.Value);
}
```

produces the output:

[owner]
    name=John Doe
    organization=Acme Widgets Inc.
    [database]
    server=192.0.2.62
    port=143
    file=payroll.dat

The `ParseHash` method parses the INI file format and return a dictionary of
sections where each section is itself a dictionary of entries:

```c#
const string ini = @"
    ; last modified 1 April 2001 by John Doe
    [owner]
    name=John Doe
    organization=Acme Widgets Inc.

[database]
    ; use IP address in case network name resolution is not working
    server=192.0.2.62
    port=143
    file=payroll.dat";

The output produced by the preceding code is:

Owner Name = John Doe
    Owner Organization = Acme Widgets Inc.
    Database Server = 192.0.2.62
    Database Port = 143
    Database File = payroll.dat

The `ParseHashFlat` method is like `ParseFlat` except it returns a single
dictionary of entries. The section names are merged with the key names via a
mapper function to generate unique entires:

```c#
const string ini = @"
    ; last modified 1 April 2001 by John Doe
    [owner]
    name=John Doe
    organization=Acme Widgets Inc.

[database]
    ; use IP address in case network name resolution is not working
    server=192.0.2.62
    port=143
    file=payroll.dat";

foreach (var e in Ini.ParseFlatHash(ini, (s, k) => s + "." + k))
    Console.WriteLine("{0} = {1}", e.Key, e.Value);
```

The output is as follows:

owner.name = John Doe
    owner.organization = Acme Widgets Inc.
    database.server = 192.0.2.62
    database.port = 143
    database.file = payroll.dat

Gini can also parse the INI file format into a dynamic object via the
`ParseObject`:

```c#
    const string ini = @"
        ; last modified 1 April 2001 by John Doe
        [owner]
        name=John Doe
        organization=Acme Widgets Inc.

[database]
        ; use IP address in case network name resolution is not working
        server=192.0.2.62
        port=143
        file=payroll.dat";

The output is:

Owner Name = John Doe
    Owner Organization = Acme Widgets Inc.
    Database Server = 192.0.2.62
    Database Port = 143
    Database File = payroll.dat

Note that the lookup of properties on the dynamic object is case-insensitive.

Like there is `ParseFlatHash` for `ParseFlat`, there is `ParseFlatObject` for
`ParseObject` that returns a single object of entries with a mapper function
determinig how to merge section and key names:

```c#
const string ini = @"
    ; last modified 1 April 2001 by John Doe
    [owner]
    name=John Doe
    organization=Acme Widgets Inc.

[database]
    ; use IP address in case network name resolution is not working
    server=192.0.2.62
    port=143
    file=payroll.dat";

The output is again:

Owner Name = John Doe
    Owner Organization = Acme Widgets Inc.
    Database Server = 192.0.2.62
    Database Port = 143
    Database File = payroll.dat

Syntax errors in the INI file format are silently ignored. Only bits that can
be successfully parsed are returned or processed.

[1]: http://en.wikipedia.org/wiki/INI_file
  [2]: http://www.nuget.org/packages/Gini/
  [3]: http://msdn.microsoft.com/en-us/library/vstudio/bb344977.aspx
  [4]: http://msdn.microsoft.com/en-us/library/5tbh8a42.aspx

Gini

Gini Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Gini

Gini Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README