OwlCore 0.0.32

• .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)
  • Nito.AsyncEx.Coordination (>= 5.1.2)
  • System.Text.Json (>= 5.0.2)
  • System.Threading.Tasks.Dataflow (>= 5.0.0)

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