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
|
|
|
*
|
2018-08-22 13:48:27 -04:00
|
|
|
* An API client for Kitsu to manage anime and manga watch lists
|
2015-11-16 11:40:01 -05:00
|
|
|
*
|
2021-02-04 11:57:01 -05:00
|
|
|
* PHP version 8
|
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>
|
2021-01-13 01:52:03 -05:00
|
|
|
* @copyright 2015 - 2021 Timothy J. Warren
|
2017-01-06 23:34:56 -05:00
|
|
|
* @license http://www.opensource.org/licenses/mit-license.html MIT License
|
2020-12-10 17:06:50 -05:00
|
|
|
* @version 5.2
|
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-03-01 22:07:51 -05:00
|
|
|
use Aviat\AnimeClient\API\Mapping\AnimeWatchingStatus;
|
2022-01-07 12:33:01 -05:00
|
|
|
use Aviat\AnimeClient\Types\Anime as AnimeType;
|
2019-12-09 14:34:23 -05: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 {
|
2020-08-26 15:24:49 -04:00
|
|
|
use MediaTrait;
|
2018-09-20 10:41:28 -04:00
|
|
|
|
2020-08-26 15:24:49 -04:00
|
|
|
protected string $type = 'anime';
|
2016-12-21 12:46:20 -05:00
|
|
|
|
2015-05-22 12:36:26 -04:00
|
|
|
/**
|
|
|
|
* Get a category out of the full list
|
|
|
|
*
|
2022-03-03 13:25:10 -05:00
|
|
|
* @return array<string, mixed>
|
2015-05-22 12:36:26 -04:00
|
|
|
*/
|
2020-10-21 18:52:12 -04:00
|
|
|
public function getList(string $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
|
|
|
|
*
|
2022-03-03 13:25:10 -05:00
|
|
|
* @return mixed[]
|
2017-03-29 12:32:36 -04:00
|
|
|
*/
|
|
|
|
public function getAllLists(): array
|
2017-03-07 17:51:08 -05:00
|
|
|
{
|
|
|
|
$data = $this->kitsuModel->getFullOrganizedAnimeList();
|
|
|
|
|
2022-01-07 12:33:01 -05:00
|
|
|
foreach($data as &$list)
|
2017-03-07 17:51:08 -05:00
|
|
|
{
|
|
|
|
$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
|
|
|
*/
|
2018-11-09 10:38:35 -05: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
|
|
|
|
2020-12-02 12:42:47 -05:00
|
|
|
/**
|
|
|
|
* Get information about a random anime
|
|
|
|
*/
|
|
|
|
public function getRandomAnime(): AnimeType
|
|
|
|
{
|
|
|
|
return $this->kitsuModel->getRandomAnime();
|
|
|
|
}
|
|
|
|
|
2017-02-08 15:48:20 -05:00
|
|
|
/**
|
|
|
|
* Get anime by its kitsu id
|
|
|
|
*/
|
2018-08-20 13:01:16 -04:00
|
|
|
public function getAnimeById(string $animeId): AnimeType
|
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
|
|
|
}
|
|
|
|
|
2020-04-21 19:22:56 -04:00
|
|
|
/**
|
|
|
|
* Get recent watch history
|
|
|
|
*
|
2022-03-03 13:25:10 -05:00
|
|
|
* @return mixed[]
|
2020-04-21 19:22:56 -04:00
|
|
|
*/
|
|
|
|
public function getHistory(): array
|
|
|
|
{
|
|
|
|
return $this->kitsuModel->getAnimeHistory();
|
|
|
|
}
|
|
|
|
|
2017-02-08 15:48:20 -05:00
|
|
|
|
2017-03-07 17:51:08 -05:00
|
|
|
}
|