Testing service (#197)

* Testing service

* Run await test without time skipping

* Run await test without time skipping

* Add test service description

* Add trait

* Remove grpc extension requirement

.github/workflows/testing.yml

@@ -17,7 +17,7 @@ jobs:
         uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php }}
-          extensions: dom
+          extensions: dom, sockets, grpc, curl
 
       - name: Check Out Code
         uses: actions/checkout@v2
@@ -65,7 +65,7 @@ jobs:
         with:
           php-version: ${{ matrix.php }}
           tools: composer:v2
-          extensions: dom, sockets, curl
+          extensions: dom, sockets, grpc, curl
 
       - name: Check Out Code
         uses: actions/checkout@v2
@@ -118,7 +118,7 @@ jobs:
         with:
           php-version: ${{ matrix.php }}
           tools: composer:v2
-          extensions: dom, sockets, curl
+          extensions: dom, sockets, grpc, curl
 
       - name: Check Out Code
         uses: actions/checkout@v2

composer.json

@@ -40,6 +40,8 @@
     },
     "autoload": {
         "psr-4": {
+            "Temporal\\Api\\Testservice\\": "testing/api/testservice/Temporal/Api/Testservice",
+            "GPBMetadata\\Temporal\\Api\\Testservice\\": "testing/api/testservice/GPBMetadata/Temporal/Api/Testservice",
             "Temporal\\Testing\\": "testing/src",
             "GPBMetadata\\": "api/v1/GPBMetadata",
             "Temporal\\": "src",

testing/Readme.md

@@ -63,6 +63,35 @@ $worker->registerActivity(MyActvivityMock::class);
 $factory->run();
 ```
 
+### Time management 
+By default, the test server starts with `--enable-time-skipping` option. It means that if the 
+workflow has a timer, the server doesn't wait for it and continues immediately. To change
+this behaviour you can use `TestService` class:
+
+```php
+$testService = TestService::create('localhost:7233');
+$testService->lockTimeSkipping();
+
+// ...
+$testService->unlockTimeSkipping();
+```
+
+Class `TestService` communicates with a test server and provides method for "time management". Time skipping 
+can be switched on/off with `unlockTimeSkipping()` and `lockTimeSkipping()` method. 
+
+In case you need to emulate some "waiting" on a test server, you can use `sleep(int secods)` or `sleepUntil(int $timestamp)` methods.
+
+Current server time can be retrieved with `getCurrentTime(): Carbon` method.
+
+For convenience if you don't want to skip time in the whole `TestCase` class use `WithoutTimeSkipping`: 
+
+```php
+final class MyWorkflowTest extends TestCase 
+{
+    use WithoutTimeSkipping;
+}
+```
+