"""Manager for the Sidekiq methods.

def __init__(self, gl):

"""Constructs a Sidekiq manager.

self.gitlab = gl

def _simple_get(self, url, **kwargs):

r = self.gitlab._raw_get(url, **kwargs)

raise_error_from_response(r, GitlabGetError)

return r.json()

def queue_metrics(self, **kwargs):

"""Returns the registred queues information."""

return self._simple_get('/sidekiq/queue_metrics', **kwargs)

def process_metrics(self, **kwargs):

"""Returns the registred sidekiq workers."""

return self._simple_get('/sidekiq/process_metrics', **kwargs)

def job_stats(self, **kwargs):

"""Returns statistics about the jobs performed."""

return self._simple_get('/sidekiq/job_stats', **kwargs)

def compound_metrics(self, **kwargs):

"""Returns all available metrics and statistics."""

_url = '/users/%(user_id)s/emails'

canUpdate = False

shortPrintAttr = 'email'

requiredUrlAttrs = ['user_id']

_url = '/users/%(user_id)s/keys'

canGet = 'from_list'

canUpdate = False

requiredUrlAttrs = ['user_id']

_url = '/projects/user/%(user_id)s'

_constructorTypes = {'owner': 'User', 'namespace': 'Group'}

canUpdate = False

canDelete = False

canList = False

canGet = False

requiredUrlAttrs = ['user_id']

requiredCreateAttrs = ['name']

optionalCreateAttrs = ['default_branch', 'issues_enabled', 'wall_enabled',

'merge_requests_enabled', 'wiki_enabled',

'snippets_enabled', 'public', 'visibility_level',

'description', 'builds_enabled', 'public_builds',

_url = '/users'

shortPrintAttr = 'username'

requiredCreateAttrs = ['email', 'username', 'name']

optionalCreateAttrs = ['password', 'reset_password', 'skype', 'linkedin',

'twitter', 'projects_limit', 'extern_uid',

'provider', 'bio', 'admin', 'can_create_group',

'website_url', 'confirm', 'external',

'organization', 'location']

requiredUpdateAttrs = ['email', 'username', 'name']

optionalUpdateAttrs = ['password', 'skype', 'linkedin', 'twitter',

'projects_limit', 'extern_uid', 'provider', 'bio',

'admin', 'can_create_group', 'website_url',

'confirm', 'external', 'organization', 'location']

managers = (

('emails', 'UserEmailManager', [('user_id', 'id')]),

('keys', 'UserKeyManager', [('user_id', 'id')]),

('projects', 'UserProjectManager', [('user_id', 'id')]),

)

def _data_for_gitlab(self, extra_parameters={}, update=False,

as_json=True):

if hasattr(self, 'confirm'):

self.confirm = str(self.confirm).lower()

return super(User, self)._data_for_gitlab(extra_parameters)

def block(self, **kwargs):

"""Blocks the user."""

url = '/users/%s/block' % self.id

r = self.gitlab._raw_put(url, **kwargs)

raise_error_from_response(r, GitlabBlockError)

self.state = 'blocked'

def unblock(self, **kwargs):

"""Unblocks the user."""

url = '/users/%s/unblock' % self.id

r = self.gitlab._raw_put(url, **kwargs)

raise_error_from_response(r, GitlabUnblockError)

self.state = 'active'

def __eq__(self, other):

if type(other) is type(self):

selfdict = self.as_dict()

otherdict = other.as_dict()

selfdict.pop('password', None)

otherdict.pop('password', None)

return selfdict == otherdict

obj_cls = User

def search(self, query, **kwargs):

"""Search users.

url = self.obj_cls._url + '?search=' + query

return self.gitlab._raw_list(url, self.obj_cls, **kwargs)

def get_by_username(self, username, **kwargs):

"""Get a user by its username.

url = self.obj_cls._url + '?username=' + username

results = self.gitlab._raw_list(url, self.obj_cls, **kwargs)

assert len(results) in (0, 1)

try:

return results[0]

except IndexError:

_url = '/user/emails'

canUpdate = False

shortPrintAttr = 'email'

_url = '/user/keys'

canUpdate = False

shortPrintAttr = 'title'

_url = '/user'

canList = False

canCreate = False

canUpdate = False

canDelete = False

shortPrintAttr = 'username'

managers = (

('emails', 'CurrentUserEmailManager', [('user_id', 'id')]),

('keys', 'CurrentUserKeyManager', [('user_id', 'id')]),

_url = '/application/settings'

_id_in_update_url = False

getRequiresId = False

optionalUpdateAttrs = ['after_sign_out_path',

'container_registry_token_expire_delay',

'default_branch_protection',

'default_project_visibility',

'default_projects_limit',

'default_snippet_visibility',

'domain_blacklist',

'domain_blacklist_enabled',

'domain_whitelist',

'enabled_git_access_protocol',

'gravatar_enabled',

'home_page_url',

'max_attachment_size',

'repository_storage',

'restricted_signup_domains',

'restricted_visibility_levels',

'session_expire_delay',

'sign_in_text',

'signin_enabled',

'signup_enabled',

'twitter_sharing_enabled',

'user_oauth_applications']

canList = False

canCreate = False

canDelete = False

def _data_for_gitlab(self, extra_parameters={}, update=False,

as_json=True):

data = (super(ApplicationSettings, self)

._data_for_gitlab(extra_parameters, update=update,

as_json=False))

if not self.domain_whitelist:

data.pop('domain_whitelist', None)

_url = '/broadcast_messages'

requiredCreateAttrs = ['message']

optionalCreateAttrs = ['starts_at', 'ends_at', 'color', 'font']

requiredUpdateAttrs = []

_url = '/deploy_keys'

canGet = 'from_list'

canCreate = False

canUpdate = False

canDelete = False

def __init__(self, *args, **kwargs):

warnings.warn("`Key` is deprecated, use `DeployKey` instead",

DeprecationWarning)

_url = '/deploy_keys'

canGet = 'from_list'

canCreate = False

canUpdate = False

_url = '/notification_settings'

_id_in_update_url = False

getRequiresId = False

optionalUpdateAttrs = ['level',

'notification_email',

'new_note',

'new_issue',

'reopen_issue',

'close_issue',

'reassign_issue',

'new_merge_request',

'reopen_merge_request',

'close_merge_request',

'reassign_merge_request',

'merge_merge_request']

canList = False

canCreate = False

_url = '/templates/gitignores'

canDelete = False

canUpdate = False

canCreate = False

_url = '/templates/gitlab_ci_ymls'

canDelete = False

canUpdate = False

canCreate = False

_url = '/groups/%(group_id)s/issues'

canGet = 'from_list'

canCreate = False

canUpdate = False

canDelete = False

requiredUrlAttrs = ['group_id']

_url = '/groups/%(group_id)s/members'

canGet = 'from_list'

requiredUrlAttrs = ['group_id']

requiredCreateAttrs = ['access_level', 'user_id']

optionalCreateAttrs = ['expires_at']

requiredUpdateAttrs = ['access_level']

optionalCreateAttrs = ['expires_at']

shortPrintAttr = 'username'

def _update(self, **kwargs):

self.user_id = self.id

_url = '/groups/%(group_id)s/access_requests'

canGet = 'from_list'

canUpdate = False

def approve(self, access_level=gitlab.DEVELOPER_ACCESS, **kwargs):

"""Approve an access request.

url = ('/groups/%(group_id)s/access_requests/%(id)s/approve' %

{'group_id': self.group_id, 'id': self.id})

data = {'access_level': access_level}

r = self.gitlab._raw_put(url, data=data, **kwargs)

raise_error_from_response(r, GitlabUpdateError, 201)

_url = '/hooks'

canUpdate = False

requiredCreateAttrs = ['url']

_url = '/issues'

_constructorTypes = {'author': 'User', 'assignee': 'User',

'milestone': 'ProjectMilestone'}

canGet = 'from_list'

canDelete = False

canUpdate = False

canCreate = False

shortPrintAttr = 'title'

_url = '/licenses'

canDelete = False

canUpdate = False

canCreate = False

idAttr = 'key'

optionalListAttrs = ['popular']

_url = '/snippets'

_constructorTypes = {'author': 'User'}

requiredCreateAttrs = ['title', 'file_name', 'content']

optionalCreateAttrs = ['lifetime', 'visibility_level']

optionalUpdateAttrs = ['title', 'file_name', 'content', 'visibility_level']

shortPrintAttr = 'title'

def raw(self, streamed=False, action=None, chunk_size=1024, **kwargs):

"""Return the raw content of a snippet.

url = ("/snippets/%(snippet_id)s/raw" % {'snippet_id': self.id})

r = self.gitlab._raw_get(url, **kwargs)

raise_error_from_response(r, GitlabGetError)

obj_cls = Snippet

def public(self, **kwargs):

"""List all the public snippets.

_url = '/namespaces'

canGet = 'from_list'

canUpdate = False

canDelete = False

canCreate = False

_url = '/projects/%(project_id)s/boards/%(board_id)s/lists'

requiredUrlAttrs = ['project_id', 'board_id']

_constructorTypes = {'label': 'ProjectLabel'}

requiredCreateAttrs = ['label_id']

_url = '/projects/%(project_id)s/boards'

requiredUrlAttrs = ['project_id']

_constructorTypes = {'labels': 'ProjectBoardList'}

canGet = 'from_list'

canUpdate = False

canCreate = False

canDelete = False

managers = (

('lists', 'ProjectBoardListManager',

[('project_id', 'project_id'), ('board_id', 'id')]),

_url = '/projects/%(project_id)s/repository/branches'

_constructorTypes = {'author': 'User', "committer": "User"}

idAttr = 'name'

canUpdate = False

requiredUrlAttrs = ['project_id']

requiredCreateAttrs = ['branch_name', 'ref']

def protect(self, protect=True, **kwargs):

"""Protects the branch."""

url = self._url % {'project_id': self.project_id}

action = 'protect' if protect else 'unprotect'

url = "%s/%s/%s" % (url, self.name, action)

r = self.gitlab._raw_put(url, data=None, content_type=None, **kwargs)

raise_error_from_response(r, GitlabProtectError)

if protect:

self.protected = protect

else:

del self.protected

def unprotect(self, **kwargs):

"""Unprotects the branch."""

_url = '/projects/%(project_id)s/builds'

_constructorTypes = {'user': 'User',

'commit': 'ProjectCommit',

'runner': 'Runner'}

requiredUrlAttrs = ['project_id']

canDelete = False

canUpdate = False

canCreate = False

def cancel(self, **kwargs):

"""Cancel the build."""

url = '/projects/%s/builds/%s/cancel' % (self.project_id, self.id)

r = self.gitlab._raw_post(url)

raise_error_from_response(r, GitlabBuildCancelError, 201)

def retry(self, **kwargs):

"""Retry the build."""

url = '/projects/%s/builds/%s/retry' % (self.project_id, self.id)

r = self.gitlab._raw_post(url)

raise_error_from_response(r, GitlabBuildRetryError, 201)

def play(self, **kwargs):

"""Trigger a build explicitly."""

url = '/projects/%s/builds/%s/play' % (self.project_id, self.id)

r = self.gitlab._raw_post(url)

raise_error_from_response(r, GitlabBuildPlayError)

def erase(self, **kwargs):

"""Erase the build (remove build artifacts and trace)."""

url = '/projects/%s/builds/%s/erase' % (self.project_id, self.id)

r = self.gitlab._raw_post(url)

raise_error_from_response(r, GitlabBuildEraseError, 201)

def keep_artifacts(self, **kwargs):

"""Prevent artifacts from being delete when expiration is set.

url = ('/projects/%s/builds/%s/artifacts/keep' %

(self.project_id, self.id))

r = self.gitlab._raw_post(url)

raise_error_from_response(r, GitlabGetError, 200)

def artifacts(self, streamed=False, action=None, chunk_size=1024,

**kwargs):

"""Get the build artifacts.

url = '/projects/%s/builds/%s/artifacts' % (self.project_id, self.id)

r = self.gitlab._raw_get(url, streamed=streamed, **kwargs)

raise_error_from_response(r, GitlabGetError, 200)

return utils.response_content(r, streamed, action, chunk_size)

def trace(self, streamed=False, action=None, chunk_size=1024, **kwargs):

"""Get the build trace.

url = '/projects/%s/builds/%s/trace' % (self.project_id, self.id)

r = self.gitlab._raw_get(url, streamed=streamed, **kwargs)

raise_error_from_response(r, GitlabGetError, 200)

_url = '/projects/%(project_id)s/repository/commits/%(commit_id)s/statuses'

_create_url = '/projects/%(project_id)s/statuses/%(commit_id)s'

canUpdate = False

canDelete = False

requiredUrlAttrs = ['project_id', 'commit_id']

optionalGetAttrs = ['ref_name', 'stage', 'name', 'all']

requiredCreateAttrs = ['state']

optionalCreateAttrs = ['description', 'name', 'context', 'ref',

_url = '/projects/%(project_id)s/repository/commits/%(commit_id)s/comments'

canUpdate = False

canGet = False

canDelete = False

requiredUrlAttrs = ['project_id', 'commit_id']

requiredCreateAttrs = ['note']

_url = '/projects/%(project_id)s/repository/commits'

canDelete = False

canUpdate = False

requiredUrlAttrs = ['project_id']

requiredCreateAttrs = ['branch_name', 'commit_message', 'actions']

optionalCreateAttrs = ['author_email', 'author_name']

shortPrintAttr = 'title'

managers = (

('comments', 'ProjectCommitCommentManager',

[('project_id', 'project_id'), ('commit_id', 'id')]),

('statuses', 'ProjectCommitStatusManager',

[('project_id', 'project_id'), ('commit_id', 'id')]),

)

def diff(self, **kwargs):

"""Generate the commit diff."""

url = ('/projects/%(project_id)s/repository/commits/%(commit_id)s/diff'

% {'project_id': self.project_id, 'commit_id': self.id})

r = self.gitlab._raw_get(url, **kwargs)

raise_error_from_response(r, GitlabGetError)

return r.json()

def blob(self, filepath, streamed=False, action=None, chunk_size=1024,

**kwargs):

"""Generate the content of a file for this commit.

url = ('/projects/%(project_id)s/repository/blobs/%(commit_id)s' %

{'project_id': self.project_id, 'commit_id': self.id})

url += '?filepath=%s' % filepath

r = self.gitlab._raw_get(url, streamed=streamed, **kwargs)

raise_error_from_response(r, GitlabGetError)

return utils.response_content(r, streamed, action, chunk_size)

def builds(self, **kwargs):

"""List the build for this commit.

url = '/projects/%s/repository/commits/%s/builds' % (self.project_id,

self.id)

return self.gitlab._raw_list(url, ProjectBuild, **kwargs)

def cherry_pick(self, branch, **kwargs):

"""Cherry-pick a commit into a branch.

url = ('/projects/%s/repository/commits/%s/cherry_pick' %

(self.project_id, self.id))

r = self.gitlab._raw_post(url, data={'project_id': self.project_id,

'branch': branch}, **kwargs)

errors = {400: GitlabCherryPickError}

_url = '/projects/%(project_id)s/environments'

canGet = 'from_list'

requiredUrlAttrs = ['project_id']

requiredCreateAttrs = ['name']

optionalCreateAttrs = ['external_url']

_url = '/projects/%(project_id)s/keys'

canUpdate = False

requiredUrlAttrs = ['project_id']

obj_cls = ProjectKey

def enable(self, key_id):

"""Enable a deploy key for a project."""

url = '/projects/%s/deploy_keys/%s/enable' % (self.parent.id, key_id)

r = self.gitlab._raw_post(url)

raise_error_from_response(r, GitlabProjectDeployKeyError, 201)

def disable(self, key_id):

"""Disable a deploy key for a project."""

url = '/projects/%s/deploy_keys/%s/disable' % (self.parent.id, key_id)

r = self.gitlab._raw_delete(url)

_url = '/projects/%(project_id)s/events'

canGet = 'from_list'

canDelete = False

canUpdate = False

canCreate = False

requiredUrlAttrs = ['project_id']

_url = '/projects/fork/%(project_id)s'

canUpdate = False

canDelete = False

canList = False

canGet = False

requiredUrlAttrs = ['project_id']

_url = '/projects/%(project_id)s/hooks'

requiredUrlAttrs = ['project_id']

requiredCreateAttrs = ['url']

optionalCreateAttrs = ['push_events', 'issues_events', 'note_events',

'merge_requests_events', 'tag_push_events',

'build_events', 'enable_ssl_verification', 'token',

'pipeline_events']

_url = '/projects/%(project_id)s/issues/%(issue_id)s/notes'

_constructorTypes = {'author': 'User'}

canDelete = False

requiredUrlAttrs = ['project_id', 'issue_id']

requiredCreateAttrs = ['body']

optionalCreateAttrs = ['created_at']

# file attachment settings (see #56)

description_attr = "body"

_url = '/projects/%(project_id)s/issues/'

_constructorTypes = {'author': 'User', 'assignee': 'User',

'milestone': 'ProjectMilestone'}

optionalListAttrs = ['state', 'labels', 'milestone', 'iid', 'order_by',

'sort']

requiredUrlAttrs = ['project_id']

requiredCreateAttrs = ['title']

optionalCreateAttrs = ['description', 'assignee_id', 'milestone_id',

'labels', 'created_at', 'due_date']

optionalUpdateAttrs = ['title', 'description', 'assignee_id',

'milestone_id', 'labels', 'created_at',

'updated_at', 'state_event', 'due_date']

shortPrintAttr = 'title'

managers = (

('notes', 'ProjectIssueNoteManager',

[('project_id', 'project_id'), ('issue_id', 'id')]),

)

# file attachment settings (see #56)

description_attr = "description"

project_id_attr = "project_id"

def subscribe(self, **kwargs):

"""Subscribe to an issue.

url = ('/projects/%(project_id)s/issues/%(issue_id)s/subscription' %

{'project_id': self.project_id, 'issue_id': self.id})

r = self.gitlab._raw_post(url, **kwargs)

raise_error_from_response(r, GitlabSubscribeError)

self._set_from_dict(r.json())

def unsubscribe(self, **kwargs):

"""Unsubscribe an issue.

url = ('/projects/%(project_id)s/issues/%(issue_id)s/subscription' %

{'project_id': self.project_id, 'issue_id': self.id})

r = self.gitlab._raw_delete(url, **kwargs)

raise_error_from_response(r, GitlabUnsubscribeError)

self._set_from_dict(r.json())

def move(self, to_project_id, **kwargs):

"""Move the issue to another project.

url = ('/projects/%(project_id)s/issues/%(issue_id)s/move' %

{'project_id': self.project_id, 'issue_id': self.id})

data = {'to_project_id': to_project_id}

data.update(**kwargs)

r = self.gitlab._raw_post(url, data=data)

raise_error_from_response(r, GitlabUpdateError, 201)

self._set_from_dict(r.json())

def todo(self, **kwargs):

"""Create a todo for the issue.

url = ('/projects/%(project_id)s/issues/%(issue_id)s/todo' %

{'project_id': self.project_id, 'issue_id': self.id})

r = self.gitlab._raw_post(url, **kwargs)

raise_error_from_response(r, GitlabTodoError, [201, 304])

def time_stats(self, **kwargs):

"""Get time stats for the issue.