AGDevX 0.0.1-alpha

AGDevX .NET

AGDevX .NET is a collection of C# extension methods, utilities, and other helpful, foundational code that can help make developing applications more elegant.

<br /> <br />

Features

The sections below describe AGDevX .NET's capabilities.

Assemblies

Assembly Extensions

• FullNameStartsWithPrefix: Determines if an assembly's FullName begins with the provided string prefix
• FullNameStartsWithPrefixes: Determines if an assembly's FullName begins with any of the provided string prefixes

Assembly Utility

• GetAssemblies: Recursively retrieves all assemblies referenced by the provided parent assembly or the currently executing assembly
• AssemblyNameStartsWithAnyPrefix: Determines if an assembly's FullName begins with any of the provided prefixes

<br />

Attributes

Attribute Extensions

• GetDescription: Retrieves the value of the DescriptionAttribute for an objects of type T

<br />

DateTimes

DateTime Extensions

• SpecifyKind: Specifies the Kind of the DateTime

<br />

Enums

Enum Extensions

• IsOneOf: Determines if an Emum exists in a list of Enums

EnumStringValueAttribute

Decorator to provide a string value to an Enum since C# does not support Enums with a string value

• StringValue (extension): Retrieves the string value for an Enum decorated with the EnumStringValueAttribute

<br />

Exceptions

• CodedException: Base exception from which to inherit for application-specific exceptions. This inherits from ApplicationException and adds the concept of a "Code" that can be programmatically checked by other applications if this exception is serialized and returned to another application.

• AcquireTokenException: Exception to throw if an error occurs while acquiring a token from an authorization server

• ApplicationStartupException: Exception to throw during application start up if an error occurs during the application startup process

• ClaimNotFoundException: Exception to throw if a claim is unable to be retrieved from a ClaimsPrincipal

• ExtensionMethodException: Exception to throw if an error occurs during the execution of an extension method when no other more-specific exceptions are available

• ExtensionMethodParameterNullException: Exception to throw if a required parameter was not provided to an extension method

• MissingRequiredClaimException: Exception to throw if a required Claim is missing from a ClaimsPrincipal

• NotAuthorizedException: Exception to throw if the ClaimsPrincipal is attempting to access a resource or perform a function that it is not allowed to

Exception Detail

Information relevant to a developer that has been extracted from an execption and put into an easy to consume model

• GetExceptionDetail (Exception extension method): Recursively retrieves structured information about an exception

<br />

Guids

Guid Extensions

• IsEmpty: Determines if a Guid is empty
• IsNotEmpty: Determines if a Guid is not empty
• IsNull: Determines if a Guid is null
• IsNotNull: Determines if a Guid is not null
• IsNullOrEmpty: Determines if a Guid is null or empty
• IsNotNullNorEmpty: Determines if a Guid is not null and not empty

<br />

IEnumerables

Dictionary Extensions

• ReverseKeysAndValues: Switches the place of the Dictionary's Keys and Values
• Concatenate: Appends one Dictionary to another

IEnumerable Extensions

• IsNullOrEmpty: Determines if an IEnumerable is null or empty
• HasCommonStringElement: Determines if two string IEnumerables have a common element
• ToDataTable: Converts an IEnumerable of type T to a DataTable with the provided column name
• ContainsIgnoreCase: Determines if a string IEnumerable contains the provided string
• AnySafe: Determines if there are any records in an IEnumerable (will not blow up on null IEnumerables)

<br />

Objects

Object Extensions

• IsNull: Determines if an object is null
• IsNotNull: Determines if an object is not null

<br />

Security

• Auth0ClaimType: Claim Types as defined by Auth0
• CustomClaimType: Claim Types as defined by AGDevX
• JwtClaimType: Standard JWT Claim Types

ClaimsPrincipal Extensions

Extensions for pulling Claims out of a ClaimsPrincipal

<br />

Strings

String Extensions

• EqualsIgnoreCase: Determines if two string are equal ignoring case
• StartsWithIgnoreCase: Determines if a string starts with another string ignoring case
• ContainsIgnoreCase: Determines if a string is contained within another string ignoring case
• IsNullOrWhiteSpace: Determines if a string is null or whitespace
• IsNotNullNorWhiteSpace: Determines if a string is not null and not whitespace
• IsWhiteSpace: Determines if a string only consists of whitespace
• IsNotWhiteSpace: Determines if a string contains at least one character that is not whitespace
• IsEmpty: Determines if a string is empty
• IsNotEmpty: Determines if a string is not empty

<br /> <br />

Tech Debt

• Unit tests to cover all ClaimsPrincipal extensions (there are many)
• Document all ClaimsPrincipal extensions (there are many)