DotNetTips.Spargine for Microsoft .NET 10: v2026.10.2.15

Open-source .NET assemblies from dotNetTips.com and David (dotNetDave) McCarter. This repository hosts the dotNetTips.Spargine codebase for .NET 10. Spargine encompasses foundational code that I’ve been building and perfecting since the early days of .NET 2. In addition to the core library, it includes a dedicated library to support efficient testing and another designed specifically for benchmarking your code, helping you achieve optimal performance with ease.

Please support this project by clicking here.

Click here to visit the Spargine page on dotNetTips.com. Much of this code is also documented on dotNetTips.com.

NuGet

All of the assemblies listed below can be found on NuGet by clicking here.

Projects

Code Quality Stats

DotNetTips.Spargine

Unit tests: 180

DotNetTips.Spargine.Core

Unit tests: 2,043
Benchmark tests: 754

DotNetTips.Spargine.Extentions

Unit tests: 1,323
Benchmark tests: 1,878

DotNetTips.Spargine.Tester

Unit tests: 1,323
Benchmark tests: 124

Below is the list of current projects in this repository

• DotNetTips.Spargine: Windows and File I/O Targeting Library.

  • IO
    • DirectoryHelper: Common methods for working with file directories.
    • DriveHelper: Common methods for working with disk drives.
    • FileHelper: Common methods for working with files.
    • FileProcessor: Facilitates file copying and deletion operations, incorporating event handling for files. Additionally, it offers the capability to delete folders.
    • PathHelper: Common methods for path manipulation, encompassing handling invalid filter characters, invalid path names, and path separators.
    • TempFileManager: Creates and maintains a list of temporary files.
  • Net
    • Http
      • HttpClientHelper: Utility methods for HttpClient.
    • Sockets
      • SocketsHelper: Helper methods for Socket operations.
  • Win32
    • RegistryHelper: Convenient methods for interacting with the Windows registration database, streamlining access and manipulation tasks.
  • Service: Convenient helper methods for seamless management of Windows services, offering key features such as loading a service, checking its running status, starting and stopping services, and more.

• DotNetTips.Spargine.Core: Core library used by all of the other assemblies.

  • Cache
    • InMemoryCache: MemoryCache with a default duration of 20 minutes for storing objects in memory.
  • Collections
    • Generic
      • Concurrent
        • ChannelQueue: QueueManager class featuring the ListenAsync method for common queuing of items.
        • ConcurrentHashSet: Represents a thread-safe, hash-based unique collection.
        • DistinctBlockingCollection: A custom thread-safe collection type designed for multi-threading tasks, ensuring uniqueness for all items in the collection.
        • DistinctConcurrentBag: Inherits from ConcurrentBag and ensures that all items in the bag are unique.
      • AutoDefaultDictionary: The AutoDefaultDictionary is a specialized dictionary type that automatically returns a predefined default value when a key is not found. This eliminates the need for explicit error handling or null checks when accessing non-existent keys.
      • FastSortedList: Custom Collection Class for <T>. Items within this collection are sorted only upon request.
      • ObservableList: Custom Observable Collection Class for <T>. Includes the following events: CollectionChanged, PropertyChanged, PropertyChanging.
    • CollectionRandomizer: Designed to shuffle a collection either once or endlessly. Enables users to retrieve items using the GetNext() method.
  • Devices
    • Clock: Time Utility Class for common tasks related to clocks and time. It includes functionalities to retrieve the current time and tick count, along with a method to determine the number of days in the current month (DaysInCurrentMonth).
  • Diagnostics
    • PerformanceStopwatch: Enhances Stopwatch with helpful methods: StartNew() and StopReset(). Additionally, it possesses the ability to add messages that can be retrieved when the Stopwatch stops.
  • Logging
    • FastLoggerExtentions: Extension methods for ILogger to simplify logging with enriched messages including the calling method's name.
    • LoggingHelper: Utility methods designed for logging purposes. Includes functionality to log computer information and application details. Additionally, it can capture and log all domain exceptions, even if the exception originates from a different assembly, covering exceptions from the .NET framework.
  • Network
    • HttpEventListener: Listens and logs messages from HTTP events, capturing events such as request start and stop. This functionality facilitates comprehensive monitoring and logging of HTTP-related activities.
    • HttpEventListenerAsysncLocal: Listens asynchronously and logs messages from HTTP events, including request start and stop. This functionality enables comprehensive monitoring and logging of asynchronous HTTP-related activities.
    • HttpHandlerDiagnosticListener: Accesses the HttpRequestMessage/HttpResponseMessage instances, providing a useful means to retrieve information such as request headers or the response status code.
    • HttpRequestObserver: Observes the HttpRequestMessage/HttpResponseMessage instances, offering a valuable method to retrieve information such as request headers or the response status code.
    • NetworkHelper: Provides helper methods for network-related operations.
  • Queues
    • ChannelQueue: Thread-Safe queue using Channel.
  • RegularExpressions
    • RegexProcessor: Utility methods for common string regular expressions. Included methods: ContainsWord, IsCreditCardNumber, IsEmailAddress, IsUrl, IsISBN, and more.
  • Security
    • EncryptionHelper: Provides secure encryption for strings using AES (Advanced Encryption Standard) and includes a method to validate encrypted strings. The AES encryption ensures the confidentiality and integrity of sensitive information, making it suitable for securely handling data.
    • PasswordGenerator: Provides functionality to generate random passwords with a mix of uppercase letters, lowercase letters, digits, and special characters.
    • PasswordHasher: Provides methods for hashing and verifying passwords using multiple algorithms.
    • UlidGenerator: Provides methods to generate and manipulate ULIDs (Universally Unique Lexicographically Sortable Identifiers)
  • Serialization
    • JsonSerialization: This class simplifies the process of serializing and deserializing strings to and from JSON format using the JsonSerializer. JSON serialization is a widely adopted and efficient method for storing and exchanging data in various applications and APIs.
    • XmlSerialization: Facilitates seamless serialization and deserialization of strings to and from the XML format.
  • Web
    • ServiceProxy: Generates a service proxy for types that implement ICommunicationObject, enabling communication with such objects.
    • WebHelper: Utility methods for website calls. These functions streamline website interactions and efficiently manage HTTP-related tasks.
  • ApiLibraries: List of common Windows API libraries.
  • App: Application Information and Utility Methods.
  • ArgumentInvalidException: Custom exception type for invalid argument value.
  • ArgumentReadOnlyException: Custom exception type for read-only argument values, such as collections.
  • AssemblyHelper: Provides static helper methods for working with assemblies.
  • ComputerInfo: Used to retrieve common computer information.
  • Config: Adaptable type designed to simplify the creation of custom configuration objects, with a focus on easy disk saving in applications.
  • ControlChars: Contains frequently used strings and characters, including backslash, comma, dash, double quote, empty string, forward slash, quote, space, tab, underscore, and more.
  • DateTimeFormat: Provides a set of common date and time formats as strongly-typed enumeration instances.
  • DirectoryNotFoundException: Custom exception to be utilized when a directory cannot be found.
  • Enumeration: Provides a base class for creating an enumeration-like class structure that supports descriptive names and associated values, offering more flexibility than the standard Enum type.
  • EnumHelper: Facilitates the usage of Enums by providing convenient methods such as AdjustCamelCase(), AdjustName(), GetNames(), and more.
  • EnvironmentKey: Enumeration for common environment keys.
  • ExceptionExtentions: Provides extension methods for working with exceptions.
  • ExceptionThrower: Inspired by the .NET ExceptionThrower, this tool streamlines the process of throwing exceptions effortlessly. All exceptions thrown utilize default messages, and if necessary, custom messages can also be provided.
  • ExecutionHelper: When making calls to code that might be interrupted by network issues, the ProgressiveRetry() method proves beneficial. It automatically retries the code multiple times (default is 3) when encountering connection problems or other internet-related interruptions.
  • FastStringBuilder: Enhances performance when using a StringBuilder by employing an ObjectPool.
  • IDataModel: Interface designed for model classes, enforcing the implementation of the "Id" property, which is mandatory.
  • IDataRecord: Interface tailored for model records, mandating the implementation of the "Id" property. Additionally, it provides functionality to convert all the properties and their data to a string representation.
  • InformationAttributeDocGenerator: Generates documentation for a given type based on the InformationAttribute.
  • InformationAttribute: Attribute that enables the addition of informational data to methods. Properties include Author, BenchMarkStatus, CreatedOn, Description, Documentation, ModifiedBy, ModifiedOn, Status, UnitTestCoverage.
  • InvalidEnumTypeException: Custom exception to be utilized when a value for an Enum is invalid.
  • InvalidValueException: Custom exception to be used when an invalid value is encountered.
  • KeyGenerator: Generates unique keys using a GUID without dashes.
  • LineSplitEnumerator: Initializes a new instance of the LineSplitEnumerator struct for splitting a string into lines.
  • LoggableException: Exception type that includes a HasBeenLogged property to prevent an exception from being logged multiple times.
  • MessageNotQueuedException: Custom exception to be employed when a message could not be queued.
  • NetworkConnectionException: Custom exception to be used when there is a network connection error.
  • PreserveAttribute: Attribute to make it easier to look at code and know that the code needs to be preserved due to one of the reasons in PreserveReason (None, ObjectInjected, MethodFromInterface, MethodOverride, Other).
  • ProcessorInforamtion: Utility to retrieve information about the computer processor.
  • SimpleResult: Enables methods to return a value, a status, and exception information as needed. This comprehensive approach provides flexibility in handling various outcomes.
  • Singleton: Enables easy creation of a singleton type by utilizing Lazy to instantiate the type only when necessary.
  • TaskHelper: Synchronous execution methods for Tasks streamline the process of running asynchronous operations without requiring explicit asynchronous handling. This simplifies code readability and management.
  • TypeHelper: Provides valuable methods for type management, encompassing tasks such as loading derived types, creating new types, discovering derived types, converting JSON to objects, transforming JSON files into objects, generating instance hash codes, and listing built-in types. These functionalities empower developers to handle types effectively in diverse scenarios.
  • Ulid: Represents a Universally Unique Lexicographically Sortable Identifier (ULID).
  • Valdaitor: Methods facilitating the validation of arguments and values, ensuring both simplicity and accuracy. In the event of encountering invalid data, an Exception will be thrown, accompanied by an appropriate error message, which can be either custom or default.

• DotNetTips.Spargine.Extensions: Library for common extension methods. Supported types are: Array, Assembly, Boolean, Collection, Color, ConcurrentBag, DataContext, DataReader, DataTable, DateTime, Dictionary, Enumerable, Enum, Exception, Guid, HashSet, HttpClient, HttpContext, HttpRequest, HttpReponseHeader, ImmutableArray, LINQ, List, Math, Numeric, Object, ObservableCollection, Process, ReadOnlyCollection, ReadOnlySpan, Socket, SortedDictionary, SortedSet, Stream, StringBuilder, String, Task, Thread, Type, WebClient

• DotNetTips.Spargine.Tester: Library for creating dummy data for use in unit & benchmark tests.

  • Data:
    • Countries: Methods for retrieving comprehensive data encompassing all countries worldwide, including their respective regions, states and cities.
  • Models
    • RefTypes
      • Address: Reference type with properties for Address1 and Address2, City, Country, CountryProvince, Phone, PostalCode, and State. This type inherits from the interface IAddress.
      • AddressRecord: Record type with properties for Address1 and Address2, City, Country, CountryProvince, Phone, PostalCode, and State. This type inherits from the interface IAddress.
      • IAddress: Interface "IAddress" that defines properties for Address1 and Address2, City, Country, CountryProvince, Phone, PostalCode, and State. This interface inherits from another interface named IAddress.
      • IPerson: Interface "IPerson" that defines properties for Addresses, BornOn, CellPhone, Email, FirstName, LastName, and Phone.
      • Person: A real-world type for testing and benchmarking named "Person" with the following properties: Addresses, Age, BornOn, CellPhone, Email, FirstName, FullName, LastName, and Phone. This type also includes methods to convert from PersonRecord and Person value types to Person.
      • PersonJsonSerializerContext: JSON context designed to optimize the serialization and deserialization processes for the "Person" type and collections of "Person."
      • PersonRecord: A real-world type for testing and benchmarking named "PersonRecord" with the following properties: Addresses, Age, BornOn, CellPhone, Email, FirstName, FullName, LastName, and Phone. Additionally, this type includes methods to convert from both Person reference and value types to PersonRecord.
    • ValueTypes
      • Address: Value type named "Address" with properties for Address1 and Address2, City, Country, CountryProvince, Phone, PostalCode, and State. This type inherits from the interface IAddress.
      • Coordinate: A practical value type designed for testing and benchmarking, named "Coordinate," featuring properties X, Y, and Z. It inherits from the interface ICoordinate.
      • ICoordinate: An interface named "ICoordinate" with properties X, Y, and Z for coordinating values.
      • Person: A real-world value type crafted for testing and benchmarking, named "Person," encompassing properties such as Addresses, Age, BornOn, CellPhone, Email, FirstName, FullName, LastName, and Phone.
  • CountryRepository: Provides static methods for retrieving comprehensive data about countries, including their regions, states, and cities.
  • RandomCreditCardNumberGenerator: Create random credit card numbers. It includes support for major credit card types such as Visa, MasterCard, American Express, and others.
  • RandomData: Create random data for unit and benchmark testing.
  • UnitTester: Provides utility methods for debugging and saving object properties. This class is intended to be used as a base class for unit testing scenarios.

• DotNetTips.Spargine.Benchmarking: Library for benchmarking code using BenchmarkDotNet. To read more about this project, click here.

Benchmark Tests

Spargine undergoes performance testing through benchmark tests using BenchmarkDotNet.

Your Support Is Appreciated!

Do you have code you would like to submit to these repositories? Submit a pull request or submit an issue. I promise to take a look and include it if I like it! I might just send you some cool geeky swag that includes one of my books (as supplies last). You can also support these projects via GitHub Sponsors: https://github.com/sponsors/RealDotNetDave