<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
 * Unit tests for repository_wikimedia class.
 *
 * @package    repository_wikimedia
 * @copyright  2026 Andi Permana
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace repository_wikimedia;

use GuzzleHttp\Exception\RequestException;
use GuzzleHttp\Psr7\Request;
use GuzzleHttp\Psr7\Response;

defined('MOODLE_INTERNAL') || die();

global $CFG;
require_once($CFG->dirroot . '/repository/lib.php');
require_once($CFG->dirroot . '/repository/wikimedia/lib.php');

/**
 * Unit tests for Wikimedia repository
 *
 * @package    repository_wikimedia
 * @copyright  2026 Andi Permana
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 * @covers     \repository_wikimedia
 */
final class repository_test extends \advanced_testcase {
    /** @var \repository_wikimedia|null Repository instance */
    private $repo = null;

    /**
     * Setup test environment.
     */
    protected function setUp(): void {
        parent::setUp();
        $this->resetAfterTest(true);

        $user = get_admin();
        $this->setUser($user);

        // Create repository instance.
        $record = $this->getDataGenerator()->create_repository('wikimedia');

        $this->repo = \repository::get_repository_by_id($record->id, \context_system::instance());
    }

    /**
     * Test that a HTTP 429 response from Wikimedia throws a rate limit exception.
     */
    public function test_get_file_rate_limited(): void {
        ['mock' => $mock] = $this->get_mocked_http_client();
        $mock->append(new Response(429));

        $this->expectException(\repository_exception::class);
        $this->expectExceptionMessage(get_string('ratelimited', 'repository_wikimedia'));

        $this->repo->get_file('https://upload.wikimedia.org/wikipedia/commons/test.jpg');
    }

    /**
     * Test that a successful HTTP 200 response returns the downloaded file path and URL.
     */
    public function test_get_file_success(): void {
        ['mock' => $mock] = $this->get_mocked_http_client();
        $mock->append(new Response(200, [], 'fake image content'));

        $result = $this->repo->get_file('https://upload.wikimedia.org/wikipedia/commons/test.jpg');

        $this->assertArrayHasKey('path', $result);
        $this->assertArrayHasKey('url', $result);
        $this->assertEquals('https://upload.wikimedia.org/wikipedia/commons/test.jpg', $result['url']);
        $this->assertFileExists($result['path']);
    }

    /**
     * Test that a non-200/non-429 HTTP error response throws a moodle_exception.
     */
    public function test_get_file_http_error(): void {
        ['mock' => $mock] = $this->get_mocked_http_client();
        $mock->append(new Response(503, [], 'Service Unavailable'));

        $this->expectException(\moodle_exception::class);
        $this->expectExceptionMessage(get_string('errorwhiledownload', 'repository', 'Service Unavailable'));

        $this->repo->get_file('https://upload.wikimedia.org/wikipedia/commons/test.jpg');
    }

    /**
     * Test that a network-level failure (e.g. connection refused) throws a moodle_exception.
     */
    public function test_get_file_network_error(): void {
        ['mock' => $mock] = $this->get_mocked_http_client();
        $mock->append(new RequestException('Connection refused', new Request('GET', 'https://upload.wikimedia.org/')));

        $this->expectException(\moodle_exception::class);
        $this->expectExceptionMessage(get_string('errorwhiledownload', 'repository', 'Connection refused'));

        $this->repo->get_file('https://upload.wikimedia.org/wikipedia/commons/test.jpg');
    }
}