From b28851bfb1ce04c195cdcbe0780b04781efb1e5e Mon Sep 17 00:00:00 2001
From: Gowon Patterson <gowon.ocp@gmail.com>
Date: Mon, 9 Mar 2020 23:58:19 -0400
Subject: [PATCH] Added Xml docs. Removing pre-release tag.

---
 README.md                                     |  1 +
 .../KeyType.cs                                | 10 +++
 .../SecureStore.Contrib.Configuration.csproj  |  2 +-
 .../SecureStoreConfigurationExtensions.cs     | 73 ++++++++++++++++---
 .../SecureStoreConfigurationProvider.cs       | 11 +++
 .../SecureStoreConfigurationSource.cs         | 17 ++++-
 6 files changed, 101 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 9bbe8f2..03546fe 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,7 @@
 # SecureStore.Contrib.Configuration
 
 [![Nuget (with prereleases)](https://img.shields.io/nuget/vpre/SecureStore.Contrib.Configuration?color=blue)](https://www.nuget.org/packages/SecureStore.Contrib.Configuration)
+[![Nuget](https://img.shields.io/nuget/dt/SecureStore.Contrib.Configuration?color=blue)](https://www.nuget.org/packages/SecureStore.Contrib.Configuration)
 ![build](https://github.com/gowon/SecureStore.Contrib.Configuration/workflows/build/badge.svg)
 [![codecov](https://codecov.io/gh/gowon/SecureStore.Contrib.Configuration/branch/master/graph/badge.svg)](https://codecov.io/gh/gowon/SecureStore.Contrib.Configuration)
 
diff --git a/src/SecureStore.Contrib.Configuration/KeyType.cs b/src/SecureStore.Contrib.Configuration/KeyType.cs
index 81d6ddc..10f38da 100644
--- a/src/SecureStore.Contrib.Configuration/KeyType.cs
+++ b/src/SecureStore.Contrib.Configuration/KeyType.cs
@@ -1,8 +1,18 @@
 namespace SecureStore.Contrib.Configuration
 {
+    /// <summary>
+    /// SecureStore key types.
+    /// </summary>
     public enum KeyType
     {
+        /// <summary>
+        /// File key.
+        /// </summary>
         File,
+
+        /// <summary>
+        /// Password key.
+        /// </summary>
         Password
     }
 }
\ No newline at end of file
diff --git a/src/SecureStore.Contrib.Configuration/SecureStore.Contrib.Configuration.csproj b/src/SecureStore.Contrib.Configuration/SecureStore.Contrib.Configuration.csproj
index b5f9ba0..1be8c28 100644
--- a/src/SecureStore.Contrib.Configuration/SecureStore.Contrib.Configuration.csproj
+++ b/src/SecureStore.Contrib.Configuration/SecureStore.Contrib.Configuration.csproj
@@ -4,7 +4,7 @@
     <TargetFramework>netstandard2.0</TargetFramework>
     <LangVersion>latest</LangVersion>
     <NoWarn>$(NoWarn);1591</NoWarn>
-    <Version>1.0.0-alpha</Version>
+    <Version>1.0.0</Version>
     <Authors>Gowon Patterson</Authors>
     <Description>A SecureStore configuration provider to use with Microsoft.Extensions.Configuration.</Description>
     <Copyright>© Gowon Patterson. All rights reserved.</Copyright>
diff --git a/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationExtensions.cs b/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationExtensions.cs
index f18c2be..8048650 100644
--- a/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationExtensions.cs
+++ b/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationExtensions.cs
@@ -5,20 +5,53 @@
     using Microsoft.Extensions.Configuration;
     using Microsoft.Extensions.FileProviders;
 
+    /// <summary>
+    /// Extension methods for adding <see cref="SecureStoreConfigurationProvider"/>.
+    /// </summary>
     public static class SecureStoreConfigurationExtensions
     {
+        /// <summary>
+        /// Adds the SecureStore configuration provider at <paramref name="path"/> to <paramref name="builder"/>.
+        /// </summary>
+        /// <param name="builder">The <see cref="IConfigurationBuilder"/> to add to.</param>
+        /// <param name="path">Path relative to the base path stored in 
+        /// <see cref="IConfigurationBuilder.Properties"/> of <paramref name="builder"/>.</param>
+        /// <param name="key">The SecureStore key.</param>
+        /// <param name="keyType">The key type.</param>
+        /// <returns>The <see cref="IConfigurationBuilder"/>.</returns>
         public static IConfigurationBuilder AddSecureStoreFile(this IConfigurationBuilder builder, string path,
             string key, KeyType keyType)
         {
             return AddSecureStoreFile(builder, path, key, keyType, false);
         }
 
+        /// <summary>
+        /// Adds the SecureStore configuration provider at <paramref name="path"/> to <paramref name="builder"/>.
+        /// </summary>
+        /// <param name="builder">The <see cref="IConfigurationBuilder"/> to add to.</param>
+        /// <param name="path">Path relative to the base path stored in 
+        /// <see cref="IConfigurationBuilder.Properties"/> of <paramref name="builder"/>.</param>
+        /// <param name="key">The SecureStore key.</param>
+        /// <param name="keyType">The key type.</param>
+        /// <param name="optional">Whether the file is optional.</param>
+        /// <returns>The <see cref="IConfigurationBuilder"/>.</returns>
         public static IConfigurationBuilder AddSecureStoreFile(this IConfigurationBuilder builder, string path,
             string key, KeyType keyType, bool optional)
         {
             return AddSecureStoreFile(builder, path, key, keyType, optional, false);
         }
 
+        /// <summary>
+        /// Adds the SecureStore configuration provider at <paramref name="path"/> to <paramref name="builder"/>.
+        /// </summary>
+        /// <param name="builder">The <see cref="IConfigurationBuilder"/> to add to.</param>
+        /// <param name="path">Path relative to the base path stored in 
+        /// <see cref="IConfigurationBuilder.Properties"/> of <paramref name="builder"/>.</param>
+        /// <param name="key">The SecureStore key.</param>
+        /// <param name="keyType">The key type.</param>
+        /// <param name="optional">Whether the file is optional.</param>
+        /// <param name="reloadOnChange">Whether the configuration should be reloaded if the file changes.</param>
+        /// <returns>The <see cref="IConfigurationBuilder"/>.</returns>
         public static IConfigurationBuilder AddSecureStoreFile(this IConfigurationBuilder builder, string path,
             string key, KeyType keyType, bool optional,
             bool reloadOnChange)
@@ -26,6 +59,18 @@ public static IConfigurationBuilder AddSecureStoreFile(this IConfigurationBuilde
             return AddSecureStoreFile(builder, null, path, key, keyType, optional, reloadOnChange);
         }
 
+        /// <summary>
+        /// Adds a SecureStore configuration source to <paramref name="builder"/>.
+        /// </summary>
+        /// <param name="builder">The <see cref="IConfigurationBuilder"/> to add to.</param>
+        /// <param name="provider">The <see cref="IFileProvider"/> to use to access the file.</param>
+        /// <param name="path">Path relative to the base path stored in 
+        /// <see cref="IConfigurationBuilder.Properties"/> of <paramref name="builder"/>.</param>
+        /// <param name="key">The SecureStore key.</param>
+        /// <param name="keyType">The key type.</param>
+        /// <param name="optional">Whether the file is optional.</param>
+        /// <param name="reloadOnChange">Whether the configuration should be reloaded if the file changes.</param>
+        /// <returns>The <see cref="IConfigurationBuilder"/>.</returns>
         public static IConfigurationBuilder AddSecureStoreFile(this IConfigurationBuilder builder,
             IFileProvider provider,
             string path, string key, KeyType keyType, bool optional, bool reloadOnChange)
@@ -51,18 +96,24 @@ public static IConfigurationBuilder AddSecureStoreFile(this IConfigurationBuilde
                 path = Path.GetFileName(path);
             }
 
-            var source = new SecureStoreConfigurationSource
+            return builder.AddSecureStoreFile(source =>
             {
-                FileProvider = provider,
-                Path = path,
-                Key = key,
-                KeyType = keyType,
-                Optional = optional,
-                ReloadOnChange = reloadOnChange
-            };
-
-            builder.Add(source);
-            return builder;
+                source.FileProvider = provider;
+                source.Path = path;
+                source.Key = key;
+                source.KeyType = keyType;
+                source.Optional = optional;
+                source.ReloadOnChange = reloadOnChange;
+            });
         }
+
+        /// <summary>
+        /// Adds a SecureStore configuration source to <paramref name="builder"/>.
+        /// </summary>
+        /// <param name="builder">The <see cref="IConfigurationBuilder"/> to add to.</param>
+        /// <param name="configureSource">Configures the source.</param>
+        /// <returns>The <see cref="IConfigurationBuilder"/>.</returns>
+        public static IConfigurationBuilder AddSecureStoreFile(this IConfigurationBuilder builder, Action<SecureStoreConfigurationSource> configureSource)
+            => builder.Add(configureSource);
     }
 }
\ No newline at end of file
diff --git a/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationProvider.cs b/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationProvider.cs
index 531674b..d043675 100644
--- a/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationProvider.cs
+++ b/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationProvider.cs
@@ -6,12 +6,23 @@
     using Microsoft.Extensions.Configuration;
     using NeoSmart.SecureStore;
 
+    /// <summary>
+    /// A SecureStore file based <see cref="FileConfigurationProvider"/>.
+    /// </summary>
     public class SecureStoreConfigurationProvider : FileConfigurationProvider
     {
+        /// <summary>
+        /// Initializes a new instance with the specified source.
+        /// </summary>
+        /// <param name="source">The source settings.</param>
         public SecureStoreConfigurationProvider(SecureStoreConfigurationSource source) : base(source)
         {
         }
 
+        /// <summary>
+        /// Loads the SecureStore data from a stream.
+        /// </summary>
+        /// <param name="stream">The stream to read.</param>
         public override void Load(Stream stream)
         {
             var source = (SecureStoreConfigurationSource)Source;
diff --git a/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationSource.cs b/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationSource.cs
index 42c48d8..9fa33ca 100644
--- a/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationSource.cs
+++ b/src/SecureStore.Contrib.Configuration/SecureStoreConfigurationSource.cs
@@ -2,14 +2,29 @@
 {
     using Microsoft.Extensions.Configuration;
 
+    /// <summary>
+    /// Represents a SecureStore file as an <see cref="IConfigurationSource"/>.
+    /// </summary>
     public class SecureStoreConfigurationSource : FileConfigurationSource
     {
+        /// <summary>
+        /// The key to decrypt the SecureStore file.
+        /// </summary>
         public string Key { get; set; }
+
+        /// <summary>
+        /// Determines if the key is a password or a key file.
+        /// </summary>
         public KeyType KeyType { get; set; }
 
+        /// <summary>
+        /// Builds the <see cref="SecureStoreConfigurationProvider"/> for this source.
+        /// </summary>
+        /// <param name="builder">The <see cref="IConfigurationBuilder"/>.</param>
+        /// <returns>A <see cref="SecureStoreConfigurationProvider"/></returns>
         public override IConfigurationProvider Build(IConfigurationBuilder builder)
         {
-            FileProvider ??= builder.GetFileProvider();
+            EnsureDefaults(builder);
             return new SecureStoreConfigurationProvider(this);
         }
     }