Release notes from MicrosoftConfigurationBuilders

v3.0

2023-04-12T02:58:23Z

⚠️ Breaking Change - Expand mode is gone. It has been replaced by Token mode.
Utils.MapPath - This was somewhat broken in ASP.Net scenarios previously. It should now reliably go against Server.MapPath() in ASP.Net scenarios. It has also been updated to fall back against the directory of the config file being processed when resolving the app root in the case of a Configuration object being created by ConfigurationManager.OpenConfiguration* API's rather than being part of a fully-initialized runtime configuration stack.
Json use has migrated to use System.Text.Json instead of Newtonsoft.Json.
The Azure Config Builders have been updated to require a newer minimum version of Azure.Identity by default which allows for more methods of connecting to Azure, such as User-Assigned Managed Identity, or Client Certificate-based via environment variables. Also a pair of overloads (GetCredential and GetSecretClientOptions/GetConfigurationClientOptions) have been added for users who need something more than DefaultAzureCredential with default client options can provide.
Added RecursionGuard to help detect and prevent situations where a ConfigurationBuilder accessing values from a ConfigurationSection other than the one which it is currently processing could result in stack overflow.
optional attribute is obsolete => enabled attribute which provides more versatility. (The optional attribute is still parsed and recognized in the absence of the newer enabled attribute, but builders should migrate to use the new attribute name when possible. Installation scripts should try to handle this automatically.)
Character Mapping - Some config builders have had an internal mapping of characters that might exist in keys in the config file but are illegal in keys at the source. As more scenarios come to light and individual prefrences are not always unanimous, V3 instead adds the charMap attribute to allow this character mapping to work with all KeyValueConfigBuilders and to be handled in an easily configurable manner.
ConnectionStringsSectionHandler2 - A new section handler for the <connectionStrings> section has been included in the base package. This new handler will allow updating of both the 'connectionString' attribute as well as the 'providerName' attribute. It does require the builders and source of config data to be aware of this new ability though. The default section handler for the <connectionStrings> section has not been updated and remains as it was in previous versions, so apps wishing to take advantage of the new handler will have to wire it up in their config. More details can be found in the SectionHandlers documentation.
AzureAppConfiguration nuget package version is revved to match the rest of this suite of builders, rather than being 1 major version behind. (ie, AzureAppConfiguration:3.0 now depends on Base:3.0 rather than AzureAppConfiguration:1.0 depending on Base:2.0)

v2.0

2020-02-22T00:41:52Z

Azure App Configuration Support - There is a new builder for drawing values from the new Azure App Configuration service.
ConfigBuilder Parameters from AppSettings - This has been one of the most asked for features of these config builders. With V2, it is now possible to
read initialization parameters for config builders from appSettings. Read more about it here.
Lazy Initialization - As part of the work to enable pulling config parameters from appSettings, these key/value configuration builders now support a
lazy initialization model. Things that must happen immediately can be left in the existing Initialize(name, config) method, or builders can leverage
the LazyInitialize(name, config) method for things that can happen just before retrieving values. All builders in this project have been updated to
be lazy whenever possible.
Updateable Keys - Builders can now massage key names before inserting into config. The AzureKeyVaultConfigBuilder has been
updated to use this feature to allow embedding 'version' tags in key names instead of applying a single 'version' tag to the builder. (Note: This is
seperate from, and performed after prefix stripping.)
Base Optional Tag - The optional tag that some of the builders in this project employed in V1 has been moved into the base class and is now available
on all key/value config builders.
Section Handlers - This feature allows users to develop extensions that will apply key/value config to sections other than appSettings and connectionStrings
if desired. Read more about this feature in the Section Handlers segment below.

v1.0.2

2018-07-06T22:28:56Z

Introduce KeyPerFile builder which can be used with various container-orchestrators.
Fix dependency/assembly version handling.
Revamp package install/uninstall(/upgrade) to stash and restore builder declarations in an effort to not lose developer-configured config builder settings when upgrading packages.

v1.0.1

2018-05-30T19:20:11Z

Fix solution items to enable proper assembly signing in the build system.

v1.0

2018-05-30T19:19:24Z

Initial release.