Skip to content

Commit 75db423

Browse files
glennawatsonglennawatson
committed
Initial version of the application
1 parent a7d3190 commit 75db423

24 files changed

+1161
-0
lines changed

‎README.md

+32
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Reactive Marbles Property Changed
2+
3+
A framework for providing an observable with the latest value of a property expression.
4+
5+
Will use Expression trees on platforms that support it (no iOS based platforms).
6+
7+
```cs
8+
this.WhenPropertyChanges(x => x.Property1.Property2.Property3);
9+
```
10+
11+
The above will generate a `IObservable<T>` where T is the type of `Property3`. It will signal each time a value has changed. It is aware of all property changes in the property chain.
12+
13+
# Limitations compared to ReactiveUI
14+
15+
At the moment it only supports `INotifyPropertyChanged` properties. More property types to come such as WPF DependencyProperty.
16+
17+
# Benchmark Comparisons
18+
19+
```ini
20+
| Method | N | Mean | Error | StdDev | Gen 0 | Gen 1 | Gen 2 | Allocated |
21+
|----------------------- |----- |-------------:|-----------:|-------------:|----------:|------:|------:|-----------:|
22+
| ReactiveMarblesChanges | 1 | 80.61 us | 1.542 us | 1.515 us | 8.9111 | - | - | 13.82 KB |
23+
| ReactiveUIChanges | 1 | 246.01 us | 19.087 us | 55.069 us | - | - | - | 20.38 KB |
24+
| ReactiveMarblesChanges | 10 | 258.15 us | 2.114 us | 1.977 us | 27.3438 | - | - | 42.32 KB |
25+
| ReactiveUIChanges | 10 | 581.21 us | 10.042 us | 8.902 us | 36.1328 | - | - | 55.75 KB |
26+
| ReactiveMarblesChanges | 100 | 1,968.07 us | 28.810 us | 25.539 us | 212.8906 | - | - | 328.04 KB |
27+
| ReactiveUIChanges | 100 | 4,754.17 us | 49.251 us | 43.659 us | 281.2500 | - | - | 437.24 KB |
28+
| ReactiveMarblesChanges | 1000 | 19,262.79 us | 275.029 us | 257.262 us | 2062.5000 | - | - | 3180.23 KB |
29+
| ReactiveUIChanges | 1000 | 45,432.12 us | 902.420 us | 1,843.404 us | 2000.0000 | - | - | 4232.83 KB |
30+
```
31+
32+
The above benchmarks for compares ReactiveUI `WhenAnyValue` to `WhenPropertyChanges`. On every platform apart from iOS/TVOS/WatchOS the new property changes out performs ReactiveUI versions.

‎azure-pipelines.yml

+60
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
trigger:
2+
- master
3+
4+
pool:
5+
vmImage: 'windows-latest'
6+
7+
variables:
8+
solution: '**/*.sln'
9+
buildPlatform: 'Any CPU'
10+
buildConfiguration: 'Release'
11+
dotNetVersion: '3.0.100-preview8-013656'
12+
13+
steps:
14+
- task: NuGetToolInstaller@0
15+
inputs:
16+
versionSpec: '5.2.0'
17+
18+
- task: DotNetCoreInstaller@0
19+
displayName: Install Dot Net Core v$(dotNetVersion)
20+
inputs:
21+
version: $(dotNetVersion)
22+
23+
- task: NuGetCommand@2
24+
displayName: 'NuGet restore'
25+
inputs:
26+
restoreSolution: '$(solution)'
27+
28+
- task: DotNetCoreCLI@2
29+
inputs:
30+
command: custom
31+
custom: tool
32+
arguments: install --tool-path . nbgv
33+
displayName: Install NBGV tool
34+
env:
35+
COREHOST_TRACE: 0
36+
DOTNET_SKIP_FIRST_TIME_EXPERIENCE: 1
37+
DOTNET_CLI_TELEMETRY_OPTOUT: 1
38+
39+
- script: nbgv cloud
40+
displayName: Set Version
41+
env:
42+
COREHOST_TRACE: 0
43+
DOTNET_SKIP_FIRST_TIME_EXPERIENCE: 1
44+
DOTNET_CLI_TELEMETRY_OPTOUT: 1
45+
46+
- task: MSBuild@1
47+
displayName: Build Solutions
48+
inputs:
49+
solution: '$(solution)'
50+
msbuildArguments: /t:build;pack /p:NoPackageAnalysis=true /p:PackageOutputPath=$(Build.ArtifactStagingDirectory)\artifacts
51+
configuration: $(BuildConfiguration)
52+
maximumCpuCount: true
53+
54+
- task: PublishBuildArtifacts@1
55+
displayName: Publish Build Artifacts
56+
inputs:
57+
PathtoPublish: $(Build.ArtifactStagingDirectory)\artifacts
58+
ArtifactName: artifacts
59+
publishLocation: Container
60+
condition: always()

‎src/Directory.Build.props

+67
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
<Project>
2+
<PropertyGroup>
3+
<GenerateDocumentationFile>true</GenerateDocumentationFile>
4+
<NoWarn>$(NoWarn);1591;1701;1702;1705;VSX1000</NoWarn>
5+
<Platform>AnyCPU</Platform>
6+
<IsTestProject>$(MSBuildProjectName.Contains('Tests'))</IsTestProject>
7+
<DebugType>embedded</DebugType>
8+
<CodeAnalysisRuleSet>$(MSBuildThisFileDirectory)analyzers.ruleset</CodeAnalysisRuleSet>
9+
10+
<Authors>Glenn Watson</Authors>
11+
<Copyright>Copyright (c) 2019 Glenn Watson</Copyright>
12+
<PackageLicenseExpression>MIT</PackageLicenseExpression>
13+
<PackageProjectUrl>https://github.com/reactivemarbles/PropertyChanged</PackageProjectUrl>
14+
<PackageDescription>Allows to get an observables for property changed events.</PackageDescription>
15+
<Owners>glennawatson</Owners>
16+
<PackageTags>system.reactive;propertychanged;inpc;reactive;functional</PackageTags>
17+
<PackageReleaseNotes>https://github.com/reactivemarbles/PropertyChanged/releases</PackageReleaseNotes>
18+
<RepositoryUrl>https://github.com/reactivemarbles/PropertyChanged</RepositoryUrl>
19+
<RepositoryType>git</RepositoryType>
20+
21+
<!-- disable sourcelink on mono, to workaround https://github.com/dotnet/sourcelink/issues/155 -->
22+
<EnableSourceLink Condition=" '$(OS)' != 'Windows_NT' AND '$(MSBuildRuntimeType)' != 'Core' ">false</EnableSourceLink>
23+
<EnableSourceControlManagerQueries>$(EnableSourceLink)</EnableSourceControlManagerQueries>
24+
<!-- Publish the repository URL in the built .nupkg (in the NuSpec <Repository> element) -->
25+
<PublishRepositoryUrl>true</PublishRepositoryUrl>
26+
<!-- Embed source files that are not tracked by the source control manager in the PDB -->
27+
<EmbedUntrackedSources>true</EmbedUntrackedSources>
28+
<!-- Include PDB in the built .nupkg -->
29+
<AllowedOutputExtensionsInPackageBuildOutputFolder>$(AllowedOutputExtensionsInPackageBuildOutputFolder);.pdb</AllowedOutputExtensionsInPackageBuildOutputFolder>
30+
</PropertyGroup>
31+
32+
<ItemGroup Condition="$(IsTestProject)">
33+
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.2.0" />
34+
<PackageReference Include="xunit" Version="2.4.1" />
35+
<PackageReference Include="xunit.runner.console" Version="2.4.1" />
36+
<PackageReference Include="xunit.runner.visualstudio" Version="2.4.1" />
37+
<PackageReference Include="Xunit.StaFact" Version="0.3.18" />
38+
<PackageReference Include="Shouldly" Version="4.0.0-beta0002" />
39+
<PackageReference Include="PublicApiGenerator" Version="9.3.0" />
40+
</ItemGroup>
41+
42+
<ItemGroup Condition="'$(IsTestProject)' != 'true' and '$(SourceLinkEnabled)' != 'false'">
43+
<PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.0.0-beta2-19367-01" PrivateAssets="All" />
44+
</ItemGroup>
45+
46+
<PropertyGroup>
47+
<SolutionDir Condition="'$(SolutionDir)' == ''">$(MSBuildThisFileDirectory)</SolutionDir>
48+
</PropertyGroup>
49+
50+
<ItemGroup>
51+
<None Include="$(MSBuildThisFileDirectory)..\LICENSE" Pack="true" PackagePath="LICENSE" />
52+
</ItemGroup>
53+
54+
<ItemGroup>
55+
<PackageReference Include="Nerdbank.GitVersioning" Version="3.0.25" PrivateAssets="all" />
56+
</ItemGroup>
57+
58+
<ItemGroup>
59+
<PackageReference Include="stylecop.analyzers" Version="1.1.118" PrivateAssets="all" />
60+
<PackageReference Include="Microsoft.CodeAnalysis.FxCopAnalyzers" Version="2.6.3" PrivateAssets="all" />
61+
<PackageReference Include="Roslynator.Analyzers" Version="2.1.0" PrivateAssets="All" />
62+
<PackageReference Condition="'$(OS)' == 'Windows_NT'" Include="Microsoft.CodeAnalysis.FxCopAnalyzers" Version="2.9.3" PrivateAssets="all" />
63+
</ItemGroup>
64+
<ItemGroup>
65+
<AdditionalFiles Include="$(MSBuildThisFileDirectory)stylecop.json" Link="stylecop.json" />
66+
</ItemGroup>
67+
</Project>

‎src/Directory.build.targets

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
<Project>
2+
<PropertyGroup>
3+
<Product>$(AssemblyName) ($(TargetFramework))</Product>
4+
</PropertyGroup>
5+
6+
<PropertyGroup Condition="$(TargetFramework.StartsWith('net4'))">
7+
<DefineConstants>$(DefineConstants);NET_45;XAML</DefineConstants>
8+
</PropertyGroup>
9+
<PropertyGroup Condition="$(TargetFramework.StartsWith('uap'))">
10+
<DefineConstants>$(DefineConstants);NETFX_CORE;XAML;WINDOWS_UWP</DefineConstants>
11+
</PropertyGroup>
12+
<PropertyGroup Condition="$(TargetFramework.StartsWith('Xamarin.iOS'))">
13+
<DefineConstants>$(DefineConstants);MONO;UIKIT;COCOA</DefineConstants>
14+
</PropertyGroup>
15+
<PropertyGroup Condition="$(TargetFramework.StartsWith('Xamarin.Mac'))">
16+
<DefineConstants>$(DefineConstants);MONO;COCOA</DefineConstants>
17+
</PropertyGroup>
18+
<PropertyGroup Condition="$(TargetFramework.StartsWith('Xamarin.TVOS'))">
19+
<DefineConstants>$(DefineConstants);MONO;UIKIT;COCOA</DefineConstants>
20+
</PropertyGroup>
21+
<PropertyGroup Condition="$(TargetFramework.StartsWith('Xamarin.WatchOS'))">
22+
<DefineConstants>$(DefineConstants);MONO;UIKIT;COCOA</DefineConstants>
23+
</PropertyGroup>
24+
<PropertyGroup Condition="$(TargetFramework.StartsWith('MonoAndroid'))">
25+
<DefineConstants>$(DefineConstants);MONO;ANDROID</DefineConstants>
26+
</PropertyGroup>
27+
<PropertyGroup Condition="$(TargetFramework.StartsWith('tizen'))">
28+
<DefineConstants>$(DefineConstants);TIZEN</DefineConstants>
29+
</PropertyGroup>
30+
</Project>

‎src/PropertyChanged.sln

+71
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
2+
Microsoft Visual Studio Solution File, Format Version 12.00
3+
# Visual Studio 15
4+
VisualStudioVersion = 15.0.26124.0
5+
MinimumVisualStudioVersion = 15.0.26124.0
6+
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ReactiveMarbles.PropertyChanged", "ReactiveMarbles.PropertyChanged\ReactiveMarbles.PropertyChanged.csproj", "{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}"
7+
EndProject
8+
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ReactiveMarbles.PropertyChanged.Tests", "ReactiveMarbles.PropertyChanged.Tests\ReactiveMarbles.PropertyChanged.Tests.csproj", "{211669E0-34C1-48EF-B59C-C5271F721D38}"
9+
EndProject
10+
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{15316C41-0C07-4A56-894A-43E2E2C4296A}"
11+
ProjectSection(SolutionItems) = preProject
12+
Directory.build.targets = Directory.build.targets
13+
Directory.Build.props = Directory.Build.props
14+
analyzers.ruleset = analyzers.ruleset
15+
global.json = global.json
16+
stylecop.json = stylecop.json
17+
EndProjectSection
18+
EndProject
19+
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ReactiveMarbles.PropertyChanged.Benchmarks", "ReactiveMarbles.PropertyChanged.Benchmarks\ReactiveMarbles.PropertyChanged.Benchmarks.csproj", "{DFE06734-1998-4ED1-B0BB-75DC718347B9}"
20+
EndProject
21+
Global
22+
GlobalSection(SolutionConfigurationPlatforms) = preSolution
23+
Debug|Any CPU = Debug|Any CPU
24+
Debug|x64 = Debug|x64
25+
Debug|x86 = Debug|x86
26+
Release|Any CPU = Release|Any CPU
27+
Release|x64 = Release|x64
28+
Release|x86 = Release|x86
29+
EndGlobalSection
30+
GlobalSection(SolutionProperties) = preSolution
31+
HideSolutionNode = FALSE
32+
EndGlobalSection
33+
GlobalSection(ProjectConfigurationPlatforms) = postSolution
34+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
35+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Debug|Any CPU.Build.0 = Debug|Any CPU
36+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Debug|x64.ActiveCfg = Debug|Any CPU
37+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Debug|x64.Build.0 = Debug|Any CPU
38+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Debug|x86.ActiveCfg = Debug|Any CPU
39+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Debug|x86.Build.0 = Debug|Any CPU
40+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Release|Any CPU.ActiveCfg = Release|Any CPU
41+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Release|Any CPU.Build.0 = Release|Any CPU
42+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Release|x64.ActiveCfg = Release|Any CPU
43+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Release|x64.Build.0 = Release|Any CPU
44+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Release|x86.ActiveCfg = Release|Any CPU
45+
{15B3E9B3-869B-4692-ADBB-A57E47C7D3DA}.Release|x86.Build.0 = Release|Any CPU
46+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
47+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Debug|Any CPU.Build.0 = Debug|Any CPU
48+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Debug|x64.ActiveCfg = Debug|Any CPU
49+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Debug|x64.Build.0 = Debug|Any CPU
50+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Debug|x86.ActiveCfg = Debug|Any CPU
51+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Debug|x86.Build.0 = Debug|Any CPU
52+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Release|Any CPU.ActiveCfg = Release|Any CPU
53+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Release|Any CPU.Build.0 = Release|Any CPU
54+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Release|x64.ActiveCfg = Release|Any CPU
55+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Release|x64.Build.0 = Release|Any CPU
56+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Release|x86.ActiveCfg = Release|Any CPU
57+
{211669E0-34C1-48EF-B59C-C5271F721D38}.Release|x86.Build.0 = Release|Any CPU
58+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
59+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Debug|Any CPU.Build.0 = Debug|Any CPU
60+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Debug|x64.ActiveCfg = Debug|Any CPU
61+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Debug|x64.Build.0 = Debug|Any CPU
62+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Debug|x86.ActiveCfg = Debug|Any CPU
63+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Debug|x86.Build.0 = Debug|Any CPU
64+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Release|Any CPU.ActiveCfg = Release|Any CPU
65+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Release|Any CPU.Build.0 = Release|Any CPU
66+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Release|x64.ActiveCfg = Release|Any CPU
67+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Release|x64.Build.0 = Release|Any CPU
68+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Release|x86.ActiveCfg = Release|Any CPU
69+
{DFE06734-1998-4ED1-B0BB-75DC718347B9}.Release|x86.Build.0 = Release|Any CPU
70+
EndGlobalSection
71+
EndGlobal

‎src/ReactiveMarbles.PropertyChanged.Benchmarks/Moqs/A.cs

+17
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
// Copyright (c) 2019 Glenn Watson. All rights reserved.
2+
// Glenn Watson licenses this file to you under the MIT license.
3+
// See the LICENSE file in the project root for full license information.
4+
5+
namespace ReactiveMarbles.PropertyChanged.Benchmarks.Moqs
6+
{
7+
internal class A : BaseTestClass
8+
{
9+
private B _b;
10+
11+
public B B
12+
{
13+
get => _b;
14+
set => RaiseAndSetIfChanged(ref _b, value);
15+
}
16+
}
17+
}

‎src/ReactiveMarbles.PropertyChanged.Benchmarks/Moqs/B.cs

+17
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
// Copyright (c) 2019 Glenn Watson. All rights reserved.
2+
// Glenn Watson licenses this file to you under the MIT license.
3+
// See the LICENSE file in the project root for full license information.
4+
5+
namespace ReactiveMarbles.PropertyChanged.Benchmarks.Moqs
6+
{
7+
internal class B : BaseTestClass
8+
{
9+
private C _c;
10+
11+
public C C
12+
{
13+
get => _c;
14+
set => RaiseAndSetIfChanged(ref _c, value);
15+
}
16+
}
17+
}

‎src/ReactiveMarbles.PropertyChanged.Benchmarks/Moqs/BaseTestClass.cs

+31
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
// Copyright (c) 2019 Glenn Watson. All rights reserved.
2+
// Glenn Watson licenses this file to you under the MIT license.
3+
// See the LICENSE file in the project root for full license information.
4+
5+
using System.Collections.Generic;
6+
using System.ComponentModel;
7+
using System.Runtime.CompilerServices;
8+
9+
namespace ReactiveMarbles.PropertyChanged.Benchmarks.Moqs
10+
{
11+
internal abstract class BaseTestClass : INotifyPropertyChanged
12+
{
13+
public event PropertyChangedEventHandler PropertyChanged;
14+
15+
protected void RaiseAndSetIfChanged<T>(ref T fieldValue, T value, [CallerMemberName] string propertyName = null)
16+
{
17+
if (EqualityComparer<T>.Default.Equals(fieldValue, value))
18+
{
19+
return;
20+
}
21+
22+
fieldValue = value;
23+
OnPropertyChanged(propertyName);
24+
}
25+
26+
protected virtual void OnPropertyChanged(string propertyName)
27+
{
28+
PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
29+
}
30+
}
31+
}

‎src/ReactiveMarbles.PropertyChanged.Benchmarks/Moqs/C.cs

+17
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
// Copyright (c) 2019 Glenn Watson. All rights reserved.
2+
// Glenn Watson licenses this file to you under the MIT license.
3+
// See the LICENSE file in the project root for full license information.
4+
5+
namespace ReactiveMarbles.PropertyChanged.Benchmarks.Moqs
6+
{
7+
internal class C : BaseTestClass
8+
{
9+
private string _test;
10+
11+
public string Test
12+
{
13+
get => _test;
14+
set => RaiseAndSetIfChanged(ref _test, value);
15+
}
16+
}
17+
}

‎src/ReactiveMarbles.PropertyChanged.Benchmarks/Program.cs

+24
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
// Copyright (c) 2019 Glenn Watson. All rights reserved.
2+
// Glenn Watson licenses this file to you under the MIT license.
3+
// See the LICENSE file in the project root for full license information.
4+
5+
using System;
6+
using BenchmarkDotNet.Running;
7+
8+
namespace ReactiveMarbles.PropertyChanged.Benchmarks
9+
{
10+
/// <summary>
11+
/// Class which hosts the main entry point into the application.
12+
/// </summary>
13+
public static class Program
14+
{
15+
/// <summary>
16+
/// The main entry point into the benchmarking application.
17+
/// </summary>
18+
/// <param name="args">Arguments from the command line.</param>
19+
public static void Main(string[] args)
20+
{
21+
BenchmarkSwitcher.FromAssembly(typeof(Program).Assembly).Run(args);
22+
}
23+
}
24+
}

0 commit comments

Comments
 (0)