gitlab.v4 package¶
Submodules¶
gitlab.v4.objects module¶
-
class
gitlab.v4.objects.
ApplicationSettings
(manager, attrs)¶
-
class
gitlab.v4.objects.
ApplicationSettingsManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetWithoutIdMixin
,gitlab.mixins.UpdateMixin
,gitlab.base.RESTManager
Object update
Optional attributes for object update:
id
default_projects_limit
signup_enabled
password_authentication_enabled_for_web
gravatar_enabled
sign_in_text
created_at
updated_at
home_page_url
default_branch_protection
restricted_visibility_levels
max_attachment_size
session_expire_delay
default_project_visibility
default_snippet_visibility
default_group_visibility
outbound_local_requests_whitelist
domain_whitelist
domain_blacklist_enabled
domain_blacklist
external_authorization_service_enabled
external_authorization_service_url
external_authorization_service_default_label
external_authorization_service_timeout
user_oauth_applications
after_sign_out_path
container_registry_token_expire_delay
repository_storages
plantuml_enabled
plantuml_url
terminal_max_session_time
polling_interval_multiplier
rsa_key_restriction
dsa_key_restriction
ecdsa_key_restriction
ed25519_key_restriction
first_day_of_week
enforce_terms
terms
performance_bar_allowed_group_id
instance_statistics_visibility_private
user_show_add_ssh_key_message
file_template_project_id
local_markdown_version
asset_proxy_enabled
asset_proxy_url
asset_proxy_whitelist
geo_node_allowed_ips
allow_local_requests_from_hooks_and_services
allow_local_requests_from_web_hooks_and_services
allow_local_requests_from_system_hooks
-
update
(**kwargs)¶ Update an object on the server.
Parameters: - id – ID of the object to update (can be None if not required)
- new_data – the update data for the object
- **kwargs – Extra options to send to the server (e.g. sudo)
Returns: The new object data (not a RESTObject)
Return type: dict
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabUpdateError
– If the server cannot perform the request
-
class
gitlab.v4.objects.
BroadcastMessage
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
BroadcastMessageManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
message
Optional attributes:
starts_at
ends_at
color
font
Object update
Optional attributes for object update:
message
starts_at
ends_at
color
font
-
class
gitlab.v4.objects.
CurrentUser
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
CurrentUserEmail
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
CurrentUserEmailManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
email
-
class
gitlab.v4.objects.
CurrentUserGPGKey
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
CurrentUserGPGKeyManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
key
-
class
gitlab.v4.objects.
CurrentUserKey
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
CurrentUserKeyManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
title
key
-
class
gitlab.v4.objects.
CurrentUserManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetWithoutIdMixin
,gitlab.base.RESTManager
-
class
gitlab.v4.objects.
CurrentUserStatus
(manager, attrs)¶
-
class
gitlab.v4.objects.
CurrentUserStatusManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetWithoutIdMixin
,gitlab.mixins.UpdateMixin
,gitlab.base.RESTManager
Object update
Optional attributes for object update:
emoji
message
-
class
gitlab.v4.objects.
DeployKey
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
DeployKeyManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
Dockerfile
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
DockerfileManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
Event
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
EventManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
action
target_type
before
after
sort
-
class
gitlab.v4.objects.
Feature
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
FeatureManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
-
set
(**kwargs)¶ Create or update the object.
Parameters: - name (str) – The value to set for the object
- value (bool/int) – The value to set for the object
- feature_group (str) – A feature group name
- user (str) – A GitLab username
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabSetError
– If an error occured
Returns: The created/updated attribute
Return type: obj
-
-
class
gitlab.v4.objects.
GeoNode
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
repair
(**kwargs)¶ Repair the OAuth authentication of the geo node.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabRepairError
– If the server failed to perform the request
-
status
(**kwargs)¶ Get the status of the geo node.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server failed to perform the request
Returns: The status of the geo node
Return type: dict
-
-
class
gitlab.v4.objects.
GeoNodeManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object update
Optional attributes for object update:
enabled
url
files_max_capacity
repos_max_capacity
-
current_failures
(**kwargs)¶ Get the list of failures on the current geo node.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server failed to perform the request
Returns: The list of failures
Return type: list
-
status
(**kwargs)¶ Get the status of all the geo nodes.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server failed to perform the request
Returns: The status of all the geo nodes
Return type: list
-
class
gitlab.v4.objects.
Gitignore
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GitignoreManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
Gitlabciyml
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GitlabciymlManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
Group
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
add_ldap_group_link
(**kwargs)¶ Add an LDAP group link.
Parameters: - cn (str) – CN of the LDAP group
- group_access (int) – Minimum access level for members of the LDAP group
- provider (str) – LDAP provider for the LDAP group
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server cannot perform the request
-
delete_ldap_group_link
(**kwargs)¶ Delete an LDAP group link.
Parameters: - cn (str) – CN of the LDAP group
- provider (str) – LDAP provider for the LDAP group
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server cannot perform the request
-
ldap_sync
(**kwargs)¶ Sync LDAP groups.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server cannot perform the request
-
search
(**kwargs)¶ Search the group resources matching the provided string.’
Parameters: - scope (str) – Scope of the search
- search (str) – Search string
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabSearchError
– If the server failed to perform the request
Returns: A list of dicts describing the resources found.
Return type:
-
transfer_project
(**kwargs)¶ Transfer a project to this group.
Parameters: - to_project_id (int) – ID of the project to transfer
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabTransferProjectError
– If the project could not be transfered
-
-
class
gitlab.v4.objects.
GroupAccessRequest
(manager, attrs)¶ Bases:
gitlab.mixins.AccessRequestMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupAccessRequestManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
-
class
gitlab.v4.objects.
GroupBadge
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupBadgeManager
(gl, parent=None)¶ Bases:
gitlab.mixins.BadgeRenderMixin
,gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
link_url
image_url
Object update
Optional attributes for object update:
link_url
image_url
-
class
gitlab.v4.objects.
GroupBoard
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupBoardList
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupBoardListManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
label_id
Object update
Mandatory attributes for object update:
position
-
class
gitlab.v4.objects.
GroupBoardManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
-
class
gitlab.v4.objects.
GroupCustomAttribute
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupCustomAttributeManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.SetMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
-
class
gitlab.v4.objects.
GroupEpic
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.mixins.SaveMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupEpicIssue
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.mixins.SaveMixin
,gitlab.base.RESTObject
-
save
(**kwargs)¶ Save the changes made to the object to the server.
The object is updated to match what the server returns.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo) - Raise:
- GitlabAuthenticationError: If authentication is not correct GitlabUpdateError: If the server cannot perform the request
-
-
class
gitlab.v4.objects.
GroupEpicIssueManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
issue_id
Object update
Optional attributes for object update:
move_before_id
move_after_id
-
create
(**kwargs)¶ Create a new object.
Parameters: - data (dict) – Parameters to send to the server to create the resource
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server cannot perform the request
Returns: - A new instance of the manage object class build with
the data sent by the server
Return type:
-
class
gitlab.v4.objects.
GroupEpicManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object listing filters
author_id
labels
order_by
sort
search
Object Creation
Mandatory attributes:
title
Optional attributes:
labels
description
start_date
end_date
Object update
Optional attributes for object update:
title
labels
description
start_date
end_date
-
class
gitlab.v4.objects.
GroupEpicResourceLabelEvent
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupEpicResourceLabelEventManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
GroupIssue
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupIssueManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
state
labels
milestone
order_by
sort
iids
author_id
assignee_id
my_reaction_emoji
search
created_after
created_before
updated_after
updated_before
-
class
gitlab.v4.objects.
GroupLabel
(manager, attrs)¶ Bases:
gitlab.mixins.SubscribableMixin
,gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
save
(**kwargs)¶ Saves the changes made to the object to the server.
The object is updated to match what the server returns.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correct.GitlabUpdateError
– If the server cannot perform the request.
-
-
class
gitlab.v4.objects.
GroupLabelManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
color
Optional attributes:
description
priority
Object update
Mandatory attributes for object update:
name
Optional attributes for object update:
new_name
color
description
priority
-
delete
(**kwargs)¶ Delete a Label on the server.
Parameters: - name – The name of the label
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server cannot perform the request
-
update
(name, new_data=None, **kwargs)¶ Update a Label on the server.
Parameters: - name – The name of the label
- **kwargs – Extra options to send to the server (e.g. sudo)
-
class
gitlab.v4.objects.
GroupManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object listing filters
skip_groups
all_available
search
order_by
sort
statistics
owned
with_custom_attributes
Object Creation
Mandatory attributes:
name
path
Optional attributes:
description
visibility
parent_id
lfs_enabled
request_access_enabled
Object update
Optional attributes for object update:
name
path
description
visibility
lfs_enabled
request_access_enabled
-
class
gitlab.v4.objects.
GroupMember
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupMemberManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
access_level
user_id
Optional attributes:
expires_at
Object update
Mandatory attributes for object update:
access_level
Optional attributes for object update:
expires_at
-
all
(**kwargs)¶ List all the members, included inherited ones.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the list could not be retrieved
Returns: The list of members
Return type:
-
class
gitlab.v4.objects.
GroupMergeRequest
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupMergeRequestManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
state
order_by
sort
milestone
view
labels
created_after
created_before
updated_after
updated_before
scope
author_id
assignee_id
my_reaction_emoji
source_branch
target_branch
search
-
class
gitlab.v4.objects.
GroupMilestone
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
issues
(**kwargs)¶ List issues related to this milestone.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the list could not be retrieved
Returns: The list of issues
Return type:
-
merge_requests
(**kwargs)¶ List the merge requests related to this milestone.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the list could not be retrieved
Returns: The list of merge requests
Return type:
-
-
class
gitlab.v4.objects.
GroupMilestoneManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object listing filters
iids
state
search
Object Creation
Mandatory attributes:
title
Optional attributes:
description
due_date
start_date
Object update
Optional attributes for object update:
title
description
due_date
start_date
state_event
-
class
gitlab.v4.objects.
GroupNotificationSettings
(manager, attrs)¶
-
class
gitlab.v4.objects.
GroupNotificationSettingsManager
(gl, parent=None)¶ Bases:
gitlab.v4.objects.NotificationSettingsManager
Object update
Optional attributes for object update:
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
-
class
gitlab.v4.objects.
GroupProject
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupProjectManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
archived
visibility
order_by
sort
search
ci_enabled_first
simple
owned
starred
with_custom_attributes
-
class
gitlab.v4.objects.
GroupSubgroup
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupSubgroupManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
skip_groups
all_available
search
order_by
sort
statistics
owned
with_custom_attributes
-
class
gitlab.v4.objects.
GroupVariable
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
GroupVariableManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
key
value
Optional attributes:
protected
Object update
Mandatory attributes for object update:
key
value
Optional attributes for object update:
protected
-
class
gitlab.v4.objects.
Hook
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
HookManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
url
-
class
gitlab.v4.objects.
Issue
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
IssueManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
state
labels
milestone
scope
author_id
assignee_id
my_reaction_emoji
iids
order_by
sort
search
created_after
created_before
updated_after
updated_before
-
class
gitlab.v4.objects.
LDAPGroup
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
LDAPGroupManager
(gl, parent=None)¶ Bases:
gitlab.base.RESTManager
Object listing filters
search
provider
-
list
(**kwargs)¶ Retrieve a list of objects.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Returns: The list of objects, or a generator if as_list is False
Return type: list
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the server cannot perform the request
-
class
gitlab.v4.objects.
License
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
LicenseManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.base.RESTManager
Object listing filters
popular
-
class
gitlab.v4.objects.
MergeRequest
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
MergeRequestManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
state
order_by
sort
milestone
view
labels
created_after
created_before
updated_after
updated_before
scope
author_id
assignee_id
my_reaction_emoji
source_branch
target_branch
search
-
class
gitlab.v4.objects.
Namespace
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
NamespaceManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.base.RESTManager
Object listing filters
search
-
class
gitlab.v4.objects.
NotificationSettings
(manager, attrs)¶
-
class
gitlab.v4.objects.
NotificationSettingsManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetWithoutIdMixin
,gitlab.mixins.UpdateMixin
,gitlab.base.RESTManager
Object update
Optional attributes for object update:
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
-
class
gitlab.v4.objects.
PagesDomain
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
PagesDomainManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
Project
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
archive
(**kwargs)¶ Archive a project.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server failed to perform the request
-
artifact
(**kwargs)¶ Download a single artifact file from a specific tag or branch from within the job’s artifacts archive.
Parameters: - ref_name (str) – Branch or tag name in repository. HEAD or SHA references are not supported.
- artifact_path (str) – Path to a file inside the artifacts archive.
- job (str) – The name of the job.
- streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for treatment
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the artifacts could not be retrieved
Returns: The artifacts if streamed is False, None otherwise.
Return type: str
-
create_fork_relation
(**kwargs)¶ Create a forked from/to relation between existing projects.
Parameters: - forked_from_id (int) – The ID of the project that was forked from
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the relation could not be created
-
delete_fork_relation
(**kwargs)¶ Delete a forked relation between existing projects.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server failed to perform the request
-
delete_merged_branches
(**kwargs)¶ Delete merged branches.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server failed to perform the request
-
housekeeping
(**kwargs)¶ Start the housekeeping task.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabHousekeepingError
– If the server failed to perform the request
-
languages
(**kwargs)¶ Get languages used in the project with percentage value.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server failed to perform the request
-
mirror_pull
(**kwargs)¶ Start the pull mirroring process for the project.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server failed to perform the request
-
repository_archive
(**kwargs)¶ Return a tarball of the repository.
Parameters: - sha (str) – ID of the commit (default branch by default)
- streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for treatment
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the server failed to perform the request
Returns: The binary data of the archive
Return type: str
-
repository_blob
(**kwargs)¶ Return a file by blob SHA.
Parameters: - sha (str) – ID of the blob
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server failed to perform the request
Returns: The blob content and metadata
Return type: dict
-
repository_compare
(**kwargs)¶ Return a diff between two branches/commits.
Parameters: - from (str) – Source branch/SHA
- to (str) – Destination branch/SHA
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server failed to perform the request
Returns: The diff
Return type: str
-
repository_contributors
(**kwargs)¶ Return a list of contributors for the project.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server failed to perform the request
Returns: The contributors
Return type: list
-
repository_raw_blob
(**kwargs)¶ Return the raw file contents for a blob.
Parameters: - sha (str) – ID of the blob
- streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for treatment
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server failed to perform the request
Returns: The blob content if streamed is False, None otherwise
Return type: str
-
repository_tree
(**kwargs)¶ Return a list of files in the repository.
Parameters: - path (str) – Path of the top folder (/ by default)
- ref (str) – Reference to a commit or branch
- recursive (bool) – Whether to get the tree recursively
- all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server failed to perform the request
Returns: The representation of the tree
Return type: list
-
search
(**kwargs)¶ Search the project resources matching the provided string.’
Parameters: - scope (str) – Scope of the search
- search (str) – Search string
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabSearchError
– If the server failed to perform the request
Returns: A list of dicts describing the resources found.
Return type:
Share the project with a group.
Parameters: - group_id (int) – ID of the group.
- group_access (int) – Access level for the group.
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server failed to perform the request
-
snapshot
(**kwargs)¶ Return a snapshot of the repository.
Parameters: - wiki (bool) – If True return the wiki repository
- streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for treatment.
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the content could not be retrieved
Returns: The uncompressed tar archive of the repository
Return type: str
-
star
(**kwargs)¶ Star a project.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server failed to perform the request
-
transfer_project
(**kwargs)¶ Transfer a project to the given namespace ID
Parameters: - to_namespace (str) – ID or path of the namespace to transfer the
- to (project) –
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabTransferProjectError
– If the project could not be transfered
-
trigger_pipeline
(**kwargs)¶ Trigger a CI build.
See https://gitlab.com/help/ci/triggers/README.md#trigger-a-build
Parameters: - ref (str) – Commit to build; can be a branch name or a tag
- token (str) – The trigger token
- variables (dict) – Variables passed to the build script
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server failed to perform the request
-
unarchive
(**kwargs)¶ Unarchive a project.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server failed to perform the request
Delete a shared project link within a group.
Parameters: - group_id (int) – ID of the group.
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server failed to perform the request
-
unstar
(**kwargs)¶ Unstar a project.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server failed to perform the request
-
update_submodule
(**kwargs)¶ Update a project submodule
Parameters: - submodule (str) – Full path to the submodule
- branch (str) – Name of the branch to commit into
- commit_sha (str) – Full commit SHA to update the submodule to
- commit_message (str) – Commit message. If no message is provided, a default one will be set (optional)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabPutError
– If the submodule could not be updated
-
upload
(**kwargs)¶ Upload the specified file into the project.
Note
Either
filedata
orfilepath
MUST be specified.Parameters: - filename (str) – The name of the file being uploaded
- filedata (bytes) – The raw data of the file being uploaded
- filepath (str) – The path to a local file to upload (optional)
Raises: GitlabConnectionError
– If the server cannot be reachedGitlabUploadError
– If the file upload failsGitlabUploadError
– Iffiledata
andfilepath
are not specifiedGitlabUploadError
– If bothfiledata
andfilepath
are specified
Returns: - A
dict
with the keys: alt
- The alternate text for the uploadurl
- The direct url to the uploaded filemarkdown
- Markdown for the uploaded file
Return type: dict
-
-
class
gitlab.v4.objects.
ProjectAccessRequest
(manager, attrs)¶ Bases:
gitlab.mixins.AccessRequestMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectAccessRequestManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
-
class
gitlab.v4.objects.
ProjectApproval
(manager, attrs)¶
-
class
gitlab.v4.objects.
ProjectApprovalManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetWithoutIdMixin
,gitlab.mixins.UpdateMixin
,gitlab.base.RESTManager
Object update
Optional attributes for object update:
approvals_before_merge
reset_approvals_on_push
disable_overriding_approvers_per_merge_request
-
set_approvers
(**kwargs)¶ Change project-level allowed approvers and approver groups.
Parameters: - approver_ids (list) – User IDs that can approve MRs
- approver_group_ids (list) – Group IDs whose members can approve MRs
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabUpdateError
– If the server failed to perform the request
-
class
gitlab.v4.objects.
ProjectApprovalRule
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectApprovalRuleManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
approvals_required
Optional attributes:
user_ids
group_ids
-
class
gitlab.v4.objects.
ProjectBadge
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectBadgeManager
(gl, parent=None)¶ Bases:
gitlab.mixins.BadgeRenderMixin
,gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
link_url
image_url
Object update
Optional attributes for object update:
link_url
image_url
-
class
gitlab.v4.objects.
ProjectBoard
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectBoardList
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectBoardListManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
label_id
Object update
Mandatory attributes for object update:
position
-
class
gitlab.v4.objects.
ProjectBoardManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
-
class
gitlab.v4.objects.
ProjectBranch
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
protect
(**kwargs)¶ Protect the branch.
Parameters: - developers_can_push (bool) – Set to True if developers are allowed to push to the branch
- developers_can_merge (bool) – Set to True if developers are allowed to merge to the branch
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabProtectError
– If the branch could not be protected
-
unprotect
(**kwargs)¶ Unprotect the branch.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabProtectError
– If the branch could not be unprotected
-
-
class
gitlab.v4.objects.
ProjectBranchManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
branch
ref
-
class
gitlab.v4.objects.
ProjectCommit
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
cherry_pick
(**kwargs)¶ Cherry-pick a commit into a branch.
Parameters: - branch (str) – Name of target branch
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCherryPickError
– If the cherry-pick could not be performed
-
diff
(**kwargs)¶ Generate the commit diff.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the diff could not be retrieved
Returns: The changes done in this commit
Return type: list
-
merge_requests
(**kwargs)¶ List the merge requests related to the commit.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the references could not be retrieved
Returns: The merge requests related to the commit.
Return type: list
-
refs
(**kwargs)¶ List the references the commit is pushed to.
Parameters: - type (str) – The scope of references (‘branch’, ‘tag’ or ‘all’)
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the references could not be retrieved
Returns: The references the commit is pushed to.
Return type: list
-
-
class
gitlab.v4.objects.
ProjectCommitComment
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectCommitCommentManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
note
Optional attributes:
path
line
line_type
-
class
gitlab.v4.objects.
ProjectCommitDiscussion
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectCommitDiscussionManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Optional attributes:
created_at
-
class
gitlab.v4.objects.
ProjectCommitDiscussionNote
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectCommitDiscussionNoteManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Optional attributes:
created_at
position
Object update
Mandatory attributes for object update:
body
-
class
gitlab.v4.objects.
ProjectCommitManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
branch
commit_message
actions
Optional attributes:
author_email
author_name
-
class
gitlab.v4.objects.
ProjectCommitStatus
(manager, attrs)¶
-
class
gitlab.v4.objects.
ProjectCommitStatusManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
state
Optional attributes:
description
name
context
ref
target_url
coverage
-
create
(**kwargs)¶ Create a new object.
Parameters: - data (dict) – Parameters to send to the server to create the resource
- **kwargs – Extra options to send to the server (e.g. sudo or ‘ref_name’, ‘stage’, ‘name’, ‘all’)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server cannot perform the request
Returns: - A new instance of the manage object class build with
the data sent by the server
Return type:
-
class
gitlab.v4.objects.
ProjectCustomAttribute
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectCustomAttributeManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.SetMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
-
class
gitlab.v4.objects.
ProjectDeployment
(manager, attrs)¶
-
class
gitlab.v4.objects.
ProjectDeploymentManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.base.RESTManager
Object listing filters
order_by
sort
Object Creation
Mandatory attributes:
sha
ref
tag
status
environment
-
class
gitlab.v4.objects.
ProjectEnvironment
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
stop
(**kwargs)¶ Stop the environment.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabStopError
– If the operation failed
-
-
class
gitlab.v4.objects.
ProjectEnvironmentManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
Optional attributes:
external_url
Object update
Optional attributes for object update:
name
external_url
-
class
gitlab.v4.objects.
ProjectEvent
(manager, attrs)¶ Bases:
gitlab.v4.objects.Event
-
class
gitlab.v4.objects.
ProjectEventManager
(gl, parent=None)¶ Bases:
gitlab.v4.objects.EventManager
Object listing filters
action
target_type
before
after
sort
-
class
gitlab.v4.objects.
ProjectExport
(manager, attrs)¶ Bases:
gitlab.mixins.RefreshMixin
,gitlab.base.RESTObject
-
download
(**kwargs)¶ Download the archive of a project export.
Parameters: - streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for reatment
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server failed to perform the request
Returns: The blob content if streamed is False, None otherwise
Return type: str
-
-
class
gitlab.v4.objects.
ProjectExportManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetWithoutIdMixin
,gitlab.mixins.CreateMixin
,gitlab.base.RESTManager
Object Creation
Optional attributes:
description
-
class
gitlab.v4.objects.
ProjectFile
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
decode
()¶ Returns the decoded content of the file.
Returns: the decoded content. Return type: (str)
-
delete
(branch, commit_message, **kwargs)¶ Delete the file from the server.
Parameters: - branch (str) – Branch from which the file will be removed
- commit_message (str) – Commit message for the deletion
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server cannot perform the request
-
save
(branch, commit_message, **kwargs)¶ Save the changes made to the file to the server.
The object is updated to match what the server returns.
Parameters: - branch (str) – Branch in which the file will be updated
- commit_message (str) – Message to send with the commit
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabUpdateError
– If the server cannot perform the request
-
-
class
gitlab.v4.objects.
ProjectFileManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
file_path
branch
content
commit_message
Optional attributes:
encoding
author_email
author_name
Object update
Mandatory attributes for object update:
file_path
branch
content
commit_message
Optional attributes for object update:
encoding
author_email
author_name
-
blame
(**kwargs)¶ Return the content of a file for a commit.
Parameters: - file_path (str) – Path of the file to retrieve
- ref (str) – Name of the branch, tag or commit
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the server failed to perform the request
Returns: a list of commits/lines matching the file
Return type: list(blame)
-
create
(**kwargs)¶ Create a new object.
Parameters: - data (dict) – parameters to send to the server to create the resource
- **kwargs – Extra options to send to the server (e.g. sudo)
Returns: - a new instance of the managed object class built with
the data sent by the server
Return type: Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server cannot perform the request
-
delete
(**kwargs)¶ Delete a file on the server.
Parameters: - file_path (str) – Path of the file to remove
- branch (str) – Branch from which the file will be removed
- commit_message (str) – Commit message for the deletion
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server cannot perform the request
-
get
(**kwargs)¶ Retrieve a single file.
Parameters: - file_path (str) – Path of the file to retrieve
- ref (str) – Name of the branch, tag or commit
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the file could not be retrieved
Returns: The generated RESTObject
Return type: object
-
raw
(**kwargs)¶ Return the content of a file for a commit.
Parameters: - ref (str) – ID of the commit
- filepath (str) – Path of the file to return
- streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for treatment
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the file could not be retrieved
Returns: The file content
Return type: str
-
update
(**kwargs)¶ Update an object on the server.
Parameters: - id – ID of the object to update (can be None if not required)
- new_data – the update data for the object
- **kwargs – Extra options to send to the server (e.g. sudo)
Returns: The new object data (not a RESTObject)
Return type: dict
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabUpdateError
– If the server cannot perform the request
-
class
gitlab.v4.objects.
ProjectFork
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectForkManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CreateMixin
,gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
archived
visibility
order_by
sort
search
simple
owned
membership
starred
statistics
with_custom_attributes
with_issues_enabled
with_merge_requests_enabled
Object Creation
Optional attributes:
namespace
-
list
(**kwargs)¶ Retrieve a list of objects.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Returns: The list of objects, or a generator if as_list is False
Return type: list
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the server cannot perform the request
-
class
gitlab.v4.objects.
ProjectHook
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectHookManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
url
Optional attributes:
push_events
issues_events
confidential_issues_events
merge_requests_events
tag_push_events
note_events
job_events
pipeline_events
wiki_page_events
enable_ssl_verification
token
Object update
Mandatory attributes for object update:
url
Optional attributes for object update:
push_events
issues_events
confidential_issues_events
merge_requests_events
tag_push_events
note_events
job_events
pipeline_events
wiki_events
enable_ssl_verification
token
-
class
gitlab.v4.objects.
ProjectImport
(manager, attrs)¶
-
class
gitlab.v4.objects.
ProjectImportManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetWithoutIdMixin
,gitlab.base.RESTManager
-
class
gitlab.v4.objects.
ProjectIssue
(manager, attrs)¶ Bases:
gitlab.mixins.UserAgentDetailMixin
,gitlab.mixins.SubscribableMixin
,gitlab.mixins.TodoMixin
,gitlab.mixins.TimeTrackingMixin
,gitlab.mixins.ParticipantsMixin
,gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
closed_by
(**kwargs)¶ List merge requests that will close the issue when merged.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetErrot
– If the merge requests could not be retrieved
Returns: The list of merge requests.
Return type: list
-
move
(**kwargs)¶ Move the issue to another project.
Parameters: - to_project_id (int) – ID of the target project
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabUpdateError
– If the issue could not be moved
List merge requests related to the issue.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetErrot
– If the merge requests could not be retrieved
Returns: The list of merge requests.
Return type: list
-
-
class
gitlab.v4.objects.
ProjectIssueAwardEmoji
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectIssueAwardEmojiManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
-
class
gitlab.v4.objects.
ProjectIssueDiscussion
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectIssueDiscussionManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Optional attributes:
created_at
-
class
gitlab.v4.objects.
ProjectIssueDiscussionNote
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectIssueDiscussionNoteManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Optional attributes:
created_at
Object update
Mandatory attributes for object update:
body
-
class
gitlab.v4.objects.
ProjectIssueLink
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectIssueLinkManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
target_project_id
target_issue_iid
-
create
(**kwargs)¶ Create a new object.
Parameters: - data (dict) – parameters to send to the server to create the resource
- **kwargs – Extra options to send to the server (e.g. sudo)
Returns: The source and target issues
Return type: Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server cannot perform the request
-
class
gitlab.v4.objects.
ProjectIssueManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object listing filters
iids
state
labels
milestone
scope
author_id
assignee_id
my_reaction_emoji
order_by
sort
search
created_after
created_before
updated_after
updated_before
Object Creation
Mandatory attributes:
title
Optional attributes:
description
confidential
assignee_ids
assignee_id
milestone_id
labels
created_at
due_date
merge_request_to_resolve_discussions_of
discussion_to_resolve
Object update
Optional attributes for object update:
title
description
confidential
assignee_ids
assignee_id
milestone_id
labels
state_event
updated_at
due_date
discussion_locked
-
class
gitlab.v4.objects.
ProjectIssueNote
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectIssueNoteAwardEmoji
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectIssueNoteAwardEmojiManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
-
class
gitlab.v4.objects.
ProjectIssueNoteManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Optional attributes:
created_at
Object update
Mandatory attributes for object update:
body
-
class
gitlab.v4.objects.
ProjectIssueResourceLabelEvent
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectIssueResourceLabelEventManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
ProjectJob
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
,gitlab.mixins.RefreshMixin
-
artifact
(**kwargs)¶ Get a single artifact file from within the job’s artifacts archive.
Parameters: - path (str) – Path of the artifact
- streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for treatment
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the artifacts could not be retrieved
Returns: The artifacts if streamed is False, None otherwise.
Return type: str
-
artifacts
(**kwargs)¶ Get the job artifacts.
Parameters: - streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for treatment
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the artifacts could not be retrieved
Returns: The artifacts if streamed is False, None otherwise.
Return type: str
-
cancel
(**kwargs)¶ Cancel the job.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabJobCancelError
– If the job could not be canceled
-
delete_artifacts
(**kwargs)¶ Delete artifacts of a job.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the request could not be performed
-
erase
(**kwargs)¶ Erase the job (remove job artifacts and trace).
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabJobEraseError
– If the job could not be erased
-
keep_artifacts
(**kwargs)¶ Prevent artifacts from being deleted when expiration is set.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the request could not be performed
-
play
(**kwargs)¶ Trigger a job explicitly.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabJobPlayError
– If the job could not be triggered
-
retry
(**kwargs)¶ Retry the job.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabJobRetryError
– If the job could not be retried
-
trace
(**kwargs)¶ Get the job trace.
Parameters: - streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for treatment
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the artifacts could not be retrieved
Returns: The trace
Return type: str
-
-
class
gitlab.v4.objects.
ProjectJobManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
ProjectKey
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectKeyManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
title
key
Optional attributes:
can_push
Object update
Optional attributes for object update:
title
can_push
-
enable
(**kwargs)¶ Enable a deploy key for a project.
Parameters: - key_id (int) – The ID of the key to enable
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabProjectDeployKeyError
– If the key could not be enabled
-
class
gitlab.v4.objects.
ProjectLabel
(manager, attrs)¶ Bases:
gitlab.mixins.SubscribableMixin
,gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
save
(**kwargs)¶ Saves the changes made to the object to the server.
The object is updated to match what the server returns.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correct.GitlabUpdateError
– If the server cannot perform the request.
-
-
class
gitlab.v4.objects.
ProjectLabelManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
color
Optional attributes:
description
priority
Object update
Mandatory attributes for object update:
name
Optional attributes for object update:
new_name
color
description
priority
-
delete
(**kwargs)¶ Delete a Label on the server.
Parameters: - name – The name of the label
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server cannot perform the request
-
update
(name, new_data=None, **kwargs)¶ Update a Label on the server.
Parameters: - name – The name of the label
- **kwargs – Extra options to send to the server (e.g. sudo)
-
class
gitlab.v4.objects.
ProjectManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object listing filters
search
owned
starred
archived
visibility
order_by
sort
simple
membership
statistics
with_issues_enabled
with_merge_requests_enabled
with_custom_attributes
Object Creation
Optional attributes:
name
path
namespace_id
description
issues_enabled
merge_requests_enabled
jobs_enabled
wiki_enabled
snippets_enabled
resolve_outdated_diff_discussions
container_registry_enabled
shared_runners_enabled
visibility
import_url
public_jobs
only_allow_merge_if_pipeline_succeeds
only_allow_merge_if_all_discussions_are_resolved
merge_method
lfs_enabled
request_access_enabled
tag_list
avatar
printing_merge_request_link_enabled
ci_config_path
Object update
Optional attributes for object update:
name
path
default_branch
description
issues_enabled
merge_requests_enabled
jobs_enabled
wiki_enabled
snippets_enabled
resolve_outdated_diff_discussions
container_registry_enabled
shared_runners_enabled
visibility
import_url
public_jobs
only_allow_merge_if_pipeline_succeeds
only_allow_merge_if_all_discussions_are_resolved
merge_method
lfs_enabled
request_access_enabled
tag_list
avatar
ci_config_path
-
import_project
(file, path, namespace=None, overwrite=False, override_params=None, **kwargs)¶ Import a project from an archive file.
Parameters: - file – Data or file object containing the project
- path (str) – Name and path for the new project
- namespace (str) – The ID or path of the namespace that the project will be imported to
- overwrite (bool) – If True overwrite an existing project with the same path
- override_params (dict) – Set the specific settings for the project
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the server failed to perform the request
Returns: A representation of the import status.
Return type: dict
-
class
gitlab.v4.objects.
ProjectMember
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectMemberManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
access_level
user_id
Optional attributes:
expires_at
Object update
Mandatory attributes for object update:
access_level
Optional attributes for object update:
expires_at
-
all
(**kwargs)¶ List all the members, included inherited ones.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the list could not be retrieved
Returns: The list of members
Return type:
-
class
gitlab.v4.objects.
ProjectMergeRequest
(manager, attrs)¶ Bases:
gitlab.mixins.SubscribableMixin
,gitlab.mixins.TodoMixin
,gitlab.mixins.TimeTrackingMixin
,gitlab.mixins.ParticipantsMixin
,gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
approve
(**kwargs)¶ Approve the merge request.
Parameters: - sha (str) – Head SHA of MR
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabMRApprovalError
– If the approval failed
-
cancel_merge_when_pipeline_succeeds
(**kwargs)¶ Cancel merge when the pipeline succeeds.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabMROnBuildSuccessError
– If the server could not handle the request
-
changes
(**kwargs)¶ List the merge request changes.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the list could not be retrieved
Returns: List of changes
Return type:
-
closes_issues
(**kwargs)¶ List issues that will close on merge.”
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the list could not be retrieved
Returns: List of issues
Return type:
-
commits
(**kwargs)¶ List the merge request commits.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the list could not be retrieved
Returns: The list of commits
Return type:
-
merge
(**kwargs)¶ Accept the merge request.
Parameters: - merge_commit_message (bool) – Commit message
- should_remove_source_branch (bool) – If True, removes the source branch
- merge_when_pipeline_succeeds (bool) – Wait for the build to succeed, then merge
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabMRClosedError
– If the merge failed
-
pipelines
(**kwargs)¶ List the merge request pipelines.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the list could not be retrieved
Returns: List of changes
Return type:
-
rebase
(**kwargs)¶ Attempt to rebase the source branch onto the target branch
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabMRRebaseError
– If rebasing failed
-
unapprove
(**kwargs)¶ Unapprove the merge request.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabMRApprovalError
– If the unapproval failed
-
-
class
gitlab.v4.objects.
ProjectMergeRequestApproval
(manager, attrs)¶
-
class
gitlab.v4.objects.
ProjectMergeRequestApprovalManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetWithoutIdMixin
,gitlab.mixins.UpdateMixin
,gitlab.base.RESTManager
Object update
Mandatory attributes for object update:
approvals_required
-
set_approvers
(**kwargs)¶ Change MR-level allowed approvers and approver groups.
Parameters: - approver_ids (list) – User IDs that can approve MRs
- approver_group_ids (list) – Group IDs whose members can approve MRs
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabUpdateError
– If the server failed to perform the request
-
class
gitlab.v4.objects.
ProjectMergeRequestAwardEmoji
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectMergeRequestAwardEmojiManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
-
class
gitlab.v4.objects.
ProjectMergeRequestDiff
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectMergeRequestDiffManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
ProjectMergeRequestDiscussion
(manager, attrs)¶
-
class
gitlab.v4.objects.
ProjectMergeRequestDiscussionManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Optional attributes:
created_at
position
Object update
Mandatory attributes for object update:
resolved
-
class
gitlab.v4.objects.
ProjectMergeRequestDiscussionNote
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectMergeRequestDiscussionNoteManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Optional attributes:
created_at
Object update
Mandatory attributes for object update:
body
-
class
gitlab.v4.objects.
ProjectMergeRequestManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object listing filters
state
order_by
sort
milestone
view
labels
created_after
created_before
updated_after
updated_before
scope
author_id
assignee_id
my_reaction_emoji
source_branch
target_branch
search
Object Creation
Mandatory attributes:
source_branch
target_branch
title
Optional attributes:
assignee_id
description
target_project_id
labels
milestone_id
remove_source_branch
allow_maintainer_to_push
squash
Object update
Optional attributes for object update:
target_branch
assignee_id
title
description
state_event
labels
milestone_id
remove_source_branch
discussion_locked
allow_maintainer_to_push
squash
-
class
gitlab.v4.objects.
ProjectMergeRequestNote
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectMergeRequestNoteAwardEmoji
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectMergeRequestNoteAwardEmojiManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
-
class
gitlab.v4.objects.
ProjectMergeRequestNoteManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Object update
Mandatory attributes for object update:
body
-
class
gitlab.v4.objects.
ProjectMergeRequestResourceLabelEvent
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectMergeRequestResourceLabelEventManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
ProjectMilestone
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
issues
(**kwargs)¶ List issues related to this milestone.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the list could not be retrieved
Returns: The list of issues
Return type:
-
merge_requests
(**kwargs)¶ List the merge requests related to this milestone.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the list could not be retrieved
Returns: The list of merge requests
Return type:
-
-
class
gitlab.v4.objects.
ProjectMilestoneManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object listing filters
iids
state
search
Object Creation
Mandatory attributes:
title
Optional attributes:
description
due_date
start_date
state_event
Object update
Optional attributes for object update:
title
description
due_date
start_date
state_event
-
class
gitlab.v4.objects.
ProjectNote
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectNoteManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
-
class
gitlab.v4.objects.
ProjectNotificationSettings
(manager, attrs)¶
-
class
gitlab.v4.objects.
ProjectNotificationSettingsManager
(gl, parent=None)¶ Bases:
gitlab.v4.objects.NotificationSettingsManager
Object update
Optional attributes for object update:
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
-
class
gitlab.v4.objects.
ProjectPagesDomain
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectPagesDomainManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
domain
Optional attributes:
certificate
key
Object update
Optional attributes for object update:
certificate
key
-
class
gitlab.v4.objects.
ProjectPipeline
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
,gitlab.mixins.RefreshMixin
,gitlab.mixins.ObjectDeleteMixin
-
cancel
(**kwargs)¶ Cancel the job.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabPipelineCancelError
– If the request failed
-
retry
(**kwargs)¶ Retry the job.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabPipelineRetryError
– If the request failed
-
-
class
gitlab.v4.objects.
ProjectPipelineJob
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectPipelineJobManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
scope
-
class
gitlab.v4.objects.
ProjectPipelineManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object listing filters
scope
status
ref
sha
yaml_errors
name
username
order_by
sort
Object Creation
Mandatory attributes:
ref
-
create
(data, **kwargs)¶ Creates a new object.
Parameters: - data (dict) – Parameters to send to the server to create the resource
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server cannot perform the request
Returns: - A new instance of the managed object class build with
the data sent by the server
Return type:
-
class
gitlab.v4.objects.
ProjectPipelineSchedule
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
take_ownership
(**kwargs)¶ Update the owner of a pipeline schedule.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabOwnershipError
– If the request failed
-
-
class
gitlab.v4.objects.
ProjectPipelineScheduleManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
description
ref
cron
Optional attributes:
cron_timezone
active
Object update
Optional attributes for object update:
description
ref
cron
cron_timezone
active
-
class
gitlab.v4.objects.
ProjectPipelineScheduleVariable
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectPipelineScheduleVariableManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
key
value
Object update
Mandatory attributes for object update:
key
value
-
class
gitlab.v4.objects.
ProjectPipelineVariable
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectPipelineVariableManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
ProjectProtectedBranch
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectProtectedBranchManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
Optional attributes:
push_access_level
merge_access_level
unprotect_access_level
allowed_to_push
allowed_to_merge
allowed_to_unprotect
-
class
gitlab.v4.objects.
ProjectProtectedTag
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectProtectedTagManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
Optional attributes:
create_access_level
-
class
gitlab.v4.objects.
ProjectPushRules
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectPushRulesManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetWithoutIdMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Optional attributes:
deny_delete_tag
member_check
prevent_secrets
commit_message_regex
branch_name_regex
author_email_regex
file_name_regex
max_file_size
Object update
Optional attributes for object update:
deny_delete_tag
member_check
prevent_secrets
commit_message_regex
branch_name_regex
author_email_regex
file_name_regex
max_file_size
-
class
gitlab.v4.objects.
ProjectRegistryRepository
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectRegistryRepositoryManager
(gl, parent=None)¶ Bases:
gitlab.mixins.DeleteMixin
,gitlab.mixins.ListMixin
,gitlab.base.RESTManager
-
class
gitlab.v4.objects.
ProjectRegistryTag
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectRegistryTagManager
(gl, parent=None)¶ Bases:
gitlab.mixins.DeleteMixin
,gitlab.mixins.RetrieveMixin
,gitlab.base.RESTManager
-
delete_in_bulk
(**kwargs)¶ Delete Tag in bulk
Parameters: - name_regex (string) – The regex of the name to delete. To delete all tags specify .*.
- keep_n (integer) – The amount of latest tags of given name to keep.
- older_than (string) – Tags to delete that are older than the given time, written in human readable form 1h, 1d, 1month.
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeleteError
– If the server cannot perform the request
-
-
class
gitlab.v4.objects.
ProjectRelease
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectReleaseManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
tag_name
description
Optional attributes:
ref
assets
-
class
gitlab.v4.objects.
ProjectRunner
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectRunnerManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
runner_id
-
class
gitlab.v4.objects.
ProjectService
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectServiceManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
-
available
(**kwargs)¶ List the services known by python-gitlab.
Returns: The list of service code names. Return type: list (str)
-
get
(id, **kwargs)¶ Retrieve a single object.
Parameters: - id (int or str) – ID of the object to retrieve
- lazy (bool) – If True, don’t request the server, but create a shallow object giving access to the managers. This is useful if you want to avoid useless calls to the API.
- **kwargs – Extra options to send to the server (e.g. sudo)
Returns: The generated RESTObject.
Return type: object
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the server cannot perform the request
-
update
(id=None, new_data=None, **kwargs)¶ Update an object on the server.
Parameters: - id – ID of the object to update (can be None if not required)
- new_data – the update data for the object
- **kwargs – Extra options to send to the server (e.g. sudo)
Returns: The new object data (not a RESTObject)
Return type: dict
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabUpdateError
– If the server cannot perform the request
-
-
class
gitlab.v4.objects.
ProjectSnippet
(manager, attrs)¶ Bases:
gitlab.mixins.UserAgentDetailMixin
,gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
content
(**kwargs)¶ Return the content of a snippet.
Parameters: - streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for treatment.
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the content could not be retrieved
Returns: The snippet content
Return type: str
-
-
class
gitlab.v4.objects.
ProjectSnippetAwardEmoji
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectSnippetAwardEmojiManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
-
class
gitlab.v4.objects.
ProjectSnippetDiscussion
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectSnippetDiscussionManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Optional attributes:
created_at
-
class
gitlab.v4.objects.
ProjectSnippetDiscussionNote
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectSnippetDiscussionNoteManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.UpdateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Optional attributes:
created_at
Object update
Mandatory attributes for object update:
body
-
class
gitlab.v4.objects.
ProjectSnippetManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
title
file_name
code
Optional attributes:
lifetime
visibility
Object update
Optional attributes for object update:
title
file_name
code
visibility
-
class
gitlab.v4.objects.
ProjectSnippetNote
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectSnippetNoteAwardEmoji
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectSnippetNoteAwardEmojiManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
name
-
class
gitlab.v4.objects.
ProjectSnippetNoteManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
body
Object update
Mandatory attributes for object update:
body
-
class
gitlab.v4.objects.
ProjectTag
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
set_release_description
(**kwargs)¶ Set the release notes on the tag.
If the release doesn’t exist yet, it will be created. If it already exists, its description will be updated.
Parameters: - description (str) – Description of the release.
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabCreateError
– If the server fails to create the releaseGitlabUpdateError
– If the server fails to update the release
-
-
class
gitlab.v4.objects.
ProjectTagManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
tag_name
ref
Optional attributes:
message
-
class
gitlab.v4.objects.
ProjectTrigger
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
take_ownership
(**kwargs)¶ Update the owner of a trigger.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabOwnershipError
– If the request failed
-
-
class
gitlab.v4.objects.
ProjectTriggerManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
description
Object update
Mandatory attributes for object update:
description
-
class
gitlab.v4.objects.
ProjectUser
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectUserManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
search
-
class
gitlab.v4.objects.
ProjectVariable
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectVariableManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
key
value
Object update
Mandatory attributes for object update:
key
value
-
class
gitlab.v4.objects.
ProjectWiki
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
ProjectWikiManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object listing filters
with_content
Object Creation
Mandatory attributes:
title
content
Optional attributes:
format
Object update
Optional attributes for object update:
title
content
format
-
class
gitlab.v4.objects.
Runner
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
RunnerJob
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
RunnerJobManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.base.RESTManager
Object listing filters
status
-
class
gitlab.v4.objects.
RunnerManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object listing filters
scope
Object Creation
Mandatory attributes:
token
Optional attributes:
description
info
active
locked
run_untagged
tag_list
maximum_timeout
Object update
Optional attributes for object update:
description
active
tag_list
run_untagged
locked
access_level
maximum_timeout
-
all
(**kwargs)¶ List all the runners.
Parameters: - scope (str) – The scope of runners to show, one of: specific, shared, active, paused, online
- all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the server failed to perform the request
Returns: a list of runners matching the scope.
Return type: list(Runner)
-
verify
(**kwargs)¶ Validates authentication credentials for a registered Runner.
Parameters: - token (str) – The runner’s authentication token
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabVerifyError
– If the server failed to verify the token
-
class
gitlab.v4.objects.
SidekiqManager
(gl, parent=None)¶ Bases:
gitlab.base.RESTManager
Manager for the Sidekiq methods.
This manager doesn’t actually manage objects but provides helper fonction for the sidekiq metrics API.
-
compound_metrics
(**kwargs)¶ Return all available metrics and statistics.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the information couldn’t be retrieved
Returns: All available Sidekiq metrics and statistics
Return type: dict
-
job_stats
(**kwargs)¶ Return statistics about the jobs performed.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the information couldn’t be retrieved
Returns: Statistics about the Sidekiq jobs performed
Return type: dict
-
process_metrics
(**kwargs)¶ Return the registred sidekiq workers.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the information couldn’t be retrieved
Returns: Information about the register Sidekiq worker
Return type: dict
-
queue_metrics
(**kwargs)¶ Return the registred queues information.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the information couldn’t be retrieved
Returns: Information about the Sidekiq queues
Return type: dict
-
-
class
gitlab.v4.objects.
Snippet
(manager, attrs)¶ Bases:
gitlab.mixins.UserAgentDetailMixin
,gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
content
(**kwargs)¶ Return the content of a snippet.
Parameters: - streamed (bool) – If True the data will be processed by chunks of chunk_size and each chunk is passed to action for treatment.
- action (callable) – Callable responsible of dealing with chunk of data
- chunk_size (int) – Size of each chunk
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabGetError
– If the content could not be retrieved
Returns: The snippet content
Return type: str
-
-
class
gitlab.v4.objects.
SnippetManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
title
file_name
content
Optional attributes:
lifetime
visibility
Object update
Optional attributes for object update:
title
file_name
content
visibility
-
public
(**kwargs)¶ List all the public snippets.
Parameters: - all (bool) – If True the returned object will be a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabListError
– If the list could not be retrievedReturns: A generator for the snippets list
Return type:
-
class
gitlab.v4.objects.
Todo
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
mark_as_done
(**kwargs)¶ Mark the todo as done.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabTodoError
– If the server failed to perform the request
-
-
class
gitlab.v4.objects.
TodoManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object listing filters
action
author_id
project_id
state
type
-
mark_all_as_done
(**kwargs)¶ Mark all the todos as done.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabTodoError
– If the server failed to perform the request
Returns: The number of todos maked done
Return type: int
-
class
gitlab.v4.objects.
User
(manager, attrs)¶ Bases:
gitlab.mixins.SaveMixin
,gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
activate
(**kwargs)¶ Activate the user.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabActivateError
– If the user could not be activated
Returns: Whether the user status has been changed
Return type: bool
-
block
(**kwargs)¶ Block the user.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabBlockError
– If the user could not be blocked
Returns: Whether the user status has been changed
Return type: bool
-
deactivate
(**kwargs)¶ Deactivate the user.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabDeactivateError
– If the user could not be deactivated
Returns: Whether the user status has been changed
Return type: bool
-
unblock
(**kwargs)¶ Unblock the user.
Parameters: **kwargs – Extra options to send to the server (e.g. sudo)
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabUnblockError
– If the user could not be unblocked
Returns: Whether the user status has been changed
Return type: bool
-
-
class
gitlab.v4.objects.
UserActivities
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
UserActivitiesManager
(gl, parent=None)¶
-
class
gitlab.v4.objects.
UserCustomAttribute
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
UserCustomAttributeManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.SetMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
-
class
gitlab.v4.objects.
UserEmail
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
UserEmailManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
email
-
class
gitlab.v4.objects.
UserEvent
(manager, attrs)¶ Bases:
gitlab.v4.objects.Event
-
class
gitlab.v4.objects.
UserEventManager
(gl, parent=None)¶ Bases:
gitlab.v4.objects.EventManager
Object listing filters
action
target_type
before
after
sort
-
class
gitlab.v4.objects.
UserGPGKey
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
UserGPGKeyManager
(gl, parent=None)¶ Bases:
gitlab.mixins.RetrieveMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
key
-
class
gitlab.v4.objects.
UserImpersonationToken
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
UserImpersonationTokenManager
(gl, parent=None)¶ Bases:
gitlab.mixins.NoUpdateMixin
,gitlab.base.RESTManager
Object listing filters
state
Object Creation
Mandatory attributes:
name
scopes
Optional attributes:
expires_at
-
class
gitlab.v4.objects.
UserKey
(manager, attrs)¶ Bases:
gitlab.mixins.ObjectDeleteMixin
,gitlab.base.RESTObject
-
class
gitlab.v4.objects.
UserKeyManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.mixins.DeleteMixin
,gitlab.base.RESTManager
Object Creation
Mandatory attributes:
title
key
-
class
gitlab.v4.objects.
UserManager
(gl, parent=None)¶ Bases:
gitlab.mixins.CRUDMixin
,gitlab.base.RESTManager
Object listing filters
active
blocked
username
extern_uid
provider
external
search
custom_attributes
status
Object Creation
Optional attributes:
email
username
name
password
reset_password
skype
linkedin
twitter
projects_limit
extern_uid
provider
bio
admin
can_create_group
website_url
skip_confirmation
external
organization
location
avatar
Object update
Mandatory attributes for object update:
email
username
name
Optional attributes for object update:
password
skype
linkedin
twitter
projects_limit
extern_uid
provider
bio
admin
can_create_group
website_url
skip_confirmation
external
organization
location
avatar
-
class
gitlab.v4.objects.
UserProject
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
UserProjectManager
(gl, parent=None)¶ Bases:
gitlab.mixins.ListMixin
,gitlab.mixins.CreateMixin
,gitlab.base.RESTManager
Object listing filters
archived
visibility
order_by
sort
search
simple
owned
membership
starred
statistics
with_issues_enabled
with_merge_requests_enabled
Object Creation
Mandatory attributes:
name
Optional attributes:
default_branch
issues_enabled
wall_enabled
merge_requests_enabled
wiki_enabled
snippets_enabled
public
visibility
description
builds_enabled
public_builds
import_url
only_allow_merge_if_build_succeeds
-
list
(**kwargs)¶ Retrieve a list of objects.
Parameters: - all (bool) – If True, return all the items, without pagination
- per_page (int) – Number of items to retrieve per request
- page (int) – ID of the page to return (starts with page 1)
- as_list (bool) – If set to False and no pagination option is defined, return a generator instead of a list
- **kwargs – Extra options to send to the server (e.g. sudo)
Returns: The list of objects, or a generator if as_list is False
Return type: list
Raises: GitlabAuthenticationError
– If authentication is not correctGitlabListError
– If the server cannot perform the request
-
class
gitlab.v4.objects.
UserStatus
(manager, attrs)¶ Bases:
gitlab.base.RESTObject
-
class
gitlab.v4.objects.
UserStatusManager
(gl, parent=None)¶ Bases:
gitlab.mixins.GetWithoutIdMixin
,gitlab.base.RESTManager