KinghornJa.Core 0.0.8.9

Kinghorn.NET Core Library

NuGet Package

The Kinghorn Core Library is a powerful and versatile software library designed exclusively for internal use by apps owned by Kinghorn & Kinghorn. This comprehensive library serves as a foundational building block for developing robust and efficient applications within the company's ecosystem.

Purpose

The primary purpose of the Kinghorn Core Library is to provide a standardized set of functionalities, components, and utilities that can be shared and utilized across multiple internal applications. By leveraging this library, development teams can accelerate the app development process, ensure consistent implementation, and enhance overall code quality.

Feature Targets

• Modular Architecture: The library is organized into modular components, allowing developers to selectively import and use only the required functionalities. This promotes code reusability and facilitates efficient application development.
• Common Utilities: The Kinghorn Core Library offers a wide range of common utilities, such as data manipulation, error handling, logging, and authentication mechanisms. These utilities are meticulously crafted to meet the specific requirements of Kinghorn & Kinghorn applications, streamlining development workflows and reducing redundant code.
• Design Patterns and Best Practices: The core library incorporates industry-proven design patterns and best practices to encourage scalable, maintainable, and efficient application development. By following these established guidelines, developers can ensure consistent code structure and foster codebase longevity.
• Security and Compliance: Security is a top priority for Kinghorn & Kinghorn, and the Kinghorn Core Library integrates robust security measures and compliance standards. It provides secure data handling, input validation, and encryption capabilities, ensuring that applications built using the library adhere to stringent security protocols.
• Documentation and Support: The Kinghorn Core Library is accompanied by comprehensive documentation, including usage guidelines, API references, and code examples. This documentation empowers developers to leverage the library effectively and efficiently. Additionally, the library is supported by a dedicated team that provides assistance and resolves queries related to its implementation and usage.

Requirements

To utilize the Kinghorn Core Library, developers should have a working knowledge of C# programming language and the .NET Core framework. The library is specifically designed for .NET Core 7, ensuring compatibility and optimal performance with this version.

Getting Started

To get started with the Kinghorn Core Library, refer to the provided documentation for installation instructions, usage guidelines, and code samples. Developers can import the library into their C# (.NET Core 7) projects and begin leveraging its functionalities to accelerate development and ensure consistency across Kinghorn & Kinghorn applications.

.NET Core 7 Installation

1. To add the Kinghorn Core Library to your project simply copy the <ItemGroup> below and add it to your {PROJECT_NAME} .csproj

   <ItemGroup>
   
        <PackageReference Include="KinghornJa.Core" Version="x.x.x" />
   
   </ItemGroup>
   

2. Replace Version="x.x.x" with the version number of the library you want.

3. Install the packages with the restore command.

   dotnet restore
   

Feedback and Contributions

Report an Issue

Kinghorn & Kinghorn welcomes feedback, suggestions, and contributions from internal developers to enhance the core library further. Developers are encouraged to participate in the ongoing development and improvement of the library by submitting bug reports, feature requests, or pull requests via the designated channels.

By leveraging the Kinghorn Core Library, developers can build robust and efficient internal applications in C# (.NET Core 7) that align with the company's standards and requirements.

Change Log

• 2023-05-18 → Completed implementation of JsonStore. [0.0.4]

• 2023-05-22 → Added StringExtensions. [0.0.5]

  • ToMd5() for quick md5 hashing of strings.

• 2023-05-28 → Added DateTimeExtensions. [0.0.5.1]

  • RelativeDateTime() returns a string representation a relative date or time from now.

• 2023-05-31 → Added Messaging. [0.0.6]

  • Added EmailSender for Email dissemination.
  • Added GoogleSpaceBot for Google Workspace Notifications.
  • Added SmsSender for SMS dissemination.

• 2023-06-02 → Added to StringExtensions [0.0.6]

  • Added GetGravatar returns a gravatar avatar URL.
  • Adjusted Namespaces of Mesaging senders. [0.0.6.1]
  • Added WhatsAppSender for dissemination via WhatsApp. [0.0.7]
    • Added support for WhatsAppTextMessage.
    • Added support for WhatsAppImageMessage.

• 2023-06-06 → Progressed Implementation of senders. [0.0.8]

  • Added AddEmailSender Extension for Dependency Injection.
  • Added AddGoogleSpaceBot Extension for Dependency Injection.
  • Added AddSmsSender Extension for Dependency Injection.
  • Added AddWhatsAppSender Extension for Dependency Injection.
  • Converted EmailSender from a static class to a service.
  • Converted GoogleSpaceBot from a static class to a service.
  • Converted SmsSender from a static class to a service.
  • Improved WhatsAppSender service implementation.
  • Added Documentation for EmailSender.
  • Added Documentation for GoogleSpaceBot.
  • Added Documentation for SmsSender.
  • Added Documentation for WhatsAppSender.
  • Added Rudementary implementation of WhatsAppRecieverController.

• 2023-06-08 → BugFix: StringExtensions.GetGravatar. [0.0.8.1]

• 2023-06-11 → Updated Messaging. [0.0.8.2]

  • Updated EmailSenderOptions to accept an IConfigurationSection.

• 2023-07-06 → Updated EmailMessage options. [0.0.8.3]

  • Added Cc to EmailMessage.
  • Added Bcc to EmailMessage.

• 2023-08-09 → Updated EmailSender options. [0.0.8.4]

  • Added EmailSender.Send accepts MailMessage.

• 2023-09-28 → Added Identity. [0.0.8.5]

  • Added LoginEntity, ResetPasswordEntity
  • Added ClaimsPrincipalExtension.GetClaimValue
  • Added ClaimsIdentityExtension.GetClaimValue, ClaimsIdentityExtension.GetDisplayName
  • Added MoneyHelper to tools
  • Added core entities for general use. Usually extended by common db models

• 2024-01-01 → Added Identity. [0.0.8.6]

  • skipping version forward during the transtion of the project management

• 2024-01-01 → Added Identity. [0.0.8.7]

  • Added IdentityService and webbuilder extensions

• 2024-02-06 → Updated Identity. [0.0.8.8]

  • Added IdentityUser
  • Added IdentityService.GetUserAsync, IdentityService.RegisterLoginAsync

• 2024-02-21 → [0.0.8.9]

  • Update webbuilder to inject an EmailSender instance directly, not just the IMessagerSender<EmailSender>
  • Fixed EmailSender bug which tried to add nul CC, BCC addresses