feat: added functionality to filter by properties on nested objects

Author: Jamess-Lucass

example/Dto/UserDto.cs

@@ -13,4 +13,5 @@ public record UserDto
     public int? NullableInt { get; set; }
     public DateTime DateOfBirthUtc { get; set; }
     public DateTime DateOfBirthTz { get; set; }
+    public User? Manager { get; set; }
 }

example/Entities/User.cs

@@ -16,4 +16,5 @@ public record User
 
     [Column(TypeName = "timestamp without time zone")]
     public DateTime DateOfBirthTz { get; set; }
+    public User? Manager { get; set; }
 }

example/Program.cs

@@ -50,7 +50,8 @@
 
                 u.DateOfBirthUtc = date;
                 u.DateOfBirthTz = TimeZoneInfo.ConvertTimeFromUtc(date, timeZone);
-            });
+            })
+            .RuleFor(x => x.Manager, (f, u) => f.CreateManager(3));
 
         context.Users.AddRange(users.Generate(1_000));
         context.SaveChanges();
@@ -59,6 +60,8 @@
     }
 }
 
+Console.WriteLine($"Postgres connection string: {postgreSqlContainer.GetConnectionString()}");
+
 app.MapGet("/minimal/users", (ApplicationDbContext db, [FromServices] IMapper mapper, [AsParameters] Query query) =>
 {
     var result = db.Users
@@ -79,3 +82,27 @@
 app.MapControllers();
 
 app.Run();
+
+public static class FakerExtensions
+{
+    public static User? CreateManager(this Faker f, int depth)
+    {
+        if (depth <= 0 || !f.Random.Bool(0.6f)) // 60% chance of having manager, stop at depth 0
+            return null;
+
+        return new User
+        {
+            Id = f.Random.Guid(),
+            Firstname = f.Person.FirstName,
+            Lastname = f.Person.LastName,
+            Age = f.Random.Int(0, 100),
+            IsDeleted = f.Random.Bool(),
+            Test = f.Random.Double(),
+            NullableInt = f.Random.Bool() ? f.Random.Int(1, 100) : null,
+            IsEmailVerified = f.Random.Bool(),
+            DateOfBirthUtc = f.Date.Past().ToUniversalTime(),
+            DateOfBirthTz = TimeZoneInfo.ConvertTimeFromUtc(f.Date.Past().ToUniversalTime(), TimeZoneInfo.FindSystemTimeZoneById("America/New_York")),
+            Manager = f.CreateManager(depth - 1) // Recursive call with reduced depth
+        };
+    }
+}

src/GoatQuery/src/Ast/Node.cs

@@ -7,7 +7,7 @@ public Node(Token token)
         _token = token;
     }
 
-    public string TokenLiteral()
+    public virtual string TokenLiteral()
     {
         return _token.Literal;
     }

src/GoatQuery/src/Ast/PropertyPath.cs

@@ -0,0 +1,16 @@
+using System.Collections.Generic;
+
+public sealed class PropertyPath : QueryExpression
+{
+    public List<string> Segments { get; }
+
+    public PropertyPath(Token token, List<string> segments) : base(token)
+    {
+        Segments = segments;
+    }
+
+    public override string TokenLiteral()
+    {
+        return string.Join("/", Segments);
+    }
+}