From 128b8f4d4ac78079d033793d6db8e517b48ac020 Mon Sep 17 00:00:00 2001
From: Benjamin Blake <ben@sitelease.ca>
Date: Tue, 25 Feb 2020 12:31:30 -0700
Subject: [PATCH] Updated the Repositories API requester

+ Updated use statements and class names
+ Added a `getByName()` method for getting a repository using its owner and name
+ Added a `getRawFile()` method for getting the contents of a file from a repository
+ Added a `downloadArchive()` method for downloading an archive for a repository
---
 src/Api/Repositories.php | 106 +++++++++++++++++++++++++++++++++++++--
 1 file changed, 103 insertions(+), 3 deletions(-)

diff --git a/src/Api/Repositories.php b/src/Api/Repositories.php
index 4274b4d..ed351f7 100644
--- a/src/Api/Repositories.php
+++ b/src/Api/Repositories.php
@@ -8,9 +8,9 @@ use Gitea\Client;
 use Gitea\Collections\ApiItemCollection;
 use Gitea\Model\Repository;
 
-use Gitea\Api\Abstracts\AbstractAllApi;
+use Gitea\Api\Abstracts\AbstractAllApiRequester;
 
-class Repositories extends AbstractAllApi
+class Repositories extends AbstractAllApiRequester
 {
     /**
      * Get a page of items from the API route
@@ -62,7 +62,11 @@ class Repositories extends AbstractAllApi
                 if ($jsonOk && count($jsonItemList) > 0) {
                     foreach ($jsonItemList as $jsonItem) {
                         $encodedItem = json_encode($jsonItem);
-                        $itemObject = Repository::fromJson(json_decode($encodedItem));
+                        $itemObject = Repository::fromJson(
+                            $this->getClient(),
+                            $this,
+                            json_decode($encodedItem)
+                        );
                         $repositoryCollection->addItem($itemObject, $itemObject->getId());
                     }
                 }
@@ -74,4 +78,100 @@ class Repositories extends AbstractAllApi
         }
     }
 
+    /**
+     * Get a repository using its name and owner
+     *
+     * Example:
+     * ```
+     * $giteaClient->repositories()->getByName($owner, $repoName);
+     * ```
+     *
+     * @param string $owner The owner of the repository
+     * @param string $repoName The name of the repository
+     * @return Repository
+     */
+    public function getByName(string $owner, string $repoName)
+    {
+        $client = $this->getClient();
+        try {
+            $response = $this->get("repos/$owner/$repoName");
+            $statusCode = $response->getStatusCode();
+            $body = (string) $response->getBody();
+            if ($statusCode == 200) {
+                return Repository::fromJson(
+                    $this->getClient(),
+                    $this,
+                    json_decode($body)
+                );
+            }
+            return false;
+
+        } catch (ServerException $serverError) {
+            return false;
+        }
+    }
+
+    /**
+     * Get the raw contents of a file stored inside a repository
+     * using the repository's name and owner
+     *
+     * Example:
+     * ```
+     * $giteaClient->repositories()->getRawFile($owner, $repoName, "README.md");
+     * ```
+     *
+     * @param string $owner The owner of the repository
+     * @param string $repoName The name of the repository
+     * @param string $filepath The path to the raw file (relative to the repository root)
+     * @return string
+     */
+    public function getRawFile(string $owner, string $repoName, string $filepath)
+    {
+        $client = $this->getClient();
+        try {
+            $response = $this->get("repos/$owner/$repoName/raw/$filepath");
+            $statusCode = $response->getStatusCode();
+            $body = (string) $response->getBody();
+            if ($statusCode == 200) {
+                return $body;
+            }
+            return false;
+
+        } catch (ServerException $serverError) {
+            return false;
+        }
+    }
+
+    /**
+     * Download an archive for a branch, tag, or commit SHA
+     *
+     * Example:
+     * ```
+     * $giteaClient->repositories()->downloadArchive($owner, $repoName, "master", ".zip");
+     * ```
+     *
+     * @param string $owner The owner of the repository
+     * @param string $repoName The name of the repository
+     * @param string $gitRef The branch, tag, or commit SHA for the archive
+     * @param string $format The format of the downloaded archive (".zip", or ".tar.gz")
+     * @return string A string that can be written to a file
+     */
+    public function downloadArchive(string $owner, string $repoName, string $gitRef, string $format = ".tar.gz")
+    {
+        $client = $this->getClient();
+        $filepath = $gitRef.$format;
+        try {
+            $response = $this->get("repos/$owner/$repoName/archive/$filepath");
+            $statusCode = $response->getStatusCode();
+            $body = (string) $response->getBody();
+            if ($statusCode == 200) {
+                return $body;
+            }
+            return false;
+
+        } catch (ServerException $serverError) {
+            return false;
+        }
+    }
+
 }