Helix\Asana\Task\Attachment

Complexity

Total Complexity

2

Size/Duplication

Total Lines	35
Duplicated Lines	0 %

Importance

Changes	10
Bugs	1	Features	2

2 Methods

Rating	Name	Duplication	Size	Complexity
A	__toString()	0	2	1
A	create()	0	8	1

<?php

namespace Helix\Asana\Task;

use CURLFile;
use Helix\Asana\Base\AbstractEntity;
use Helix\Asana\Base\AbstractEntity\DeleteTrait;
use Helix\Asana\Base\AbstractEntity\ImmutableInterface;
use Helix\Asana\Task;

/**
 * A file attachment.
 *
 * @see https://developers.asana.com/docs/asana-attachments
 * @see https://developers.asana.com/docs/attachment
 *
 * @immutable Attachments may only be deleted after creation.
 *
 * @method string   getCreatedAt    () RFC3339x
 * @method string   getDownloadUrl  ()
 * @method string   getHost         ()
 * @method string   getName         ()
 * @method Task     getParent       ()
 * @method string   getPermanentUrl () Short, human-friendly.
 * @method string   getViewUrl      ()
 */
class Attachment extends AbstractEntity implements ImmutableInterface {

    use DeleteTrait;

    const TYPE = 'attachment';

    protected const MAP = [
        'parent' => Task::class
    ];

    /**
     * `attachments/{gid}`
     *
     * @return string
     */
    final public function __toString (): string {
        return "attachments/{$this->getGid()}";
    }

    /**
     * Creates the attachment by uploading a file.
     *
     * @see https://developers.asana.com/docs/upload-an-attachment
     *
     * @param string $file
     * @return $this
     */
    public function create (string $file) {
        // api returns compact version. reload.
        $remote = $this->api->call('POST', "{$this->getParent()}/attachments", [
            CURLOPT_POSTFIELDS => ['file' => new CURLFile(realpath($file))] // multipart/form-data
        ])['data'];
        $this->data['gid'] = $remote['gid'];
        $this->reload();
        return $this;
    }
}