Merge pull request #14 from stevenvolckaert/vNext

Releasing v1.1.0

StevenVolckaert.EnterpriseLibrary.sln

@@ -1,46 +1,45 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio 14
-VisualStudioVersion = 14.0.25420.1
+# Visual Studio 15
+VisualStudioVersion = 15.0.26228.9
 MinimumVisualStudioVersion = 10.0.40219.1
-Project("{8BB2217D-0F2D-49D1-97BC-3654ED321F3B}") = "StevenVolckaert.Core", "src\StevenVolckaert.Core\StevenVolckaert.Core.xproj", "{3E5DE170-18C8-4B09-90A6-7D158A6C54C5}"
-EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution items", "Solution items", "{00269925-9ABB-475F-A63B-B57C55E26CD3}"
  ProjectSection(SolutionItems) = preProject
  .gitattributes = .gitattributes
  .gitignore = .gitignore
  appveyor.yml = appveyor.yml
- global.json = global.json
  LICENSE = LICENSE
  README.md = README.md
  EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "test", "test", "{887100A5-003F-4148-85D8-9D9C9E7E5125}"
 EndProject
-Project("{8BB2217D-0F2D-49D1-97BC-3654ED321F3B}") = "StevenVolckaert.Core.Tests", "test\StevenVolckaert.Core.Tests\StevenVolckaert.Core.Tests.xproj", "{A97F5579-7D70-4FD4-8D6B-DC12E4909AD2}"
-EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{54EC9438-05ED-4ACD-AEF6-B31B353069EA}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "StevenVolckaert.Core", "src\StevenVolckaert.Core\StevenVolckaert.Core.csproj", "{9493EB60-BD91-426A-BDF1-4390456046E1}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "StevenVolckaert.Core.Tests", "test\StevenVolckaert.Core.Tests\StevenVolckaert.Core.Tests.csproj", "{B2222404-4375-458C-9F04-C5F1D279CBA6}"
+EndProject
 Global
  GlobalSection(SolutionConfigurationPlatforms) = preSolution
  Debug|Any CPU = Debug|Any CPU
  Release|Any CPU = Release|Any CPU
  EndGlobalSection
  GlobalSection(ProjectConfigurationPlatforms) = postSolution
- {3E5DE170-18C8-4B09-90A6-7D158A6C54C5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
- {3E5DE170-18C8-4B09-90A6-7D158A6C54C5}.Debug|Any CPU.Build.0 = Debug|Any CPU
- {3E5DE170-18C8-4B09-90A6-7D158A6C54C5}.Release|Any CPU.ActiveCfg = Release|Any CPU
- {3E5DE170-18C8-4B09-90A6-7D158A6C54C5}.Release|Any CPU.Build.0 = Release|Any CPU
- {A97F5579-7D70-4FD4-8D6B-DC12E4909AD2}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
- {A97F5579-7D70-4FD4-8D6B-DC12E4909AD2}.Debug|Any CPU.Build.0 = Debug|Any CPU
- {A97F5579-7D70-4FD4-8D6B-DC12E4909AD2}.Release|Any CPU.ActiveCfg = Release|Any CPU
- {A97F5579-7D70-4FD4-8D6B-DC12E4909AD2}.Release|Any CPU.Build.0 = Release|Any CPU
+ {9493EB60-BD91-426A-BDF1-4390456046E1}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+ {9493EB60-BD91-426A-BDF1-4390456046E1}.Debug|Any CPU.Build.0 = Debug|Any CPU
+ {9493EB60-BD91-426A-BDF1-4390456046E1}.Release|Any CPU.ActiveCfg = Release|Any CPU
+ {9493EB60-BD91-426A-BDF1-4390456046E1}.Release|Any CPU.Build.0 = Release|Any CPU
+ {B2222404-4375-458C-9F04-C5F1D279CBA6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+ {B2222404-4375-458C-9F04-C5F1D279CBA6}.Debug|Any CPU.Build.0 = Debug|Any CPU
+ {B2222404-4375-458C-9F04-C5F1D279CBA6}.Release|Any CPU.ActiveCfg = Release|Any CPU
+ {B2222404-4375-458C-9F04-C5F1D279CBA6}.Release|Any CPU.Build.0 = Release|Any CPU
  EndGlobalSection
  GlobalSection(SolutionProperties) = preSolution
  HideSolutionNode = FALSE
  EndGlobalSection
  GlobalSection(NestedProjects) = preSolution
- {3E5DE170-18C8-4B09-90A6-7D158A6C54C5} = {54EC9438-05ED-4ACD-AEF6-B31B353069EA}
- {A97F5579-7D70-4FD4-8D6B-DC12E4909AD2} = {887100A5-003F-4148-85D8-9D9C9E7E5125}
+ {9493EB60-BD91-426A-BDF1-4390456046E1} = {54EC9438-05ED-4ACD-AEF6-B31B353069EA}
+ {B2222404-4375-458C-9F04-C5F1D279CBA6} = {887100A5-003F-4148-85D8-9D9C9E7E5125}
  EndGlobalSection
 EndGlobal

appveyor.yml

@@ -1,19 +1,20 @@
-version: 1.0.0-{build}
+version: 1.1.0-{build}
 build:
  verbosity: minimal
 configuration:
 - Debug
 - Release
 platform: Any CPU
 environment:
+ image: Visual Studio 2017
  DOTNET_CLI_TELEMETRY_OPTOUT: 1
 init:
-- ps: $Env:LABEL = "CI" + $Env:APPVEYOR_BUILD_NUMBER.PadLeft(5, "0")
+- ps: $Env:VERSION_SUFFIX = "CI" + $Env:APPVEYOR_BUILD_NUMBER.PadLeft(5, "0")
 before_build:
 - appveyor-retry dotnet restore -v Minimal
 build_script:
-- dotnet build "src\StevenVolckaert.Core" -c %CONFIGURATION% --no-dependencies --version-suffix %LABEL%
+- dotnet build "src\StevenVolckaert.Core" -c %CONFIGURATION% --version-suffix %VERSION_SUFFIX%
 test_script:
-- dotnet test "test\StevenVolckaert.Core.Tests" -c %CONFIGURATION%
+- dotnet test "test\StevenVolckaert.Core.Tests\StevenVolckaert.Core.Tests.csproj" -c %CONFIGURATION%
 cache:
 - '%USERPROFILE%\.nuget\packages'

src/StevenVolckaert.Core/ICollectionExtensions.cs

@@ -5,7 +5,8 @@
  using System.Linq;
 
  /// <summary>
- /// Provides extension methods for instances that implement the <see cref="ICollection{T}"/> interface.
+ /// Provides extension methods for instances that implement the <see cref="ICollection{T}"/>
+ /// interface.
  /// </summary>
  public static class ICollectionExtensions
  {
@@ -27,8 +28,40 @@ IEnumerable<TSource> sourceCollection
  if (source == null)
  throw new ArgumentNullException(nameof(source));
 
- if (sourceCollection != null)
- foreach (TSource value in sourceCollection)
+ source.AddRange(sourceCollection, isDistinct: false);
+ }
+
+ /// <summary>
+ /// Adds the elements of the specified collection to the end of the <see cref="ICollection{T}"/>
+ /// instance.
+ /// </summary>
+ /// <typeparam name="TSource">The type of elements of <paramref name="source"/>.</typeparam>
+ /// <param name="source">The target data collection.</param>
+ /// <param name="isDistinct">
+ /// A value that indicates whether to skip adding elements from
+ /// <paramref name="sourceCollection"/> that <paramref name="source"/> already contains,
+ /// using the default equality comparer.
+ /// </param>
+ /// <param name="sourceCollection">
+ /// The collection whose elements should be added to the <see cref="ICollection{T}"/> instance.
+ /// </param>
+ /// <exception cref="ArgumentNullException"><paramref name="source"/> is <c>null</c>.</exception>
+ public static void AddRange<TSource>(
+ this ICollection<TSource> source,
+ IEnumerable<TSource> sourceCollection,
+ bool isDistinct
+ )
+ {
+ if (source == null)
+ throw new ArgumentNullException(nameof(source));
+
+ if (sourceCollection == null)
+ return;
+
+ foreach (TSource value in sourceCollection)
+ if (isDistinct && source.Contains(value))
+ continue;
+ else
  source.Add(value);
  }
 
@@ -42,7 +75,10 @@ IEnumerable<TSource> sourceCollection
  /// <exception cref="ArgumentNullException">
  /// <paramref name="source"/> or <paramref name="predicate"/> is <c>null</c>.
  /// </exception>
- public static void RemoveFirst<TSource>(this ICollection<TSource> source, Func<TSource, bool> predicate)
+ public static void RemoveFirst<TSource>(
+ this ICollection<TSource> source,
+ Func<TSource, bool> predicate
+ )
  {
  if (source == null)
  throw new ArgumentNullException(nameof(source));

src/StevenVolckaert.Core/IDictionaryExtensions.cs

@@ -7,8 +7,8 @@
 #endif
 
  /// <summary>
- /// Provides extension methods for instances that implement the <see cref="IDictionary{TKey, TValue}"/>
- /// interface.
+ /// Provides extension methods for instances that implement the
+ /// <see cref="IDictionary{TKey, TValue}"/> interface.
  /// </summary>
  public static class IDictionaryExtensions
  {
@@ -34,8 +34,8 @@ this IDictionary<TKey, TValue> dictionary
 #endif
 
  /// <summary>
- /// Gets the value associated with the specified key, or the type's default value if the key
- /// doesn't exist.
+ /// Gets the value associated with the specified key,
+ /// or the type's default value if the key doesn't exist.
  /// </summary>
  /// <typeparam name="TKey">The type of keys in the dictionary.</typeparam>
  /// <typeparam name="TValue">The type of values in the dictionary.</typeparam>
@@ -55,27 +55,28 @@ public static TValue TryGetValue<TKey, TValue>(this IDictionary<TKey, TValue> di
  if (key == null)
  throw new ArgumentNullException(nameof(key));
 
- return dictionary.TryGetValue(key, defaultValue: default(TValue));
+ return dictionary.TryGetValue(key, fallbackValue: default(TValue));
  }
 
  /// <summary>
- /// Gets the value associated with the specified key, or a default value if the key doesn't exist.
+ /// Gets the value associated with the specified key,
+ /// or a specified fallback value if the key doesn't exist.
  /// </summary>
  /// <typeparam name="TKey">The type of keys in the dictionary.</typeparam>
  /// <typeparam name="TValue">The type of values in the dictionary.</typeparam>
  /// <param name="dictionary">
  /// The <see cref="IDictionary{TKey, TValue}"/> instance this extension method affects.
  /// </param>
  /// <param name="key">The key whose value to get.</param>
- /// <param name="defaultValue">The default value.</param>
+ /// <param name="fallbackValue">The default value.</param>
  /// <returns>
- /// The value associated with the specified key, or <paramref name="defaultValue"/> if
+ /// The value associated with the specified key, or <paramref name="fallbackValue"/> if
  /// <paramref name="key"/> doesn't exist.
  /// </returns>
  public static TValue TryGetValue<TKey, TValue>(
  this IDictionary<TKey, TValue> dictionary,
  TKey key,
- TValue defaultValue
+ TValue fallbackValue
  )
  {
  if (dictionary == null)
@@ -84,7 +85,7 @@ TValue defaultValue
  if (key == null)
  throw new ArgumentNullException(nameof(key));
 
- return dictionary.ContainsKey(key) ? dictionary[key] : defaultValue;
+ return dictionary.ContainsKey(key) ? dictionary[key] : fallbackValue;
  }
  }
 }

src/StevenVolckaert.Core/IEnumerableExtensions.cs

@@ -8,17 +8,90 @@
 #endif
 
  /// <summary>
- /// Provides extension methods for instances that implement the <see cref="IEnumerable{T}"/> interface.
+ /// Provides extension methods for instances that implement the <see cref="IEnumerable{T}"/>
+ /// interface.
  /// </summary>
  public static class IEnumerableExtensions
  {
+ /// <summary>
+ /// Adds a specified element to the end of the sequence.
+ /// </summary>
+ /// <typeparam name="T">The type of the elements of <paramref name="source"/>.</typeparam>
+ /// <param name="source">
+ /// The <see cref="IEnumerable{T}"/> instance this extension method affects.
+ /// </param>
+ /// <param name="element">The element to add.</param>
+ /// <returns>
+ /// An <see cref="IEnumerable{T}"/> instance containing all elements of <paramref name="source"/>,
+ /// followed by <paramref name="element"/>.
+ /// </returns>
+ /// <exception cref="ArgumentNullException">
+ /// <paramref name="source"/> is <c>null</c>.
+ /// </exception>
+ public static IEnumerable<T> Append<T>(this IEnumerable<T> source, T element)
+ {
+ if (source == null)
+ throw new ArgumentNullException(nameof(source));
+
+ foreach (var sourceElement in source)
+ yield return sourceElement;
+
+ yield return element;
+ }
+
+ /// <summary>
+ /// Adds a specified element to the beginning of the sequence.
+ /// </summary>
+ /// <typeparam name="T">The type of the elements of <paramref name="source"/>.</typeparam>
+ /// <param name="source">
+ /// The <see cref="IEnumerable{T}"/> instance this extenion method affects.
+ /// </param>
+ /// <param name="element">The element to add.</param>
+ /// <returns>
+ /// An <see cref="IEnumerable{T}"/> instance containing <paramref name="element"/>,
+ /// followed by all elements of <paramref name="source"/>.
+ /// </returns>
+ /// <exception cref="ArgumentNullException">
+ /// <paramref name="source"/> is <c>null</c>.
+ /// </exception>
+ public static IEnumerable<T> Prepend<T>(this IEnumerable<T> source, T element)
+ {
+ if (source == null)
+ throw new ArgumentNullException(nameof(source));
+
+ yield return element;
+
+ foreach (var sourceElement in source)
+ yield return sourceElement;
+ }
+
+ /// <summary>
+ /// Determines whether a sequence contains no elements.
+ /// </summary>
+ /// <typeparam name="TSource">The type of the elements of <paramref name="source"/>.</typeparam>
+ /// <param name="source">The <see cref="IEnumerable{T}"/> instance to check for emptiness. </param>
+ /// <returns>
+ /// <c>true</c> if the source sequence contains no elements; otherwise, <c>false</c>.
+ /// </returns>
+ /// <exception cref="ArgumentNullException"><paramref name="source"/> is <c>null</c>.</exception>
+ public static bool IsEmpty<TSource>(this IEnumerable<TSource> source)
+ {
+ if (source == null)
+ throw new ArgumentNullException(nameof(source));
+
+ return !source.Any();
+ }
+
  /// <summary>
  /// Determines whether a sequence contains no elements.
  /// </summary>
  /// <typeparam name="TSource">The type of the elements of <paramref name="source"/>.</typeparam>
  /// <param name="source">The <see cref="IEnumerable{T}"/> instance to check for emptiness. </param>
- /// <returns><c>true</c> if the source sequence contains no elements; otherwise, <c>false</c>.</returns>
+ /// <returns>
+ /// <c>true</c> if the source sequence contains no elements; otherwise, <c>false</c>.
+ /// </returns>
  /// <exception cref="ArgumentNullException"><paramref name="source"/> is <c>null</c>.</exception>
+ [Obsolete("Use of this method is deprecated. Use IEnumerable<T>.IsEmpty<T>() instead.")]
  public static bool Empty<TSource>(this IEnumerable<TSource> source)
  {
  if (source == null)
@@ -253,8 +326,8 @@ public static IEnumerable<T> SkipLast<T>(this IEnumerable<T> source)
  /// <param name="source">The sequence to remove elements from.</param>
  /// <param name="count">The number of elements to remove.</param>
  /// <returns>
- /// An <see cref="IEnumerable{T}"/> instance that doesn't contain the specified number of elements at
- /// the end of the input sequence.
+ /// An <see cref="IEnumerable{T}"/> instance that doesn't contain the specified number of elements
+ /// at the end of the input sequence.
  /// </returns>
  /// <exception cref="ArgumentNullException">
  /// <paramref name="source"/> is <c>null</c>.
@@ -285,7 +358,8 @@ public static IEnumerable<T> SkipLast<T>(this IEnumerable<T> source, int count)
  /// <typeparam name="TSource">The type of the elements of <paramref name="source"/>.</typeparam>
  /// <param name="source">The sequence to create an <see cref="ObservableCollection{T}"/> from.</param>
  /// <returns>
- /// An <see cref="ObservableCollection{T}"/> instance that contains elements from the input sequence.
+ /// An <see cref="ObservableCollection{T}"/> instance that contains elements from the input
+ /// sequence.
  /// </returns>
  /// <exception cref="ArgumentNullException">
  /// <paramref name="source"/> is <c>null</c>.

src/StevenVolckaert.Core/StevenVolckaert.Core.csproj

@@ -0,0 +1,40 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+ <PropertyGroup>
+ <AssemblyName>StevenVolckaert.Core</AssemblyName>
+ <AssemblyTitle>Steven Volckaert's Enterprise Library - Core</AssemblyTitle>
+ <NeutralLanguage>en-US</NeutralLanguage>
+ <VersionPrefix>1.0.1</VersionPrefix>
+ <VersionSuffix>alpha</VersionSuffix>
+ <Copyright>Copyright (c) 2016, 2017 Steven Volckaert</Copyright>
+ <Description>Steven Volckaert's Enterprise Library contains reusable software components designed to assist software developers with writing less and semantically more meaningful code.
+
+See https://github.com/stevenvolckaert/enterprise-library for more information.</Description>
+ <Authors>Steven Volckaert</Authors>
+ <TargetFrameworks>net452;netstandard1.5</TargetFrameworks>
+ <GenerateDocumentationFile>true</GenerateDocumentationFile>
+ <PackageId>StevenVolckaert.Core</PackageId>
+ <PackageProjectUrl>https://github.com/stevenvolckaert/enterprise-library</PackageProjectUrl>
+ <PackageLicenseUrl>https://github.com/stevenvolckaert/enterprise-library/blob/master/LICENSE</PackageLicenseUrl>
+ <RepositoryType>git</RepositoryType>
+ <RepositoryUrl>https://github.com/stevenvolckaert/enterprise-library</RepositoryUrl>
+ <NetStandardImplicitPackageVersion Condition=" '$(TargetFramework)' == 'netstandard1.5' ">1.6.1</NetStandardImplicitPackageVersion>
+ <GenerateAssemblyConfigurationAttribute>false</GenerateAssemblyConfigurationAttribute>
+ <GenerateAssemblyCompanyAttribute>false</GenerateAssemblyCompanyAttribute>
+ <GenerateAssemblyProductAttribute>false</GenerateAssemblyProductAttribute>
+ <RootNamespace>StevenVolckaert</RootNamespace>
+ <AssemblyVersion>1.1.0.0</AssemblyVersion>
+ <FileVersion>1.1.0.0</FileVersion>
+ <Version>1.1.0</Version>
+ </PropertyGroup>
+
+ <ItemGroup Condition=" '$(TargetFramework)' == 'net35' ">
+ <Reference Include="System" />
+ </ItemGroup>
+
+ <ItemGroup Condition=" '$(TargetFramework)' == 'net452' ">
+ <Reference Include="System" />
+ <Reference Include="Microsoft.CSharp" />
+ </ItemGroup>
+
+</Project>