dhJSrSSKJr SSKrSSKJrJrJrJrJ r SSK J r SSK J r JrJr \(aSSKJr "SS \ 5rg) zUtil that calls gitlab.) annotationsN) TYPE_CHECKINGAnyDictListOptional)get_from_dict_or_env) BaseModel ConfigDictmodel_validator)Issuect\rSrSr%SrSrS\S'SrS\S'SrS\S'Sr S\S 'Sr S\S 'Sr S\S 'Sr S\S '\ "S S9r\"SS9\S%Sj55rS&SjrS'SjrS(SjrS)SjrS*SjrS+SjrS,SjrS+SjrS,SjrS'SjrS'SjrS-SjrS.S/SjjrS.S0SjjrS1S jr S'S!jr!S2S"jr"S3S#jr#S$r$g)4GitLabAPIWrapperzWrapper for GitLab API.Nrgitlabgitlab_repo_instancez Optional[str] gitlab_urlgitlab_repositorygitlab_personal_access_token gitlab_branchgitlab_base_branchforbid)extrabefore)modecl[USSSS9n[USS5n[USS5n[US S S S9n[US S S S9nSSKnURUUSS9nUR 5 XS'UR R U5US'X!S'X1S'XAS'XQS 'XaS 'U$![a [S5ef=f)z?Validate that api key and python package exists in environment.r GITLAB_URLzhttps://gitlab.com)defaultrGITLAB_REPOSITORYrGITLAB_PERSONAL_ACCESS_TOKENr GITLAB_BRANCHmainrGITLAB_BASE_BRANCHrNzRpython-gitlab is not installed. Please install it with `pip install python-gitlab`T)url private_token keep_base_urlrr)r r ImportErrorGitlabauthprojectsget) clsvaluesrrrrrrgs \/var/www/html/shao/venv/lib/python3.13/site-packages/langchain_community/utilities/gitlab.pyvalidate_environment%GitLabAPIWrapper.validate_environment's * L,8L 1 ')< (< 24R( $- O_f 2 (*>    MM6   x)*8I)J%&)|&7"#1M-."/'9#$ - E  s BB3cr/nUH.nURnURnURXES.5 M0 U$)z Extracts title and number from each Issue and puts them in a dictionary Parameters: issues(List[Issue]): A list of gitlab Issue objects Returns: List[dict]: A dictionary of issue titles and numbers )titlenumber)r3iidappend)selfissuesparsedissuer3r4s r/ parse_issuesGitLabAPIWrapper.parse_issuesYs;EKKEYYF MME< = cURRRSS9n[U5S:a9UR U5nS[ [U55-S-[ U5-nU$g)z Fetches all open issues from the repo Returns: str: A plaintext report containing the number of issues and each issue's title and number. opened)staterFound z issues: zNo open issues available)rr8listlenr;str)r7r8 parsed_issuesparsed_issues_strs r/ get_issuesGitLabAPIWrapper.get_issueshso**1166X6F v;? --f5M3s=122\AC DVV % $-r=cURRRU5nSn/n[U5S::aURR US9n[U5S:XaOoUHSnURRUR 5nURURURSS.5 MU US- n[U5S::aMURUR[U5S.$)z Fetches a specific issue and its first 10 comments Parameters: issue_number(int): The number for the gitlab issue Returns: dict: A dictionary containing the issue's title, body, and comments as a string r )pageusername)bodyuser)r3rMcomments) rr8r+rCnotesrBidr6rMauthorr3 descriptionrD)r7 issue_numberr:rKrP comments_pagecomments r/ get_issueGitLabAPIWrapper.get_issuezs))0044\B!(mr!!KK,,$,7M=!Q&(++//'**5 ' 'z :) AID(mr![[%%H   r=clURUR:XagURS5SnU[U5S-SnURR R URURUUS/S.5nSUR3$![anS [U5-sSnA$SnAff=f) a Makes a pull request from the bot's branch to the base branch Parameters: pr_query(str): a string which contains the PR title and the PR body. The title is the first line in the string, and the body are the rest of the string. For example, "Updated README made changes to add info" Returns: str: A success or failure message zXCannot make a pull request because commits are already in the master branch rNzcreated-by-agent) source_branch target_branchr3rTlabelszSuccessfully created PR number z*Unable to make pull request due to error: ) rrsplitrCr mergerequestscreater5 ExceptionrD)r7pr_queryr3rMpres r/create_pull_request$GitLabAPIWrapper.create_pull_requests  " "d&8&8 88 N t,Q/E Q 01..<<CC)-););)-)@)@!&'+#5"6 9AA NDs1vMM NsA3B B3 B.(B3.B3c\[URS5S5nU[[U55S-SnURR R U5nURRSU05 S[U5-$![anS[U5-sSnA$SnAff=f)af Adds a comment to a gitlab issue Parameters: comment_query(str): a string which contains the issue number, two newlines, and the comment. for example: "1 Working on it now" adds the comment "working on it now" to issue 1 Returns: str: A success or failure message z rr\NrMzCommented on issue z%Unable to make comment due to error: ) intr`rCrDrr8r+rQrbrc)r7 comment_queryrUrWr:rfs r/comment_on_issue!GitLabAPIWrapper.comment_on_issues=..v6q9: C $5 6 : <= E--4488FE KK  0 1(3|+<< < E;c!fD D EsAB B+ B& B+&B+cURUR:XaSURS3$URS5SnU[U5S-SnURR R X R5 SUS3$![aA URS U-UUS .nURR RU5 S U-s$f=f) a Creates a new file on the gitlab repo Parameters: file_query(str): a string which contains the file path and the file contents. The file path is the first line in the string, and the contents are the rest of the string. For example, "hello_world.md # Hello World!" Returns: str: A success or failure message +You're attempting to commit directlyto the F branch, which is protected. Please create a new branch and try again.r[rr\NzFile already exists at z. Use update_file insteadCreate )branchcommit_message file_pathcontentz Created file ) rrr`rCrfilesr+rcrb)r7 file_queryrt file_contentsdatas r/ create_fileGitLabAPIWrapper.create_files   !8!8 81123<<  $$T*1- "3y>A#5#78  /  % % + + / / ;M;M N,YK7PQ Q /,,"+i"7&( D  % % + + 2 24 8"Y. . /s4BACCcURRRXR5nUR 5R S5$)z Reads a file from the gitlab repo Parameters: file_path(str): the file path Returns: str: The file decoded as a string zutf-8)rrvr+rdecode)r7rtfiles r/ read_fileGitLabAPIWrapper.read_files=((..229>P>PQ{{}##G,,r=cpURUR:XaSURS3$URS5SnURS5SRS5SR5nURS5SRS 5SR5nUR U5nUR X45nXV:Xag URS U-S UUS ./S.nUR RRU5 SU-$![anS[U5-sSnA$SnAff=f)a Updates a file with new content. Parameters: file_query(str): Contains the file path and the file contents. The old file contents is wrapped in OLD <<<< and >>>> OLD The new file contents is wrapped in NEW <<<< and >>>> NEW For example: test/hello.txt OLD <<<< Hello Earth! >>>> OLD NEW <<<< Hello Mars! >>>> NEW Returns: A success or failure message rorpr[rzOLD <<<>>> OLDzNEW <<<>>> NEWzFile content was not updated because old content was not found.It may be helpful to use the read_file action to get the current file contents.rqupdate)actionrtru)rrrsactionsz Updated file z$Unable to update file due to error: N) rrr`striprreplacercommitsrbrcrD) r7rwrtold_file_contentsnew_file_contents file_contentupdated_file_contentcommitrfs r/ update_fileGitLabAPIWrapper.update_filesd$   !8!8 81123<<  $ D"((.q1I  ,Q/55jA!DJJL   ,Q/55jA!DJJL  >>)4L#/#7#7!$ 31,,"+i"7#+%.#7 F  % % - - 4 4V <"Y. . D:SVC C Ds%B$DAD D5 D0*D50D5cURUR:XaSURS3$URRR XRSU-5 SU-$![ anS[ U5-sSnA$SnAff=f)z} Deletes a file from the repo Parameters: file_path(str): Where the file is Returns: str: Success or failure message rorpzDelete z Deleted file z$Unable to delete file due to error: N)rrrrvdeletercrD)r7rtrfs r/ delete_fileGitLabAPIWrapper.delete_file8s   !8!8 81123<<   D  % % + + 2 2--y9/D #Y. . D:SVC C Ds7A$$ B. B;BBcTURcgURUR5$)z Get the list of files in the main branch of the repository Returns: str: A plaintext report containing the list of files in the repository in the main branch z-No base branch set. Please set a base branch.)r _list_filesr7s r/list_files_in_main_branch*GitLabAPIWrapper.list_files_in_main_branchNs*  " " *B 7 788r=cTURcgURUR5$)z Get the list of files in the active branch of the repository Returns: str: A plaintext report containing the list of files in the repository in the active branch *No active branch set. Please set a branch.rrrs r/list_files_in_bot_branch)GitLabAPIWrapper.list_files_in_bot_branchZs*    %? 2 233r=cRURcgURURUS9$)z Get the list of files in the active branch of the repository from a specific directory Returns: str: A plaintext report containing the list of files in the repository in the active branch from the specified directory rrrpathr)r7rs r/list_files_from_directory*GitLabAPIWrapper.list_files_from_directoryfs7    %?%%   r=cURUUS9nU(a%SRU5nS[U5SUSU3$SUS3$![anSU3sSnA$SnAff=f) Nrr[rAz files in branch `z`: zNo files found in branch: ``zError: )_get_repository_filesjoinrCrc)r7rrrrv files_strrfs r/rGitLabAPIWrapper._list_filesvs~ !../E IIe, E |+=fXT)UU4VHA>> !QC=  !s";AA AAAAcURRXS9n/nUHEnUSS:Xa%URURXS55 M1UR US5 MG U$)N)refrtypetreer)rrepository_treeextendrr6)r7rrr repo_contentsrvrus r/r&GitLabAPIWrapper._get_repository_filessh11AAfAX $Gv&( T77PQ WV_- %  r=cSSKJn SnUn[U5HWnURRR UUR S.5nURUlSURS3s $ SUSUS3$!UaSnURS:Xa"SUR;aUS - nUS U3nS nAM[S U35 [S U35eS nAff=f)z Create a new branch in the repository and set it as the active branch Parameters: proposed_branch_name (str): The name of the new branch to be created Returns: str: A success or failure message r)GitlabCreateErrord)rrrzBranch 'z9' created successfully, and set as current active branch.izBranch already existsrO_vz Failed to create branch. Error: z8Unable to create branch name from proposed_branch_name: Nz"Unable to create branch. At least z? branches exist with named derived from proposed_branch_name: `r) rrrangerbranchesrbrname response_code error_messageprintrc)r7proposed_branch_namer max_attemptsnew_branch_nameiresponserfs r/ create_branchGitLabAPIWrapper.create_branchs  - .|$A 44==DD"1#11&.]]"x}}o.NN%>1?&&:%;1 > % OOs*/1??BFA)=(>b&DO>%( ( ] "##E* * ] "##E* * _ $%%e, , , ,--/ / ( ())%0 0 0 0113 3 / /002 2 0 011%8 8^d23 3r=)r)r-rreturnr)r8z List[Issue]rz List[dict])rrD)rUrjrzDict[str, Any])rdrDrrD)rkrDrrD)rwrDrrD)rtrDrrD)rrDrrD))rrrDrrDrrD)rrrDrrDrz List[str])rrDrrD)rrDrrD)rrDrrDrrD)%__name__ __module__ __qualname____firstlineno____doc__r__annotations__rrrrrrr model_configr classmethodr0r;rGrXrgrlrzrrrrrrrrrrrr__static_attributes__r=r/rrs!FC $#$ $J $)'+}+P26 -6P#'M=')- ,L(#.$.` .$ @N>E( /D -<D|D, 9 4 ! / b5&*4r=r)r __future__rrtypingrrrrrlangchain_core.utilsr pydanticr r r gitlab.v4.objectsr rrr=r/rs1" ;;5;;'x4yx4r=