AppEngine Tools

🏷️ Introduction

AppEngine Tools is a lightweight development engine for .NET web applications, designed to simplify and provide essential tools for developing web apps. It offers a collection of utilities, extensions, and validation mechanisms to streamline the development process and enhance productivity.

📁 Project Structure

AppEngine/
├── .github/                                    # GitHub configuration files
│   ├── instructions/                           # Instructions for contributing and using the project
│   └── workflows/                              # GitHub Actions workflows for CI/CD
│
├── src/
│   ├── TinyAppEngine.Tools/                    # Command-line tools and utilities
│   │   ├──  DependencyInjection/               # Dependency injection related classes and utilities
│   │   ├──  ExceptionHandlers/                 # Custom exception handlers and related classes
│   │   ├──  Extensions/                        # Extension methods specific to the tools
│   │   ├──  OpenApi/                           # OpenAPI related utilities and classes
│   │   │    ├── Filters/                       # OpenAPI filters and related classes
│   │   │    ├── Helpers/                       # OpenAPI helper classes and utilities
│   │   │    ├── Options/                       # OpenAPI options and configuration classes
│   │   │    └── SimpleAuthentication/          # OpenAPI extensions and utilities for simple authentication
│   │   │
│   │   ├──  OperationResult/                   # Classes related to operation results and responses
│   │   │    └── AspNetCore.Http/               # Operation result classes specific to ASP.NET Core HTTP responses
│   │   │
│   │   ├──  Serialization/                     # Serialization utilities and classes
│   │   ├──  SimpleAuthentication/              # Simple authentication utilities and classes
│   │   │    ├── Abstractions/                  # Abstractions and interfaces for authentication
│   │   │    └── JWTBearer/                     # JWT Bearer authentication related classes and utilities
│   │   │
│   │   └──  TimeZoneService/                   # Time zone related utilities and services
│   │        └── Interfaces/                    # Interfaces for time zone services
│   │   
│   └── Directory.Build.props                   # Shared MSBuild properties
│
├── .editorconfig                               # Code style and formatting rules
├── .gitignore                                  # Git ignore file
├── LICENSE                                     # License information
├── README.md                                   # Project documentation
└── AppEngine.slnx                              # Solution file for the entire project

🛠️ Installation

Prerequisites

• .NET 10.0 SDK (latest version)

Setup

The libraries are available on Baget, just search for TinyAppEngine.Tools in the Package Manager GUI or run the following command in the .NET CLI:

dotnet add package TinyAppEngine.Tools

[!NOTE] It is necessary to configure nuget.config in order to be able to install nuget packages from Baget without problems, below is an example of configuration

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <packageSources>
        <add key="Baget" value="http://nuget.aepserver.it/v3/index.json" allowInsecureConnections="true" />
    </packageSources>

    <!-- Opzionale: limitare quali pacchetti vengono risolti da quale sorgente -->
    <packageSourceMapping>
        <packageSource key="nuget.org">
            <package pattern="*" />
        </packageSource>
        <packageSource key="Baget">
            <package pattern="TinyAppEngine*" /><!-- Tutti i pacchetti che iniziano con TinyAppEngine -->
        </packageSource>
    </packageSourceMapping>

    <config>
        <!-- esempio: personalizzare la cartella dei pacchetti (opzionale) -->
        <!-- <add key="globalPackagesFolder" value="%USERPROFILE%\.nuget\packages" /> -->
    </config>
</configuration>

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.