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

.NET 6.0 .NET Standard 2.1
Install-Package Kephas.Data -Version 11.1.0
dotnet add package Kephas.Data --version 11.1.0
<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
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Kephas.Data, 11.1.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. 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
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

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 Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.1
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
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.Model.Abstractions The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides data modeling abstractions. Typically used areas and classes/interfaces/services: - IIdentifiable, IGuidIdentifiable, INamed, ITagged, IHierarchyNode. 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 178 4/13/2022
11.1.0-dev.4 54 4/6/2022
11.1.0-dev.3 44 3/30/2022
11.1.0-dev.2 47 3/23/2022
11.1.0-dev.1 42 3/23/2022
11.0.0 161 3/11/2022
11.0.0-dev.7 49 3/7/2022
11.0.0-dev.6 49 2/28/2022
11.0.0-dev.5 45 2/26/2022
11.0.0-dev.4 50 2/24/2022
11.0.0-dev.3 48 2/23/2022
11.0.0-dev.2 51 2/18/2022
11.0.0-dev.1 49 2/7/2022
10.3.0 158 1/18/2022
10.2.0 778 12/3/2021
10.1.0 4,701 11/23/2021
10.1.0-dev.7 115 11/17/2021
10.1.0-dev.6 91 11/16/2021
10.1.0-dev.5 83 11/10/2021
10.1.0-dev.4 105 11/8/2021
10.1.0-dev.3 75 11/8/2021
10.1.0-dev.2 89 11/4/2021
10.1.0-dev.1 85 11/3/2021
10.0.1 707 10/16/2021
10.0.0 667 10/13/2021
10.0.0-dev.4 77 10/13/2021
10.0.0-dev.3 97 10/11/2021
10.0.0-dev.2 144 10/8/2021
9.3.4 624 8/25/2021
9.3.3 619 8/25/2021
9.3.2 597 8/24/2021
9.3.1 592 8/12/2021
9.3.0 615 8/12/2021
9.2.0 658 6/17/2021
9.1.0 655 6/17/2021
9.1.0-dev.9.1 115 5/28/2021
9.1.0-dev.9 112 5/26/2021
9.1.0-dev.8 103 5/26/2021
9.1.0-dev.7.1 98 5/17/2021
9.1.0-dev.7 105 5/17/2021
9.1.0-dev.6 94 4/28/2021
9.1.0-dev.5 111 4/23/2021
9.1.0-dev.4 110 4/21/2021
9.1.0-dev.3 107 4/17/2021
9.1.0-dev.2 84 4/12/2021
9.1.0-dev.1 106 4/9/2021
9.0.5 635 3/31/2021
9.0.4 677 3/23/2021
9.0.3 688 3/20/2021
9.0.1 664 3/18/2021
9.0.0 677 3/17/2021
9.0.0-dev.4 102 3/4/2021
9.0.0-dev.3 105 3/1/2021
9.0.0-dev.2 131 2/22/2021
8.4.0 998 11/11/2020
8.3.0 852 10/28/2020
8.2.0 897 10/16/2020
8.1.0 1,052 9/23/2020
8.0.0 1,627 7/1/2020
8.0.0-dev.44 206 6/25/2020
8.0.0-dev.43 192 6/23/2020
8.0.0-dev.42 223 6/22/2020
8.0.0-dev.41 227 6/18/2020
8.0.0-dev.40 179 6/18/2020
8.0.0-dev.39 208 6/15/2020
8.0.0-dev.38 317 6/14/2020
8.0.0-dev.37 174 6/13/2020
8.0.0-dev.36 228 6/13/2020
8.0.0-dev.35 168 6/12/2020
8.0.0-dev.34 209 6/12/2020
8.0.0-dev.33 262 6/10/2020
8.0.0-dev.32 183 6/1/2020
8.0.0-dev.31 208 6/1/2020
8.0.0-dev.30 276 5/30/2020
8.0.0-dev.28 216 5/28/2020
8.0.0-dev.27 191 5/15/2020
8.0.0-dev.26 181 5/14/2020
8.0.0-dev.25 204 5/14/2020
8.0.0-dev.24 187 5/13/2020
8.0.0-dev.23 185 5/13/2020
8.0.0-dev.22 189 5/13/2020
8.0.0-dev.21 195 5/12/2020
8.0.0-dev.20 195 5/12/2020
8.0.0-dev.19 193 5/7/2020
8.0.0-dev.18 190 5/7/2020
8.0.0-dev.17 190 5/6/2020
8.0.0-dev.16 192 5/6/2020
8.0.0-dev.15 187 5/5/2020
8.0.0-dev.14 189 5/5/2020
8.0.0-dev.13 213 5/4/2020
7.6.0-dev.13 214 5/1/2020
7.6.0-dev.12 219 4/30/2020
7.6.0-dev.11 199 4/28/2020
7.6.0-dev.10 183 4/27/2020
7.6.0-dev.9 189 4/24/2020
7.6.0-dev.8 185 4/22/2020
7.6.0-dev.7 186 4/15/2020
7.6.0-dev.6 183 4/15/2020
7.6.0-dev.5 178 4/15/2020
7.6.0-dev.4 188 4/11/2020
7.6.0-dev.3 191 4/10/2020
7.6.0-dev.2 192 4/10/2020
7.6.0-dev.1 278 4/8/2020
7.5.2 1,601 3/20/2020
7.5.1 849 3/12/2020
7.5.0 1,806 3/10/2020
7.5.0-dev.18 217 3/5/2020
7.5.0-dev.17 221 3/5/2020
7.5.0-dev.16 246 3/4/2020
7.5.0-dev.15 192 3/3/2020
7.5.0-dev.14 207 3/3/2020
7.5.0-dev.13 187 2/29/2020
7.5.0-dev.12 308 2/29/2020
7.5.0-dev.10 188 2/25/2020
7.5.0-dev.9 235 2/20/2020
7.5.0-dev.8 267 2/18/2020
7.5.0-dev.7 197 2/18/2020
7.5.0-dev.6 215 2/14/2020
7.5.0-dev.5 232 2/12/2020
7.5.0-dev.4 205 2/11/2020
7.5.0-dev.3 179 2/11/2020
7.5.0-dev.2 319 2/8/2020
7.5.0-dev.1 218 2/7/2020
7.4.2 1,067 2/5/2020
7.4.1 1,371 2/3/2020
7.4.0 1,406 1/31/2020
7.4.0-dev.4 264 1/31/2020
7.4.0-dev.3 244 1/29/2020
7.4.0-dev.2 199 1/28/2020
7.4.0-dev.1 196 1/23/2020
7.3.1 1,051 1/21/2020
7.3.1-preview.7 206 1/21/2020
7.3.1-preview.1 234 1/20/2020
7.3.0 1,063 1/19/2020
7.2.6 1,100 1/18/2020
7.2.5 1,072 12/19/2019
7.2.4 1,065 12/19/2019
7.2.3 1,029 12/16/2019
7.2.2 1,059 12/9/2019
7.2.1 1,085 12/4/2019
7.2.0 1,045 11/26/2019
7.2.0-preview.10 202 11/20/2019
7.2.0-preview.9 197 11/19/2019
7.2.0-preview.8 199 11/18/2019
7.2.0-preview.6 210 11/14/2019
7.2.0-preview.5 201 11/14/2019
7.2.0-preview.4 197 11/14/2019
7.2.0-preview.2 201 11/11/2019
7.2.0-preview.1 197 11/9/2019
7.1.0 1,055 11/6/2019
7.1.0-preview.8 215 11/5/2019
7.1.0-preview.7 210 11/4/2019
7.1.0-preview.6 216 11/1/2019
7.1.0-preview.5 219 10/31/2019
7.1.0-preview.4 231 10/30/2019
7.1.0-preview.3 216 10/26/2019
7.1.0-preview.2 213 10/25/2019
7.1.0-preview.1 201 10/24/2019
7.0.0 1,027 10/16/2019
7.0.0-rc.41 218 10/15/2019
7.0.0-rc.40 228 10/15/2019
7.0.0-rc.39 220 10/12/2019
7.0.0-rc.38 215 10/11/2019
7.0.0-rc.37 212 10/10/2019
7.0.0-rc.36 207 10/9/2019
7.0.0-rc.35 202 10/8/2019
7.0.0-rc.34 209 10/8/2019
7.0.0-rc.33 214 10/7/2019
7.0.0-rc.32 211 10/5/2019
7.0.0-rc.31 211 10/3/2019
7.0.0-rc.30 217 10/1/2019
7.0.0-rc.28 217 10/1/2019
7.0.0-rc.27 213 9/30/2019
7.0.0-rc.26 214 9/30/2019
7.0.0-rc.25 214 9/27/2019
7.0.0-rc.24 208 9/27/2019
7.0.0-rc.23 207 9/26/2019
7.0.0-rc.22 213 9/25/2019
7.0.0-rc.21 211 9/24/2019
7.0.0-rc.20 209 9/23/2019
7.0.0-rc.19 212 9/20/2019
7.0.0-rc.18.1 218 9/20/2019
7.0.0-rc.18 203 9/20/2019
6.5.0-rc.17 226 9/19/2019
6.5.0-rc.16 233 9/18/2019
6.5.0-rc.15 233 9/18/2019
6.5.0-rc.14.1 214 9/18/2019
6.5.0-rc.14 231 9/17/2019
6.5.0-rc.13 217 9/16/2019
6.5.0-rc.12.2 221 9/13/2019
6.5.0-rc.12.1 219 9/12/2019
6.5.0-rc.12 222 9/12/2019
6.5.0-rc.11 220 9/11/2019
6.5.0-rc.10 223 9/10/2019
6.5.0-rc.9 227 9/9/2019
6.5.0-rc.8 213 9/6/2019
6.5.0-rc.7 227 9/6/2019
6.5.0-rc.6 223 9/6/2019
6.5.0-rc.5 214 9/2/2019
6.5.0-rc.4 227 9/2/2019
6.5.0-rc.3 215 8/30/2019
6.5.0-rc.2 236 8/29/2019
6.5.0-rc.1 231 8/28/2019
6.5.0-beta.5 235 8/28/2019
6.5.0-beta.4 238 8/27/2019
6.0.0 977 8/6/2019
6.0.0-rc.7 228 7/19/2019
6.0.0-rc.6 229 6/28/2019
6.0.0-rc.5 217 6/28/2019
6.0.0-rc.4 218 6/25/2019
6.0.0-rc.3 227 6/20/2019
6.0.0-rc.2 233 5/29/2019
6.0.0-rc.1 228 5/28/2019
6.0.0-beta.3 233 4/17/2019
5.3.0-beta.2 237 3/21/2019
5.3.0-beta.1 227 3/20/2019
5.2.0 870 3/19/2019
5.1.0 1,169 1/25/2019
5.0.0 1,159 12/21/2018
5.0.0-rc11 899 12/14/2018
5.0.0-rc10 840 11/16/2018
5.0.0-rc09 801 11/1/2018
5.0.0-rc08 806 10/31/2018
5.0.0-rc07 807 10/31/2018
5.0.0-rc06 772 10/30/2018
5.0.0-rc05 764 10/29/2018
5.0.0-rc04 819 10/29/2018
5.0.0-rc03 771 10/26/2018
5.0.0-rc02 727 10/25/2018
5.0.0-rc01 794 10/12/2018
5.0.0-beta03 828 9/21/2018
5.0.0-beta02 835 9/10/2018
5.0.0-beta01 834 9/7/2018
4.5.1 717 8/7/2018
4.5.0 1,577 8/7/2018
4.5.0-rc01 887 6/7/2018
4.5.0-beta09 899 6/7/2018
4.5.0-beta08 984 5/16/2018
4.5.0-beta07 903 5/9/2018
4.5.0-beta06 940 4/25/2018
4.5.0-beta05 964 4/12/2018
4.5.0-beta03 914 4/12/2018
4.2.0-beta02 923 3/27/2018
4.2.0-beta01 913 2/14/2018
4.1.1 811 2/1/2018
4.1.0 1,366 1/15/2018
4.1.0-rc10 951 12/19/2017
4.1.0-rc09 1,031 12/19/2017
4.1.0-rc08 1,011 12/12/2017
4.1.0-rc07 846 12/5/2017
4.1.0-rc06 888 12/5/2017
4.1.0-rc05 851 12/5/2017
4.1.0-rc03 881 12/4/2017
4.1.0-rc02 901 12/4/2017
4.1.0-rc01 860 12/4/2017
4.1.0-beta09 892 12/3/2017
4.1.0-beta08 895 11/25/2017
4.1.0-beta07 892 11/23/2017
4.1.0-beta06 841 11/22/2017
4.1.0-beta05 840 11/21/2017
4.1.0-beta04 607 11/21/2017
4.1.0-beta03 598 11/17/2017
4.1.0-beta02 596 11/17/2017
4.0.1-beta01 627 11/6/2017
4.0.0 2,151 10/23/2017
4.0.0-rc05 827 10/17/2017
4.0.0-rc04 823 10/17/2017
4.0.0-rc03 830 10/12/2017
4.0.0-rc02 842 10/10/2017
4.0.0-rc01 844 10/6/2017
4.0.0-beta9 833 10/5/2017
4.0.0-beta8 870 10/5/2017
4.0.0-beta7 865 10/3/2017
4.0.0-beta6 843 9/30/2017
4.0.0-beta5 852 9/28/2017
4.0.0-beta4 853 9/27/2017
4.0.0-beta3 845 9/26/2017
4.0.0-beta2 842 9/25/2017
4.0.0-beta1 841 9/22/2017
3.11.0 1,056 8/18/2017
3.10.1 733 8/18/2017
3.10.0 1,380 8/1/2017
3.9.1 795 6/23/2017
3.9.0 1,407 6/13/2017
3.8.3 779 5/29/2017
3.8.2 759 5/29/2017
3.8.1 1,003 5/26/2017
3.8.0 970 5/26/2017
3.7.0 946 5/23/2017
3.6.1 759 5/19/2017
3.6.0 1,067 5/18/2017
3.5.0 1,103 5/15/2017
3.4.0 1,042 5/4/2017
3.3.6 755 4/13/2017
3.3.5 746 4/12/2017
3.3.1 767 4/12/2017
3.3.0 1,533 4/12/2017
3.3.0-preview1 707 4/6/2017
3.2.0 1,161 3/27/2017
3.1.0 980 3/22/2017
3.1.0-preview4 875 3/9/2017
3.1.0-preview3 753 12/9/2016
3.1.0-preview2 784 12/9/2016
3.1.0-preview1-rc2 732 10/31/2016
3.1.0-preview1 773 10/28/2016
3.0.9 824 10/19/2016
3.0.8 814 8/19/2016
3.0.7 987 7/12/2016
3.0.7-pre1 761 5/18/2016
3.0.0-rc6 719 3/29/2016
3.0.0-rc5 731 3/24/2016
3.0.0-rc4 826 3/21/2016
3.0.0-rc3 1,105 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.