Merge pull request #1776 from icanhazstring/feature/hsl

Add hslColor to ColorProvider

readme.md

@@ -250,6 +250,8 @@ Methods accepting a `$timezone` argument default to `date_default_timezone_get()
     rgbCssColor            // 'rgb(0,255,122)'
     safeColorName          // 'fuchsia'
     colorName              // 'Gainsbor'
+    hslColor               // '340,50,20'
+    hslColorAsArray        // array(340,50,20)
 
 ### `Faker\Provider\File`
 

src/Faker/Provider/Color.php

@@ -113,4 +113,31 @@ public static function colorName()
     {
         return static::randomElement(static::$allColorNames);
     }
+
+    /**
+     * @example '340,50,20'
+     * @return string
+     */
+    public static function hslColor()
+    {
+        return sprintf(
+            '%s,%s,%s',
+            static::numberBetween(0, 360),
+            static::numberBetween(0, 100),
+            static::numberBetween(0, 100)
+        );
+    }
+
+    /**
+     * @example array(340, 50, 20)
+     * @return array
+     */
+    public static function hslColorAsArray()
+    {
+        return array(
+            static::numberBetween(0, 360),
+            static::numberBetween(0, 100),
+            static::numberBetween(0, 100)
+        );
+    }
 }

test/Faker/Provider/ColorTest.php

@@ -51,4 +51,16 @@ public function testColorName()
     {
         $this->assertRegExp('/^[\w]+$/', Color::colorName());
     }
+
+    public function testHslColor()
+    {
+        $regexp360 = '(?:36[0]|3[0-5][0-9]|[12][0-9][0-9]|[1-9]?[0-9])';
+        $regexp100 = '(?:100|[1-9]?[0-9])';
+        $this->assertRegExp('/^' . $regexp360 . ',' . $regexp100 . ',' . $regexp100 . '$/', Color::hslColor());
+    }
+
+    public function testHslColorArray()
+    {
+        $this->assertCount(3, Color::hslColorAsArray());
+    }
 }