jclaveau / php-logical-filter

src/LogicalFilter.php

Doc Comments +8 added lines, -9 removed lines

@@ -247,7 +247,7 @@ 
      *
      * This helpes to ease the result of simplify()
      *
-     * @return OrRule
+     * @return LogicalFilter
      */
     public function addMinimalCase()
     {
@@ -302,7 +302,7 @@ 
      *
      * @param $debug Provides a source oriented dump.
      *
-     * @return array A description of the rules.
+     * @return string A description of the rules.
      */
     public function toString(array $options=[])
     {
@@ -377,7 +377,7 @@ 
      * @param  array|callable Associative array of renamings or callable
      *                        that would rename the fields.
      *
-     * @return string $this
+     * @return LogicalFilter $this
      */
     public function removeRules($filter)
     {
@@ -422,7 +422,7 @@ 
      * @param  array|LogicalFilter|AbstractRule $rules
      * @param  array|callable                   $options
      *
-     * @return array The rules matching the filter
+     * @return LogicalFilter The rules matching the filter
      */
     public function filterRules($rules=[], array $options=[])
     {
@@ -449,8 +449,8 @@ 
      * @param  array|callable Associative array of renamings or callable
      *                        that would rename the fields.
      *
-     * @return array The rules matching the filter
-     * @return array $options debug | leaves_only | clean_empty_branches
+     * @return LogicalFilter The rules matching the filter
+     * @return LogicalFilter $options debug | leaves_only | clean_empty_branches
      */
     public function keepLeafRulesMatching($filter=[], array $options=[])
     {
@@ -558,6 +558,7 @@ 
      * @param  array|LogicalFilter
      * @param  array|callable Associative array of renamings or callable
      *                        that would rename the fields.
+     * @param \Closure $options
      *
      * @return array          The rules matching the filter
      */
@@ -744,7 +745,6 @@ 
     }
 
     /**
-     * @param bool  $exit=false
      * @param array $options    + callstack_depth=2 The level of the caller to dump
      *                          + mode='string' in 'export' | 'dump' | 'string'
      *
@@ -839,10 +839,9 @@ 
      * Applies the current instance to a value (and its index optionnally).
      *
      * @param  mixed                  $value_to_check
-     * @param  scalar                 $index
      * @param  Filterer|callable|null $filterer
      *
-     * @return AbstractRule|false|true + False if the filter doesn't validates
+     * @return boolean + False if the filter doesn't validates
      *                                 + Null if the target has no sens (operation filtered by field for example)
      *                                 + A rule tree containing the first matching case if there is one.
      */

Unused Use Statements -1 removed lines

@@ -8,7 +8,6 @@
 namespace JClaveau\LogicalFilter;
 
 use JClaveau\LogicalFilter\Rule\AbstractRule;
-use JClaveau\LogicalFilter\Rule\AbstractOperationRule;
 use JClaveau\LogicalFilter\Rule\AndRule;
 use JClaveau\LogicalFilter\Rule\OrRule;
 use JClaveau\LogicalFilter\Rule\NotRule;

Indentation +3 added lines, -3 removed lines

@@ -392,7 +392,7 @@ 
                     unset( $rows[$key] );
                     if (! $rows ) {
                         throw new \Exception(
-                             "Removing the only rule $rule from the filter $this "
+                                "Removing the only rule $rule from the filter $this "
                             ."produces a case which has no possible solution due to missing "
                             ."implementation of TrueRule.\n"
                             ."Please see: https://github.com/jclaveau/php-logical-filter/issues/59"
@@ -821,7 +821,7 @@ 
         }
         elseif (! $filterer instanceof Filterer) {
             throw new \InvalidArgumentException(
-                 "The given \$filterer must be null or a callable or a instance "
+                    "The given \$filterer must be null or a callable or a instance "
                 ."of Filterer instead of: ".var_export($filterer, true)
             );
         }
@@ -856,7 +856,7 @@ 
         }
         elseif (! $filterer instanceof Filterer) {
             throw new \InvalidArgumentException(
-                 "The given \$filterer must be null or a callable or a instance "
+                    "The given \$filterer must be null or a callable or a instance "
                 ."of Filterer instead of: ".var_export($filterer, true)
             );
         }

Spacing +46 added lines, -46 removed lines

@@ -51,12 +51,12 @@ 
      *
      * @see self::addRules
      */
-    public function __construct($rules=[], Filterer $default_filterer=null, array $options=[])
+    public function __construct($rules = [], Filterer $default_filterer = null, array $options = [])
     {
         if ($rules instanceof AbstractRule) {
             $rules = $rules->copy();
         }
-        elseif (! is_null($rules) && ! is_array($rules)) {
+        elseif ( ! is_null($rules) && ! is_array($rules)) {
             throw new \InvalidArgumentException(
                 "\$rules must be a rules description or an AbstractRule instead of"
                 .var_export($rules, true)
@@ -72,7 +72,7 @@ 
         }
 
         if ($rules) {
-            $this->and_( $rules );
+            $this->and_($rules);
         }
     }
 
@@ -80,7 +80,7 @@ 
      */
     protected function getDefaultFilterer()
     {
-        if (! $this->default_filterer) {
+        if ( ! $this->default_filterer) {
             $this->default_filterer = new PhpFilterer();
         }
 
@@ -223,12 +223,12 @@ 
      * @param  array $options stop_after | stop_before |
      * @return $this
      */
-    public function simplify($options=[])
+    public function simplify($options = [])
     {
         if ($this->rules) {
             // AndRule added to make all Operation methods available
             $this->rules = (new AndRule([$this->rules]))
-                ->simplify( $options )
+                ->simplify($options)
                 // ->dump(true, false)
                 ;
         }
@@ -271,9 +271,9 @@ 
      *
      * @return bool
      */
-    public function hasSolution($save_simplification=true)
+    public function hasSolution($save_simplification = true)
     {
-        if (! $this->rules) {
+        if ( ! $this->rules) {
             return true;
         }
 
@@ -292,7 +292,7 @@ 
      *
      * @return array A description of the rules.
      */
-    public function toArray(array $options=[])
+    public function toArray(array $options = [])
     {
         return $this->rules ? $this->rules->toArray($options) : $this->rules;
     }
@@ -304,7 +304,7 @@ 
      *
      * @return array A description of the rules.
      */
-    public function toString(array $options=[])
+    public function toString(array $options = [])
     {
         return $this->rules ? $this->rules->toString($options) : $this->rules;
     }
@@ -342,7 +342,7 @@ 
      * @param  mixed $row
      * @return bool
      */
-    public function __invoke($row, $key=null)
+    public function __invoke($row, $key = null)
     {
         return $this->validates($row, $key);
     }
@@ -389,8 +389,8 @@ 
             [
                 Filterer::on_row_matches => function($rule, $key, &$rows, $matching_case) use (&$cache_flush_required) {
                     // $rule->dump();
-                    unset( $rows[$key] );
-                    if (! $rows ) {
+                    unset($rows[$key]);
+                    if ( ! $rows) {
                         throw new \Exception(
                              "Removing the only rule $rule from the filter $this "
                             ."produces a case which has no possible solution due to missing "
@@ -424,7 +424,7 @@ 
      *
      * @return array The rules matching the filter
      */
-    public function filterRules($rules=[], array $options=[])
+    public function filterRules($rules = [], array $options = [])
     {
         if ($rules instanceof LogicalFilter) {
             $rules = $rules->getRules();
@@ -452,7 +452,7 @@ 
      * @return array The rules matching the filter
      * @return array $options debug | leaves_only | clean_empty_branches
      */
-    public function keepLeafRulesMatching($filter=[], array $options=[])
+    public function keepLeafRulesMatching($filter = [], array $options = [])
     {
         $clean_empty_branches = ! isset($options['clean_empty_branches']) || $options['clean_empty_branches'];
 
@@ -460,7 +460,7 @@ 
         // ->dump()
         ;
 
-        $options[ Filterer::leaves_only ] = true;
+        $options[Filterer::leaves_only] = true;
 
         $this->rules = (new RuleFilterer)->apply($filter, $this->rules, $options);
         // $this->rules->dump(true);
@@ -500,13 +500,13 @@ 
      *
      * @todo Merge with rules
      */
-    public function listLeafRulesMatching($filter=[])
+    public function listLeafRulesMatching($filter = [])
     {
         $filter = (new LogicalFilter($filter, new RuleFilterer))
         // ->dump()
         ;
 
-        if (! $this->rules) {
+        if ( ! $this->rules) {
             return [];
         }
 
@@ -520,7 +520,7 @@ 
                     $key,
                     array $siblings
                 ) use (&$out) {
-                    if (   ! $matching_rule instanceof AndRule
+                    if ( ! $matching_rule instanceof AndRule
                         && ! $matching_rule instanceof OrRule
                         && ! $matching_rule instanceof NotRule
                     ) {
@@ -561,13 +561,13 @@ 
      *
      * @return array          The rules matching the filter
      */
-    public function onEachRule($filter=[], $options)
+    public function onEachRule($filter = [], $options)
     {
         $filter = (new LogicalFilter($filter, new RuleFilterer))
         // ->dump()
         ;
 
-        if (! $this->rules) {
+        if ( ! $this->rules) {
             return [];
         }
 
@@ -600,7 +600,7 @@ 
     {
         $this->simplify()->addMinimalCase();
 
-        if (! $this->rules) {
+        if ( ! $this->rules) {
             return $this;
         }
 
@@ -626,11 +626,11 @@ 
      *
      * @return array The bounds of the range and a nullable property for each field
      */
-    public function getRanges($ruleFilter=null)
+    public function getRanges($ruleFilter = null)
     {
         $ranges = [];
 
-        $this->onEachCase(function (AndRule $and_rule) use (&$ranges, $ruleFilter) {
+        $this->onEachCase(function(AndRule $and_rule) use (&$ranges, $ruleFilter) {
             (new self($and_rule))->onEachRule(
                 ['and',
                     $ruleFilter,
@@ -639,12 +639,12 @@ 
                         '><', '><=', '=><=', '=><',
                     ]],
                 ],
-                function ($rule) use (&$ranges) {
+                function($rule) use (&$ranges) {
 
                     $field = $rule->getField();
 
-                    $range = isset($ranges[ $field ])
-                           ? $ranges[ $field ]
+                    $range = isset($ranges[$field])
+                           ? $ranges[$field]
                            : ['min' => [], 'max' => [], 'nullable' => false];
 
                     if ($rule::operator == '=') {
@@ -672,7 +672,7 @@ 
                         );
                     }
 
-                    $ranges[ $field ] = $range;
+                    $ranges[$field] = $range;
                 }
             );
         });
@@ -726,7 +726,7 @@ 
      *
      * @return LogicalFilter
      */
-    public function saveAs( &$variable)
+    public function saveAs(&$variable)
     {
         return $variable = $this;
     }
@@ -737,7 +737,7 @@ 
      *
      * @return LogicalFilter
      */
-    public function saveCopyAs( &$copied_variable)
+    public function saveCopyAs(&$copied_variable)
     {
         $copied_variable = $this->copy();
         return $this;
@@ -750,15 +750,15 @@ 
      *
      * @return $this
      */
-    public function dump($exit=false, array $options=[])
+    public function dump($exit = false, array $options = [])
     {
         $default_options = [
             'callstack_depth' => 3,
             'mode'            => 'string',
         ];
         foreach ($default_options as $default_option => &$default_value) {
-            if (! isset($options[ $default_option ])) {
-                $options[ $default_option ] = $default_value;
+            if ( ! isset($options[$default_option])) {
+                $options[$default_option] = $default_value;
             }
         }
         extract($options);
@@ -769,24 +769,24 @@ 
         else {
             // TODO dump a TrueRule
             $bt     = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, $callstack_depth);
-            $caller = $bt[ $callstack_depth - 2 ];
+            $caller = $bt[$callstack_depth - 2];
 
             // get line and file from the previous level of the caller
             // TODO go deeper if this case exist?
-            if (! isset($caller['file'])) {
-                $caller['file'] = $bt[ $callstack_depth - 3 ]['file'];
+            if ( ! isset($caller['file'])) {
+                $caller['file'] = $bt[$callstack_depth - 3]['file'];
             }
 
-            if (! isset($caller['line'])) {
-                $caller['line'] = $bt[ $callstack_depth - 3 ]['line'];
+            if ( ! isset($caller['line'])) {
+                $caller['line'] = $bt[$callstack_depth - 3]['line'];
             }
 
             try {
-                echo "\n" . $caller['file'] . ':' . $caller['line'] . "\n";
+                echo "\n".$caller['file'].':'.$caller['line']."\n";
                 var_export($this->toArray($options));
             }
             catch (\Exception $e) {
-                echo "\nError while dumping: " . $e->getMessage() . "\n";
+                echo "\nError while dumping: ".$e->getMessage()."\n";
                 var_export($caller);
                 echo "\n\n";
                 var_export($bt);
@@ -811,15 +811,15 @@ 
      *
      * @return mixed The filtered data
      */
-    public function applyOn($data_to_filter, $action_on_matches=null, $filterer=null)
+    public function applyOn($data_to_filter, $action_on_matches = null, $filterer = null)
     {
-        if (! $filterer) {
+        if ( ! $filterer) {
             $filterer = $this->getDefaultFilterer();
         }
         elseif (is_callable($filterer)) {
             $filterer = new CustomizableFilterer($filterer);
         }
-        elseif (! $filterer instanceof Filterer) {
+        elseif ( ! $filterer instanceof Filterer) {
             throw new \InvalidArgumentException(
                  "The given \$filterer must be null or a callable or a instance "
                 ."of Filterer instead of: ".var_export($filterer, true)
@@ -846,15 +846,15 @@ 
      *                                 + Null if the target has no sens (operation filtered by field for example)
      *                                 + A rule tree containing the first matching case if there is one.
      */
-    public function validates($value_to_check, $key_to_check=null, $filterer=null)
+    public function validates($value_to_check, $key_to_check = null, $filterer = null)
     {
-        if (! $filterer) {
+        if ( ! $filterer) {
             $filterer = $this->getDefaultFilterer();
         }
         elseif (is_callable($filterer)) {
             $filterer = new CustomizableFilterer($filterer);
         }
-        elseif (! $filterer instanceof Filterer) {
+        elseif ( ! $filterer instanceof Filterer) {
             throw new \InvalidArgumentException(
                  "The given \$filterer must be null or a callable or a instance "
                 ."of Filterer instead of: ".var_export($filterer, true)

src/RuleDescriptionParser.php

Indentation +1 added lines, -1 removed lines

@@ -148,7 +148,7 @@
         if ($filter_rules && in_array( get_class($filter_rules), [AndRule::class, OrRule::class])
             && ! $filter_rules->getOperands()) {
             throw new \LogicException(
-                 "You are trying to add rules to a LogicalFilter which had "
+                    "You are trying to add rules to a LogicalFilter which had "
                 ."only contradictory rules that have already been simplified: "
                 .$filter_rules
             );

Spacing +19 added lines, -19 removed lines

@@ -70,7 +70,7 @@ 
             }
         }
 
-        if (   3 == count($rules_description)
+        if (3 == count($rules_description)
             && is_string($rules_description[0])
             && is_string($rules_description[1])
         ) {
@@ -86,7 +86,7 @@ 
         }
         elseif (count($rules_description) == count(array_filter($rules_description, function($arg) {
             return $arg instanceof LogicalFilter;
-        })) ) {
+        }))) {
             // Already instanciated rules
             foreach ($rules_description as $i => $filter_inside_description) {
                 $rules = $filter_inside_description->getRules();
@@ -97,7 +97,7 @@ 
         }
         elseif (count($rules_description) == count(array_filter($rules_description, function($arg) {
             return $arg instanceof AbstractRule;
-        })) ) {
+        }))) {
             // Already instanciated rules
             foreach ($rules_description as $i => $new_rule) {
                 $filter_rules = static::addRule($new_rule, $operation, $filter_rules);
@@ -106,7 +106,7 @@ 
         elseif (1 == count($rules_description) && is_array($rules_description[0])) {
             if (count($rules_description[0]) == count(array_filter($rules_description[0], function($arg) {
                 return $arg instanceof AbstractRule;
-            })) ) {
+            }))) {
                 // Case of $filter->or_([AbstractRule, AbstractRule, AbstractRule, ...])
                 foreach ($rules_description[0] as $i => $new_rule) {
                     $filter_rules = static::addRule($new_rule, $operation, $filter_rules);
@@ -142,10 +142,10 @@ 
      *
      * @return $filter_rules The updated rule tree of the filter
      */
-    protected static function addRule( AbstractRule $rule, $operation=AndRule::operator, AbstractRule $filter_rules=null)
+    protected static function addRule(AbstractRule $rule, $operation = AndRule::operator, AbstractRule $filter_rules = null)
     {
 
-        if ($filter_rules && in_array( get_class($filter_rules), [AndRule::class, OrRule::class])
+        if ($filter_rules && in_array(get_class($filter_rules), [AndRule::class, OrRule::class])
             && ! $filter_rules->getOperands()) {
             throw new \LogicException(
                  "You are trying to add rules to a LogicalFilter which had "
@@ -194,7 +194,7 @@ 
         AbstractOperationRule $recursion_position,
         $options
     ) {
-        if (! array_filter($rules_composition, function ($rule_composition_part) {
+        if ( ! array_filter($rules_composition, function($rule_composition_part) {
             return is_string($rule_composition_part);
         })) {
             // at least one operator is required for operation rules
@@ -203,7 +203,7 @@ 
                 .var_export($rules_composition, true)
             );
         }
-        elseif ( 3 == count($rules_composition)
+        elseif (3 == count($rules_composition)
             && AbstractRule::isLeftOperand($rules_composition[0])
             && AbstractRule::isOperator($rules_composition[1])
         ) {
@@ -219,16 +219,16 @@ 
         }
         else {
             // operations
-            if (   NotRule::operator == $rules_composition[0]
-                || $rules_composition[0] == AbstractRule::findSymbolicOperator( NotRule::operator ) ) {
+            if (NotRule::operator == $rules_composition[0]
+                || $rules_composition[0] == AbstractRule::findSymbolicOperator(NotRule::operator)) {
                 $rule = new NotRule();
             }
-            elseif (in_array( AndRule::operator, $rules_composition )
-                || in_array( AbstractRule::findSymbolicOperator( AndRule::operator ), $rules_composition)) {
+            elseif (in_array(AndRule::operator, $rules_composition)
+                || in_array(AbstractRule::findSymbolicOperator(AndRule::operator), $rules_composition)) {
                 $rule = new AndRule();
             }
-            elseif (in_array( OrRule::operator, $rules_composition )
-                || in_array( AbstractRule::findSymbolicOperator( OrRule::operator ), $rules_composition) ) {
+            elseif (in_array(OrRule::operator, $rules_composition)
+                || in_array(AbstractRule::findSymbolicOperator(OrRule::operator), $rules_composition)) {
                 $rule = new OrRule();
             }
             else {
@@ -242,7 +242,7 @@ 
 
             $operands_descriptions = array_filter(
                 $rules_composition,
-                function ($operand) use ($operator) {
+                function($operand) use ($operator) {
                     return ! in_array($operand, [$operator, AbstractRule::findSymbolicOperator($operator)]);
                 }
             );
@@ -258,7 +258,7 @@ 
 
             foreach ($operands_descriptions as $i => $operands_description) {
                 if (false === $operands_description) {
-                    $operands_descriptions[ $i ] = ['and']; // FalseRule hack
+                    $operands_descriptions[$i] = ['and']; // FalseRule hack
                 }
                 elseif (null === $operands_description || true === $operands_description) {
                     $operands_description = ['and'];
@@ -269,7 +269,7 @@ 
                         );
                     }
 
-                    unset($operands_descriptions[ $i ]);
+                    unset($operands_descriptions[$i]);
                 }
             }
 
@@ -283,11 +283,11 @@ 
                 }
             );
 
-            if (! empty($remaining_operations)) {
+            if ( ! empty($remaining_operations)) {
                 throw new \InvalidArgumentException(
                     "Mixing different operations in the same rule level not implemented: \n["
                     . implode(', ', $remaining_operations)."]\n"
-                    . 'in ' . var_export($rules_composition, true)
+                    . 'in '.var_export($rules_composition, true)
                 );
             }