swarmauri_toolkit_github 0.9.0.dev7__tar.gz → 0.9.1.dev3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,47 +1,50 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: swarmauri_toolkit_github
3
- Version: 0.9.0.dev7
3
+ Version: 0.9.1.dev3
4
4
  Summary: Github Toolkit
5
5
  License-Expression: Apache-2.0
6
6
  License-File: LICENSE
7
7
  Keywords: swarmauri,toolkit,github
8
8
  Author: Jacob Stewart
9
9
  Author-email: jacob@swarmauri.com
10
- Requires-Python: >=3.10,<3.13
10
+ Requires-Python: >=3.10,<3.15
11
11
  Classifier: License :: OSI Approved :: Apache Software License
12
- Classifier: Programming Language :: Python :: 3.10
13
- Classifier: Programming Language :: Python :: 3.11
14
- Classifier: Programming Language :: Python :: 3.12
15
12
  Classifier: Natural Language :: English
16
13
  Classifier: Development Status :: 3 - Alpha
17
14
  Classifier: Intended Audience :: Developers
18
15
  Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
16
+ Classifier: Programming Language :: Python
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3 :: Only
19
+ Classifier: Programming Language :: Python :: 3.10
20
+ Classifier: Programming Language :: Python :: 3.11
21
+ Classifier: Programming Language :: Python :: 3.12
22
+ Classifier: Programming Language :: Python :: 3.13
23
+ Classifier: Programming Language :: Python :: 3.14
19
24
  Requires-Dist: pygithub (>=2.4.0)
20
25
  Requires-Dist: swarmauri_base
21
26
  Requires-Dist: swarmauri_core
22
27
  Requires-Dist: swarmauri_standard
23
28
  Description-Content-Type: text/markdown
24
29
 
25
- ![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg)
30
+ ![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)
26
31
 
27
32
  <p align="center">
28
- <a href="https://pypi.org/project/swarmauri_toolkit_github/">
29
- <img src="https://img.shields.io/pypi/dm/swarmauri_toolkit_github" alt="PyPI - Downloads"/></a>
33
+ <a href="https://pepy.tech/project/swarmauri_toolkit_github/">
34
+ <img src="https://static.pepy.tech/badge/swarmauri_toolkit_github/month" alt="PyPI - Downloads"/></a>
30
35
  <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_toolkit_github/">
31
36
  <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_toolkit_github.svg"/></a>
32
37
  <a href="https://pypi.org/project/swarmauri_toolkit_github/">
33
- <img src="https://img.shields.io/pypi/pyversions/swarmauri_toolkit_github" alt="PyPI - Python Version"/></a>
38
+ <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
34
39
  <a href="https://pypi.org/project/swarmauri_toolkit_github/">
35
40
  <img src="https://img.shields.io/pypi/l/swarmauri_toolkit_github" alt="PyPI - License"/></a>
36
41
  <a href="https://pypi.org/project/swarmauri_toolkit_github/">
37
42
  <img src="https://img.shields.io/pypi/v/swarmauri_toolkit_github?label=swarmauri_toolkit_github&color=green" alt="PyPI - swarmauri_toolkit_github"/></a>
38
43
  </p>
39
44
 
40
- ---
41
-
42
- # Swarmauri Toolkit · GitHub
45
+ # Swarmauri Toolkit · GitHub
43
46
 
44
- A Swarmauri toolkit that wraps PyGithub behind Swarmauris agent/tool abstractions. Authenticate once and gain access to repository, issue, pull request, branch, and commit helpersready for scripted automation or conversational agents.
47
+ 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.
45
48
 
46
49
  - Creates a shared GitHub client so every tool call reuses the same token and rate-limit state.
47
50
  - Normalizes responses into dictionaries so downstream logic can inspect status messages or raw PyGithub payloads.
@@ -49,7 +52,7 @@ A Swarmauri toolkit that wraps PyGithub behind Swarmauri’s agent/tool abstract
49
52
 
50
53
  ## Requirements
51
54
 
52
- - Python 3.10 3.13.
55
+ - Python 3.10 – 3.13.
53
56
  - GitHub personal access token (classic or fine-grained) with the scopes your workflow requires. Store it in an environment variable such as `GITHUB_TOKEN`.
54
57
  - Runtime dependencies (`PyGithub`, `python-dotenv`, and the Swarmauri base/standard packages) install automatically with the toolkit.
55
58
 
@@ -79,7 +82,7 @@ uv add swarmauri_toolkit_github
79
82
  uv pip install swarmauri_toolkit_github
80
83
  ```
81
84
 
82
- > Tip: `python-dotenv` is imported automaticallydrop your token into a local `.env` file (`GITHUB_TOKEN=ghp_...`) for quick experimentation.
85
+ > Tip: `python-dotenv` is imported automatically—drop your token into a local `.env` file (`GITHUB_TOKEN=ghp_...`) for quick experimentation.
83
86
 
84
87
  ## Quick Start
85
88
 
@@ -182,9 +185,9 @@ Keep a backlog tidy by automatically nudging stale tickets.
182
185
 
183
186
  ## Troubleshooting
184
187
 
185
- - **`ValueError: Invalid Token or Missing api_token`** Pass the token explicitly (`GithubToolkit(api_token=...)`) or export `GITHUB_TOKEN` before instantiating the toolkit.
186
- - **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.
187
- - **GitHub rate limits** PyGithub tracks remaining requests; consider batching actions or sleeping when `Github.get_rate_limit()` indicates low headroom.
188
+ - **`ValueError: Invalid Token or Missing api_token`** – Pass the token explicitly (`GithubToolkit(api_token=...)`) or export `GITHUB_TOKEN` before instantiating the toolkit.
189
+ - **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.
190
+ - **GitHub rate limits** – PyGithub tracks remaining requests; consider batching actions or sleeping when `Github.get_rate_limit()` indicates low headroom.
188
191
 
189
192
  ## License
190
193
 
@@ -1,23 +1,21 @@
1
- ![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg)
1
+ ![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)
2
2
 
3
3
  <p align="center">
4
- <a href="https://pypi.org/project/swarmauri_toolkit_github/">
5
- <img src="https://img.shields.io/pypi/dm/swarmauri_toolkit_github" alt="PyPI - Downloads"/></a>
4
+ <a href="https://pepy.tech/project/swarmauri_toolkit_github/">
5
+ <img src="https://static.pepy.tech/badge/swarmauri_toolkit_github/month" alt="PyPI - Downloads"/></a>
6
6
  <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_toolkit_github/">
7
7
  <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/community/swarmauri_toolkit_github.svg"/></a>
8
8
  <a href="https://pypi.org/project/swarmauri_toolkit_github/">
9
- <img src="https://img.shields.io/pypi/pyversions/swarmauri_toolkit_github" alt="PyPI - Python Version"/></a>
9
+ <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
10
10
  <a href="https://pypi.org/project/swarmauri_toolkit_github/">
11
11
  <img src="https://img.shields.io/pypi/l/swarmauri_toolkit_github" alt="PyPI - License"/></a>
12
12
  <a href="https://pypi.org/project/swarmauri_toolkit_github/">
13
13
  <img src="https://img.shields.io/pypi/v/swarmauri_toolkit_github?label=swarmauri_toolkit_github&color=green" alt="PyPI - swarmauri_toolkit_github"/></a>
14
14
  </p>
15
15
 
16
- ---
17
-
18
- # Swarmauri Toolkit · GitHub
16
+ # Swarmauri Toolkit · GitHub
19
17
 
20
- A Swarmauri toolkit that wraps PyGithub behind Swarmauris agent/tool abstractions. Authenticate once and gain access to repository, issue, pull request, branch, and commit helpersready for scripted automation or conversational agents.
18
+ 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.
21
19
 
22
20
  - Creates a shared GitHub client so every tool call reuses the same token and rate-limit state.
23
21
  - Normalizes responses into dictionaries so downstream logic can inspect status messages or raw PyGithub payloads.
@@ -25,7 +23,7 @@ A Swarmauri toolkit that wraps PyGithub behind Swarmauri’s agent/tool abstract
25
23
 
26
24
  ## Requirements
27
25
 
28
- - Python 3.10 3.13.
26
+ - Python 3.10 – 3.13.
29
27
  - GitHub personal access token (classic or fine-grained) with the scopes your workflow requires. Store it in an environment variable such as `GITHUB_TOKEN`.
30
28
  - Runtime dependencies (`PyGithub`, `python-dotenv`, and the Swarmauri base/standard packages) install automatically with the toolkit.
31
29
 
@@ -55,7 +53,7 @@ uv add swarmauri_toolkit_github
55
53
  uv pip install swarmauri_toolkit_github
56
54
  ```
57
55
 
58
- > Tip: `python-dotenv` is imported automaticallydrop your token into a local `.env` file (`GITHUB_TOKEN=ghp_...`) for quick experimentation.
56
+ > Tip: `python-dotenv` is imported automatically—drop your token into a local `.env` file (`GITHUB_TOKEN=ghp_...`) for quick experimentation.
59
57
 
60
58
  ## Quick Start
61
59
 
@@ -158,9 +156,9 @@ Keep a backlog tidy by automatically nudging stale tickets.
158
156
 
159
157
  ## Troubleshooting
160
158
 
161
- - **`ValueError: Invalid Token or Missing api_token`** Pass the token explicitly (`GithubToolkit(api_token=...)`) or export `GITHUB_TOKEN` before instantiating the toolkit.
162
- - **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.
163
- - **GitHub rate limits** PyGithub tracks remaining requests; consider batching actions or sleeping when `Github.get_rate_limit()` indicates low headroom.
159
+ - **`ValueError: Invalid Token or Missing api_token`** – Pass the token explicitly (`GithubToolkit(api_token=...)`) or export `GITHUB_TOKEN` before instantiating the toolkit.
160
+ - **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.
161
+ - **GitHub rate limits** – PyGithub tracks remaining requests; consider batching actions or sleeping when `Github.get_rate_limit()` indicates low headroom.
164
162
 
165
163
  ## License
166
164
 
@@ -1,20 +1,25 @@
1
1
  [project]
2
2
  name = "swarmauri_toolkit_github"
3
- version = "0.9.0.dev7"
3
+ version = "0.9.1.dev3"
4
4
  description = "Github Toolkit"
5
5
  license = "Apache-2.0"
6
6
  readme = "README.md"
7
7
  repository = "http://github.com/swarmauri/swarmauri-sdk"
8
- requires-python = ">=3.10,<3.13"
8
+ requires-python = ">=3.10,<3.15"
9
9
  classifiers = [
10
10
  "License :: OSI Approved :: Apache Software License",
11
- "Programming Language :: Python :: 3.10",
12
- "Programming Language :: Python :: 3.11",
13
- "Programming Language :: Python :: 3.12",
14
11
  "Natural Language :: English",
15
12
  "Development Status :: 3 - Alpha",
16
13
  "Intended Audience :: Developers",
17
14
  "Topic :: Software Development :: Libraries :: Application Frameworks",
15
+ "Programming Language :: Python",
16
+ "Programming Language :: Python :: 3",
17
+ "Programming Language :: Python :: 3 :: Only",
18
+ "Programming Language :: Python :: 3.10",
19
+ "Programming Language :: Python :: 3.11",
20
+ "Programming Language :: Python :: 3.12",
21
+ "Programming Language :: Python :: 3.13",
22
+ "Programming Language :: Python :: 3.14",
18
23
  ]
19
24
  authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
20
25
  dependencies = [