HummingBirdAnimeClient/src/AnimeClient/API/Kitsu/MutationTrait.php

76 lines
1.7 KiB
PHP
Raw Normal View History

2020-07-28 16:11:13 -04:00
<?php declare(strict_types=1);
/**
* Hummingbird Anime List Client
*
* An API client for Kitsu to manage anime and manga watch lists
*
2021-02-04 11:57:01 -05:00
* PHP version 8
2020-07-28 16:11:13 -04:00
*
2022-03-04 15:50:35 -05:00
* @copyright 2015 - 2022 Timothy J. Warren <tim@timshome.page>
2020-07-28 16:11:13 -04:00
* @license http://www.opensource.org/licenses/mit-license.html MIT License
2020-12-10 17:06:50 -05:00
* @version 5.2
2022-03-04 15:50:35 -05:00
* @link https://git.timshome.page/timw4mail/HummingBirdAnimeClient
2020-07-28 16:11:13 -04:00
*/
namespace Aviat\AnimeClient\API\Kitsu;
use Amp\Http\Client\Request;
use Aviat\AnimeClient\Types\FormItem;
/**
* Kitsu API calls that mutate data, C/U/D parts of CRUD
*/
trait MutationTrait
{
2020-07-28 16:11:13 -04:00
// -------------------------------------------------------------------------
// ! Generic API calls
// -------------------------------------------------------------------------
/**
* Create a list item
*/
public function createListItem(array $data): ?Request
{
$data['user_id'] = $this->getUserId();
if ($data['id'] === NULL)
{
return NULL;
}
return $this->listItem->create($data);
}
/**
* Increase the progress count for a list item
*/
public function incrementListItem(FormItem $data): Request
{
return $this->listItem->increment($data['id'], $data['data']);
}
/**
* Modify a list item
*/
public function updateListItem(FormItem $data): Request
{
return $this->listItem->update($data['id'], $data['data']);
}
/**
* Remove a list item
*
* @param string $id - The id of the list item to remove
*/
public function deleteListItem(string $id): Request
{
return $this->listItem->delete($id);
}
/**
* Remove a list item
*/
public function deleteItem(FormItem $data): Request
{
return $this->listItem->delete($data['id']);
}
}