ConsoleInputReader 2.1.0-preview

This is a prerelease version of ConsoleInputReader.
There is a newer version of this package available.
See the version list below for details.
dotnet add package ConsoleInputReader --version 2.1.0-preview                
NuGet\Install-Package ConsoleInputReader -Version 2.1.0-preview                
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="ConsoleInputReader" Version="2.1.0-preview" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ConsoleInputReader --version 2.1.0-preview                
#r "nuget: ConsoleInputReader, 2.1.0-preview"                
#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 ConsoleInputReader as a Cake Addin
#addin nuget:?package=ConsoleInputReader&version=2.1.0-preview&prerelease

// Install ConsoleInputReader as a Cake Tool
#tool nuget:?package=ConsoleInputReader&version=2.1.0-preview&prerelease                
TestConsoleApp - InputReader Usage Sample

This document provides an overview and usage samples of the InputReader library, which is designed to simplify reading various types of inputs in console applications.

Features

The InputReader library offers a range of features to make input handling more straightforward and efficient. These features include:

  • ReadString: Reads a string input from the console.
  • ReadChar: Reads a character input from the console.
  • ReadInt: Reads an integer input and validates it.
  • ReadDateOnly: Parses a date input with a specific format from the console.
  • ReadTimeOnly: Parses a time input with a specific format from the console.
  • ReadYesNo: Reads yes or no input from the console.
  • (Add more features as per your library)

This readers also have extension methods to read until a valid input is provided. The validation can be customized by passing a predicate to the extension method as well as its type. For instance, you can read the input until it's a valid integer.

Installation

To use the InputReader class library in your project, you need to install it via NuGet Package Manager. You can do this by running the following command in your Package Manager Console:

Install-Package InputReader ConsoleInputReader

A few examples of how to use the InputReader library:


// Read a string input until it's a valid email address
var validEmailResult = Input.String("Enter your email address: ").ReadUntilValidEmail();

// Read an integer input with allowed values. If the input is 1 or 2, it will be valid result, otherwise not valid.
var oneOrTwoResult = Input.Int("Do you agree? ").WithAllowedValues(1, 2).Read();


// Read a char from console and validate it if it's a allowed char
var yesNoResult = Input
                    .YesNo()
                    .WithMessage("Are you sure? ")
                    .WithErrorMessage("Please enter either 'y' or 'n' ")
                    .WithAllowedValues(["y", "n"], caseInsensitive: true)
                    .Read();

// Read an integer input until it's a valid one digit number
var oneDigitIntegerResult = Input
                            .Int("Input a number that is one digit only")
                            .WithPreValidator(input => input?.Length == 1)
                            .ReadUntilValid();

// Read a date input with a provided format with a specific format
var formattedDate = Input.DateOnly("Enter Date [dd.MM.yyyy]: ")
                     .WithDateOnlyValueConverter(format: "dd.MM.yyyy")
                     .Read();

// Read a date input with a provided format until it's in the specified range
var dateInput = Input
                    .DateOnly("Enter Date [dd.MM.yyyy]: ", format: "dd.MM.yyyy")
                    .ReadUntilInRange("01.01.2021", "31.12.2021", "dd.MM.yyyy");


// Read a time input with a provided format until it's in the specified range
var timeResult_1 = Input
                    .TimeOnly("Enter a time (HH:mm:ss): ", "HH:mm:ss")
                    .ReadUntilInRange("10:00", "18:00", "HH:mm");

// Read a time input with a provided format until it's in the specified range
var timeResult_2_ = Input
                    .TimeOnly("Enter a time (HH:mm:ss): ", "HH:mm:ss")
                    .ReadUntilInRange(CustomTimeOnly.From(hour: 10), CustomTimeOnly.From(hour: 18));

var passWordResult = Input
                        .Password("Enter your password: ", Constants.Chars.NoChar) // No char will be shown
                      //.PassWord("Enter your password: ", Constants.Chars.Asterisk) // Asterisk will be shown")  
                        .Read();


All the readers, return a result object that's derived from InputValue class. This object contains the input value and a boolean property IsValid that indicates if the input is valid or not. ToString() function is overridden to return the input value as a string. Also, implicit conversion operators are defined to convert the InputValue object to the input value type and vice versa.

public record InputValue<T>(T Value)
{
    public T Value { get; protected set; } = Value;

    public bool IsValid { get; set; }

    protected internal virtual string DefaultErrorMessage => "Invalid value. Please try again.";

    public sealed override string ToString() => Value?.ToString();

    public static implicit operator T(InputValue<T> wrapper)
    {
        return wrapper.Value;
    }

    public static implicit operator InputValue<T>(T value)
    {
        return new InputValue<T>(value);
    }
}
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  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 was computed.  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. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.4.4 153 8/24/2024
2.4.3-preview 95 8/7/2024
2.3.3-preview 68 8/3/2024
2.2.2-preview 83 8/1/2024
2.2.1-preview 117 8/1/2024 2.2.1-preview is deprecated because it has critical bugs.
2.2.0-preview 83 7/31/2024
2.1.0-preview 88 7/26/2024
1.1.0 176 7/11/2024
1.0.0 142 6/29/2024