Merge branch 'master' into '1.x'

# Conflicts:
#   composer.lock

.gitignore

@@ -3,4 +3,3 @@
 .php_cs.cache
 vendor/
 .phpunit.cache/
-tools/php-cs-fixer/vendor/

.gitlab-ci.yml

@@ -18,7 +18,6 @@ before_script:
   - php composer.phar install
 
 # Run our tests
-# If Xdebug was installed you can generate a coverage report and see code coverage metrics.
 test:7.4:
   only:
     - 1.x
@@ -35,3 +34,11 @@ test:8.0:
   image: php:8.0
   script:
     - vendor/bin/phpunit --configuration phpunit.xml --coverage-text --colors=never
+test:8.1:
+  only:
+    - 1.x
+  tags:
+    - default
+  image: php:8.1
+  script:
+    - vendor/bin/phpunit --configuration phpunit.xml --coverage-text --colors=never

.php-cs-fixer.dist.php

@@ -1,18 +0,0 @@
-<?php
-
-use PhpCsFixer\Config;
-
-$header = file_exists(__DIR__.'/header.txt') ? file_get_contents(__DIR__.'/header.txt') : '';
-$finder = PhpCsFixer\Finder::create()
-    ->in(__DIR__ . '/src')
-    ->in(__DIR__ . '/tests')
-;
-return (new Config())
-
-    ->setRules([
-        '@Symfony' => true,
-        'array_syntax' => ['syntax' => 'short'],
-        'header_comment' => ['header' => $header],
-    ])
-    ->setFinder($finder)
-;

.php_cs.dist

@@ -0,0 +1,14 @@
+<?php
+
+$finder = PhpCsFixer\Finder::create()
+    ->in(__DIR__)
+    ->exclude('var')
+;
+
+return PhpCsFixer\Config::create()
+    ->setRules([
+        '@Symfony' => true,
+        'array_syntax' => ['syntax' => 'short'],
+    ])
+    ->setFinder($finder)
+;

README.md

@@ -2,15 +2,16 @@
 
 This simply uses the FFI extension to enable _getch and _ungetch in Windows and linux.
 
-[![pipeline status](https://repos.bgemi.net/sikofitt/getch/badges/1.x/pipeline.svg)](https://repos.bgemi.net/sikofitt/getch/-/commits/1.x)
+[![Pipeline status](https://code.bgemi.net/olive/PHP/getch/badges/1.x/pipeline.svg)](https://code.bgemi.net/olive/PHP/getch/-/commits/1.x)
-[![coverage report](https://repos.bgemi.net/sikofitt/getch/badges/1.x/coverage.svg)](https://repos.bgemi.net/sikofitt/getch/-/commits/1.x)
+[![Coverage report](https://code.bgemi.net/olive/PHP/getch/badges/1.x/coverage.svg)](https://code.bgemi.net/olive/PHP/getch/-/commits/1.x)
+[![Latest Release](https://code.bgemi.net/olive/PHP/getch/-/badges/release.svg)](https://code.bgemi.net/olive/PHP/getch/-/releases)
 
 ```shell script
-$ composer require sikofitt/getch:dev-master
+$ composer require olivebbs/getch
 ```
 
 ```php
- use Sikofitt\Console\Getch;
+ use Olive\Console\Getch;
  $g = new Getch($linuxLibrary = null); // can also be a library that implements a function called _getch;
                                        // by default uses the bundled Resources/libgetch.so
                                        // on windows uses the built in _getch function.
@@ -45,7 +46,7 @@ Note that if you want to put a word into the STDIN stack, you need to do it in r
 There are also helper functions called getch() and ungetch();
 
 ```php
-use function Sikofitt\Console\getch;
+use function Olive\Console\getch;
 $ord = getch($linuxLibrary = null);
 print \chr($ord);
 

composer.json

@@ -2,16 +2,18 @@
     "name": "olivebbs/getch",
     "description": "Implements _getch and _ungetch for windows and linux using ffi",
     "type": "library",
+    "keywords": ["getch", "windows", "conio", "linux", "console", "conio.h", "hotkey", "termios"],
     "require": {
-        "php": "^8.2",
+        "php": ">=7.4",
         "ext-ffi": "*"
     },
   "require-dev": {
-        "phpunit/phpunit": "^9.6"
+        "friendsofphp/php-cs-fixer": "^2.18",
+        "phpunit/phpunit": "^9.5"
     },
   "autoload": {
     "psr-4": {
-      "Sikofitt\\Console\\": "src/Console/"
+      "Olive\\Console\\": "src/Console/"
     },
     "files": [
       "functions.php"
@@ -19,7 +21,7 @@
   },
   "autoload-dev": {
     "psr-4": {
-      "Sikofitt\\Tests\\Console\\": "tests/"
+      "Olive\\Tests\\Console\\": "tests/"
     }
   },
   "license": "MPL-2.0",
@@ -28,5 +30,8 @@
             "name": "R. Eric Wheeler",
             "email": "sikofitt@gmail.com"
         }
-    ]
+    ],
+    "conflict": {
+      "sikofitt/getch": "*"
+    }
 }

functions.php

@@ -3,7 +3,7 @@
 declare(strict_types=1);
 
 /*
- * Copyright (c) 2020-2024  https://sikofitt.com sikofitt@gmail.com
+ * Copyright (c) 2020  https://rewiv.com sikofitt@gmail.com
  *
  * This Source Code Form is subject to the
  * terms of the Mozilla Public License, v. 2.0.
@@ -12,18 +12,22 @@ declare(strict_types=1);
  * You can obtain one at https://mozilla.org/MPL/2.0/.
  */
 
-use Sikofitt\Console\Getch;
+use Olive\Console\Getch;
 
 if (!function_exists('getch')) {
-    function getch(?string $linuxLibrary = null): int
+    function getch(string $linuxLibrary = null): int
     {
-        return (new Getch($linuxLibrary))->getch();
+        $g = new Getch($linuxLibrary);
+
+        return $g->getch();
     }
 }
 
 if (!function_exists('ungetch')) {
-    function ungetch($char, ?string $linuxLibrary = null): int
+    function ungetch($char, string $linuxLibrary = null): int
     {
-        return (new Getch($linuxLibrary))->ungetch($char);
+        $g = new Getch($linuxLibrary);
+
+        return $g->ungetch($char);
     }
 }

header.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2020-2024  https://sikofitt.com sikofitt@gmail.com
+Copyright (c) 2020  https://rewiv.com sikofitt@gmail.com
 
 This Source Code Form is subject to the 
 terms of the Mozilla Public License, v. 2.0. 

phpunit.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.6/phpunit.xsd"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.5/phpunit.xsd"
          bootstrap="vendor/autoload.php"
          cacheResultFile=".phpunit.cache/test-results"
          executionOrder="depends,defects"

src/Console/Getch.php

@@ -3,7 +3,7 @@
 declare(strict_types=1);
 
 /*
- * Copyright (c) 2020-2024  https://sikofitt.com sikofitt@gmail.com
+ * Copyright (c) 2020  https://rewiv.com sikofitt@gmail.com
  *
  * This Source Code Form is subject to the
  * terms of the Mozilla Public License, v. 2.0.
@@ -12,7 +12,10 @@ declare(strict_types=1);
  * You can obtain one at https://mozilla.org/MPL/2.0/.
  */
 
-namespace Sikofitt\Console;
+namespace Olive\Console;
+
+use FFI;
+use RuntimeException;
 
 final class Getch
 {
@@ -22,7 +25,7 @@ final class Getch
     public const KEY_E0 = 0;
     public const KEY_E1 = 224;
 
-    // Supported scan codes.
+    // Supported scan scodes.
     public const KEY_F1 = 59;
     public const KEY_F2 = 60;
     public const KEY_F3 = 61;
@@ -53,14 +56,14 @@ final class Getch
         int _ungetch(int c);
     DECLARATIONS;
 
-    private static ?\FFI $ffi = null;
+    private static ?FFI $ffi = null;
 
     public static function resetFFI(): void
     {
-        self::$ffi = null;
+        static::$ffi = null;
     }
 
-    public function __construct(?string $linuxLibrary = null)
+    public function __construct(string $linuxLibrary = null)
     {
         if (null === $linuxLibrary) {
             $linuxLibrary = self::LINUX_LIBRARY;
@@ -70,15 +73,15 @@ final class Getch
             $osFamily = PHP_OS_FAMILY;
             if ('Windows' === $osFamily) {
                 $declarations = self::DECLARATIONS.' int _kbhit();';
-                self::$ffi = \FFI::cdef($declarations, self::WINDOWS_LIBRARY);
+                self::$ffi = FFI::cdef($declarations, self::WINDOWS_LIBRARY);
             } elseif ('Linux' === $osFamily) {
                 if (!file_exists($linuxLibrary)) {
-                    throw new \RuntimeException(sprintf('Could not find library file %s.', $linuxLibrary));
+                    throw new RuntimeException(sprintf('Could not find library file %s.', $linuxLibrary));
                 }
                 $declarations = self::DECLARATIONS.' int cinPeek();';
-                self::$ffi = \FFI::cdef($declarations, $linuxLibrary);
+                self::$ffi = FFI::cdef($declarations, $linuxLibrary);
             } else {
-                throw new \RuntimeException(sprintf('Sorry, %s is not supported yet.', $osFamily));
+                throw new RuntimeException(sprintf('Sorry, %s is not supported yet.', $osFamily));
             }
         }
     }
@@ -86,9 +89,9 @@ final class Getch
     public function peek(): int
     {
         if (PHP_OS_FAMILY === 'Windows') {
-            if (self::$ffi->_kbhit()) {
+            if ($ffi->_kbhit()) {
-                $result = self::$ffi->_getch();
+                $result = $ffi->_getch();
-                self::$ffi->_ungetch($result);
+                $ffi->_ungetch($result);
 
                 return $result;
             }
@@ -96,7 +99,7 @@ final class Getch
             return -1;
         }
 
-        return self::$ffi->cinPeek();
+        return $ffi->cinPeek();
     }
 
     public function getch(): int
@@ -104,8 +107,12 @@ final class Getch
         return self::$ffi->_getch();
     }
 
-    public function ungetch(string|int $char): int
+    public function ungetch($char): int
     {
+        if (!is_string($char) && !is_int($char)) {
+            throw new \TypeError('ungetch takes a parameter of int or string.');
+        }
+
         if (is_string($char)) {
             $char = ord($char[0]);
         }

tests/Getch/GetchTest.php

@@ -1,19 +1,9 @@
 <?php
 
-/*
+namespace Olive\Tests\Console\Getch;
- * Copyright (c) 2020-2024  https://sikofitt.com sikofitt@gmail.com
- *
- * This Source Code Form is subject to the
- * terms of the Mozilla Public License, v. 2.0.
- *
- * If a copy of the MPL was not distributed with this file,
- * You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-namespace Sikofitt\Tests\Console\Getch;
 
 use PHPUnit\Framework\TestCase;
-use Sikofitt\Console\Getch;
+use Olive\Console\Getch;
 
 class GetchTest extends TestCase
 {
@@ -33,9 +23,7 @@ class GetchTest extends TestCase
 
     /**
      * @preserveGlobalState disabled
-     *
      * @backupStaticAttributes false
-     *
      * @backupGlobals false
      */
     public function testFailureOnInvalidLibrary()

tests/Ungetch/UngetchTest.php

@@ -1,19 +1,9 @@
 <?php
 
-/*
+namespace Olive\Tests\Console\Ungetch;
- * Copyright (c) 2020-2024  https://sikofitt.com sikofitt@gmail.com
- *
- * This Source Code Form is subject to the
- * terms of the Mozilla Public License, v. 2.0.
- *
- * If a copy of the MPL was not distributed with this file,
- * You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-namespace Sikofitt\Tests\Console\Ungetch;
 
 use PHPUnit\Framework\TestCase;
-use Sikofitt\Console\Getch;
+use Olive\Console\Getch;
 
 class UngetchTest extends TestCase
 {

tools/php-cs-fixer/composer.json

@@ -1,5 +0,0 @@
-{
-    "require-dev": {
-        "friendsofphp/php-cs-fixer": "^3.59"
-    }
-}