HummingBirdAnimeClient/src/AnimeClient/Model/MediaTrait.php

202 lines
4.6 KiB
PHP
Raw Normal View History

<?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
*
2022-03-04 15:50:35 -05:00
* @copyright 2015 - 2022 Timothy J. Warren <tim@timshome.page>
* @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
*/
namespace Aviat\AnimeClient\Model;
use Aviat\AnimeClient\API\{Anilist, Kitsu, ParallelAPIRequest};
use Aviat\AnimeClient\Types\{AnimeListItem, FormItem, MangaListItem};
use Aviat\Ion\Di\ContainerInterface;
use Aviat\Ion\Json;
use Throwable;
/**
* Common functionality for Anime/Manga Models
*/
trait MediaTrait
{
/**
* Is the Anilist API enabled?
*/
protected bool $anilistEnabled;
/**
* Model for making requests to Anilist API
*/
protected Anilist\Model $anilistModel;
/**
* Model for making requests to Kitsu API
*/
protected Kitsu\Model $kitsuModel;
/**
* Anime constructor.
*/
public function __construct(ContainerInterface $container)
{
$this->anilistModel = $container->get('anilist-model');
$this->kitsuModel = $container->get('kitsu-model');
$config = $container->get('config');
$this->anilistEnabled = (bool) $config->get(['anilist', 'enabled']);
}
/**
* Search for anime by name
*
* @return mixed[]
*/
public function search(string $name, bool $inCollection = FALSE): array
{
$data = $this->kitsuModel->search($this->type, urldecode($name));
if ($inCollection)
{
// @TODO: allow filtering collection search by existing items
}
return $data;
}
/**
* Get information about a specific list item
* for editing/updating that item
*/
2022-09-22 12:08:21 -04:00
public function getItem(string $itemId): AnimeListItem|MangaListItem
{
return $this->kitsuModel->getListItem($itemId);
}
/**
* Add an anime to your list
*
* @throws Throwable
*/
2022-09-22 12:08:21 -04:00
public function createItem(array $data): bool
{
$requester = new ParallelAPIRequest();
2021-02-12 19:17:39 -05:00
$kitsuRequest = $this->kitsuModel->createListItem($data);
if ($kitsuRequest === NULL)
{
return FALSE;
}
$requester->addRequest($kitsuRequest, 'kitsu');
if ($this->anilistEnabled)
{
// If can't map MAL id, this will be null
$maybeRequest = $this->anilistModel->createListItem($data, strtoupper($this->type));
if ($maybeRequest !== NULL)
{
$requester->addRequest($maybeRequest, 'anilist');
}
}
$results = $requester->makeRequests();
return $results !== [];
}
/**
* Increment progress for the specified anime
*
* @throws Throwable
* @return array<string, mixed>
*/
2022-09-22 12:08:21 -04:00
public function incrementItem(FormItem $data): array
{
$requester = new ParallelAPIRequest();
$requester->addRequest($this->kitsuModel->incrementListItem($data), 'kitsu');
if ($this->anilistEnabled)
{
// If can't map MAL id, this will be null
$maybeRequest = $this->anilistModel->incrementListItem($data, strtoupper($this->type));
if ($maybeRequest !== NULL)
{
$requester->addRequest($maybeRequest, 'anilist');
}
}
$results = $requester->makeRequests();
$body = Json::decode($results['kitsu']);
$statusCode = array_key_exists('error', $body) ? 400 : 200;
return [
'body' => Json::decode($results['kitsu']),
'statusCode' => $statusCode,
];
}
/**
* Update a list entry
*
* @throws Throwable
* @return array<string, mixed>
*/
2022-09-22 12:08:21 -04:00
public function updateItem(FormItem $data): array
{
$requester = new ParallelAPIRequest();
$requester->addRequest($this->kitsuModel->updateListItem($data), 'kitsu');
if ($this->anilistEnabled)
{
// If can't map MAL id, this will be null
$maybeRequest = $this->anilistModel->updateListItem($data, strtoupper($this->type));
if ($maybeRequest !== NULL)
{
$requester->addRequest($maybeRequest, 'anilist');
}
}
$results = $requester->makeRequests();
$body = Json::decode($results['kitsu']);
$statusCode = array_key_exists('errors', $body) ? 400 : 200;
return [
'body' => Json::decode($results['kitsu']),
'statusCode' => $statusCode,
];
}
/**
* Delete a list entry
*
* @throws Throwable
*/
2022-09-22 12:08:21 -04:00
public function deleteItem(FormItem $data): bool
{
$requester = new ParallelAPIRequest();
2022-09-22 12:08:21 -04:00
$requester->addRequest($this->kitsuModel->deleteItem($data), 'kitsu');
if ($this->anilistEnabled)
{
// If can't map MAL id, this will be null
2022-09-22 12:08:21 -04:00
$maybeRequest = $this->anilistModel->deleteItem($data, strtoupper($this->type));
if ($maybeRequest !== NULL)
{
$requester->addRequest($maybeRequest, 'anilist');
}
}
$results = $requester->makeRequests();
return $results !== [];
}
}