👁 Image
Tenduke.Core 9.0.6

10Duke .NET core library

This repository contains the shared code between the 10Duke Enterprise and 10Duke Scale SDKs.

For more information please see the documentation.

Contents

• Why?
• Installation
• Development
• Getting involved
• Resources
• License

Why?

The 10Duke Enterprise and 10Duke Scale SDK client libraries both need similar functionality in areas such as authentication, configuration, handling HttpClient life-cycle.

In order to reduce complexity in those libraries, promote similar developer experience using those libraries, and reduce effort developing and maintaining those libraries, this project established a shared, core library that provides that functionality to both client libraries.

Supported runtimes

Tenduke.Core targets .NET Framework 4.7.2, .NET Standard 2.0, and whichever version of .NET are currently in standard and long term support (see the support policy for .NET for details).

Installation

Using the .NET Core command-line interface (CLI) tools:

dotnet add package Tenduke.Core

Using the NuGet Command Line Interface (CLI):

nuget install Tenduke.Core

Using the Package Manager Console:

Install-Package Tenduke.Core

From within Visual Studio:

Open the Solution Explorer. Right-click on a project within your solution. Click on Manage NuGet Packages... Click on the Browse tab and search for "Tenduke.Core". Click on the Tenduke.Core package, select the appropriate version in the right-tab and click Install.

For more information, refer to the documentation.

Accessing builds from gitlab package registry

To use nuget packages from the gitlab package registry, you need to add that registry as a nuget source.

dotnet nuget add source "https://gitlab.com/api/v4/projects/51515286/packages/nuget/index.json" \
 --name core --username <your_username> --password <your_token> --store-password-in-clear-text

Development

First download and install the .NET SDK. The latest version is recommended (currently version 9).

To get started with working on the code, clone this repository.

git clone git@gitlab.com:10Duke/core/dotnet-core.git

Then you need to install the tools and dependencies.

dotnet tool restore
dotnet restore .

The code can be build as follows

dotnet build

The tests can be run using

dotnet test

This will attempt to run the tests for all target .NET versions, including .NET Framework 4.7.2. That will not work on linux or macOS using the .NET SDK.

For linux or macOS, you can specify the .NET version to test with (dependent on the SDK version you are using).

dotnet test --framework NET9.0

or

dotnet test --framework NET10.0

For linux or macOS, a Makefile is provided to automate these, and other, development tasks.

Test output

Some of the unit tests (specifically for the LocalhostCallbackListener used in the Authorization code flow with PKCE), use the XUnit ITestOutputHelper to capture test output.

This can be useful to follow the flow of the asynchronous operations used in the tests to simulate the three-legged OAuth handshake.

To view the output when running the tests from the CLI, append --logger "console;verbosity=detailed" to the command, as follows:

dotnet test --framework NET10.0 --logger "console;verbosity=detailed"

Code formatting / linting

This project is using CSharpier for C# code formatting, .NET Roslyn Analyzers and Sonarlint for linting C# code, and markdownlint for linting markdown.

Releasing

To release a new version, the revision should be tagged in the format vMajor.minor.patch (for example v2.2.0) and the tag pushed.

This will build both the Tenduke.Core and Tenduke.Core.Tests nuget package and publish them to the project package registry. The packages can be downloaded from there and pushed to nuget.org (this step is manual).

Additionally the example projects should be updated to use the new version.

A script is provided to automate tagging the revision and updating the project files for the examples to use the new version of the nuget package.

If you want to create a new release from the current revision, then call it with the version number as a command line parameter:

./update-version.sh 2.2.3

The changes in ./examples/ will be left uncommitted for you to review and to add to a new revision.

Once you are happy, push the new tag. This will trigger a release being created in GitLab.

Getting involved

We welcome contributions! explains what kind of contributions we welcome.

Resources

• 10Duke Enterprise documentation
• 10Duke Scale documentation
• 10Duke.com - Find more information about 10Duke products and services

License

10Duke .NET core library is licensed under the license.