Striking

Striking is a small C# library for handling INI files. It's easy to extend and contains various features to ease the development process.

If you run into performance issues you can use Striking as a base to taylor your own problem-specific solution.

Usage

The following examples work if you use the file testdata.ini from the test library.

To load an ini file and access certain keys you would do this:

IniParser parser = new IniParser("testdata.ini");
parser.Parse();
string name = parser["owner"]["name"];

You can also tell the constructor to immediately parse the specified file like this:

IniParser parser = new IniParser("testdata.ini", true);

The first indexer specifies the section, the while the second specified the key:

string name = parser["owner"]["name"];

Autofill

It's also possible to define attributes for your properties, to let the parser automatically fill in the data you want. There is a single attribute with a different number of arguments. If you only specify a key, the parser will take the value of first occurance of said key:

[Ini("name")]
public string Name { get; set; }

To make this more precise and less prone to errors you can also specify a section:

[Ini("owner", "name")]
public string OwnerName { get; set; }

Now you simply pass this object as an argument the IniParser#Fill method like follows and you're done!

parser.Fill(myObject);

Saving

It's also possible to persist the loaded data back to the file system. You can do this using the IniParser#Save method. This method optionally accepts an indefinite ammount of objects, containing properties filled with data from ini files. This works like a queue, overwriting previous values. If you have two objects both using the "name" key of the "owner" section, the latter objects value will be written to the file.

Values from such objects overwrite data the parser tracks in any case.

parser.Save(myObject);

Install

Requirements

It doesn't use any OS API calls so it should run on any platform.

.NET Framework 4 or higher (has only been tested on this version)

License

Striking is released under the MIT license. See LICENSE for details.

schwarz / striking