Commits
Extends AbstractPackageGitHub API Repositories Commits class for the Joomla Framework.
| link | |
|---|---|
| since |
1.0 |
| package |
Joomla Framework |
Methods
__construct
Constructor.
__construct(\Joomla\Registry\Registry options = null, \Joomla\Http\Http client = null) :
__get
Magic method to lazily create API objects
__get( name) : \Joomla\Github\AbstractPackage
| since |
1.0 |
|---|---|
| throws |
|
Arguments
- name
stringName of property to retrieve
Response
AbstractPackageGitHub API package object.
compare
Compare two commits.
compare( user, repo, base, head) :
| since |
1.0 |
|---|
Arguments
- user
stringThe name of the owner of the GitHub repository.- repo
stringThe name of the GitHub repository.- base
stringThe base of the diff, either a commit SHA or branch.- head
stringThe head of the diff, either a commit SHA or branch.
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( path, page, limit) : \Joomla\Uri\Uri
| since |
1.0 |
|---|
Arguments
- path
stringURL to inflect- page
intPage to request- limit
intNumber of results to return per page
Response
get
Get a single commit.
get( user, repo, sha) :
| since |
1.0 |
|---|---|
| throws |
|
Arguments
- user
stringThe name of the owner of the GitHub repository.- repo
stringThe name of the GitHub repository.- sha
stringThe SHA of the commit to retrieve.
Response
object
getList
List commits on a repository.
getList( user, repo, sha = '', path = '', author = '', \DateTimeInterface since = null, \DateTimeInterface until = null) :
A special note on pagination: Due to the way Git works, commits are paginated based on SHA instead of page number. Please follow the link headers as outlined in the pagination overview instead of constructing page links yourself.
| since |
1.0 |
|---|---|
| throws |
|
Arguments
- user
stringThe name of the owner of the GitHub repository.- repo
stringThe name of the GitHub repository.- sha
stringSha or branch to start listing commits from.- path
stringOnly commits containing this file path will be returned.- author
stringGitHub login, name, or email by which to filter by commit author.- since
DateTimeInterface|nullISO 8601 Date - Only commits after this date will be returned.- until
DateTimeInterface|nullISO 8601 Date - Only commits before this date will be returned.
Response
object
getSha
Get the SHA-1 of a commit reference.
getSha( user, repo, ref) :
| since |
1.4.0 |
|---|---|
| throws |
Arguments
- user
stringThe name of the owner of the GitHub repository.- repo
stringThe name of the GitHub repository.- ref
stringThe commit reference
Response
string
processResponse
Process the response and decode it.
processResponse(\Joomla\Http\Response response, expectedCode = 200) :
| since |
1.0 |
|---|---|
| throws |
Arguments
- response
ResponseThe response.- expectedCode
intThe expected "good" code.
Response
mixed
Properties
package
The package the object resides in
| since |
1.0 |
|---|
Type(s)
string
hookEvents
Array containing the allowed hook events
| since |
1.5.2 |
|---|---|
| link | |
| note |
From 1.4.0 to 1.5.1 this was named $events, it was renamed due to naming conflicts with package subclasses |
Type(s)
array<string|int, mixed>