swarmauri_toolkit_github 0.9.1.dev3__py3-none-any.whl → 0.11.0.dev1__py3-none-any.whl

swarmauri_toolkit_github/GithubBranchTool.py

@@ -16,13 +16,19 @@ class GithubBranchTool(ToolBase):
             Parameter(
                 name="action",
                 input_type="string",
-                description="The action to perform on the GitHub API, e.g., 'create_repo', 'delete_repo', 'create_issue', etc.",
+                description=(
+                    "The action to perform on the GitHub API, e.g., "
+                    "'create_repo', 'delete_repo', 'create_issue', etc."
+                ),
                 required=True,
             ),
             Parameter(
                 name="repo_name",
                 input_type="string",
-                description="The full name of the repository to interact with, e.g. 'owner/repository'.",
+                description=(
+                    "The full name of the repository to interact with, e.g. "
+                    "'owner/repository'."
+                ),
                 required=True,
             ),
             Parameter(
@@ -34,7 +40,9 @@ class GithubBranchTool(ToolBase):
             Parameter(
                 name="source_branch",
                 input_type="string",
-                description="The name of the source branch to create a branch from.",
+                description=(
+                    "The name of the source branch to create a branch from."
+                ),
                 required=False,
             ),
         ]

swarmauri_toolkit_github/GithubCommitTool.py

@@ -14,19 +14,28 @@ class GithubCommitTool(ToolBase):
             Parameter(
                 name="action",
                 input_type="string",
-                description="The action to perform on the GitHub API, e.g., 'create_repo', 'delete_repo', 'create_issue', etc.",
+                description=(
+                    "The action to perform on the GitHub API, e.g., "
+                    "'create_repo', 'delete_repo', 'create_issue', etc."
+                ),
                 required=True,
             ),
             Parameter(
                 name="repo_name",
                 input_type="string",
-                description="The full name of the repository to interact with, e.g. 'owner/repository'.",
+                description=(
+                    "The full name of the repository to interact with, e.g. "
+                    "'owner/repository'."
+                ),
                 required=True,
             ),
             Parameter(
                 name="file_path",
                 input_type="string",
-                description="The path to the file in the repository, e.g. 'path/to/file.txt'.",
+                description=(
+                    "The path to the file in the repository, e.g. "
+                    "'path/to/file.txt'."
+                ),
                 required=False,
             ),
             Parameter(

swarmauri_toolkit_github/GithubIssueTool.py

@@ -14,13 +14,20 @@ class GithubIssueTool(ToolBase):
             Parameter(
                 name="action",
                 input_type="string",
-                description="The action to perform on the GitHub API, e.g., 'create_issue', 'delete_issue', 'close_issue', 'list_issues', 'get_issue'",
+                description=(
+                    "The action to perform on the GitHub API, e.g., "
+                    "'create_issue', 'delete_issue', 'close_issue', "
+                    "'list_issues', 'get_issue'"
+                ),
                 required=True,
             ),
             Parameter(
                 name="repo_name",
                 input_type="string",
-                description="The full name of the repository to interact with, e.g. 'owner/repository'.",
+                description=(
+                    "The full name of the repository to interact with, e.g. "
+                    "'owner/repository'."
+                ),
                 required=False,
             ),
             Parameter(
@@ -75,7 +82,9 @@ class GithubIssueTool(ToolBase):
         raise ValueError(f"Action '{action}' is not supported.")
 
     # Issue Management Methods
-    def create_issue(self, repo_name: str, title: str, body: str = None) -> str:
+    def create_issue(
+        self, repo_name: str, title: str, body: str = None
+    ) -> str:
         try:
             repo = self._github.get_repo(repo_name)
             repo.create_issue(title=title, body=body)

swarmauri_toolkit_github/GithubPRTool.py

@@ -14,13 +14,20 @@ class GithubPRTool(ToolBase):
             Parameter(
                 name="action",
                 input_type="string",
-                description="The action to perform on the GitHub API, e.g., 'create_pull', 'merge_pull', 'close_pull', 'get_pull', 'list_pulls' etc.",
+                description=(
+                    "The action to perform on the GitHub API, e.g., "
+                    "'create_pull', 'merge_pull', 'close_pull', 'get_pull', "
+                    "'list_pulls' etc."
+                ),
                 required=True,
             ),
             Parameter(
                 name="repo_name",
                 input_type="string",
-                description="The full name of the repository to interact with, e.g. 'owner/repository'.",
+                description=(
+                    "The full name of the repository to interact with, e.g. "
+                    "'owner/repository'."
+                ),
                 required=False,
             ),
             Parameter(
@@ -44,7 +51,10 @@ class GithubPRTool(ToolBase):
             Parameter(
                 name="base",
                 input_type="string",
-                description="The base branch you're merging into, typically 'main' or 'master'",
+                description=(
+                    "The base branch you're merging into, typically 'main' or "
+                    "'master'"
+                ),
                 required=False,
             ),
             Parameter(
@@ -88,7 +98,12 @@ class GithubPRTool(ToolBase):
 
     # Pull Request Management Methods
     def create_pull(
-        self, repo_name: str, title: str, head: str, base: str, body: str = None
+        self,
+        repo_name: str,
+        title: str,
+        head: str,
+        base: str,
+        body: str = None,
     ) -> str:
         try:
             repo = self._github.get_repo(repo_name)

swarmauri_toolkit_github/GithubRepoTool.py

@@ -14,19 +14,30 @@ class GithubRepoTool(ToolBase):
             Parameter(
                 name="action",
                 input_type="string",
-                description="The action to perform on the GitHub API, e.g., 'create_repo', 'delete_repo', 'update_repo', and 'get_repo'",
+                description=(
+                    "The action to perform on the GitHub API, e.g., "(
+                        "'create_repo', 'delete_repo', 'update_repo', and "
+                        "'get_repo'"
+                    )
+                ),
                 required=True,
             ),
             Parameter(
                 name="repo_name",
                 input_type="string",
-                description="The full name of the repository to interact with, e.g. 'owner/repository'.",
+                description=(
+                    "The full name of the repository to interact with, e.g. "
+                    "'owner/repository'."
+                ),
                 required=False,
             ),
             Parameter(
                 name="file_path",
                 input_type="string",
-                description="The path to the file in the repository, e.g. 'path/to/file.txt'.",
+                description=(
+                    "The path to the file in the repository, e.g. "
+                    "'path/to/file.txt'."
+                ),
                 required=False,
             ),
         ]
@@ -83,7 +94,7 @@ class GithubRepoTool(ToolBase):
     def get_repo(self, repo_name: str) -> str:
         try:
             repo = self._github.get_repo(repo_name)
-            repo_info = f"Repository: {repo.full_name}\nDescription: {repo.description}\nClone URL: {repo.clone_url}"
+            repo_info = f"Repository: {repo.full_name}\nDescription: {repo.description}\nClone URL: {repo.clone_url}"  # noqa: E501
             return repo_info
         except GithubException as e:
             return f"Error retrieving repository info: {e}"

{swarmauri_toolkit_github-0.9.1.dev3.dist-info → swarmauri_toolkit_github-0.11.0.dev1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: swarmauri_toolkit_github
-Version: 0.9.1.dev3
+Version: 0.11.0.dev1
 Summary: Github Toolkit
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -40,11 +40,12 @@ Description-Content-Type: text/markdown
         <img src="https://img.shields.io/pypi/l/swarmauri_toolkit_github" alt="PyPI - License"/></a>
     <a href="https://pypi.org/project/swarmauri_toolkit_github/">
         <img src="https://img.shields.io/pypi/v/swarmauri_toolkit_github?label=swarmauri_toolkit_github&color=green" alt="PyPI - swarmauri_toolkit_github"/></a>
-</p>
+    <a href="https://discord.gg/N4UpBuQv8T">
+        <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
 
-# Swarmauri Toolkit · GitHub
+# Swarmauri Toolkit ? GitHub
 
-A Swarmauri toolkit that wraps PyGithub behind Swarmauri’s agent/tool abstractions. Authenticate once and gain access to repository, issue, pull request, branch, and commit helpers—ready for scripted automation or conversational agents.
+A Swarmauri toolkit that wraps PyGithub behind Swarmauri?s agent/tool abstractions. Authenticate once and gain access to repository, issue, pull request, branch, and commit helpers?ready for scripted automation or conversational agents.
 
 - Creates a shared GitHub client so every tool call reuses the same token and rate-limit state.
 - Normalizes responses into dictionaries so downstream logic can inspect status messages or raw PyGithub payloads.
@@ -52,7 +53,7 @@ A Swarmauri toolkit that wraps PyGithub behind Swarmauri’s agent/tool abs
 
 ## Requirements
 
-- Python 3.10 – 3.13.
+- Python 3.10 ? 3.13.
 - GitHub personal access token (classic or fine-grained) with the scopes your workflow requires. Store it in an environment variable such as `GITHUB_TOKEN`.
 - Runtime dependencies (`PyGithub`, `python-dotenv`, and the Swarmauri base/standard packages) install automatically with the toolkit.
 
@@ -82,7 +83,7 @@ uv add swarmauri_toolkit_github
 uv pip install swarmauri_toolkit_github
 ```
 
-> Tip: `python-dotenv` is imported automatically—drop your token into a local `.env` file (`GITHUB_TOKEN=ghp_...`) for quick experimentation.
+> Tip: `python-dotenv` is imported automatically?drop your token into a local `.env` file (`GITHUB_TOKEN=ghp_...`) for quick experimentation.
 
 ## Quick Start
 
@@ -185,11 +186,13 @@ Keep a backlog tidy by automatically nudging stale tickets.
 
 ## Troubleshooting
 
-- **`ValueError: Invalid Token or Missing api_token`** – Pass the token explicitly (`GithubToolkit(api_token=...)`) or export `GITHUB_TOKEN` before instantiating the toolkit.
-- **PyGithub exception messages** – Most actions bubble up PyGithub errors verbatim (permission issues, missing branches, etc.). Inspect the text in the returned string to resolve scope or naming problems.
-- **GitHub rate limits** – PyGithub tracks remaining requests; consider batching actions or sleeping when `Github.get_rate_limit()` indicates low headroom.
+- **`ValueError: Invalid Token or Missing api_token`** ? Pass the token explicitly (`GithubToolkit(api_token=...)`) or export `GITHUB_TOKEN` before instantiating the toolkit.
+- **PyGithub exception messages** ? Most actions bubble up PyGithub errors verbatim (permission issues, missing branches, etc.). Inspect the text in the returned string to resolve scope or naming problems.
+- **GitHub rate limits** ? PyGithub tracks remaining requests; consider batching actions or sleeping when `Github.get_rate_limit()` indicates low headroom.
 
 ## License
 
 `swarmauri_toolkit_github` is released under the Apache 2.0 License. See `LICENSE` for full details.
 
+
+

swarmauri_toolkit_github-0.11.0.dev1.dist-info/RECORD

@@ -0,0 +1,12 @@
+swarmauri_toolkit_github/GithubBranchTool.py,sha256=L2V-YvOAqumJo-wybSzMXlOnCdPNIOgbhQyCRDArzT8,4244
+swarmauri_toolkit_github/GithubCommitTool.py,sha256=C8sqi74eFswJlltQiWdqd9D49qnwwPPsDiAJ2ctK3xo,5254
+swarmauri_toolkit_github/GithubIssueTool.py,sha256=Cdv9-lvsUA3lU9vqOp2YGS4Oy4Q55HUJccc7fZPs5QQ,4656
+swarmauri_toolkit_github/GithubPRTool.py,sha256=_SWEDNVDwSlvyimW7VZYkcCKAaQ6jb5oj-dsf-Hz6oQ,5265
+swarmauri_toolkit_github/GithubRepoTool.py,sha256=I6ZmwFaEOicIJXkpqmlLTU1JtGugonBmRxgu2btqRro,4218
+swarmauri_toolkit_github/GithubToolkit.py,sha256=gXLnqbHfNzMM979rDrRpioFnW20O8Qkw9IOVxsjmoP0,1852
+swarmauri_toolkit_github/__init__.py,sha256=ugR4rSIjWjFsklYq1zKlDuNwi2ao9NnzEcgQdGAtVgY,836
+swarmauri_toolkit_github-0.11.0.dev1.dist-info/METADATA,sha256=RXfPtdBL9bEUASk-kIhBN5rvny9qc5Izl-5Klec0QGc,7316
+swarmauri_toolkit_github-0.11.0.dev1.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
+swarmauri_toolkit_github-0.11.0.dev1.dist-info/entry_points.txt,sha256=2xC828KqwS3K-0qhlcdqbKhtoQhkzst3Y0i0KfCzXNI,467
+swarmauri_toolkit_github-0.11.0.dev1.dist-info/licenses/LICENSE,sha256=djUXOlCxLVszShEpZXshZ7v33G-2qIC_j9KXpWKZSzQ,11359
+swarmauri_toolkit_github-0.11.0.dev1.dist-info/RECORD,,

{swarmauri_toolkit_github-0.9.1.dev3.dist-info → swarmauri_toolkit_github-0.11.0.dev1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.4.0
+Generator: poetry-core 2.4.1
 Root-Is-Purelib: true
 Tag: py3-none-any

swarmauri_toolkit_github-0.9.1.dev3.dist-info/RECORD

@@ -1,12 +0,0 @@
-swarmauri_toolkit_github/GithubBranchTool.py,sha256=kAb-iBP7SVNqFP9JT3jZkIZUsHquTI74oB-ttd_5mBw,4078
-swarmauri_toolkit_github/GithubCommitTool.py,sha256=M6QXm_upD1QInenheQ2dWJq1BZDGWq6wG0kb-g7AXzQ,5065
-swarmauri_toolkit_github/GithubIssueTool.py,sha256=Xgu2kPZqdtjy9Hj6LGjcZFuu7cw7DW9-67ywkmE4Ppw,4493
-swarmauri_toolkit_github/GithubPRTool.py,sha256=ptSPk7FabS9OJ1Qdf34ydfYONbNu9r2xsnSN8aibGn4,5012
-swarmauri_toolkit_github/GithubRepoTool.py,sha256=YqkQN4tqSnzMK01azjrtO7iTFbAay_psAB8YXo7Jj3k,3961
-swarmauri_toolkit_github/GithubToolkit.py,sha256=gXLnqbHfNzMM979rDrRpioFnW20O8Qkw9IOVxsjmoP0,1852
-swarmauri_toolkit_github/__init__.py,sha256=ugR4rSIjWjFsklYq1zKlDuNwi2ao9NnzEcgQdGAtVgY,836
-swarmauri_toolkit_github-0.9.1.dev3.dist-info/METADATA,sha256=1QH_L8UHTwnsD3FxxWc1fFcSy8OvQTXCSgW9g5QbYaU,7197
-swarmauri_toolkit_github-0.9.1.dev3.dist-info/WHEEL,sha256=EGEvSphFYqXKs23-kQBeyNoJP1nrT8ZJKQoi5p5DYL8,88
-swarmauri_toolkit_github-0.9.1.dev3.dist-info/entry_points.txt,sha256=2xC828KqwS3K-0qhlcdqbKhtoQhkzst3Y0i0KfCzXNI,467
-swarmauri_toolkit_github-0.9.1.dev3.dist-info/licenses/LICENSE,sha256=djUXOlCxLVszShEpZXshZ7v33G-2qIC_j9KXpWKZSzQ,11359
-swarmauri_toolkit_github-0.9.1.dev3.dist-info/RECORD,,