HummingBirdAnimeClient/src/AnimeClient/Model/Manga.php

129 lines
2.6 KiB
PHP

<?php declare(strict_types=1);
/**
* Hummingbird Anime List Client
*
* An API client for Kitsu to manage anime and manga watch lists
*
* PHP version 7.4+
*
* @package HummingbirdAnimeClient
* @author Timothy J. Warren <tim@timshomepage.net>
* @copyright 2015 - 2021 Timothy J. Warren
* @license http://www.opensource.org/licenses/mit-license.html MIT License
* @version 5.2
* @link https://git.timshomepage.net/timw4mail/HummingBirdAnimeClient
*/
namespace Aviat\AnimeClient\Model;
use Aviat\AnimeClient\API\{
Enum\MangaReadingStatus\Title,
Mapping\MangaReadingStatus,
};
use Aviat\AnimeClient\Types\{
MangaPage
};
/**
* Model for handling requests dealing with the manga list
*/
class Manga extends API {
use MediaTrait;
protected string $type = 'manga';
/**
* Get a category out of the full list
*
* @param string $status
* @return array
*/
public function getList(string $status): array
{
if ($status === 'All')
{
$data = $this->kitsuModel->getFullOrganizedMangaList();
foreach($data as &$section)
{
$this->sortByName($section, 'manga');
}
return $data;
}
$APIstatus = MangaReadingStatus::TITLE_TO_KITSU[$status];
$data = $this->mapByStatus($this->kitsuModel->getMangaList($APIstatus));
$this->sortByName($data[$status], 'manga');
return $data[$status];
}
/**
* Get the details of a manga
*
* @param string $manga_id
* @return MangaPage
*/
public function getManga(string $manga_id): MangaPage
{
return $this->kitsuModel->getManga($manga_id);
}
/**
* Get the details of a random manga
*
* @return MangaPage
*/
public function getRandomManga(): MangaPage
{
return $this->kitsuModel->getRandomManga();
}
/**
* Get anime by its kitsu id
*
* @param string $animeId
* @return MangaPage
*/
public function getMangaById(string $animeId): MangaPage
{
return $this->kitsuModel->getMangaById($animeId);
}
/**
* Get recent reading history
*
* @return array
*/
public function getHistory(): array
{
return $this->kitsuModel->getMangaHistory();
}
/**
* Map transformed anime data to be organized by reading status
*
* @param array $data
* @return array
*/
private function mapByStatus(array $data): array
{
$output = [
Title::READING => [],
Title::PLAN_TO_READ => [],
Title::ON_HOLD => [],
Title::DROPPED => [],
Title::COMPLETED => [],
];
foreach ($data as $entry) {
$statusMap = MangaReadingStatus::KITSU_TO_TITLE;
$key = $statusMap[$entry['reading_status']];
$output[$key][] = $entry;
}
unset($entry);
return $output;
}
}
// End of MangaModel.php