PHPStan and docs updates (#142)

* Update to PHPStan 2.0

* Update to PHPUnit 12

* Remove prefer-lowest from test config

* Drop 8.0 testing due to PHPUnit issues

* Update addOperator docs

* trying to fix PHPUnit failures that work locally

Author: phpfui

README.md

@@ -123,7 +123,7 @@ $executor->execute('average(1, 3, 4, 8)'); // 4
 ## Operators:
 Default operators: `+ - * / % ^`
 
-Add custom operator to executor:
+Add custom float modulo operator to executor:
 
 ```php
 use NXP\Classes\Operator;
@@ -132,13 +132,9 @@ $executor->addOperator(new Operator(
     '%', // Operator sign
     false, // Is right associated operator
     180, // Operator priority
-    function (&$stack)
+    function ($op1, $op2)
     {
-       $op2 = array_pop($stack);
-       $op1 = array_pop($stack);
-       $result = $op1->getValue() % $op2->getValue();
-
-       return $result;
+       return fmod($op1, $op2);
     }
 ));
 ```
@@ -198,8 +194,7 @@ $executor->setVarValidationHandler(function (string $name, $variable) {
 You can dynamically define variables at run time. If a variable has a high computation cost, but might not be used, then you can define an undefined variable handler. It will only get called when the variable is used, rather than having to always set it initially.
 
 ```php
-$calculator = new MathExecutor();
-$calculator->setVarNotFoundHandler(
+$executor->setVarNotFoundHandler(
     function ($varName) {
         if ($varName == 'trans') {
             return transmogrify();
@@ -228,7 +223,7 @@ echo $executor->setDivisionByZeroIsZero()->execute('1/0');
 ```
 If you want another behavior, you can override division operator:
 ```php
-$executor->addOperator("/", false, 180, function($a, $b) {
+$executor->addOperator(new Operator("/"m, false, 180, function($a, $b) {
     if ($b == 0) {
         return null;
     }

composer.json

@@ -31,7 +31,7 @@
     "php": ">=8.0 <8.5"
   },
   "require-dev": {
-    "phpunit/phpunit": ">=9.0",
+    "phpunit/phpunit": ">=10.0",
     "friendsofphp/php-cs-fixer": "^3.8",
     "phpstan/phpstan": "^2.0"
   },

tests/MathTest.php

@@ -20,11 +20,10 @@
 use NXP\Exception\UnknownVariableException;
 use NXP\MathExecutor;
 use PHPUnit\Framework\TestCase;
-use PHPUnit\Framework\Attributes\DataProvider;
 
 class MathTest extends TestCase
 {
-    #[DataProvider('providerExpressions')]
+    #[\PHPUnit\Framework\Attributes\DataProvider('providerExpressions')]
     public function testCalculating(string $expression) : void
     {
         $calculator = new MathExecutor();
@@ -268,7 +267,7 @@ public static function providerExpressions()
         ];
     }
 
-    #[DataProvider('bcMathExpressions')]
+    #[\PHPUnit\Framework\Attributes\DataProvider('bcMathExpressions')]
     public function testBCMathCalculating(string $expression, string $expected = '') : void
     {
         $calculator = new MathExecutor();
@@ -512,7 +511,7 @@ public static function bcMathExpressions()
         ];
     }
 
-    #[DataProvider('incorrectExpressions')]
+    #[\PHPUnit\Framework\Attributes\DataProvider('incorrectExpressions')]
     public function testIncorrectExpressionException(string $expression) : void
     {
         $calculator = new MathExecutor();
@@ -1093,7 +1092,7 @@ public function testVarExists() : void
         $this->assertFalse($calculator->varExists('Lucy'));
     }
 
-    #[DataProvider('providerExpressionValues')]
+    #[\PHPUnit\Framework\Attributes\DataProvider('providerExpressionValues')]
     public function testCalculatingValues(string $expression, mixed $value) : void
     {
         $calculator = new MathExecutor();
@@ -1172,7 +1171,7 @@ public function testCache() : void
 
     public function testUnsupportedOperands() : void
     {
-        if (\version_compare(PHP_VERSION, '8.0') >= 0) {	// @phpstan-ignore-line
+        if (\version_compare(PHP_VERSION, '8.0') >= 0) {	/** @phpstan-ignore-line */
             $calculator = new MathExecutor();
 
             $calculator->setVar('stringVar', 'string');