Skip to content

feat: Add Gitea repository content endpoints (tree, content, languages) #63

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jaysomani wants to merge 6 commits into
base: main
Choose a base branch
from
Open

feat: Add Gitea repository content endpoints (tree, content, languages) #63

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
9448c32
4 endpoints inital implementation
jaysomani Feb 19, 2026
a1de80e
updated with some fixes
jaysomani Feb 19, 2026
d19d4b5
updated with small fix
jaysomani Feb 20, 2026
9219a0c
fixed including response for better debugging
jaysomani Feb 20, 2026
a7ba6f3
Merge branch 'main' of https://github.com/jaysomani/vcs into feat/git…
jaysomani Feb 26, 2026
2f5fa1c
updated with new methods
jaysomani Feb 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions src/VCS/Adapter/Git.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@

use Utopia\VCS\Adapter;
use Utopia\Cache\Cache;
use Exception;

abstract class Git extends Adapter
{
Expand Down Expand Up @@ -34,4 +35,32 @@ public function getType(): string
{
return self::TYPE_GIT;
}
/**
* Create a file in a repository
*
* @param string $owner Owner of the repository
* @param string $repositoryName Name of the repository
* @param string $filepath Path where file should be created
* @param string $content Content of the file
* @param string $message Commit message
* @return array<mixed> Response from API
*/
public function createFile(string $owner, string $repositoryName, string $filepath, string $content, string $message = 'Add file'): array
{
throw new Exception("Not implemented");
}

/**
* Create a branch in a repository
*
* @param string $owner Owner of the repository
* @param string $repositoryName Name of the repository
* @param string $newBranchName Name of the new branch
* @param string $oldBranchName Name of the branch to branch from
* @return array<mixed> Response from API
*/
public function createBranch(string $owner, string $repositoryName, string $newBranchName, string $oldBranchName): array
{
throw new Exception("Not implemented");
}
}
147 changes: 143 additions & 4 deletions src/VCS/Adapter/Git/Gitea.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,14 @@
use Utopia\Cache\Cache;
use Utopia\VCS\Adapter\Git;
use Utopia\VCS\Exception\RepositoryNotFound;
use Utopia\VCS\Exception\FileNotFound;

class Gitea extends Git
{
public const CONTENTS_FILE = 'file';

public const CONTENTS_DIRECTORY = 'dir';

protected string $endpoint = 'http://gitea:3000/api/v1';

protected string $accessToken;
Expand Down Expand Up @@ -147,22 +152,156 @@ public function getRepositoryName(string $repositoryId): string

public function getRepositoryTree(string $owner, string $repositoryName, string $branch, bool $recursive = false): array
{
throw new Exception("Not implemented yet");
$url = "/repos/{$owner}/{$repositoryName}/git/trees/" . urlencode($branch) . ($recursive ? '?recursive=1' : '');

$response = $this->call(self::METHOD_GET, $url, ['Authorization' => "token $this->accessToken"]);

if (($response['headers']['status-code'] ?? 0) === 404) {
return [];
}

return array_column($response['body']['tree'] ?? [], 'path');
}

/**
* Create a file in a repository
*
* @param string $owner Owner of the repository
* @param string $repositoryName Name of the repository
* @param string $filepath Path where file should be created
* @param string $content Content of the file
* @param string $message Commit message
* @return array<mixed> Response from API
*/
public function createFile(string $owner, string $repositoryName, string $filepath, string $content, string $message = 'Add file'): array
{
$url = "/repos/{$owner}/{$repositoryName}/contents/{$filepath}";

$response = $this->call(
self::METHOD_POST,
$url,
['Authorization' => "token $this->accessToken"],
[
'content' => base64_encode($content),
'message' => $message
]
);

$statusCode = $response['headers']['status-code'] ?? 0;
if ($statusCode >= 400) {
throw new Exception("Failed to create file {$filepath}: HTTP {$statusCode}");
}

return $response['body'] ?? [];
}

/**
* Create a branch in a repository
*
* @param string $owner Owner of the repository
* @param string $repositoryName Name of the repository
* @param string $newBranchName Name of the new branch
* @param string $oldBranchName Name of the branch to branch from
* @return array<mixed> Response from API
*/
public function createBranch(string $owner, string $repositoryName, string $newBranchName, string $oldBranchName): array
{
$url = "/repos/{$owner}/{$repositoryName}/branches";

$response = $this->call(
self::METHOD_POST,
$url,
['Authorization' => "token $this->accessToken"],
[
'new_branch_name' => $newBranchName,
'old_branch_name' => $oldBranchName
]
);

$statusCode = $response['headers']['status-code'] ?? 0;
if ($statusCode >= 400) {
throw new Exception("Failed to create branch {$newBranchName}: HTTP {$statusCode}");
}

return $response['body'] ?? [];
}

public function listRepositoryLanguages(string $owner, string $repositoryName): array
{
throw new Exception("Not implemented yet");
$url = "/repos/{$owner}/{$repositoryName}/languages";

$response = $this->call(self::METHOD_GET, $url, ['Authorization' => "token $this->accessToken"]);

if (isset($response['body'])) {
return array_keys($response['body']);
}

return [];
}

public function getRepositoryContent(string $owner, string $repositoryName, string $path, string $ref = ''): array
{
throw new Exception("Not implemented yet");
$url = "/repos/{$owner}/{$repositoryName}/contents/{$path}";
if (!empty($ref)) {
$url .= "?ref=" . urlencode($ref);
}

$response = $this->call(self::METHOD_GET, $url, ['Authorization' => "token $this->accessToken"]);

if (($response['headers']['status-code'] ?? 0) !== 200) {
throw new FileNotFound();
}

$encoding = $response['body']['encoding'] ?? '';
$content = '';

if ($encoding === 'base64') {
$content = base64_decode($response['body']['content'] ?? '');
} else {
throw new FileNotFound();
}

return [
'sha' => $response['body']['sha'] ?? '',
'size' => $response['body']['size'] ?? 0,
'content' => $content
];
}

public function listRepositoryContents(string $owner, string $repositoryName, string $path = '', string $ref = ''): array
{
throw new Exception("Not implemented yet");
$url = "/repos/{$owner}/{$repositoryName}/contents";
if (!empty($path)) {
$url .= "/{$path}";
}
if (!empty($ref)) {
$url .= "?ref=" . urlencode($ref);
}

$response = $this->call(self::METHOD_GET, $url, ['Authorization' => "token $this->accessToken"]);

if (($response['headers']['status-code'] ?? 0) === 404) {
return [];
}

$items = [];
if (!empty($response['body'][0])) {
$items = $response['body'];
} elseif (!empty($response['body'])) {
$items = [$response['body']];
}

$contents = [];
foreach ($items as $item) {
$type = $item['type'] ?? 'file';
$contents[] = [
'name' => $item['name'] ?? '',
'size' => $item['size'] ?? 0,
'type' => $type === 'file' ? self::CONTENTS_FILE : self::CONTENTS_DIRECTORY
];
}

return $contents;
}

public function deleteRepository(string $owner, string $repositoryName): bool
Expand Down
Loading