Compare commits

..

No commits in common. "master" and "v1.1.1" have entirely different histories.

14 changed files with 187 additions and 220 deletions

2
.gitignore vendored
View File

@ -1 +1 @@
/vendor/ /config.php

View File

@ -1,32 +1,5 @@
# GiteaBot
Simple PHP library to interface with Gitea API Simple PHP library to interface with Gitea API
Designed to make a "Bot" for manipulating labels and issues. Designed to make a "Bot" for manipulating labels on issues.
For usage examples see https://git.jhodges.co.uk/jhodges/GiteaBot-examples Usage example: [no_label_milestone.php](https://git.jhodges.co.uk/james/GiteaBot/src/branch/master/no_label_milestone.php)
## Change Log
V1.2.1
* Fixed #1 Added Repo::GetIssues()
* Fixed #2 Only POST changed data on save
* Updated docs
v1.2
* Added namespacing and composer.json
* Moved usage example code to seperate repo
* Added support for add/delete comment
V1.1.1
* Refactor, bootstrap, examples
V1.1
* Refactor, better OO, examples
v1.0
* Initial Prototype

4
bootstrap.php Normal file
View File

@ -0,0 +1,4 @@
<?php
spl_autoload_register(function ($class_name) {
include 'src/'.$class_name . '.php';
});

View File

@ -1,18 +0,0 @@
{
"name": "jhodges/giteabot",
"description": "Simple PHP library to interface with Gitea API",
"type": "library",
"license": "GPL3",
"authors": [
{
"name": "James",
"email": "inbox.dev@jhodges.co.uk"
}
],
"autoload": {
"psr-4": {
"JHodges\\GiteaBot\\": "src/"
}
},
"require": {}
}

6
config.php.dist Normal file
View File

@ -0,0 +1,6 @@
<?php
return [
'url'=>'',
'user'=>'',
'pass'=>'',
];

48
no_label_milestone.php Normal file
View File

@ -0,0 +1,48 @@
<?php
//1a. Adds a no-milestone label to any issues with no milestone
//1b. Also removes the label if present on an issue with a milestone
//2a. Adds a no-label label to any issues with no labels (excluding the no-label and no-milestone)
//2b. Also removes the label if present on an issue with a label (excluding the no-label and no-milestone)
require('bootstrap.php');
$config=require('config.php');
//pass cmd line args
if($argc<3){
die(basename(__FILE__)." <USER> <REPO> [debug]\n");
}
$debug = ($argc==4 && $argv[3]=='debug');
//open connection and repo
$client=new Client($config['url'],$config['user'],$config['pass'],$debug);
$repo=$client->getRepo($argv[1],$argv[2]);
//get the labels of interest
$nolabelLabel=$repo->getLabelByName('no-label');
if(!$nolabelLabel) die ("Can't find 'no-label' label in repo\n");
$nomilestoneLabel=$repo->getLabelByName('no-milestone');
if(!$nomilestoneLabel) die ("Can't find 'no-milestone' label in repo\n");
//define the function to process each issue
$callback=function($issue) use ($nolabelLabel,$nomilestoneLabel){
// do the no-label thing
$labelCount=count($issue->labels);
if($issue->hasLabel($nolabelLabel)) $labelCount--; //dont count the no-label label
if($nomilestoneLabel && $issue->hasLabel($nomilestoneLabel)) $labelCount--; //dont count the no-milestone label
if($labelCount==0 && !$issue->hasLabel($nolabelLabel) ){
$issue->addLabel( $nolabelLabel );
}elseif( $labelCount>0 && $issue->hasLabel($nolabelLabel) ){
$issue->removeLabel( $nolabelLabel );
}
//do the no-milestone thing
if( !$issue->milestone && !$issue->hasLabel($nomilestoneLabel) ){
$issue->addLabel( $nomilestoneLabel );
}elseif( $issue->milestone && $issue->hasLabel($nomilestoneLabel) ){
$issue->removeLabel( $nomilestoneLabel );
}
};
//loop through issues and call the callback
$repo->forIssues($callback);

114
repeat.php Normal file
View File

@ -0,0 +1,114 @@
<?php
require('bootstrap.php');
$config=require("config.php");
//pass cmd line args
if($argc<3){
die(basename(__FILE__)." <USER> <REPO> [debug]\n");
}
$debug = ($argc==4 && $argv[3]=='debug');
//open connection and repo
$client=new Client($config['url'],$config['user'],$config['pass'],$debug);
$repo=$client->getRepo($argv[1],$argv[2]);
$terms=[
'months'=>['janurary','feburary','march','april','may','june','july','august','september','october','november','december'],
'days'=>['monday','tuesday','wednesday','thursday','friday','saturday','sunday'],
'generic'=>['daily','weekly','fortnightly','monthly','yearly']
];
/* create the labels */
/*
foreach($terms as $k=>$vs){
foreach($vs as $v){
$label=$repo->getLabelByName($v);
if(!$label){
$label=$repo->createLabel(['name'=>$new_name,'color'=>'#ffff00','description'=>'Reopen this issue with the given frequency']);
}
}
}
*/
//define the function to process each issue
$daily=function($issue){
$day_updated=date('d/m/Y',strtotime($issue->updated_at));
$day_closed=date('d/m/Y',strtotime($issue->closed_at));
$day_today=date('d/m/Y');
echo "Daily: ". $issue->title." ".$issue->closed_at." ($day_closed, $day_today) \n";
if($day_closed!=$day_today){
if($issue->state=="closed"){
$issue->state='open';
$issue->save();
}else{
if($day_updated!=$day_today){
$issue->addComment("NAG!");
}
}
}
};
$monthly=function($issue) use ($terms){
$month_closed=date('m/Y',strtotime($issue->closed_at));
$month_today=date('m/Y');
echo "Monthly: ".$issue->title." ".$issue->closed_at." ($month_closed, $month_today) \n";
//print_r($issue->labels);
//print_r(getRepeatTerms($issue,$terms));
//die();
if($month_closed!=$month_today){
$issue->state='open';
$issue->save();
}
};
$weekly=function($issue){
$day_updated=date('z',strtotime($issue->updated_at));
$day_closed=date('z',strtotime($issue->closed_at));
$day_today=date('z');
echo "Weekly: ". $issue->title." ".$issue->closed_at." ($day_closed, $day_today => ".(abs($day_closed-$day_today)).") \n";
if( abs($day_closed-$day_today)>7 ){
if($issue->state=="closed"){
$issue->state='open';
$issue->save();
}else{
if($day_updated!=$day_today){
$issue->addComment("NAG!");
}
}
}
};
$tmp=function($issue){
//$hours_ago=(time()-strtotime($issue->closed_at))/60/60;
};
function getRepeatTerms($issue,$terms){
$labels=[];
$found=[];
foreach($issue->labels as $label){
$labels[]=$label->name;
}
print_r($labels);
foreach($terms as $name=>$values){
foreach($values as $value){
if( in_array("$value/repeat",$labels) ){
$found[$name][]=$value;
}
}
}
return $found;
}
//loop through issues and call the callback
$day_name=strtolower(date('l'));
$month_name=strtolower(date('F'));
//$repo->forIssues($daily,['state'=>'open','labels'=>'daily/repeat']);
//die();
$repo->forIssues($weekly,['state'=>'closed','labels'=>'weekly/repeat']);
$repo->forIssues($daily,['state'=>'closed','labels'=>'daily/repeat']);
$repo->forIssues($daily,['state'=>'closed','labels'=>$day_name.'/repeat']);
$repo->forIssues($monthly,['state'=>'closed','labels'=>'monthly/repeat']);
$repo->forIssues($monthly,['state'=>'closed','labels'=>$month_name.'/repeat']);

View File

@ -1,10 +0,0 @@
<?php
namespace JHodges\GiteaBot;
class ApiException extends \Exception{
public function __toString() {
return __CLASS__ . ": [{$this->code}]: {$this->message}\n";
}
}

View File

@ -1,6 +1,4 @@
<?php <?php
namespace JHodges\GiteaBot;
class Client{ class Client{
public function __construct($url,$user,$pass,$debug=false){ public function __construct($url,$user,$pass,$debug=false){
@ -29,54 +27,24 @@ class Client{
curl_setopt($ch, CURLOPT_AUTOREFERER, true); curl_setopt($ch, CURLOPT_AUTOREFERER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
if($type!='GET' && $type!='FORM'){ if($type!='GET'){
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $type); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $type);
} }
if (!is_null($postFields)) { if (!is_null($postFields)) {
if($type=='FORM'){
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: multipart/form-data']);
}else{
$postFields = json_encode($postFields); $postFields = json_encode($postFields);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json',
'Content-Length: '.strlen($postFields), ]);
}
curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields); curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json',
'Content-Length: '.strlen($postFields), ]);
} }
if($this->user) { if($this->user) {
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC); curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, $this->user.':'.$this->pass); curl_setopt($ch, CURLOPT_USERPWD, $this->user.':'.$this->pass);
} }
$result = curl_exec($ch);
$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE); $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$result = curl_exec($ch);
curl_close($ch); curl_close($ch);
if(in_array($status_code,[200,201,204])){
return json_decode($result); return json_decode($result);
}else{
throw new ApiException($result,$status_code);
}
}
public function getUserById($id){
$url="{$this->url}users/search?uid={$id}";
$data=$this->request($url,'GET');
return $data->data[0];
}
public function getCurrentUserTimes(\DateTime $since=null, \DateTime $before=null){
$args=[];
if($before){
$args['before'] = $before->format('c');
}
if($since){
$args['since'] = $since->format('c');
}
$url="{$this->url}user/times";
if($args){
$url.='?'.http_build_query($args);
}
$data=$this->request($url,'GET');
return $data;
} }
} }

View File

@ -1,22 +1,17 @@
<?php <?php
namespace JHodges\GiteaBot;
class GiteaData{ class GiteaData{
protected $data=null; protected $data=null;
protected $newData=null;
public function __construct($data=null){ public function __construct($data=null){
$this->newData=new \stdClass();
if(!$data){ if(!$data){
$data=new \stdClass(); $data=new stdClass();
} }
$this->data=$data; $this->data=$data;
} }
public function __set($k,$v){ public function __set($k,$v){
$this->data->$k=$v; $this->data->$k=$v;
$this->newData->$k=$v;
} }
public function __get($k){ public function __get($k){

View File

@ -1,6 +1,4 @@
<?php <?php
namespace JHodges\GiteaBot;
class GiteaRepoData extends GiteaData{ class GiteaRepoData extends GiteaData{
private $repo; private $repo;
@ -15,7 +13,7 @@ class GiteaRepoData extends GiteaData{
} }
public function save(){ public function save(){
return $this->repo->request($this->url,'PATCH',$this->newData); return $this->repo->request($this->url,'PATCH',$this->data);
} }
} }

View File

@ -1,6 +1,4 @@
<?php <?php
namespace JHodges\GiteaBot;
class Issue extends GiteaRepoData{ class Issue extends GiteaRepoData{
public function __construct(Repo $repo,$data){ public function __construct(Repo $repo,$data){
@ -26,10 +24,6 @@ class Issue extends GiteaRepoData{
return $this->request($this->url.'/comments','POST',$args); return $this->request($this->url.'/comments','POST',$args);
} }
public function getComments(){
return $this->request($this->url.'/comments','GET');
}
public function hasLabel($label){ public function hasLabel($label){
$id=$label->id; $id=$label->id;
foreach($this->labels as $label){ foreach($this->labels as $label){

View File

@ -1,6 +1,4 @@
<?php <?php
namespace JHodges\GiteaBot;
class Label extends GiteaRepoData{ class Label extends GiteaRepoData{
} }

View File

@ -1,10 +1,6 @@
<?php <?php
namespace JHodges\GiteaBot;
class Repo{ class Repo{
private $cache=[];
public function __construct(Client $client,$user,$repo){ public function __construct(Client $client,$user,$repo){
$this->client=$client; $this->client=$client;
$this->user=$user; $this->user=$user;
@ -32,58 +28,10 @@ class Repo{
} }
} }
public function getIssues($args=null){
$page=1;
$all_issues=[];
while(1){
$url="repos/{$this->user}/{$this->repo}/issues?page=$page";
if($args){
$url.='&'.http_build_query($args);
}
$issues=$this->client->request($url);
foreach($issues as $data){
$issue=new Issue($this,$data);
$all_issues[]=$issue;
}
if(!$issues) break;
$page++;
}
return $all_issues;
}
public function getPulls($args=null){
$page=1;
$all_pulls=[];
while(1){
$url="repos/{$this->user}/{$this->repo}/pulls?page=$page";
if($args){
$url.='&'.http_build_query($args);
}
$pulls=$this->client->request($url);
foreach($pulls as $data){
$pull=$data;//new Issue($this,$data);
$all_pulls[]=$pull;
}
if(!$pulls) break;
$page++;
}
return $all_pulls;
}
public function getIssue($id){
$url="repos/{$this->user}/{$this->repo}/issues/{$id}";
$data=$this->client->request($url);
return new Issue($this,$data);
}
public function getLabelByName($name){ public function getLabelByName($name){
$url="repos/{$this->user}/{$this->repo}/labels"; $url="repos/{$this->user}/{$this->repo}/labels";
if(!isset($this->cache['lables'])){ $data=$this->client->request($url);
$this->cache['lables']=$this->client->request($url); foreach($data as $datum){
}
foreach($this->cache['lables'] as $datum){
if($datum->name==$name){ if($datum->name==$name){
$datum->url=$url."/".$datum->id; // not set by api for some reason (bug?) $datum->url=$url."/".$datum->id; // not set by api for some reason (bug?)
return new Label($this,$datum); return new Label($this,$datum);
@ -99,15 +47,6 @@ class Repo{
return new Label($this,$data); return new Label($this,$data);
} }
public function deleteLabel($label){
$data=$this->client->request($label->url,'DELETE');
}
public function deleteComment($comment){
$url="repos/{$this->user}/{$this->repo}/issues/comments/{$comment->id}";
$data=$this->client->request($url,'DELETE');
}
public function createIssue($args){ public function createIssue($args){
$url="repos/{$this->user}/{$this->repo}/issues"; $url="repos/{$this->user}/{$this->repo}/issues";
$data=$this->client->request($url,'POST',$args); $data=$this->client->request($url,'POST',$args);
@ -115,46 +54,4 @@ class Repo{
return new Issue($this,$data); return new Issue($this,$data);
} }
public function addReleaseAttachment($releaseId,$path){
$url="repos/{$this->user}/{$this->repo}/releases/$releaseId/assets?name=test";
$args=['attachment'=>new \CurlFile($path)];
$data=$this->client->request($url,'FORM',$args);
return $data;
}
public function getTimes(\DateTime $since=null, \DateTime $before=null){
$args=[];
if($before){
$args['before'] = $before->format('c');
}
if($since){
$args['since'] = $since->format('c');
}
$url="repos/{$this->user}/{$this->repo}/times";
if($args){
$url.='?'.http_build_query($args);
}
return $this->client->request($url,'GET');
}
public function getTimesByUsername($username,\DateTime $since=null, \DateTime $before=null){
$args=[];
if($before){
$args['before'] = $before->format('c');
}
if($since){
$args['since'] = $since->format('c');
}
$url="repos/{$this->user}/{$this->repo}/times/{$username}";
if($args){
$url.='?'.http_build_query($args);
}
return $this->client->request($url,'GET');
}
public function getUsers(){
$url="repos/{$this->user}/{$this->repo}/collaborators";
return $this->client->request($url,'GET');
}
} }