describing an interface for the async webdriver client, method stubs

Author: itnelo

.gitignore

@@ -1 +1,4 @@
 .idea/
+
+vendor/
+composer.lock

composer.json

@@ -15,21 +15,22 @@
     ],
     "autoload": {
         "psr-4": {
-            "Itnelo\\React\\": [
+            "Itnelo\\React\\WebDriver\\": [
                 "src/"
             ]
         }
     },
     "minimum-stability": "stable",
     "require": {
-        "php": ">=7.4"
+        "php": ">=7.4",
+        "react/promise": "^2.8"
     },
     "config": {
         "sort-packages": true
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "0.1-dev"
+            "dev-master": "0.x-dev"
         }
     }
 }

src/Client/W3CClient.php

@@ -0,0 +1,177 @@
+<?php
+
+/*
+ * This file is part of the ReactPHP WebDriver <https://github.com/itnelo/reactphp-webdriver>.
+ *
+ * (c) 2020 Pavel Petrov <itnelo@gmail.com>.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @license https://opensource.org/licenses/mit MIT
+ */
+
+declare(strict_types=1);
+
+namespace Itnelo\React\WebDriver\Client;
+
+use Itnelo\React\WebDriver\ClientInterface;
+use React\Promise\PromiseInterface;
+
+/**
+ * W3C compliant WebDriver client for Selenium Grid server (hub) that performs asynchronously.
+ *
+ * This is a direct port of RemoteWebDriver logic from the "php-webdriver/webdriver" package, which utilizes
+ * ReactPHP event loop and promise API for browser interaction w/o execution flow blocking.
+ *
+ * It isn't a complete bridge and gives only the most common and robust levers to make the job done. For more info see
+ * {@link ClientInterface}.
+ *
+ * @see https://github.com/php-webdriver/php-webdriver/blob/1.8.3/lib/Remote/RemoteWebDriver.php
+ */
+class W3CClient implements ClientInterface
+{
+    /**
+     * {@inheritDoc}
+     */
+    public function getSessionIdentifiers(): PromiseInterface
+    {
+        // TODO: Implement getSessionIdentifiers() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function createSession(): PromiseInterface
+    {
+        // TODO: Implement createSession() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function removeSession(string $sessionIdentifier): PromiseInterface
+    {
+        // TODO: Implement removeSession() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getTabIdentifiers(string $sessionIdentifier): PromiseInterface
+    {
+        // TODO: Implement getTabIdentifiers() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getActiveTabIdentifier(string $sessionIdentifier): PromiseInterface
+    {
+        // TODO: Implement getActiveTabIdentifier() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function setActiveTab(string $sessionIdentifier, string $tabIdentifier): PromiseInterface
+    {
+        // TODO: Implement setActiveTab() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function openUri(string $sessionIdentifier, string $uri): PromiseInterface
+    {
+        // TODO: Implement openUri() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getUri(string $sessionIdentifier): PromiseInterface
+    {
+        // TODO: Implement getUri() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getSource(string $sessionIdentifier): PromiseInterface
+    {
+        // TODO: Implement getSource() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getElementIdentifier(string $sessionIdentifier, string $xpathQuery): PromiseInterface
+    {
+        // TODO: Implement getElementIdentifier() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getActiveElement(string $sessionIdentifier): PromiseInterface
+    {
+        // TODO: Implement getActiveElement() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getElementVisibility(string $sessionIdentifier, array $elementIdentifier): PromiseInterface
+    {
+        // TODO: Implement getElementVisibility() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function clickElement(string $sessionIdentifier, array $elementIdentifier): PromiseInterface
+    {
+        // TODO: Implement clickElement() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function keypressElement(
+        string $sessionIdentifier,
+        array $elementIdentifier,
+        string $keySequence
+    ): PromiseInterface {
+        // TODO: Implement keypressElement() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function mouseMove(
+        string $sessionIdentifier,
+        int $offsetX,
+        int $offsetY,
+        int $moveDuration = 100,
+        array $startingPoint = null
+    ): PromiseInterface {
+        // TODO: Implement mouseMove() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function mouseLeftClick(string $sessionIdentifier): PromiseInterface
+    {
+        // TODO: Implement mouseLeftClick() method.
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getScreenshot(string $sessionIdentifier): PromiseInterface
+    {
+        // TODO: Implement getScreenshot() method.
+    }
+}