101 lines
2.5 KiB
PHP
101 lines
2.5 KiB
PHP
<?php
|
|
/**
|
|
* @package GetBible
|
|
*
|
|
* @created 30th May, 2023
|
|
* @author Llewellyn van der Merwe <https://dev.vdm.io>
|
|
* @git GetBible <https://git.vdm.dev/getBible>
|
|
* @copyright Copyright (C) 2015 Vast Development Method. All rights reserved.
|
|
* @license GNU General Public License version 2 or later; see LICENSE.txt
|
|
*/
|
|
|
|
namespace TrueChristianChurch\Joomla\GetBible\Api;
|
|
|
|
|
|
use TrueChristianChurch\Joomla\GetBible\Abstraction\Api;
|
|
|
|
|
|
/**
|
|
* The GetBible Book Chapters
|
|
*
|
|
* @since 2.0.1
|
|
*/
|
|
final class Chapters extends Api
|
|
{
|
|
/**
|
|
* Get the chapters in a book in a translation
|
|
*
|
|
* @param string $translation The translation.
|
|
* @param int $book The book number.
|
|
*
|
|
* @return object|null The response object or null if an error occurs.
|
|
* @since 2.0.1
|
|
*/
|
|
public function get(string $translation, int $book): ?object
|
|
{
|
|
return $this->response->get(
|
|
$this->http->get(
|
|
$this->uri->get($translation . '/' . $book . '.json')
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* List the chapters of a book in a translation
|
|
*
|
|
* @param string $translation The translation.
|
|
* @param int $book The book number.
|
|
*
|
|
* @return object|null The response object or null if an error occurs.
|
|
* @since 2.0.1
|
|
*/
|
|
public function list( string $translation, int $book): ?object
|
|
{
|
|
return $this->response->get(
|
|
$this->http->get(
|
|
$this->uri->get($translation . '/' . $book . '/chapters.json')
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* List the chapters checksums of a book in a translation
|
|
*
|
|
* @param string $translation The translation.
|
|
* @param int $book The book number.
|
|
*
|
|
* @return object|null The response object or null if an error occurs.
|
|
* @since 2.0.1
|
|
*/
|
|
public function checksum(string $translation, int $book): ?object
|
|
{
|
|
return $this->response->get(
|
|
$this->http->get(
|
|
$this->uri->get($translation . '/' . $book . '/checksum.json')
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get the chapter's checksums of a book in a translation
|
|
*
|
|
* @param string $translation The translation.
|
|
* @param int $book The book number.
|
|
* @param int $chapter The chapter number.
|
|
*
|
|
* @return string|null The response checksum or null if an error occurs.
|
|
* @since 2.0.1
|
|
*/
|
|
public function sha(string $translation, int $book, int $chapter): ?string
|
|
{
|
|
return trim(
|
|
$this->response->get(
|
|
$this->http->get(
|
|
$this->uri->get($translation . '/' . $book . '/' . $chapter . '.sha')
|
|
)
|
|
)
|
|
);
|
|
}
|
|
}
|
|
|