Plinth.Common 1.7.1

Prefix Reserved
dotnet add package Plinth.Common --version 1.7.1                
NuGet\Install-Package Plinth.Common -Version 1.7.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Plinth.Common" Version="1.7.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Plinth.Common --version 1.7.1                
#r "nuget: Plinth.Common, 1.7.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Plinth.Common as a Cake Addin
#addin nuget:?package=Plinth.Common&version=1.7.1

// Install Plinth.Common as a Cake Tool
#tool nuget:?package=Plinth.Common&version=1.7.1                

README

Plinth.Common

A set of generic utilities, extensions, and enhancements for dotnet applications

Cache

Extensions for atomic GetOrCreate on Microsoft.Extensions.Caching.Memory memory caches Example:

IMemoryCache memCache = MemoryCacheUtil.Create();
await memCache.GetOrCreateAtomicMaxDurationAsync(
	"key", TimeSpan.FromMinutes(2), async () => await LoadValue());

👉 MemoryCacheUtil.Create() is a shorthand method for creating a new IMemoryCache.

Collections

  • Case Insensitive Dictionary and HashSet
  • Default Dictionary that will supply a default value for a key when requested
  • Examples:
// values are case insensitive
var set = new CaseInsensitiveHashSet<string>() { "abc", "ABC" };
set.Contains("aBc"); // true

// LINQ extension
var set = items.Where(...).Select(...).ToCaseInsensitiveHashSet();

// keys are case insensitive
var dict = new CaseInsensitiveDictionary<string, int>() { ["abc"] = 5 };
dict["ABC"]; // 5
dict.ContainsKey("aBc"); // true

// LINQ extension
var dict = items.Where(...).Select(...).ToCaseInsensitiveDictionary(v => v.ID);

// default dictionary, easy counting
var dict = new DefaultDictionary<string, int>(0);
dict["a"]++; // dict["a"] now is 1

// default dictionary, easy multi maps
var dict = new DefaultDictionary<string, ISet<int>>(() => new HashSet<int>());
dict["a"].Add(7); // "a" has a set with (7) in it

Constants

Handy constants for Content Types ContentTypes.ApplicationJson ⇒ "application/json; charset=utf-8"

Exceptions

Logical exceptions for common API return values. Allows for separation between logic and api projects

  • LogicalBadRequestException
  • LogicalConflictException
  • LogicalForbiddenException
  • LogicalNotFoundException
  • LogicalPreconditionFailedException

Extensions

A variety of useful extensions to common classes

  • For manipulating DataRow
  • IDictionary .GetValueOrDefault()
  • IEnumerable .IsNullOrEmpty() and .Many()
  • Enum extensions for converting between enums by name (not by integer value)
  • ILogger extensions for logging code durations
using (log.LogExecTiming("some code"))
{
	... some code ...
	log.Debug("action");
}
// logs
[CTX-6540F] : Starting some code #52400089
[CTX-6540F] : action
[CTX-6540F] : some code #52400089 Took: 00.00.00.274472
  • Sensitive data extensions for masking secure items like passwords, SSNs, and credit card numbers.
  • Stream extensions .ToBytes() and .ToBytesAsync()
  • String extensions for converting strings to various types, .ChangeType<T>() as various .To{Type}OrNull()

Logging

  • Extensions and enhancements to Microsoft.Extensions.ILogger for better tracing when using the Plinth ecosystem
  • Provides StaticLogManager.GetLogger() to retrieve a static logger for the current class
  • Provides RequestTraceId and RequestTraceProperties singletons for passing data through the entire call stack (including across HTTP boundaries)
  • Adds shorthand calls for shorter log function names.
    • LogTrace ⇒ Trace
    • LogDebug ⇒ Debug
    • LogInformation ⇒ Info
    • LogWarning ⇒ Warn
    • LogError ⇒ Error
    • LogCritical ⇒ Critical or Fatal

Mapping

An enhanced version of Omu.ValueInjecter for easy object to object mapping Allows for deeply nested Field to Field mapping (including Lists, Sets, and Dictionaries)

Utils

A set of static utilities

  • AsyncUtil: Some async utilities, mostly obsolete as of net6.0
  • DateTimeUtil: Utilities for truncating date times, UTC/TZ conversions, and some date comparison functions
  • HexUtil: Conversion of hex strings to bytes and vice versa. 👉 Obsolete as of net9.0
  • RuntimeUtil: Provides FindExecutableHome() which can find your project root at runtime
  • TimeUtil: Provides log timing (used by ILogger extension noted above)
  • UriUtil: Provides a Join() method similar to Path.Combine()
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (18)

Showing the top 5 NuGet packages that depend on Plinth.Common:

Package Downloads
Plinth.Serialization

JSON/XML/etc object serialization

Plinth.Security

Security, Cryptography, and Token Utilities

Plinth.HttpApiClient.Common

Shared objects for HTTP Api Client frameworks

Plinth.HttpApiClient

HTTP Api Client framework built on MS HttpClient

Plinth.AspNetCore

Plinth ASP.NET Core Services Utilities

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.7.1 528 12/12/2024
1.7.0 526 11/12/2024
1.6.6 685 11/8/2024
1.6.5 1,661 8/31/2024
1.6.4 762 8/2/2024
1.6.3 4,653 5/15/2024
1.6.2 1,241 2/16/2024
1.6.1 5,726 1/5/2024
1.6.0 1,136 11/30/2023
1.5.10-b186.aca976b4 96 11/30/2023 1.5.10-b186.aca976b4 is deprecated because it is no longer maintained.
1.5.9 2,382 11/29/2023 1.5.9 is deprecated because it is no longer maintained.
1.5.9-b174.64153841 191 11/23/2023 1.5.9-b174.64153841 is deprecated because it is no longer maintained.
1.5.9-b172.dfc6e7bd 102 11/17/2023 1.5.9-b172.dfc6e7bd is deprecated because it is no longer maintained.
1.5.9-b171.4e2b92e2 140 11/4/2023 1.5.9-b171.4e2b92e2 is deprecated because it is no longer maintained.
1.5.8 3,282 10/23/2023 1.5.8 is deprecated because it is no longer maintained.
1.5.7 7,176 7/31/2023 1.5.7 is deprecated because it is no longer maintained.
1.5.6 12,475 7/13/2023 1.5.6 is deprecated because it is no longer maintained.
1.5.5 904 6/29/2023 1.5.5 is deprecated because it is no longer maintained.
1.5.4 2,565 3/7/2023 1.5.4 is deprecated because it is no longer maintained.
1.5.3 1,747 3/3/2023 1.5.3 is deprecated because it is no longer maintained.
1.5.2 2,708 1/11/2023 1.5.2 is deprecated because it is no longer maintained.
1.5.2-b92.7c961f5f 144 1/11/2023 1.5.2-b92.7c961f5f is deprecated because it is no longer maintained.
1.5.0 3,024 11/9/2022 1.5.0 is deprecated because it is no longer maintained.
1.5.0-b88.7a7c20cd 131 11/9/2022 1.5.0-b88.7a7c20cd is deprecated because it is no longer maintained.
1.4.7 13,385 10/20/2022 1.4.7 is deprecated because it is no longer maintained.
1.4.6 6,193 10/17/2022 1.4.6 is deprecated because it is no longer maintained.
1.4.5 6,577 10/1/2022 1.4.5 is deprecated because it is no longer maintained.
1.4.4 11,657 8/16/2022 1.4.4 is deprecated because it is no longer maintained.
1.4.3 6,959 8/2/2022 1.4.3 is deprecated because it is no longer maintained.
1.4.2 6,717 7/19/2022 1.4.2 is deprecated because it is no longer maintained.
1.4.2-b80.7fdbfd04 159 7/19/2022 1.4.2-b80.7fdbfd04 is deprecated because it is no longer maintained.
1.4.2-b74.acaf86f5 209 6/15/2022 1.4.2-b74.acaf86f5 is deprecated because it is no longer maintained.
1.4.1 6,855 6/13/2022 1.4.1 is deprecated because it is no longer maintained.
1.4.0 6,649 6/6/2022 1.4.0 is deprecated because it is no longer maintained.
1.3.8 8,858 4/12/2022 1.3.8 is deprecated because it is no longer maintained.
1.3.7 6,746 3/21/2022 1.3.7 is deprecated because it is no longer maintained.
1.3.6 6,710 3/17/2022 1.3.6 is deprecated because it is no longer maintained.
1.3.6-b67.ca5053f3 174 3/16/2022 1.3.6-b67.ca5053f3 is deprecated because it is no longer maintained.
1.3.6-b66.4a9683e6 160 3/16/2022 1.3.6-b66.4a9683e6 is deprecated because it is no longer maintained.
1.3.5 6,575 2/23/2022 1.3.5 is deprecated because it is no longer maintained.
1.3.4 7,063 1/20/2022 1.3.4 is deprecated because it is no longer maintained.
1.3.3 3,306 12/29/2021 1.3.3 is deprecated because it is no longer maintained.
1.3.2 3,270 12/11/2021 1.3.2 is deprecated because it is no longer maintained.
1.3.1 3,411 11/12/2021 1.3.1 is deprecated because it is no longer maintained.
1.3.0 3,510 11/8/2021 1.3.0 is deprecated because it is no longer maintained.
1.2.3 4,849 9/22/2021 1.2.3 is deprecated because it is no longer maintained.
1.2.2 3,981 8/20/2021 1.2.2 is deprecated because it is no longer maintained.
1.2.1 4,354 8/5/2021 1.2.1 is deprecated because it is no longer maintained.
1.2.0 13,361 8/1/2021 1.2.0 is deprecated because it is no longer maintained.
1.2.0-b37.a54030b9 194 6/24/2021 1.2.0-b37.a54030b9 is deprecated because it is no longer maintained.
1.1.6 11,794 3/22/2021 1.1.6 is deprecated because it is no longer maintained.
1.1.5 4,007 3/9/2021 1.1.5 is deprecated because it is no longer maintained.
1.1.4 4,973 2/27/2021 1.1.4 is deprecated because it is no longer maintained.
1.1.3 3,527 2/17/2021 1.1.3 is deprecated because it is no longer maintained.
1.1.2 3,547 2/12/2021 1.1.2 is deprecated because it is no longer maintained.
1.1.1 3,783 2/1/2021 1.1.1 is deprecated because it is no longer maintained.
1.1.0 3,506 12/16/2020 1.1.0 is deprecated because it is no longer maintained.
1.1.0-b27.b66c309b 317 11/15/2020 1.1.0-b27.b66c309b is deprecated because it is no longer maintained.
1.0.12 5,927 10/18/2020 1.0.12 is deprecated because it is no longer maintained.
1.0.11 3,658 10/6/2020 1.0.11 is deprecated because it is no longer maintained.
1.0.10 3,747 9/30/2020 1.0.10 is deprecated because it is no longer maintained.
1.0.9 3,568 9/29/2020 1.0.9 is deprecated because it is no longer maintained.
1.0.8 3,592 9/26/2020 1.0.8 is deprecated because it is no longer maintained.
1.0.7 3,576 9/19/2020 1.0.7 is deprecated because it is no longer maintained.
1.0.6 3,523 9/3/2020 1.0.6 is deprecated because it is no longer maintained.
1.0.5 3,667 9/2/2020 1.0.5 is deprecated because it is no longer maintained.
1.0.4 3,788 9/1/2020 1.0.4 is deprecated because it is no longer maintained.
1.0.3 3,431 9/1/2020 1.0.3 is deprecated because it is no longer maintained.
1.0.2 3,447 8/29/2020 1.0.2 is deprecated because it is no longer maintained.
1.0.1 3,447 8/29/2020 1.0.1 is deprecated because it is no longer maintained.
1.0.0 3,488 8/29/2020 1.0.0 is deprecated because it is no longer maintained.
1.0.0-b1.c22f563d 273 8/28/2020 1.0.0-b1.c22f563d is deprecated because it is no longer maintained.

net9.0 support