Maknz\Slack\Message

Complexity

Total Complexity

38

Size/Duplication

Total Lines	466
Duplicated Lines	0 %

Test Coverage

Coverage

80.61%

Importance

Changes	6
Bugs	2	Features	1

27 Methods

Rating	Name	Duplication	Size	Complexity
A	getAllowMarkdown()	0	3	1
A	setBlocks()	0	9	2
A	withBlock()	0	14	3
A	getText()	0	3	1
A	getMarkdownInAttachments()	0	3	1
A	setUsername()	0	5	1
A	clearBlocks()	0	5	1
A	getIconType()	0	3	1
A	disableMarkdown()	0	5	1
A	getBlocks()	0	3	1
A	getChannel()	0	3	1
A	setAttachments()	0	9	2
A	getBlocksAsArrays()	0	9	2
A	clearAttachments()	0	5	1
A	from()	0	5	1
A	setIcon()	0	17	4
A	getIcon()	0	3	1
A	setAllowMarkdown()	0	5	1
A	setChannel()	0	5	1
A	withIcon()	0	5	1
A	enableMarkdown()	0	5	1
A	attach()	0	19	4
A	getAttachments()	0	3	1
A	setMarkdownInAttachments()	0	5	1
A	to()	0	5	1
A	setText()	0	5	1
A	getUsername()	0	3	1

<?php
namespace Maknz\Slack;

use InvalidArgumentException;

class Message
{
    /**
     * The text to send with the message.
     *
     * @var string
     */
    protected $text;

    /**
     * The channel the message should be sent to.
     *
     * @var string
     */
    protected $channel;

    /**
     * The username the message should be sent as.
     *
     * @var string
     */
    protected $username;

    /**
     * The URL to the icon to use.
     *
     * @var string
     */
    protected $icon;

    /**
     * The type of icon we are using.
     *
     * @var string (one of self::ICON_* constants)
     */
    protected $iconType;

    /**
     * Whether the message text should be interpreted in Slack's
     * Markdown-like language.
     *
     * @var bool
     */
    protected $allow_markdown = true;

    /**
     * The attachment fields which should be formatted with
     * Slack's Markdown-like language.
     *
     * @var array
     */
    protected $markdown_in_attachments = [];

    /**
     * An array of attachments to send.
     *
     * @var Attachment[]
     */
    protected $attachments = [];

    /**
     * An array of blocks to send.
     *
     * @var Block[]
     */
    protected $blocks = [];

    /**
     * @var string
     */
    const ICON_TYPE_URL = 'icon_url';

    /**
     * @var string
     */
    const ICON_TYPE_EMOJI = 'icon_emoji';

    /**
     * Get the message text.
     *
     * @return string
     */
    public function getText()
    {
        return $this->text;
    }

    /**
     * Set the message text.
     *
     * @param string $text
     *
     * @return $this
     */
    public function setText($text)
    {
        $this->text = $text;

        return $this;
    }

    /**
     * Get the channel we will post to.
     *
     * @return string
     */
    public function getChannel()
    {
        return $this->channel;
    }

    /**
     * Set the channel we will post to.
     *
     * @param string $channel
     *
     * @return $this
     */
    public function setChannel($channel)
    {
        $this->channel = $channel;

        return $this;
    }

    /**
     * Get the username we will post as.
     *
     * @return string
     */
    public function getUsername()
    {
        return $this->username;
    }

    /**
     * Set the username we will post as.
     *
     * @param string $username
     *
     * @return $this
     */
    public function setUsername($username)
    {
        $this->username = $username;

        return $this;
    }

    /**
     * Get the icon (either URL or emoji) we will post as.
     *
     * @return string
     */
    public function getIcon()
    {
        return $this->icon;
    }

    /**
     * Set the icon (either URL or emoji) we will post as.
     *
     * @param string $icon
     *
     * @return $this
     */
    public function setIcon($icon)
    {
        if ($icon == null) {
            $this->icon = $this->iconType = null;

            return $this;
        }

        if (mb_substr($icon, 0, 1) == ':' && mb_substr($icon, mb_strlen($icon) - 1, 1) == ':') {
            $this->iconType = self::ICON_TYPE_EMOJI;
        } else {
            $this->iconType = self::ICON_TYPE_URL;
        }

        $this->icon = $icon;

        return $this;
    }

    /**
     * Get the icon type being used, if an icon is set.
     *
     * @return string
     */
    public function getIconType()
    {
        return $this->iconType;
    }

    /**
     * Get whether message text should be formatted with
     * Slack's Markdown-like language.
     *
     * @return bool
     */
    public function getAllowMarkdown()
    {
        return $this->allow_markdown;
    }

    /**
     * Set whether message text should be formatted with
     * Slack's Markdown-like language.
     *
     * @param bool $value
     *
     * @return $this
     */
    public function setAllowMarkdown($value)
    {
        $this->allow_markdown = (bool)$value;

        return $this;
    }

    /**
     * Enable Markdown formatting for the message.
     *
     * @return $this
     */
    public function enableMarkdown()
    {
        $this->setAllowMarkdown(true);

        return $this;
    }

    /**
     * Disable Markdown formatting for the message.
     *
     * @return $this
     */
    public function disableMarkdown()
    {
        $this->setAllowMarkdown(false);

        return $this;
    }

    /**
     * Get the attachment fields which should be formatted
     * in Slack's Markdown-like language.
     *
     * @return array
     */
    public function getMarkdownInAttachments()
    {
        return $this->markdown_in_attachments;
    }

    /**
     * Set the attachment fields which should be formatted
     * in Slack's Markdown-like language.
     *
     * @param array $fields
     *
     * @return $this
     */
    public function setMarkdownInAttachments(array $fields)
    {
        $this->markdown_in_attachments = $fields;

        return $this;
    }

    /**
     * Change the name of the user the post will be made as.
     *
     * @param string $username
     *
     * @return $this
     */
    public function from($username)
    {
        $this->setUsername($username);

        return $this;
    }

    /**
     * Change the channel the post will be made to.
     *
     * @param string $channel
     *
     * @return $this
     */
    public function to($channel)
    {
        $this->setChannel($channel);

        return $this;
    }

    /**
     * Chainable method for setting the icon.
     *
     * @param string $icon
     *
     * @return $this
     */
    public function withIcon($icon)
    {
        $this->setIcon($icon);

        return $this;
    }

    /**
     * Add an attachment to the message.
     *
     * @param mixed $attachment
     *
     * @return $this
     *
     * @throws \InvalidArgumentException
     */
    public function attach($attachment)
    {
        if ($attachment instanceof Attachment) {
            $this->attachments[] = $attachment;

            return $this;
        } elseif (is_array($attachment)) {
            $attachmentObject = new Attachment($attachment);

            if ( ! isset($attachment['mrkdwn_in'])) {
                $attachmentObject->setMarkdownFields($this->getMarkdownInAttachments());
            }

            $this->attachments[] = $attachmentObject;

            return $this;
        }

        throw new InvalidArgumentException('Attachment must be an instance of Maknz\\Slack\\Attachment or a keyed array');
    }

    /**
     * Get the attachments for the message.
     *
     * @return Attachment[]
     */
    public function getAttachments()
    {
        return $this->attachments;
    }

    /**
     * Set the attachments for the message.
     *
     * @param array $attachments
     *
     * @return $this
     *
     * @throws \InvalidArgumentException
     */
    public function setAttachments(array $attachments)
    {
        $this->clearAttachments();

        foreach ($attachments as $attachment) {
            $this->attach($attachment);
        }

        return $this;
    }

    /**
     * Remove all attachments for the message.
     *
     * @return $this
     */
    public function clearAttachments()
    {
        $this->attachments = [];

        return $this;
    }

    /**
     * Add a block to the message.
     *
     * @param mixed $block
     *
     * @return $this
     *
     * @throws \InvalidArgumentException
     */
    public function withBlock($block)
    {
        if ($block instanceof Block) {
            $this->blocks[] = $block;

            return $this;
        } elseif (is_array($block)) {
            $blockObject = Block::factory($block);
            $this->blocks[] = $blockObject;

            return $this;
        }

        throw new InvalidArgumentException('Block must be an instance of Maknz\\Slack\\Block or a keyed array');
    }

    /**
     * Get the blocks for the message.
     *
     * @return Block[]
     */
    public function getBlocks()
    {
        return $this->blocks;
    }

    /**
     * Get the blocks for the message in array format.
     *
     * @return array
     */
    public function getBlocksAsArrays()
    {
        $blocks = [];

        foreach ($this->getBlocks() as $block) {
            $blocks[] = $block->toArray();
        }

        return $blocks;
    }

    /**
     * Set the blocks for the message.
     *
     * @param array $blocks
     *
     * @return $this
     *
     * @throws \InvalidArgumentException
     */
    public function setBlocks(array $blocks)
    {
        $this->clearBlocks();

        foreach ($blocks as $block) {
            $this->withBlock($block);
        }

        return $this;
    }

    /**
     * Remove all blocks for the message.
     *
     * @return $this
     */
    public function clearBlocks()
    {
        $this->blocks = [];

        return $this;
    }
}