2016-10-20 22:09:36 -04:00
|
|
|
<?php declare(strict_types=1);
|
2015-06-16 11:11:35 -04:00
|
|
|
/**
|
2017-02-15 16:13:32 -05:00
|
|
|
* Hummingbird Anime List Client
|
2015-11-16 11:40:01 -05:00
|
|
|
*
|
2016-12-20 12:58:37 -05:00
|
|
|
* An API client for Kitsu and MyAnimeList to manage anime and manga watch lists
|
2015-11-16 11:40:01 -05:00
|
|
|
*
|
2016-10-20 22:09:36 -04:00
|
|
|
* PHP version 7
|
2016-08-30 10:01:18 -04:00
|
|
|
*
|
2017-02-15 16:13:32 -05:00
|
|
|
* @package HummingbirdAnimeClient
|
2017-01-06 23:34:56 -05:00
|
|
|
* @author Timothy J. Warren <tim@timshomepage.net>
|
2018-01-15 14:43:15 -05:00
|
|
|
* @copyright 2015 - 2018 Timothy J. Warren
|
2017-01-06 23:34:56 -05:00
|
|
|
* @license http://www.opensource.org/licenses/mit-license.html MIT License
|
|
|
|
* @version 4.0
|
2017-03-07 20:53:58 -05:00
|
|
|
* @link https://git.timshomepage.net/timw4mail/HummingBirdAnimeClient
|
2017-01-11 10:34:24 -05:00
|
|
|
*/
|
|
|
|
|
|
|
|
namespace Aviat\AnimeClient\Model;
|
2017-02-08 15:48:20 -05:00
|
|
|
|
2017-02-20 13:37:08 -05:00
|
|
|
use Aviat\AnimeClient\API\ParallelAPIRequest;
|
2017-03-01 22:07:51 -05:00
|
|
|
use Aviat\AnimeClient\API\Mapping\AnimeWatchingStatus;
|
2018-08-08 10:12:45 -04:00
|
|
|
use Aviat\AnimeClient\Types\{
|
|
|
|
Anime as AnimeType,
|
|
|
|
AnimeFormItem,
|
2018-08-08 11:18:57 -04:00
|
|
|
AnimeListItem
|
2018-08-08 10:12:45 -04:00
|
|
|
};
|
2016-12-21 12:46:20 -05:00
|
|
|
use Aviat\Ion\Di\ContainerInterface;
|
2016-10-20 22:32:17 -04:00
|
|
|
use Aviat\Ion\Json;
|
2015-06-26 16:39:10 -04:00
|
|
|
|
2015-05-22 12:36:26 -04:00
|
|
|
/**
|
|
|
|
* Model for handling requests dealing with the anime list
|
|
|
|
*/
|
2018-08-08 13:05:38 -04:00
|
|
|
class Anime extends API {
|
2017-02-17 10:55:17 -05:00
|
|
|
/**
|
|
|
|
* Model for making requests to Kitsu API
|
|
|
|
*
|
2017-02-22 14:46:35 -05:00
|
|
|
* @var \Aviat\AnimeClient\API\Kitsu\Model
|
2017-02-17 10:55:17 -05:00
|
|
|
*/
|
2017-02-04 15:18:34 -05:00
|
|
|
protected $kitsuModel;
|
|
|
|
|
2017-02-17 10:55:17 -05:00
|
|
|
/**
|
|
|
|
* Model for making requests to MAL API
|
|
|
|
*
|
2017-02-22 14:46:35 -05:00
|
|
|
* @var \Aviat\AnimeClient\API\MAL\Model
|
2017-02-17 10:55:17 -05:00
|
|
|
*/
|
2017-02-04 15:18:34 -05:00
|
|
|
protected $malModel;
|
|
|
|
|
2016-12-22 21:36:23 -05:00
|
|
|
/**
|
|
|
|
* Anime constructor.
|
2017-02-17 10:55:17 -05:00
|
|
|
*
|
2016-12-22 21:36:23 -05:00
|
|
|
* @param ContainerInterface $container
|
|
|
|
*/
|
2017-03-01 22:07:51 -05:00
|
|
|
public function __construct(ContainerInterface $container)
|
2017-02-17 10:55:17 -05:00
|
|
|
{
|
2016-12-22 21:36:23 -05:00
|
|
|
$this->kitsuModel = $container->get('kitsu-model');
|
2017-02-04 15:18:34 -05:00
|
|
|
$this->malModel = $container->get('mal-model');
|
|
|
|
|
2017-03-28 14:36:23 -04:00
|
|
|
$config = $container->get('config');
|
2017-02-04 15:18:34 -05:00
|
|
|
$this->useMALAPI = $config->get(['use_mal_api']) === TRUE;
|
2016-12-21 12:46:20 -05:00
|
|
|
}
|
|
|
|
|
2015-05-22 12:36:26 -04:00
|
|
|
/**
|
|
|
|
* Get a category out of the full list
|
|
|
|
*
|
2015-06-09 18:18:53 -04:00
|
|
|
* @param string $status
|
2015-05-22 12:36:26 -04:00
|
|
|
* @return array
|
|
|
|
*/
|
2017-03-29 12:32:36 -04:00
|
|
|
public function getList($status): array
|
2015-05-22 12:36:26 -04:00
|
|
|
{
|
2016-12-22 21:36:23 -05:00
|
|
|
$data = $this->kitsuModel->getAnimeList($status);
|
2017-01-05 13:41:32 -05:00
|
|
|
$this->sortByName($data, 'anime');
|
2015-05-22 12:36:26 -04:00
|
|
|
|
2017-03-01 22:07:51 -05:00
|
|
|
$key = AnimeWatchingStatus::KITSU_TO_TITLE[$status];
|
|
|
|
|
2015-05-22 12:36:26 -04:00
|
|
|
$output = [];
|
2017-03-01 22:07:51 -05:00
|
|
|
$output[$key] = $data;
|
2015-05-22 12:36:26 -04:00
|
|
|
|
|
|
|
return $output;
|
|
|
|
}
|
|
|
|
|
2017-03-29 12:32:36 -04:00
|
|
|
/**
|
|
|
|
* Get data for the 'all' anime page
|
|
|
|
*
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
public function getAllLists(): array
|
2017-03-07 17:51:08 -05:00
|
|
|
{
|
|
|
|
$data = $this->kitsuModel->getFullOrganizedAnimeList();
|
|
|
|
|
|
|
|
foreach($data as $section => &$list)
|
|
|
|
{
|
|
|
|
$this->sortByName($list, 'anime');
|
|
|
|
}
|
|
|
|
|
|
|
|
return $data;
|
|
|
|
}
|
|
|
|
|
2015-06-24 16:01:35 -04:00
|
|
|
/**
|
2017-01-16 13:49:51 -05:00
|
|
|
* Get information about an anime from its slug
|
2015-06-24 16:01:35 -04:00
|
|
|
*
|
2017-01-16 13:49:51 -05:00
|
|
|
* @param string $slug
|
2018-08-08 10:12:45 -04:00
|
|
|
* @return AnimeType
|
2015-06-24 16:01:35 -04:00
|
|
|
*/
|
2018-08-08 10:12:45 -04:00
|
|
|
public function getAnime(string $slug): AnimeType
|
2017-01-05 13:41:32 -05:00
|
|
|
{
|
2017-01-16 13:49:51 -05:00
|
|
|
return $this->kitsuModel->getAnime($slug);
|
|
|
|
}
|
2017-02-04 15:18:34 -05:00
|
|
|
|
2017-02-08 15:48:20 -05:00
|
|
|
/**
|
|
|
|
* Get anime by its kitsu id
|
|
|
|
*
|
|
|
|
* @param string $animeId
|
|
|
|
* @return array
|
|
|
|
*/
|
2017-03-29 12:32:36 -04:00
|
|
|
public function getAnimeById(string $animeId): array
|
2017-01-16 13:49:51 -05:00
|
|
|
{
|
2017-02-08 15:48:20 -05:00
|
|
|
return $this->kitsuModel->getAnimeById($animeId);
|
2017-01-05 13:41:32 -05:00
|
|
|
}
|
|
|
|
|
2017-01-06 21:39:01 -05:00
|
|
|
/**
|
|
|
|
* Search for anime by name
|
|
|
|
*
|
|
|
|
* @param string $name
|
|
|
|
* @return array
|
|
|
|
*/
|
2017-03-29 12:32:36 -04:00
|
|
|
public function search(string $name): array
|
2017-01-06 21:39:01 -05:00
|
|
|
{
|
|
|
|
return $this->kitsuModel->search('anime', $name);
|
|
|
|
}
|
|
|
|
|
2017-01-05 13:41:32 -05:00
|
|
|
/**
|
|
|
|
* Get information about a specific list item
|
|
|
|
* for editing/updating that item
|
|
|
|
*
|
|
|
|
* @param string $itemId
|
2018-08-08 10:12:45 -04:00
|
|
|
* @return AnimeListItem
|
2017-01-05 13:41:32 -05:00
|
|
|
*/
|
2018-08-08 10:12:45 -04:00
|
|
|
public function getLibraryItem(string $itemId): AnimeListItem
|
2017-01-05 13:41:32 -05:00
|
|
|
{
|
|
|
|
return $this->kitsuModel->getListItem($itemId);
|
|
|
|
}
|
|
|
|
|
2017-02-04 15:18:34 -05:00
|
|
|
/**
|
|
|
|
* Add an anime to your list
|
|
|
|
*
|
|
|
|
* @param array $data
|
|
|
|
* @return bool
|
|
|
|
*/
|
2017-01-10 12:35:46 -05:00
|
|
|
public function createLibraryItem(array $data): bool
|
|
|
|
{
|
2017-02-20 13:37:08 -05:00
|
|
|
$requester = new ParallelAPIRequest();
|
2017-02-08 15:48:20 -05:00
|
|
|
|
2017-02-04 15:18:34 -05:00
|
|
|
if ($this->useMALAPI)
|
|
|
|
{
|
|
|
|
$malData = $data;
|
|
|
|
$malId = $this->kitsuModel->getMalIdForAnime($malData['id']);
|
|
|
|
|
2018-01-30 16:57:13 -05:00
|
|
|
if ($malId !== NULL)
|
2017-02-04 15:18:34 -05:00
|
|
|
{
|
|
|
|
$malData['id'] = $malId;
|
2017-02-20 13:37:08 -05:00
|
|
|
$requester->addRequest($this->malModel->createListItem($malData), 'mal');
|
2017-02-04 15:18:34 -05:00
|
|
|
}
|
|
|
|
}
|
2017-03-01 22:07:51 -05:00
|
|
|
|
2017-02-20 13:37:08 -05:00
|
|
|
$requester->addRequest($this->kitsuModel->createListItem($data), 'kitsu');
|
2017-02-04 15:18:34 -05:00
|
|
|
|
2017-12-08 22:32:00 -05:00
|
|
|
$results = $requester->makeRequests();
|
2017-02-08 15:48:20 -05:00
|
|
|
|
2017-12-08 22:32:00 -05:00
|
|
|
return count($results) > 0;
|
2017-01-10 12:35:46 -05:00
|
|
|
}
|
|
|
|
|
2017-01-05 13:41:32 -05:00
|
|
|
/**
|
2017-01-06 21:39:01 -05:00
|
|
|
* Update a list entry
|
2017-01-05 13:41:32 -05:00
|
|
|
*
|
2018-08-08 10:12:45 -04:00
|
|
|
* @param AnimeFormItem $data
|
2017-01-05 13:41:32 -05:00
|
|
|
* @return array
|
|
|
|
*/
|
2018-08-08 10:12:45 -04:00
|
|
|
public function updateLibraryItem(AnimeFormItem $data): array
|
2015-06-24 16:01:35 -04:00
|
|
|
{
|
2017-03-01 22:07:51 -05:00
|
|
|
$requester = new ParallelAPIRequest();
|
|
|
|
|
2017-02-04 15:18:34 -05:00
|
|
|
if ($this->useMALAPI)
|
|
|
|
{
|
2017-02-20 13:37:08 -05:00
|
|
|
$requester->addRequest($this->malModel->updateListItem($data), 'mal');
|
2017-02-04 15:18:34 -05:00
|
|
|
}
|
|
|
|
|
2017-02-20 13:37:08 -05:00
|
|
|
$requester->addRequest($this->kitsuModel->updateListItem($data), 'kitsu');
|
2017-02-09 20:10:13 -05:00
|
|
|
|
2017-12-08 22:32:00 -05:00
|
|
|
$results = $requester->makeRequests();
|
|
|
|
$body = Json::decode($results['kitsu']);
|
2018-01-30 16:57:13 -05:00
|
|
|
$statusCode = array_key_exists('error', $body) ? 400: 200;
|
2017-03-01 22:07:51 -05:00
|
|
|
|
2017-02-09 20:10:13 -05:00
|
|
|
return [
|
2017-12-08 22:32:00 -05:00
|
|
|
'body' => Json::decode($results['kitsu']),
|
|
|
|
'statusCode' => $statusCode
|
2017-02-09 20:10:13 -05:00
|
|
|
];
|
2015-06-24 16:01:35 -04:00
|
|
|
}
|
2017-01-09 20:36:48 -05:00
|
|
|
|
2017-02-04 15:18:34 -05:00
|
|
|
/**
|
|
|
|
* Delete a list entry
|
|
|
|
*
|
|
|
|
* @param string $id
|
|
|
|
* @param string|null $malId
|
|
|
|
* @return bool
|
|
|
|
*/
|
2017-02-17 10:55:17 -05:00
|
|
|
public function deleteLibraryItem(string $id, string $malId = NULL): bool
|
2017-01-09 20:36:48 -05:00
|
|
|
{
|
2017-02-20 13:37:08 -05:00
|
|
|
$requester = new ParallelAPIRequest();
|
2017-02-08 15:48:20 -05:00
|
|
|
|
2018-01-30 16:57:13 -05:00
|
|
|
if ($this->useMALAPI && $malId !== NULL)
|
2017-02-04 15:18:34 -05:00
|
|
|
{
|
2017-02-20 13:37:08 -05:00
|
|
|
$requester->addRequest($this->malModel->deleteListItem($malId), 'MAL');
|
2017-02-04 15:18:34 -05:00
|
|
|
}
|
|
|
|
|
2017-02-20 13:37:08 -05:00
|
|
|
$requester->addRequest($this->kitsuModel->deleteListItem($id), 'kitsu');
|
2017-02-08 15:48:20 -05:00
|
|
|
|
2017-12-08 22:32:00 -05:00
|
|
|
$results = $requester->makeRequests();
|
2017-02-08 15:48:20 -05:00
|
|
|
|
2017-12-08 22:32:00 -05:00
|
|
|
return count($results) > 0;
|
2017-01-09 20:36:48 -05:00
|
|
|
}
|
2017-03-07 17:51:08 -05:00
|
|
|
}
|