Docblock updates and better test command output

Author: stayallive

src/Sentry/Laravel/SentryHandler.php

@@ -36,8 +36,8 @@ class SentryHandler extends AbstractProcessingHandler
     protected $batchFormatter;
 
     /**
-     * @param Hub $hub
-     * @param int $level The minimum logging level at which this handler will be triggered
+     * @param Hub  $hub
+     * @param int  $level  The minimum logging level at which this handler will be triggered
      * @param bool $bubble Whether the messages that are handled can bubble up the stack or not
      */
     public function __construct(Hub $hub, $level = Logger::DEBUG, bool $bubble = true)
@@ -95,6 +95,8 @@ function ($highest, $record) {
      * Sets the formatter for the logs generated by handleBatch().
      *
      * @param FormatterInterface $formatter
+     *
+     * @return \Sentry\Laravel\SentryHandler
      */
     public function setBatchFormatter(FormatterInterface $formatter): self
     {
@@ -117,6 +119,10 @@ public function getBatchFormatter(): FormatterInterface
 
     /**
      * Translates Monolog log levels to Sentry Severity.
+     *
+     * @param int $logLevel
+     *
+     * @return \Sentry\Severity
      */
     protected function getLogLevel($logLevel)
     {
@@ -228,7 +234,10 @@ protected function getDefaultBatchFormatter(): FormatterInterface
     }
 
     /**
-     * @param  string $value
+     * Set the release.
+     *
+     * @param string $value
+     *
      * @return self
      */
     public function setRelease($value): self
@@ -238,6 +247,13 @@ public function setRelease($value): self
         return $this;
     }
 
+    /**
+     * Set the current application environment.
+     *
+     * @param string $value
+     *
+     * @return self
+     */
     public function setEnvironment($value): self
     {
         $this->environment = $value;
@@ -246,7 +262,13 @@ public function setEnvironment($value): self
     }
 
     /**
+     * Add a breadcrumb.
+     *
      * @link https://docs.sentry.io/learn/breadcrumbs/
+     *
+     * @param \Sentry\Breadcrumb $crumb
+     *
+     * @return \Sentry\Laravel\SentryHandler
      */
     public function addBreadcrumb(Breadcrumb $crumb): self
     {

src/Sentry/Laravel/TestCommand.php

@@ -45,7 +45,8 @@ public function handle()
             if ($hub->getClient()->getOptions()->getDsn()) {
                 $this->info('[sentry] Client DSN discovered!');
             } else {
-                $this->warn('[sentry] Could not discover DSN! Check your config or .env file');
+                $this->error('[sentry] Could not discover DSN!');
+                $this->error('[sentry] Please check if you DSN is set properly in your config or `.env` as `SENTRY_LARAVEL_DSN`.');
 
                 return;
             }
@@ -62,7 +63,7 @@ public function handle()
 
             if (!$lastEventId) {
                 $this->error('[sentry] There was an error sending the test event.');
-                $this->error('[sentry] Please check if you DSN is set properly in your config or .env as `SENTRY_LARAVEL_DSN`.');
+                $this->error('[sentry] Please check if you DSN is set properly in your config or `.env` as `SENTRY_LARAVEL_DSN`.');
             } else {
                 $this->info("[sentry] Event sent with ID: {$lastEventId}");
             }