Merge pull request #43 from laravel-notification-channels/improvements

Code improvements

Author: alexsoft

.gitignore

@@ -3,3 +3,4 @@ build
 composer.phar
 composer.lock
 .phpunit.result.cache
+build/

phpunit.xml.dist

@@ -11,14 +11,16 @@
          stopOnFailure="false">
     <testsuites>
         <testsuite name="Pushbullet Notification Channel Test Suite">
-            <directory>tests</directory>
+            <directory suffix="Test.php">tests</directory>
         </testsuite>
     </testsuites>
+
     <filter>
-        <whitelist>
-            <directory suffix=".php">src/</directory>
+        <whitelist processUncoveredFilesFromWhitelist="true">
+            <directory suffix=".php">src</directory>
         </whitelist>
     </filter>
+
     <logging>
         <log type="tap" target="build/report.tap"/>
         <log type="junit" target="build/report.junit.xml"/>

src/Exceptions/CouldNotSendNotification.php

@@ -1,33 +1,30 @@
 <?php
 
+declare(strict_types=1);
+
 namespace NotificationChannels\Pushbullet\Exceptions;
 
-use GuzzleHttp\Exception\ClientException;
+use Psr\Http\Message\ResponseInterface;
 use RuntimeException;
 
 class CouldNotSendNotification extends RuntimeException
 {
-    public static function pushbulletRespondedWithAnError(ClientException $exception)
+    public static function pushbulletRespondedWithAnError(ResponseInterface $response): self
     {
-        $code = $exception->getResponse()->getStatusCode();
-
-        $message = $exception->getResponse()->getBody();
+        $code = $response->getStatusCode();
 
-        return new static("Pushbullet responded with an error `{$code} - {$message}`");
-    }
+        $message = $response->getBody();
 
-    public static function providedEmailIsInvalid($email)
-    {
-        return new static("Provided email `{$email}` of `notifiable` is not valid");
+        return new self("Pushbullet responded with error: `{$code} - {$message}`.");
     }
 
-    public static function couldNotSendNotificationWithoutRecipient()
+    public static function providedEmailIsInvalid(string $email): self
     {
-        return new static('Neither device id nor email of recipient was not specified');
+        return new self("Provided email `{$email}` of `notifiable` is not valid.");
     }
 
-    public static function couldNotCommunicateWithPushbullet()
+    public static function couldNotCommunicateWithPushbullet(): self
     {
-        return new static("Couldn't connect to Pushbullet API.");
+        return new self('Could not connect to Pushbullet API.');
     }
 }

src/Pushbullet.php

@@ -1,30 +1,32 @@
 <?php
 
+declare(strict_types=1);
+
 namespace NotificationChannels\Pushbullet;
 
 use Exception;
 use GuzzleHttp\Client as HttpClient;
 use GuzzleHttp\Exception\ClientException;
 use NotificationChannels\Pushbullet\Exceptions\CouldNotSendNotification;
+use Psr\Http\Message\ResponseInterface;
 
 class Pushbullet
 {
     /** @var string */
-    protected $token;
+    private $token;
 
     /** @var \GuzzleHttp\Client */
-    protected $httpClient;
+    private $httpClient;
 
     /**
      * Create small Pushbullet client.
      *
      * @param  string  $token
      * @param  \GuzzleHttp\Client  $httpClient
      */
-    public function __construct($token, HttpClient $httpClient)
+    public function __construct(string $token, HttpClient $httpClient)
     {
         $this->token = $token;
-
         $this->httpClient = $httpClient;
     }
 
@@ -33,7 +35,7 @@ public function __construct($token, HttpClient $httpClient)
      *
      * @return string
      */
-    protected function getPushbulletUrl()
+    private function getPushbulletUrl(): string
     {
         return 'https://api.pushbullet.com/v2/pushes';
     }
@@ -43,7 +45,7 @@ protected function getPushbulletUrl()
      *
      * @return array
      */
-    protected function getHeaders()
+    private function getHeaders(): array
     {
         return [
             'Access-Token' => $this->token,
@@ -54,9 +56,10 @@ protected function getHeaders()
      * Send request to Pushbullet API.
      *
      * @param  array  $params
+     *
      * @return \Psr\Http\Message\ResponseInterface
      */
-    public function send($params)
+    public function send($params): ResponseInterface
     {
         $url = $this->getPushbulletUrl();
 
@@ -66,7 +69,7 @@ public function send($params)
                 'headers' => $this->getHeaders(),
             ]);
         } catch (ClientException $exception) {
-            throw CouldNotSendNotification::pushbulletRespondedWithAnError($exception);
+            throw CouldNotSendNotification::pushbulletRespondedWithAnError($exception->getResponse());
         } catch (Exception $exception) {
             throw CouldNotSendNotification::couldNotCommunicateWithPushbullet();
         }

src/PushbulletChannel.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace NotificationChannels\Pushbullet;
 
 use Illuminate\Notifications\Notification;
@@ -9,13 +11,10 @@
 
 class PushbulletChannel
 {
-    /**
-     * @var \NotificationChannels\Pushbullet\Pushbullet
-     */
-    protected $pushbullet;
+    /** @var \NotificationChannels\Pushbullet\Pushbullet */
+    private $pushbullet;
 
     /**
-     * Create pushbullet notification channel.
      * @param  \NotificationChannels\Pushbullet\Pushbullet  $pushbullet
      */
     public function __construct(Pushbullet $pushbullet)
@@ -31,7 +30,7 @@ public function __construct(Pushbullet $pushbullet)
      *
      * @throws \NotificationChannels\Pushbullet\Exceptions\CouldNotSendNotification
      */
-    public function send($notifiable, Notification $notification)
+    public function send($notifiable, Notification $notification): void
     {
         if (! $target = $this->getTarget($notifiable)) {
             return;
@@ -45,12 +44,13 @@ public function send($notifiable, Notification $notification)
 
     /**
      * @param $notifiable
+     *
      * @return  \NotificationChannels\Pushbullet\Targets\Targetable|void
      */
-    protected function getTarget($notifiable)
+    private function getTarget($notifiable): ?Targetable
     {
         if (! $target = $notifiable->routeNotificationFor('pushbullet')) {
-            return;
+            return null;
         }
 
         if ($target instanceof Targetable) {

src/PushbulletMessage.php

@@ -1,13 +1,15 @@
 <?php
 
+declare(strict_types=1);
+
 namespace NotificationChannels\Pushbullet;
 
 use NotificationChannels\Pushbullet\Targets\Targetable;
 
 class PushbulletMessage
 {
-    const TYPE_NOTE = 'note';
-    const TYPE_LINK = 'link';
+    private const TYPE_NOTE = 'note';
+    private const TYPE_LINK = 'link';
 
     /**
      * Type of message (currently: note or link).
@@ -45,7 +47,7 @@ class PushbulletMessage
      *
      * @return static
      */
-    public static function create($message)
+    public static function create($message): self
     {
         return new static($message);
     }
@@ -63,7 +65,7 @@ public function __construct($message)
      *
      * @return $this
      */
-    public function target(Targetable $targetable)
+    public function target(Targetable $targetable): self
     {
         $this->target = $targetable;
 
@@ -75,9 +77,9 @@ public function target(Targetable $targetable)
      *
      * @return $this
      */
-    public function note()
+    public function note(): self
     {
-        $this->type = static::TYPE_NOTE;
+        $this->type = self::TYPE_NOTE;
 
         return $this;
     }
@@ -87,9 +89,9 @@ public function note()
      *
      * @return $this
      */
-    public function link()
+    public function link(): self
     {
-        $this->type = static::TYPE_LINK;
+        $this->type = self::TYPE_LINK;
 
         return $this;
     }
@@ -101,7 +103,7 @@ public function link()
      *
      * @return $this
      */
-    public function title($title)
+    public function title($title): self
     {
         $this->title = $title;
 
@@ -115,7 +117,7 @@ public function title($title)
      *
      * @return $this
      */
-    public function message($message)
+    public function message($message): self
     {
         $this->message = $message;
 
@@ -129,7 +131,7 @@ public function message($message)
      *
      * @return $this
      */
-    public function url($url)
+    public function url($url): self
     {
         $this->url = $url;
 
@@ -141,7 +143,7 @@ public function url($url)
      *
      * @return array
      */
-    public function toArray()
+    public function toArray(): array
     {
         $payload = [
             'type' => $this->type,
@@ -159,15 +161,15 @@ public function toArray()
     /**
      * @return bool
      */
-    private function isLink()
+    private function isLink(): bool
     {
-        return $this->type === static::TYPE_LINK;
+        return $this->type === self::TYPE_LINK;
     }
 
     /**
      * @return array
      */
-    private function getUrlParameter()
+    private function getUrlParameter(): array
     {
         return $this->isLink() ? ['url' => $this->url] : [];
     }

src/PushbulletServiceProvider.php

@@ -1,24 +1,22 @@
 <?php
 
+declare(strict_types=1);
+
 namespace NotificationChannels\Pushbullet;
 
 use GuzzleHttp\Client as HttpClient;
 use Illuminate\Support\ServiceProvider;
 
 class PushbulletServiceProvider extends ServiceProvider
 {
-    /**
-     * Bootstrap the application services.
-     */
-    public function boot()
+    public function boot(): void
     {
-        // Bootstrap code here.
         $this->app->when(PushbulletChannel::class)
             ->needs(Pushbullet::class)
-            ->give(function () {
+            ->give(static function (): Pushbullet {
                 $config = config('services.pushbullet');
 
-                return new Pushbullet($config['access_token'], new HttpClient);
+                return new Pushbullet($config['access_token'], new HttpClient());
             });
     }
 }

src/Targets/Channel.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace NotificationChannels\Pushbullet\Targets;
 
 class Channel implements Targetable

src/Targets/Device.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace NotificationChannels\Pushbullet\Targets;
 
 class Device implements Targetable

src/Targets/Email.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace NotificationChannels\Pushbullet\Targets;
 
 use NotificationChannels\Pushbullet\Exceptions\CouldNotSendNotification;