Implemented reference time parameter (#10)

README.md

@@ -49,6 +49,8 @@ examples supported as of version 0.1.5:
 
 ## Configuration
 
+### Non-ignorable errors
+
 Errors emitted by the extension are non-ignorable by default, so they cannot accidentally be put into the baseline.
 You can change this behaviour with a configuration option within your `phpstan.neon`:
 
@@ -58,6 +60,29 @@ parameters:
         nonIgnorable: false # default is true
 ```
 
+### Reference time
+
+By default comments are checked against todays date.
+
+You might be interested, which comments will expire e.g. within the next 7 days, which can be configured with the `referenceTime` option.
+You need to configure a date parsable by `strtotime`.
+
+```neon
+parameters:
+    todo_by:
+        referenceTime: "now+7days"
+```
+
+It can be especially handy to use a env variable for it, so you can pass the reference date e.g. via the CLI:
+
+```neon
+parameters:
+    todo_by:
+        referenceTime: %env.TODOBY_REF_TIME%
+```
+
+`TODOBY_REF_TIME="now+7days" vendor/bin/phpstan analyze`
+
 ## Installation
 
 To use this extension, require it in [Composer](https://getcomposer.org/):

extension.neon

@@ -1,16 +1,19 @@
 parametersSchema:
     todo_by: structure([
         nonIgnorable: bool()
+        referenceTime: string()
     ])
 
 # default parameters
 parameters:
     todo_by:
         nonIgnorable: true
+        referenceTime: "now"
 
 services:
     -
         class: staabm\PHPStanTodoBy\TodoByRule
         tags: [phpstan.rules.rule]
         arguments:
             - %todo_by.nonIgnorable%
+            - %todo_by.referenceTime%

src/TodoByRule.php

@@ -7,6 +7,7 @@
 use PHPStan\Node\VirtualNode;
 use PHPStan\Rules\Rule;
 use PHPStan\Rules\RuleErrorBuilder;
+use PHPStan\ShouldNotHappenException;
 use function preg_match_all;
 use function strtotime;
 use function substr_count;
@@ -34,9 +35,15 @@ final class TodoByRule implements Rule
     private int $now;
     private bool $nonIgnorable;
 
-    public function __construct(bool $nonIgnorable)
+    public function __construct(bool $nonIgnorable, string $referenceTime)
     {
-        $this->now = time();
+        $time =  strtotime($referenceTime);
+
+        if ($time === false) {
+            throw new \RuntimeException('Unable to parse reference time "' . $referenceTime . '"');
+        }
+
+        $this->now = $time;
         $this->nonIgnorable = $nonIgnorable;
     }
 

tests/TodoByRuleTest.php

@@ -11,13 +11,16 @@
  */
 final class TodoByRuleTest extends RuleTestCase
 {
+    private string $referenceTime;
     protected function getRule(): Rule
     {
-        return new TodoByRule(true);
+        return new TodoByRule(true, $this->referenceTime);
     }
 
     public function testRule(): void
     {
+        $this->referenceTime = "now";
+
         $this->analyse([__DIR__ . '/data/example.php'], [
             [
                 'Expired on 2023-12-14: Expired comment1',
@@ -105,4 +108,23 @@ public function testRule(): void
             ],
         ]);
     }
+
+    public function testReferenceTime(): void
+    {
+        $this->referenceTime = "1st january 2023";
+
+        $this->analyse([__DIR__ . '/data/referenceTime.php'], []);
+    }
+
+    public function testReferenceTime2(): void
+    {
+        $this->referenceTime = "18th january 2023";
+
+        $this->analyse([__DIR__ . '/data/referenceTime.php'], [
+            [
+                'Expired on 2023-01-14: fix it',
+                5,
+            ],
+        ]);
+    }
 }

tests/data/referenceTime.php

@@ -0,0 +1,6 @@
+<?php
+
+namespace ReferenceTime;
+
+// todo - 2023-01-14 fix it
+