Confy

Intention

The idea of that library is to wrap a config type into a "container" that autorefresh for you the content using parameters.

Open to new config sources

The code is ready to add new implementations , i.e , get the config from a WebService or Database. Actual one is for load configuration from json file.

Versions

1.0

The first one, added the Confy.File and Confy.Tests

Installation

The Nuget is available at : Old version at https://www.nuget.org/packages/Confy.File/1.0.0

Example Quick Usage

 var container =
                FileContainerBuilder.BuildContainer<ComplexSampleObject>()
                    .LocatedAt(_path + @"\Config_ComplexSectionConfig.json")
                    .UsingSection("NO-SAMPLE")
                    .UsingRefreshMode()
                    .Automatic()
                    .Each(TimeSpan.FromSeconds(2))
                    .Build();

2.0

Implementation of FileSystemWatcher to reload the configuration. Removed form the fluent api the old reload descriptor methods.

Installation

The Nuget is available at : No version published

Example Quick Usage

 var container =
                FileContainerBuilder.BuildContainer<ComplexSampleObject>()
                    .LocatedAt(_path + @"\Config_ComplexSectionConfig.json")
                    .UsingSection("NO-SAMPLE")
                    .WhenFileChange()
                    .Build();

3.0

1. Added Camaleonic fields, that fields are fields that allow you to copy at json level the value of other tag.
2. Added Inconsitant controls, if configuration cannot be loaded correctly when file changes, you can specify if wants to throw an exception the next time you access to the container.
3. Added New ManualReload method, to give a way for exception control flows.
4. Added Event Handler when the reload is done, the you can pass a method to execute when the reload finish, for example, reinstantiate a class, or send an event to other applications, etc... (No event args on this version). You can pass the function to the fluent API or subscribe to the OnConfigurationReload event available on the Container.

Installation

The Nuget is available at : https://www.nuget.org/packages/Confy.File/3.2.0

Camaleonic example

{
"SAMPLE":{
},
"NO-SAMPLE":{
"ComplexFirstLevelName":"New Complex Name",
"TimeStamp":"10/04/2017 05:20:00",
"SampleSimpleObject":{
"Name":"New Second Level Name",
"Age":"30",
"CamaleonicSample":"<cam>NO-SAMPLE->TimeStamp</cam>"
}
}
}

This will get the value inside the section "No-Sample" and the field "Time Stamp".

If not <cam> tag then no substitution is done.

Example Quick Usage

 var container =
                FileContainerBuilder.BuildContainer<ComplexSampleObject>()
                .LocatedAt(_path + @"\Config_ComplexSectionConfig.json")
                .UsingEntireFile()
                .RefreshingWhenFileChange()
                .ThrowsIfUnableToRefresh(true)
                .WithActionOnChanged(HandlerAction)
                .Build();

Other way to subscribe to the event :

 public ConstructorOpTypeA(IFileContainer<BeatImplementationConfiguration> configContainer)
        {
            _configContainer = configContainer;
            _configContainer.OnConfigurationReload += OnConfigReload;
        }

And you can register the config across all the application on you Autofac register class :

 builder.Register(c => FileContainerBuilder.BuildContainer<Libbeat.NET.Configuration.BeatCoreConfiguration>()
                .LocatedAt(location)
                .UsingEntireFile()
                .RefreshingWhenFileChange()
                .ThrowsIfUnableToRefresh(true)
                .Build()).SingleInstance();