swm_example_plugin 0.6.5.dev19__tar.gz → 0.6.6.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.
- {swm_example_plugin-0.6.5.dev19 → swm_example_plugin-0.6.6.dev3}/PKG-INFO +26 -25
- swm_example_plugin-0.6.6.dev3/README.md +78 -0
- {swm_example_plugin-0.6.5.dev19 → swm_example_plugin-0.6.6.dev3}/pyproject.toml +9 -7
- swm_example_plugin-0.6.5.dev19/README.md +0 -79
- {swm_example_plugin-0.6.5.dev19 → swm_example_plugin-0.6.6.dev3}/LICENSE +0 -0
- {swm_example_plugin-0.6.5.dev19 → swm_example_plugin-0.6.6.dev3}/swm_example_plugin/__init__.py +0 -0
|
@@ -1,27 +1,29 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: swm_example_plugin
|
|
3
|
-
Version: 0.6.
|
|
3
|
+
Version: 0.6.6.dev3
|
|
4
4
|
Summary: This repository includes an example of a Swarmauri Plugin.
|
|
5
5
|
License-Expression: Apache-2.0
|
|
6
6
|
License-File: LICENSE
|
|
7
7
|
Keywords: swarmauri,plugin,example,agents,entry-points,sdk,scaffolding,template,tutorial,packaging,asyncio,extension-points,media-workflows
|
|
8
8
|
Author: Jacob Stewart
|
|
9
9
|
Author-email: jacob@swarmauri.com
|
|
10
|
-
Requires-Python: >=3.10,<3.
|
|
10
|
+
Requires-Python: >=3.10,<3.15
|
|
11
11
|
Classifier: Development Status :: 1 - Planning
|
|
12
12
|
Classifier: License :: OSI Approved :: Apache Software License
|
|
13
13
|
Classifier: Natural Language :: English
|
|
14
|
+
Classifier: Framework :: AsyncIO
|
|
15
|
+
Classifier: Operating System :: OS Independent
|
|
16
|
+
Classifier: Intended Audience :: Developers
|
|
17
|
+
Classifier: Topic :: Software Development :: Libraries
|
|
18
|
+
Classifier: Topic :: Education
|
|
14
19
|
Classifier: Programming Language :: Python
|
|
15
20
|
Classifier: Programming Language :: Python :: 3
|
|
16
21
|
Classifier: Programming Language :: Python :: 3 :: Only
|
|
17
22
|
Classifier: Programming Language :: Python :: 3.10
|
|
18
23
|
Classifier: Programming Language :: Python :: 3.11
|
|
19
24
|
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
-
Classifier:
|
|
21
|
-
Classifier:
|
|
22
|
-
Classifier: Intended Audience :: Developers
|
|
23
|
-
Classifier: Topic :: Software Development :: Libraries
|
|
24
|
-
Classifier: Topic :: Education
|
|
25
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
26
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
25
27
|
Project-URL: Changelog, https://github.com/swarmauri/swarmauri-sdk/releases
|
|
26
28
|
Project-URL: Documentation, https://github.com/swarmauri/swarmauri-sdk/tree/main/pkgs/plugins/example_plugin#readme
|
|
27
29
|
Project-URL: Discussions, https://github.com/orgs/swarmauri/discussions
|
|
@@ -30,22 +32,21 @@ Project-URL: Issues, https://github.com/swarmauri/swarmauri-sdk/issues
|
|
|
30
32
|
Project-URL: Source, https://github.com/swarmauri/swarmauri-sdk/tree/main/pkgs/plugins/example_plugin
|
|
31
33
|
Description-Content-Type: text/markdown
|
|
32
34
|
|
|
33
|
-
|
|
34
|
-
<img src="https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg" alt="Swarmauri logotype" width="420" />
|
|
35
|
-
</p>
|
|
36
|
-
|
|
37
|
-
<h1 align="center">Swarmauri Example Plugin</h1>
|
|
35
|
+
|
|
38
36
|
|
|
39
37
|
<p align="center">
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
38
|
+
<a href="https://pepy.tech/project/swm_example_plugin/">
|
|
39
|
+
<img src="https://static.pepy.tech/badge/swm_example_plugin/month" alt="PyPI - Downloads"/></a>
|
|
40
|
+
<a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/plugins/example_plugin/">
|
|
41
|
+
<img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/plugins/example_plugin.svg"/></a>
|
|
42
|
+
<a href="https://pypi.org/project/swm_example_plugin/">
|
|
43
|
+
<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>
|
|
44
|
+
<a href="https://pypi.org/project/swm_example_plugin/">
|
|
45
|
+
<img src="https://img.shields.io/pypi/l/swm_example_plugin" alt="PyPI - License"/></a>
|
|
46
|
+
<a href="https://pypi.org/project/swm_example_plugin/">
|
|
47
|
+
<img src="https://img.shields.io/pypi/v/swm_example_plugin?label=swm_example_plugin&color=green" alt="PyPI - swm_example_plugin"/></a>
|
|
45
48
|
</p>
|
|
46
49
|
|
|
47
|
-
---
|
|
48
|
-
|
|
49
50
|
The Swarmauri Example Plugin is a lightweight reference package that shows how to
|
|
50
51
|
ship a plugin ready for the Swarmauri ecosystem. It demonstrates how to declare
|
|
51
52
|
entry points, surface metadata, and structure tests so that new plugin projects
|
|
@@ -53,13 +54,13 @@ start from a fully configured baseline that supports Python 3.10 through 3.12.
|
|
|
53
54
|
|
|
54
55
|
## Features
|
|
55
56
|
|
|
56
|
-
- **Entry-point wiring**
|
|
57
|
+
- **Entry-point wiring** - exposes the `swarmauri.plugins` group so your agent
|
|
57
58
|
classes can be discovered automatically once implemented.
|
|
58
|
-
- **Ready-to-publish metadata**
|
|
59
|
+
- **Ready-to-publish metadata** - includes keywords, classifiers, and long
|
|
59
60
|
descriptions wired directly into `pyproject.toml`.
|
|
60
|
-
- **Version helpers**
|
|
61
|
+
- **Version helpers** - surfaces `__version__` and `__long_desc__` constants so
|
|
61
62
|
documentation and tooling can introspect the package after installation.
|
|
62
|
-
- **Testing scaffold**
|
|
63
|
+
- **Testing scaffold** - ships with baseline unit tests verifying version
|
|
63
64
|
resolution to encourage a test-first development workflow.
|
|
64
65
|
|
|
65
66
|
## Installation
|
|
@@ -104,8 +105,8 @@ custom functionality into the Swarmauri plugin registry.
|
|
|
104
105
|
|
|
105
106
|
## Project Resources
|
|
106
107
|
|
|
107
|
-
- Source: <https://github.com/swarmauri/swarmauri-sdk/tree/
|
|
108
|
-
- Documentation: <https://github.com/swarmauri/swarmauri-sdk/tree/
|
|
108
|
+
- Source: <https://github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/plugins/example_plugin>
|
|
109
|
+
- Documentation: <https://github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/plugins/example_plugin#readme>
|
|
109
110
|
- Issues: <https://github.com/swarmauri/swarmauri-sdk/issues>
|
|
110
111
|
- Releases: <https://github.com/swarmauri/swarmauri-sdk/releases>
|
|
111
112
|
- Discussions: <https://github.com/orgs/swarmauri/discussions>
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<a href="https://pepy.tech/project/swm_example_plugin/">
|
|
5
|
+
<img src="https://static.pepy.tech/badge/swm_example_plugin/month" alt="PyPI - Downloads"/></a>
|
|
6
|
+
<a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/plugins/example_plugin/">
|
|
7
|
+
<img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/plugins/example_plugin.svg"/></a>
|
|
8
|
+
<a href="https://pypi.org/project/swm_example_plugin/">
|
|
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
|
+
<a href="https://pypi.org/project/swm_example_plugin/">
|
|
11
|
+
<img src="https://img.shields.io/pypi/l/swm_example_plugin" alt="PyPI - License"/></a>
|
|
12
|
+
<a href="https://pypi.org/project/swm_example_plugin/">
|
|
13
|
+
<img src="https://img.shields.io/pypi/v/swm_example_plugin?label=swm_example_plugin&color=green" alt="PyPI - swm_example_plugin"/></a>
|
|
14
|
+
</p>
|
|
15
|
+
|
|
16
|
+
The Swarmauri Example Plugin is a lightweight reference package that shows how to
|
|
17
|
+
ship a plugin ready for the Swarmauri ecosystem. It demonstrates how to declare
|
|
18
|
+
entry points, surface metadata, and structure tests so that new plugin projects
|
|
19
|
+
start from a fully configured baseline that supports Python 3.10 through 3.12.
|
|
20
|
+
|
|
21
|
+
## Features
|
|
22
|
+
|
|
23
|
+
- **Entry-point wiring** - exposes the `swarmauri.plugins` group so your agent
|
|
24
|
+
classes can be discovered automatically once implemented.
|
|
25
|
+
- **Ready-to-publish metadata** - includes keywords, classifiers, and long
|
|
26
|
+
descriptions wired directly into `pyproject.toml`.
|
|
27
|
+
- **Version helpers** - surfaces `__version__` and `__long_desc__` constants so
|
|
28
|
+
documentation and tooling can introspect the package after installation.
|
|
29
|
+
- **Testing scaffold** - ships with baseline unit tests verifying version
|
|
30
|
+
resolution to encourage a test-first development workflow.
|
|
31
|
+
|
|
32
|
+
## Installation
|
|
33
|
+
|
|
34
|
+
### Using `uv`
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
uv add swm-example-plugin
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
### Using `pip`
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
pip install swm-example-plugin
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Usage
|
|
47
|
+
|
|
48
|
+
### Inspect published metadata
|
|
49
|
+
|
|
50
|
+
```python
|
|
51
|
+
from swm_example_plugin import __long_desc__, __version__
|
|
52
|
+
|
|
53
|
+
print(__version__)
|
|
54
|
+
print(__long_desc__.splitlines()[0])
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### Discover the registered entry point
|
|
58
|
+
|
|
59
|
+
```python
|
|
60
|
+
from importlib.metadata import entry_points
|
|
61
|
+
|
|
62
|
+
for ep in entry_points(group="swarmauri.plugins"):
|
|
63
|
+
if ep.name == "example_agent":
|
|
64
|
+
print(ep.name, "->", ep.value)
|
|
65
|
+
break
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
This skeleton intentionally leaves the actual agent implementation up to you.
|
|
69
|
+
Replace the target specified in the entry point with your concrete class to wire
|
|
70
|
+
custom functionality into the Swarmauri plugin registry.
|
|
71
|
+
|
|
72
|
+
## Project Resources
|
|
73
|
+
|
|
74
|
+
- Source: <https://github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/plugins/example_plugin>
|
|
75
|
+
- Documentation: <https://github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/plugins/example_plugin#readme>
|
|
76
|
+
- Issues: <https://github.com/swarmauri/swarmauri-sdk/issues>
|
|
77
|
+
- Releases: <https://github.com/swarmauri/swarmauri-sdk/releases>
|
|
78
|
+
- Discussions: <https://github.com/orgs/swarmauri/discussions>
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "swm_example_plugin"
|
|
3
|
-
version = "0.6.
|
|
3
|
+
version = "0.6.6.dev3"
|
|
4
4
|
description = "This repository includes an example of a Swarmauri Plugin."
|
|
5
5
|
authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
|
|
6
6
|
license = "Apache-2.0"
|
|
@@ -10,19 +10,21 @@ classifiers = [
|
|
|
10
10
|
"Development Status :: 1 - Planning",
|
|
11
11
|
"License :: OSI Approved :: Apache Software License",
|
|
12
12
|
"Natural Language :: English",
|
|
13
|
+
"Framework :: AsyncIO",
|
|
14
|
+
"Operating System :: OS Independent",
|
|
15
|
+
"Intended Audience :: Developers",
|
|
16
|
+
"Topic :: Software Development :: Libraries",
|
|
17
|
+
"Topic :: Education",
|
|
13
18
|
"Programming Language :: Python",
|
|
14
19
|
"Programming Language :: Python :: 3",
|
|
15
20
|
"Programming Language :: Python :: 3 :: Only",
|
|
16
21
|
"Programming Language :: Python :: 3.10",
|
|
17
22
|
"Programming Language :: Python :: 3.11",
|
|
18
23
|
"Programming Language :: Python :: 3.12",
|
|
19
|
-
"
|
|
20
|
-
"
|
|
21
|
-
"Intended Audience :: Developers",
|
|
22
|
-
"Topic :: Software Development :: Libraries",
|
|
23
|
-
"Topic :: Education",
|
|
24
|
+
"Programming Language :: Python :: 3.13",
|
|
25
|
+
"Programming Language :: Python :: 3.14",
|
|
24
26
|
]
|
|
25
|
-
requires-python = ">=3.10,<3.
|
|
27
|
+
requires-python = ">=3.10,<3.15"
|
|
26
28
|
dependencies = []
|
|
27
29
|
|
|
28
30
|
keywords = [
|
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<img src="https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg" alt="Swarmauri logotype" width="420" />
|
|
3
|
-
</p>
|
|
4
|
-
|
|
5
|
-
<h1 align="center">Swarmauri Example Plugin</h1>
|
|
6
|
-
|
|
7
|
-
<p align="center">
|
|
8
|
-
<a href="https://pypi.org/project/swm-example-plugin/"><img src="https://img.shields.io/pypi/dm/swm-example-plugin?style=for-the-badge" alt="PyPI - Downloads" /></a>
|
|
9
|
-
<a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/main/pkgs/plugins/example_plugin/"><img src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/main/pkgs/plugins/example_plugin.svg?style=for-the-badge" alt="Repository views" /></a>
|
|
10
|
-
<a href="https://pypi.org/project/swm-example-plugin/"><img src="https://img.shields.io/pypi/pyversions/swm-example-plugin?style=for-the-badge" alt="Supported Python versions" /></a>
|
|
11
|
-
<a href="https://pypi.org/project/swm-example-plugin/"><img src="https://img.shields.io/pypi/l/swm-example-plugin?style=for-the-badge" alt="License" /></a>
|
|
12
|
-
<a href="https://pypi.org/project/swm-example-plugin/"><img src="https://img.shields.io/pypi/v/swm-example-plugin?style=for-the-badge&label=swm-example-plugin" alt="Latest release" /></a>
|
|
13
|
-
</p>
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
The Swarmauri Example Plugin is a lightweight reference package that shows how to
|
|
18
|
-
ship a plugin ready for the Swarmauri ecosystem. It demonstrates how to declare
|
|
19
|
-
entry points, surface metadata, and structure tests so that new plugin projects
|
|
20
|
-
start from a fully configured baseline that supports Python 3.10 through 3.12.
|
|
21
|
-
|
|
22
|
-
## Features
|
|
23
|
-
|
|
24
|
-
- **Entry-point wiring** – exposes the `swarmauri.plugins` group so your agent
|
|
25
|
-
classes can be discovered automatically once implemented.
|
|
26
|
-
- **Ready-to-publish metadata** – includes keywords, classifiers, and long
|
|
27
|
-
descriptions wired directly into `pyproject.toml`.
|
|
28
|
-
- **Version helpers** – surfaces `__version__` and `__long_desc__` constants so
|
|
29
|
-
documentation and tooling can introspect the package after installation.
|
|
30
|
-
- **Testing scaffold** – ships with baseline unit tests verifying version
|
|
31
|
-
resolution to encourage a test-first development workflow.
|
|
32
|
-
|
|
33
|
-
## Installation
|
|
34
|
-
|
|
35
|
-
### Using `uv`
|
|
36
|
-
|
|
37
|
-
```bash
|
|
38
|
-
uv add swm-example-plugin
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
### Using `pip`
|
|
42
|
-
|
|
43
|
-
```bash
|
|
44
|
-
pip install swm-example-plugin
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
## Usage
|
|
48
|
-
|
|
49
|
-
### Inspect published metadata
|
|
50
|
-
|
|
51
|
-
```python
|
|
52
|
-
from swm_example_plugin import __long_desc__, __version__
|
|
53
|
-
|
|
54
|
-
print(__version__)
|
|
55
|
-
print(__long_desc__.splitlines()[0])
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
### Discover the registered entry point
|
|
59
|
-
|
|
60
|
-
```python
|
|
61
|
-
from importlib.metadata import entry_points
|
|
62
|
-
|
|
63
|
-
for ep in entry_points(group="swarmauri.plugins"):
|
|
64
|
-
if ep.name == "example_agent":
|
|
65
|
-
print(ep.name, "->", ep.value)
|
|
66
|
-
break
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
This skeleton intentionally leaves the actual agent implementation up to you.
|
|
70
|
-
Replace the target specified in the entry point with your concrete class to wire
|
|
71
|
-
custom functionality into the Swarmauri plugin registry.
|
|
72
|
-
|
|
73
|
-
## Project Resources
|
|
74
|
-
|
|
75
|
-
- Source: <https://github.com/swarmauri/swarmauri-sdk/tree/main/pkgs/plugins/example_plugin>
|
|
76
|
-
- Documentation: <https://github.com/swarmauri/swarmauri-sdk/tree/main/pkgs/plugins/example_plugin#readme>
|
|
77
|
-
- Issues: <https://github.com/swarmauri/swarmauri-sdk/issues>
|
|
78
|
-
- Releases: <https://github.com/swarmauri/swarmauri-sdk/releases>
|
|
79
|
-
- Discussions: <https://github.com/orgs/swarmauri/discussions>
|
|
File without changes
|
{swm_example_plugin-0.6.5.dev19 → swm_example_plugin-0.6.6.dev3}/swm_example_plugin/__init__.py
RENAMED
|
File without changes
|