equadrat.Framework.Core.Interfaces
6.3.2
Prefix Reserved
See the version list below for details.
dotnet add package equadrat.Framework.Core.Interfaces --version 6.3.2
NuGet\Install-Package equadrat.Framework.Core.Interfaces -Version 6.3.2
<PackageReference Include="equadrat.Framework.Core.Interfaces" Version="6.3.2" />
paket add equadrat.Framework.Core.Interfaces --version 6.3.2
#r "nuget: equadrat.Framework.Core.Interfaces, 6.3.2"
// Install equadrat.Framework.Core.Interfaces as a Cake Addin #addin nuget:?package=equadrat.Framework.Core.Interfaces&version=6.3.2 // Install equadrat.Framework.Core.Interfaces as a Cake Tool #tool nuget:?package=equadrat.Framework.Core.Interfaces&version=6.3.2
equadrat Framework Core
The idea of the equadrat Framework is to provide APIs to build applications with an architecture of highly decoupled components. Every single component, aspect or pattern is represented by interfaces. The framework provides a standard implementation for these but each type can be replaced by a custom implementation.
The framework is not about reimplementing components, but making them available using common interfaces.
Getting started
You can use most of the components by simply instantiating them. This is maybe the easiest way to evaluate the framework.
If you're using an IOC/DI container such as Microsoft Extensions DependencyInjection or if you want to use the built-in IOC framework, you can use the bootstrapper and bootstrapper modules to register the framework to the IOC.
Usage
Have a look at the example applications on my website: www.equadrat.net
Interesting components
This is a list of some (not all) components of the framework which might be interesting for you.
Architecture
- ICoreCommandFactory
- ICoreEventFactory
- ICoreEventHandlerInterruptRegistry
- ICoreInstancePoolFactory
- ICoreOwnerTokenFactory
- ICorePropertyObserverFactory
- ICoreSequenceDependencyTrackerFactory
- ICoreSuspendableRelayFactory
- ICoreSystemTimeProvider
Collections & Data
- ICoreBinaryOperationsHelper
- ICoreCollectionHelper
- ICoreCollectionFactory
- ICoreArrayList
- ICoreBinaryHeap
- ICoreList
- ICoreListSegment
- ICoreObservableCollection
- ICorePrioritizedQueue
- ICorePrioritizedStack
- ICorePolymorphList
- ICoreQueue
- ICoreReadOnlyList
- ICoreReadOnlyListSegment
- ICoreReadOnlyListWithExclusion
- ICoreReadOnlyObservableCollection
- ICoreStack
- ICoreCollectionObserverFactory
- ICoreCollectionMerger
- ICoreCollectionObserver
- ICoreCollectionSorter
- ICoreCollectionSplitter
- ICoreEmbeddedResourceAccessor
- ICoreHashProcessor
- ICoreHashProcessorProvider
- ICoreRandomDataProvider
- ICoreStringPatternPredicateFactory
- ICoreValueConverterFactory
IOC
- ICoreBootstrapper
- ICoreBootstrapperModule
- ICoreIOCFactory
- ICoreIOCInstanceFactory
- ICoreIOCInstanceProvider
- ICoreIOCRegistry
- CoreIOCRegistry
- CoreServiceCollectionWrapper & CoreServiceProviderWrapper
Reflection
- ICoreExpressionHelper
- ICoreReflectionHelper
Logging
- ICoreLoggingContext
- ICoreLoggingEvent
- ICoreLoggingProduct
- ICoreLoggingTarget
- CoreAppInsightsLoggingTarget
- CoreLoggingConsoleLogTarget
- CoreLoggingTextFileTarget
- CoreLoggingTraceLogTarget
- CoreNLogTarget
- CoreSerilogTarget
Serialization
- ICoreSerializer
- ICoreSerializerFormat
- CoreBsonNewtonsoftFormat
- CoreJsonDataContractFormat
- CoreJsonNewtonsoftFormat
- CoreProtobufFormat
- CoreXmlClassicFormat
- CoreXmlDataContractFormat
- ICoreSerializerProvider
Threading
- ICoreDispatcher
- CoreAvaloniaDispatcher
- CoreMauiDispatcher
- CoreThreadDispatcher
- CoreWpfDispatcher
- CoreXamarinFormsDispatcher
- ICoreLockFactory
- ICoreTaskFactory
- ICoreTaskQueue
- ICoreTaskScheduler
- ICoreThreadFactory
- ICoreThreadPool
Cryptography
- ICoreCryptographyAsymmetricCipherGenerator
- ICoreCryptographyAsymmetricCipherOperator
- ICoreCryptographyAsymmetricCipherOperatorProvider
- ICoreCryptographySigner
- ICoreCryptographySignerProvider
Licensing
- ICoreLicenseFactory
- ICoreLicenseOperator
- ICoreLicenseValidator
Native code & marshalling
- ICoreNativeLibraryLoader
Compatibility
The plan is to keep the equadrat Framework compatible to these .net versions as long as possible.
.net version | min | max |
---|---|---|
Core | 3.1 | ≥ 7.x |
Standard | 2.0 | ≥ 2.1 |
Framework | 4.6.2 | ≥ 4.8.x |
Version scheme and breaking changes
Version change | Scope |
---|---|
Major | Overhaul of the project |
Minor | Some types have changed |
Revision | Fully backward compatible |
Build | Set in preview versions only |
Additional documentation
You can find some guides regarding specific features on my website: www.equadrat.net
Feedback
You can contact me on my website: www.equadrat.net
License
Please respect the license and check equadrat.Framework.Core.License.md before using the package.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. 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 is compatible. 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 | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Microsoft.Bcl.AsyncInterfaces (>= 7.0.0)
- System.Buffers (>= 4.5.1)
- System.Memory (>= 4.5.5)
-
.NETStandard 2.1
- No dependencies.
-
net5.0
- No dependencies.
-
net6.0
- No dependencies.
-
net7.0
- No dependencies.
NuGet packages (71)
Showing the top 5 NuGet packages that depend on equadrat.Framework.Core.Interfaces:
Package | Downloads |
---|---|
equadrat.Framework.Core
A framework to extend the Microsoft .net framework with extra core functionality. |
|
equadrat.Framework.Mvvm.Interfaces
A framework to extend the Microsoft .net framework with extra mvvm functionality. |
|
equadrat.Framework.Mvvm
A framework to extend the Microsoft .net framework with extra mvvm functionality. |
|
equadrat.Framework.Core.Microsoft.Extensions.DependencyInjection
A framework to extend the Microsoft .net framework with extra core functionality. |
|
equadrat.Framework.Data.Interfaces
A framework to extend the Microsoft .net framework with extra data functionality. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
7.3.0 | 2,457 | 11/14/2024 |
7.2.1 | 2,935 | 9/21/2024 |
7.2.0 | 3,302 | 6/30/2024 |
7.1.0 | 3,586 | 4/20/2024 |
7.0.1 | 2,185 | 4/6/2024 |
7.0.0 | 2,082 | 4/1/2024 |
6.4.4 | 1,720 | 3/16/2024 |
6.4.3 | 1,602 | 3/9/2024 |
6.4.2 | 2,041 | 3/3/2024 |
6.4.1 | 1,395 | 2/10/2024 |
6.4.0 | 2,469 | 12/30/2023 |
6.3.5 | 1,141 | 12/25/2023 |
6.3.4 | 1,561 | 12/5/2023 |
6.3.3 | 2,452 | 11/15/2023 |
6.3.2 | 1,703 | 10/21/2023 |
6.3.1 | 1,606 | 10/7/2023 |
6.3.0 | 2,104 | 10/1/2023 |
====
v6.3.2
====
- Added overloads for hash processors to support more data types.
- Added overloads for cryptographic signers to support more data types.
- Assigned EnumMemberAttribute to eCoreTriState fields to be compatible to (nullable) boolean.
====
v6.3.1
====
- Added overloads for cryptographic signers and operators to support more data types.
- Added more cryptographic signer algorithms to be registered by default.
- Added base interface and base class for ICoreSecureArray which is used by ICoreSecureString too.
- Added SkipDisposeOnFinalize method to ICoreSecureArray.
- Fixed issue in README file.
====
v6.3.0
====
- Implement separate project for cryptographic signing.
- Refactored Core.Licensing to use Core.Cryptography.
- Added ICoreLoggingTimeFormatterProperties to ICoreLoggingEntryFixedTextFormatter and ICoreLoggingEntryFloatingTextFormatter to make them configurable.
- Refactored ICoreSerializerLengthPrefixProcessor to support asynchronous read-/write-methods.
- Added ICoreVarIntHelper to read and write VarInt values.
- Added CoreSerializerLengthPrefixVarIntProcessor to use VarInt for serialization.
- Extended CoreStringWriter and refactored some serializers to use ArrayPool when writing data to the stream.
- Extended ICorePolymorphList to support a shared state used by multiple instances.
- Extended CorePolymorphList to support a custom convert callback for items.
- Extended ICoreCollectionFactory to support new options for ICorePolymorphList.
- Refactored ICoreSerializerLengthPrefixProcessorProvider to use CoreSerializerRepresentation instead of eCoreSerializerRepresentation.
- Made eCoreSerializerRepresentation obsolete.
- ICoreReflectionHelper.GetKnownTypes considers the first inheritance level of KnownTypeAttribute assignments on classes only.
====
v6.2.0
====
- Refactored CoreSharedWaitHandle to CoreWaitHandle.
- Extended ICoreLockFactory by adding a parameter to specify whether to use slim or regular wait handles.
- Extended ICoreLockFactory by adding a parameter to specify whether to use shared or dedicated wait handles.
- Extended ICoreLockFactory to create wrappers for WaitHandles.
====
v6.1.2
====
- Added virtual Core(Async|Hybrid)DisposableSlim.UseStrictDispose property which returns false by default. Strict dispose means that any other call to Dispose(Async) after the first call will throw an exception.
====
v6.1.1
====
- Fixed LockRecursionException in CoreLifetimeLockSlim implementation if an action was registered to its CancellationToken which accessed the lifetime lock again.
====
v6.1.0
====
- Added ICoreAsyncObserver and ICoreAsyncObservable.
- Added extension methods to wrap the core interfaces to the native interfaces.
- Added extension methods to easily forward CancellationToken cancellations to other CancellationTokenSources/CancellationTokens.
- Added CoreLifetimeLock to easily handle the lifetime of an instance while it is used.
- Extended CoreSharedWaitHandle by adding IDisposable implementation.
- Added ICoreDisposableSlim and ICoreDisposableSlim to have a base class without events.
- Added CoreHybridDisposableSlim as a base class which implements ICoreDisposable and ICoreAsyncDisposable.
- Changed base class of CoreSemaphoreSlim to CoreDisposableSlim.
- Refactored ICoreDisposable and ICoreAsyncDisposable to base on the slim versions.
- Made ICoreIOCInstance obsolete.
- Improved performance of CoreQueue.Enqueue(IEnumerable<T> items) if items is of type ICollection<T>.
- Added System.Buffers as package reference for .net Standard 2.0.
====
v6.0.9
====
- Fixed bug in CoreProtobufTypeModelBuilder of CoreProtobufSerializer to register implicitly linked known types to the type model.
- Added Freeze option to CoreProtobufSettings to not freeze the type model.
====
v6.0.8
====
- Added ICoreLoggingContext.Attach overload with predicate for ICoreLoggingEntry.
- Extended ICoreLoggingEventParametersOverride to support overriding custom event properties.
- Implemented ICoreAsyncQueue and ICoreAsyncPrioritizedQueue as implementations of IAsyncEnumerable.
- Extended ICoreCollectionFactory to create instances of ICoreAsyncQueue and ICoreAsyncPrioritizedQueue similar to ICoreQueue and ICorePrioritizedQueue.
- Added ICoreSerializerOptions to configure a serializer, i.e. specify a callback to convert a model before serialization.
- Extended ICoreSerializerProvider and ICoreSerializerFormat to support ICoreSerializerOptions.
- Fixed CoreFrameworkIocBootstrapperModule.InitIocHelper to check CoreIOCHelper.CanSetResolver first.
- Improved Core...Exceptions to provide more information.
- Extended CoreReadOnlyObservableCollection<> to support IList and IList<>.
- Upgraded Avalonia UI NuGet package references to v11.x.
- Upgraded Portable.BouncyCastle v1.x NuGet package references to BouncyCastle.Cryptography v2.x.
====
v6.0.7
====
- Enabled IL trimming.
- Added README.md file to the NuGet package.
====
v6.0.6
====
- Added overload of ICoreLoggingEvent.WithProperty(IEnumerable<ValueTuple>).
- Refactored ambiguous constructors of CoreLicense[...] classes by adding static factory methods instead.
====
v6.0.5
====
- Added overloads to register logging products and events using a single options parameter.
- Added support to specify custom properties for logging events on register or when logging.
- Added workaround for ambiguous reference when using CoreEnumerableExtensions.AsReadOnly with IDictionary and .net 7+.
====
v6.0.4
====
- Added base class for loggers.
====
v6.0.3
====
- Fixed bug in the Microsoft.Extensions.DependencyInjection wrappers when registering (singleton/scope) routes.
- Fixed bug in the Microsoft.Extensions.DependencyInjection wrappers when using an instance provider.
====
v6.0.2
====
- Fixed bug in the bootstrapper module initialization logic.
====
v6.0.1
====
- Added wrappers for Microsoft.Extensions.DependencyInjection to let IServiceCollection work as ICoreIOCRegistry and to let IServiceProvider work as ICoreIOCFactory.
- Added parameterless overload of ICoreBootstrapper.Startup to access a two-step fluent API to support DI-containers which use the builder pattern (i.e. Microsoft.Extensions.DependencyInjection).
- Renamed CoreFrameworkBootstrapperModulesSelector to CoreFrameworkBootstrapperModuleSelector.
- Added SessionId to ICoreLoggingContext and ICoreLoggingEntry to provide a unique identifier for the current (source) session of a logging entry.
- Added ICoreLoggingSessionIdProvider to generate session identifiers.
- Extended logging targets for Application Insights, NLog and Serilog to passthrough ICoreLoggingEntry.SessionId.
- The Application Insights logging target will use trace telemetry for logging entries without exception.
====
v6.0.0
====
- Initial Release