ReSight.Core.Text 1.0.0

# ReSight.Core.Text

The ReSight.Core.Text library provides utility methods for text manipulation and extraction in .NET applications. It includes features for pattern-based text extraction, enum description retrieval, and GUID conversion.

## Features

1. **Pattern-Based Text Extraction**: Extract values from text based on a specified pattern.
2. **Enum Description Retrieval**: Retrieve the description attribute of an enum value or its name if the description is not present.
3. **GUID Conversion**: Convert strings to GUIDs, with handling for invalid GUID strings.

## Getting Started

### Installation

This library is conceptual and meant to be included in your .NET projects as a shared library or as part of your solution. It is available as a NuGet package, you can add it through:

```shell
dotnet add package ReSight.Core.Text

Usage

1. Pattern-Based Text Extraction

You can extract values from a string based on a specified pattern using the Extract method:

using ReSight.Core.Text;
using System.Collections.Immutable;

string input = "Hello, my name is John and I am 30 years old.";
string pattern = "Hello, my name is {name} and I am {age} years old.";

ImmutableDictionary<string, string> result = input.Extract(pattern);

// result["name"] will be "John"
// result["age"] will be "30"

2. Enum Description Retrieval

Retrieve the description attribute of an enum value or its name if the description is not present using the Description method:

using ReSight.Core.Text;
using System.ComponentModel;

public enum Status
{
    [Description("Operation is pending")]
    Pending,
    [Description("Operation completed successfully")]
    Completed,
    Unknown
}

Status status = Status.Completed;
string description = status.Description(); // "Operation completed successfully"

3. GUID Conversion

Convert a string to a GUID using the ToGuid method. If the string is not a valid GUID, an empty GUID is returned:

using ReSight.Core.Text;
using System;

string guidString = "d2719b6e-7b6e-4d6e-9b6e-7b6e4d6e9b6e";
Guid result = guidString.ToGuid(); // Valid GUID

string invalidGuidString = "invalid-guid";
Guid invalidResult = invalidGuidString.ToGuid(); // Guid.Empty

License

This project is licensed under the MIT License.