Kephas.Data 11.1.0

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
dotnet add package Kephas.Data --version 11.1.0
NuGet\Install-Package Kephas.Data -Version 11.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Kephas.Data" Version="11.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Kephas.Data --version 11.1.0
#r "nuget: Kephas.Data, 11.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Kephas.Data as a Cake Addin
#addin nuget:?package=Kephas.Data&version=11.1.0

// Install Kephas.Data as a Cake Tool
#tool nuget:?package=Kephas.Data&version=11.1.0

Data

Introduction

Data is one of the most important parts of an application. To leverage working with it, Kephas provides an abstract data infrastructure which allows data manipulation (CRUD), validation and support for various behaviors.

The general architecture

All data operations are performed through a data context. The data context is responsible for holding and managing a local cache of data and for instantiating [[commands|Data-commands]]. The commands are actually the performers of data operations, integrate data behaviors, and are tightly coupled to the data context that created them.

Data contexts are created by a data context factory, which is a [[singleton application service|Application-services]], by providing a data store name. The factory uses configured data store information and associated services to get it and to initialize the data context.

The data context

The data context is the entry point in regard to data operations. Its main responsibilities are:

  • Query the data and retrieve the results. There are no restrictions regarding the implementation of the data querying, so it's up to the implementation to use, for example, a first or a second level cache. All the information controlling how the querying should be performed may be specified in the queryOperationContext parameter, which is an expando that can be customized freely.

  • Create the commands. As explained in the following, the strategy for creating the commands will choose the most appropriate one for the calling data context.

  • Provide entity information. This is information attached to each entity in the internal cache regarding its ID, change state, original data, and many more.

  • Attach and detach entities. These operations add/remove entities to/from the internal cache.

Apart from these, the data context:

  • is a contextual object: the consumers may access the [[ambient services|Application-Environment-and-Lifetime-Management#ambient-services]] and use the data context as an [[expando|Dynamic-expandable-objects-(expandos)]] object, dynamically adding and accessing values to it/from it.

  • is initializable and disposable: implements the IInitializable and IDisposable interfaces to control its lifetime.

The data context factory

Data contexts are dependent on initialization data, which typically contains at least data store connection information. Due to the fact that multiple physical data stores may be served by the same data context implementation and that by design, at one time, a data context instance may be connected to a single physical data store, there must be a factory service that creates a data context for a given connection. This is the data context factory application service.

  • CreateDataContext(dataStoreName, [initializationContext]): IDataContext: This is the only method of the factory service which creates a data context instance and initializes it.
    • dataStoreName: indicates the name of the data store. This identifies typically an entry in the configuration where connection information and other initialization data is provided.
    • initializationContext: provides contextual information for data context initialization.

Note: The consumer of the CreateDataContext method takes the full responsibility of disposing correctly the received data context.

The data commands

The [[data commands|Data-commands]] extend the data context functionality beyond the minimalist one defined by the IDataContext interface. Kephas provides built-in commands for the following data operations:

  • Create entity
  • Delete entity
  • Persist changes
  • Discard changes
  • Find by ID
  • Find by criteria

These operations provide the basic infrastructure for data manipulation, but for some scenarios this might not be enough. For example, update commands fired against all entities matching a specific criteria, calling stored procedures, or supporting all kinds of upsert variations are specific cases where there is no built-in support. With Kephas, the developer is free to define as many commands as needed, tailored for specific needs and data stores of all kinds. For a step-by-step tutorial, check the [[data commands|Data-commands]] page.

The IDataCommand interface and DataCommandBase base class

A data command has basically only one method: ExecuteAsync, which takes an operation context as parameters and returns a promise (task) of a result. The base interface to be implemented by a command is IDataCommand, which has its generic flavor IDataCommand<TOperationContext, TResult>. However, to ease the definition of commands, a base class DataCommandBase<TOperationContext, TResult> is provided, where only the generic ExecuteAsync method should be implemented.

    public interface IDataCommand
    {
        /// <summary>
        /// Executes the data command asynchronously.
        /// </summary>
        /// <param name="operationContext">The operation context.</param>
        /// <param name="cancellationToken">The cancellation token (optional).</param>
        /// <returns>
        /// A promise of a <see cref="IDataCommandResult"/>.
        /// </returns>
        Task<IDataCommandResult> ExecuteAsync(IDataOperationContext operationContext, CancellationToken cancellationToken = default(CancellationToken));
    }

    /// <summary>
    /// Contract for data commands, with typed operationContext and result.
    /// </summary>
    /// <typeparam name="TContext">Type of the operation context.</typeparam>
    /// <typeparam name="TResult">Type of the result.</typeparam>
    public interface IDataCommand<in TOperationContext, TResult> : IDataCommand
        where TOperationContext : IDataOperationContext
        where TResult : IDataCommandResult
    {
        /// <summary>
        /// Executes the data command asynchronously.
        /// </summary>
        /// <param name="operationContext">The operation context.</param>
        /// <param name="cancellationToken">The cancellation token (optional).</param>
        /// <returns>
        /// A promise of a <see cref="IDataCommandResult"/>.
        /// </returns>
        Task<TResult> ExecuteAsync(TOperationContext operationContext, CancellationToken cancellationToken = default(CancellationToken));
    }

Steps in implementing a data context command

Define the command application service contract

The data context uses composition to get an instance of the command to use, so the commands will provide an application service contract and one or more service implementations.

Multiple command implementations may be provided targeting specific data context implementations (different data context implementations may be provided for relational databases, NoSQL databases, or graph databases), so that the targeted data context finds the appropriate command to use. For example, a MongoDBFindOneCommand will indicate that it targets a MongoDBDataContext.

Note: When the data context creates the command through composition, it must get a new instance, otherwise unexpected behavior may occur. Therefore it is strongly discouraged to mark the application service contracts as shared.

Note: Together with the application service contract, the specific operation context type (where the input parameters will be provided) and the specific expected result type will be defined, if the command requires it. They must specialize the IDataOperationContext and IDataCommandResult respectively.

    /// <summary>
    /// Contract for find commands retrieving one entity based on a predicate.
    /// </summary>
    [AppServiceContract(AllowMultiple = true, 
                        MetadataAttributes = new[] { typeof(DataContextTypeAttribute) })]
    public interface IFindOneCommand : IDataCommand<IFindOneContext, IFindResult>
    {
        // AllowMultiple = true indicate that multiple implementations may be provided.
        // DataContextTypeAttribute as metadata attribute indicate that
        // the implementations may specify a target data context type.
    }

    /// <summary>
    /// Interface for data operation contexts of the <see cref="IFindOneCommand"/>.
    /// </summary>
    public interface IFindOneContext : IDataOperationContext
    {
        /// <summary>
        /// Gets the criteria of the entity to find.
        /// </summary>
        Expression Criteria { get; }

        /// <summary>
        /// Gets the type of the entity.
        /// </summary>
        Type EntityType { get; }

        /// <summary>
        /// Gets a value indicating whether to throw an exception if an entity is not found.
        /// </summary>
        bool ThrowIfNotFound { get; }
    }

    /// <summary>
    /// Generic interface for data operation contexts of the <see cref="IFindOneCommand"/>.
    /// </summary>
    /// <typeparam name="TEntity">Type of the entity.</typeparam>
    public interface IFindOneContext<TEntity> : IFindOneContext
    {
        /// <summary>
        /// Gets the criteria of the entity to find.
        /// </summary>
        /// <remarks>
        /// Overrides the untyped expression from the base interface
        /// to provide LINQ-support.
        /// </remarks>
        new Expression<Func<TEntity, bool>> Criteria { get; }
    }

    /// <summary>
    /// Interface for the find result.
    /// </summary>
    public interface IFindResult : IDataCommandResult
    {
        /// <summary>
        /// Gets the found entity or <c>null</c> if no entity could be found.
        /// </summary>
        object Entity { get; }
    }

Provide data context specific implementation of the command

After the service contract was defined, the service implementing it is created. For convenience, the base class DataCommandBase<TOperationContext, TResult> may be used.

Important: Do not forget to annotate the command service with the targeted data context type. The match is not exact, but done on a compatibility basis. This means that if a data context instantiating a command may find multiple being compatible with it (target compatible types, like the base type DataContextBase). The current strategy will choose the command targeting the most specific data context.

    /// <summary>
    /// Base class for find commands retrieving one result.
    /// </summary>
    [DataContextType(typeof(DataContextBase))]
    public class FindOneCommand : DataCommandBase<IFindOneContext, IFindResult>, IFindOneCommand
    {
        //... implement the command execution
    }

    // The command below targets a very specific data context, the MongoDataContext,
    // while the one above should work for all specializing the `DataContextBase`.

    /// <summary>
    /// Command for persisting changes targeting <see cref="MongoDataContext"/>.
    /// </summary>
    [DataContextType(typeof(MongoDataContext))]
    public class MongoPersistChangesCommand : PersistChangesCommand
    {
        //... implement the command execution
    }

Provide data context extension methods to make command consumption easier

Even if we are ready with the new command, it is not very handy to use it. Here is how we would use it now:

    var command = dataContext.CreateCommand<IFindOneCommand>();
    var findContext = new FindOneContext
                      {
                           Criteria = criteria,
                           ThrowIfNotFound = false,
                      }
    var result = await command.ExecuteAsync(findContext).PreserveThreadContext();
    var foundEntity = result.Entity;
    // yupee, got the entity! but it was a loooong way to get there :(.

So, to achieve the simplicity of simply calling the command on the data context, the next step would be to provide an extension method to wrap up all this stuff.

    public static class DataContextExtensions
    {
        //...

        public static async Task<T> FindOneAsync<T>(
            this IDataContext dataContext, 
            Expression<Func<T, bool>> criteria,
            bool throwIfNotFound = true,
            CancellationToken cancellationToken = default(CancellationToken))
            where T : class
        {
            Requires.NotNull(dataContext, nameof(dataContext));
            Requires.NotNull(criteria, nameof(criteria));

            var findOneContext = new FindOneContext<T>(dataContext, criteria, throwIfNotFound);
            var command = (IFindOneCommand)dataContext.CreateCommand(typeof(IFindOneCommand));
            var result = await command.ExecuteAsync(findOneContext, cancellationToken).PreserveThreadContext();
            return (T)result.Entity;
        }
    }

Now we can use the defined command as if it was a method of the data context:

    var foundEntity = await dataContext.FindOneAsync<Customer>(
                          c => c.Name == "John" && c.FamilyName == "Doe",
                          throwIfNotFound: false).PreserveThreadContext();
    // way better :)

Synchronous commands

Most data operations are by design asynchronous, but some do not need this overhead, for example because they work with data in the local cache, like marking entities for deletion or discarding the in-memory changes. For such data commands, they need to implement the ISyncDataCommand interface or, more comfortable, specialize SyncDataCommandBase.

Securing the data

Entity types may be secured by decorating them with the [SupportsPermission] attribute.

Example:

/// <summary>
/// The customer entity type.
/// </summary>
[SupportsPermission(typeof(IAdminPermission))]
public interface ICustomer : ...
{
}

Note: If a mixin declares supported permission types, all entity types inheriting that mixin will support those permissions, too.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (12)

Showing the top 5 NuGet packages that depend on Kephas.Data:

Package Downloads
Kephas.Data.Client The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides the infrastructure for the client area of the data flow. Typically used areas and classes/interfaces/services: - Queries: IClientQueryProcessor. Kephas Framework ("stone" in aramaic) aims to deliver a solid infrastructure for applications and application ecosystems.

Kephas.Data.Model The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides a modeling API framework for data. Typically used areas and classes/interfaces/services: - IEntityType, IKey. - Dimensions: Client (area), Domain (area). - AttributedModel: EntityAssemblyAttribute, EntityTypeAttribute, KeyAttribute, NaturalKeyAttribute, PrimaryKeyAttribute. - Analysis: ModelRefPropertiesBehavior. Kephas Framework ("stone" in aramaic) aims to deliver a solid infrastructure for applications and application ecosystems.

Kephas.Data.IO The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides services for the data import/export (input/output). Typically used areas and classes/interfaces/services: - DataStreams: IDataStreamReader, IDataStreamWriter. - Export: IDataExportService. - Import: IDataImportService, IDataImportBehavior. Kephas Framework ("stone" in aramaic) aims to deliver a solid infrastructure for applications and application ecosystems.

Kephas.Data.Endpoints The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Adds messaging endpoints for data services. The endpoints will work if Kephas.Messaging is referenced and the IMessageProcessor is used for processing the messages. Typically used areas and classes/interfaces/services: - PersistChangesHandler, QueryHandler, DataSourceHandler. Kephas Framework ("stone" in aramaic) aims to deliver a solid infrastructure for applications and application ecosystems.

Kephas.Data.MongoDB The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides the MongoDB implementation for data context and associated commands. Typically used areas and classes/interfaces/services: - MongoDataContext. Kephas Framework ("stone" in aramaic) aims to deliver a solid infrastructure for applications and application ecosystems.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
11.1.0 4,077 4/13/2022
11.1.0-dev.4 129 4/6/2022
11.1.0-dev.3 122 3/30/2022
11.1.0-dev.2 127 3/23/2022
11.1.0-dev.1 130 3/23/2022
11.0.0 3,982 3/11/2022
11.0.0-dev.7 132 3/7/2022
11.0.0-dev.6 132 2/28/2022
11.0.0-dev.5 118 2/26/2022
11.0.0-dev.4 120 2/24/2022
11.0.0-dev.3 122 2/23/2022
11.0.0-dev.2 127 2/18/2022
11.0.0-dev.1 127 2/7/2022
10.3.0 3,687 1/18/2022
10.2.0 2,959 12/3/2021
10.1.0 6,985 11/23/2021
10.1.0-dev.7 187 11/17/2021
10.1.0-dev.6 168 11/16/2021
10.1.0-dev.5 161 11/10/2021
10.1.0-dev.4 183 11/8/2021
10.1.0-dev.3 147 11/8/2021
10.1.0-dev.2 165 11/4/2021
10.1.0-dev.1 155 11/3/2021
10.0.1 2,996 10/16/2021
10.0.0 2,953 10/13/2021
10.0.0-dev.4 148 10/13/2021
10.0.0-dev.3 167 10/11/2021
10.0.0-dev.2 217 10/8/2021
9.3.4 2,815 8/25/2021
9.3.3 2,817 8/25/2021
9.3.2 2,753 8/24/2021
9.3.1 2,672 8/12/2021
9.3.0 2,837 8/12/2021
9.2.0 2,872 6/17/2021
9.1.0 2,810 6/17/2021
9.1.0-dev.9.1 195 5/28/2021
9.1.0-dev.9 191 5/26/2021
9.1.0-dev.8 181 5/26/2021
9.1.0-dev.7.1 182 5/17/2021
9.1.0-dev.7 193 5/17/2021
9.1.0-dev.6 174 4/28/2021
9.1.0-dev.5 191 4/23/2021
9.1.0-dev.4 178 4/21/2021
9.1.0-dev.3 189 4/17/2021
9.1.0-dev.2 159 4/12/2021
9.1.0-dev.1 178 4/9/2021
9.0.5 2,842 3/31/2021
9.0.4 2,871 3/23/2021
9.0.3 2,918 3/20/2021
9.0.1 2,914 3/18/2021
9.0.0 2,966 3/17/2021
9.0.0-dev.4 181 3/4/2021
9.0.0-dev.3 182 3/1/2021
9.0.0-dev.2 210 2/22/2021
8.4.0 3,668 11/11/2020
8.3.0 3,014 10/28/2020
8.2.0 3,087 10/16/2020
8.1.0 3,496 9/23/2020
8.0.0 5,037 7/1/2020
8.0.0-dev.44 281 6/25/2020
8.0.0-dev.43 270 6/23/2020
8.0.0-dev.42 308 6/22/2020
8.0.0-dev.41 311 6/18/2020
8.0.0-dev.40 260 6/18/2020
8.0.0-dev.39 281 6/15/2020
8.0.0-dev.38 388 6/14/2020
8.0.0-dev.37 242 6/13/2020
8.0.0-dev.36 300 6/13/2020
8.0.0-dev.35 240 6/12/2020
8.0.0-dev.34 290 6/12/2020
8.0.0-dev.33 341 6/10/2020
8.0.0-dev.32 260 6/1/2020
8.0.0-dev.31 287 6/1/2020
8.0.0-dev.30 347 5/30/2020
8.0.0-dev.28 291 5/28/2020
8.0.0-dev.27 267 5/15/2020
8.0.0-dev.26 262 5/14/2020
8.0.0-dev.25 275 5/14/2020
8.0.0-dev.24 267 5/13/2020
8.0.0-dev.23 267 5/13/2020
8.0.0-dev.22 266 5/13/2020
8.0.0-dev.21 269 5/12/2020
8.0.0-dev.20 273 5/12/2020
8.0.0-dev.19 273 5/7/2020
8.0.0-dev.18 265 5/7/2020
8.0.0-dev.17 273 5/6/2020
8.0.0-dev.16 266 5/6/2020
8.0.0-dev.15 269 5/5/2020
8.0.0-dev.14 259 5/5/2020
8.0.0-dev.13 293 5/4/2020
7.6.0-dev.13 286 5/1/2020
7.6.0-dev.12 294 4/30/2020
7.6.0-dev.11 275 4/28/2020
7.6.0-dev.10 256 4/27/2020
7.6.0-dev.9 269 4/24/2020
7.6.0-dev.8 259 4/22/2020
7.6.0-dev.7 261 4/15/2020
7.6.0-dev.6 256 4/15/2020
7.6.0-dev.5 248 4/15/2020
7.6.0-dev.4 248 4/11/2020
7.6.0-dev.3 258 4/10/2020
7.6.0-dev.2 253 4/10/2020
7.6.0-dev.1 351 4/8/2020
7.5.2 4,491 3/20/2020
7.5.1 2,869 3/12/2020
7.5.0 5,060 3/10/2020
7.5.0-dev.18 281 3/5/2020
7.5.0-dev.17 286 3/5/2020
7.5.0-dev.16 314 3/4/2020
7.5.0-dev.15 255 3/3/2020
7.5.0-dev.14 268 3/3/2020
7.5.0-dev.13 247 2/29/2020
7.5.0-dev.12 370 2/29/2020
7.5.0-dev.10 253 2/25/2020
7.5.0-dev.9 293 2/20/2020
7.5.0-dev.8 326 2/18/2020
7.5.0-dev.7 260 2/18/2020
7.5.0-dev.6 285 2/14/2020
7.5.0-dev.5 292 2/12/2020
7.5.0-dev.4 261 2/11/2020
7.5.0-dev.3 245 2/11/2020
7.5.0-dev.2 389 2/8/2020
7.5.0-dev.1 277 2/7/2020
7.4.2 3,325 2/5/2020
7.4.1 3,930 2/3/2020
7.4.0 4,013 1/31/2020
7.4.0-dev.4 328 1/31/2020
7.4.0-dev.3 311 1/29/2020
7.4.0-dev.2 256 1/28/2020
7.4.0-dev.1 258 1/23/2020
7.3.1 3,269 1/21/2020
7.3.1-preview.7 275 1/21/2020
7.3.1-preview.1 299 1/20/2020
7.3.0 3,214 1/19/2020
7.2.6 3,350 1/18/2020
7.2.5 3,382 12/19/2019
7.2.4 3,425 12/19/2019
7.2.3 3,335 12/16/2019
7.2.2 3,310 12/9/2019
7.2.1 3,359 12/4/2019
7.2.0 3,310 11/26/2019
7.2.0-preview.10 259 11/20/2019
7.2.0-preview.9 256 11/19/2019
7.2.0-preview.8 269 11/18/2019
7.2.0-preview.6 269 11/14/2019
7.2.0-preview.5 267 11/14/2019
7.2.0-preview.4 259 11/14/2019
7.2.0-preview.2 265 11/11/2019
7.2.0-preview.1 257 11/9/2019
7.1.0 3,218 11/6/2019
7.1.0-preview.8 276 11/5/2019
7.1.0-preview.7 272 11/4/2019
7.1.0-preview.6 277 11/1/2019
7.1.0-preview.5 285 10/31/2019
7.1.0-preview.4 292 10/30/2019
7.1.0-preview.3 282 10/26/2019
7.1.0-preview.2 276 10/25/2019
7.1.0-preview.1 263 10/24/2019
7.0.0 3,333 10/16/2019
7.0.0-rc.41 284 10/15/2019
7.0.0-rc.40 296 10/15/2019
7.0.0-rc.39 282 10/12/2019
7.0.0-rc.38 279 10/11/2019
7.0.0-rc.37 278 10/10/2019
7.0.0-rc.36 274 10/9/2019
7.0.0-rc.35 270 10/8/2019
7.0.0-rc.34 272 10/8/2019
7.0.0-rc.33 274 10/7/2019
7.0.0-rc.32 272 10/5/2019
7.0.0-rc.31 278 10/3/2019
7.0.0-rc.30 283 10/1/2019
7.0.0-rc.28 282 10/1/2019
7.0.0-rc.27 276 9/30/2019
7.0.0-rc.26 276 9/30/2019
7.0.0-rc.25 282 9/27/2019
7.0.0-rc.24 272 9/27/2019
7.0.0-rc.23 271 9/26/2019
7.0.0-rc.22 280 9/25/2019
7.0.0-rc.21 273 9/24/2019
7.0.0-rc.20 272 9/23/2019
7.0.0-rc.19 270 9/20/2019
7.0.0-rc.18.1 279 9/20/2019
7.0.0-rc.18 273 9/20/2019
6.5.0-rc.17 286 9/19/2019
6.5.0-rc.16 295 9/18/2019
6.5.0-rc.15 296 9/18/2019
6.5.0-rc.14.1 282 9/18/2019
6.5.0-rc.14 295 9/17/2019
6.5.0-rc.13 281 9/16/2019
6.5.0-rc.12.2 289 9/13/2019
6.5.0-rc.12.1 283 9/12/2019
6.5.0-rc.12 296 9/12/2019
6.5.0-rc.11 296 9/11/2019
6.5.0-rc.10 286 9/10/2019
6.5.0-rc.9 289 9/9/2019
6.5.0-rc.8 273 9/6/2019
6.5.0-rc.7 288 9/6/2019
6.5.0-rc.6 292 9/6/2019
6.5.0-rc.5 283 9/2/2019
6.5.0-rc.4 290 9/2/2019
6.5.0-rc.3 284 8/30/2019
6.5.0-rc.2 300 8/29/2019
6.5.0-rc.1 293 8/28/2019
6.5.0-beta.5 305 8/28/2019
6.5.0-beta.4 305 8/27/2019
6.0.0 3,050 8/6/2019
6.0.0-rc.7 294 7/19/2019
6.0.0-rc.6 290 6/28/2019
6.0.0-rc.5 279 6/28/2019
6.0.0-rc.4 278 6/25/2019
6.0.0-rc.3 294 6/20/2019
6.0.0-rc.2 298 5/29/2019
6.0.0-rc.1 297 5/28/2019
6.0.0-beta.3 294 4/17/2019
5.3.0-beta.2 302 3/21/2019
5.3.0-beta.1 292 3/20/2019
5.2.0 2,727 3/19/2019
5.1.0 3,028 1/25/2019
5.0.0 3,044 12/21/2018
5.0.0-rc11 2,161 12/14/2018
5.0.0-rc10 2,090 11/16/2018
5.0.0-rc09 2,060 11/1/2018
5.0.0-rc08 2,096 10/31/2018
5.0.0-rc07 2,116 10/31/2018
5.0.0-rc06 2,011 10/30/2018
5.0.0-rc05 1,987 10/29/2018
5.0.0-rc04 2,004 10/29/2018
5.0.0-rc03 2,049 10/26/2018
5.0.0-rc02 1,974 10/25/2018
5.0.0-rc01 2,014 10/12/2018
5.0.0-beta03 2,103 9/21/2018
5.0.0-beta02 2,100 9/10/2018
5.0.0-beta01 2,050 9/7/2018
4.5.1 1,881 8/7/2018
4.5.0 4,356 8/7/2018
4.5.0-rc01 1,943 6/7/2018
4.5.0-beta09 1,967 6/7/2018
4.5.0-beta08 2,029 5/16/2018
4.5.0-beta07 1,900 5/9/2018
4.5.0-beta06 1,956 4/25/2018
4.5.0-beta05 1,969 4/12/2018
4.5.0-beta03 1,945 4/12/2018
4.2.0-beta02 1,997 3/27/2018
4.2.0-beta01 1,932 2/14/2018
4.1.1 2,034 2/1/2018
4.1.0 3,268 1/15/2018
4.1.0-rc10 1,990 12/19/2017
4.1.0-rc09 2,074 12/19/2017
4.1.0-rc08 2,033 12/12/2017
4.1.0-rc07 1,855 12/5/2017
4.1.0-rc06 1,887 12/5/2017
4.1.0-rc05 1,889 12/5/2017
4.1.0-rc03 1,945 12/4/2017
4.1.0-rc02 1,901 12/4/2017
4.1.0-rc01 1,842 12/4/2017
4.1.0-beta09 1,871 12/3/2017
4.1.0-beta08 1,928 11/25/2017
4.1.0-beta07 1,894 11/23/2017
4.1.0-beta06 1,888 11/22/2017
4.1.0-beta05 1,890 11/21/2017
4.1.0-beta04 1,600 11/21/2017
4.1.0-beta03 1,522 11/17/2017
4.1.0-beta02 1,592 11/17/2017
4.0.1-beta01 1,612 11/6/2017
4.0.0 3,917 10/23/2017
4.0.0-rc05 1,856 10/17/2017
4.0.0-rc04 1,885 10/17/2017
4.0.0-rc03 1,877 10/12/2017
4.0.0-rc02 1,923 10/10/2017
4.0.0-rc01 1,862 10/6/2017
4.0.0-beta9 1,889 10/5/2017
4.0.0-beta8 1,850 10/5/2017
4.0.0-beta7 1,856 10/3/2017
4.0.0-beta6 1,832 9/30/2017
4.0.0-beta5 1,878 9/28/2017
4.0.0-beta4 1,925 9/27/2017
4.0.0-beta3 1,917 9/26/2017
4.0.0-beta2 1,868 9/25/2017
4.0.0-beta1 1,840 9/22/2017
3.11.0 2,666 8/18/2017
3.10.1 1,860 8/18/2017
3.10.0 3,387 8/1/2017
3.9.1 1,915 6/23/2017
3.9.0 3,275 6/13/2017
3.8.3 1,975 5/29/2017
3.8.2 1,882 5/29/2017
3.8.1 2,456 5/26/2017
3.8.0 2,464 5/26/2017
3.7.0 2,417 5/23/2017
3.6.1 1,968 5/19/2017
3.6.0 2,745 5/18/2017
3.5.0 2,794 5/15/2017
3.4.0 2,507 5/4/2017
3.3.6 1,916 4/13/2017
3.3.5 1,827 4/12/2017
3.3.1 1,928 4/12/2017
3.3.0 3,880 4/12/2017
3.3.0-preview1 1,670 4/6/2017
3.2.0 2,681 3/27/2017
3.1.0 2,354 3/22/2017
3.1.0-preview4 1,873 3/9/2017
3.1.0-preview3 1,636 12/9/2016
3.1.0-preview2 1,765 12/9/2016
3.1.0-preview1-rc2 1,753 10/31/2016
3.1.0-preview1 1,723 10/28/2016
3.0.9 1,959 10/19/2016
3.0.8 1,927 8/19/2016
3.0.7 2,096 7/12/2016
3.0.7-pre1 1,712 5/18/2016
3.0.0-rc6 1,688 3/29/2016
3.0.0-rc5 1,685 3/24/2016
3.0.0-rc4 1,787 3/21/2016
3.0.0-rc3 2,111 12/22/2015

Please check https://github.com/kephas-software/kephas/releases for the change log.
           Also check the documentation and the samples from https://github.com/kephas-software/kephas/wiki and https://github.com/kephas-software/kephas/tree/master/Samples.