tarsana / functional

build.php

Doc Comments -3 removed lines

@@ -634,8 +634,6 @@ 
  * Gets an element of the stream methods list.
  *
  * @signature String -> Block -> String
- * @param  string $moduleName
- * @param  object $block
  * @return string
  */
 function stream_method_link() {
@@ -661,7 +659,6 @@ 
  * Dump a variable and returns it.
  *
  * @signature a -> a
- * @param  mixed $something
  * @return mixed
  */
 function log() {

Spacing +15 added lines, -15 removed lines

@@ -116,7 +116,7 @@ 
  * @return array
  */
 function get_modules() {
-    $composer = json_decode(file_get_contents(__DIR__.'/composer.json'));
+    $composer = json_decode(file_get_contents(__DIR__ . '/composer.json'));
     return $composer->autoload->files;
 }
 
@@ -147,10 +147,10 @@ 
  */
 function write_module($module) {
     if ($module->docs) {
-        $docsDir  = dirname($module->docsPath);
+        $docsDir = dirname($module->docsPath);
         if (!is_dir($docsDir))
             mkdir($docsDir, 0777, true);
-        file_put_contents($module->docsPath,  $module->docs);
+        file_put_contents($module->docsPath, $module->docs);
     }
     if ($module->tests) {
         $testsDir = dirname($module->testsPath);
@@ -179,7 +179,7 @@ 
         'fill_docs_path',
         'fill_tests_path',
         'fill_blocks'
-    ]), [(object)['path' => $path]]);
+    ]), [(object) ['path' => $path]]);
 }
 
 /**
@@ -233,8 +233,8 @@ 
 function fill_blocks($module) {
     $module->blocks = apply(pipe(
         prepend('dox -r < '), // "dox -r < src/...php"
-        'shell_exec',         // "[{...}, ...]"
-        'json_decode',        // [DoxBlock]
+        'shell_exec', // "[{...}, ...]"
+        'json_decode', // [DoxBlock]
         map(_f('make_block'))
         // sort()
     ), [$module->path]);
@@ -256,7 +256,7 @@ 
     if (has('class', $tags)) $type = 'class';
     if (has('method', $tags)) $type = 'method';
 
-    $params = map(function($tag){
+    $params = map(function($tag) {
         $parts = split(' ', get('value', $tag));
         return [
             'type' => $parts[0],
@@ -292,7 +292,7 @@ 
  */
 function tags_of($doxBlock) {
     if ($doxBlock->tags)
-        return map(function($tag){
+        return map(function($tag) {
             return (object) [
                 'name'  => $tag->type,
                 'value' => $tag->string
@@ -341,7 +341,7 @@ 
  * @return object
  */
 function generate_docs_sommaire($module) {
-    $blocks = filter (
+    $blocks = filter(
         satisfiesAll(['ignore' => not(), 'internal' => not(), 'type' => equals('function')]),
         $module->blocks
     );
@@ -371,7 +371,7 @@ 
  * @return object
  */
 function generate_docs_contents($module) {
-    $blocks = filter (
+    $blocks = filter(
         satisfiesAll(['ignore' => not(), 'internal' => not()]),
         $module->blocks
     );
@@ -429,7 +429,7 @@ 
     $additionalNamespace = replace("/", "\\", remove(6, dirname($module->testsPath)));
     if ($additionalNamespace)
         $namespace .= "\\" . $additionalNamespace;
-    $name = remove(-4, last(split("/", $module->testsPath)));
+    $name = remove(- 4, last(split("/", $module->testsPath)));
     $module->tests .= "<?php namespace {$namespace};\n\nuse Tarsana\Functional as F;\n\nclass {$name} extends \Tarsana\UnitTests\Functional\UnitTest {\n";
     return $module;
 }
@@ -442,7 +442,7 @@ 
  * @return object
  */
 function generate_tests_contents($module) {
-    $blocks = filter (
+    $blocks = filter(
         satisfiesAll(['ignore' => not()]),
         $module->blocks
     );
@@ -499,7 +499,7 @@ 
     if (!contains('```php', $description))
         return '';
     $code = remove(7 + indexOf('```php', $description), $description);
-    return remove(-4, trim($code));
+    return remove(- 4, trim($code));
 }
 
 /**
@@ -552,7 +552,7 @@ 
  * @return array
  */
 function generate_stream_operations($module) {
-    $blocks = filter (
+    $blocks = filter(
         satisfiesAll(['ignore' => equals(false), 'stream' => equals(true)]),
         $module->blocks
     );
@@ -621,7 +621,7 @@ 
  * @return array
  */
 function generate_stream_methods($module) {
-    $blocks = filter (
+    $blocks = filter(
         satisfiesAll(['ignore' => equals(false), 'stream' => equals(true)]),
         $module->blocks
     );

src/Classes/Stream.php

Doc Comments +4 added lines, -5 removed lines

@@ -36,7 +36,7 @@ 
      * Creates a new Stream.
      *
      * @param  mixed $data
-     * @return Tarsana\Functional\Stream
+     * @return Stream
      */
     public static function of($data)
     {
@@ -47,7 +47,7 @@ 
      * Adds a new operation to the Stream class.
      *
      * @param  string $name
-     * @param  string $signature
+     * @param  string $signatures
      * @param  callable $fn
      * @return void
      */
@@ -65,7 +65,7 @@ 
      * Checks if the Stream class has an operation with the given name.
      *
      * @param  string  $name
-     * @return boolean
+     * @return \PHPUnit_Framework_Constraint_TraversableContains
      */
     public static function hasOperation($name)
     {
@@ -87,7 +87,6 @@ 
     /**
      * Creates a new Stream with some data.
      *
-     * @param mixed $data
      */
     protected function __construct($stream)
     {
@@ -120,7 +119,7 @@ 
      *
      * @param  string $name The name of the operation
      * @param  array  $args
-     * @return Tarsana\Functional\Stream
+     * @return Stream
      */
     public function __call($name, $args)
     {

Spacing +1 added lines, -1 removed lines

@@ -53,7 +53,7 @@
      */
     public static function operation($name, $signatures, $fn = null)
     {
-        if (! is_array($signatures)) {
+        if (!is_array($signatures)) {
             $signatures = [$signatures];
         }
         foreach ($signatures as $signature) {

src/common.php

Doc Comments -4 removed lines

@@ -26,7 +26,6 @@ 
  * ```
  *
  * @signature * -> String
- * @param  mixed $data
  * @return string
  */
 function type() {
@@ -73,8 +72,6 @@ 
  *
  * @stream
  * @signature String -> * -> Boolean
- * @param  string $type
- * @param  mixed $data
  * @return boolean
  */
 function is() {
@@ -109,7 +106,6 @@ 
  *
  * @stream
  * @signature * -> String
- * @param  mixed $something
  * @return string
  */
 function toString () {

Spacing +4 added lines, -4 removed lines

@@ -114,7 +114,7 @@ 
  * @param  mixed $something
  * @return string
  */
-function toString () {
+function toString() {
     static $toString = false;
     $toString = $toString ?: curry(function($something) {
         switch (type($something)) {
@@ -137,11 +137,11 @@ 
                 return $something->__toString();
             case 'Object':
             case 'Array':
-                return '{' . join(', ', map(function($pair){
-                    return $pair[0].': '. toString($pair[1]);
+                return '{' . join(', ', map(function($pair) {
+                    return $pair[0] . ': ' . toString($pair[1]);
                 }, toPairs($something))) . '}';
             default:
-                return '['.type($something).']';
+                return '[' . type($something) . ']';
         }
     });
     return _apply($toString, func_get_args());

src/Internal/_stream.php

Doc Comments +1 added lines, -6 removed lines

@@ -40,7 +40,7 @@ 
  * Returns supported types in signatures.
  *
  * @signature List
- * @return array
+ * @return string[]
  */
 function _stream_types() {
     return [
@@ -126,7 +126,6 @@ 
  * @signature String -> String -> Maybe(Function) -> Operation
  * @param  string $name
  * @param  string $signature
- * @param  callable $fn
  * @return array
  */
 function _stream_operation($name, $signature, $callable = null) {
@@ -190,8 +189,6 @@ 
  * F\_stream_ensure_type('List -> Bar', 'Bar'); // throws "Stream: invalid signature 'List -> Bar' it should follow the syntax 'TypeArg1 -> TypeArg2 -> ... -> ReturnType' and types to use are Boolean, Number, String, Resource, Function, List, Array, Object, Any"
  * ```
  * @signature String -> String -> String
- * @param  string $signature
- * @param  string $type
  * @return string
  */
 function _stream_ensure_type() {
@@ -491,8 +488,6 @@ 
  * ```
  *
  * @signature [String] -> Operation -> Boolean
- * @param  array $argsTypes
- * @param  array $operation
  * @return bool
  */
 function _stream_operation_is_applicable() {

Spacing +2 added lines, -2 removed lines

@@ -167,7 +167,7 @@ 
     if (length($parts) < 2)
         _stream_throw_error('invalid-signature', $text);
 
-    return reduce(function($result, $part){
+    return reduce(function($result, $part) {
         return chain(function($item) use($result){
             return map(append($item), $result);
         }, $part);
@@ -197,7 +197,7 @@ 
  */
 function _stream_ensure_type() {
     $ensureType = function($signature, $type) {
-        if (! contains($type, _stream_types()))
+        if (!contains($type, _stream_types()))
             _stream_throw_error('invalid-signature', $signature);
         return $type;
     };

src/math.php

Doc Comments -23 removed lines

@@ -14,8 +14,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  int|float $x
- * @param  int|float $y
  * @return int|float
  */
 function plus() {
@@ -35,8 +33,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  int|float $x
- * @param  int|float $y
  * @return int|float
  */
 function minus() {
@@ -57,7 +53,6 @@ 
  *
  * @stream
  * @signature Number -> Number
- * @param  int|float $x
  * @return int|float
  */
 function negate() {
@@ -78,8 +73,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  int|float $x
- * @param  int|float $y
  * @return int|float
  */
 function multiply() {
@@ -99,8 +92,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  int|float $x
- * @param  int|float $y
  * @return int|float
  */
 function divide() {
@@ -120,8 +111,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  int|float $x
- * @param  int|float $y
  * @return int|float
  */
 function modulo() {
@@ -142,7 +131,6 @@ 
  *
  * @stream
  * @signature [Number] -> Number
- * @param  array $numbers
  * @return int|float
  */
 function sum() {
@@ -163,7 +151,6 @@ 
  *
  * @stream
  * @signature [Number] -> Number
- * @param  array $numbers
  * @return int|float
  */
 function product() {
@@ -184,8 +171,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  number $a
- * @param  number $b
  * @return number
  */
 function min() {
@@ -206,9 +191,6 @@ 
  *
  * @stream
  * @signature (a -> Number) -> a -> a -> a
- * @param  callable $fn
- * @param  mixed $a
- * @param  mixed $b
  * @return mixed
  */
 function minBy() {
@@ -229,8 +211,6 @@ 
  *
  * @stream
  * @signature Number -> Number -> Number
- * @param  number $a
- * @param  number $b
  * @return number
  */
 function max() {
@@ -251,9 +231,6 @@ 
  *
  * @stream
  * @signature (a -> Number) -> a -> a -> a
- * @param  callable $fn
- * @param  mixed $a
- * @param  mixed $b
  * @return mixed
  */
 function maxBy() {

Spacing +11 added lines, -11 removed lines

@@ -20,7 +20,7 @@ 
  */
 function plus() {
     static $plus = false;
-    $plus = $plus ?: curry(function($x, $y){
+    $plus = $plus ?: curry(function($x, $y) {
         return $x + $y;
     });
     return _apply($plus, func_get_args());
@@ -41,7 +41,7 @@ 
  */
 function minus() {
     static $minus = false;
-    $minus = $minus ?: curry(function($x, $y){
+    $minus = $minus ?: curry(function($x, $y) {
         return $x - $y;
     });
     return _apply($minus, func_get_args());
@@ -62,8 +62,8 @@ 
  */
 function negate() {
     static $negate = false;
-    $negate = $negate ?: curry(function($x){
-        return -$x;
+    $negate = $negate ?: curry(function($x) {
+        return - $x;
     });
     return _apply($negate, func_get_args());
 }
@@ -84,7 +84,7 @@ 
  */
 function multiply() {
     static $multiply = false;
-    $multiply = $multiply ?: curry(function($x, $y){
+    $multiply = $multiply ?: curry(function($x, $y) {
         return $y * $x;
     });
     return _apply($multiply, func_get_args());
@@ -105,7 +105,7 @@ 
  */
 function divide() {
     static $divide = false;
-    $divide = $divide ?: curry(function($x, $y){
+    $divide = $divide ?: curry(function($x, $y) {
         return $x / $y;
     });
     return _apply($divide, func_get_args());
@@ -126,7 +126,7 @@ 
  */
 function modulo() {
     static $modulo = false;
-    $modulo = $modulo ?: curry(function($x, $y){
+    $modulo = $modulo ?: curry(function($x, $y) {
         return $x % $y;
     });
     return _apply($modulo, func_get_args());
@@ -186,7 +186,7 @@ 
  */
 function min() {
     static $min = false;
-    $min = $min ?: curry(function($a, $b){
+    $min = $min ?: curry(function($a, $b) {
         return $a < $b ? $a : $b;
     });
     return _apply($min, func_get_args());
@@ -209,7 +209,7 @@ 
  */
 function minBy() {
     static $minBy = false;
-    $minBy = $minBy ?: curry(function($fn, $a, $b){
+    $minBy = $minBy ?: curry(function($fn, $a, $b) {
         return $fn($a) < $fn($b) ? $a : $b;
     });
     return _apply($minBy, func_get_args());
@@ -231,7 +231,7 @@ 
  */
 function max() {
     static $max = false;
-    $max = $max ?: curry(function($a, $b){
+    $max = $max ?: curry(function($a, $b) {
         return $a > $b ? $a : $b;
     });
     return _apply($max, func_get_args());
@@ -254,7 +254,7 @@ 
  */
 function maxBy() {
     static $maxBy = false;
-    $maxBy = $maxBy ?: curry(function($fn, $a, $b){
+    $maxBy = $maxBy ?: curry(function($fn, $a, $b) {
         return $fn($a) > $fn($b) ? $a : $b;
     });
     return _apply($maxBy, func_get_args());

src/string.php

Doc Comments -28 removed lines

@@ -14,8 +14,6 @@ 
  *
  * @stream
  * @signature String -> String -> [String]
- * @param string $delimiter
- * @param string $string
  * @return array
  */
 function split() {
@@ -34,8 +32,6 @@ 
  *
  * @stream
  * @signature String -> [String] -> String
- * @param string $glue
- * @param array $pieces
  * @return string
  */
 function join() {
@@ -59,9 +55,6 @@ 
  *
  * @stream
  * @signature String|[String] -> String|[String] -> String -> String
- * @param  string $search
- * @param  string $replacement
- * @param  string $string
  * @return string
  */
 function replace() {
@@ -81,9 +74,6 @@ 
  *
  * @stream
  * @signature String -> String -> String -> String
- * @param  string $pattern
- * @param  string $replacement
- * @param  string $string
  * @return string
  */
 function regReplace() {
@@ -101,7 +91,6 @@ 
  *
  * @stream
  * @signature String -> String
- * @param  string $string
  * @return string
  */
 function upperCase() {
@@ -119,7 +108,6 @@ 
  *
  * @stream
  * @signature String -> String
- * @param  string $string
  * @return string
  */
 function lowerCase() {
@@ -137,7 +125,6 @@ 
  *
  * @stream
  * @signature String -> String
- * @param  string $string
  * @return string
  */
 function camelCase() {
@@ -164,8 +151,6 @@ 
  *
  * @stream
  * @signature String -> String -> String
- * @param  string $delimiter
- * @param  string $string
  * @return string
  */
 function snakeCase() {
@@ -194,8 +179,6 @@ 
  *
  * @stream
  * @signature String -> String -> Boolean
- * @param  string $token
- * @param  string $string
  * @return bool
  */
 function startsWith() {
@@ -220,8 +203,6 @@ 
  *
  * @stream
  * @signature String -> String -> Boolean
- * @param  string $token
- * @param  string $string
  * @return bool
  */
 function endsWith() {
@@ -246,8 +227,6 @@ 
  *
  * @stream
  * @signature String -> String -> Boolean
- * @param  string $pattern
- * @param  string $string
  * @return bool
  */
 function test() {
@@ -270,8 +249,6 @@ 
  *
  * @stream
  * @signature String -> String -> [String]
- * @param  string $pattern
- * @param  string $string
  * @return array
  */
 function match() {
@@ -295,8 +272,6 @@ 
  *
  * @stream
  * @signature String -> String -> Number
- * @param  string $token
- * @param  string $text
  * @return int
  */
 function occurences() {
@@ -322,9 +297,6 @@ 
  *
  * @stream
  * @signature String -> String -> String -> [String]
- * @param  string $surrounders
- * @param  string $separator
- * @param  sring $text
  * @return array
  */
 function chunks() {

Spacing +1 added lines, -1 removed lines

@@ -46,7 +46,7 @@
  */
 function join() {
     static $join = false;
-    $join = $join ?: curry(function($glue, $pieces){
+    $join = $join ?: curry(function($glue, $pieces) {
         return implode($glue, $pieces);
     });
     return _apply($join, func_get_args());

src/Classes/Error.php

Spacing +1 added lines, -1 removed lines

@@ -18,7 +18,7 @@
      * @param  Error|null $error
      * @return Error
      */
-    public static function of ($message, $code = 0, Error $error = null)
+    public static function of($message, $code = 0, Error $error = null)
     {
         return new Error($message, $code, $error);
     }

performance/run.php

Doc Comments +2 added lines, -2 removed lines

@@ -3,7 +3,7 @@ 
 /**
  * Returns the list of scripts to compare.
  *
- * @return array
+ * @return string[]
  */
 function scripts() {
     return [
@@ -101,7 +101,7 @@ 
  * and returns its running time in miliseconds.
  *
  * @param  string $path
- * @return array
+ * @return double
  */
 function execute($path, $input) {
     $start = microtime(true);

Spacing +2 added lines, -2 removed lines

@@ -79,8 +79,8 @@
  */
 function averageTime($n, $path, $test) {
     $s = 0;
-    for ($i=0; $i < $n; $i++) {
-        $s =+ execute($path, $test->input);
+    for ($i = 0; $i < $n; $i ++) {
+        $s = + execute($path, $test->input);
     }
     return $s / $n;
 }

src/object.php

Spacing +2 added lines, -2 removed lines

@@ -173,7 +173,7 @@ 
  */
 function has() {
     static $has = false;
-    $has = $has ?: curry(function($name, $object){
+    $has = $has ?: curry(function($name, $object) {
         if (is_object($object)) return isset($object->{$name});
         if (is_array($object)) return isset($object[$name]);
         return false;
@@ -208,7 +208,7 @@ 
  */
 function get() {
     static $get = false;
-    $get = $get ?: curry(function($name, $object){
+    $get = $get ?: curry(function($name, $object) {
         return is_object($object)
             ? (isset($object->{$name}) ? $object->{$name} : null)
             : (isset($object[$name]) ? $object[$name] : null);

Doc Comments -24 removed lines

@@ -22,7 +22,6 @@ 
  * ```
  *
  * @signature a -> a
- * @param  mixed $value
  * @return mixed
  */
 function clone_() {
@@ -74,7 +73,6 @@ 
  *
  * @stream
  * @signature {k: v} -> {k: v}
- * @param  object|array $object
  * @return array
  */
 function attributes() {
@@ -99,7 +97,6 @@ 
  * @stream
  * @signature [*] -> [Number]
  * @signature {k: v} -> [k]
- * @param object|array $object
  * @return array
  */
 function keys() {
@@ -124,7 +121,6 @@ 
  * @stream
  * @signature [a] -> [a]
  * @signature {k: v} -> [v]
- * @param object|array $object
  * @return array
  */
 function values() {
@@ -167,8 +163,6 @@ 
  *
  * @stream
  * @signature k -> {k: v} -> Boolean
- * @param  string|int $name
- * @param  mixed $object
  * @return bool
  */
 function has() {
@@ -202,8 +196,6 @@ 
  *
  * @stream
  * @signature k -> {k: v} -> Maybe(v)
- * @param  string $name
- * @param  array $object
  * @return mixed
  */
 function get() {
@@ -233,8 +225,6 @@ 
  *
  * @stream
  * @signature [k] -> {k: v} -> v
- * @param  array $path
- * @param  mixed $object
  * @return mixed
  */
 function getPath() {
@@ -265,9 +255,6 @@ 
  *
  * @stream
  * @signature k -> v -> {k: v} -> {k: v}
- * @param  string|int $name
- * @param  mixed $value
- * @param  mixed $object
  * @return mixed
  */
 function set() {
@@ -299,9 +286,6 @@ 
  *
  * @stream
  * @signature k -> (v -> v) -> {k: v} -> {k: v}
- * @param  string|int $name
- * @param  callable $fn
- * @param  mixed $object
  * @return mixed
  */
 function update() {
@@ -327,9 +311,6 @@ 
  *
  * @stream
  * @signature (a -> Boolean) -> k -> {k : a} -> Boolean
- * @param  callable $predicate
- * @param  string|int $key
- * @param  mixed $object
  * @return bool
  */
 function satisfies() {
@@ -362,8 +343,6 @@ 
  *
  * @stream
  * @signature {String: (a -> Boolean)} -> {k : a} -> Boolean
- * @param  array $predicates
- * @param  mixed $object
  * @return bool
  */
 function satisfiesAll() {
@@ -400,8 +379,6 @@ 
  *
  * @stream
  * @signature {String: (a -> Boolean)} -> {k : a} -> Boolean
- * @param  array $predicates
- * @param  mixed $object
  * @return bool
  */
 function satisfiesAny() {
@@ -427,7 +404,6 @@ 
  * @stream
  * @signature {k: v} -> [(k,v)]
  * @signature [v] -> [(Number,v)]
- * @param  array $object
  * @return array
  */
 function toPairs() {