Add containerCreate() and containerStart() methods

Author: clue

src/Client.php

@@ -88,6 +88,19 @@ public function containerList($all = false, $size = false)
         return $this->browser->get($this->url('/containers/json?all=%u&size=%u', $all, $size))->then(array($this->parser, 'expectJson'));
     }
 
+    /**
+     * Create a container
+     *
+     * @param array       $config e.g. `array('Image' => 'busybox', 'Cmd' => 'date')` (see link)
+     * @param string|null $name   (optional) name to assign to this container
+     * @return Promise Promise<array> container properties `array('Id' => $containerId', 'Warnings' => array())`
+     * @link https://docs.docker.com/reference/api/docker_remote_api_v1.15/#create-a-container
+     */
+    public function containerCreate($config, $name = null)
+    {
+        return $this->postJson($this->url('/containers/create?name=%s', $name), $config)->then(array($this->parser, 'expectJson'));
+    }
+
     /**
      * Return low-level information on the container id
      *
@@ -126,6 +139,19 @@ public function containerResize($container, $w, $h)
         return $this->browser->get($this->url('/containers/%s/resize?w=%u&h=%u', $container, $w, $h))->then(array($this->parser, 'expectEmpty'));
     }
 
+    /**
+     * Start the container id
+     *
+     * @param string $container container ID
+     * @param array  $config    (optional) start config (see link)
+     * @return Promise Promise<null>
+     * @link https://docs.docker.com/reference/api/docker_remote_api_v1.15/#start-a-container
+     */
+    public function containerStart($container, $config = array())
+    {
+        return $this->postJson($this->url('/containers/%s/start', $container), $config)->then(array($this->parser, 'expectEmpty'));
+    }
+
     /**
      * Stop the container id
      *

tests/ClientTest.php

@@ -26,6 +26,24 @@ public function testPing()
         $this->expectPromiseResolveWith($body, $this->client->ping());
     }
 
+    public function testContainerCreate()
+    {
+        $json = array();
+        $config = array();
+        $this->expectRequestFlow('post', '/containers/create?name=', $this->createResponseJson($json), 'expectJson');
+
+        $this->expectPromiseResolveWith($json, $this->client->containerCreate($config));
+    }
+
+    public function testContainerCreateName()
+    {
+        $json = array();
+        $config = array();
+        $this->expectRequestFlow('post', '/containers/create?name=demo', $this->createResponseJson($json), 'expectJson');
+
+        $this->expectPromiseResolveWith($json, $this->client->containerCreate($config, 'demo'));
+    }
+
     public function testContainerInspect()
     {
         $json = array();
@@ -71,6 +89,14 @@ public function testContainerKillSignalNumber()
         $this->expectPromiseResolveWith('', $this->client->containerKill(123, 9));
     }
 
+    public function testContainerStart()
+    {
+        $config = array();
+        $this->expectRequestFlow('post', '/containers/123/start', $this->createResponse(), 'expectEmpty');
+
+        $this->expectPromiseResolveWith('', $this->client->containerStart(123, $config));
+    }
+
     public function testContainerStop()
     {
         $this->expectRequestFlow('post', '/containers/123/stop?t=10', $this->createResponse(), 'expectEmpty');

tests/FunctionalClientTest.php

@@ -32,6 +32,39 @@ public function testPing()
         $this->loop->run();
     }
 
+    public function testCreateStartAndRemoveContainer()
+    {
+        $config = array(
+            'Image' => 'busybox',
+            'Cmd' => array('echo', 'test')
+        );
+
+        $promise = $this->client->containerCreate($config);
+        $container = $this->waitFor($promise, $this->loop);
+
+        $this->assertNotNull($container['Id']);
+        $this->assertNull($container['Warnings']);
+
+        $promise = $this->client->containerStart($container['Id']);
+        $ret = $this->waitFor($promise, $this->loop);
+
+        $this->assertEquals('', $ret);
+
+        $promise = $this->client->containerRemove($container['Id'], false, true);
+        $ret = $this->waitFor($promise, $this->loop);
+
+        $this->assertEquals('', $ret);
+    }
+
+    /**
+     * @expectedException RuntimeException
+     */
+    public function testContainerRemoveInvalid()
+    {
+        $promise = $this->client->containerRemove('invalid123');
+        $this->waitFor($promise, $this->loop);
+    }
+
     public function testInfo()
     {
         $this->expectPromiseResolve($this->client->info());