OwlCore 0.0.37

There is a newer version of this package available.
See the version list below for details.
dotnet add package OwlCore --version 0.0.37                
NuGet\Install-Package OwlCore -Version 0.0.37                
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="OwlCore" Version="0.0.37" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add OwlCore --version 0.0.37                
#r "nuget: OwlCore, 0.0.37"                
#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 OwlCore as a Cake Addin
#addin nuget:?package=OwlCore&version=0.0.37

// Install OwlCore as a Cake Tool
#tool nuget:?package=OwlCore&version=0.0.37                

Have you ever seen an owl do a barrel roll? Me neither.

OwlCore is in a rapid development cycle and is constantly being improved upon. Until a stable release, breaking changes can happen any time. Comprehensive changelogs included with every release.

Our favorite features:
- .NET Standard 2.0 - Battle-tested on Uno Platform and UWP, for both hobby and enterprise-level applications.
- OwlCore.Remoting - Painlessly sync member changes in C# with an external source via magic (reflection + IL weaving).
- AbstractUI - Abstracts simple UI elements as pure data. Send over a network, store on disk, share between platforms, etc. Make something else worry about rendering and interacting. (Optional OwlCore.Remoting integration)
- AbstractStorage - Abstract away your storage needs for easy implementation switching and unit test mocking. Based on the Windows StorageFile APIs, designed to be completely agnostic of any underlying platform or protocol.
- Flow.Debouncer - For when something fires repeatedly. but you only care about when it stops.
- Flow.EventAsTask - Wait for an EventHandler to fire (with cancellation).
- Flow.EasySemaphore - Use a "using" statement with your semaphores instead of manually calling WaitAsync and Release.
- Threading.PrimaryContext -  Use a "using" statement to execute on your main thread. No dispatcher, callbacks or cleanup needed.
- Threading.OnPrimaryThread - Easily invoke a callback on your primary thread.
- CachedHttpClientHandler - Cache http requests to disk and return them as needed. Supports chaining.
- RateLimitedHttpClientHandler - Limit the number of requests within a window of time. Supports chaining.
- Countless extension methods. PruneNull, Shuffle, InParallel, ChangeDate, HashMD5Fast, DistinctBy, InsertOrAdd, and more.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  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 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 was computed. 
.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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on OwlCore:

Package Downloads
CoptLib

A .NET Standard 2.0 library made to handle scenarios involving documents with interdependencies and multilingual content.

StrixMusic.Sdk

An open music standard that breaks down the walls between services by defining a standardized and highly flexible API surface.

OwlCore.AbstractUI

Package Description

StrixMusic.Cores.Storage

Use any OwlCore.Storage implementation as a music source.

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on OwlCore:

Repository Stars
yoshiask/FluentStore
A unifying frontend for Windows app stores and package managers
Arlodotexe/strix-music
Combine any music sources into a single library. It's your music. Play it your way.
Version Downloads Last updated
0.6.1 437 9/14/2024
0.6.0 937 7/23/2024
0.5.0 912 3/18/2024
0.4.1 2,827 11/14/2023
0.4.0 2,330 5/13/2023
0.3.0 264 5/13/2023
0.2.1 777 2/23/2023
0.2.0 276 2/22/2023
0.1.0 7,475 9/12/2022
0.0.71 4,538 6/19/2022
0.0.70 754 6/10/2022
0.0.69 469 6/10/2022
0.0.68 461 6/7/2022
0.0.67 479 6/5/2022
0.0.66 1,113 5/3/2022
0.0.65 559 4/14/2022
0.0.64 524 4/11/2022
0.0.63 534 4/3/2022
0.0.62 499 4/2/2022
0.0.61 990 3/31/2022
0.0.60 489 3/28/2022
0.0.59 483 3/28/2022
0.0.58 542 3/20/2022
0.0.57 476 3/19/2022
0.0.56 472 3/18/2022
0.0.55 477 3/17/2022
0.0.54 467 3/12/2022
0.0.53 480 3/10/2022
0.0.52 487 3/10/2022
0.0.51 489 3/4/2022
0.0.50 477 3/3/2022
0.0.49 579 2/9/2022
0.0.48 511 2/2/2022
0.0.47 506 2/2/2022
0.0.46 492 2/2/2022
0.0.45 525 2/1/2022
0.0.44 484 1/23/2022
0.0.43 456 12/19/2021
0.0.42 354 12/19/2021
0.0.41 314 12/16/2021
0.0.40 524 12/13/2021
0.0.39 358 12/10/2021
0.0.38 498 12/9/2021
0.0.37 3,156 11/24/2021
0.0.36 5,410 11/24/2021
0.0.35 362 11/22/2021
0.0.34 713 11/21/2021
0.0.33 390 11/12/2021
0.0.32 468 11/11/2021
0.0.31 375 11/10/2021
0.0.30 409 10/28/2021
0.0.29 389 10/27/2021
0.0.28 379 10/13/2021
0.0.27 374 10/13/2021
0.0.26 371 10/12/2021
0.0.25 402 10/12/2021
0.0.24 364 9/23/2021
0.0.23 435 9/10/2021
0.0.22 409 9/8/2021
0.0.21 427 7/16/2021
0.0.20 367 7/15/2021
0.0.19 404 7/14/2021
0.0.18 427 7/7/2021
0.0.17 378 7/6/2021
0.0.16 372 7/6/2021
0.0.15 408 7/6/2021
0.0.14 379 7/6/2021
0.0.13 364 7/5/2021
0.0.12 446 6/28/2021
0.0.11 414 6/28/2021
0.0.10 405 6/24/2021
0.0.9 422 6/23/2021
0.0.8 462 6/23/2021
0.0.7 403 6/23/2021
0.0.6 435 5/17/2021
0.0.5 433 5/17/2021
0.0.4 427 5/17/2021
0.0.3 425 5/17/2021
0.0.2 448 5/2/2021
0.0.1 401 3/31/2021

--- 0.0.37 ---
[Fixes]
Fixed an issue where updating OwlCore in existing apps could result in the error "error CS1705: Assembly 'OwlCore' with identity 'OwlCore, Version=0.0.36.0, Culture=neutral, PublicKeyToken=null' uses 'System.Runtime, Version=5.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' which has a higher version than referenced assembly 'System.Runtime' with identity 'System.Runtime, Version=4.2.1.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'

--- 0.0.36 ---
[Fixes]
Fixed issues with the RemoteLock extension methods for MemberRemote. Added Unit Tests.
Fixed an issue where DataProxy extension methods would not scope to the given member remote. Added Unit Tests.
Fixed an issue where DataProxy was unable to send null values. Added Unit Tests for null, primitives, structs and objects.

--- 0.0.35 ---
[Fixes]
Fixed several issues with EnumerableExtensions.ChangeCollection, and added unit tests around it.

--- 0.0.34 ---
[New]
New logo!

[Improvements]
Made MemberRemote.IsAllowedRemotingDirection public. Given the current mode, it checks if the given memberInfo allows data to flow in a certain direction.
Fixed docs on RemoteDataMessage.TargetMemberSignature.
Added Unit Tests to the DataProxy extension methods for MemberRemote.

[Fixes]
Fixed an issue where the MemberRemote.PublishDataAsync extension method used the signature scope from the MemberRemote for data, instead of AssemblyQualifiedName.
Fixed an issue where MemberRemote.PublishDataAsync returned always nullable.

[Breaking changes]
The PublishDataAsync extension method for MemberRemote now takes the call token as the first parameter instead of the second.

--- 0.0.33 ---
[Improvements]
CompositeHttpClientHandler, CompositeHttpClientHandlerActionBase, RateLimitedHttpClientHandlerAction, and CachedHttpClientHandlerAction will be deprecated and removed in a future version.
CachedHttpClientHandler now supports proper chaining as a System.Net.Http.DelegatingHandler.
RateLimitedHttpClientHandler now supports proper chaining as a System.Net.Http.DelegatingHandler.

[Breaking changes]
Removed dependency on Nito.AsyncEx.Coordination. If you were using this as a transitive dependency, install this package in your projects directly.

[Fixes]
Fixed an issue where MemberRemote wasn't fully disposed until the finalizer was called.

--- 0.0.32 ---
[New]
Added Flow.EasySemaphore() and unit tests. Provides syntactic sugar for releasing a SemaphoreSlim when execution leaves a using statement.

[Improvements]
IRemoteMessageHandler is now only initialized once while maintianing proper concurrency.
Better docs for SetPrimarySynchronizationContext and SetPrimaryThreadInvokeHandler.

--- 0.0.31 ---
[New]
Added OwlCore.Provisos.ILauncher for delegating the launch of Urls and more.

[Improvements]
Added Unit Testing to OwlCore.Remoting.MemberRemote - about 5,520 possible usage combinations (~30% coverage).
Added Unit Testing to OwlCore.Remoting.Transfer.MessageConverters.NewtonsoftRemoteMessageConverter - about 150 combinations (~70% coverage).

[Breaking changes]
To keep things clean for devs, classes in OwlCore.Remoting.Attributes and OwlCore.Remoting.EventArgs have been moved to OwlCore.Remoting.

--- 0.0.30 ---
[New]
Added ReplaceOrAdd extension method for IList{T}. Behaves the same as InsertOrAdd, but replaces at the given index if it exists.
Added Pop extension method for IList{T}. Removes and returns the last item in the list.

[Breaking changes]
InsertOrAdd and InsertOrAddRange now properly throw ArgumentOutOfRangeException when index is less than -1.

[Improvements]
We've started adding unit tests to OwlCore behind the scenes. Development of [New] features is now test driven and existing code will get tests added over time.

--- 0.0.29 ---
[New]
Added InsertOrAddRange extension method. Behaves the same as InsertOrAdd, but allows an adding or inserting an enumerable at a specific index.

[Improvements]
Added CachedRequestFound and CachedRequestSaving relay from CachedHttpClientHandlerAction to CachedHttpClientHandler.
NotNullIfNotNullAttribute and NotNullAttribute are now transitive dependencies from Microsoft.Toolkit.Mvvm

[Improvements, Breaking changes]
Added MemberSignatureScope to OwlCore.Remoting.Transfer.IRemoteMessageHandler to allow sending/receiving member changes in different assemblies, namespaces, or class names. Previously restricted to 1:1 matches of assembly, namespace and class name.
Added AssemblyQualifiedName property to RemotePropertyChangeMessage and adjusted constructor signature, as TargetMemberSignature is no longer guaranteed to match AssemblyQualifiedName.
Due to the MemberSignatureScope changes, if you've saved any values for IRemoteMemberMessage.TargetMemberSignature, they may not match values generated by this version.
The static method MemberRemote.CreateMemberSignature() now requires a second parameter specifying MemberSignatureScope. Previous default behavior was MemberSignatureScope.AssemblyQualifiedName.
OwlCore.Services.IInstanceCacheRepository.HasId() was added for checking if a specific instance Id exists in the repository.
OwlCore.AbstractStorage.IFileData.GetThumbnailAsync added for getting the thumbnail images from a file according to specified settings.
OwlCore.Remoting.Transfer.IRemoteMessageHandler.MessageConverter is now nullable.

[Fixes]
Fixed an issue with OwlCore.Remoting where non-primitive property changes and method parameters were treated as primitive during internal type conversion and throwing.
Fixed an issue where placing RemoteMethod on a class would attempt to remote calls to the Add and Remove methods for events.

--- 0.0.28 ---
[Fixes]
No code changes. Fixed release notes for a previous versions.

--- 0.0.27 ---
[Fixes]
Fixed a major issue with OwlCore.Remoting.MemberRemote where ignoring an invalid remoting direction resulted in the next message causing a throw.

--- 0.0.26 ---
[Breaking changes]
OwlCore.AbstractStorage.IFileScanner was moved to the namespace OwlCore.AbstractStorage.Scanners.
OwlCore.AbstractStorage.IFileScanner.ScanFolder was renamed to ScanFolderAsync
OwlCore.AbstractStorage.IFileScanner.ScanFolder's IFolderData parameter was redundant and removed. Implementors should pass this into the class constructor.
OwlCore.AbstractStorage.DepthFirstFileScanner was moved to the namespace OwlCore.AbstractStorage.Scanners.
OwlCore.AbstractStorage.FileScanStateEventArgs was unused and has been removed.

[Improvements]
Embedded PBD information to help with debugging.
Added examples and improved documentation for Flow.EventAsTask.
Added optional Id to IFolderData, same as the Id for IFileData.
OwlCore.Remoting.RemoteProperty can now be used on fields (weaving fields was previously supported)
Added setup and help documentation for OwlCore.Remoting (MemberRemote, RemoteMethodAttribute, RemotePropertyAttribute).

--- 0.0.25 ---
[Breaking changes]
OwlCore.Remoting.RemoteOptionsAttribute can no longer be used on Events (was never supported by MemberRemote).
OwlCore.Remoting.Transfer.MessageConverters.MessagePackRemoteMessageConverter was removed as it was untested and compatibility is uncertain.

[Improvements]
OwlCore.Remoting.Transfer.MessageConverter.NewtonsoftRemoteMessageConverter is MASSIVELY improved. This version has all primitives, common structs and several classes unit tested with property changes and method call messages.
OwlCore.Remoting.RemoteOptionsAttribute can now be used on fields. [RemoteProperty] applies to fields when put on a class, and [RemoteOptions] now lets you disable specific fields.
Use explicit cast in OwlCore.Extensions.Cast{T}();

[Fixes]
Fixed an issue where StreamExtensions.ToBytes() and StreamExtensions.ToBytesAsync() would return an empty byte array when stream isn't seeked to beginning.

--- 0.0.24 ---
[New]
Added AbstractFolderExplorer in OwlCore.AbstractUI.Components. This is an AbstractUICollection that acts as a standalone, inbox component. A Folder explorer that interops with OwlCore.AbstractStorage to browse and select subfolders from an IFolderData.

[Breaking changes]
Removed cancellation token overload from InParallel. For cancellation, pass the token to the inner tasks.
Swapped enum value order for OwlCore.AbstractUI.Models.PreferredOrientation so Vertical is first and default.

[Fixes]
Fixed issue where "isIndeterminate" parameter of AbstractProgressIndicator wasn't being set from the ctor.
Fixed an issue where AbstractUICollectionViewModel wasn't relaying underlying item to the public Items property.
Fixed an issue where setting state in AbstractBooleanViewModel caused a StackOverflow.

--- 0.0.23 ---
[Breaking changes]
Renamed OwlCore.AbstractUI.Models.AbstractProgress to OwlCore.AbstractUI.Models.AbstractProgressIndicator.
Renamed OwlCore.AbstractUI.Models.AbstractProgressViewModel to OwlCore.AbstractUI.Models.AbstractProgressIndictatorViewModel.

--- 0.0.22 ---
[Breaking changes]
Moved EventAsTask from Threading to Flow.
Removed ExclusiveSynchronizationContext.
Removed "UIElement" from class names of all AbstractUI elements and ViewModels.
Renamed AbstractUIElementGroup to AbstractUICollection.
Refactored CachedHttpClientHandler to use events instead of Action callbacks in the constructor. Added CachedRequestFound and CachedRequestSaving events. Set e.Handled on these instead of returning true or false.

[Improvements]
AbstractUI now works with OwlCore.Remoting when you pass an instance to a MemberRemote.
AbstractUICollection now implements ICollection{AbstractUIElement}.
Added CancellationToken parameter to EventAsTask.

[Fixes]
Fixed potential memory leak in OwlCore.Remoting when RemoteMessageReceivingEventArgs.Handled is set to true.
Fixed an issue where an instance with an overriden == operator handed to MemberRemote could interfere with instance reference checks.

--- 0.0.21 ---
[Fixes]
Fixed a crash in OwlCore.Remoting.MemberRemote when the library catches and prepares to send an exception.

--- 0.0.20 ---
[Fixes]
Fixed threading issue with OwlCore.Remoting introduced in 0.0.19.

--- 0.0.19 ---
[Fixes]
Fixed a crash with OwlCore.Remoting when compiled with optimizations.

--- 0.0.18 ---
[Fixes]
Fixed an issue where remote member change messages were not scoping to specific MemberRemote instances without manually implementing IRemoteMemberMessage.

--- 0.0.17 ---
[Fixes]
Re-release of 0.0.16 to fix freezing visual studio when building.

--- 0.0.16 ---
[Improvements]
Hardened the fix introduced in 0.0.15.

--- 0.0.15 ---
[Fixes]
Fixed an issue where bidirectional remoting causes a loop for method calls and property changes.

--- 0.0.14 ---
[Improvements]
Added empty constructors to classes in OwlCore.Remoting.Transfer.Messages for deserializers.

--- 0.0.13 ---
[Fixes]
Fixed and improved type handling for NewtonsoftRemoteMessageConverter.

[Improvements]
Added additional checks, exceptions and instructions for mismatched data types in remote properties and method parameters.
Exposed a new SerializerSettings property for NewtonsoftRemoteMessageConverter.