Add ContextBlock for slack notifier

norkunas · norkunas · commit a58cbd7d2bc5 · 2020-12-01T08:23:38.000+02:00
diff --git a/src/Symfony/Component/Notifier/Bridge/Slack/Block/SlackContextBlock.php b/src/Symfony/Component/Notifier/Bridge/Slack/Block/SlackContextBlock.php
@@ -0,0 +1,65 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Symfony\Component\Notifier\Bridge\Slack\Block;
+
+final class SlackContextBlock extends AbstractSlackBlock
+{
+    private const ELEMENT_LIMIT = 10;
+
+    public function __construct()
+    {
+        $this->options['type'] = 'context';
+    }
+
+    public function text(string $text, bool $markdown = true, bool $emoji = true, bool $verbatim = false): self
+    {
+        if (self::ELEMENT_LIMIT === \count($this->options['elements'] ?? [])) {
+            throw new \LogicException('Maximum number of elements should not exceed 10.');
+        }
+
+        $element = [
+            'type' => $markdown ? 'mrkdwn' : 'plain_text',
+            'text' => $text,
+        ];
+        if (!$markdown) {
+            $element['emoji'] = $emoji;
+            $element['verbatim'] = $verbatim;
+        }
+        $this->options['elements'][] = $element;
+
+        return $this;
+    }
+
+    public function image(string $url, string $text): self
+    {
+        if (self::ELEMENT_LIMIT === \count($this->options['elements'] ?? [])) {
+            throw new \LogicException('Maximum number of elements should not exceed 10.');
+        }
+
+        $this->options['elements'][] = [
+            'type' => 'image',
+            'image_url' => $url,
+            'alt_text' => $text,
+        ];
+
+        return $this;
+    }
+
+    public function id(string $id): self
+    {
+        $this->options['block_id'] = $id;
+
+        return $this;
+    }
+}
diff --git a/src/Symfony/Component/Notifier/Bridge/Slack/Tests/Block/SlackContextBlockTest.php b/src/Symfony/Component/Notifier/Bridge/Slack/Tests/Block/SlackContextBlockTest.php
@@ -0,0 +1,77 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Notifier\Bridge\Slack\Tests\Block;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\Notifier\Bridge\Slack\Block\SlackContextBlock;
+
+final class SlackContextBlockTest extends TestCase
+{
+    public function testCanBeInstantiated(): void
+    {
+        $context = new SlackContextBlock();
+        $context->text('context text');
+        $context->image('https://example.com/image.jpg', 'an image');
+        $context->id('context_id');
+
+        $this->assertSame([
+            'type' => 'context',
+            'elements' => [
+                [
+                    'type' => 'mrkdwn',
+                    'text' => 'context text',
+                ],
+                [
+                    'type' => 'image',
+                    'image_url' => 'https://example.com/image.jpg',
+                    'alt_text' => 'an image',
+                ],
+            ],
+            'block_id' => 'context_id',
+        ], $context->toArray());
+    }
+
+    public function testSetsPropertiesForPlainText(): void
+    {
+        $context = new SlackContextBlock();
+        $context->text('plain context text', false, false, true);
+
+        $this->assertSame([
+            'type' => 'context',
+            'elements' => [
+                [
+                    'type' => 'plain_text',
+                    'text' => 'plain context text',
+                    'emoji' => false,
+                    'verbatim' => true,
+                ],
+            ],
+        ], $context->toArray());
+    }
+
+    public function testThrowsWhenElementsLimitReached(): void
+    {
+        $context = new SlackContextBlock();
+        for ($i = 0; $i < 10; ++$i) {
+            if (0 === $i % 2) {
+                $context->text($i);
+            } else {
+                $context->image($i, $i);
+            }
+        }
+
+        $this->expectException(\LogicException::class);
+        $this->expectExceptionMessage('Maximum number of elements should not exceed 10.');
+
+        $context->text('fail');
+    }
+}
