MortgageCalculators 1.0.0-rc2

This is a prerelease version of MortgageCalculators.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package MortgageCalculators --version 1.0.0-rc2
                    
NuGet\Install-Package MortgageCalculators -Version 1.0.0-rc2
                    
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="MortgageCalculators" Version="1.0.0-rc2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="MortgageCalculators" Version="1.0.0-rc2" />
                    
Directory.Packages.props
<PackageReference Include="MortgageCalculators" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add MortgageCalculators --version 1.0.0-rc2
                    
#r "nuget: MortgageCalculators, 1.0.0-rc2"
                    
#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.
#:package MortgageCalculators@1.0.0-rc2
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=MortgageCalculators&version=1.0.0-rc2&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=MortgageCalculators&version=1.0.0-rc2&prerelease
                    
Install as a Cake Tool

Mortgage Calculators

A collection of C# calculators for mortgage affordability, loan comparison, and refinancing, with robust input validation using FluentValidation.

Features

  • Affordability Calculator: Estimate how much home you can afford.
  • Loan Comparison Calculator: Compare different loan options.
  • Refinance Calculator: Analyze the benefits of refinancing your mortgage.
  • Input Validation: All request models are validated using FluentValidation.

Getting Started

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/dalvare/mortgage-calculators.git
    cd mortgage-calculators
    
  2. Restore dependencies:

    dotnet restore
    

Configuring FluentValidation

  1. Install FluentValidation (if not already installed):

    dotnet add package FluentValidation
    
  2. Register Validators (for example, in your DI container if using ASP.NET Core):

    using FluentValidation;
    using Calculators.Models;
    using Calculators.Validation.Validators;
    
    builder.Services.AddValidatorsFromAssemblyContaining<AffordabilityRequestValidator>();
    

    If you are not using dependency injection, you can instantiate validators directly:

    var validator = new AffordabilityRequestValidator();
    var result = validator.Validate(request);
    if (!result.IsValid)
    {
        // Handle validation errors
    }
    
  3. Using Validators in Tests

    The project uses FluentValidation.TestHelper for unit testing validators. Example:

    var validator = new AffordabilityRequestValidator();
    var result = validator.TestValidate(request);
    result.ShouldNotHaveAnyValidationErrors();
    

Running Tests

Run all unit tests using:

dotnet test
Product Compatible and additional computed target framework versions.
.NET 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 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows 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
1.0.0-rc8 590 9/2/2025
1.0.0-rc7 171 8/27/2025
1.0.0-rc6 162 8/27/2025
1.0.0-rc5 123 8/21/2025
1.0.0-rc4 112 8/21/2025
1.0.0-rc3 111 8/21/2025
1.0.0-rc2 110 8/21/2025
1.0.0-rc1 111 8/21/2025

Includes affordability calculator, loan comparison calculator, and refinance calculator with FluentValidation support.