Skip to content

Commit 1159005

Browse files
authored
Merge pull request #158 from OpenVoiceOS/release-1.3.1a1
Release 1.3.1a1
2 parents f06819d + 241fd13 commit 1159005

File tree

4 files changed

+26
-14
lines changed

4 files changed

+26
-14
lines changed

CHANGELOG.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# Changelog
22

3-
## [1.3.0a1](https://github.com/OpenVoiceOS/ovos-bus-client/tree/1.3.0a1) (2024-12-28)
3+
## [1.3.1a1](https://github.com/OpenVoiceOS/ovos-bus-client/tree/1.3.1a1) (2024-12-29)
44

5-
[Full Changelog](https://github.com/OpenVoiceOS/ovos-bus-client/compare/1.2.0...1.3.0a1)
5+
[Full Changelog](https://github.com/OpenVoiceOS/ovos-bus-client/compare/1.3.0...1.3.1a1)
66

77
**Merged pull requests:**
88

9-
- feat:hivemind-plugin-manager [\#155](https://github.com/OpenVoiceOS/ovos-bus-client/pull/155) ([JarbasAl](https://github.com/JarbasAl))
9+
- fix: missing hivemind entrypoint in setup.py [\#157](https://github.com/OpenVoiceOS/ovos-bus-client/pull/157) ([JarbasAl](https://github.com/JarbasAl))
1010

1111

1212

README.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,27 +2,37 @@
22

33
This module is a simple interface for the OVOS messagebus and can be used to connect to OVOS, send messages and react to messages sent by the OpenVoiceOS system.
44

5+
---
56

6-
## MycroftBusClient()
7+
## 📡 HiveMind Integration
8+
9+
This project includes a native [hivemind-plugin-manager](https://github.com/JarbasHiveMind/hivemind-plugin-manager) integration, providing seamless interoperability with the HiveMind ecosystem.
10+
11+
- **Agent Protocol**: Provides `hivemind-ovos-agent-plugin` allowing to connect satellites to OVOS
12+
13+
---
14+
15+
## 🐍 Python Usage
16+
17+
### MycroftBusClient()
718

819
The `MycroftBusClient()` object can be setup to connect to any host and port as well as any endpont on that host. this makes it quite versitile and will work on the main bus as well as on a gui bus. If no arguments are provided it will try to connect to a local instance of OVOS on the default endpoint and port.
920

1021
> NOTE: we kept the original pre-fork class name for compatibility reasons
1122
12-
## Message()
23+
### Message()
1324

1425
The `Message` object is a representation of the messagebus message, this will always contain a message type but can also contain data and context. Data is usually real information while the context typically contain information on where the message originated or who the intended recipient is.
1526

1627
```python
1728
Message('MESSAGE_TYPE', data={'meaning': 42}, context={'origin': 'A.Dent'})
1829
```
1930

20-
## Examples
31+
### Examples
2132

22-
Below are some a couple of simple cases for sending a message on the bus as well
23-
as reacting to messages on the bus
33+
Below are some a couple of simple cases for sending a message on the bus as well as reacting to messages on the bus
2434

25-
### Sending a message on the bus.
35+
#### Sending a message on the bus.
2636

2737
```python
2838
from ovos_bus_client import MessageBusClient, Message
@@ -35,7 +45,7 @@ print('Sending speak message...')
3545
client.emit(Message('speak', data={'utterance': 'Hello World'}))
3646
```
3747

38-
### Catching a message on the messagebus
48+
#### Catching a message on the messagebus
3949

4050
```python
4151
from ovos_bus_client import MessageBusClient, Message

ovos_bus_client/version.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# START_VERSION_BLOCK
22
VERSION_MAJOR = 1
33
VERSION_MINOR = 3
4-
VERSION_BUILD = 0
5-
VERSION_ALPHA = 0
4+
VERSION_BUILD = 1
5+
VERSION_ALPHA = 1
66
# END_VERSION_BLOCK

setup.py

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,7 @@ def required(requirements_file):
1818

1919

2020
def get_version():
21-
""" Find the version of ovos-core"""
22-
version = None
21+
""" Find the version of the package"""
2322
version_file = os.path.join(BASEDIR, 'ovos_bus_client', 'version.py')
2423
major, minor, build, alpha = (None, None, None, None)
2524
with open(version_file) as f:
@@ -45,6 +44,8 @@ def get_version():
4544
with open(os.path.join(BASEDIR, "README.md"), "r") as f:
4645
long_description = f.read()
4746

47+
PLUGIN_ENTRY_POINT = 'hivemind-ovos-agent-plugin=ovos_bus_client.hpm:OVOSProtocol'
48+
4849
setup(
4950
name='ovos-bus-client',
5051
version=get_version(),
@@ -72,6 +73,7 @@ def get_version():
7273
'Programming Language :: Python :: 3',
7374
],
7475
entry_points={
76+
'hivemind.agent.protocol': PLUGIN_ENTRY_POINT,
7577
'console_scripts': [
7678
'ovos-listen=ovos_bus_client.scripts:ovos_listen',
7779
'ovos-speak=ovos_bus_client.scripts:ovos_speak',

0 commit comments

Comments
 (0)