Compare commits

..

3 Commits
1.5.0 ... 2.x

Author SHA1 Message Date
R. Eric Wheeler cf7da6c32c Fix name in composer 2024-07-18 13:19:21 -07:00
R. Eric Wheeler 48420375b4 Updated header comment 2024-07-18 12:44:34 -07:00
R. Eric Wheeler d9af97eab2 Update dependencies 2024-07-18 12:34:40 -07:00
15 changed files with 2790 additions and 2686 deletions

1
.gitignore vendored
View File

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

18
.php-cs-fixer.dist.php Normal file
View File

@ -0,0 +1,18 @@
<?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)
;

View File

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

View File

@ -2,16 +2,15 @@
This simply uses the FFI extension to enable _getch and _ungetch in Windows and linux.
[![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://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)
[![pipeline status](https://repos.bgemi.net/sikofitt/getch/badges/1.x/pipeline.svg)](https://repos.bgemi.net/sikofitt/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)
```shell script
$ composer require olivebbs/getch
$ composer require sikofitt/getch:dev-master
```
```php
use Olive\Console\Getch;
use Sikofitt\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.
@ -46,7 +45,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 Olive\Console\getch;
use function Sikofitt\Console\getch;
$ord = getch($linuxLibrary = null);
print \chr($ord);

View File

@ -3,16 +3,15 @@
"description": "Implements _getch and _ungetch for windows and linux using ffi",
"type": "library",
"require": {
"php": ">=7.4",
"php": "^8.2",
"ext-ffi": "*"
},
"require-dev": {
"friendsofphp/php-cs-fixer": "^2.18",
"phpunit/phpunit": "^9.5"
"phpunit/phpunit": "^9.6"
},
"autoload": {
"psr-4": {
"Olive\\Console\\": "src/Console/"
"Sikofitt\\Console\\": "src/Console/"
},
"files": [
"functions.php"
@ -20,7 +19,7 @@
},
"autoload-dev": {
"psr-4": {
"Olive\\Tests\\Console\\": "tests/"
"Sikofitt\\Tests\\Console\\": "tests/"
}
},
"license": "MPL-2.0",

2787
composer.lock generated

File diff suppressed because it is too large Load Diff

View File

@ -3,7 +3,7 @@
declare(strict_types=1);
/*
* Copyright (c) 2020 https://rewiv.com sikofitt@gmail.com
* 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.
@ -12,22 +12,18 @@ declare(strict_types=1);
* You can obtain one at https://mozilla.org/MPL/2.0/.
*/
use Olive\Console\Getch;
use Sikofitt\Console\Getch;
if (!function_exists('getch')) {
function getch(string $linuxLibrary = null): int
function getch(?string $linuxLibrary = null): int
{
$g = new Getch($linuxLibrary);
return $g->getch();
return (new Getch($linuxLibrary))->getch();
}
}
if (!function_exists('ungetch')) {
function ungetch($char, string $linuxLibrary = null): int
function ungetch($char, ?string $linuxLibrary = null): int
{
$g = new Getch($linuxLibrary);
return $g->ungetch($char);
return (new Getch($linuxLibrary))->ungetch($char);
}
}

View File

@ -1,4 +1,4 @@
Copyright (c) 2020 https://rewiv.com sikofitt@gmail.com
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.

View File

@ -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.5/phpunit.xsd"
xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.6/phpunit.xsd"
bootstrap="vendor/autoload.php"
cacheResultFile=".phpunit.cache/test-results"
executionOrder="depends,defects"

View File

@ -3,7 +3,7 @@
declare(strict_types=1);
/*
* Copyright (c) 2020 https://rewiv.com sikofitt@gmail.com
* 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.
@ -12,10 +12,7 @@ declare(strict_types=1);
* You can obtain one at https://mozilla.org/MPL/2.0/.
*/
namespace Olive\Console;
use FFI;
use RuntimeException;
namespace Sikofitt\Console;
final class Getch
{
@ -25,7 +22,7 @@ final class Getch
public const KEY_E0 = 0;
public const KEY_E1 = 224;
// Supported scan scodes.
// Supported scan codes.
public const KEY_F1 = 59;
public const KEY_F2 = 60;
public const KEY_F3 = 61;
@ -56,14 +53,14 @@ final class Getch
int _ungetch(int c);
DECLARATIONS;
private static ?FFI $ffi = null;
private static ?\FFI $ffi = null;
public static function resetFFI(): void
{
static::$ffi = null;
self::$ffi = null;
}
public function __construct(string $linuxLibrary = null)
public function __construct(?string $linuxLibrary = null)
{
if (null === $linuxLibrary) {
$linuxLibrary = self::LINUX_LIBRARY;
@ -73,15 +70,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));
}
}
}
@ -89,9 +86,9 @@ final class Getch
public function peek(): int
{
if (PHP_OS_FAMILY === 'Windows') {
if ($ffi->_kbhit()) {
$result = $ffi->_getch();
$ffi->_ungetch($result);
if (self::$ffi->_kbhit()) {
$result = self::$ffi->_getch();
self::$ffi->_ungetch($result);
return $result;
}
@ -99,7 +96,7 @@ final class Getch
return -1;
}
return $ffi->cinPeek();
return self::$ffi->cinPeek();
}
public function getch(): int
@ -107,12 +104,8 @@ final class Getch
return self::$ffi->_getch();
}
public function ungetch($char): int
public function ungetch(string|int $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]);
}

0
src/Console/Resources/libgetch.so Executable file → Normal file
View File

View File

@ -1,9 +1,19 @@
<?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 Olive\Console\Getch;
use Sikofitt\Console\Getch;
class GetchTest extends TestCase
{
@ -23,7 +33,9 @@ class GetchTest extends TestCase
/**
* @preserveGlobalState disabled
*
* @backupStaticAttributes false
*
* @backupGlobals false
*/
public function testFailureOnInvalidLibrary()

View File

@ -1,9 +1,19 @@
<?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 Olive\Console\Getch;
use Sikofitt\Console\Getch;
class UngetchTest extends TestCase
{

View File

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

2542
tools/php-cs-fixer/composer.lock generated Normal file

File diff suppressed because it is too large Load Diff