swarmauri_toolkit_github 0.9.0.dev7__tar.gz → 0.9.1.dev2__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,51 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: swarmauri_toolkit_github
3
- Version: 0.9.0.dev7
3
+ Version: 0.9.1.dev2
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
-
40
44
  ---
41
45
 
42
- # Swarmauri Toolkit · GitHub
46
+ # Swarmauri Toolkit · GitHub
43
47
 
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.
48
+ 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
49
 
46
50
  - Creates a shared GitHub client so every tool call reuses the same token and rate-limit state.
47
51
  - Normalizes responses into dictionaries so downstream logic can inspect status messages or raw PyGithub payloads.
@@ -49,7 +53,7 @@ A Swarmauri toolkit that wraps PyGithub behind Swarmauri’s agent/tool abstract
49
53
 
50
54
  ## Requirements
51
55
 
52
- - Python 3.10 3.13.
56
+ - Python 3.10 – 3.13.
53
57
  - 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
58
  - Runtime dependencies (`PyGithub`, `python-dotenv`, and the Swarmauri base/standard packages) install automatically with the toolkit.
55
59
 
@@ -79,7 +83,7 @@ uv add swarmauri_toolkit_github
79
83
  uv pip install swarmauri_toolkit_github
80
84
  ```
81
85
 
82
- > Tip: `python-dotenv` is imported automaticallydrop your token into a local `.env` file (`GITHUB_TOKEN=ghp_...`) for quick experimentation.
86
+ > Tip: `python-dotenv` is imported automatically—drop your token into a local `.env` file (`GITHUB_TOKEN=ghp_...`) for quick experimentation.
83
87
 
84
88
  ## Quick Start
85
89
 
@@ -182,9 +186,9 @@ Keep a backlog tidy by automatically nudging stale tickets.
182
186
 
183
187
  ## Troubleshooting
184
188
 
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.
189
+ - **`ValueError: Invalid Token or Missing api_token`** – Pass the token explicitly (`GithubToolkit(api_token=...)`) or export `GITHUB_TOKEN` before instantiating the toolkit.
190
+ - **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.
191
+ - **GitHub rate limits** – PyGithub tracks remaining requests; consider batching actions or sleeping when `Github.get_rate_limit()` indicates low headroom.
188
192
 
189
193
  ## License
190
194
 
@@ -1,23 +1,22 @@
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
-
16
15
  ---
17
16
 
18
- # Swarmauri Toolkit · GitHub
17
+ # Swarmauri Toolkit · GitHub
19
18
 
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.
19
+ 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
20
 
22
21
  - Creates a shared GitHub client so every tool call reuses the same token and rate-limit state.
23
22
  - Normalizes responses into dictionaries so downstream logic can inspect status messages or raw PyGithub payloads.
@@ -25,7 +24,7 @@ A Swarmauri toolkit that wraps PyGithub behind Swarmauri’s agent/tool abstract
25
24
 
26
25
  ## Requirements
27
26
 
28
- - Python 3.10 3.13.
27
+ - Python 3.10 – 3.13.
29
28
  - 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
29
  - Runtime dependencies (`PyGithub`, `python-dotenv`, and the Swarmauri base/standard packages) install automatically with the toolkit.
31
30
 
@@ -55,7 +54,7 @@ uv add swarmauri_toolkit_github
55
54
  uv pip install swarmauri_toolkit_github
56
55
  ```
57
56
 
58
- > Tip: `python-dotenv` is imported automaticallydrop your token into a local `.env` file (`GITHUB_TOKEN=ghp_...`) for quick experimentation.
57
+ > Tip: `python-dotenv` is imported automatically—drop your token into a local `.env` file (`GITHUB_TOKEN=ghp_...`) for quick experimentation.
59
58
 
60
59
  ## Quick Start
61
60
 
@@ -158,9 +157,9 @@ Keep a backlog tidy by automatically nudging stale tickets.
158
157
 
159
158
  ## Troubleshooting
160
159
 
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.
160
+ - **`ValueError: Invalid Token or Missing api_token`** – Pass the token explicitly (`GithubToolkit(api_token=...)`) or export `GITHUB_TOKEN` before instantiating the toolkit.
161
+ - **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.
162
+ - **GitHub rate limits** – PyGithub tracks remaining requests; consider batching actions or sleeping when `Github.get_rate_limit()` indicates low headroom.
164
163
 
165
164
  ## License
166
165
 
@@ -1,20 +1,25 @@
1
1
  [project]
2
2
  name = "swarmauri_toolkit_github"
3
- version = "0.9.0.dev7"
3
+ version = "0.9.1.dev2"
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 = [