Merge pull request #1 from qlimix/v2

V2

.travis.yml

@@ -1,8 +1,7 @@
 language: php
 
 php:
-  - 7.2
-  - 7.3
+  - 7.4
   - nightly
 
 matrix:
@@ -15,6 +14,7 @@ before_script:
 
 script:
   - vendor/bin/grumphp run
+  - vendor/bin/phpunit tests --coverage-clover clover.xml
 
 notifications:
   email:

CHANGELOG.md

@@ -0,0 +1,10 @@
+### 2.0.0 - 14-11-2020
+
+### Changes
+ - restructuring object and interfaces
+
+### Dependencies
+ - update code standard
+
+### Compatibility
+ - Updated to php >7.4

composer.json

@@ -4,24 +4,31 @@
     "description": "Process control interfaces",
     "license": "MIT",
     "keywords": [
-        "process",
-        "manager"
+        "process"
     ],
     "authors": [
         {
             "name": "frank",
             "email": "frank@qlimix.net"
         }
     ],
+    "require": {
+        "php": ">7.4"
+    },
+    "require-dev": {
+        "qlimix/code-standard": "^3.0"
+    },
     "autoload": {
         "psr-4": {
             "Qlimix\\Process\\": "src/"
         }
     },
+    "autoload-dev": {
+        "psr-4": {
+            "Qlimix\\Tests\\Process\\": "tests/"
+        }
+    },
     "config": {
         "sort-packages": true
-    },
-    "require-dev": {
-        "qlimix/code-standard": "^1.0"
     }
 }

grumphp.yml

@@ -1,9 +1,9 @@
-parameters:
-  git_dir: .
-  bin_dir: vendor/bin
+grumphp:
   stop_on_failure: false
   ignore_unstaged_changes: false
-  ascii: ~
+  ascii:
+    failed: ~
+    succeeded: ~
   tasks:
     phpcs:
     phpmd:
@@ -18,3 +18,12 @@ parameters:
         - "public"
         - "bin"
         - "docs"
+    psalm:
+      config: psalm.xml
+      ignore_patterns: []
+      no_cache: false
+      report: ~
+      output_format: null
+      threads: 1
+      triggered_by: ['php']
+      show_info: false

phpunit.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.4/phpunit.xsd"
+         backupGlobals="false"
+         colors="true"
+         processIsolation="false"
+         stopOnFailure="false"
+         bootstrap="vendor/autoload.php"
+>
+    <testsuites>
+        <testsuite name="Test">
+            <directory suffix=".php">./tests/</directory>
+        </testsuite>
+    </testsuites>
+
+    <filter>
+        <whitelist>
+            <directory suffix=".php">./src/</directory>
+        </whitelist>
+    </filter>
+</phpunit>

psalm.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0"?>
+<psalm
+        totallyTyped="true"
+        resolveFromConfigFile="true"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xmlns="https://getpsalm.org/schema/config"
+        xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
+        memoizeMethodCallResults="true"
+        errorLevel="8"
+>
+    <projectFiles>
+        <directory name="src" />
+        <ignoreFiles>
+            <directory name="vendor" />
+        </ignoreFiles>
+    </projectFiles>
+</psalm>

src/Control/ControlInterface.php

@@ -0,0 +1,37 @@
+<?php declare(strict_types=1);
+
+namespace Qlimix\Process\Control;
+
+use Qlimix\Process\Control\Exception\ControlException;
+
+interface ControlInterface
+{
+    /**
+     * @throws ControlException
+     */
+    public function status(): ?Status;
+
+    /**
+     * @throws ControlException
+     */
+    public function start(string $process): int;
+
+    /**
+     * @param string[] $processes
+     *
+     * @return int[]
+     *
+     * @throws ControlException
+     */
+    public function startMultiple(array $processes): array;
+
+    /**
+     * @throws ControlException
+     */
+    public function stop(int $id): void;
+
+    /**
+     * @throws ControlException
+     */
+    public function stopAll(): void;
+}

src/Control/Exception/ControlException.php

@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace Qlimix\Process\Control\Exception;
+
+use Exception;
+
+final class ControlException extends Exception
+{
+}

src/Control/Status.php

@@ -0,0 +1,34 @@
+<?php declare(strict_types=1);
+
+namespace Qlimix\Process\Control;
+
+final class Status
+{
+    private int $id;
+
+    private string $process;
+
+    private bool $success;
+
+    public function __construct(int $id, string $process, bool $success)
+    {
+        $this->id = $id;
+        $this->process = $process;
+        $this->success = $success;
+    }
+
+    public function getId(): int
+    {
+        return $this->id;
+    }
+
+    public function getProcess(): string
+    {
+        return $this->process;
+    }
+
+    public function isSuccess(): bool
+    {
+        return $this->success;
+    }
+}

src/Manager/Exception/ManagerException.php

@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace Qlimix\Process\Manager\Exception;
+
+use Exception;
+
+final class ManagerException extends Exception
+{
+}

src/ProcessManagerInterface.php → src/Manager/ManagerInterface.php

@@ -1,13 +1,13 @@
 <?php declare(strict_types=1);
 
-namespace Qlimix\Process;
+namespace Qlimix\Process\Manager;
 
-use Qlimix\Process\Exception\ProcessException;
+use Qlimix\Process\Manager\Exception\ManagerException;
 
-interface ProcessManagerInterface
+interface ManagerInterface
 {
     /**
-     * @throws ProcessException
+     * @throws ManagerException
      */
     public function maintain(): void;
 
@@ -16,7 +16,7 @@ public function stop(): void;
     public function continue(): bool;
 
     /**
-     * @throws ProcessException
+     * @throws ManagerException
      */
     public function initialize(): void;
 }

src/Output/OutputInterface.php

@@ -5,4 +5,6 @@
 interface OutputInterface
 {
     public function write(string $text): void;
+
+    public function writeLine(string $text): void;
 }

src/Output/StdOutput.php

@@ -10,6 +10,14 @@ final class StdOutput implements OutputInterface
      * @inheritDoc
      */
     public function write(string $text): void
+    {
+        echo $text;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function writeLine(string $text): void
     {
         echo $text.PHP_EOL;
     }