you can modify value if return a new value

Author: newbe36524

README.md

@@ -47,11 +47,11 @@ order.FormatToString();
 
 ## API
 
-| icon | remark                                                      |
-| ---- | ----------------------------------------------------------- |
-| ✔️   | it is already avaliable in latest version                   |
-| 🚧   | still in plan or development and will be changed or removed |
-| ❌   | it is removed form the latest version                       |
+| icon | remark                                                                   |
+| ---- | ------------------------------------------------------------------------ |
+| ✔️   | it is already avaliable in latest version                                |
+| 🚧   | still in plan or development and will be implemented, changed or removed |
+| ❌   | it is removed form the latest version                                    |
 
 ```cs
 var o = new Yueluo();
@@ -97,8 +97,9 @@ var cachedVisitor = deafult(Yueluo).V()
 cachedVisitor.Run(new Yueluo(), new StringBuilder());
 
 
-//🚧 you can modify value if return a new value
-o.V().ForEach((context)=>context.Value.SubString(0,1)).Run();
+//✔️ from 0.2
+// you can modify value if return a new value
+o.V().ForEach((context)=>context.Value = context.Value.SubString(0,1)).Run();
 
 //✔️ from 0.1
 // get debug info about expression now

src/Directory.Build.props

@@ -70,4 +70,7 @@ Why do I need this?
     <PackageReference Include="Autofac.Extras.Moq" Version="4.3.0"/>
     <PackageReference Include="FluentAssertions" Version="5.10.3"/>
   </ItemGroup>
+  <ItemGroup Condition=" '$(Configuration)' == 'Debug' ">
+    <PackageReference Include="AgileObjects.ReadableExpressions" Version="2.5.1" />
+  </ItemGroup>
 </Project>

src/Newbe.ObjectVisitor.BenchmarkTest/PropertyGetterTest.cs

@@ -0,0 +1,53 @@
+using System;
+using System.Reflection;
+using BenchmarkDotNet.Attributes;
+
+namespace Newbe.ObjectVisitor.BenchmarkTest
+{
+    [Config(typeof(Config))]
+    public class PropertyGetterTest
+    {
+        private readonly Yueluo _yueluo;
+        private readonly PropertyInfo _nameProperty;
+        private readonly PropertyInfo _ageProperty;
+        private readonly Func<Yueluo, string> _nameFunc;
+
+        public PropertyGetterTest()
+        {
+            _yueluo = Yueluo.Create();
+            _nameProperty = typeof(Yueluo).GetProperty(nameof(Yueluo.Name));
+            _ageProperty = typeof(Yueluo).GetProperty(nameof(Yueluo.Age));
+            _nameFunc = ValueGetter<Yueluo, string, string>.GetGetter(_nameProperty);
+            _ = ValueGetter<Yueluo, int, int>.GetGetter(_ageProperty).Invoke(_yueluo);
+            _ = ValueGetter<Yueluo>.GetGetter(_nameProperty).Invoke(_yueluo);
+        }
+
+        [Benchmark(Baseline = true)]
+        public string DirectlyString() => _yueluo.Name;
+
+        [Benchmark]
+        public int DirectlyInt() => _yueluo.Age;
+
+        [Benchmark]
+        public string ReflectString() => (string) _nameProperty.GetValue(_yueluo);
+
+        [Benchmark]
+        public int ReflectInt() => (int) _ageProperty.GetValue(_yueluo);
+
+        [Benchmark]
+        public string GetterString()
+            => ValueGetter<Yueluo, string, string>.GetGetter(_nameProperty).Invoke(_yueluo);
+
+        [Benchmark]
+        public int GetterInt()
+            => ValueGetter<Yueluo, int, int>.GetGetter(_ageProperty).Invoke(_yueluo);
+
+        [Benchmark]
+        public string GetterObject()
+            => (string) ValueGetter<Yueluo>.GetGetter(_nameProperty).Invoke(_yueluo);
+
+        [Benchmark]
+        public string GetterCached()
+            => _nameFunc.Invoke(_yueluo);
+    }
+}

src/Newbe.ObjectVisitor/Newbe.ObjectVisitor.Tests/ChangePasswordTest.cs

@@ -0,0 +1,57 @@
+using System.Text.RegularExpressions;
+using FluentAssertions;
+using NUnit.Framework;
+
+namespace Newbe.ObjectVisitor.Tests
+{
+    public class ChangePasswordTest
+    {
+        [Test]
+        public void CoverSensitiveDataTest()
+        {
+            // here is a model
+            var userModel = new UserModel
+            {
+                Username = "newbe36524",
+                Password = "newbe.pro",
+                Phone = "12345678901"
+            };
+
+            // create a data visitor to cover sensitive data
+            var visitor = userModel.V()
+                .ForEach<UserModel, string>(x => CoverSensitiveData(x))
+                .Cache();
+
+            visitor.Run(userModel);
+
+            var expected = new UserModel
+            {
+                Username = "newbe36524",
+                Password = "***",
+                Phone = "123****8901",
+            };
+            userModel.Should().BeEquivalentTo(expected);
+        }
+
+        private void CoverSensitiveData(IObjectVisitorContext<UserModel, string> c)
+        {
+            var value = c.Value;
+            if (!string.IsNullOrEmpty(value))
+            {
+                c.Value = Regex.Replace(value, "(\\d{3})\\d{4}(\\d{4})", "$1****$2");
+            }
+
+            if (c.Name == nameof(UserModel.Password))
+            {
+                c.Value = "***";
+            }
+        }
+
+        public class UserModel
+        {
+            public string Username { get; set; } = null!;
+            public string Phone { get; set; } = null!;
+            public string Password { get; set; } = null!;
+        }
+    }
+}

src/Newbe.ObjectVisitor/Newbe.ObjectVisitor.Tests/DataConnectionModelTest.cs

@@ -0,0 +1,107 @@
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using FluentAssertions;
+using NUnit.Framework;
+
+namespace Newbe.ObjectVisitor.Tests
+{
+    public class DataConnectionModelTest
+    {
+        public const string ConnectionStringValue =
+            "Host=www.newbe.pro;Port=36524;Username=newbe36524;Password=newbe.pro;";
+
+        [Test]
+        public void JoinToString()
+        {
+            var model = new DataConnectionModel
+            {
+                Host = "www.newbe.pro",
+                Port = 36524,
+                Username = "newbe36524",
+                Password = "newbe.pro",
+            };
+            var connectionString = model.ToString();
+
+            connectionString.Should().Be(ConnectionStringValue);
+        }
+
+        [Test]
+        public void BuildFromString()
+        {
+            var model = DataConnectionModel.FromString(ConnectionStringValue);
+            var expected = new DataConnectionModel
+            {
+                Host = "www.newbe.pro",
+                Port = 36524,
+                Username = "newbe36524",
+                Password = "newbe.pro",
+            };
+            model.Should().BeEquivalentTo(expected);
+        }
+
+
+        public class DataConnectionModel
+        {
+            public string Host { get; set; } = null!;
+            public ushort? Port { get; set; } = null!;
+            public string Username { get; set; } = null!;
+            public string Password { get; set; } = null!;
+            public int? MaxPoolSize { get; set; } = null!;
+
+            private static readonly ICachedObjectVisitor<DataConnectionModel, StringBuilder> ConnectionStringBuilder =
+                default(DataConnectionModel)!
+                    .V()
+                    .WithExtendObject<DataConnectionModel, StringBuilder>()
+                    .ForEach((name, value, sb) => AppendValueIfNotNull(name, value, sb))
+                    .Cache();
+
+            private static void AppendValueIfNotNull(string name, object? value, StringBuilder sb)
+            {
+                if (value != null)
+                {
+                    sb.Append($"{name}={value};");
+                }
+            }
+
+
+            public override string ToString()
+            {
+                var sb = new StringBuilder();
+                ConnectionStringBuilder.Run(this, sb);
+                return sb.ToString();
+            }
+
+            private static readonly ICachedObjectVisitor<DataConnectionModel, Dictionary<string, string>>
+                ConnectionStringConstructor
+                    =
+                    default(DataConnectionModel)!
+                        .V()
+                        .WithExtendObject<DataConnectionModel, Dictionary<string, string>>()
+                        .ForEach(context => SetValueIfFound(context))
+                        .Cache();
+
+            private static void SetValueIfFound(
+                IObjectVisitorContext<DataConnectionModel, Dictionary<string, string>, object> c)
+            {
+                if (c.ExtendObject.TryGetValue(c.Name, out var stringValue))
+                {
+                    TypeConverter conv = TypeDescriptor.GetConverter(c.PropertyInfo.PropertyType);
+                    c.Value = conv.ConvertFrom(stringValue)!;
+                }
+            }
+
+            public static DataConnectionModel FromString(string connectionString)
+            {
+                var dic = connectionString.Split(';')
+                    .Where(x => !string.IsNullOrEmpty(x))
+                    .Select(x => x.Split('='))
+                    .ToDictionary(x => x[0], x => x[1]);
+                var re = new DataConnectionModel();
+                ConnectionStringConstructor.Run(re, dic);
+                return re;
+            }
+        }
+    }
+}

src/Newbe.ObjectVisitor/Newbe.ObjectVisitor.Tests/EnumerableTest.cs

@@ -0,0 +1,68 @@
+using System.Collections.Generic;
+using System.Linq;
+using FluentAssertions;
+using NUnit.Framework;
+
+namespace Newbe.ObjectVisitor.Tests
+{
+    public class EnumerableTest
+    {
+        [Test]
+        public void NameAndValue()
+        {
+            var model = new TestModel
+            {
+                List1 = new[] {1},
+                List2 = new[] {2},
+                List3 = new List<int> {3},
+                List4 = new HashSet<int> {4}
+            };
+            var sumBag = new SumBag();
+            var visitor = model.V()
+                .WithExtendObject(sumBag)
+                .ForEach<TestModel, SumBag, IEnumerable<int>>((name, value, bag) => Sum(bag, value),
+                    x => x.IsOrImplOf<IEnumerable<int>>())
+                .Cache();
+            visitor.Run(model, sumBag);
+            sumBag.Sum.Should().Be(10);
+        }
+
+        [Test]
+        public void NameAndValue2()
+        {
+            var model = new TestModel
+            {
+                List1 = new[] {1},
+                List2 = new[] {2},
+                List3 = new List<int> {3},
+                List4 = new HashSet<int> {4}
+            };
+            var sumBag = new SumBag();
+            var visitor = model.V()
+                .WithExtendObject(sumBag)
+                .ForEach<TestModel, SumBag, IEnumerable<int>>(x => Sum(x.ExtendObject, x.Value),
+                    x => x.IsOrImplOf<IEnumerable<int>>())
+                .Cache();
+            visitor.Run(model, sumBag);
+            sumBag.Sum.Should().Be(10);
+        }
+
+        private static void Sum(SumBag bag, IEnumerable<int> data)
+        {
+            bag.Sum += data.Sum();
+        }
+
+        public class SumBag
+        {
+            public int Sum { get; set; }
+        }
+
+        public class TestModel
+        {
+            public int[] List1 { get; set; } = null!;
+            public IEnumerable<int> List2 { get; set; } = null!;
+            public List<int> List3 { get; set; } = null!;
+            public HashSet<int> List4 { get; set; } = null!;
+        }
+    }
+}