CodeDesignPlus.Net.PubSub.Abstractions provides essential interfaces and abstract classes for implementing publish-subscribe patterns in .NET Core applications. This library defines core contracts and abstractions that facilitate a clean and maintainable architecture for event-driven systems, enabling better testing and extensibility.
About Me
Hello! I am an archetype designed to assist you in creating .NET Core libraries distributed as NuGet packages. I've been crafted with the best practices and common patterns in mind to make your life easier.
Key Features:
Options Pattern: I facilitate configuration and customization of your libraries using the options pattern.
Dependency Injection: I employ the mechanism of dependency injection to ensure effective decoupling and efficient service management. This not only eases testing and maintainability of your code but also promotes a modular and flexible structure.
Abstractions: With the interfaces and abstract classes I offer, you can develop decoupled and maintainable components.
Unit Tests: I include a dedicated project for unit tests, equipped with tools to validate data annotations, loggers, and more.
Node Utilities: I come packed with several Node.js utilities, like linters and Commitizen, to assist you in adhering to commit conventions.
Scripts and Dependencies:
In the package.json, I offer several handy scripts:
Tools: Install global .NET tools like dotnet-sonarscanner.
Installation: Restore necessary dependencies for your project.
Tests: Execute all unit tests.
Compilation: Compile your solution.
Formatting: Format your code to keep it neat and consistent.
Preparation: Set up husky, a tool to manage git hooks.
Furthermore, I integrate various dependencies and devDependencies to streamline version control, linting, and commit management, such as commitizen, husky, and lint-staged.
Built With
Efficient and maintainable software creation not only demands coding skills but also the right tools that fit our needs and streamline our workflow. The tools and technologies we employ often mirror our priorities in terms of efficiency, security, collaboration, and other pivotal aspects of software development. Below are the cornerstone tools and technologies that underpin this archetype:
.NET SDK 8: The necessary SDK for building applications in .NET SDK 8.
Node.js: A JavaScript runtime environment that enables server-side application development.
Visual Studio Community 2022: A comprehensive IDE tailored for .NET development.
VS Code: A lightweight yet powerful code editor with extensive extensibility capabilities.
This archetype comes with a preconfigured continuous integration pipeline, streamlining the automation of crucial tasks such as testing, building, packaging, and deployment. Thanks to this pipeline:
Full Automation: Tests and builds are automatically run with each push, ensuring the code meets quality standards.
Semantic Versioning Control: Using codedesignplus/semver-git-version, versions are automatically generated based on commits, ensuring coherent and predictable version management.
Code Quality: With integrated SonarQube, the code is analyzed for quality and security issues.
Automatic Publishing: Packages are automatically published to NuGet and GitHub Package Registry under certain conditions, making distribution straightforward.
Change Management: With tools like mikepenz/release-changelog-builder-action, a changelog is automatically created for each new version.
Beyond the continuous integration pipeline, this archetype brings several benefits that enhance and standardize the development and collaboration process:
Predefined Issue Templates: They simplify the creation of bug reports, new feature requests, security reports, and more, ensuring all necessary information is provided in a structured manner when creating a new issue.
Standardized Contribution: The CONTRIBUTING.md file offers clear guidelines for those wishing to contribute to the project.
Code of Conduct: CODE_OF_CONDUCT.md sets the norms to ensure a respectful and productive collaboration environment.
Code Owners: The CODEOWNERS file outlines those responsible for reviewing and approving changes.
Pull Request Template: Every new pull request will follow a defined structure, simplifying the review process.
Security Guidelines: SECURITY.md provides guidelines for reporting security vulnerabilities.
Bot Configuration: With files like issue_label_bot.yaml, tasks like auto-labeling issues based on their content can be automated.
License: LICENSE.md details how others can use or contribute to the project.
Getting Started
To dive into this archetype and set up your development environment, follow these steps:
For Visual Studio Community 2022:
Open the .sln file with Visual Studio Community 2022.
Select Build > Restore NuGet Packages from the menu to restore dependencies.
Compile the project by selecting Build > Build Solution.
Run the unit tests by selecting Test > Run All Tests.
To package, right-click on the project you wish to package and select Pack.
dotnet tool install --global dotnet-sonarscanner
dotnet restore
dotnet build
dotnet test
dotnet format
npm install
npm run prepare
dotnet pack -c Release /p:Version=1.0.0 # Ensure to set the appropriate version
Recommended Extensions for VS Code: These extensions enrich the development experience within VS Code:
AWS Toolkit
ESLint
GitLens
Prettier
GitHub Actions
Docker
C#
.NET Runtime
Remote Development (for containers, WSL, etc.)
CMake Tools & Extensions
Angular Console
Material Icon Theme
SonarLint
Lorem Ipsum
Conventional Commits
Usage
For more information regarding the library, you can visit our documentation at CodeDesignPlus Doc
Roadmap
Refer to issues for a list of proposed features and known issues.
Contributing
Fork the Project
Create your Feature Branch (git checkout -b features/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request
License
Distributed under the MIT License. See LICENSE for more information.
