Create new group with the Example and Test

Example/GroupsExample.php

@@ -37,6 +37,10 @@ public function groupsExample()
         // instantiate pushover group (can be injected into service using Dependency Injection)
         $group = new Group("replace_with_pushover_group_key", $application);
 
+        // Use any valid key or placeholder ^[a-zA-Z0-9]{30}$ as group key to create new group
+        $createGroupResponse = $group->create('Test');
+        $newGroupKey = $createGroupResponse->getGroupKey();
+
         // Retrieve information about the group from the API and populate the object with it.
         /** @var RetrieveGroupResponse $retrieveGroupResponse */
         $retrieveGroupResponse = $group->retrieveGroupInformation();

README.md

@@ -25,6 +25,7 @@ Light, simple and fast, yet comprehensive wrapper for the [Pushover](https://pus
   - Query emergency priority receipt
   - Cancel emergency priority retry
 - Groups API ([Example](Example/GroupsExample.php))
+  - Create the new group
   - Retrieve information about the group
   - Add / Remove users
   - Enable / Disable users

src/Api/Groups/Group.php

@@ -15,6 +15,7 @@
 use Serhiy\Pushover\Client\Curl\Curl;
 use Serhiy\Pushover\Client\GroupsClient;
 use Serhiy\Pushover\Client\Request\Request;
+use Serhiy\Pushover\Client\Response\CreateGroupResponse;
 use Serhiy\Pushover\Client\Response\AddUserToGroupResponse;
 use Serhiy\Pushover\Client\Response\DisableUserInGroupResponse;
 use Serhiy\Pushover\Client\Response\EnableUserInGroupResponse;
@@ -56,6 +57,11 @@ class Group
      */
     private $users;
 
+    /**
+     * @param string $key Group key. (Put str_repeat('0', 30) before creating new group)
+     *
+     * @throws InvalidArgumentException
+     */
     public function __construct(string $key, Application $application)
     {
         if (1 != preg_match("/^[a-zA-Z0-9]{30}$/", $key)) {
@@ -121,6 +127,24 @@ public function retrieveGroupInformation(): RetrieveGroupResponse
         return $response;
     }
 
+    /**
+     * Create the group. Reflected in the API and in the group editor on our website.
+     */
+    public function create(string $name): CreateGroupResponse
+    {
+        $this->name = $name;
+
+        $client = new GroupsClient($this, GroupsClient::ACTION_CREATE_GROUP);
+        $request = new Request($client->buildApiUrl(), Request::POST, $client->buildCurlPostFields());
+
+        $curlResponse = Curl::do($request);
+
+        $response = new CreateGroupResponse($curlResponse);
+        $response->setRequest($request);
+
+        return $response;
+    }
+
     /**
      * Adds an existing Pushover user to your Delivery Group.
      *

src/Client/GroupsClient.php

@@ -27,6 +27,7 @@ class GroupsClient extends Client implements ClientInterface
     const ACTION_DISABLE_USER = "disable_user";
     const ACTION_ENABLE_USER = "enable_user";
     const ACTION_RENAME_GROUP = "rename";
+    const ACTION_CREATE_GROUP = "create";
 
     /**
      * @var Group
@@ -53,6 +54,10 @@ public function __construct(Group $group, string $action)
      */
     public function buildApiUrl()
     {
+        if ($this->action == self::ACTION_CREATE_GROUP) {
+            return Curl::API_BASE_URL."/".Curl::API_VERSION."/groups.json";
+        }
+
         if ($this->action == self::ACTION_RETRIEVE_GROUP) {
             return Curl::API_BASE_URL."/".Curl::API_VERSION."/groups/".$this->group->getKey().".json?token=".$this->group->getApplication()->getToken();
         }
@@ -89,7 +94,9 @@ public function buildCurlPostFields(Recipient $recipient = null): array
             }
         }
 
-        if ($this->action == self::ACTION_RENAME_GROUP) {
+        if ($this->action == self::ACTION_RENAME_GROUP ||
+            $this->action == self::ACTION_CREATE_GROUP
+        ) {
             $curlPostFields["name"] = $this->group->getName();
         }
 

src/Client/Response/CreateGroupResponse.php

@@ -0,0 +1,50 @@
+<?php
+
+/*
+ * This file is part of the Pushover package.
+ *
+ * (c) Serhiy Lunak <https://github.com/slunak>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Serhiy\Pushover\Client\Response;
+
+use Serhiy\Pushover\Client\Response\Base\Response;
+
+/**
+ * @author Serhiy Lunak
+ */
+class CreateGroupResponse extends Response
+{
+    /**
+     * @var string Obtained Group Key
+     */
+    private $groupKey;
+
+    /**
+     * @param mixed $curlResponse
+     */
+    public function __construct($curlResponse)
+    {
+        $this->processCurlResponse($curlResponse);
+    }
+
+    /**
+     * @param mixed $curlResponse
+     */
+    private function processCurlResponse($curlResponse): void
+    {
+        $decodedCurlResponse = $this->processInitialCurlResponse($curlResponse);
+        $this->groupKey = property_exists($decodedCurlResponse,'group') ? $decodedCurlResponse->group : null;
+    }
+
+    /**
+     * @return string Group key obtained
+     */
+    public function getGroupKey(): string
+    {
+        return $this->groupKey;
+    }
+}

tests/Api/Groups/GroupTest.php

@@ -15,6 +15,7 @@
 use PHPUnit\Framework\TestCase;
 use Serhiy\Pushover\Application;
 use Serhiy\Pushover\Client\Response\RetrieveGroupResponse;
+use Serhiy\Pushover\Client\Response\CreateGroupResponse;
 
 /**
  * @author Serhiy Lunak
@@ -65,4 +66,17 @@ public function testRetrieveGroupInformation()
 
         $this->assertInstanceOf(RetrieveGroupResponse::class, $response);
     }
+
+    /**
+     * @group Integration
+     */
+    public function testCreate()
+    {
+        $application = new Application("cccc3333CCCC3333dddd4444DDDD44"); // using dummy token
+        $group = new Group("eeee5555EEEE5555ffff6666FFFF66", $application);
+
+        $response = $group->create('unit test '. date('Y-m-d H:i:s'));
+
+        $this->assertInstanceOf(CreateGroupResponse::class, $response);
+    }    
 }