|
@@ -1,167 +1,2101 @@
|
|
|
-# gogs-php-api-client
|
|
|
|
|
|
-A client to query Gogs (https://gogs.io) API from PHP.
|
|
|
+Sami Markdown Extension
|
|
|
+===
|
|
|
|
|
|
-## Uages:
|
|
|
+# Table of content
|
|
|
+1. [Gogs](#gogs "Gogs")
|
|
|
+ 1. [API](#gogsapi "Gogs\API")
|
|
|
+ 1. [Request](#gogsapirequest "Gogs\API\Request")
|
|
|
+ 1. [Base](#base-gogsapirequest "Gogs\API\Request\Base") `@deprecated` Base class for request types.
|
|
|
+ 2. [Collection](#collection-gogsapirequest "Gogs\API\Request\Collection") Collection is a collection of data of one type.
|
|
|
+ 3. [Exception](#gogsapirequestexception "Gogs\API\Request\Exception")
|
|
|
+ 1. [InvalidMethodRequestException](#invalidmethodrequestexception-gogsapirequestexception "Gogs\API\Request\Exception\InvalidMethodRequestException") Thrown whenever a class that inherits the base-classis used wrong (e.g tries to create on a loaded object)
|
|
|
+ 2. [NotImplementedException](#notimplementedexception-gogsapirequestexception "Gogs\API\Request\Exception\NotImplementedException") Thrown when the requested method for a class isn'timplemented.
|
|
|
+ 3. [RequestErrorException](#requesterrorexception-gogsapirequestexception "Gogs\API\Request\Exception\RequestErrorException") Typically thrown when needed data to build the queryis missing.
|
|
|
+ 4. [SearchParamException](#searchparamexception-gogsapirequestexception "Gogs\API\Request\Exception\SearchParamException") Thrown when needed parameters for a search is missing.
|
|
|
+ 4. [Org](#org-gogsapirequest "Gogs\API\Request\Org") Stores data and methods related to a single organization.
|
|
|
+ 5. [Orgs](#orgs-gogsapirequest "Gogs\API\Request\Orgs") Orgs is a collection of organizations.
|
|
|
+ 6. [Repo](#repo-gogsapirequest "Gogs\API\Request\Repo") Stores data and methods related to a single repository.
|
|
|
+ 7. [Repos](#repos-gogsapirequest "Gogs\API\Request\Repos") Repos is a collection of repos.
|
|
|
+ 8. [RequestInterface](#requestinterface-gogsapirequest "Gogs\API\Request\RequestInterface") Request interface, used by any kind of request object.
|
|
|
+ 9. [User](#user-gogsapirequest "Gogs\API\Request\User") Stores user data and methods related to a single user.
|
|
|
+ 10. [Users](#users-gogsapirequest "Gogs\API\Request\Users") Returns one or more users in the Gogs installation,depending on the called method.
|
|
|
+ 2. [Client](#client-gogsapi "Gogs\API\Client") `@deprecated` Gogs API client.
|
|
|
+ 2. [Lib](#gogslib "Gogs\Lib")
|
|
|
+ 1. [Curl](#gogslibcurl "Gogs\Lib\Curl")
|
|
|
+ 1. [Client](#client-gogslibcurl "Gogs\Lib\Curl\Client") A trait used for every class referencing the api-url and token.
|
|
|
+ 2. [Exception](#gogslibcurlexception "Gogs\Lib\Curl\Exception")
|
|
|
+ 1. [HTTPUnexpectedResponse](#httpunexpectedresponse-gogslibcurlexception "Gogs\Lib\Curl\Exception\HTTPUnexpectedResponse") Defines an unexpected response.
|
|
|
+ 2. [NotAuthorizedException](#notauthorizedexception-gogslibcurlexception "Gogs\Lib\Curl\Exception\NotAuthorizedException") When the request fails because of an unauthorized token,this is thrown instead.
|
|
|
+ 2. [ArrayIterator](#arrayiterator-gogslib "Gogs\Lib\ArrayIterator") Interface to store one or more elements in arrayproviding an iterator interface.
|
|
|
+ 3. [Collection](#collection-gogslib "Gogs\Lib\Collection") Base class for collections. Implements basicfunctions and typically used to return collectionswhich wont be a part of the "request package"
|
|
|
|
|
|
-A guide on how to use will come shortly!
|
|
|
|
|
|
-### Quick example:
|
|
|
+---
|
|
|
+Documentation
|
|
|
+---
|
|
|
|
|
|
-Clone the repo. Set the `API_URL` and `API_TOKEN` in the index-file.
|
|
|
+# Gogs
|
|
|
|
|
|
-```php
|
|
|
-$client = new \Client\GogsAPI(API_URL, API_TOKEN);
|
|
|
+ * [Gogs\API](#gogsapi "Namespace: Gogs\API")
|
|
|
+ * [Gogs\API\Request](#gogsapirequest "Namespace: Gogs\API\Request")
|
|
|
+ * [Gogs\API\Request\Exception](#gogsapirequestexception "Namespace: Gogs\API\Request\Exception")
|
|
|
+ * [Gogs\Lib](#gogslib "Namespace: Gogs\Lib")
|
|
|
+ * [Gogs\Lib\Curl](#gogslibcurl "Namespace: Gogs\Lib\Curl")
|
|
|
+ * [Gogs\Lib\Curl\Exception](#gogslibcurlexception "Namespace: Gogs\Lib\Curl\Exception")
|
|
|
|
|
|
-$me = $client->user();
|
|
|
-$other = $client->user("username");
|
|
|
+# Gogs\API
|
|
|
|
|
|
-$repos = $me->get("/repos")->load();
|
|
|
+## Classes
|
|
|
|
|
|
-// Loop through every repo
|
|
|
-for($repo = $repos->current(); $repo != false; $repo = $repos->next())
|
|
|
- var_dump($repo);
|
|
|
-```
|
|
|
+### Client `Gogs\API`
|
|
|
|
|
|
-# Progress
|
|
|
|
|
|
-## Users
|
|
|
+* `@deprecated`:
|
|
|
+* Class uses [Gogs\Lib\Curl\Client](#client-gogslibcurl)
|
|
|
|
|
|
-### Search
|
|
|
-```
|
|
|
-GET /users/search
|
|
|
-```
|
|
|
+Gogs API client.
|
|
|
+
|
|
|
+This class initially provide the programmer with a starting
|
|
|
+point (a kind of an "interface" to start from), to keep
|
|
|
+track of the context when going from a user, to a repo,
|
|
|
+organization etc.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[__construct](#__construct-gogsapiclient)||public| |
|
|
|
+|[users](#users-gogsapiclient)|[Users](#users-gogsapirequest)|public| Returns a Request\Users to fetch users from theGogs installation.|
|
|
|
+|[user](#user-gogsapiclient)|[User](#user-gogsapirequest)|public| Get a single user from Gogs.|
|
|
|
+|[repos](#repos-gogsapiclient)|[Repos](#repos-gogsapirequest)|public| Returns an \Request\Repos to fetch repositorieson the Gogs installation.|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### __construct `Gogs\API\Client`
|
|
|
```php
|
|
|
-$users = $client->users()->search(array("name" => /* username */));
|
|
|
+public function __construct(string $api_url, string $api_token);
|
|
|
```
|
|
|
-The array-param can be
|
|
|
-* name/q: The username
|
|
|
-* limit: maximum number of results, default: 10
|
|
|
|
|
|
-Returns a `CollectionResult`, e.g
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$api_url|The base URL for the Gogs API (e.g https://git.domain.tld/api/v1)|
|
|
|
+|string|$api_token|The token for an authorized user to query Gogs API.|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### users `Gogs\API\Client`
|
|
|
```php
|
|
|
-foreach ($users as $user)
|
|
|
- echo $user->ufull_name . "\n";
|
|
|
+public function users();
|
|
|
```
|
|
|
+ Returns a Request\Users to fetch users from the
|
|
|
+Gogs installation.
|
|
|
|
|
|
-### Get authenticated user
|
|
|
-```
|
|
|
-GET /user
|
|
|
-```
|
|
|
+
|
|
|
+Returns: [Users](#users-gogsapirequest)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### user `Gogs\API\Client`
|
|
|
```php
|
|
|
-$me = $client->user(); // alt: $client->users()->get()
|
|
|
+public function user(string $name = "me");
|
|
|
```
|
|
|
+ Get a single user from Gogs.
|
|
|
|
|
|
-### Get a single user
|
|
|
-```
|
|
|
-GET /users/:username
|
|
|
-```
|
|
|
+Returns either
|
|
|
+* the authorized user ($name = "" or "me")
|
|
|
+* the specified user ($name = anything else)
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$name|*None*|
|
|
|
+
|
|
|
+Returns: [User](#user-gogsapirequest)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### repos `Gogs\API\Client`
|
|
|
```php
|
|
|
-$user = $client->user("username"); // alt: $client->users()->get("username")
|
|
|
+public function repos();
|
|
|
```
|
|
|
+ Returns an \Request\Repos to fetch repositories
|
|
|
+on the Gogs installation.
|
|
|
+
|
|
|
+
|
|
|
+Returns: [Repos](#repos-gogsapirequest)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+# Gogs\API\Request
|
|
|
+
|
|
|
+## Classes
|
|
|
|
|
|
-### Create a user
|
|
|
+### Base `Gogs\API\Request`
|
|
|
+
|
|
|
+
|
|
|
+* `@deprecated`: since 0.1, to be removed in 3.0
|
|
|
+* Class implements[Gogs\API\Request\RequestInterface](#requestinterface-gogsapirequest)
|
|
|
+* Class uses [Gogs\Lib\Curl\Client](#client-gogslibcurl)
|
|
|
+
|
|
|
+Base class for request types.
|
|
|
+
|
|
|
+Each request shall inherit this class to ensure
|
|
|
+it will have the correct methods required by interface,
|
|
|
+and get the cURL functionality.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[__construct](#__construct-gogsapirequestbase)||public| |
|
|
|
+|[load](#load-gogsapirequestbase)|object|final public| Load an object.|
|
|
|
+|[method_get](#method_get-gogsapirequestbase)|string|final protected| Perform a GET-request against the Gogs API.|
|
|
|
+|[method_post](#method_post-gogsapirequestbase)|string|final protected| Perform a POST-request against the Gogs API.|
|
|
|
+|[method_delete](#method_delete-gogsapirequestbase)|string|final protected| Perform a DELETE-request against the Gogs API.|
|
|
|
+|[get](#get-gogsapirequestbase)|object|public| Get object references by identifier.|
|
|
|
+|[create](#create-gogsapirequestbase)|bool|public| Create object inherited by class.|
|
|
|
+|[patch](#patch-gogsapirequestbase)|bool|public| Patch (update) object|
|
|
|
+|[delete](#delete-gogsapirequestbase)|bool|public| Delete object.|
|
|
|
+|[json_decode](#json_decode-gogsapirequestbase)|object|final protected| Decode JSON-string.|
|
|
|
+|[json_encode](#json_encode-gogsapirequestbase)|string|final protected| Encode JSON-object/array.|
|
|
|
+|[json_error](#json_error-gogsapirequestbase)||final protected| Check for errors on encoding/decoding.|
|
|
|
+|[property_exists](#property_exists-gogsapirequestbase)|string ***v*** [false](#false-gogsapirequest)|final protected| Checks if the property (key) exists within selfor parent class.|
|
|
|
+|[__get](#__get-gogsapirequestbase)|mixed ***v*** null|final public| Get property by name.|
|
|
|
+|[__set](#__set-gogsapirequestbase)|mixed ***v*** null|final public| Set property by name.|
|
|
|
+|[__isset](#__isset-gogsapirequestbase)|bool|final public| Checks if property is set.|
|
|
|
+|[json_set_property](#json_set_property-gogsapirequestbase)|[true](#true-gogsapirequest) ***v*** array|abstract protected| Set properties for the current object.|
|
|
|
+|[set_scope](#set_scope-gogsapirequestbase)|bool|abstract protected| Set the scope for the request methods accepted by the child.|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### __construct `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+public function __construct(string $api_url, string $api_token);
|
|
|
```
|
|
|
-POST /admin/users
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$api_url|The URL to the API.|
|
|
|
+|string|$api_token|A token for an authorized user|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### load `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+final public function load(bool $force = false);
|
|
|
```
|
|
|
+ Load an object.
|
|
|
+
|
|
|
+If `$force = true` the object will be fetched
|
|
|
+from the Gogs API again.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|bool|$force|Force update, default: true|
|
|
|
+
|
|
|
+Returns: object
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### method_get `Gogs\API\Request\Base`
|
|
|
```php
|
|
|
-$user = $clients->users()->new(
|
|
|
- "new user", "users@email.com"
|
|
|
-);
|
|
|
+final protected function method_get(array $params = array());
|
|
|
```
|
|
|
-The params should be in the order
|
|
|
-* username (required)
|
|
|
-* email (required)
|
|
|
-* source_id
|
|
|
-* login_name
|
|
|
-* password
|
|
|
-* send_notify
|
|
|
+ Perform a GET-request against the Gogs API.
|
|
|
|
|
|
-Requires the authenticated user to have admin rights.
|
|
|
-### Delete a user
|
|
|
+Ensure the correct scope i set first, with
|
|
|
+```php
|
|
|
+$this->set_scope("*valid scope*"); // e.g create
|
|
|
```
|
|
|
-DELETE /admin/users/:username
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|array|$params|The parameters|
|
|
|
+
|
|
|
+Returns: string
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### method_post `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+final protected function method_post(array $params = array());
|
|
|
```
|
|
|
+ Perform a POST-request against the Gogs API.
|
|
|
+
|
|
|
+Ensure the correct scope i set first, with
|
|
|
```php
|
|
|
-$user->delete();
|
|
|
+$this->set_scope("*valid scope*"); // e.g create
|
|
|
```
|
|
|
-Requires the authenticated user to have admin rights.
|
|
|
|
|
|
-### Get a user's repos
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|array|$params|The parameters|
|
|
|
+
|
|
|
+Returns: string
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### method_delete `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+final protected function method_delete();
|
|
|
```
|
|
|
-GET /user/repos
|
|
|
+ Perform a DELETE-request against the Gogs API.
|
|
|
+
|
|
|
+Ensure the correct scope i set first, with
|
|
|
+```php
|
|
|
+$this->set_scope("*valid scope*"); // e.g delete
|
|
|
```
|
|
|
-or
|
|
|
+
|
|
|
+
|
|
|
+Returns: string
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### get `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+public function get(string $s);
|
|
|
```
|
|
|
-GET /users/:username/repos
|
|
|
+ Get object references by identifier.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$s|The idientifier to look up|
|
|
|
+
|
|
|
+Returns: object
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### create `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+public function create(... $args);
|
|
|
```
|
|
|
+ Create object inherited by class.
|
|
|
+
|
|
|
+Child class must add a scope for 'create' and ensure child is not *loaded*,
|
|
|
+otherwise will `create` throw an exception.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|[...](http://php.net/manual/en/functions.arguments.php#functions.variable-arg-list)|$args|Arguments required by create.|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+Throws:
|
|
|
+
|
|
|
+* [InvalidMethodRequestException](#invalidmethodrequestexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\InvalidMethodRequestException")
|
|
|
+* [NotImplementedException](#notimplementedexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\NotImplementedException")
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### patch `Gogs\API\Request\Base`
|
|
|
```php
|
|
|
-$repos = $user->repos()->load();
|
|
|
+public function patch();
|
|
|
```
|
|
|
+ Patch (update) object
|
|
|
+
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+Throws:
|
|
|
|
|
|
-### Get specific user's repo
|
|
|
+* [InvalidMethodRequestException](#invalidmethodrequestexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\InvalidMethodRequestException")
|
|
|
+* [NotImplementedException](#notimplementedexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\NotImplementedException")
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### delete `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+public function delete();
|
|
|
```
|
|
|
-GET /repos/:owner/:repo
|
|
|
+ Delete object.
|
|
|
+
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+Throws:
|
|
|
+
|
|
|
+* [NotImplementedException](#notimplementedexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\NotImplementedException")
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### json_decode `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+final protected function json_decode(string $jenc);
|
|
|
```
|
|
|
+ Decode JSON-string.
|
|
|
+
|
|
|
+Will ensure that there weren't any errors by calling `$this->json_error`.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$jenc|Encoded JSON string|
|
|
|
+
|
|
|
+Returns: object
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### json_encode `Gogs\API\Request\Base`
|
|
|
```php
|
|
|
-$repo = $user->repo( /* repo */ );
|
|
|
+final protected function json_encode(iterable $jdec);
|
|
|
```
|
|
|
+ Encode JSON-object/array.
|
|
|
|
|
|
-### Create a user's repo
|
|
|
+Will ensure that there weren't any errors by calling `$this->json_error`.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|[iterable](http://php.net/manual/en/functions.arguments.php#functions.arguments.type-declaration.types)|$jdec|JSON-data|
|
|
|
+
|
|
|
+Returns: string
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### json_error `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+final protected function json_error();
|
|
|
```
|
|
|
-POST /user/repos
|
|
|
+ Check for errors on encoding/decoding.
|
|
|
+
|
|
|
+Throws:
|
|
|
+
|
|
|
+* [RequestErrorException](#requesterrorexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\RequestErrorException")
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### property_exists `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+final protected function property_exists(mixed $name);
|
|
|
```
|
|
|
-or
|
|
|
+ Checks if the property (key) exists within self
|
|
|
+or parent class.
|
|
|
+
|
|
|
+Returns the actual key if it does. A class key (aka property)
|
|
|
+start with the tag `classname_` followed by property name,
|
|
|
+reflecting the JSON-object, and can be reached by
|
|
|
+
|
|
|
+ * `$class->parameter`,
|
|
|
+ * `$class->classname_parameter` or alternatively (for classes that inherits another class).
|
|
|
+ * `$class->parentclassname_parameter`.
|
|
|
+
|
|
|
+ If a class override a parent class with the same parameter,
|
|
|
+ the class's own parameter will be favoured.
|
|
|
+
|
|
|
+As this is public properties this wont be an security issue;
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$name|Name of the key.|
|
|
|
+
|
|
|
+Returns: string ***v*** [false](#false-gogsapirequest)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### __get `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+final public function __get(string $name);
|
|
|
```
|
|
|
-POST /admin/users/:username/repos
|
|
|
+ Get property by name.
|
|
|
+
|
|
|
+Checks both self and parent for the property.
|
|
|
+
|
|
|
+Returns the value if property exists, otherwise an `E_USER_NOTICE`
|
|
|
+is triggered.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$name|*None*|
|
|
|
+
|
|
|
+Returns: mixed ***v*** null
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### __set `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+final public function __set(string $name, mixed $value);
|
|
|
```
|
|
|
+ Set property by name.
|
|
|
+
|
|
|
+Checks both self and parent for the property.
|
|
|
+
|
|
|
+Returns the value if property exists, otherwise an `E_USER_NOTICE`
|
|
|
+is triggered.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$name|Property name|
|
|
|
+|mixed|$value|Property value|
|
|
|
+
|
|
|
+Returns: mixed ***v*** null
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### __isset `Gogs\API\Request\Base`
|
|
|
```php
|
|
|
-$user->repos()->new(
|
|
|
- "name"
|
|
|
-);
|
|
|
+final public function __isset(string $name);
|
|
|
```
|
|
|
+ Checks if property is set.
|
|
|
+
|
|
|
+Checks both self and parent for property.
|
|
|
+
|
|
|
+Triggers E_USER_NOTICE if property is unknown.
|
|
|
+
|
|
|
|
|
|
-The params should be in the order
|
|
|
-* name
|
|
|
-* description
|
|
|
-* private
|
|
|
-* bool
|
|
|
-* auto_init
|
|
|
-* gitignores
|
|
|
-* license
|
|
|
-* readme
|
|
|
+Parameters
|
|
|
|
|
|
-Requires the authenticated user to have admin rights to be able to create repos for other users than itself.
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$name|Property name|
|
|
|
|
|
|
-### Delete a user's repo
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### json_set_property `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+abstract protected function json_set_property(mixed $obj);
|
|
|
```
|
|
|
-DELETE /repos/:owner/:repo
|
|
|
+ Set properties for the current object.
|
|
|
+
|
|
|
+Each child class must implement this to set its data. Will
|
|
|
+be called by methods such as `load` and from collection
|
|
|
+classes.
|
|
|
+
|
|
|
+Will return true/false for singel objects but an array on collections.
|
|
|
+The array will contain the newly inserted elements. This to prevent
|
|
|
+additional iterations.
|
|
|
+
|
|
|
+This method should also set loaded to true or false, depending
|
|
|
+on success or failure.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$obj|*None*|
|
|
|
+
|
|
|
+Returns: [true](#true-gogsapirequest) ***v*** array
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### set_scope `Gogs\API\Request\Base`
|
|
|
+```php
|
|
|
+abstract protected function set_scope(string $method);
|
|
|
```
|
|
|
+ Set the scope for the request methods accepted by the child.
|
|
|
+
|
|
|
+This can be
|
|
|
+ * `get`,
|
|
|
+ * `search`,
|
|
|
+ * `delete` etc.
|
|
|
+
|
|
|
+ Must return true if scope exists of false otherwise. Methods
|
|
|
+ the calls this will throw an exception if not true is returned.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$method|Method type, e.g "get"|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+### Collection `Gogs\API\Request`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Gogs\API\Request\Base](#base-gogsapirequest)
|
|
|
+* Class implements
|
|
|
+ * [Gogs\Lib\ArrayIterator](#arrayiterator-gogslib)
|
|
|
+ * [Gogs\API\Request\RequestInterface](#requestinterface-gogsapirequest)
|
|
|
+
|
|
|
+Collection is a collection of data of one type.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[add](#add-gogsapirequestcollection)|mixed ***v*** int|public| Add an object to the collection.|
|
|
|
+|[remove](#remove-gogsapirequestcollection)|bool|public| Remove an element in collection.|
|
|
|
+|[all](#all-gogsapirequestcollection)|array|public| |
|
|
|
+|[len](#len-gogsapirequestcollection)|int|public| |
|
|
|
+|[by_key](#by_key-gogsapirequestcollection)|mixed|public| |
|
|
|
+|[next](#next-gogsapirequestcollection)|mixed|public| |
|
|
|
+|[prev](#prev-gogsapirequestcollection)|mixed|public| |
|
|
|
+|[current](#current-gogsapirequestcollection)||public| |
|
|
|
+|[reset](#reset-gogsapirequestcollection)|mixed|public| |
|
|
|
+|[search](#search-gogsapirequestcollection)|[Collection](#collection-gogslib)|abstract public| Search for an object.|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### add `Gogs\API\Request\Collection`
|
|
|
```php
|
|
|
-$repo->delete();
|
|
|
+public function add(mixed $obj, mixed $key = null);
|
|
|
```
|
|
|
-Requires the authenticated user to have admin rights to be able to delete repos for other users than itself.
|
|
|
+ Add an object to the collection.
|
|
|
+
|
|
|
+When adding a key the object will be stored
|
|
|
+on the particual key, also overwriting existing data.
|
|
|
|
|
|
-### Get a user's organizations
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$obj|Element to store|
|
|
|
+|mixed|$key|Index key to store on|
|
|
|
+
|
|
|
+Returns: mixed ***v*** int
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### remove `Gogs\API\Request\Collection`
|
|
|
+```php
|
|
|
+public function remove(mixed $any, bool $deep = true);
|
|
|
```
|
|
|
-GET /user/orgs
|
|
|
+ Remove an element in collection.
|
|
|
+
|
|
|
+The function will first look for the element as a
|
|
|
+index key, but if its not found it will look for the
|
|
|
+element as a value.
|
|
|
+
|
|
|
+Deep functions only when the value is given and not the key.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$any|Index key or element value|
|
|
|
+|bool|$deep|Delete every item and not just the first|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### all `Gogs\API\Request\Collection`
|
|
|
+```php
|
|
|
+public function all();
|
|
|
```
|
|
|
-or
|
|
|
+
|
|
|
+Returns: array
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### len `Gogs\API\Request\Collection`
|
|
|
+```php
|
|
|
+public function len();
|
|
|
```
|
|
|
-GET /users/:username/orgs
|
|
|
+
|
|
|
+Returns: int
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### by_key `Gogs\API\Request\Collection`
|
|
|
+```php
|
|
|
+public function by_key(mixed $idx);
|
|
|
```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$idx|Index key.|
|
|
|
+
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### next `Gogs\API\Request\Collection`
|
|
|
```php
|
|
|
-$orgs = $user->organizations();
|
|
|
+public function next();
|
|
|
```
|
|
|
|
|
|
-## Organizations
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
|
|
|
-### Get an organizations repositories
|
|
|
+
|
|
|
+##### prev `Gogs\API\Request\Collection`
|
|
|
+```php
|
|
|
+public function prev();
|
|
|
```
|
|
|
-GET /orgs/:orgname/repos
|
|
|
+
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### current `Gogs\API\Request\Collection`
|
|
|
+```php
|
|
|
+public function current();
|
|
|
```
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### reset `Gogs\API\Request\Collection`
|
|
|
```php
|
|
|
-$org = $user->organizations()->load()->current();
|
|
|
+public function reset();
|
|
|
+```
|
|
|
|
|
|
-$repos = $org->repos();
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### search `Gogs\API\Request\Collection`
|
|
|
+```php
|
|
|
+abstract public function search(array $params = array());
|
|
|
```
|
|
|
+ Search for an object.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|array|$params|Parameters|
|
|
|
+
|
|
|
+Returns: [Collection](#collection-gogslib)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+### Org `Gogs\API\Request`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Gogs\API\Request\User](#user-gogsapirequest)
|
|
|
+* Class implements[Gogs\API\Request\RequestInterface](#requestinterface-gogsapirequest)
|
|
|
+
|
|
|
+Stores data and methods related to a single organization.
|
|
|
+
|
|
|
+By now the following are supported:
|
|
|
+
|
|
|
+ * GET `/orgs/username`
|
|
|
+ * POST `/admin/users/username/orgs` (**Requires** admin rights. Curl will throw NotAuthorized exception if not).
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[__construct](#__construct-gogsapirequestorg)||public| Initialize an organization.|
|
|
|
+|[set_scope](#set_scope-gogsapirequestorg)|bool|protected| |
|
|
|
+|[search](#search-gogsapirequestorg)||public| |
|
|
|
+|[create](#create-gogsapirequestorg)|bool|public| Create a new user|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### __construct `Gogs\API\Request\Org`
|
|
|
+```php
|
|
|
+public function __construct(string $api_url, string $api_token, User $owner = null, string $oname = null);
|
|
|
+```
|
|
|
+ Initialize an organization.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$api_url|The URL to the API.|
|
|
|
+|string|$api_token|A token for an authorized user|
|
|
|
+|[User](#request-gogsapi)|$owner|The owner of the organization|
|
|
|
+|string|$oname|Organization name|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### set_scope `Gogs\API\Request\Org`
|
|
|
+```php
|
|
|
+protected function set_scope(string $method);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$method|Method type, e.g "get"|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+Throws:
|
|
|
+
|
|
|
+* [InvalidMethodRequestException](#invalidmethodrequestexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\InvalidMethodRequestException")
|
|
|
+* [RequestErrorException](#requesterrorexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\RequestErrorException")
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### search `Gogs\API\Request\Org`
|
|
|
+```php
|
|
|
+public function search(string $q);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$q|*None*|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### create `Gogs\API\Request\Org`
|
|
|
+```php
|
|
|
+public function create(... $args);
|
|
|
+```
|
|
|
+ Create a new user
|
|
|
+
|
|
|
+Valid parameters:
|
|
|
+
|
|
|
+ 1. username
|
|
|
+ 2. full_name
|
|
|
+ 3. description
|
|
|
+ 4. website
|
|
|
+ 5. location
|
|
|
+
|
|
|
+ This reflects the API v1 doc, but is in an order
|
|
|
+ where the required fields is first.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|[...](http://php.net/manual/en/functions.arguments.php#functions.variable-arg-list)|$args|Arguments required by create.|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+### Orgs `Gogs\API\Request`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Gogs\API\Request\Collection](#collection-gogsapirequest)
|
|
|
+* Class implements
|
|
|
+ * [Gogs\Lib\ArrayIterator](#arrayiterator-gogslib)
|
|
|
+ * [Gogs\API\Request\RequestInterface](#requestinterface-gogsapirequest)
|
|
|
+
|
|
|
+Orgs is a collection of organizations.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[__construct](#__construct-gogsapirequestorgs)||public| |
|
|
|
+|[set_scope](#set_scope-gogsapirequestorgs)|bool|protected| Set the scope for the request methods accepted by the child.|
|
|
|
+|[create](#create-gogsapirequestorgs)|bool|public| Create object inherited by class.|
|
|
|
+|[get](#get-gogsapirequestorgs)|object|public| Get an organization by indentifier.|
|
|
|
+|[search](#search-gogsapirequestorgs)|[Collection](#collection-gogslib)|public| Search for an organization.|
|
|
|
+|[json_set_property](#json_set_property-gogsapirequestorgs)|[true](#true-gogsapirequest) ***v*** array|protected| |
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### __construct `Gogs\API\Request\Orgs`
|
|
|
+```php
|
|
|
+public function __construct(string $api_url, string $api_token, User $owner);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$api_url|The URL to the API.|
|
|
|
+|string|$api_token|A token for an authorized user|
|
|
|
+|[User](#request-gogsapi)|$owner|*None*|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### set_scope `Gogs\API\Request\Orgs`
|
|
|
+```php
|
|
|
+protected function set_scope(string $method);
|
|
|
+```
|
|
|
+ Set the scope for the request methods accepted by the child.
|
|
|
+
|
|
|
+This can be
|
|
|
+ * `get`,
|
|
|
+ * `search`,
|
|
|
+ * `delete` etc.
|
|
|
+
|
|
|
+ Must return true if scope exists of false otherwise. Methods
|
|
|
+ the calls this will throw an exception if not true is returned.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$method|Method type, e.g "get"|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### create `Gogs\API\Request\Orgs`
|
|
|
+```php
|
|
|
+public function create(... $args);
|
|
|
+```
|
|
|
+ Create object inherited by class.
|
|
|
+
|
|
|
+Child class must add a scope for 'create' and ensure child is not *loaded*,
|
|
|
+otherwise will `create` throw an exception.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|[...](http://php.net/manual/en/functions.arguments.php#functions.variable-arg-list)|$args|Arguments required by create.|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+Throws:
|
|
|
+
|
|
|
+* [InvalidMethodRequestException](#invalidmethodrequestexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\InvalidMethodRequestException")
|
|
|
+* [NotImplementedException](#notimplementedexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\NotImplementedException")
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### get `Gogs\API\Request\Orgs`
|
|
|
+```php
|
|
|
+public function get(string $s);
|
|
|
+```
|
|
|
+ Get an organization by indentifier.
|
|
|
+
|
|
|
+Method will first look through organizations
|
|
|
+already loaded. If not found it will return a
|
|
|
+new object.
|
|
|
+
|
|
|
+Method does not ensure the organization in loaded
|
|
|
+from Gogs so the user should call `->load()` on
|
|
|
+returned element.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$s|The idientifier to look up|
|
|
|
+
|
|
|
+Returns: object
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### search `Gogs\API\Request\Orgs`
|
|
|
+```php
|
|
|
+public function search(array $params = array());
|
|
|
+```
|
|
|
+ Search for an organization.
|
|
|
+
|
|
|
+Params can be an array of
|
|
|
+```php
|
|
|
+$orgs->search(array(
|
|
|
+ "name" => "name", // alt. "q". required
|
|
|
+ "limit" => 10, // not required, default: 10
|
|
|
+));
|
|
|
+```
|
|
|
+By now, this method can be intensive, as it will load
|
|
|
+every organization and then do a match on each entry.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|array|$params|Parameters|
|
|
|
+
|
|
|
+Returns: [Collection](#collection-gogslib)
|
|
|
+
|
|
|
+Throws:
|
|
|
+
|
|
|
+* [SearchParamException](#searchparamexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\SearchParamException")
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### json_set_property `Gogs\API\Request\Orgs`
|
|
|
+```php
|
|
|
+protected function json_set_property(mixed $obj);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$obj|*None*|
|
|
|
+
|
|
|
+Returns: [true](#true-gogsapirequest) ***v*** array
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+### Repo `Gogs\API\Request`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Gogs\API\Request\Base](#base-gogsapirequest)
|
|
|
+* Class implements[Gogs\API\Request\RequestInterface](#requestinterface-gogsapirequest)
|
|
|
+
|
|
|
+Stores data and methods related to a single repository.
|
|
|
+
|
|
|
+By now the following are supported:
|
|
|
+
|
|
|
+ * GET `/repos/username/reponame`
|
|
|
+ * POST `/user/repos`
|
|
|
+ * POST `/admin/user/username/repos`
|
|
|
+ * POST `/org/orgname/repos`
|
|
|
+ * DELETE `/repos/username/reponame`
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[__construct](#__construct-gogsapirequestrepo)||public| Initialize a repo object.|
|
|
|
+|[set_scope](#set_scope-gogsapirequestrepo)|bool|protected| |
|
|
|
+|[json_set_property](#json_set_property-gogsapirequestrepo)|[true](#true-gogsapirequest) ***v*** array|protected| |
|
|
|
+|[search](#search-gogsapirequestrepo)||public| |
|
|
|
+|[create](#create-gogsapirequestrepo)|bool|public| Create a new repo|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### __construct `Gogs\API\Request\Repo`
|
|
|
+```php
|
|
|
+public function __construct(string $api_url, string $api_token, User $owner = null, string $name = null);
|
|
|
+```
|
|
|
+ Initialize a repo object.
|
|
|
+
|
|
|
+Note that the owner can also be an Org (organization),
|
|
|
+or any other class that inherits a user.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$api_url|The URL to the API.|
|
|
|
+|string|$api_token|A token for an authorized user|
|
|
|
+|[User](#request-gogsapi)|$owner|The owner of the repo|
|
|
|
+|string|$name|The repo name|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### set_scope `Gogs\API\Request\Repo`
|
|
|
+```php
|
|
|
+protected function set_scope(string $method);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$method|Method type, e.g "get"|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+Throws:
|
|
|
+
|
|
|
+* [RequestErrorException](#requesterrorexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\RequestErrorException")
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### json_set_property `Gogs\API\Request\Repo`
|
|
|
+```php
|
|
|
+protected function json_set_property(mixed $obj);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$obj|*None*|
|
|
|
+
|
|
|
+Returns: [true](#true-gogsapirequest) ***v*** array
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### search `Gogs\API\Request\Repo`
|
|
|
+```php
|
|
|
+public function search(string $q);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$q|*None*|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### create `Gogs\API\Request\Repo`
|
|
|
+```php
|
|
|
+public function create(... $args);
|
|
|
+```
|
|
|
+ Create a new repo
|
|
|
+
|
|
|
+Valid paramters:
|
|
|
+
|
|
|
+ 1. name
|
|
|
+ 2. description
|
|
|
+ 3. private (default: false)
|
|
|
+ 4. auto_init (default: false)
|
|
|
+ 5. gitignore
|
|
|
+ 6. license
|
|
|
+ 7. readme (default: "Default")
|
|
|
+
|
|
|
+ This reflects the API v1 documentation, but is in an order
|
|
|
+ where the required fields are first.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|[...](http://php.net/manual/en/functions.arguments.php#functions.variable-arg-list)|$args|Arguments required by create.|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+### Repos `Gogs\API\Request`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Gogs\API\Request\Collection](#collection-gogsapirequest)
|
|
|
+* Class implements
|
|
|
+ * [Gogs\Lib\ArrayIterator](#arrayiterator-gogslib)
|
|
|
+ * [Gogs\API\Request\RequestInterface](#requestinterface-gogsapirequest)
|
|
|
+
|
|
|
+Repos is a collection of repos.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[__construct](#__construct-gogsapirequestrepos)||public| Initialize a repos collection|
|
|
|
+|[set_scope](#set_scope-gogsapirequestrepos)|bool|protected| |
|
|
|
+|[create](#create-gogsapirequestrepos)|bool|public| |
|
|
|
+|[search](#search-gogsapirequestrepos)|[Collection](#collection-gogslib)|public| Searches for a repo.|
|
|
|
+|[json_set_property](#json_set_property-gogsapirequestrepos)|[true](#true-gogsapirequest) ***v*** array|protected| |
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### __construct `Gogs\API\Request\Repos`
|
|
|
+```php
|
|
|
+public function __construct(string $api_url, string $api_token, User $owner = null);
|
|
|
+```
|
|
|
+ Initialize a repos collection
|
|
|
+
|
|
|
+If owner is not set it will query the whole
|
|
|
+repo archive on Gogs.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$api_url|The URL to the API.|
|
|
|
+|string|$api_token|A token for an authorized user|
|
|
|
+|[User](#request-gogsapi)|$owner|The owner of the collection|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### set_scope `Gogs\API\Request\Repos`
|
|
|
+```php
|
|
|
+protected function set_scope(string $method);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$method|Method type, e.g "get"|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### create `Gogs\API\Request\Repos`
|
|
|
+```php
|
|
|
+public function create(... $args);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|[...](http://php.net/manual/en/functions.arguments.php#functions.variable-arg-list)|$args|Arguments required by create.|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### search `Gogs\API\Request\Repos`
|
|
|
+```php
|
|
|
+public function search(array $params = array());
|
|
|
+```
|
|
|
+ Searches for a repo.
|
|
|
+
|
|
|
+If the owner is specified the search will be
|
|
|
+limited to the actual user.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|array|$params|Parameters|
|
|
|
+
|
|
|
+Returns: [Collection](#collection-gogslib)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### json_set_property `Gogs\API\Request\Repos`
|
|
|
+```php
|
|
|
+protected function json_set_property(mixed $obj);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$obj|*None*|
|
|
|
+
|
|
|
+Returns: [true](#true-gogsapirequest) ***v*** array
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+### User `Gogs\API\Request`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Gogs\API\Request\Base](#base-gogsapirequest)
|
|
|
+* Class implements[Gogs\API\Request\RequestInterface](#requestinterface-gogsapirequest)
|
|
|
+
|
|
|
+Stores user data and methods related to a single user.
|
|
|
+
|
|
|
+By now the following are supported:
|
|
|
+
|
|
|
+ * GET `/user`
|
|
|
+ * GET `/users/username`
|
|
|
+ * POST `/admin/users` (**Requires** admin rights. Curl will throw NotAuthorized exception if not).
|
|
|
+ * DELETE `/admin/users` (**Requires** admin rights. Curl will throw NotAuthorized exception if not).
|
|
|
+
|
|
|
+A user can also list it's repos and organizations.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[__construct](#__construct-gogsapirequestuser)||public| Initialize an user object.|
|
|
|
+|[set_scope](#set_scope-gogsapirequestuser)|bool|protected| |
|
|
|
+|[search](#search-gogsapirequestuser)||public| |
|
|
|
+|[authenticated](#authenticated-gogsapirequestuser)|bool|public| Returns if the user is the authenticated user.|
|
|
|
+|[repos](#repos-gogsapirequestuser)|[Repos](#repos-gogsapirequest)|public| Returns every repo under user.|
|
|
|
+|[repo](#repo-gogsapirequestuser)|[Repo](#repo-gogsapirequest)|public| Return a single repo.|
|
|
|
+|[organizations](#organizations-gogsapirequestuser)|[Orgs](#orgs-gogsapirequest)|public| Return every organization under user.|
|
|
|
+|[organization](#organization-gogsapirequestuser)|[Org](#org-gogsapirequest)|public| Return a single organization.|
|
|
|
+|[create](#create-gogsapirequestuser)|bool|public| Create a new user.|
|
|
|
+|[json_set_property](#json_set_property-gogsapirequestuser)|[true](#true-gogsapirequest) ***v*** array|protected| |
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### __construct `Gogs\API\Request\User`
|
|
|
+```php
|
|
|
+public function __construct(string $api_url, string $api_token, string $user = "");
|
|
|
+```
|
|
|
+ Initialize an user object.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$api_url|The URL to the API.|
|
|
|
+|string|$api_token|A token for an authorized user|
|
|
|
+|string|$user|The username. "Empty" or "me" will return authenticated user|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### set_scope `Gogs\API\Request\User`
|
|
|
+```php
|
|
|
+protected function set_scope(string $method);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$method|Method type, e.g "get"|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+Throws:
|
|
|
+
|
|
|
+* [InvalidMethodRequest](#invalidmethodrequest-gogsapirequestexception "Exception: Gogs\API\Request\Exception\InvalidMethodRequest")
|
|
|
+* [RequestErrorException](#requesterrorexception-gogsapirequestexception "Exception: Gogs\API\Request\Exception\RequestErrorException")
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### search `Gogs\API\Request\User`
|
|
|
+```php
|
|
|
+public function search(string $q);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$q|*None*|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### authenticated `Gogs\API\Request\User`
|
|
|
+```php
|
|
|
+public function authenticated();
|
|
|
+```
|
|
|
+ Returns if the user is the authenticated user.
|
|
|
+
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### repos `Gogs\API\Request\User`
|
|
|
+```php
|
|
|
+public function repos();
|
|
|
+```
|
|
|
+ Returns every repo under user.
|
|
|
+
|
|
|
+
|
|
|
+Returns: [Repos](#repos-gogsapirequest)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### repo `Gogs\API\Request\User`
|
|
|
+```php
|
|
|
+public function repo(string $name);
|
|
|
+```
|
|
|
+ Return a single repo.
|
|
|
+
|
|
|
+Note: This will also load the repo.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$name|Repo name|
|
|
|
+
|
|
|
+Returns: [Repo](#repo-gogsapirequest)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### organizations `Gogs\API\Request\User`
|
|
|
+```php
|
|
|
+public function organizations();
|
|
|
+```
|
|
|
+ Return every organization under user.
|
|
|
+
|
|
|
+
|
|
|
+Returns: [Orgs](#orgs-gogsapirequest)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### organization `Gogs\API\Request\User`
|
|
|
+```php
|
|
|
+public function organization(string $name);
|
|
|
+```
|
|
|
+ Return a single organization.
|
|
|
+
|
|
|
+Note: This will also load the repo.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$name|Organization name|
|
|
|
+
|
|
|
+Returns: [Org](#org-gogsapirequest)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### create `Gogs\API\Request\User`
|
|
|
+```php
|
|
|
+public function create(... $args);
|
|
|
+```
|
|
|
+ Create a new user.
|
|
|
+
|
|
|
+Valid parameters
|
|
|
+
|
|
|
+ 1. username
|
|
|
+ 2. email
|
|
|
+ 3. source_id
|
|
|
+ 4. login_name
|
|
|
+ 5. password
|
|
|
+ 6. send_notify
|
|
|
+
|
|
|
+This reflects the API v1 documentation, but is in an order
|
|
|
+where the required fields are first.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|[...](http://php.net/manual/en/functions.arguments.php#functions.variable-arg-list)|$args|Arguments required by create.|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### json_set_property `Gogs\API\Request\User`
|
|
|
+```php
|
|
|
+protected function json_set_property(mixed $obj);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$obj|*None*|
|
|
|
+
|
|
|
+Returns: [true](#true-gogsapirequest) ***v*** array
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+### Users `Gogs\API\Request`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Gogs\API\Request\Collection](#collection-gogsapirequest)
|
|
|
+* Class implements
|
|
|
+ * [Gogs\Lib\ArrayIterator](#arrayiterator-gogslib)
|
|
|
+ * [Gogs\API\Request\RequestInterface](#requestinterface-gogsapirequest)
|
|
|
+
|
|
|
+Returns one or more users in the Gogs installation,
|
|
|
+depending on the called method.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[set_scope](#set_scope-gogsapirequestusers)|bool|protected| Set the scope for the request methods accepted by the child.|
|
|
|
+|[create](#create-gogsapirequestusers)|bool|public| Returns a new user object. If argumentsis specified the user will be "created".|
|
|
|
+|[get](#get-gogsapirequestusers)|object|public| Get object references by identifier.|
|
|
|
+|[search](#search-gogsapirequestusers)|[Collection](#collection-gogslib)|public| Search for an object.|
|
|
|
+|[json_set_property](#json_set_property-gogsapirequestusers)|[true](#true-gogsapirequest) ***v*** array|protected| Set properties for the current object.|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### set_scope `Gogs\API\Request\Users`
|
|
|
+```php
|
|
|
+protected function set_scope(string $method);
|
|
|
+```
|
|
|
+ Set the scope for the request methods accepted by the child.
|
|
|
+
|
|
|
+This can be
|
|
|
+ * `get`,
|
|
|
+ * `search`,
|
|
|
+ * `delete` etc.
|
|
|
+
|
|
|
+ Must return true if scope exists of false otherwise. Methods
|
|
|
+ the calls this will throw an exception if not true is returned.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$method|Method type, e.g "get"|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### create `Gogs\API\Request\Users`
|
|
|
+```php
|
|
|
+public function create(... $args);
|
|
|
+```
|
|
|
+ Returns a new user object. If arguments
|
|
|
+is specified the user will be "created".
|
|
|
+
|
|
|
+The arguments can be left out to "create" the
|
|
|
+user through the user object iteself.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|[...](http://php.net/manual/en/functions.arguments.php#functions.variable-arg-list)|$args|Arguments required by create.|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### get `Gogs\API\Request\Users`
|
|
|
+```php
|
|
|
+public function get(string $s = "");
|
|
|
+```
|
|
|
+ Get object references by identifier.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$s|The idientifier to look up|
|
|
|
+
|
|
|
+Returns: object
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### search `Gogs\API\Request\Users`
|
|
|
+```php
|
|
|
+public function search(array $params = array());
|
|
|
+```
|
|
|
+ Search for an object.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|array|$params|Parameters|
|
|
|
+
|
|
|
+Returns: [Collection](#collection-gogslib)
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### json_set_property `Gogs\API\Request\Users`
|
|
|
+```php
|
|
|
+protected function json_set_property(mixed $obj);
|
|
|
+```
|
|
|
+ Set properties for the current object.
|
|
|
+
|
|
|
+Each child class must implement this to set its data. Will
|
|
|
+be called by methods such as `load` and from collection
|
|
|
+classes.
|
|
|
+
|
|
|
+Will return true/false for singel objects but an array on collections.
|
|
|
+The array will contain the newly inserted elements. This to prevent
|
|
|
+additional iterations.
|
|
|
+
|
|
|
+This method should also set loaded to true or false, depending
|
|
|
+on success or failure.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$obj|*None*|
|
|
|
+
|
|
|
+Returns: [true](#true-gogsapirequest) ***v*** array
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## Interfaces
|
|
|
+
|
|
|
+### RequestInterface `Gogs\API\Request`
|
|
|
+
|
|
|
+Request interface, used by any kind of request object.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[load](#load-gogsapirequestrequestinterface)|object|public| Load object.|
|
|
|
+|[get](#get-gogsapirequestrequestinterface)|object|public| Get by identifier|
|
|
|
+|[create](#create-gogsapirequestrequestinterface)|bool|public| Create object|
|
|
|
+|[patch](#patch-gogsapirequestrequestinterface)|bool|public| Patch (update) object|
|
|
|
+|[delete](#delete-gogsapirequestrequestinterface)|bool|public| Delete object|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### load `Gogs\API\Request\RequestInterface`
|
|
|
+```php
|
|
|
+public function load(bool $force = false);
|
|
|
+```
|
|
|
+ Load object.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|bool|$force|Force update, default: true|
|
|
|
+
|
|
|
+Returns: object
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### get `Gogs\API\Request\RequestInterface`
|
|
|
+```php
|
|
|
+public function get(string $s);
|
|
|
+```
|
|
|
+ Get by identifier
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$s|The idientifier to look up|
|
|
|
+
|
|
|
+Returns: object
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### create `Gogs\API\Request\RequestInterface`
|
|
|
+```php
|
|
|
+public function create(... $args);
|
|
|
+```
|
|
|
+ Create object
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|[...](http://php.net/manual/en/functions.arguments.php#functions.variable-arg-list)|$args|Arguments required by create.|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### patch `Gogs\API\Request\RequestInterface`
|
|
|
+```php
|
|
|
+public function patch();
|
|
|
+```
|
|
|
+ Patch (update) object
|
|
|
+
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### delete `Gogs\API\Request\RequestInterface`
|
|
|
+```php
|
|
|
+public function delete();
|
|
|
+```
|
|
|
+ Delete object
|
|
|
+
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+# Gogs\API\Request\Exception
|
|
|
+
|
|
|
+## Exceptions
|
|
|
+
|
|
|
+### InvalidMethodRequestException `Gogs\API\Request\Exception`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Exception](https://www.google.no/search?q=Exception)
|
|
|
+
|
|
|
+Thrown whenever a class that inherits the base-class
|
|
|
+is used wrong (e.g tries to create on a loaded object)
|
|
|
+
|
|
|
+
|
|
|
+### NotImplementedException `Gogs\API\Request\Exception`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [BadMethodCallException](https://www.google.no/search?q=BadMethodCallException)
|
|
|
+
|
|
|
+Thrown when the requested method for a class isn't
|
|
|
+implemented.
|
|
|
+
|
|
|
+
|
|
|
+### RequestErrorException `Gogs\API\Request\Exception`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Exception](https://www.google.no/search?q=Exception)
|
|
|
+
|
|
|
+Typically thrown when needed data to build the query
|
|
|
+is missing.
|
|
|
+
|
|
|
+
|
|
|
+### SearchParamException `Gogs\API\Request\Exception`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Exception](https://www.google.no/search?q=Exception)
|
|
|
+
|
|
|
+Thrown when needed parameters for a search is missing.
|
|
|
+
|
|
|
+# Gogs\Lib
|
|
|
+
|
|
|
+## Classes
|
|
|
+
|
|
|
+### Collection `Gogs\Lib`
|
|
|
+
|
|
|
+
|
|
|
+* Class implements[Gogs\Lib\ArrayIterator](#arrayiterator-gogslib)
|
|
|
+
|
|
|
+Base class for collections. Implements basic
|
|
|
+functions and typically used to return collections
|
|
|
+which wont be a part of the "request package"
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[set](#set-gogslibcollection)||public| Set value(e) to the collection.|
|
|
|
+|[by_key](#by_key-gogslibcollection)|mixed|public| |
|
|
|
+|[all](#all-gogslibcollection)|array|public| |
|
|
|
+|[len](#len-gogslibcollection)|int|public| |
|
|
|
+|[next](#next-gogslibcollection)|mixed|public| |
|
|
|
+|[prev](#prev-gogslibcollection)|mixed|public| |
|
|
|
+|[current](#current-gogslibcollection)||public| |
|
|
|
+|[reset](#reset-gogslibcollection)|mixed|public| |
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### set `Gogs\Lib\Collection`
|
|
|
+```php
|
|
|
+public function set(mixed $val, mixed $key = null);
|
|
|
+```
|
|
|
+ Set value(e) to the collection.
|
|
|
+
|
|
|
+If the value is an array it will overwrite
|
|
|
+the whole object-array, aka everything.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$val|*None*|
|
|
|
+|mixed|$key|*None*|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### by_key `Gogs\Lib\Collection`
|
|
|
+```php
|
|
|
+public function by_key(mixed $idx);
|
|
|
+```
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$idx|Index key.|
|
|
|
+
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### all `Gogs\Lib\Collection`
|
|
|
+```php
|
|
|
+public function all();
|
|
|
+```
|
|
|
+
|
|
|
+Returns: array
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### len `Gogs\Lib\Collection`
|
|
|
+```php
|
|
|
+public function len();
|
|
|
+```
|
|
|
+
|
|
|
+Returns: int
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### next `Gogs\Lib\Collection`
|
|
|
+```php
|
|
|
+public function next();
|
|
|
+```
|
|
|
+
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### prev `Gogs\Lib\Collection`
|
|
|
+```php
|
|
|
+public function prev();
|
|
|
+```
|
|
|
+
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### current `Gogs\Lib\Collection`
|
|
|
+```php
|
|
|
+public function current();
|
|
|
+```
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### reset `Gogs\Lib\Collection`
|
|
|
+```php
|
|
|
+public function reset();
|
|
|
+```
|
|
|
+
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## Interfaces
|
|
|
+
|
|
|
+### ArrayIterator `Gogs\Lib`
|
|
|
+
|
|
|
+Interface to store one or more elements in array
|
|
|
+providing an iterator interface.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[current](#current-gogslibarrayiterator)||public| Get current element in collection.|
|
|
|
+|[next](#next-gogslibarrayiterator)|mixed|public| Get next element in collection.|
|
|
|
+|[prev](#prev-gogslibarrayiterator)|mixed|public| Return previous element in collection.|
|
|
|
+|[reset](#reset-gogslibarrayiterator)|mixed|public| Reset collection (set array to head).|
|
|
|
+|[len](#len-gogslibarrayiterator)|int|public| Return collection size.|
|
|
|
+|[all](#all-gogslibarrayiterator)|array|public| Return the whole colection.|
|
|
|
+|[by_key](#by_key-gogslibarrayiterator)|mixed|public| Get element by index key.|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### current `Gogs\Lib\ArrayIterator`
|
|
|
+```php
|
|
|
+public function current();
|
|
|
+```
|
|
|
+ Get current element in collection.
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### next `Gogs\Lib\ArrayIterator`
|
|
|
+```php
|
|
|
+public function next();
|
|
|
+```
|
|
|
+ Get next element in collection.
|
|
|
+
|
|
|
+
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### prev `Gogs\Lib\ArrayIterator`
|
|
|
+```php
|
|
|
+public function prev();
|
|
|
+```
|
|
|
+ Return previous element in collection.
|
|
|
+
|
|
|
+
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### reset `Gogs\Lib\ArrayIterator`
|
|
|
+```php
|
|
|
+public function reset();
|
|
|
+```
|
|
|
+ Reset collection (set array to head).
|
|
|
+
|
|
|
+
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### len `Gogs\Lib\ArrayIterator`
|
|
|
+```php
|
|
|
+public function len();
|
|
|
+```
|
|
|
+ Return collection size.
|
|
|
+
|
|
|
+
|
|
|
+Returns: int
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### all `Gogs\Lib\ArrayIterator`
|
|
|
+```php
|
|
|
+public function all();
|
|
|
+```
|
|
|
+ Return the whole colection.
|
|
|
+
|
|
|
+
|
|
|
+Returns: array
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### by_key `Gogs\Lib\ArrayIterator`
|
|
|
+```php
|
|
|
+public function by_key(mixed $idx);
|
|
|
+```
|
|
|
+ Get element by index key.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|mixed|$idx|Index key.|
|
|
|
+
|
|
|
+Returns: mixed
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+# Gogs\Lib\Curl
|
|
|
+
|
|
|
+## Traits
|
|
|
+
|
|
|
+### Client `Gogs\Lib\Curl`
|
|
|
+
|
|
|
+A trait used for every class referencing the api-url and token.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[method](#method-gogslibcurlclient)|int|protected| Initializes a curl request of different kinds, dependingon the specified method. This can be|
|
|
|
+|[authorized](#authorized-gogslibcurlclient)|bool|protected| Checks if the user is authorized for the scope. Shouldn'tbe used frequently. One test for one scope should be enough,but if you know for sure thats you're programming with theuse of an authorized user you should leave this and justhandle the NotAuthorizedExeption whenever thrown.|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### method `Gogs\Lib\Curl\Client`
|
|
|
+```php
|
|
|
+protected function method(string $method, string $req, string $scope, array $params, bool $ret);
|
|
|
+```
|
|
|
+ Initializes a curl request of different kinds, depending
|
|
|
+on the specified method. This can be
|
|
|
+
|
|
|
+DELETE, PATCH, POST or GET. An unidentified value will
|
|
|
+become a GET-request.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$method|either DELETE, PATCH, POST, GET|
|
|
|
+|string|$req|&$req variable to store request body in|
|
|
|
+|string|$scope|scope within the API (e.g /user/repos)|
|
|
|
+|array|$params|parameters to pass|
|
|
|
+|bool|$ret|return transfer|
|
|
|
+
|
|
|
+Returns: int
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### authorized `Gogs\Lib\Curl\Client`
|
|
|
+```php
|
|
|
+protected function authorized(string $scope = "");
|
|
|
+```
|
|
|
+ Checks if the user is authorized for the scope. Shouldn't
|
|
|
+be used frequently. One test for one scope should be enough,
|
|
|
+but if you know for sure thats you're programming with the
|
|
|
+use of an authorized user you should leave this and just
|
|
|
+handle the NotAuthorizedExeption whenever thrown.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$scope|the scope, a relative uri.|
|
|
|
+
|
|
|
+Returns: bool
|
|
|
+
|
|
|
+Throws:
|
|
|
+
|
|
|
+* [Not](#not-gogslibcurl "Exception: Gogs\Lib\Curl\Not")
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+# Gogs\Lib\Curl\Exception
|
|
|
+
|
|
|
+## Exceptions
|
|
|
+
|
|
|
+### HTTPUnexpectedResponse `Gogs\Lib\Curl\Exception`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Exception](https://www.google.no/search?q=Exception)
|
|
|
+
|
|
|
+Defines an unexpected response.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[__construct](#__construct-gogslibcurlexceptionhttpunexpectedresponse)||public| Sets the exceptions.|
|
|
|
+|[__toString](#__tostring-gogslibcurlexceptionhttpunexpectedresponse)|string|public| Visual representation of the exception.|
|
|
|
+|[getResponse](#getresponse-gogslibcurlexceptionhttpunexpectedresponse)|string|public| Get the actual response from the body or the request.|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### __construct `Gogs\Lib\Curl\Exception\HTTPUnexpectedResponse`
|
|
|
+```php
|
|
|
+public function __construct(string $message, int $code = -1, Exception $previous = null);
|
|
|
+```
|
|
|
+ Sets the exceptions.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$message|*None*|
|
|
|
+|int|$code|*None*|
|
|
|
+|Exception|$previous|*None*|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### __toString `Gogs\Lib\Curl\Exception\HTTPUnexpectedResponse`
|
|
|
+```php
|
|
|
+public function __toString();
|
|
|
+```
|
|
|
+ Visual representation of the exception.
|
|
|
+
|
|
|
+
|
|
|
+Returns: string
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+##### getResponse `Gogs\Lib\Curl\Exception\HTTPUnexpectedResponse`
|
|
|
+```php
|
|
|
+public function getResponse();
|
|
|
+```
|
|
|
+ Get the actual response from the body or the request.
|
|
|
+
|
|
|
+
|
|
|
+Returns: string
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+### NotAuthorizedException `Gogs\Lib\Curl\Exception`
|
|
|
+
|
|
|
+
|
|
|
+* Class extends [Gogs\Lib\Curl\Exception\HTTPUnexpectedResponse](#httpunexpectedresponse-gogslibcurlexception)
|
|
|
+
|
|
|
+When the request fails because of an unauthorized token,
|
|
|
+this is thrown instead.
|
|
|
+
|
|
|
+#### Methods
|
|
|
+
|
|
|
+|Name|Return|Access|Description|
|
|
|
+|:---|:---|:---|:---|
|
|
|
+|[__construct](#__construct-gogslibcurlexceptionnotauthorizedexception)||public| Sets the exceptions.|
|
|
|
+
|
|
|
+#### Method details
|
|
|
+
|
|
|
+##### __construct `Gogs\Lib\Curl\Exception\NotAuthorizedException`
|
|
|
+```php
|
|
|
+public function __construct(string $message, int $code = 401, Exception $previous = null);
|
|
|
+```
|
|
|
+ Sets the exceptions.
|
|
|
+
|
|
|
+
|
|
|
+Parameters
|
|
|
+
|
|
|
+| Type | Variable | Description |
|
|
|
+|---|---|---|
|
|
|
+|string|$message|*None*|
|
|
|
+|int|$code|*None*|
|
|
|
+|Exception|$previous|*None*|
|
|
|
+---
|
|
|
+
|
|
|
+
|
|
|
+ - Genetated using Sami and the [Sami/Twig Markdown Extension](https://git.giaever.org/joachimmg/sami-markdown)
|
|
|
+
|