j<dZddlmZmZddlmZddlmZddlm Z m Z ddl m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"ddl#m$Z$ddl%m&Z&Gd d e Z'Gd d e Z(Gd de Z)Gdde Z*Gdde Z+Gdde Z,Gdde Z-Gdde Z.Gdde Z/Gdde Z0Gdde Z1Gdd e Z2Gd!d"e Z3Gd#d$e Z4Gd%d&e Z5Gd'd(eZ6y))*zGitHub Toolkit.)DictList)BaseTool) BaseToolkit) BaseModelField)COMMENT_ON_ISSUE_PROMPTCREATE_BRANCH_PROMPTCREATE_FILE_PROMPTCREATE_PULL_REQUEST_PROMPTCREATE_REVIEW_REQUEST_PROMPTDELETE_FILE_PROMPTGET_FILES_FROM_DIRECTORY_PROMPTGET_ISSUE_PROMPTGET_ISSUES_PROMPTGET_LATEST_RELEASE_PROMPT GET_PR_PROMPTGET_RELEASE_PROMPTGET_RELEASES_PROMPTLIST_BRANCHES_IN_REPO_PROMPTLIST_PRS_PROMPTLIST_PULL_REQUEST_FILES"OVERVIEW_EXISTING_FILES_BOT_BRANCHOVERVIEW_EXISTING_FILES_IN_MAINREAD_FILE_PROMPTSEARCH_CODE_PROMPTSEARCH_ISSUES_AND_PRS_PROMPTSET_ACTIVE_BRANCH_PROMPTUPDATE_FILE_PROMPT) GitHubAction)GitHubAPIWrapperc0eZdZUdZeddZeed<y)NoInputz4Schema for operations that do not require any input.z*No input required, e.g. `` (empty string). descriptionno_inputN)__name__ __module__ __qualname____doc__rr'str__annotations__{/var/www/html/Fitness-lenito-AI-main/venv/lib/python3.12/site-packages/langchain_community/agent_toolkits/github/toolkit.pyr#r#&s>"*VWHcWr/r#c0eZdZUdZeddZeed<y)GetIssuezr>>sJc/PQL#Qr/r>c0eZdZUdZeddZeed<y) CreateFileDSchema for operations that require a file path and content as input..r7r%formatted_fileN)r(r)r*r+rrCr,r-r.r/r0rArADsN1RSNCSr/rAc0eZdZUdZeddZeed<y)ReadFile8Schema for operations that require a file path as input..z}The full file path of the file you would like to read where the path must NOT start with a slash, e.g. `some_dir/my_file.py`.r%formatted_filepathNr(r)r*r+rrGr,r-r.r/r0rErEJs B#  Lr/rEc0eZdZUdZeddZeed<y) UpdateFilerB.z#Strictly follow the provided rules.r%formatted_file_updateN)r(r)r*r+rrKr,r-r.r/r0rJrJVsN!& >"3r/rJc0eZdZUdZeddZeed<y) DeleteFilerF.zThe full file path of the file you would like to delete where the path must NOT start with a slash, e.g. `some_dir/my_file.py`. Only input a string, not the param name.r%rGNrHr.r/r0rMrM^sB#  #r/rMc0eZdZUdZeddZeed<y) DirectoryPathz=Schema for operations that require a directory path as input.r$zmThe path of the directory, e.g. `some_dir/inner_dir`. Only input a string, do not include the parameter name.r%r8Nr9r.r/r0rOrOlsG  GE3r/rOc0eZdZUdZeddZeed<y) BranchNamez:Schema for operations that require a branch name as input..z)The name of the branch, e.g. `my_branch`.r% branch_nameN)r(r)r*r+rrRr,r-r.r/r0rQrQxsD DKr/rQc0eZdZUdZeddZeed<y) SearchCode;Schema for operations that require a search query as input..zQA keyword-focused natural language searchquery for code, e.g. `MyFunctionName()`.r% search_queryNr(r)r*r+rrVr,r-r.r/r0rTrTsE  7L#r/rTc0eZdZUdZeddZeed<y)CreateReviewRequestz7Schema for operations that require a username as input..z@GitHub username of the user being requested, e.g. `my_username`.r%usernameN)r(r)r*r+rrZr,r-r.r/r0rYrYsA VHcr/rYc0eZdZUdZeddZeed<y)SearchIssuesAndPRsrU.z>Natural language search query, e.g. `My issue title or topic`.r%rVNrWr.r/r0r\r\sE TL#r/r\c0eZdZUdZeddZeed<y)TagNamez7Schema for operations that require a tag name as input..z+The tag name of the release, e.g. `v1.0.0`.r%tag_nameN)r(r)r*r+rr_r,r-r.r/r0r^r^sA AHcr/r^cZeZdZUdZgZeeed<e d de de ddfdZ deefdZ y) GitHubToolkita)GitHub Toolkit. *Security Note*: This toolkit contains tools that can read and modify the state of a service; e.g., by creating, deleting, or updating, reading underlying data. For example, this toolkit can be used to create issues, pull requests, and comments on GitHub. See [Security](https://python.langchain.com/docs/security) for more information. Setup: See detailed installation instructions here: https://python.langchain.com/docs/integrations/tools/github/#installation You will need to install ``pygithub`` and set the following environment variables: .. code-block:: bash pip install -U pygithub export GITHUB_APP_ID="your-app-id" export GITHUB_APP_PRIVATE_KEY="path-to-private-key" export GITHUB_REPOSITORY="your-github-repository" Instantiate: .. code-block:: python from langchain_community.agent_toolkits.github.toolkit import GitHubToolkit from langchain_community.utilities.github import GitHubAPIWrapper github = GitHubAPIWrapper() toolkit = GitHubToolkit.from_github_api_wrapper(github) Tools: .. code-block:: python tools = toolkit.get_tools() for tool in tools: print(tool.name) .. code-block:: none Get Issues Get Issue Comment on Issue List open pull requests (PRs) Get Pull Request Overview of files included in PR Create Pull Request List Pull Requests' Files Create File Read File Update File Delete File Overview of existing files in Main branch Overview of files in current working branch List branches in this repository Set active branch Create a new branch Get files from a directory Search issues and pull requests Search code Create review request Include release tools: By default, the toolkit does not include release-related tools. You can include them by setting ``include_release_tools=True`` when initializing the toolkit: .. code-block:: python toolkit = GitHubToolkit.from_github_api_wrapper( github, include_release_tools=True ) Setting ``include_release_tools=True`` will include the following tools: .. code-block:: none Get latest release Get releases Get release Use within an agent: .. code-block:: python from langchain_openai import ChatOpenAI from langgraph.prebuilt import create_react_agent # Select example tool tools = [tool for tool in toolkit.get_tools() if tool.name == "Get Issue"] assert len(tools) == 1 tools[0].name = "get_issue" llm = ChatOpenAI(model="gpt-4o-mini") agent_executor = create_react_agent(llm, tools) example_query = "What is the title of issue 24888?" events = agent_executor.stream( {"messages": [("user", example_query)]}, stream_mode="values", ) for event in events: event["messages"][-1].pretty_print() .. code-block:: none ================================[1m Human Message [0m================================= What is the title of issue 24888? ==================================[1m Ai Message [0m================================== Tool Calls: get_issue (call_iSYJVaM7uchfNHOMJoVPQsOi) Call ID: call_iSYJVaM7uchfNHOMJoVPQsOi Args: issue_number: 24888 =================================[1m Tool Message [0m================================= Name: get_issue {"number": 24888, "title": "Standardize KV-Store Docs", "body": "..." ==================================[1m Ai Message [0m================================== The title of issue 24888 is "Standardize KV-Store Docs". Parameters: tools: List[BaseTool]. The tools in the toolkit. Default is an empty list. toolsgithub_api_wrapperinclude_release_toolsreturncDddttdddttdddtt ddd t tdd d ttdd d ttdddttdd dttdddttdddttdddt t"dddt$t&dddt(tdddt*tdddt,tddd t.t0dd!d"t2t0dd#d$t4t6dd%d&t8t:dd'd(t<t>dd)d*t@tBdg}d+d,tDtdd-d.tFtdd/d0tHtJdg}||r|ngz}|Dcgc]+}tM|d1|d2|d3||jOd4d56-}}||7Scc}w)8aHCreate a GitHubToolkit from a GitHubAPIWrapper. Args: github_api_wrapper: GitHubAPIWrapper. The GitHub API wrapper. include_release_tools: bool. Whether to include release-related tools. Defaults to False. Returns: GitHubToolkit. The GitHub toolkit. get_issuesz Get Issues)modenamer& args_schema get_issuez Get Issuecomment_on_issuezComment on Issuelist_open_pull_requestszList open pull requests (PRs)get_pull_requestzGet Pull Requestlist_pull_request_filesz Overview of files included in PRcreate_pull_requestzCreate Pull RequestzList Pull Requests' Files create_filez Create File read_filez Read File update_filez Update File delete_filez Delete Filelist_files_in_main_branchz)Overview of existing files in Main branchlist_files_in_bot_branchz+Overview of files in current working branchlist_branches_in_repoz List branches in this repositoryset_active_branchzSet active branch create_branchzCreate a new branchget_files_from_directoryzGet files from a directorysearch_issues_and_prszSearch issues and pull requests search_codez Search codecreate_review_requestzCreate review requestget_latest_releasezGet latest release get_releasesz Get releases get_releasez Get releaserir&rhrjN)rir&rh api_wrapperrjrb)(rr#rr2r r6rrr;rr r>r rArrErrJrrMrrrrrQr rrOrr\rrTr rYrrrr^r get)clsrcrd operationsrelease_operationsactionrbs r0from_github_api_wrapperz%GitHubToolkit.from_github_api_wrapper,sS %$0&  $#/'  +*6-  27.&  +*,$  2:6$  .-9'  236$  &%1)  $#/'  &%1)  &%1)  4C>&  3EA&  0:;&  ,+7)  (-3)  34>,  09;1  &%1)  0/;2  s" F-,8&  '&2&  &%1&  * * 9N#5TVW %  % F^"=1F^."JJ}d;  %     s"0Fc|jS)zGet the tools in the toolkit.r)selfs r0 get_toolszGitHubToolkit.get_toolss zzr/N)F) r(r)r*r+rbrrr- classmethodr!boolrrr.r/r0raras\@DE4>QVn !1n JNn n n `4>r/raN)7r+typingrrlangchain_core.toolsrlangchain_core.tools.baserpydanticrr'langchain_community.tools.github.promptr r r r r rrrrrrrrrrrrrrrrrr%langchain_community.tools.github.toolr $langchain_community.utilities.githubr!r#r2r6r;r>rArErJrMrOrQrTrYr\r^rar.r/r0rs )1%2?AXiX VyV KYK TIT RyR TT y    I   )ixKxr/