RSS-Bridge_rss-bridge/bridges/GogsBridge.php

217 lines
6.9 KiB
PHP

<?php
class GogsBridge extends BridgeAbstract
{
const NAME = 'Gogs';
const URI = 'https://gogs.io';
const DESCRIPTION = 'Returns the latest issues, commits or releases';
const MAINTAINER = 'logmanoriginal';
const CACHE_TIMEOUT = 300; // 5 minutes
const PARAMETERS = [
'global' => [
'host' => [
'name' => 'Host',
'exampleValue' => 'https://notabug.org',
'required' => true,
'title' => 'Host name with its protocol, without trailing slash',
],
'user' => [
'name' => 'Username',
'exampleValue' => 'PDModdingCommunity',
'required' => true,
'title' => 'User name as it appears in the URL',
],
'project' => [
'name' => 'Project name',
'exampleValue' => 'PD-Loader',
'required' => true,
'title' => 'Project name as it appears in the URL',
],
],
'Commits' => [
'branch' => [
'name' => 'Branch name',
'defaultValue' => 'master',
'required' => true,
'title' => 'Branch name as it appears in the URL',
],
],
'Issues' => [
'include_description' => [
'name' => 'Include issue description',
'type' => 'checkbox',
'title' => 'Activate to include the issue description',
],
],
'Single issue' => [
'issue' => [
'name' => 'Issue number',
'type' => 'number',
'exampleValue' => 100,
'required' => true,
'title' => 'Issue number from the issues list',
],
],
'Releases' => [],
];
private $title = '';
/**
* Note: detectParamters doesn't make sense for this bridge because there is
* no "single" host for this service. Anyone can host it.
*/
public function getURI()
{
switch ($this->queriedContext) {
case 'Commits':
return $this->getInput('host')
. '/' . $this->getInput('user')
. '/' . $this->getInput('project')
. '/commits/' . $this->getInput('branch');
case 'Issues':
return $this->getInput('host')
. '/' . $this->getInput('user')
. '/' . $this->getInput('project')
. '/issues/';
case 'Single issue':
return $this->getInput('host')
. '/' . $this->getInput('user')
. '/' . $this->getInput('project')
. '/issues/' . $this->getInput('issue');
case 'Releases':
return $this->getInput('host')
. '/' . $this->getInput('user')
. '/' . $this->getInput('project')
. '/releases/';
default:
return parent::getURI();
}
}
public function getName()
{
switch ($this->queriedContext) {
case 'Commits':
case 'Issues':
case 'Releases':
return $this->title . ' ' . $this->queriedContext;
case 'Single issue':
return $this->title . ' Issue ' . $this->getInput('issue');
default:
return parent::getName();
}
}
public function getIcon()
{
return 'https://gogs.io/img/favicon.ico';
}
public function collectData()
{
$html = getSimpleHTMLDOM($this->getURI());
$html = defaultLinkTo($html, $this->getURI());
$this->title = $html->find('[property="og:title"]', 0)->content;
switch ($this->queriedContext) {
case 'Commits':
$this->collectCommitsData($html);
break;
case 'Issues':
$this->collectIssuesData($html);
break;
case 'Single issue':
$this->collectSingleIssueData($html);
break;
case 'Releases':
$this->collectReleasesData($html);
break;
}
}
protected function collectCommitsData($html)
{
$commits = $html->find('#commits-table tbody tr')
or returnServerError('Unable to find commits');
foreach ($commits as $commit) {
$this->items[] = [
'uri' => $commit->find('a.sha', 0)->href,
'title' => $commit->find('.message span', 0)->plaintext,
'author' => $commit->find('.author', 0)->plaintext,
'timestamp' => $commit->find('.time-since', 0)->title,
'uid' => $commit->find('.sha', 0)->plaintext,
];
}
}
protected function collectIssuesData($html)
{
$issues = $html->find('.issue.list li')
or returnServerError('Unable to find issues');
foreach ($issues as $issue) {
$uri = $issue->find('a', 0)->href;
$item = [
'uri' => $uri,
'title' => $issue->find('.label', 0)->plaintext . ' | ' . $issue->find('a.title', 0)->plaintext,
'author' => $issue->find('.desc a', 0)->plaintext,
'timestamp' => $issue->find('.time-since', 0)->title,
'uid' => $issue->find('.label', 0)->plaintext,
];
if ($this->getInput('include_description')) {
$issue_html = getSimpleHTMLDOMCached($uri, 3600)
or returnServerError('Unable to load issue description');
$issue_html = defaultLinkTo($issue_html, $uri);
$item['content'] = $issue_html->find('.comment .markdown', 0);
}
$this->items[] = $item;
}
}
protected function collectSingleIssueData($html)
{
$comments = $html->find('.comments .comment')
or returnServerError('Unable to find comments');
foreach ($comments as $comment) {
$this->items[] = [
'uri' => $comment->find('a[href*="#issue"]', 0)->href,
'title' => $comment->find('span', 0)->plaintext,
'author' => $comment->find('.content a', 0)->plaintext,
'timestamp' => $comment->find('.time-since', 0)->title,
'content' => $comment->find('.markdown', 0),
];
}
$this->items = array_reverse($this->items);
}
protected function collectReleasesData($html)
{
$releases = $html->find('#release-list li')
or returnServerError('Unable to find releases');
foreach ($releases as $release) {
$this->items[] = [
'uri' => $release->find('a', 0)->href,
'title' => 'Release ' . $release->find('h4', 0)->plaintext,
];
}
}
}