daiddlZddlmZddlmZddlmZddlmZddlm Z ddl m Z eje ZGd d eZGd d e Zy) N)Enum)Optional) deprecated) HTTPError)Cloud) BitbucketBaseceZdZdZdZdZdZy) MergeStrategyzA Merge strategies used by the merge_pull_request method. merge_commitsquash fast_forwardN)__name__ __module__ __qualname____doc__ MERGE_COMMITSQUASH FAST_FORWARDT/var/www/timesheet/venv/lib/python3.12/site-packages/atlassian/bitbucket/__init__.pyr r s"L F!Lrr c eZdZfdZdZddZddZddZdZdZ d Z dd Z dd Z d Z d ZdZdZdZdZdZdZdZdZdZdZdZdZddZddZddZddZddZdZ d Z!d!Z"d"Z#d#Z$dd$Z%dd%Z&dd&Z'd'Z(dd(Z)d)Z*d*Z+d+Z,d,Z-dd-Z.d.Z/d/Z0d0Z1d1Z2d2Z3d3Z4dd4Z5d5Z6d6Z7d7Z8d8Z9d9Z:dd:Z;d;Zd>Z?d?Z@dd@ZAddAZBddBZCdCZDddEZEddFZFdGZGdHZHdIZIdJZJdKZKdLZLdMZMdNZNddOZOdPZPddQZQdRZRdSZSdTZTddUZUdVZVdWZWdXZXdYZYdZZZd[Z[d\Z\d]Z]d^Z^dd_Z_dd`Z` ddaZadbZbdcZcddZdddeZeddfZfddgZg ddhZhddiZi ddjZjdkZkdlZl ddmZmdnZndoZodpZpdqZq ddrZr ddsZsdtZtduZudvZvdwZwdxZxdyZydzZzd{Z{ dd|Z|d}Z} dd~Z~dZdZdZedddZdZdZ ddZ ddZ ddZdZ ddZdedededededeef dZ ddZdZdZ ddZdZdZdZedddZdZdefdZdedededededef dZdedededeefdZdZdZdZdZdZdZdZddZdZdDejLdfdZdZdZdZddZdZdZddZ ddZddZddZ ddZddZdZdZ ddZdZdZdZdZdZd„Z d dÄZddĄZddńZ ddƄZ d dDŽZddȄZddɄZddʄZd˄Zd̄Zd̈́Zd΄ZdτZdЄZdфZd҄Z̐d dӄZdԄZΐd dՄZdքZdׄZd؄ZdلZddڄZdۄZd܄Zd݄ZdބZ d d߄ZeddᬄddZeddᬄddZeddᬄ ddZeddᬄdZeddᬄdZeddᬄdZeddᬄdZeddᬄdZeddᬄ ddZeddᬄddZeddᬄdZeddᬄdZeddᬄdZeddᬄ ddZeddᬄddZeddᬄdZeddᬄdZeddᬄdZeddᬄddZeddᬄdZeddᬄdZxZS( Bitbucketcd|vr d|vrd|d<d|vrd|vr|drdnd|d<d|vr d|vrdnd |d <tt| |g|i|y) Ncloudz bitbucket.orgT api_version2.01.0zapi.bitbucket.orgzrest/apiapi_root)superr__init__)selfurlargskwargs __class__s rr#zBitbucket.__init__sq & o&<"F7O  &-4->6'?EX]F= ! f ':c'AzF:  i'=d=f=rcJ|jd}|j||S)z Preview generated HTML for the given markdown content. Only authenticated users may call this resource. :param data: :return: zmarkup/previewdata resource_urlpost)r$r+r%s rmarkup_previewzBitbucket.markup_preview%s( 01yy4y((rNc(|jd|S)Nadminrr-)r$rs r _url_adminzBitbucket._url_admin4s  k BBrc||jdd}i}|r||d<|r||d<|r||d<|j||S)a| Get list of bitbucket groups. Use 'group_filter' for get specific group or get all group if necessary. :param group_filter: str - groupname :param limit: int - paginated limit to retrieve :param start: int - paginated point to start retrieving :return: The collection as JSON with all relevant information about the group groupsrr2filterlimitstartparams)r- _get_paged)r$ group_filterr8r9r%r;s r get_groupszBitbucket.get_groups7sVe< +F8  #F7O #F7Os622rc||jd}i}|r||d<|r||d<|r||d<|j||S)z Get group of members :param group: The group name to query :param start: :param limit: :return: A list of group members z/groups/more-membersr9r8contextr:r4r<)r$groupr9r8r%r;s r group_memberszBitbucket.group_membersKsV"##78 #F7O #F7O  %F9 s622rc #HK|jD]}tjd|jd|jd|jd|jd|j |dDcgc] }|d|ddc}dycc}ww) z Get the list of project administrators :return: A generator object containing a map with the project_key, project_name and project_administrators zProcessing project: %s - %skeyname emailAddress displayName)emailrF) project_key project_nameproject_administratorsN) project_listloginfoget,project_users_with_administrator_permissions)r$projectxs rall_project_administratorsz$Bitbucket.all_project_administrators^s ((* G HH2GKK4F TZH[ \&{{51 ' F 3"NNwW\~^+ /=9IJ+   +sA?B"B B"cL|jddd}|j|S)za Rebuild the bundled Elasticsearch indexes for Bitbucket Server :return: sync rest/indexinglatestr!rr,r$r%s rreindexzBitbucket.reindexos) hWyy~rcL|jddd}|j|S)z: Check reindexing status :return: statusrWrXrYr-rPrZs rcheck_reindexing_statusz!Bitbucket.check_reindexing_statusws* ?PXYxx}rc||jdd}i}|r||d<|r||d<|r||d<|j||S)a Get list of bitbucket users. Use 'user_filter' for get specific users or get all users if necessary. :param user_filter: str - username, displayname or email :param limit: int - paginated limit to retrieve :param start: int - paginated point to start retreiving :return: The collection as JSON with all relevant information about the licensed user usersrr2r7r8r9r:r^)r$ user_filterr8r9r%r;s r get_userszBitbucket.get_userssVU; *F8  #F7O #F7OxxFx++rc|jdd}i}|r||d<|r||d<|r||d<|j||S)aC The authenticated user must have the LICENSED_USER permission to call this resource. :param user_filter: if specified only users with usernames, display name or email addresses containing the supplied string will be returned :param limit: :param start: :return: rr2z/usersr8r9r7r:rA)r$rbr9r8r%r;s rget_users_infozBitbucket.get_users_infosYU34F; #F7O #F7O *F8 s622rcJ|jd}|j|S)a Retrieves details about the current license, as well as the current status of the system with regard to the installed license. The status includes the current number of users applied toward the license limit, as well as any status messages about the license (warnings about expiry or user counts exceeding license limits). The authenticated user must have ADMIN permission. Unauthenticated users, and non-administrators, are not permitted to access license details. :return: z/license)r4rPrZs rget_current_licensezBitbucket.get_current_licenses&"#8,xx}rc(|jdS)Nz /mail-serverr4r$s r_url_mail_serverzBitbucket._url_mail_servers//#$L11rcD|j}|j|S)z Retrieves the current mail configuration. The authenticated user must have the SYS_ADMIN permission to call this resource. :return: )rkrPrZs rget_mail_configurationz Bitbucket.get_mail_configurations ##%xx}rc(|jdS)Nz/sender-address)rkrjs r_url_mail_server_sender_addressz)Bitbucket._url_mail_server_sender_addresss'')*/::rcD|j}|j|S)zE Retrieves the server email address :return: )rorPrZs rget_mail_sender_addressz!Bitbucket.get_mail_sender_addresss 224xx}rcD|j}|j|S)z Clears the server email address. The authenticated user must have the ADMIN permission to call this resource. :return: )rodeleterZs rremove_mail_sender_addressz$Bitbucket.remove_mail_sender_addresss! 224{{3rcJ|jdd}|j|S)zA Retrieve ssh settings for user :return: settingszrest/sshr!r^rZs rget_ssh_settingszBitbucket.get_ssh_settingss'  Z@xx}rcN|jd}|s|jd}|S)z Get health status https://confluence.atlassian.com/jirakb/how-to-retrieve-health-check-results-using-rest-api-867195158.html :return: zrest/troubleshooting/1.0/check/z"rest/supportHealthCheck/1.0/check/rP)r$responses r health_checkzBitbucket.health_checks*88=>xx DEHrcP|jd|d}|j|S)zv To get the build statuses associated with a commit. :commit: str- commit id :return: zcommits/zrest/build-statusrwr^)r$commitr%s rget_associated_build_statusesz'Bitbucket.get_associated_build_statusess6 vh (  xx}rc(|jdS)Nz/bannerrirjs r_url_announcement_bannerz"Bitbucket._url_announcement_banners//#$G,,rcD|j}|j|Szk Gets the announcement banner, if one exists and is available to the user :return: )rrPrZs rget_announcement_bannerz!Bitbucket.get_announcement_banners ++-xx}rcH|j}|j||S)a~ Sets the announcement banner with the provided JSON. Only users authenticated as Admins may call this resource :param body { "id": "https://docs.atlassian.com/jira/REST/schema/rest-announcement-banner#", "title": "Rest Announcement Banner", "type": "object" } :return: r*)rput)r$bodyr%s rset_announcement_bannerz!Bitbucket.set_announcement_banners%++-xx$x''rcD|j}|j|Sr)rrsrZs rdelete_announcement_bannerz$Bitbucket.delete_announcement_banner s! ++-{{3rc|jdd|jdjd}d|}dt|di}|j |||j S) z Provide plugin path for upload into BitBucket e.g. useful for auto deploy :param plugin_path: :return: GETzrest/plugins/1.0/T)methodpathheaderstrailingz upm-tokenzrest/plugins/1.0/?token=pluginrbfilesr)requestno_check_headersropenr.)r$ plugin_path upm_tokenr%rs r upload_pluginzBitbucket.upload_pluginsq LL$)) ! '+  ) 44 T23yyE43H3HyIIrcd|}|r|d|}|j|dd}|j|}|jdjdS)a Get a list of categories assigned to a project or repository. :param project_key: The project key as shown in URL. :param repository_slug: The repository as shown in URL (optional). :return: If 'repository_slug', returns the list with categories of the repository, otherwise, returns the list with the categories of the project 'project_key' zproject/z /repository/zrest/categoriesrXrYresult categoriesr^)r$rJrepository_slugr%r+s rget_categorieszBitbucket.get_categories%sc & Eo%67C.?XVxx}xx!%%l33rc(|jd||S)Nprojectsr3)r$r!rs r _url_projectszBitbucket._url_projects8s  X{CCrch|j}i}|r||d<|r||d<|j||S)zO Provide the project list :return: A list of projects r9r8r:)rr<)r$r9r8r%r;s rrMzBitbucket.project_list;sB   " #F7O #F7Os622rcT|j}|||d}|j||S)z Create project :param key: The project key :param name: The project name :param description: The project description :return: The value of the post request. )rErF descriptionr*)rr.)r$rErFrr%r+s rcreate_projectzBitbucket.create_projectIs1  "DEyy4y((rc0|j||d|SN/)rr$rJr!rs r _url_projectzBitbucket._url_projectZs!$$X{;yyE7y;;rc|j|dd}i}|r||d<|r||d<|r||d<|j||S)z Get SSH access keys added to the project :param start: :param limit: :param key: The project key :param filter_str: OPTIONAL: users filter string :return: The list of SSH access keys rest/keysrw/sshr9r8r7r:)rr<r$rEr9r8 filter_strr%r;s r project_keyszBitbucket.project_keyss^""3"=>dC #F7O #F7O )F8 s622rc*|j|dSNz/permissions/usersrrs r_url_project_userszBitbucket._url_project_userss##K011CDDrcx|j|}i}|r||d<|r||d<|r||d<|j||S)z Get users with permission in project :param key: The project key :param filter_str: OPTIONAL: users filter string :param start: :param limit: :return: The list of project users r9r8r7r:)rr<rs rrzBitbucket.project_userssQ%%c* #F7O #F7O )F8 s622rc|j|Dcgc]}|ddk(s |d}}|j|D])}|j|D]}|j|+|Scc}w)z Get project administrators for project :param key: The project key :return: List of project administrators permission PROJECT_ADMINuser)r-project_groups_with_administrator_permissionsrCappend)r$rErrLrBs rrQz6Bitbucket.project_users_with_administrator_permissionss&*%7%7%<" !\@RVe@eDL" " GGL 4E**51 4&--d3 4 4&% " s A*A*cT|j|}||d}|j||S)a- Grant the specified project permission to a specific user :param project_key: The project key :param username: username to be granted :param permission: the project permissions available are 'PROJECT_ADMIN', 'PROJECT_WRITE' and 'PROJECT_READ' :return: rrFr:)rr)r$rJusernamerr%r;s rproject_grant_user_permissionsz(Bitbucket.project_grant_user_permissionss1%%k2 *H=xxFx++rcR|j|}d|i}|j||S)a Revoke all permissions for the specified project for a user. The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher global permission to call this resource. In addition, a user may not revoke their own project permissions if they do not have a higher global permission. :param project_key: The project key :param username: username to be granted :return: rFr:)rrs)r$rJrr%r;s rproject_remove_user_permissionsz)Bitbucket.project_remove_user_permissionss1%%k2(#{{3v{..rc*|j|dSNz/permissions/groupsrrs r_url_project_groupszBitbucket._url_project_groupss##K011DEErcx|j|}i}|r||d<|r||d<|r||d<|j||S)z Get Project Groups :param limit: :param limit: :param start: :param key: The project key :param filter_str: OPTIONAL: group filter string :return: r9r8r7r:)rr<rs rrzBitbucket.project_groupssQ&&s+ #F7O #F7O )F8 s622rcT|j|}||d}|j||S)a- Grant the specified project permission to a specific group :param project_key: The project key :param group_name: group to be granted :param permission: the project permissions available are 'PROJECT_ADMIN', 'PROJECT_WRITE' and 'PROJECT_READ' :return: rr:)rr)r$rJ group_namerr%r;s rproject_grant_group_permissionsz)Bitbucket.project_grant_group_permissionss1&&{3 *J?xxFx++rcR|j|}d|i}|j||S)a Revoke all permissions for the specified project for a group. The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher global permission to call this resource. In addition, a user may not revoke a group's permissions if it will reduce their own permission level. :param project_key: The project key :param groupname: group to be granted :return: rFr:)rrs)r$rJ groupnamer%r;s r project_remove_group_permissionsz*Bitbucket.project_remove_group_permissions!s1&&{3)${{3v{..rcR|j|d|d}|j|S)a Check if the specified permission is the default permission for a given project :param project_key: The project key :param permission: the project permissions available are 'PROJECT_ADMIN', 'PROJECT_WRITE' and 'PROJECT_READ' :return: /permissions//allrr$rJrr%s rproject_default_permissionsz%Bitbucket.project_default_permissions0s0"";/0 j\Nxx}rcZ|j|d|d}|j|ddiS)a  Grant the specified project permission to all users for a given project :param project_key: The project key :param permission: the project permissions available are 'PROJECT_ADMIN', 'PROJECT_WRITE' and 'PROJECT_READ' :return: rrallowTr:rr.rs r!project_grant_default_permissionsz+Bitbucket.project_grant_default_permissions:s9"";/0 j\Nyygt_y55rcZ|j|d|d}|j|ddiS)a  Revoke the specified project permission for all users for a given project :param project_key: The project key :param permission: the project permissions available are 'PROJECT_ADMIN', 'PROJECT_WRITE' and 'PROJECT_READ' :return: rrrFr:rrs r"project_remove_default_permissionsz,Bitbucket.project_remove_default_permissionsDs:"";/0 j\Nyygu%5y66rc*|j|dSNz/settings/hooksrrs r_url_project_repo_hook_settingsz)Bitbucket._url_project_repo_hook_settingsNs##K01AArcv|j|}i}|r||d<|r||d<|r||d<|j||S)a Get all repository hooks for a given project :param project_key: The project key :param start: :param limit: OPTIONAL: The limit of the number of changes to return, this may be restricted by fixed system limits. Default by built-in method: None :param filter_type: OPTIONAL: PRE_RECEIVE|POST_RECEIVE if present, controls how repository hooks should be filtered. :return: typer9r8)rr<)r$rJr9r8 filter_typer%r;s rall_project_repo_hook_settingsz(Bitbucket.all_project_repo_hook_settingsQsN22;? (F6N #F7O #F7OsF++rcP|j|d|}|j|S)z Get a repository hook from a given project :param project_key: The project key :param hook_key: The repository hook key :return: r)rrPr$rJhook_keyr%s rget_project_repo_hook_settingsz(Bitbucket.get_project_repo_hook_settingsfs.55kBC1XJOxx}rcR|j|d|d}|j|S)z Enable a repository hook for a given project :param project_key: The project key :param hook_key: The repository hook key :return: r/enabled)rrrs r!enable_project_repo_hook_settingsz+Bitbucket.enable_project_repo_hook_settingsps055kBC1XJhWxx}rcR|j|d|d}|j|S)z Disable a repository hook for a given project :param project_key: The project key :param hook_key: The repository hook key :return: rr)rrsrs r"disable_project_repo_hook_settingsz,Bitbucket.disable_project_repo_hook_settingszs155kBC1XJhW{{3rcHdj|j|ddSNz {}/conditionsrest/default-reviewersrrYformatrrs r_url_project_conditionsz!Bitbucket._url_project_conditionss1%%   1!    rcN|j|}|j|xsiS)aZ Request type: GET Return a page of defaults conditions with reviewers list that have been configured for this project. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm52264904368 :projectKey: str :return: )r rP)r$rJr%s rget_project_conditionsz Bitbucket.get_project_conditionss'**;7xx}""rc`dj|j|dd}||d|z }|S)Nz {}/conditionrrrYrr r$rJ id_conditionr%s r_url_project_conditionz Bitbucket._url_project_conditionsL##   1!     # Q|n% %C rcP|j||}|j|xsiS)a Request type: GET Return a specific condition with reviewers list that has been configured for this project. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm52264901504 :projectKey: str - project key involved :idCondition: int - condition id involved :return: )rrPrs rget_project_conditionzBitbucket.get_project_conditions)))+|Dxx}""rcR|j|}|j||xsiS)a Request type: POST Create a new condition for this project. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm52264893584 :projectKey: str- project key involved :data: condition: dictionary object :example condition: '{"sourceMatcher": {"id":"any", "type":{"id":"ANY_REF"}}, "targetMatcher":{"id":"refs/heads/master","type":{"id":"BRANCH"}}, "reviewers":[{"id": 12}],"requiredApprovals":"0" }' :return: r*)rr.)r$rJ conditionr%s rcreate_project_conditionz"Bitbucket.create_project_conditions, ))+6yy9y-33rcT|j||}|j||xsiS)a Request type: PUT Update a new condition for this project. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm52264927632 :projectKey: str- project key involved :idCondition: int - condition id involved :data: condition: dictionary object :example condition: '{"sourceMatcher": {"id":"any", "type":{"id":"ANY_REF"}}, "targetMatcher":{"id":"refs/heads/master","type":{"id":"BRANCH"}}, "reviewers":[{"id": 12}],"requiredApprovals":"0" }' :return: r*)rr)r$rJrrr%s rupdate_project_conditionz"Bitbucket.update_project_conditions."))+|Dxx)x,22rcP|j||}|j|xsiS)a Delete a specific condition for this repository slug inside project. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm52264896304 Request type: DELETE :projectKey: str- project key involved :idCondition: int - condition id involved :return: )rrsrs rdelete_project_conditionz"Bitbucket.delete_project_conditions*))+|D{{3%2%rc\|jr td|j|ddSN Not supported in Bitbucket Cloudz rest/auditrwz/events)r Exceptionrrs r_url_project_audit_logz Bitbucket._url_project_audit_logs3 ::>? ?##K,#GHPPrcj|j|}i}|r||d<|r||d<|j||S)z Get the audit log of the project :param start: :param limit: :param project_key: The project key :return: List of events of the audit log r9r8r:)rr<r$rJr9r8r%r;s rget_project_audit_logzBitbucket.get_project_audit_logsD))+6 #F7O #F7Os622rc.|j|||dS)Nz/reposrrs r _url_reposzBitbucket._url_reposs##K;GHOOrcj|j|}i}|r||d<|r||d<|j||S)z Get repositories list from project :param project_key: The project key :param start: :param limit: :return: r9r8r:)r$r<r!s r repo_listzBitbucket.repo_listsBook* #F7O #F7Os622rc(|j|dS)ze Get all repositories list from project :param project_key: :return: N)r8)r&rs r repo_all_listzBitbucket.repo_all_lists ~~k~66rFcX|j|}|d||d}|j||S)aCreate a new repository. Requires an existing project in which this repository will be created. The only parameters which will be used are name and scmId. The authenticated user must have PROJECT_ADMIN permission for the context project to call this resource. :param project_key: The project matching the projectKey supplied in the resource path as shown in URL. :type project_key: str :param repository_slug: Name of repository to create (i.e. "My repo"). :param forkable: Set the repository to be forkable or not. :type forkable: bool :param is_private: Set the repository to be private or not. :type is_private: bool :return: 201 - application/json (repository) 400 - application/json (errors) 401 - application/json (errors) 409 - application/json (errors) :rtype: requests.Response git)rFscmIdforkable is_privater*)r$r.)r$rJrr,r-r%r+s r create_repozBitbucket.create_repos:,ook*# $   yy4y((rc2|j|||d|Sr)r$)r$rJrepor!rs r _url_repozBitbucket._url_repo;s!//+xEFavNNrcndj|j||dd}|j|S)zk Reindex repo :param project_key: :param repository_slug: :return: z{urlRepo}/syncrWrrY)urlRepo)r r1r.r$rJrr%s r reindex_repozBitbucket.reindex_repo>sF%%NN(! #& yy~rcR|j||dd}|j|S)a Reindex all the Jira issues related to this repository_slug, including branches and pull requests. This automatically happens as part of an upgrade, and calling this manually should only be required if something unforeseen happens and the index becomes out of sync. The authenticated user must have REPO_ADMIN permission for the specified repository to call this resource. :param project_key: :param repository_slug: :return: z rest/jira-devrwz/reindexr1r.r4s rreindex_repo_dev_panelz Bitbucket.reindex_repo_dev_panelOs/ _WXX`ayy~rcH|j||}|j|S)aG Get a specific repository from a project. This operates based on slug not name which may be confusing to some users. :param project_key: Key of the project you wish to look in. :param repository_slug: url-compatible repository identifier :return: Dictionary of request response )r1rPr4s rget_repozBitbucket.get_repo\s"nn[/:xx}rcd} |j||d}|S#t$r$}|jjdvr Yd}~|Sd}~wwxYw)ak Check if given combination of project and repository exists and available. :param project_key: Key of the project where to check for repository. :param repository_slug: url-compatible repository identifier to look for. :return: False is requested repository doesn't exist in the project or not accessible to the requestor FTrN)r:rr{r)r$rJrrrs r repo_existszBitbucket.repo_existsgsU  MM+ 7F  zz%%3  s AAAc L|j||}|j||S)a> Update a repository in a project. This operates based on slug not name which may be confusing to some users. :param project_key: Key of the project you wish to look in. :param repository_slug: url-compatible repository identifier :return: The value of the put request. r*)r1r)r$rJrr;r%s r update_repozBitbucket.update_repows'nn[/:xx&x))rcH|j||}|j|S)aJ Delete a specific repository from a project. This operates based on slug not name which may be confusing to some users. :param project_key: Key of the project you wish to look in. :param repository_slug: url-compatible repository identifier :return: Dictionary of request response )r1rsr4s r delete_repozBitbucket.delete_repos#nn[/:{{3rcl|j||}i}| ||d<d|i|d<|j||S)z Forks a repository within the same project. :param project_key: :param repository_slug: :param new_repository_slug: :return: rFrErRr*r7)r$rJrnew_repository_slugr%rs rfork_repositoryzBitbucket.fork_repositorysInn[/:  *.DL$k2DOyy4y((rcp|j||}i}|| ||d<d|i|d<|j||S)a+ Forks a repository to a separate project. :param project_key: Origin Project Key :param repository_slug: Origin repository slug :param new_project_key: Project Key of target project :param new_repository_slug: Target Repository slug :return: rFrErRr*r7)r$rJrnew_project_keyrBr%rs rfork_repository_new_projectz%Bitbucket.fork_repository_new_projectsNnn[/:  */J.DL$o6DOyy4y((rc|j||dd}i}|r||d<|r||d<|r||d<|j||S)a  Get SSH access keys added to the repository :param start: :param limit: :param project_key: The project key :param repo_key: The repository key :param filter_str: OPTIONAL: users filter string :return: rrwrr9r8r7r:r1r<r$rJrepo_keyr9r8rr%r;s r repo_keyszBitbucket.repo_keyss] X LMTR #F7O #F7O )F8 s622rc,|j||dSrr1r$rJr0s r_url_repo_userszBitbucket._url_repo_userss..d344FGGrcz|j||}i}|r||d<|r||d<|r||d<|j||S)a Get users with permission in repository :param start: :param limit: :param project_key: The project key :param repo_key: The repository key :param filter_str: OPTIONAL: Users filter string :return: r9r8r7r:)rOr<rIs r repo_userszBitbucket.repo_userssS"";9 #F7O #F7O )F8 s622rcV|j||}||d}|j||S)a] Grant the specified repository permission to a specific user :param project_key: The project key :param repo_key: The repository key (slug) :param username: username to be granted :param permission: the repository permissions available are 'REPO_ADMIN', 'REPO_WRITE' and 'REPO_READ' :return: rr:)rOr)r$rJrJrrr%r;s rrepo_grant_user_permissionsz%Bitbucket.repo_grant_user_permissionss3"";9 *H=xxFx++rcT|j||}d|i}|j||S)a$ Revoke all permissions for the specified repository for a user. The authenticated user must have REPO_ADMIN permission for the specified repository or a higher project or global permission to call this resource. In addition, a user may not revoke their own repository permissions if they do not have a higher project or global permission. :param project_key: The project key :param repo_key: The repository key (slug) :param username: username to be granted :return: rFr:)rOrs)r$rJrJrr%r;s rrepo_remove_user_permissionsz&Bitbucket.repo_remove_user_permissionss3"";9(#{{3v{..rc,|j||dSrrMrNs r_url_repo_groupszBitbucket._url_repo_groupss..d344GHHrcz|j||}i}|r||d<|r||d<|r||d<|j||S)z Get repository Groups :param start: :param limit: :param project_key: The project key :param repo_key: The repository key :param filter_str: OPTIONAL: group filter string :return: r9r8r7r:)rWr<rIs r repo_groupszBitbucket.repo_groupssS##K: #F7O #F7O )F8 s622rch|j|Dcgc]}|ddk(s |ddc}Scc}w)zX Get groups with admin permissions :param key: :return: rrrBrF)r)r$rErBs rrz7Bitbucket.project_groups_with_administrator_permissionss; 594G4G4Lw5PUVbPcgvPvgv&wwws / /cg}|j||D]}|ddk(s |j||j||D])}|j|D]}|j|+|j |D]}|j|t |Dcic]}|d| c}j Scc}w)z Get repository administrators for repository :param project_key: The project key :param repo_key: The repository key :return: List of repo administrators r REPO_ADMINid)rQr*repo_groups_with_administrator_permissionsrCrQlistvalues)r$rJrJrepo_administratorsrrBs r)repo_users_with_administrator_permissionsz3Bitbucket.repo_users_with_administrator_permissionss!OOK: 1DL!\1#**40 1DD[RZ[ 1E**51 1#**40 1 1EEkR -D  & &t , -2EF$T$Z%FMMOPPFs" Ccg}|j||D]"}|ddk(s |j|dd$|j|D]}|j|tt |S)zy Get groups with admin permissions :param project_key: :param repo_key: :return: rr\rBrF)rYrrr_set)r$rJrJrepo_group_administratorsrBs rr^z4Bitbucket.repo_groups_with_administrator_permissions,s%'!%%k8< IE\"l2)00w1GH IGG T 4E % , ,U 3 4C1233rcV|j||}||d}|j||S)a Grant the specified repository permission to a specific group Promote or demote a group's permission level for the specified repository. Available repository permissions are: REPO_READ REPO_WRITE REPO_ADMIN See the Bitbucket Server documentation for a detailed explanation of what each permission entails. The authenticated user must have REPO_ADMIN permission for the specified repository or a higher project or global permission to call this resource. In addition, a user may not demote a group's permission level if their own permission level would be reduced as a result. :param project_key: The project key :param repo_key: The repository key (slug) :param groupname: group to be granted :param permission: the repository permissions available are 'REPO_ADMIN', 'REPO_WRITE' and 'REPO_READ' :return: rr:)rWrr$rJrJrrr%r;s rrepo_grant_group_permissionsz&Bitbucket.repo_grant_group_permissions<s3$##K: *I>xxFx++rcb|j||}d|i}|r||d<|j||S)ar Revoke all permissions for the specified repository for a group. The authenticated user must have REPO_ADMIN permission for the specified repository or a higher project or global permission to call this resource. In addition, a user may not revoke a group's permissions if it will reduce their own permission level. :param project_key: The project key :param repo_key: The repository key (slug) :param groupname: group to be granted :param permission: the repository permissions available are 'REPO_ADMIN', 'REPO_WRITE' and 'REPO_READ' :return: rFrr:)rWrsrgs rrepo_remove_group_permissionsz'Bitbucket.repo_remove_group_permissionsRs@##K:)$ #-F< {{3v{..rcZ|jr td|j||dS)Nrz/labelsrrr1r$rJrs r_url_repo_labelszBitbucket._url_repo_labelsds. ::>? ?..o>?wGGrcH|j||}|j|S)aj Get labels for a specific repository from a project. This operates based on slug not name which may be confusing to some users. (BitBucket Server only) :param project_key: Key of the project you wish to look in. :param repository_slug: url-compatible repository identifier :return: Dictionary of request response )rnrPr4s rget_repo_labelszBitbucket.get_repo_labelsjs$##KAxx}rcT|j||}d|i}|j||S)a Sets a label on a repository. (BitBucket Server only) The authenticated user must have REPO_ADMIN permission for the specified repository to call this resource. :param project_key: Key of the project you wish to look in. :param repository_slug: url-compatible repository identifier :param label_name: label name to apply :return: rFr*)rnr.)r$rJr label_namer%r+s rset_repo_labelzBitbucket.set_repo_labelus3##KA #yy4y((rc^|jr td|j||ddSrrlrms r_url_repo_audit_logzBitbucket._url_repo_audit_logs3 ::>? ?..o .UVV]^^rcl|j||}i}|r||d<|r||d<|j||S)a Get the audit log of the repository :param start: :param limit: :param project_key: Key of the project you wish to look in. :param repository_slug: url-compatible repository identifier :return: List of events of the audit log r9r8r:)rur<)r$rJrr9r8r%r;s rget_repo_audit_logzBitbucket.get_repo_audit_logsF&&{OD #F7O #F7Os622rc0|j|||dS)Nrwz /branchesrMr$rJrr!s r_url_repo_brancheszBitbucket._url_repo_branchess ..o.QRR[\\rc |j||} i} |r|| d<|r|| d<|r|| d<|r|| d<|r|| d<|| d<| | d<|j| | S) a Retrieve the branches matching the supplied filterText param. The authenticated user must have REPO_READ permission for the specified repository to call this resource. :param start: :param project_key: :param repository_slug: :param base: base branch/tag to compare each branch to (for the metadata providers that uses that information) :param filter: :param limit: OPTIONAL: The limit of the number of branches to return, this may be restricted by fixed system limits. Default by built-in method: None :param details: whether to retrieve plugin-provided metadata about each branch :param order_by: OPTIONAL: ordering of refs either ALPHABETICAL (by name) or MODIFICATION (last updated) :param boost_matches: Controls whether exact and prefix matches will be boosted to the top :return: r9r8 filterTextbaseorderBydetails boostMatchesr:)rzr<) r$rJrr}r7r9r8rorder_by boost_matchesr%r;s r get_brancheszBitbucket.get_branchess6%%k?C #F7O #F7O #)F< !F6N  (F9 #y!.~s622rc,|j||dS)Nz/default)rzrms r_url_repo_default_branchez#Bitbucket._url_repo_default_branches))+GHQQrcH|j||}|j|S)a Get the default branch of the repository. The authenticated user must have REPO_READ permission for the specified repository to call this resource. :param project_key: The project key :param repository_slug: The repository key :return: )rrPr4s rget_default_branchzBitbucket.get_default_branchs$,,[/Jxx}rcT|j||}d|i}|j||S)af Update the default branch of a repository. The authenticated user must have REPO_ADMIN permission for the specified repository to call this resource. :param project_key: The project key :param repository_slug: The repository key (slug) :param ref_branch_name: ref name like refs/heads/master :return: r]r*)rr)r$rJrref_branch_namer%r+s rset_default_branchzBitbucket.set_default_branchs3,,[/Jo&xx$x''rcX|j||}|||d}|j||S)aXCreates a branch using the information provided in the request. The authenticated user must have REPO_WRITE permission for the context repository to call this resource. :param project_key: The project matching the projectKey supplied in the resource path as shown in URL. :type project_key: str :param repository_slug: Name of repository where branch is created (i.e. "my_repo"). :param name: Name of branch to create (i.e. "my_branch"). :type name: str :param start_point: Name of branch to branch from. :type start_point: str :param message: Branch message. :type message: str :return: 200 - application/json (repository) 401 - application/json (errors) 404 - application/json (errors) :rtype: requests.Response )rF startPointmessager*)rzr.)r$rJrrF start_pointrr%r+s r create_branchzBitbucket.create_branchs5(%%k?CKGLyy4y((rcx|j||d}dt|i}|r||d<|j||S)z Delete branch from related repo :param self: :param project_key: :param repository_slug: :param name: :param end_point: :return: rest/branch-utilsrwrFendPointr*)rzstrrs)r$rJrrF end_pointr%r+s r delete_branchzBitbucket.delete_branchsJ%%k?M`%aD " (D {{3T{**rcv|jr|j|||dS|j|||dS)Nrwz /refs/tagsz/tags)rr1rys r_url_repo_tagszBitbucket._url_repo_tags sE ::nn[/HnUVV`a ann[/HnUVV[\ \rc|j||}i}|r||d<|r||d<|r||d<|r||d<|j||S)aQ Retrieve the tags matching the supplied filterText param. The authenticated user must have REPO_READ permission for the context repository to call this resource. :param project_key: :param repository_slug: :param filter: :param start: :param limit: OPTIONAL: The limit of the number of tags to return, this may be restricted by fixed system limits. Default by built-in method: 1000 :param order_by: OPTIONAL: ordering of refs either ALPHABETICAL (by name) or MODIFICATION (last updated) :return: r9r8r|r~r:)rr<) r$rJrr7r8rr9r%r;s rget_tagszBitbucket.get_tagss`*!!+? #F7O #F7O #)F<  (F9 s622rcx|j||}||j|d|S|j|S)aw Retrieve a tag in the specified repository. The authenticated user must have REPO_READ permission for the context repository to call this resource. Search uri is api/1.0/projects/{projectKey}/repos/{repositorySlug}/tags/{name:.*} :param project_key: :param repository_slug: :param tag_name: OPTIONAL: :return: r)rrPr<r$rJrtag_namer%s rget_project_tagszBitbucket.get_project_tags1sE!!+?  88se1XJ/0 0s##rcd|j||}||d}|||d<|j||S)a Creates a tag using the information provided in the {@link RestCreateTagRequest request} The authenticated user must have REPO_WRITE permission for the context repository to call this resource. :param project_key: :param repository_slug: :param tag_name: :param commit_revision: commit hash :param description: OPTIONAL: :return: )rFrrr*)rr.)r$rJrrcommit_revisionrr%rs rset_tagzBitbucket.set_tagAsG$!!+?)   ")DOyy4y((rcV|j||dd|}|j|S)aA Creates a tag using the information provided in the {@link RestCreateTagRequest request} The authenticated user must have REPO_WRITE permission for the context repository to call this resource. :param project_key: :param repository_slug: :param tag_name: :return: zrest/gitrwr)rrsrs r delete_tagzBitbucket.delete_tag]s9$$[/J$WXXYZbYcd{{3rc,|j||dSrrMrms r_url_repo_hook_settingsz!Bitbucket._url_repo_hook_settingsis..o>?OOrcx|j||}i}|r||d<|r||d<|r||d<|j||S)a Get all repository hooks for a given repo :param project_key: The project key :param repository_slug: The repository key :param start: :param limit: OPTIONAL: The limit of the number of changes to return, this may be restricted by fixed system limits. Default by built-in method: None :param filter_type: OPTIONAL: PRE_RECEIVE|POST_RECEIVE if present, controls how repository hooks should be filtered. :return: rr9r8)rr<)r$rJrr9r8rr%r;s rall_repo_hook_settingsz Bitbucket.all_repo_hook_settingslsP&**;H (F6N #F7O #F7OsF++rcR|j||d|}|j|S)z Get a repository hook from a given repo :param project_key: The project key :param repository_slug: The repository key :param hook_key: The repository hook key :return: r)rrPr$rJrrr%s rget_repo_hook_settingsz Bitbucket.get_repo_hook_settingss0--k?KLAhZXxx}rcT|j||d|d}|j|S)z Enable a repository hook for a given repo :param project_key: The project key :param repository_slug: The repository key :param hook_key: The repository hook key :return: rr)rrrs renable_repo_hook_settingsz#Bitbucket.enable_repo_hook_settingss3--k?KLAhZW_`xx}rcT|j||d|d}|j|S)z Disable a repository hook for a given repo :param project_key: The project key :param repository_slug: The repository key :param hook_key: The repository hook key :return: rr)rrsrs rdisable_repo_hook_settingsz$Bitbucket.disable_repo_hook_settingss4--k?KLAhZW_`{{3rc,|j||dS)Nz /webhooksrMrms r _url_webhookszBitbucket._url_webhookss..o>?yIIrcl|j||}i}|r||d<|r||d<|j||S)z Get webhooks :param project_key: :param repository_slug: :param event: OPTIONAL: defaults to None :param statistics: OPTIONAL: defaults to False :return: event statisticsr:)rr<)r$rJrrrr%r;s r get_webhookszBitbucket.get_webhookssG  o> #F7O #-F< s622rcl|j||}||||d} |rd|i| d<|j|| S)aCreates a webhook using the information provided in the request. The authenticated user must have REPO_ADMIN permission for the context repository to call this resource. :param project_key: The project matching the projectKey supplied in the resource path as shown in URL. :param repository_slug: :param name: Name of webhook to create. :param events: List of event. (i.e. ["repo:refs_changed", "pr:merged", "pr:opened"]) :param webhook_url: :param active: :param secret: The string is used to verify data integrity between Bitbucket and your endpoint. :return: )rFeventsr%activesecret configurationr*)rr.) r$rJrrFr webhook_urlrrr%rs rcreate_webhookzBitbucket.create_webhooksP.  o>   %-v$6D !yy4y((rc0|j||d|Sr)r)r$rJr webhook_ids r _url_webhookzBitbucket._url_webhooks!$$[/BC1ZLQQrcJ|j|||}|j|S)a* Retrieve a webhook. The authenticated user must have REPO_ADMIN permission for the context repository to call this resource. :param project_key: :param repository_slug: :param webhook_id: the ID of the webhook within the repository :return: )rrPr$rJrrr%s r get_webhookzBitbucket.get_webhooks& _jIxx}rc N|j|||}|j||S)a( Update a webhook. The authenticated user must have REPO_ADMIN permission for the context repository to call this resource. :param project_key: :param repository_slug: :param webhook_id: the ID of the webhook within the repository :return: r*)rr)r$rJrrr;r%s rupdate_webhookzBitbucket.update_webhooks+ _jIxx&x))rcJ|j|||}|j|S)a( Delete a webhook. The authenticated user must have REPO_ADMIN permission for the context repository to call this resource. :param project_key: :param repository_slug: :param webhook_id: the ID of the webhook within the repository :return: )rrsrs rdelete_webhookzBitbucket.delete_webhooks' _jI{{3rc,|j||dS)Nz/settings/pull-requestsrMrms r_url_pull_request_settingsz$Bitbucket._url_pull_request_settings s..o>??VWWrcH|j||}|j|S)zy Get pull request settings. :param project_key: :param repository_slug: :return: )rrPr4s rget_pull_request_settingsz#Bitbucket.get_pull_request_settingss$--k?Kxx}rcL|j||}|j||S)z Set pull request settings. :param project_key: :param repository_slug: :param data: json body :return: r*)rr.r$rJrr+r%s rset_pull_request_settingsz#Bitbucket.set_pull_request_settingss)--k?Kyy4y((rct|jr|jd|d|dS|j||dS)Nz repositories/rz /pullrequests/pull-requests)rr-r1rms r_url_pull_requestszBitbucket._url_pull_requests%sD ::$$}[M?BSS`%ab bnn[/BC>R Rrc |j||} i} |r|| d<|r|| d<|r|| d<|r|| d<|r|| d<|r|| d<|j| | S)a! Get pull requests :param project_key: :param repository_slug: :param state: :param order: OPTIONAL: defaults to NEWEST the order to return pull requests in, either OLDEST (as in: "oldest first") or NEWEST. :param limit: :param start: :param at: :param filter_text: (optional) If specified, only pull requests where the title or description contains the supplied string will be returned. :return: stater8r9orderatr|r:)rr<) r$rJrrrr8r9r filter_textr%r;s rget_pull_requestszBitbucket.get_pull_requests+sw"%%k?C #F7O #F7O #F7O #F7O F4L #.F< s622rcdj|j||dd}|j||d}|j||d} ||| |d} |j|| S)a Get required reviewers for PR creation :param source_project: the project that the PR source is from :param source_repo: the repository that the PR source is from :param source_branch: the branch name of the PR :param dest_project: the project that the PR destination is from :param dest_repo: the repository that the PR destination is from :param dest_branch: where the PR is being merged into :return: z {}/reviewersrrrYr]) sourceRepoId sourceRefId targetRepoId targetRefIdr:)r r1r:rP) r$source_project source_repo dest_project dest_repo source_branch dest_branchr%source_repo_id dest_repo_idr;s r'get_required_reviewers_for_pull_requestz1Bitbucket.get_required_reviewers_for_pull_requestLs## NN1!   ~{CDI}}\9=dC *((&   xxFx++rc H|||||d|idd|||d|iddgdfd} |js*| r(|j||||||} | D] } | | d| 8t| tr | | nt| tr| D] }| | |j ||S)aQ Create a new pull request between two branches. The branches may be in the same repository_slug, or different ones. When using different repositories, they must still be in the same {@link Repository#getHierarchyId() hierarchy}. The authenticated user must have REPO_READ permission for the "from" and "to"repositories to call this resource. :param source_project: the project that the PR source is from :param source_repo: the repository that the PR source is from :param dest_project: the project that the PR destination is from :param dest_repo: the repository that the PR destination is from :param source_branch: the branch name of the PR :param destination_branch: where the PR is being merged into :param title: the title of the PR :param description: the description of what the PR does :param reviewers: the list of reviewers or a single reviewer of the PR :param include_required_reviewers: OPTIONAL defaults to False, include required reviewers for the PR :return: rE)slugrFrR)r] repository)titlerfromReftoRef reviewersc:dd|ii}dj|y)NrrFr)r) reviewer_nameentryrs r add_reviewerz1Bitbucket.open_pull_request..add_reviewers%fm45E   $ $U +rrF)rr isinstancerr_create_pull_request)r$rrrrrdestination_branchrrrinclude_required_reviewersrrequired_reviewersrequired_reviewerreviewerrs @ropen_pull_requestzBitbucket.open_pull_requestks>&#'' %~6)%% %|4' , ,zz8!%!M!M \9mUg" &8 8!.v67 8  )S)Y'It, )+H *+'' iFFrcL|j||}|j||S)zu :param project_key: :param repository_slug: :param data: json body :return: r*)rr.rs rrzBitbucket.create_pull_requests)%%k?Cyy4y((rc0|j||d|Srrr$rJrpull_request_ids r_url_pull_requestzBitbucket._url_pull_requests"))+GH/IZ[[rcJ|j|||}|j|S)aW Retrieve a pull request. The authenticated user must have REPO_READ permission for the repository that this pull request targets to call this resource. :param project_key: :param repository_slug: :param pull_request_id: the ID of the pull request within the repository :return: rrPr$rJrrr%s rget_pull_requestzBitbucket.get_pull_requests&$$[/?Sxx}rz1.15.1zUse get_pull_request())versionreasoncy)zP Deprecated name since 1.15.1. Let's use the get_pull_request() Nr)r$r&r's rget_pullrequestzBitbucket.get_pullrequestsrcN|j|||}|j||S)au Update a pull request. The authenticated user must have REPO_WRITE permission for the repository that this pull request targets to call this resource. :param project_key: :param repository_slug: :param pull_request_id: the ID of the pull request within the repository :param data: json body :return: r*)rr)r$rJrrr+r%s rupdate_pull_requestzBitbucket.update_pull_requests+$$[/?Sxx$x''rcV|j|||}d|i}|j||S)a0 Delete a pull request. :param project_key: the project key :param repository_slug: the repository slug :param pull_request_id: the ID of the pull request within the repository :param pull_request_version: the version of the pull request :return: rr*)rrs)r$rJrrpull_request_versionr%r+s rdelete_pull_requestzBitbucket.delete_pull_requests6 $$[/?S/0{{3T{**rc|jr|j|||d}n|j|||d}i}|r||d<|r||d<|j||S)z Get pull requests activities :param limit: :param project_key: :param repository_slug: :param pull_request_id: the ID of the pull request within the repository :param start: :return: z /activityz /activitiesr9r8)rrr<r$rJrrr9r8r%r;s rget_pull_requests_activitiesz&Bitbucket.get_pull_requests_activitiesss" ::++K/Z[[deC++K/Z[[fgC #F7O #F7OsF++rcr|j|||d}i}|r||d<|r||d<|j||S)z Get pull requests changes :param start: :param limit: :param project_key: :param repository_slug: :param pull_request_id: the ID of the pull request within the repository :return: z/changesr9r8rr<r s rget_pull_requests_changesz#Bitbucket.get_pull_requests_changessO"'' _oVWW_` #F7O #F7OsF++rcr|j|||d}i}|r||d<|r||d<|j||S)a Get pull requests commits :param start: :param limit: :param project_key: :param repository_slug: :param pull_request_id: the ID of the pull request within the repository :start :limit :return: z/commitsr9r8r r s rget_pull_requests_commitsz#Bitbucket.get_pull_requests_commits+sO&'' _oVWW_` #F7O #F7OsF++rc2|j||d|dS)Nrz /participantsrrs r_url_pull_request_participantsz(Bitbucket._url_pull_request_participantsFs%))+GH/IZZghhrcl|j|||}i}|r||d<|r||d<|j||S)z Get all participants of a pull request :param start: :param limit: :param project_key: :param repository_slug: :param pull_request_id: :return: r9r8)rr<r s rget_pull_requests_participantsz(Bitbucket.get_pull_requests_participantsIsG"11+P_` #F7O #F7OsF++rrJrrrolerreturnc\|j|||}|d|id}|j||S)a` Assign a role to a user for a pull request :param project_key: The project key :param repository_slug: The repository key :param pull_request_id: The pull request id :param role: The role to assign, currently it only accepts REVIEWER :param user: The user to assign the role to :return: rF)rrr*)rr.)r$rJrrrrr%r+s r$assign_pull_request_participant_rolez.Bitbucket.assign_pull_request_participant_rolebs:11+P_`vtn5yy4y((rc|jr td|jd}i} |r|| d<||| d<||| d<||| d<||| d<||| d<||| d <|j|| S) a Get all pull requests where the current authenticated user is involved as either a reviewer, author or a participant :param start: :param limit: :param closed_since: OPTIONAL, defaults to returning pull requests regardless of closed since date. Permits returning only pull requests with a closed timestamp set more recently that (now - closedSince). Units are in seconds. So for example if closed since 86400 is set only pull requests closed in the previous 24 hours will be returned. :param role: OPTIONAL, defaults to returning pull requests for any role. If a role is supplied only pull requests where the authenticated user is a participant in the given role will be returned. Either REVIEWER, AUTHOR or PARTICIPANT. :param participant_status: OPTIONAL, defaults to returning pull requests with any participant status. A comma separated list of participant status. That is, one or more of UNAPPROVED, NEEDS_WORK, or APPROVED. :param state: OPTIONAL, defaults to returning pull requests in any state. If a state is supplied only pull requests in the specified state will be returned. Either OPEN, DECLINED or MERGED. Omit this parameter to return pull request in any state. :param order: OPTIONAL, defaults to NEWEST, the order to return pull requests in, either OLDEST (as in: "oldest first"), NEWEST, PARTICIPANT_STATUS, or CLOSED_DATE. Where CLOSED_DATE is specified and the result set includes pull requests that are not in the closed state, these pull requests will appear first in the result set, followed by most recently closed pull requests. :return: rzdashboard/pull-requestsr9r8 closedSincerparticipantStatusrrr:)rrr-r<) r$r9r8 closed_sincerparticipant_statusrrr%r;s rget_dashboard_pull_requestsz%Bitbucket.get_dashboard_pull_requestsrsX ::>? ? 9: #F7O  #F7O  #$0F= !  !F6N  )*? ?'' _oVWW]^xx}rcR|jr td|jdS)Nrtasks)rrr-rjs r _url_taskszBitbucket._url_tasksrs& ::>? ?  ))rcX|j}|dd|d}|j||S)z Add task to the comment :param anchor: ID of the comment, :param text: task text :return: COMMENT)r]r)anchorr(r*)rJr.)r$rMr(r%r+s radd_taskzBitbucket.add_taskws2oo!';TJyy4y((rc,|jd|Sr)rJ)r$task_ids r _url_taskzBitbucket._url_tasks//#$AgY//rcF|j|}|j|S)zU Get task information by ID :param task_id: :return: )rQrPr$rPr%s rget_taskzBitbucket.get_tasks nnW%xx}rcF|j|}|j|S)zL Delete task by ID :param task_id: :return: )rQrsrSs r delete_taskzBitbucket.delete_tasks! nnW%{{3rcn|j|}d|i}|r||d<|r||d<|j||S)z Update task by ID. It is possible to update state and/or text of the task :param task_id: :param text: :param state: OPEN, RESOLVED :return: r]r(rr*)rQr)r$rPr(rr%r+s r update_taskzBitbucket.update_tasksFnnW%g DL !DMxx$x''rcP|j|||d}|j|S)a Test whether a pull request can be merged. A pull request may not be merged if: - there are conflicts that need to be manually resolved before merging; and/or - one or more merge checks have vetoed the merge. The authenticated user must have REPO_READ permission for the repository that this pull request targets to call this resource. :param project_key: PROJECT :param repository_slug: my_shiny_repo :param pr_id: 2341 :return: /merger)r$rJrrCr%s ris_pull_request_can_be_mergedz'Bitbucket.is_pull_request_can_be_mergeds.'' _eLMVTxx}rc|j|||d}i} d||t|jd} |js|| d<|j || | S)a Merge pull request The authenticated user must have REPO_READ permission for the repository that this pull request targets to call this resource. :param project_key: PROJECT :param repository_slug: my_shiny_repo :param pr_id: 2341 :param merge_message: "feat: add new file handler" :param pr_version: :param close_source_branch: True :param merge_strategy: "squash" :return: rZ pullrequest)rrclose_source_branchmerge_strategyr)r+r;)rr valuerr.) r$rJrrC merge_messager^r_rDr%r;r+s rmerge_pull_requestzBitbucket.merge_pull_requestsk0'' _eLMVT!$#6+N;AA   zz *F9 yy4y77rc\|j|||d}d|i}|j||S)a^ Re-open a declined pull request. The authenticated user must have REPO_READ permission for the repository that this pull request targets to call this resource. :param project_key: PROJECT :param repository_slug: my_shiny_repo :param pr_id: 2341 :param pr_version: 12 :return: z/reopenrr:)rr.rBs rreopen_pull_requestzBitbucket.reopen_pull_requests='' _eLMWUZ(yyVy,,rcy)Nzinbox/pull-requestsrrjs r_url_inbox_pull_requestsz"Bitbucket._url_inbox_pull_requestss$rcJ|jd}|j|S)Nz/count)rfrPrZs rcheck_inbox_pull_requests_countz)Bitbucket.check_inbox_pull_requests_counts&..018xx}rcl|j}d|i}|r||d<|r||d<|j||S)z Get pull request in your inbox :param start: :param limit: :param role: :return: r9r8rr:)rfr<)r$r9r8rr%r;s rcheck_inbox_pull_requestsz#Bitbucket.check_inbox_pull_requestssG++-5! #F7O !F6Ns622rc0|j||d}|S)Nz/comparerMr4s r_url_repo_comparezBitbucket._url_repo_compare s _=>hG rc|j||d|}i}|r||d<|r||d<|j||xsijdS)aX Gets a diff of the changes available in the {@code from} commit but not in the {@code to} commit. If either the {@code from} or {@code to} commit are not specified, they will be replaced by the default branch of their containing repository. :param project_key: :param repository_slug: :param path: :param hash_oldest: the source commit (can be a partial/full commit ID or qualified/unqualified ref name) :param hash_newest: the target commit (can be a partial/full commit ID or qualified/unqualified ref name) :return: z/diff/fromtor:diffs)rlrP)r$rJrr hash_oldest hash_newestr%r;s rget_diffzBitbucket.get_diff sb'' _EFfTFS (F6N &F4LV,277@@rcJdj|j||||S)Nz {}/commitsrYr r1)r$rJrr!rs r _url_commitszBitbucket._url_commits s2"" NN!'    rc$|j||}d|i}|r||d<|r||d<|r||d<|r||d<|r||d<| r| |d<| r| |d<| r| |d <|jr| s| r td | r| |d<| r| |d<|r||d <|j|| S) a Get commit list from repo :param project_key: :param repository_slug: :param hash_oldest: :param hash_newest: :param merges: OPTIONAL: include|exclude|only if present, controls how merge commits should be filtered. :param follow_renames: OPTIONAL: if true, the commit history of the specified file will be followed past renames :param ignore_missing: OPTIONAL: true to ignore missing commits, false otherwise :param with_counts: OPTIONAL: optionally include the total number of commits and total number of unique authors :param avatar_size: OPTIONAL: if present the service adds avatar URLs for commit authors. :param avatar_scheme: OPTIONAL: the desired scheme for the avatar URL :param limit: OPTIONAL: The limit of the number of commits to return, this may be restricted by fixed system limits. Default by built-in method: None :param until: OPTIONAL: The commit ID or ref (inclusively) to retrieve commits before :param since: OPTIONAL: The commit ID or ref (exclusively) to retrieve commits after :param path: OPTIONAL: An optional path to filter commits by :return: mergessinceuntil followRenames ignoreMissing withCounts avatarSize avatarSchemer8rrr:)rvrrr<)r$rJrrqrrfollow_renamesignore_missingrx with_counts avatar_size avatar_schemer8rzryrr%r;s r get_commitszBitbucket.get_commits% sH _=F# )F7O )F7O &4F? # &4F? # #.F< #.F< %2F> " #F7O ::5E>? ? #F7O #F7O !F6Ns622rcf|j|||}d|i}|r||d<|j||S)a Get commit list from repo :param project_key: :param repository_slug: :param hash_newest: :param merges: OPTIONAL: include|exclude|only if present, controls how merge commits should be filtered. :param commit_id :return: ) commit_idrxrzr:) _url_commit_crP)r$rJrrrrxrr%r;s rget_commit_changeszBitbucket.get_commit_changese sD  o SF# )F7OxxFx++rcLdj|j|||||S)Nz{}/commits/{}/changesrYru)r$rJrr!rrs rrzBitbucket._url_commit_cu s7&-- NN!'     rcLdj|j|||||S)Nz{}/{}rY)r rv)r$rJrrr!rs r _url_commitzBitbucket._url_commit s9~~   !'     rc`|j|||}i}|r||d<|j||S)a Retrieve a single commit identified by its ID>. In general, that ID is a SHA1. From 2.11, ref names like "refs/heads/master" are no longer accepted by this resource. The authenticated user must have REPO_READ permission for the specified repository to call this resource. :param project_key: :param repository_slug: :param commit: the commit ID to retrieve :param path :OPTIONAL an optional path to filter the commit by. If supplied the details returned may not be for the specified commit. Instead, starting from the specified commit, they will be the details for the first commit affecting the specified path. :return: rr:)rrP)r$rJrr~rr%r;s rget_commit_infozBitbucket.get_commit_info s<{OVD !F6NxxFx++rc.|j|||dS)Nr)r)r$rJrrs r_url_commit_pull_requestsz#Bitbucket._url_commit_pull_requests s"";KLN[[rcp|j|||}|j|xsijdS)Nr`)rrP)r$rJrr~r%s r get_pull_requests_contain_commitz*Bitbucket.get_pull_requests_contain_commit s4,,[/6R #((22rc|j||d}i}|r||d<|r||d<|r||d<|r||d<|j||S)ap Get change log between 2 refs :param start: :param project_key: :param repository_slug: :param ref_from: :param ref_to: :param limit: OPTIONAL: The limit of the number of changes to return, this may be restricted by fixed system limits. Default by built-in method: None :return: z/compare/commitsrnror9r8r:rH) r$rJrref_fromref_tor9r8r%r;s r get_changelogzBitbucket.get_changelog se( _=>>NO %F6N !F4L #F7O #F7Os622rc Ndj|j|||dd|S)Nz{}/reports/{}/annotations rest/insightsrrYr rr$rJrr report_keys r_url_code_insights_annotationsz(Bitbucket._url_code_insights_annotations s<*11   (!     rcX|j||||}d|i}|j||S)aM Adds annotations to an existing insight report. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/6.6.1/bitbucket-code-insights-rest.html :project_key: str :repository_slug: str :commit_id: str :report_key: str :annotations: list annotationsr*)rr.)r$rJrrrrr%r+s r'add_code_insights_annotations_to_reportz1Bitbucket.add_code_insights_annotations_to_report s911+PY[ef{+yy4y((rc Ndj|j|||dd|S)Nz {}/reports/{}rrrYrrs r_url_code_insights_reportz#Bitbucket._url_code_insights_report s<%%   (!     rcL|j||||}|j|S)z Retrieve the specified code-insights report. :projectKey: str :repositorySlug: str :commit_id: str :report_key: str )rrPr$rJrrrr%s rget_code_insights_reportz"Bitbucket.get_code_insights_report s),,[/9V`axx}rcL|j||||}|j|S)z Delete a report for the given commit. Also deletes any annotations associated with this report. :projectKey: str :repositorySlug: str :commit_id: str :report_key: str )rrsrs rdelete_code_insights_reportz%Bitbucket.delete_code_insights_report s*,,[/9V`a{{3rc z|j||||}d|i}|j||j||S)aU Create a new insight report, or replace the existing one if a report already exists for the given repository_slug, commit, and report key. A request to replace an existing report will be rejected if the authenticated user was not the creator of the specified report. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/6.6.1/bitbucket-code-insights-rest.html :projectKey: str :repositorySlug: str :commitId: str :report_key: str :report_title: str :report_params: rr*)rupdater) r$rJrrr report_title report_paramsr%r+s rcreate_code_insights_reportz%Bitbucket.create_code_insights_report sD.,,[/9V`a& M"xx$x''rc|j||d}|r|d|jd}i}|r||d<|r||d<|r||d<|j||S)a Retrieve a page of files from particular directory of a repository. The search is done recursively, so all files from any subdirectory of the specified directory will be returned. The authenticated user must have REPO_READ permission for the specified repository to call this resource. :param start: :param project_key: :param repository_slug: :param sub_folder: a sub folder in the target repository to list the files from. :param query: the commit ID or ref (e.g. a branch or tag) to list the files at. If not specified the default branch will be used instead. :param limit: OPTIONAL :return: z/filesrrr9r8r:)r1lstripr<) r$rJr sub_folderqueryr9r8r%r;s r get_file_listzBitbucket.get_file_list' sw, _=>fE E:,,S123C  F4L #F7O #F7Os622rc|j||d|}i}|||d<|||d<|j}|j||d|S)a4 Retrieve the raw content for a file path at a specified revision. The authenticated user must have REPO_READ permission for the specified repository to call this resource. :param project_key: :param repository_slug: :param filename: :param at: OPTIONAL ref string :param markup: if present or "true", triggers the raw content to be markup-rendered and returned as HTML; otherwise, if not specified, or any value other than "true" the content is streamed without markup. :return: z/raw/rmarkupT)r;rr)r1form_token_headersrP) r$rJrfilenamerrr%r;rs rget_content_of_filezBitbucket.get_content_of_fileI se _=>eH:N >F4L  %F8 ))xxFdGxTTrc||j|dd}n|j||dd}|d|dSt|S)Nzrest/branch-permissionsrrYz/restrictions/r )rr1r)r$rJ permission_idrr}s r_url_branches_permissionsz#Bitbucket._url_branches_permissions^ sp  "$$2!%D >>2! "D~M,Ab%Z[[s=GY%Z[[rcn|j|||}i}|r||d<|r||d<|j||S)z Get branches permissions from a given repo :param project_key: :param permission_id: :param repository_slug: :param start: :param limit: :return: r8r9r:)rrP)r$rJrrr9r8r%r;s rget_branches_permissionsz"Bitbucket.get_branches_permissionso sH",,[-Y #F7O #F7OxxFx++rc |j||} |g}|g}| g} |j} |r|j} |}n,||||j|j ddd||| d}| | d}|j | ||| S)a Create a restriction for the supplied branch or set of branches to be applied to the given repository. Allows creating multiple restrictions at once. To use multiple restrictions you should format payload manually - see the bitbucket-branch-restrictions.py example. Reference: https://docs.atlassian.com/bitbucket-server/rest/6.8.0/bitbucket-ref-restriction-rest.html :param project_key: :param multiple_permissions: :param matcher_type: :param matcher_value: :param permission_type: :param repository_slug: :param except_users: :param except_groups: :param except_access_keys: :param start: :param limit: :return: )rJr)r]rFT)r] displayIdrr)rmatcherrar6 accessKeys)r9r8)r+r;r)rr bulk_headersupper capitalizer.)r$rJmultiple_permissions matcher_type matcher_valuepermission_typer except_users except_groupsexcept_access_keysr9r8r%r restrictionr;s rset_branches_permissionsz"Bitbucket.set_branches_permissions sB,,Ve,f  L  M  %!# && ''G.K('!.*002 , 7 7 9#&'0K!51yy;vwyOOrcJ|j|||}|j|S)a Deletes a restriction as specified by a restriction id. The authenticated user must have REPO_ADMIN permission or higher to call this resource. :param project_key: :param repository_slug: :param permission_id: :return: )rrsr$rJrrr%s rdelete_branch_permissionz"Bitbucket.delete_branch_permission s',,[-Y{{3rcJ|j|||}|j|S)a Returns a restriction as specified by a restriction id. The authenticated user must have REPO_ADMIN permission or higher to call this resource. :param project_key: :param repository_slug: :param permission_id: :return: rr<rs rget_branch_permissionzBitbucket.get_branch_permission s',,[-Ys##rcJ|j|||}|j|S)z Get branches permissions from a given repo :param project_key: :param permission_id :param repository_slug: :return: rrs rall_branches_permissionsz"Bitbucket.all_branches_permissions s',,[-Ys##rcJdj|j||ddS)Nz{}/branchmodel/configurationrrrYrurms r_url_branching_modelzBitbucket._url_branching_model s2-44 NN,!    rcH|j||}|j|S)zr Get branching model :param project_key: :param repository_slug: :return: )rrPr4s rget_branching_modelzBitbucket.get_branching_model s$'' _Exx}rcL|j||}|j||S)z Set branching model :param project_key: :param repository_slug: :param data: :return: r*)rrrs rset_branching_modelzBitbucket.set_branching_model s)'' _Exx$x''rc hddddddddddd d dd dd d ddddddgd}|j|||S)z Enable branching model by setting it with default configuration :param project_key: :param repository_slug: :return: NT)refId useDefaultBugfixBUGFIXzbugfix/)rHenabledr]prefixFeatureFEATUREzfeature/HotfixHOTFIXzhotfix/ReleaseRELEASEzrelease/) developmenttypes)r)r$rJrdefault_model_datas renable_branching_modelz Bitbucket.enable_branching_model s}&*>$,#"' $-##( $,#"' $-##( ' :'' _FXYYrcD|j|j||S)zv Disable branching model :param project_key: :param repository_slug: :return: )rsrrms rdisable_branching_modelz!Bitbucket.disable_branching_model1 s {{444[/RSSrc0|j||d|S)Nz/browse/rM)r$rJrrs r _url_filezBitbucket._url_file: s..o>?xzRRrc`|j|||}|||d}|j||ddiS)z Upload new file for given branch. :param project_key: :param repository_slug: :param content: :param message: :param branch: :param filename :return: )contentrbranchrapplication/jsonrrr) r$rJrrrrrr%r+s r upload_filezBitbucket.upload_file= s=nn[/8D"w&Ixx4(xx}""rcb|j||}d}|D]}|dddk(r||=|dz }|S)a Request type: GET Return a page of repository conditions (only type PROJECT) with reviewers list associated that have been configured for this repository slug inside project specified. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm52264928992 :projectKey: str- project key involved :repoKey: str - repo key involved :return: rscoper REPOSITORYrrr$rJrJr{countrs rget_repo_project_conditionsz%Bitbucket.get_repo_project_conditions sS++KB! I!&)\9UO QJE rcb|j||}d}|D]}|dddk(r||=|dz }|S)a Request type: GET Return a page of repository conditions (only type REPOSITORY) with reviewers list associated that have been configured for this repository slug inside project specified. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm52264928992 :projectKey: str- project key involved :repoKey: str - repo key involved :return: rr rPROJECTrr r s rget_repo_repo_conditionsz"Bitbucket.get_repo_repo_conditions sS++KB! I!&)Y6UO QJE rcndj|j||dd|dSt|S)Nz{}/condition/{}rrrYr )r r1r)r$rJrJrs r_url_repo_conditionzBitbucket._url_repo_condition sP '' NN1!   &B  -0 ,=  rcR|j|||}|j|xsiS)a Request type: GET Return a specific condition with reviewers list that have been configured for this repository slug inside project specified. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm52264927632 :projectKey: str- project key involved :repoKey: str - repo key involved :idCondition: int - condition id involved :return: )rrPr$rJrJrr%s rget_repo_conditionzBitbucket.get_repo_condition s+&&{HlKxx}""rcT|j||}|j||xsiS)a Request type: POST Create a new condition for this repository slug inside project specified. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm52264908128 :projectKey: str- project key involved :repoKey: str - repo key involved :data: condition: dictionary object :example condition: '{"sourceMatcher": {"id":"any", "type":{"id":"ANY_REF"}}, "targetMatcher":{"id":"refs/heads/master","type":{"id":"BRANCH"}}, "reviewers":[{"id": 12}],"requiredApprovals":"0" }' :return: r*)rr.)r$rJrJrr%s rcreate_repo_conditionzBitbucket.create_repo_condition s."&&{H=yy9y-33rcV|j|||}|j||xsiS)aA Request type: PUT Update a specific condition for this repository slug inside project. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm52264927632 :projectKey: str- project key involved :repoKey: str - repo key involved :idCondition: int - condition id involved :data: condition: dictionary object :example condition: '{"sourceMatcher": {"id":"any", "type":{"id":"ANY_REF"}}, "targetMatcher":{"id":"refs/heads/master","type":{"id":"BRANCH"}}, "reviewers":[{"id": 12}],"requiredApprovals":"0" }' :return: r*)rr)r$rJrJrrr%s rupdate_repo_conditionzBitbucket.update_repo_condition s0$&&{HlKxx)x,22rcR|j|||}|j|xsiS)a Delete a specific condition for this repository slug inside project. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-default-reviewers-rest.html#idm8287339888 Request type: DELETE :projectKey: str- project key involved :repoKey: str - repo key involved :idCondition: int - condition id involved :return: )rrsrs rdelete_repo_conditionzBitbucket.delete_repo_condition s,&&{HlK{{3%2%rc |j||d} i} ||| d<||| d<||| d<||| d<||| d<dd i} |j| | | d } | j| D]}|j|y) a Downloads a repository archive. Note that the data is written to the specified file-like object, rather than simply being returned. For further information visit: https://docs.atlassian.com/bitbucket-server/rest/7.13.0/bitbucket-rest.html#idp199 :param project_key: :param repository_slug: :param dest_fd: a file-like object to which the archive will be written :param at: string: Optional, the commit to download an archive of; if not supplied, an archive of the default branch is downloaded :param filename: string: Optional, a filename to include the "Content-Disposition" header :param format: string: Optional, the format to stream the archive in; must be one of: zip, tar, tar.gz or tgz. If not specified, then the archive will be in zip format. :param path: string: Optional, path to include in the streamed archive :param prefix: string: Optional, a prefix to apply to all entries in the streamed archive; if the supplied prefix does not end with a trailing /, one will be added automatically :param chunk_size: int: Optional, download chunk size. Defeault is 128 z/archiveNrrr rrrz*/*T)r;r advanced_mode) chunk_size)r1rP iter_contentwrite)r$rJrdest_fdrrr rrrr%r;rr{chunks rdownload_repo_archivezBitbucket.download_repo_archive s> _=>hG >F4L  !)F:   %F8   !F6N  %F8 U#88Ct8T**j*A !E MM%  !rz2.0.2zt'='=> ZI \$$DE$=   FF   sA.cDg}t|jfi|jjj |j j |j j|D].}|j|jt||k(s-|S|S)a2 Get information about latest pipelines runs. :param workspace: :param repository_slug: :param sort_by: :param number: number of pipelines to fetch :param :sort_by: optional key to sort available pipelines for :return: List of pipeline data )r') rr%r(r)rPr* pipelinesr+rr+len)r$r,rnumbersort_byr`ps r get_pipelineszBitbucket.get_pipelinesU s $(( 5d44 5 ZI \##o. Yttt)  A MM!&& !6{f$   rct|jfi|jjj |j j |j j|||jS)a Trigger a new pipeline. The following options are possible (1 and 2 trigger the pipeline that the branch is associated with in the Pipelines configuration): 1. Latest revision of a branch (specify ``branch``) 2. Specific revision on a branch (additionally specify ``revision``) 3. Specific pipeline (additionally specify ``name``) :return: the initiated pipeline; or error information )rr~pattern) rr%r(r)rPr*r0triggerr+)r$r,rrrevisionrFs rtrigger_pipelinezBitbucket.trigger_pipelineq sT, $(( 5d44 5 ZI \##o. YwwfXtwL T  rct|jfi|jjj |j j |j j |jS)z Get information about the pipeline specified by ``uuid``. :param workspace: :param repository_slug: :param uuid: Pipeline identifier (with surrounding {}; NOT the build number) )rr%r(r)rPr*r0r+r$r,ruuids r get_pipelinezBitbucket.get_pipeline sM $(( 5d44 5 ZI \##o. Yss4y T  rct|jfi|jjj |j j |j j |jS)a Stop the pipeline specified by ``uuid``. :param workspace: :param repository_slug: :param uuid: Pipeline identifier (with surrounding {}; NOT the build number) See the documentation for the meaning of response status codes. )rr%r(r)rPr*r0stopr<s r stop_pipelinezBitbucket.stop_pipeline sO $(( 5d44 5 ZI \##o. Yss4y TV  rc<g}t|jfi|jjj |j j |j j |jD]}|j|j|S)z Get information about the steps of the pipeline specified by ``uuid``. :param workspace: :param repository_slug: :param uuid: Pipeline identifier (with surrounding {}; NOT the build number) ) rr%r(r)rPr*r0stepsrr+)r$r,rr=r`ss rget_pipeline_stepszBitbucket.get_pipeline_steps st $(( 5d44 5 ZI \##o. Yss4y UW  "A MM!&& ! " rc t|jfi|jjj |j j |j j |j|jS)a4 Get information about a step of a pipeline, specified by respective UUIDs. :param workspace: :param repository_slug: :param pipeline_uuid: Pipeline identifier (with surrounding {}; NOT the build number) :param step_uuid: Step identifier (with surrounding {}) ) rr%r(r)rPr*r0stepr+r$r,r pipeline_uuid step_uuids rget_pipeline_stepzBitbucket.get_pipeline_step sW $(( 5d44 5 ZI \##o. Yss=) T)_ T  rct|jfi|jjj |j j |j j |j|jS)aJ Get log of a step of a pipeline, specified by respective UUIDs. :param workspace: :param repository_slug: :param pipeline_uuid: Pipeline identifier (with surrounding {}; NOT the build number) :param step_uuid: Step identifier (with surrounding {}) :return: byte string log ) rr%r(r)rPr*r0rGrNrHs rget_pipeline_step_logzBitbucket.get_pipeline_step_log sY $(( 5d44 5 ZI \##o. Yss=) T)_ SU  rct|jfi|jjj |j j |j j||||jS)aF Create a new issue in the issue tracker of the given repository. :param workspace: :param repository_slug: :param title: :param description: :param kind: one of: bug, enhancement, proposal, task :param priority: one of: trivial, minor, major, critical, blocker )rrkindpriority) rr%r(r)rPr*issuescreater+)r$r,rrrrOrPs r create_issuezBitbucket.create_issue sa. $(( 5d44 5 ZI \##o. VFF'!  T rc$g}t|jfi|jjj |j j |j j||D]}|j|j|S)a Get information about the issues tracked in the given repository. By default, the issues are sorted by ID in descending order. :param workspace: :param repository_slug: :param sort_by: optional key to sort available issues for :param query: optional query to filter available issues for. See https://developer.atlassian.com/bitbucket/api/2/reference/meta/filtering for an overview :return: List of issues (direct, i.e. without the 'values' key) )r&r') rr%r(r)rPr*rQr+rr+)r$r,rr3rr`r4s r get_issueszBitbucket.get_issues sr" $(( 5d44 5 ZI \##o. VDD5wD/  "A MM!&& !  " rct|jfi|jjj |j j |j j |jS)z4 Get the issue specified by ``id``. )rr%r(r)rPr*rQr+r$r,rr]s r get_issuezBitbucket.get_issue7 sM $(( 5d44 5 ZI \##o. VCCG T  rc t|jfi|jjj |j j |j j |jdi|jS)z Update the ``fields`` of the issue specified by ``id``. Consult the official API documentation for valid fields. r) rr%r(r)rPr*rQrr+r$r,rr]fieldss r update_issuezBitbucket.update_issueG se E$(( 5d44 5 ZI \##o. VCCG V     T  rct|jfi|jjj |j j |j j |jS)z7 Delete the issue specified by ``id``. )rr%r(r)rPr*rQrsrWs r delete_issuezBitbucket.delete_issueY sO $(( 5d44 5 ZI \##o. VCCG VX  rc t|jfi|jjj |j j |j j||||||| jS)a  Add a new branch restriction. :param workspace: :param repository_slug: :param value: :param kind: One of require_tasks_to_be_completed, force, restrict_merges, enforce_merge_checks, require_approvals_to_merge, delete, require_all_dependencies_merged, push, require_passing_builds_to_merge, reset_pullrequest_approvals_on_change, require_default_reviewer_approvals_to_merge :param branch_match_kind: branching_model or glob, if branching_model use param branch_type otherwise branch_pattern. :param branch_pattern: A glob specifying the branch this restriction should apply to (supports * as wildcard). :param branch_type: The branch type specifies the branches this restriction should apply to. One of: feature, bugfix, release, hotfix, development, production. :param users: List of user objects that are excluded from the restriction. Minimal: {"username": ""} :param groups: List of group objects that are excluded from the restriction. Minimal: {"owner": {"username": ""}, "slug": ""} )branch_match_kindbranch_pattern branch_typerar6r`) rr%r(r)rPr*branch_restrictionsrRr+) r$r,rrOr`rarbrar6r`s radd_branch_restrictionz Bitbucket.add_branch_restrictioni slL $(( 5d44 5 ZI \##o. "3-'"("T rcFg}t|jfi|jjj |j j |j j||D].}|j|jt||k(s-|S|S)z- Get all branch permissions. )rOr7) rr%r(r)rPr*rcr+rr+r1)r$r,rrOr7r2r`r4s rget_branch_restrictionsz!Bitbucket.get_branch_restrictions s $(( 5d44 5 ZI \##o. 4!A  A MM!&& !6{f$   rc t|jfi|jjj |j j |j j |jdi|jS)z Update an existing branch restriction identified by ``id``. Consult the official API documentation for valid fields. r) rr%r(r)rPr*rcrr+rZs rupdate_branch_restrictionz#Bitbucket.update_branch_restriction sf E$(( 5d44 5 ZI \##o. R V     T  rct|jfi|jjj |j j |j j |jS)zM Delete an existing branch restriction identified by ``id``. )rr%r(r)rPr*rcrsrWs rdelete_branch_restrictionz#Bitbucket.delete_branch_restriction sP $(( 5d44 5 ZI \##o. R VX  rct|jfi|jjj |j j |j j|jS)a Add user as default reviewer to the repository. Can safely be called multiple times with the same user, only adds once. :param workspace: :param repository_slug: :param user: The username or account UUID to add as default_reviewer. ) rr%r(r)rPr*default_reviewersaddr+r$r,rrs radd_default_reviewerzBitbucket.add_default_reviewer sN $(( 5d44 5 ZI \##o.  ss4y T  rc@g}t|jfi|jjj |j j |j jD].}|j|jt||k(s-|S|S)z? Get all default reviewers for the repository. ) rr%r(r)rPr*rlr+rr+r1)r$r,rr2r`r4s rget_default_reviewerszBitbucket.get_default_reviewers s $(( 5d44 5 ZI \##o.  ttv  A MM!&& !6{f$   rct|jfi|jjj |j j |j j | yy)z Check if the user is a default reviewer of the repository. :param workspace: :param repository_slug: :param user: The username or account UUID to check. :return: True if present, False if not. FT)rr%r(r)rPr*rlrns ris_default_reviewerzBitbucket.is_default_reviewer sT $(( 5d44 5 ZI \##o.  ss4y   rct|jfi|jjj |j j |j j |jS)z Remove user as default reviewer from the repository. :param repository_slug: :param workspace: :param user: The username or account UUID to delete as default reviewer. )rr%r(r)rPr*rlrsrns rdelete_default_reviewerz!Bitbucket.delete_default_reviewersP $(( 5d44 5 ZI \##o.  ss4y VX  r)N)Nr)rN)Nrrv)NN)r )z image/png)rNN)rrv)FT)NNrNT MODIFICATIONF)r iNr)NF)OPENnewestdrNN)rNNNNNN) NNFFincludeFNNNNNN)Nr{N)NNN)NNrN) FNNNNNNNrrv)r )T)NNNNN)r|z -created_on)masterNN)r bugmajor)glob*NNNN)NNr|)r|)rrrr#r/r4r>rCrTr[r_rcrergrkrmrorqrtrxr|rrrrrrrrrMrrrRrrrrrrrrrrQrrrrrrrrrrrrrrr r rrrrrrr"r$r&r(r.r1r5r8r:r<r>r@rCrFrKrOrQrSrUrWrYrrbr^rhrjrnrprsrurwrzrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr rrrrrintrrrrr#r&r+r/r1r5r8r7r;r>r@rErGrJrNrQrTrVrXr[r rrbrdrfrhrjrlrsrvrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr$r.r5r:r>rArErKrMrSrUrXr\r^rdrfrhrjrorqrsru __classcell__)r(s@rrrs> )C3(3&",&3& 2;   - ( J 4&D 3 )"L# *>   F <3&E3& & , /F3( , /67B,*   #  #4&3( &Q 3 P3"7)FO"   *   )),3(H3( ,/ I3(xQ&4 ,,/$H  )_ 3"])3VR  ()0+ ]3B$, )8  P ,:    J 3> )DR  *  X )Stx3B,R#(FGP)\ )AB C (+2 ,B ,< ,6i ,2))14)GJ)RU)]`) $)$ >3@#* )0 (*(KL M &-(cf))14)GJ)RV)be) )  14 GJ  $ -$ * )0 ( ."$11"8H- %3 A(  >3@,    $,*\33@   )     (@ 3DU*\* ,8#=P~   $ $  ($ZLTS QQ<  $  #&&   #4(3* &&  .!`M  "M 0M    2M    M  "M &M  "M  $M   >M 0M    M    M    M!/ / bM "M    M    M  "M "M (M  rr)loggingenumrtypingrrrequestsratlassian.bitbucket.cloudrr}r getLoggerrrNr rrrrrsF!+g!"D"O8 O8 r