JGithubPackageIssuesComments
Extends \JGithubPackageGitHub API Comments class for the Joomla Platform.
The Issue Comments API supports listing, viewing, editing, and creating comments on issues and pull requests.
documentation | |
---|---|
since |
3.1.4 |
deprecated |
4.0 Use the |
package |
Joomla.Platform |
Methods
__construct
Constructor.
__construct(\Joomla\Registry\Registry $options = null, \JGithubHttp $client = null)
since |
1.7.3 |
---|
Arguments
- $options
\Joomla\Registry\Registry
GitHub options object.- $client
\JGithubHttp
The HTTP client object.
__get
Magic method to lazily create API objects
__get(string $name) : \JGithubPackage
since |
3.3 |
---|---|
throws |
|
Arguments
- $name
string
Name of property to retrieve
Response
\JGithubPackage
GitHub API package object.
create
Method to create a comment on an issue.
create(string $user, string $repo, integer $issueId, string $body) : object
throws |
|
---|---|
since |
1.7.3 |
Arguments
- $user
string
The name of the owner of the GitHub repository.- $repo
string
The name of the GitHub repository.- $issueId
integer
The issue number.- $body
string
The comment body text.
Response
object
delete
Method to delete a comment on an issue.
delete(string $user, string $repo, integer $commentId) : boolean
throws |
|
---|---|
since |
1.7.3 |
Arguments
- $user
string
The name of the owner of the GitHub repository.- $repo
string
The name of the GitHub repository.- $commentId
integer
The id of the comment to delete.
Response
boolean
edit
Method to update a comment on an issue.
edit(string $user, string $repo, integer $commentId, string $body) : object
since |
1.7.3 |
---|---|
throws |
|
Arguments
- $user
string
The name of the owner of the GitHub repository.- $repo
string
The name of the GitHub repository.- $commentId
integer
The id of the comment to update.- $body
string
The new body text for the comment.
Response
object
fetchUrl
Method to build and return a full request URL for the request. This method will add appropriate pagination details if necessary and also prepend the API url to have a complete URL for the request.
fetchUrl(string $path, integer $page, integer $limit) : string
since |
1.7.3 |
---|
Arguments
- $path
string
URL to inflect- $page
integer
Page to request- $limit
integer
Number of results to return per page
Response
string
The request URL.
get
Method to get a single comment.
get(string $owner, string $repo, integer $id) : mixed
Arguments
- $owner
string
The name of the owner of the GitHub repository.- $repo
string
The name of the GitHub repository.- $id
integer
The comment id.
Response
mixed
getList
Method to get the list of comments on an issue.
getList(string $owner, string $repo, integer $issueId, integer $page, integer $limit) : array
throws |
|
---|---|
since |
1.7.3 |
Arguments
- $owner
string
The name of the owner of the GitHub repository.- $repo
string
The name of the GitHub repository.- $issueId
integer
The issue number.- $page
integer
The page number from which to get items.- $limit
integer
The number of items on a page.
Response
array
getRepositoryList
Method to get the list of comments in a repository.
getRepositoryList(string $owner, string $repo, string $sort = 'created', string $direction = 'asc', \JDate $since = null) : array
throws |
|
---|---|
since |
1.7.3 |
Arguments
- $owner
string
The name of the owner of the GitHub repository.- $repo
string
The name of the GitHub repository.- $sort
string
The sort field - created or updated.- $direction
string
The sort order- asc or desc. Ignored without sort parameter.- $since
\JDate
A timestamp in ISO 8601 format.
Response
array
processResponse
Process the response and decode it.
processResponse(\JHttpResponse $response, integer $expectedCode = 200, boolean $decode = true) : mixed
throws |
|
---|---|
since |
3.3.0 |
Arguments
- $response
\JHttpResponse
The response.- $expectedCode
integer
The expected "good" code.- $decode
boolean
If the should be response be JSON decoded.
Response
mixed
Properties
name
since |
3.3 |
---|
Type(s)
string
packages
since |
3.3 |
---|
Type(s)
array
client
The HTTP client object to use in sending HTTP requests.