Updates

Author: HypeMC

CHANGELOG.md

@@ -7,9 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.0.0] - xxxx-xx-xx
 
+### Added
+
+- `ExpressionValues` to enable resolution of route parameter values via expressions by @HypeMC
+  in https://github.com/sofascore/purgatory-bundle/pull/112
+
 ### Removed
 
 - Symfony v5 support by @HypeMC in https://github.com/sofascore/purgatory-bundle/pull/128
+- `InverseValuesAwareInterface`, use dedicated builder services instead by @HypeMC
+  in https://github.com/sofascore/purgatory-bundle/pull/123
 
 ## [1.3.0] - 2025-12-15
 

docs/complex-route-params.md

@@ -119,10 +119,31 @@ public function listAction(string $lang)
 In this example, multiple URLs are generated based on all values from the `LanguageCodes` enum and the raw value `XK`
 for the `lang` parameter.
 
+### Using Values Provided by an Expression
+
+You can also map route parameters to values provided dynamically using a **Symfony ExpressionLanguage** expression.
+This is useful when a route parameter cannot be mapped directly to a single property and needs to be composed or
+transformed.
+
+In these expressions, the entity is available as the `obj` variable:
+
+```php
+use Sofascore\PurgatoryBundle\Attribute\RouteParamValue\ExpressionValues;
+
+#[Route('/posts-by-author/{full_name}', name: 'posts_list_by_author', methods: 'GET')]
+#[PurgeOn(Author::class, routeParams: ['full_name' => new ExpressionValues('obj.firstName~"-"~obj.lastName')])]
+public function listAction(Author $author)
+{
+}
+```
+
+You can also add [custom Expression Language functions](custom-expression-language-functions.md) to extend the available
+expression syntax.
+
 ### Using Values Provided by a Service
 
-You can also map route parameters to values provided dynamically by a service. This is particularly useful when you need
-route parameters that depend on context or runtime information:
+As an alternative to expressions, route parameter values can be provided by a service. This is particularly useful when
+you need route parameters that depend on context or runtime information:
 
 ```php
 use Sofascore\PurgatoryBundle\Attribute\RouteParamValue\DynamicValues;

docs/custom-expression-language-functions.md

@@ -1,6 +1,7 @@
 # Custom Expression Language Functions
 
-You can add custom functions to the Expression Language for use with the `if` parameter.
+You can add custom Expression Language functions that can be used by expressions defined in `ExpressionValues` or the
+`if` parameter.
 
 ```php
 #[Route('/post/{id<\d+>}', name: 'post_details', methods: 'GET')]

docs/purge-subscriptions-using-yaml.md

@@ -58,6 +58,12 @@ posts_list:
             - !enum App\Enum\LanguageCodes
             - !raw XK
 
+# Using values provided by an expression
+posts_list_by_author:
+    class: App\Entity\Author
+    route_params:
+        full_name: !expression 'obj.firstName~"-"~obj.lastName'
+
 # Using values provided by a service
 posts_list:
     class: App\Entity\Post

src/Cache/PropertyResolver/ExpressionLanguage/InverseRelationExpressionTransformer.php

@@ -9,6 +9,9 @@
 use Symfony\Component\PropertyInfo\PropertyReadInfo;
 use Symfony\Component\PropertyInfo\PropertyReadInfoExtractorInterface;
 
+/**
+ * @internal
+ */
 final class InverseRelationExpressionTransformer
 {
     public function __construct(

tests/Command/DebugCommandTest.php

@@ -56,7 +56,7 @@ public function testOptionAll(): void
 
         self::assertNumberOfDisplayedSubscriptions(
             command: $this->command,
-            expectedNumberOfSubscriptions: 10,
+            expectedNumberOfSubscriptions: 12,
         );
         self::assertNumberOfDisplayedEntities(
             command: $this->command,
@@ -65,7 +65,7 @@ public function testOptionAll(): void
         );
         self::assertNumberOfDisplayedEntities(
             command: $this->command,
-            expectedNumberOfEntities: 5,
+            expectedNumberOfEntities: 7,
             entityClass: Author::class,
         );
 
@@ -96,6 +96,11 @@ public function testOptionAll(): void
             needle: 'page: Dynamic("purgatory.get_page", null)',
             haystack: $display,
         );
+        self::assertSubstringCount(
+            expectedCount: 2,
+            needle: 'full_name: Expression("obj.firstName~\"-\"~obj.lastName")',
+            haystack: $display,
+        );
     }
 
     public function testOptionRoute(): void
@@ -134,7 +139,7 @@ public function testOptionRoute(): void
 
     #[TestWith([Post::class, 1, Post::class, 'ANY'])]
     #[TestWith([Author::class, 1, Author::class, 'ANY'])]
-    #[TestWith([Author::class.'::firstName', 2, Author::class, 'firstName'])]
+    #[TestWith([Author::class.'::firstName', 3, Author::class, 'firstName'])]
     public function testOptionSubscription(string $subscriptionOption, int $numberOfSubscriptions, string $entity, string $property): void
     {
         $this->command->execute([
@@ -170,11 +175,11 @@ public function testOptionSubscriptionWithProperties(): void
 
         self::assertNumberOfDisplayedSubscriptions(
             command: $this->command,
-            expectedNumberOfSubscriptions: 5,
+            expectedNumberOfSubscriptions: 7,
         );
         self::assertNumberOfDisplayedEntities(
             command: $this->command,
-            expectedNumberOfEntities: 5,
+            expectedNumberOfEntities: 7,
             entityClass: Author::class,
         );
     }
@@ -191,12 +196,12 @@ public function testInteractiveMode(): void
 
         self::assertNumberOfDisplayedEntities(
             command: $this->command,
-            expectedNumberOfEntities: 2,
+            expectedNumberOfEntities: 3,
             entityClass: Author::class,
         );
         self::assertNumberOfDisplayedProperties(
             command: $this->command,
-            expectedNumberOfProperties: 2,
+            expectedNumberOfProperties: 3,
             property: 'lastName',
         );
     }
@@ -213,7 +218,7 @@ public function testInteractiveModeWithAllProperties(): void
 
         self::assertNumberOfDisplayedEntities(
             command: $this->command,
-            expectedNumberOfEntities: 5,
+            expectedNumberOfEntities: 7,
             entityClass: Author::class,
         );
         self::assertNumberOfDisplayedProperties(
@@ -223,12 +228,12 @@ public function testInteractiveModeWithAllProperties(): void
         );
         self::assertNumberOfDisplayedProperties(
             command: $this->command,
-            expectedNumberOfProperties: 2,
+            expectedNumberOfProperties: 3,
             property: 'firstName',
         );
         self::assertNumberOfDisplayedProperties(
             command: $this->command,
-            expectedNumberOfProperties: 2,
+            expectedNumberOfProperties: 3,
             property: 'lastName',
         );
     }

tests/Functional/DebugCommand/Controller/PostController.php

@@ -8,6 +8,7 @@
 use Sofascore\PurgatoryBundle\Attribute\RouteParamValue\CompoundValues;
 use Sofascore\PurgatoryBundle\Attribute\RouteParamValue\DynamicValues;
 use Sofascore\PurgatoryBundle\Attribute\RouteParamValue\EnumValues;
+use Sofascore\PurgatoryBundle\Attribute\RouteParamValue\ExpressionValues;
 use Sofascore\PurgatoryBundle\Attribute\RouteParamValue\RawValues;
 use Sofascore\PurgatoryBundle\Attribute\Target\ForGroups;
 use Sofascore\PurgatoryBundle\Listener\Enum\Action;
@@ -73,4 +74,15 @@ public function list()
     public function filterByAuthorAndTag(Author $author)
     {
     }
+
+    #[Route('/author-full-name/{full_name}', 'post_filter_by_author_full_name')]
+    #[PurgeOn(Author::class,
+        target: ['firstName', 'lastName'],
+        routeParams: [
+            'full_name' => new ExpressionValues('obj.firstName~"-"~obj.lastName'),
+        ],
+    )]
+    public function filterByAuthorFullName()
+    {
+    }
 }