low minute addition

Author: lsv

README.md

@@ -14,6 +14,11 @@ And if you have multiple hour letters you can set these in the constructor, see
 * 2t20 = 140
 * 3x84s = 264
 
+##### New in 2.0
+
+* You can now add a low minute, meaning if set it to 4, then if you write 3, it will become 3 hours, if you write 5 it will still be 5 minutes.
+* By default the `low minute` variable is NULL, meaning its not used
+
 ### Install
 
 `composer require lsv/timestringparser`
@@ -33,7 +38,13 @@ to your `composer.json`
 ### Usage
 
 By standard hour letter is `h` and minute letter is `m` but these can be customized in the constructor `new TimestringParser(['h','t','u'], ['m','x','y']);` now `h`, `t` and `u` can be used to parse the hour part of the time string, and the letters `m`, `x`, `y` can be used to parse the minute part of the time string
-  
+ 
+##### New in 2.0
+
+You can set the `low minute` variable in the constructor `new TimestringParser(['h','t','u'], ['m','x','y'], <low minute>);`
+
+It needs to be a integer
+ 
 ### Examples
 
 ```php
@@ -47,6 +58,18 @@ foreach($timestrings as $string) {
 }
 ```
 
+##### Low minute example
+
+```
+$timestrings = [1, 2, '3', '4', 5];
+$parser = new TimestringParser(['h'], ['m'], 3);
+echo $parser->parseTimeString(1); // Returns 60
+echo $parser->parseTimeString(2); // Returns 120
+echo $parser->parseTimeString('3'); // Returns 180
+echo $parser->parseTimeString('4'); // Returns 4
+echo $parser->parseTimeString(5); // Returns 5
+```
+
 ### License
 
 The MIT License (MIT)

src/TimestringParser.php

@@ -45,10 +45,19 @@ class TimestringParser
      */
     protected $hourLetters;
 
-    public function __construct(array $hourLetters = ['h'], array $minuteLetters = ['m'])
+    /**
+     * Set this to a number, and if this value is 5,
+     * then everything you write equals or lower than this, will become hours
+     *
+     * @var int
+     */
+    public $lowMinutes;
+
+    public function __construct(array $hourLetters = ['h'], array $minuteLetters = ['m'], int $lowMinutes = null)
     {
         $this->hourLetters = $hourLetters;
         $this->minuteLetters = $minuteLetters;
+        $this->lowMinutes = $lowMinutes;
     }
 
     /**
@@ -103,6 +112,12 @@ private function parseTime(string $time) : int
             return $minutes;
         }
 
+        if ($this->lowMinutes !== null) {
+            if (((int)$time) <= $this->lowMinutes) {
+                return ((int)$time) * 60;
+            }
+        }
+
         return (int) $time;
     }
 

tests/TimestringParserTest.php

@@ -12,6 +12,7 @@ class TimestringParserTest extends TestCase
     public function dataProvider()
     {
         return [
+            ['1', 1],
             ['3:20', (3 * 60) + 20],
             ['4h48', (4 * 60) + 48],
             ['3h 20m', (3 * 60) + 20],
@@ -80,4 +81,27 @@ public function test_readme_examples(string $string, int $expected) : void
         $this->assertEquals($expected, $parser->parseTimeString($string));
     }
 
+    public function dataProviderLowMinutes() : array
+    {
+        return [
+            [3, (3 * 60), 3],
+            [3, 3, 2],
+            [3, (3 * 60), 4],
+            [10, 10 * 60, 10],
+        ];
+    }
+
+    /**
+     * @dataProvider dataProviderLowMinutes
+     *
+     * @param int $number
+     * @param int $expected
+     * @param int $lowinutes
+     */
+    public function test_low_minutes(int $number, int $expected, int $lowinutes) : void
+    {
+        $parser = new TimestringParser(['h'], ['m'], $lowinutes);
+        $this->assertEquals($expected, $parser->parseTimeString($number));
+    }
+
 }