OwlCore 0.0.45

• .NETStandard 2.0

  • Cauldron.BasicInterceptors (>= 3.2.3)
  • Cauldron.Interception.Fody (>= 3.2.3)
  • MessagePack (>= 2.3.85)
  • Microsoft.CSharp (>= 4.7.0)
  • Microsoft.Extensions.DependencyInjection (>= 5.0.2)
  • Microsoft.Toolkit (>= 7.0.0)
  • Microsoft.Toolkit.Diagnostics (>= 7.1.1)
  • Microsoft.Toolkit.Mvvm (>= 7.1.1)
  • Newtonsoft.Json (>= 13.0.1)
  • System.Text.Json (>= 5.0.2)
  • System.Threading.Tasks.Dataflow (>= 5.0.0)

--- 0.0.45 ---
[New]
Added extension methods CrawlBy and CrawlByAsync. Crawls an object tree for nested properties of the same type and returns the first instance that matches a filter predicate. Unit tested.
Added OwlCore.ComponentModel.IDelegatable.
Added OwlCore.ComponentModel.ChainedProxyBuilder. Builds a class delegation chain where each item might delegate member access to the next item in the collection. Unit tested.

[Breaking changes]
CompositeHttpClientHandler and all related classes have been removed in favor of the built-in DelegatingMessageHandler, which all OwlCore handlers support by default.
OwlCore.Net.HttpClientHandlers namespace has been renamed to OwlCore.Net.Http.

--- 0.0.44 ---
[New]
New class: RemoteSemaphoreSlim. A remote-capable SemaphoreSlim implementation. Unit tests included.
Added a new overload to DataProxy: ReceiveDataAsync{TResult}(MemberRemote, string, TimeSpan, CancellationToken?). This overloads waits the given timespan for multiple published messages, then returns all received data. Unit tests included.
MemberRemote will now emit a RemoteMethodCallMessage when a method is exited.
MethodCallId has been added to MethodInterceptEventArgs and RemoteMethodCallMessage. This value is unique for every method call.
InterceptType (entry, exit) has been added to MethodInterceptEventArgs.

[Improvements]
NewtonsoftRemoteMessageConverter will now exclude null values during serialization.
OwlCore.Extensions.Cast{T} now uses aggressive inlining.
Added unit tests for the emitting of RemoteMethodCallMessage for both Entry and Exit.
AbstractUICollectionViewModel now inherits from ICollection{T} instead of IEnumerable{T}.
AbstractUICollectionViewModel now implements INotifyCollectionChanged.
AbstractUICollectionViewModel now inherits from ICollection{T} instead of IEnumerable{T}.
AbstractUICollection now implements INotifyCollectionChanged.
AbstractUICollection.Items and AbstractUICollectionViewModel.Items have been marked as obsolete and will be removed in a future version. Enumerate the collections directly instead.

[Fixes]
Fixed an issue in NewtonsoftRemoteMessageConverter where property changes were not using assembly qualified name for type conversion.
Fixed an issue in NewtonsoftRemoteMessageConverter where Enums were not being deserialized properly.
Fixed an issue in NewtonsoftRemoteMessageConverter where a concrete class value passed for an interface target type was cast to the wrong enumerable type.

[Breaking changes]
MethodEnteredEventArgs has been renamed to MethodInterceptEventArgs.
A param has been inserted at index 0 in the ctor for MethodInterceptEventArgs (string methodCallId)
A param has been inserted at index 1 in the ctor for RemoteMethodCallMessage (string methodCallId).

--- 0.0.43 ---
[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.42.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.42 ---
[Fixes]
Fixed an issue where modified shuffle maps kept in sync with the original list might not unshuffle properly. Added tests.

[Breaking changes]
Remove problematic Flow.Catch overloads, and added tests.

--- 0.0.41 ---
[Improvements]
Flow.Catch now has overloads to catch up to 4 exceptions.

[Breaking changes]
The type parameter order on Flow.Catch{TException, TResult}(Func{TResult}) has been swapped to {TException, TResult}. This allows for more natural usage when catching more than 1 exception.

--- 0.0.40 ---
[Improvements]
Shuffle extension method is now O(n) using fisher-yates.
Shuffle extension method now returns a "shuffle map" that can be used to map items to their original positions and unshuffle the collection.
Added IList{T} overload to Shuffle extension method.
Added unit tests to Shuffle extension methods.

[New]
Added Unshuffle extension method for T[] and List{T}. Pass a "shuffle map" returned by the Shuffle extension method to return a list to its' original order using a (probably) original algorithm inspired by fisher-yates with O(n) time and space complexity.

--- 0.0.39 ---
[New]
Added NavigationFailed event to AbstractFolderExplorer.
Flow.Catch now has an overload that catches all exception with no return value.

[Fixes]
Fixed a potential memory leak in Flow.WhenCancelled.

[Improvements]
Made selfCancellationToken parameter optional on CancellationToken.WhenCancelled() extension method.
Flow.Catch now properly returns default values when an exception is caught.

[Breaking changes]
Flow.TryOrSkip was renamed to Flow.Catch

--- 0.0.38 ---
[New]
Added Flow.WhenCancelled(cancellationToken) and unit tests. Returns a Task that completes when the given cancellation token is cancelled.
Added CancellationToken.WhenCancelled() extension method to OwlCore.Extensions and unit tests. Same behavior as Flow.WhenCancelled, but as an extension method.

[Breaking changes]
Deque was removed from OwlCore.Collections.Generic. For a maintained version, see https://github.com/Avid29/MoreCollections/blob/main/src/Generic/Deque.cs
SynchronizedObservableCollection was moved to OwlCore.Collections.ObjectModel.
OwlCore.Validation.Ensure was made internal. This is only used by SynchronizedObservableCollection, which may be removed in a future release.
InvokeOnUI from OwlCore.Extensions has a fatal flaw and was removed.
OwlCore.Exceptions.UIElementNotFoundException was removed.
OwlCore.Exceptions was removed.

--- 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.