tarsana / functional

src/list.php

Doc Comments -70 removed lines

@@ -11,8 +11,6 @@ 
  * ```
  *
  * @signature (a -> b) -> [a] -> [b]
- * @param  callable $fn
- * @param  array $list
  * @return array
  */
 function map() {
@@ -31,8 +29,6 @@ 
  * ```
  *
  * @signature (a -> [b]) -> [a] -> [b]
- * @param  callable $fn
- * @param  array $list
  * @return array
  */
 function chain() {
@@ -51,8 +47,6 @@ 
  * $numeric($list) // [1, 3]
  * ```
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $fn
- * @param  array $list
  * @return array
  */
 function filter() {
@@ -72,9 +66,6 @@ 
  * ```
  *
  * @signature (* -> a -> *) -> * -> [a] -> *
- * @param  callable $fn
- * @param  mixed $initial
- * @param  array $list
  * @return array
  */
 function reduce() {
@@ -99,8 +90,6 @@ 
  * ```
  *
  * @signature (a -> *) -> [a] -> [a]
- * @param  callable $fn
- * @param  array $list
  * @return array
  */
 function each() {
@@ -252,8 +241,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> Boolean
- * @param  callable $predicate
- * @param  array $list
  * @return bool
  */
 function all() {
@@ -273,8 +260,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> Boolean
- * @param  callable $predicate
- * @param  array $list
  * @return bool
  */
 function any() {
@@ -293,8 +278,6 @@ 
  *
  * @signature [*] -> [*] -> [*]
  * @signature String -> String -> String
- * @param  array $list1
- * @param  array $list2
  * @return array
  */
 function concat() {
@@ -314,7 +297,6 @@ 
  * ```
  *
  * @signature [[a]] -> [a]
- * @param  array $lists
  * @return array
  */
 function concatAll() {
@@ -338,9 +320,6 @@ 
  *
  * @signature Number -> a -> [a] -> [a]
  * @signature Number -> String -> String -> String
- * @param  int $position
- * @param  mixed $item
- * @param  array $list
  * @return array
  */
 function insert() {
@@ -365,9 +344,6 @@ 
  *
  * @signature Number -> [a] -> [a] -> [a]
  * @signature Number -> String -> String -> String
- * @param  int $position
- * @param  mixed $items
- * @param  array $list
  * @return array
  */
 function insertAll() {
@@ -388,8 +364,6 @@ 
  *
  * @signature * -> [*] -> [*]
  * @signature String -> String -> String
- * @param  mixed $item
- * @param  array $list
  * @return array
  */
 function append() {
@@ -409,8 +383,6 @@ 
  *
  * @signature a -> [a] -> [a]
  * @signature String -> String -> String
- * @param  mixed $item
- * @param  array $list
  * @return array
  */
 function prepend() {
@@ -431,8 +403,6 @@ 
  *
  * @signature Number -> [a] -> [a]
  * @signature Number -> String -> String
- * @param  int $count
- * @param  array $list
  * @return array
  */
 function take() {
@@ -461,8 +431,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function takeWhile() {
@@ -485,8 +453,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function takeLastWhile() {
@@ -510,8 +476,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function takeUntil() {
@@ -530,8 +494,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function takeLastUntil() {
@@ -556,8 +518,6 @@ 
  *
  * @signature Number -> [a] -> [a]
  * @signature Number -> String -> String
- * @param  int $count
- * @param  array $list
  * @return array
  */
 function remove() {
@@ -582,8 +542,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function removeWhile() {
@@ -602,8 +560,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function removeLastWhile() {
@@ -624,8 +580,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function removeUntil() {
@@ -645,8 +599,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> [a]
- * @param  callable $predicate
- * @param  array $list
  * @return array
  */
 function removeLastUntil() {
@@ -663,7 +615,6 @@ 
  * ```
  *
  * @signature [(k, v)] -> {k: v}
- * @param  array $pairs
  * @return stdClass
  */
 function fromPairs() {
@@ -689,8 +640,6 @@ 
  *
  * @signature Number -> [a] -> [[a]]
  * @signature Number -> String -> [String]
- * @param  int $size
- * @param  array $list
  * @return array
  */
 function slices() {
@@ -715,8 +664,6 @@ 
  *
  * @signature a -> [a] -> Boolean
  * @signature String -> String -> Boolean
- * @param  mixed $item
- * @param  array|string $list
  * @return bool
  */
 function contains() {
@@ -737,8 +684,6 @@ 
  *
  * @signature (a -> Boolean) -> [a] -> Maybe(Number)
  * @signature (v -> Boolean) -> {k: v} -> Maybe(k)
- * @param  callable $predicate
- * @param  array $list
  * @return mixed
  */
 function findIndex() {
@@ -763,8 +708,6 @@ 
  *
  * @signature (a -> Boolean) -> [a] -> Maybe(Number)
  * @signature (v -> Boolean) -> {k: v} -> Maybe(k)
- * @param  callable $predicate
- * @param  array $list
  * @return mixed
  */
 function findLastIndex() {
@@ -787,8 +730,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> Maybe(a)
- * @param  callable $predicate
- * @param  array $list
  * @return mixed
  */
 function find() {
@@ -807,8 +748,6 @@ 
  * ```
  *
  * @signature (a -> Boolean) -> [a] -> Maybe(a)
- * @param  callable $predicate
- * @param  array $list
  * @return mixed
  */
 function findLast() {
@@ -834,8 +773,6 @@ 
  * @signature a -> [a] -> Maybe(Number) 
  * @signature v -> {k: v} -> Maybe(k)
  * @signature String -> String -> Maybe(Number)
- * @param  mixed $item
- * @param  array $list
  * @return int
  */
 function indexOf() {
@@ -863,8 +800,6 @@ 
  *
  * @signature a -> [a] -> Number 
  * @signature String -> String -> Number
- * @param  mixed $item
- * @param  array $list
  * @return int
  */
 function lastIndexOf() {
@@ -888,8 +823,6 @@ 
  * ```
  *
  * @signature (a -> a -> Boolean) -> [a] -> [a]
- * @param  callable $areEqual
- * @param  array $list
  * @return array
  */
 function uniqueBy() {
@@ -917,7 +850,6 @@ 
  * ```
  *
  * @signature [a] -> [a]
- * @param  array $list
  * @return array
  */
 function unique() {
@@ -951,8 +883,6 @@ 
  * ```
  *
  * @signature (a -> String) -> [a] -> {String: a}
- * @param  callable $fn
- * @param  array $list
  * @return array
  */
 function groupBy() {

Spacing +15 added lines, -15 removed lines

@@ -56,7 +56,7 @@ 
  * @return array
  */
 function filter() {
-    $filter = function($fn, $list){
+    $filter = function($fn, $list) {
         return array_values(array_filter($list, $fn));
     };
     return apply(curry($filter), func_get_args());
@@ -78,7 +78,7 @@ 
  * @return array
  */
 function reduce() {
-    $reduce = function($fn, $initial, $list){
+    $reduce = function($fn, $initial, $list) {
         return array_reduce($list, $fn, $initial);
     };
     return apply(curry($reduce), func_get_args());
@@ -104,7 +104,7 @@ 
  * @return array
  */
 function each() {
-    $each = function($fn, $list){
+    $each = function($fn, $list) {
         foreach ($list as $item) {
             apply($fn, [$item]);
         }
@@ -128,7 +128,7 @@ 
  * @return mixed
  */
 function head($list) {
-    if(is_string($list))
+    if (is_string($list))
         return substr($list, 0, 1);
     return (count($list) > 0)
         ? $list[0]
@@ -150,7 +150,7 @@ 
  * @return mixed
  */
 function last($list) {
-    if(is_string($list))
+    if (is_string($list))
         return substr($list, -1);
     return (count($list) > 0)
         ? $list[count($list) - 1]
@@ -173,7 +173,7 @@ 
  * @return array
  */
 function init($list) {
-    if(is_string($list))
+    if (is_string($list))
         return (strlen($list) > 1)
             ? substr($list, 0, strlen($list) - 1)
             : '';
@@ -198,7 +198,7 @@ 
  * @return array
  */
 function tail($list) {
-    if(is_string($list))
+    if (is_string($list))
         return (strlen($list) > 1)
             ? substr($list, 1)
             : '';
@@ -393,7 +393,7 @@ 
  * @return array
  */
 function append() {
-    $append = function ($item, $list) {
+    $append = function($item, $list) {
         return concat($list, [$item]);
     };
     return apply(curry($append), func_get_args());
@@ -439,7 +439,7 @@ 
     $take = function($count, $list) {
         if ($count > $length || $count < -$length)
             return [];
-        if(is_string($list)) {
+        if (is_string($list)) {
             return ($count >= 0)
                 ? substr($list, 0, $count)
                 : substr($list, $count);
@@ -695,9 +695,9 @@ 
  */
 function slices() {
     $slices = function($size, $list) {
-        if(empty($list))
+        if (empty($list))
             return is_string($list) ? '' : [];
-        if(length($list) <= $size)
+        if (length($list) <= $size)
             return [$list];
         return prepend(take($size, $list), slices($size, remove($size, $list)));
     };
@@ -770,7 +770,7 @@ 
 function findLastIndex() {
     $findLastIndex = function($predicate, $list) {
         foreach (reverse(toPairs($list)) as $pair) {
-            if($predicate($pair[1]))
+            if ($predicate($pair[1]))
                 return $pair[0];
         }
         return null;
@@ -842,7 +842,7 @@ 
     $indexOf = function($item, $list) {
         if (is_string($list)) {
             $index = strpos($list, $item);
-            return (-1 == $index)
+            return (- 1 == $index)
                 ? null
                 : $index;
         }
@@ -871,7 +871,7 @@ 
     $lastIndexOf = function($item, $list) {
         if (is_string($list)) {
             $index = strrpos($list, $item);
-            return (-1 == $index)
+            return (- 1 == $index)
                 ? null
                 : $index;
         }
@@ -959,7 +959,7 @@ 
     $groupBy = function($fn, $list) {
         return reduce(function($result, $item) use($fn) {
             $index = $fn($item);
-            if (! isset($result[$index]))
+            if (!isset($result[$index]))
                 $result[$index] = [];
             $result[$index][] = $item;
             return $result;

Braces +39 added lines, -26 removed lines

@@ -128,8 +128,9 @@ 
  * @return mixed
  */
 function head($list) {
-    if(is_string($list))
-        return substr($list, 0, 1);
+    if(is_string($list)) {
+            return substr($list, 0, 1);
+    }
     return (count($list) > 0)
         ? $list[0]
         : null;
@@ -150,8 +151,9 @@ 
  * @return mixed
  */
 function last($list) {
-    if(is_string($list))
-        return substr($list, -1);
+    if(is_string($list)) {
+            return substr($list, -1);
+    }
     return (count($list) > 0)
         ? $list[count($list) - 1]
         : null;
@@ -173,10 +175,11 @@ 
  * @return array
  */
 function init($list) {
-    if(is_string($list))
-        return (strlen($list) > 1)
+    if(is_string($list)) {
+            return (strlen($list) > 1)
             ? substr($list, 0, strlen($list) - 1)
             : '';
+    }
     return (count($list) > 1)
         ? array_slice($list, 0, count($list) - 1)
         : [];
@@ -198,10 +201,11 @@ 
  * @return array
  */
 function tail($list) {
-    if(is_string($list))
-        return (strlen($list) > 1)
+    if(is_string($list)) {
+            return (strlen($list) > 1)
             ? substr($list, 1)
             : '';
+    }
     return (count($list) > 1)
         ? array_slice($list, 1)
         : [];
@@ -299,8 +303,9 @@ 
  */
 function concat() {
     $concat = function($list1, $list2) {
-        if (is_string($list1))
-            return $list1 . $list2;
+        if (is_string($list1)) {
+                    return $list1 . $list2;
+        }
         return array_merge($list1, $list2);
     };
     return apply(curry($concat), func_get_args());
@@ -372,8 +377,9 @@ 
  */
 function insertAll() {
     $insertAll = function($position, $items, $list) {
-        if ($position < 0)
-            $position = length($list) - $position;
+        if ($position < 0) {
+                    $position = length($list) - $position;
+        }
         return concatAll([take($position, $list), $items, remove($position, $list)]);
     };
     return apply(curry($insertAll), func_get_args());
@@ -437,8 +443,9 @@ 
  */
 function take() {
     $take = function($count, $list) {
-        if ($count > $length || $count < -$length)
-            return [];
+        if ($count > $length || $count < -$length) {
+                    return [];
+        }
         if(is_string($list)) {
             return ($count >= 0)
                 ? substr($list, 0, $count)
@@ -563,8 +570,9 @@ 
 function remove() {
     $remove = function($count, $list) {
         $length = length($list);
-        if ($count > $length || $count < -$length)
-            return [];
+        if ($count > $length || $count < -$length) {
+                    return [];
+        }
         return ($count > 0) 
             ? take($count - $length)
             : take($count + $length);
@@ -695,10 +703,12 @@ 
  */
 function slices() {
     $slices = function($size, $list) {
-        if(empty($list))
-            return is_string($list) ? '' : [];
-        if(length($list) <= $size)
-            return [$list];
+        if(empty($list)) {
+                    return is_string($list) ? '' : [];
+        }
+        if(length($list) <= $size) {
+                    return [$list];
+        }
         return prepend(take($size, $list), slices($size, remove($size, $list)));
     };
     return apply(curry($slices), func_get_args());
@@ -744,8 +754,9 @@ 
 function findIndex() {
     $findIndex = function($predicate, $list) {
         foreach ($list as $key => $value) {
-            if ($predicate($value))
-                return $key;
+            if ($predicate($value)) {
+                            return $key;
+            }
         }
         return null;
     };
@@ -770,8 +781,9 @@ 
 function findLastIndex() {
     $findLastIndex = function($predicate, $list) {
         foreach (reverse(toPairs($list)) as $pair) {
-            if($predicate($pair[1]))
-                return $pair[0];
+            if($predicate($pair[1])) {
+                            return $pair[0];
+            }
         }
         return null;
     };
@@ -959,8 +971,9 @@ 
     $groupBy = function($fn, $list) {
         return reduce(function($result, $item) use($fn) {
             $index = $fn($item);
-            if (! isset($result[$index]))
-                $result[$index] = [];
+            if (! isset($result[$index])) {
+                            $result[$index] = [];
+            }
             $result[$index][] = $item;
             return $result;
         }, [], $list);

src/object.php

Doc Comments -5 removed lines

@@ -27,7 +27,6 @@ 
  * ```
  *
  * @signature {k: v} -> {k: v}
- * @param  object $object
  * @return array
  */
 function attributes() {
@@ -95,8 +94,6 @@ 
  * ```
  *
  * @signature String|Number -> [key => *] -> Boolean
- * @param  string $name
- * @param  array $object
  * @return mixed
  */
 function has() {
@@ -125,8 +122,6 @@ 
  * ```
  *
  * @signature k -> {k: v} -> Maybe(v)
- * @param  string $name
- * @param  array $object
  * @return mixed
  */
 function get() {

Spacing +2 added lines, -2 removed lines

@@ -100,7 +100,7 @@ 
  * @return mixed
  */
 function has() {
-    $has = function($name, $object){
+    $has = function($name, $object) {
         return contains($name, keys($object));
     };
     return apply(curry($has), func_get_args());
@@ -130,7 +130,7 @@ 
  * @return mixed
  */
 function get() {
-    $get = function($name, $object){
+    $get = function($name, $object) {
         $object = attributes($object);
         return has($name, $object)
             ? $object[$name]

Braces +3 added lines, -2 removed lines

@@ -32,8 +32,9 @@
  */
 function attributes() {
     $attrs = function($object) {
-        if (is_object($object))
-            return get_object_vars($object);
+        if (is_object($object)) {
+                    return get_object_vars($object);
+        }
         return $object;
     };
     return apply(curry($attrs), func_get_args());

src/operators.php

Doc Comments -19 removed lines

@@ -8,8 +8,6 @@ 
  * Returns `$a && $b`.
  *
  * @signature Boolean -> Boolean -> Boolean
- * @param  bool $a
- * @param  bool $b
  * @return bool
  */
 function and_() {
@@ -22,8 +20,6 @@ 
  * Returns `$a || $b`.
  *
  * @signature Boolean -> Boolean -> Boolean
- * @param  bool $a
- * @param  bool $b
  * @return bool
  */
 function or_() {
@@ -36,7 +32,6 @@ 
  * Returns `!$x`.
  *
  * @signature Boolean -> Boolean
- * @param  bool $x
  * @return bool
  */
 function not() {
@@ -50,8 +45,6 @@ 
  * Returns `$x == $y`.
  *
  * @signature * -> * -> Boolean
- * @param  mixed $a
- * @param  mixed $b
  * @return bool
  */
 function eq() {
@@ -64,8 +57,6 @@ 
  * Returns `$x === $y`.
  *
  * @signature * -> * -> Boolean
- * @param  mixed $a
- * @param  mixed $b
  * @return bool
  */
 function eqq() {
@@ -90,8 +81,6 @@ 
  * ```
  *
  * @signature * -> * -> Boolean
- * @param  mixed $a
- * @param  mixed $b
  * @return bool
  */
 function equals() {
@@ -129,8 +118,6 @@ 
  * Returns `$a < $b`.
  *
  * @signature * -> * -> Boolean
- * @param  mixed $a
- * @param  mixed $b
  * @return bool
  */
 function lt() {
@@ -143,8 +130,6 @@ 
  * Returns `$a <= $b`.
  *
  * @signature * -> * -> Boolean
- * @param  mixed $a
- * @param  mixed $b
  * @return bool
  */
 function lte() {
@@ -157,8 +142,6 @@ 
  * Returns `$a > $b`.
  *
  * @signature * -> * -> Boolean
- * @param  mixed $a
- * @param  mixed $b
  * @return bool
  */
 function gt() {
@@ -171,8 +154,6 @@ 
  * Returns `$a >= $b`.
  *
  * @signature * -> * -> Boolean
- * @param  mixed $a
- * @param  mixed $b
  * @return bool
  */
 function gte() {

Spacing +9 added lines, -11 removed lines

@@ -13,7 +13,7 @@ 
  * @return bool
  */
 function and_() {
-    return apply(curry(function($a, $b){
+    return apply(curry(function($a, $b) {
         return $a && $b;
     }), func_get_args());
 }
@@ -27,7 +27,7 @@ 
  * @return bool
  */
 function or_() {
-    return apply(curry(function($a, $b){
+    return apply(curry(function($a, $b) {
         return $a || $b;
     }), func_get_args());
 }
@@ -55,7 +55,7 @@ 
  * @return bool
  */
 function eq() {
-    return apply(curry(function($a, $b){
+    return apply(curry(function($a, $b) {
         return $a == $b;
     }), func_get_args());
 }
@@ -69,7 +69,7 @@ 
  * @return bool
  */
 function eqq() {
-    return apply(curry(function($a, $b){
+    return apply(curry(function($a, $b) {
         return $a === $b;
     }), func_get_args());
 }
@@ -112,9 +112,7 @@ 
                     return $a == $b;
                 case 'List':
                     $length = length($a);
-                    return length($b) != $length ? false :
-                           0 == $length ? true :
-                           equals(head($a), head($b)) && equals(tail($a), tail($b));
+                    return length($b) != $length ? false : 0 == $length ? true : equals(head($a), head($b)) && equals(tail($a), tail($b));
                 case 'Array':
                 case 'ArrayObject':
                 case 'Object':
@@ -134,7 +132,7 @@ 
  * @return bool
  */
 function lt() {
-    return apply(curry(function($a, $b){
+    return apply(curry(function($a, $b) {
         return $a < $b;
     }), func_get_args());
 }
@@ -148,7 +146,7 @@ 
  * @return bool
  */
 function lte() {
-    return apply(curry(function($a, $b){
+    return apply(curry(function($a, $b) {
         return $a <= $b;
     }), func_get_args());
 }
@@ -162,7 +160,7 @@ 
  * @return bool
  */
 function gt() {
-    return apply(curry(function($a, $b){
+    return apply(curry(function($a, $b) {
         return $a > $b;
     }), func_get_args());
 }
@@ -176,7 +174,7 @@ 
  * @return bool
  */
 function gte() {
-    return apply(curry(function($a, $b){
+    return apply(curry(function($a, $b) {
         return $a >= $b;
     }), func_get_args());
 }

Braces +3 added lines, -2 removed lines

@@ -97,8 +97,9 @@
 function equals() {
     $equals = function($a, $b) {
             $type = type($a);
-            if ($type != type($b))
-                return false;
+            if ($type != type($b)) {
+                            return false;
+            }
             switch ($type) {
                 case 'Null':
                 case 'Boolean':