ok
Mini Shell
<?php
declare(strict_types=1);
/*
* This file is part of the Gitlab API library.
*
* (c) Matt Humphrey <matth@windsor-telecom.co.uk>
* (c) Graham Campbell <hello@gjcampbell.co.uk>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Gitlab\Api;
use Symfony\Component\OptionsResolver\Exception\InvalidOptionsException;
use Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException;
use Symfony\Component\OptionsResolver\Options;
class MergeRequests extends AbstractApi
{
/**
* @var string
*/
public const STATE_ALL = 'all';
/**
* @var string
*/
public const STATE_MERGED = 'merged';
/**
* @var string
*/
public const STATE_OPENED = 'opened';
/**
* @var string
*/
public const STATE_CLOSED = 'closed';
/**
* @var string
*/
public const STATE_LOCKED = 'locked';
/**
* @param int|string|null $project_id
* @param array $parameters {
*
* @var int[] $iids return the request having the given iid
* @var string $state return all merge requests or just those that are opened, closed, or
* merged
* @var string $scope Return merge requests for the given scope: created-by-me,
* assigned-to-me or all (default is created-by-me)
* @var string $order_by return requests ordered by created_at or updated_at fields (default is created_at)
* @var string $sort return requests sorted in asc or desc order (default is desc)
* @var string $milestone return merge requests for a specific milestone
* @var string $view if simple, returns the iid, URL, title, description, and basic state of merge request
* @var string $labels return merge requests matching a comma separated list of labels
* @var \DateTimeInterface $created_after return merge requests created after the given time (inclusive)
* @var \DateTimeInterface $created_before return merge requests created before the given time (inclusive)
* @var int $reviewer_id return merge requests which have the user as a reviewer with the given user id
* @var bool $wip return only draft merge requests (true) or only non-draft merge requests (false)
* }
*
* @throws UndefinedOptionsException if an option name is undefined
* @throws InvalidOptionsException if an option doesn't fulfill the specified validation rules
*
* @return mixed
*/
public function all($project_id = null, array $parameters = [])
{
$resolver = $this->createOptionsResolver();
$datetimeNormalizer = function (Options $resolver, \DateTimeInterface $value): string {
return $value->format('c');
};
$resolver->setDefined('iids')
->setAllowedTypes('iids', 'array')
->setAllowedValues('iids', function (array $value) {
return \count($value) === \count(\array_filter($value, 'is_int'));
})
;
$resolver->setDefined('state')
->setAllowedValues('state', [self::STATE_ALL, self::STATE_MERGED, self::STATE_OPENED, self::STATE_CLOSED, self::STATE_LOCKED])
;
$resolver->setDefined('scope')
->setAllowedValues('scope', ['created-by-me', 'assigned-to-me', 'all'])
;
$resolver->setDefined('order_by')
->setAllowedValues('order_by', ['created_at', 'updated_at'])
;
$resolver->setDefined('sort')
->setAllowedValues('sort', ['asc', 'desc'])
;
$resolver->setDefined('milestone');
$resolver->setDefined('view')
->setAllowedValues('view', ['simple'])
;
$resolver->setDefined('labels');
$resolver->setDefined('created_after')
->setAllowedTypes('created_after', \DateTimeInterface::class)
->setNormalizer('created_after', $datetimeNormalizer)
;
$resolver->setDefined('created_before')
->setAllowedTypes('created_before', \DateTimeInterface::class)
->setNormalizer('created_before', $datetimeNormalizer)
;
$resolver->setDefined('updated_after')
->setAllowedTypes('updated_after', \DateTimeInterface::class)
->setNormalizer('updated_after', $datetimeNormalizer)
;
$resolver->setDefined('updated_before')
->setAllowedTypes('updated_before', \DateTimeInterface::class)
->setNormalizer('updated_before', $datetimeNormalizer)
;
$resolver->setDefined('scope')
->setAllowedValues('scope', ['created_by_me', 'assigned_to_me', 'all'])
;
$resolver->setDefined('author_id')
->setAllowedTypes('author_id', 'integer');
$resolver->setDefined('assignee_id')
->setAllowedTypes('assignee_id', 'integer');
$resolver->setDefined('search');
$resolver->setDefined('source_branch');
$resolver->setDefined('target_branch');
$resolver->setDefined('with_merge_status_recheck')
->setAllowedTypes('with_merge_status_recheck', 'bool')
;
$resolver->setDefined('approved_by_ids')
->setAllowedTypes('approved_by_ids', 'array')
->setAllowedValues('approved_by_ids', function (array $value) {
return \count($value) === \count(\array_filter($value, 'is_int'));
})
;
$resolver->setDefined('reviewer_id')
->setAllowedTypes('reviewer_id', 'integer');
$resolver->setDefined('wip')
->setAllowedTypes('wip', 'boolean')
->addNormalizer('wip', static function ($resolver, $wip) {
return $wip ? 'yes' : 'no';
});
$path = null === $project_id ? 'merge_requests' : $this->getProjectPath($project_id, 'merge_requests');
return $this->get($path, $resolver->resolve($parameters));
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param array $parameters {
*
* @var bool $include_diverged_commits_count Return the commits behind the target branch
* @var bool $include_rebase_in_progress Return whether a rebase operation is in progress
* }
*
* @return mixed
*/
public function show($project_id, int $mr_iid, array $parameters = [])
{
$resolver = $this->createOptionsResolver();
$resolver->setDefined('include_diverged_commits_count')
->setAllowedTypes('include_diverged_commits_count', 'bool')
;
$resolver->setDefined('include_rebase_in_progress')
->setAllowedTypes('include_rebase_in_progress', 'bool')
;
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid)), $resolver->resolve($parameters));
}
/**
* @param int|string $project_id
* @param string $source
* @param string $target
* @param string $title
* @param array<string,mixed> $parameters {
*
* @var int $assignee_id the assignee id
* @var int|string $target_project_id the target project id
* @var string $description the description
* }
*
* @return mixed
*/
public function create($project_id, string $source, string $target, string $title, array $parameters = [])
{
$baseParams = [
'source_branch' => $source,
'target_branch' => $target,
'title' => $title,
];
return $this->post(
$this->getProjectPath($project_id, 'merge_requests'),
\array_merge($baseParams, $parameters)
);
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param array $parameters
*
* @return mixed
*/
public function update($project_id, int $mr_iid, array $parameters)
{
return $this->put($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid)), $parameters);
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param array $parameters
*
* @return mixed
*/
public function merge($project_id, int $mr_iid, array $parameters = [])
{
return $this->put($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/merge'), $parameters);
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function showNotes($project_id, int $mr_iid)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/notes'));
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param int $note_id
*
* @return mixed
*/
public function showNote($project_id, int $mr_iid, int $note_id)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/notes/'.self::encodePath($note_id)));
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param string $body
* @param array $params
*
* @return mixed
*/
public function addNote($project_id, int $mr_iid, string $body, array $params = [])
{
$params['body'] = $body;
return $this->post($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/notes'), $params);
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param int $note_id
* @param string $body
*
* @return mixed
*/
public function updateNote($project_id, int $mr_iid, int $note_id, string $body)
{
return $this->put($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/notes/'.self::encodePath($note_id)), [
'body' => $body,
]);
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param int $note_id
*
* @return mixed
*/
public function removeNote($project_id, int $mr_iid, int $note_id)
{
return $this->delete($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/notes/'.self::encodePath($note_id)));
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function showDiscussions($project_id, int $mr_iid)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid)).'/discussions');
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param string $discussion_id
*
* @return mixed
*/
public function showDiscussion($project_id, int $mr_iid, string $discussion_id)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid)).'/discussions/'.self::encodePath($discussion_id));
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param array $params
*
* @return mixed
*/
public function addDiscussion($project_id, int $mr_iid, array $params)
{
return $this->post($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/discussions'), $params);
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param string $discussion_id
* @param bool $resolved
*
* @return mixed
*/
public function resolveDiscussion($project_id, int $mr_iid, string $discussion_id, bool $resolved = true)
{
return $this->put($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/discussions/'.self::encodePath($discussion_id)), [
'resolved' => $resolved,
]);
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param string $discussion_id
* @param string $body
*
* @return mixed
*/
public function addDiscussionNote($project_id, int $mr_iid, string $discussion_id, string $body)
{
return $this->post($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/discussions/'.self::encodePath($discussion_id).'/notes'), ['body' => $body]);
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param string $discussion_id
* @param int $note_id
* @param array $params
*
* @return mixed
*/
public function updateDiscussionNote($project_id, int $mr_iid, string $discussion_id, int $note_id, array $params)
{
return $this->put($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/discussions/'.self::encodePath($discussion_id).'/notes/'.self::encodePath($note_id)), $params);
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param string $discussion_id
* @param int $note_id
*
* @return mixed
*/
public function removeDiscussionNote($project_id, int $mr_iid, string $discussion_id, int $note_id)
{
return $this->delete($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/discussions/'.self::encodePath($discussion_id).'/notes/'.self::encodePath($note_id)));
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function changes($project_id, int $mr_iid)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/changes'));
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function commits($project_id, int $mr_iid)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/commits'));
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function closesIssues($project_id, int $mr_iid)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/closes_issues'));
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function approvals($project_id, int $mr_iid)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/approvals'));
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function approve($project_id, int $mr_iid)
{
return $this->post($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/approve'));
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function unapprove($project_id, int $mr_iid)
{
return $this->post($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/unapprove'));
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function awardEmoji($project_id, int $mr_iid)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/award_emoji'));
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param int $award_id
*
* @return mixed
*/
public function removeAwardEmoji($project_id, int $mr_iid, int $award_id)
{
return $this->delete($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/award_emoji/'.self::encodePath($award_id)));
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param array $params
*
* @return mixed
*/
public function rebase($project_id, int $mr_iid, array $params = [])
{
$resolver = $this->createOptionsResolver();
$resolver->setDefined('skip_ci')
->setAllowedTypes('skip_ci', 'bool');
return $this->put($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid)).'/rebase', $resolver->resolve($params));
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function approvalState($project_id, int $mr_iid)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/approval_state'));
}
/**
* @param int|string $project_id
* @param int $mr_iid
*
* @return mixed
*/
public function levelRules($project_id, int $mr_iid)
{
return $this->get($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/approval_rules'));
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param string $name
* @param int $approvals_required
* @param array<string,mixed> $parameters
*
* @return mixed
*/
public function createLevelRule($project_id, int $mr_iid, string $name, int $approvals_required, array $parameters = [])
{
$baseParam = [
'name' => $name,
'approvals_required' => $approvals_required,
];
return $this->post(
$this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/approval_rules'),
\array_merge($baseParam, $parameters)
);
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param int $approval_rule_id
* @param string $name
* @param int $approvals_required
* @param array<string,mixed> $parameters
*
* @return mixed
*/
public function updateLevelRule($project_id, int $mr_iid, int $approval_rule_id, string $name, int $approvals_required, array $parameters = [])
{
$baseParam = [
'name' => $name,
'approvals_required' => $approvals_required,
];
return $this->put(
$this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/approval_rules/'.self::encodePath($approval_rule_id)),
\array_merge($baseParam, $parameters)
);
}
/**
* @param int|string $project_id
* @param int $mr_iid
* @param int $approval_rule_id
*
* @return mixed
*/
public function deleteLevelRule($project_id, int $mr_iid, int $approval_rule_id)
{
return $this->delete($this->getProjectPath($project_id, 'merge_requests/'.self::encodePath($mr_iid).'/approval_rules/'.self::encodePath($approval_rule_id)));
}
}
Zerion Mini Shell 1.0