Kurmann.Videoschnitt.Templates 1.7.0-beta.2

Videoschnitt Templates

Dieses Repository, "Videoschnitt Templates", ist eine Sammlung von benutzerdefinierten .NET Templates, die darauf ausgelegt sind, die schnelle Entwicklung von Modulen und Anwendungen innerhalb des Videoschnitt Projekts zu erleichtern. Jedes Template hält sich an unsere Architekturprinzipien und bietet eine strukturierte Grundlage für den Bau modularer, wartbarer und skalierbarer Lösungen in .NET Core und ASP.NET Core Anwendungen.

Installation

dotnet new install Kurmann.Videoschnitt.Templates

Anwendung

Nach der Installation können Sie ein neues Projekt basierend auf einem Template erstellen mit:

dotnet new [TemplateShortName] -n Projektname

Verfügbare Templates

Service Collection Integrated Module (SCI Module)

Kurzname: scimodule

Das ServiceCollectionIntegratedModuleTemplate ist das erste Template in dieser Sammlung, entworfen für die nahtlose Erstellung von Modulen, die einfach mit der IServiceCollection für Dependency Injection integriert werden können. Dieses Template legt Wert auf Modularität, Event-Driven Design und klare Operationsergebnis-Typen, um den Entwicklungsprozess zu vereinfachen und Konsistenz über Module hinweg zu gewährleisten.

Features SCI Module

• IServiceCollection Integration: Erleichtert die Registrierung von Diensten mit der IServiceCollection, was die Dependency Injection verbessert.
• Modulare Architektur: Hält sich an unsere Prinzipien von hoher Kohäsion und loser Kopplung.
• Event-Driven Design: Beinhaltet Event- und Delegate-Muster für die Nachrichtenverarbeitung innerhalb des Moduls.
• Operationsergebnis-Typen: Nutzt Result<T> für die explizite Handhabung von Erfolgs- und Fehlerfällen.
• Einfache Integration: Entwickelt für die mühelose Eingliederung in Host-Anwendungen.
• Namespace-Unterstützung: Der Stammnamespace Kurmann.Videoschnitt wird korrekt angewandt.

Anwendung SCI Module

dotnet new scimodule -n MediaFileWatcher -o src

ergibt ein Modul im "src"-Verzeichnis mit den .NET-Projekten

• Kurmann.Videoschnitt.MediaFileWatcher.Application
• Kurmann.Videoschnitt.MediaFileWatcher.Module
• Kurmann.Videoschnitt.MediaFileWatcher.Entities
• Kurmann.Videoschnitt.MediaFileWatcher.Tests

SCI Module GitHub Workflow

Kurzname: scimodule-github-workflow

Features SCI GitHub Workflow

Das Template erzeugt eine GitHub Actions Workflow-Konfiguration (YAML-Datei), die für das Publizieren eines Service Collection Integrated Modules auf NuGet.org ausgelegt ist.

Anwendung SCI GitHub Workflow

dotnet new scimodule-github-workflow -o .

erzeugt folgende Verzeichnisstruktur im Arbeitsverzeichnis

working-directory/
└── .github/
    └── workflows/
        └── dotnet.yml

Hinweis: Die Namensgebung des Projektes mit -n Parameter hat keinen Einfluss auf die YAML-Datei und kann somit verzichtet werden.

SCI Module Visual Studio Code Debug Configuration

Kurzname: scimodule-vscode-debugconfig

Features SCI Module VS Code Config

Dieses Modul bietet eine vordefinierte Debug-Konfiguration für die Entwicklung eines Service Collection Integrated Modules in Visual Studio Code. Es umfasst sowohl launch.json als auch tasks.json, um das Debuggen und Ausführen von Aufgaben innerhalb der VSCode-Umgebung zu erleichtern.

Anwendung SCI Module VS Code Config

dotnet new scimodule-vscode-debugconfig -n Projektname -o .

erzeugt folgende Verzeichnisstruktur im Arbeitsverzeichnis

scimodule-vscode-debugconfig/
└── .vscode/
    └── launch.json
    └── tasks.json

Empfehlungen

Zum Erstellen eines kompletten Service Collection Integrated Moduls mitsamt Repository-Struktur wird die kombination der Templates scimodule, scimodule-github-workflow und scimodule-vscode-debugconfig empfohlen.

Bitte vorher zum Wurzelverzeichnis des neu erstellte GitHub-Repositorys wechseln.

Erstellt ein Service Collection Integrated Modul um "src"-Verzeichnis und erzeugt eine passende GitHub Actions Workflow-Konfiguration und eine passende vordefinierte Debug-Konfiguration für Visual Studio Code.

export PROJEKTNAME="MeinProjekt"
dotnet new scimodule -n $PROJEKTNAME -o src
dotnet new scimodule-github-workflow -o .
dotnet new scimodule-vscode-debugconfig -n $PROJEKTNAME -o .