Skip to content

Commit 3e3304f

Browse files
authored
test: add missing subscribe, close, and low-priority tests for all SDKs
test: add missing subscribe, close, and low-priority tests for all SDKs
2 parents ce0865e + 7eabc39 commit 3e3304f

24 files changed

Lines changed: 1083 additions & 32 deletions

File tree

‎.github/workflows/release.yml‎

Lines changed: 29 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,7 @@ jobs:
4949
check "JavaScript" "javascript/package.json" "\"version\": \"${VERSION}\""
5050
check "Java" "java/pom.xml" "<version>${VERSION}</version>"
5151
check "C#" "csharp/RobustMQ.Mq9/RobustMQ.Mq9.csproj" "<Version>${VERSION}</Version>"
52+
check "langchain-mq9" "langchain-mq9/pyproject.toml" "version = \"${VERSION}\""
5253
echo "All build files verified: ${VERSION}"
5354
5455
- name: Create and push git tag
@@ -185,12 +186,31 @@ jobs:
185186
MAVEN_GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
186187
run: mvn --no-transfer-progress deploy -P release
187188

189+
release-langchain-mq9:
190+
needs: prepare
191+
runs-on: ubuntu-22.04
192+
steps:
193+
- uses: actions/checkout@v4
194+
with:
195+
ref: ${{ needs.prepare.outputs.tag }}
196+
- uses: actions/setup-python@v5
197+
with:
198+
python-version: "3.12"
199+
- name: Install build tools
200+
run: pip install build twine
201+
- name: Build
202+
working-directory: langchain-mq9
203+
run: python -m build
204+
- name: Publish to PyPI
205+
working-directory: langchain-mq9
206+
env:
207+
TWINE_USERNAME: __token__
208+
TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
209+
run: twine upload dist/*
210+
188211
release-csharp:
189212
needs: prepare
190-
if: false # disabled: enable when NuGet Trusted Publishing is configured
191213
runs-on: ubuntu-22.04
192-
permissions:
193-
id-token: write # required for NuGet Trusted Publishing
194214
steps:
195215
- uses: actions/checkout@v4
196216
with:
@@ -204,13 +224,15 @@ jobs:
204224
- name: Pack
205225
working-directory: csharp/RobustMQ.Mq9
206226
run: dotnet pack -c Release --no-build -o ../nupkg
207-
- name: Publish to NuGet (Trusted Publishing)
227+
- name: Publish to NuGet
208228
working-directory: csharp
209-
run: dotnet nuget push nupkg/*.nupkg --source https://api.nuget.org/v3/index.json
229+
env:
230+
NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
231+
run: dotnet nuget push nupkg/*.nupkg --api-key "$NUGET_API_KEY" --source https://api.nuget.org/v3/index.json
210232

211233
# ── Step 3: summary ─────────────────────────────────────────────────────────
212234
summary:
213-
needs: [prepare, release-python, release-rust, release-go, release-javascript, release-java, release-csharp]
235+
needs: [prepare, release-python, release-rust, release-go, release-javascript, release-java, release-csharp, release-langchain-mq9]
214236
runs-on: ubuntu-22.04
215237
if: always()
216238
steps:
@@ -228,6 +250,7 @@ jobs:
228250
| JavaScript | npm | ${{ needs.release-javascript.result }} |
229251
| Java | Maven Central | ${{ needs.release-java.result }} |
230252
| C# | NuGet | ${{ needs.release-csharp.result }} |
253+
| langchain-mq9 | PyPI | ${{ needs.release-langchain-mq9.result }} |
231254
232255
GitHub Release: https://github.com/${{ github.repository }}/releases/tag/v${VERSION}
233256
EOF

‎README.md‎

Lines changed: 26 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,12 @@ Full spec: [docs/mq9-protocol.md](docs/mq9-protocol.md)
4141
| Rust | `robustmq` | 0.3.5 | `cargo add robustmq` |
4242
| C# | `RobustMQ` | 0.3.5 | `dotnet add package RobustMQ` |
4343

44+
### Integrations
45+
46+
| Package | Description | Install |
47+
|---------|-------------|---------|
48+
| `langchain-mq9` | LangChain tools for mq9 — give your Agents a persistent async inbox | `pip install langchain-mq9` |
49+
4450
---
4551

4652
## Quick start
@@ -149,6 +155,7 @@ await client.SendAsync(mailbox.MailId, "hello"u8.ToArray(), Priority.Normal);
149155
| Java | [docs/java.md](docs/java.md) | [demo/demo-java/](demo/demo-java/) |
150156
| C# | [docs/csharp.md](docs/csharp.md) | [demo/demo-csharp/](demo/demo-csharp/) |
151157
| Rust | [docs/rust.md](docs/rust.md) | [demo/demo-rust/](demo/demo-rust/) |
158+
| langchain-mq9 | [docs/langchain-mq9.md](docs/langchain-mq9.md) | [demo/demo-langchain-mq9/](demo/demo-langchain-mq9/) |
152159

153160
---
154161

@@ -179,28 +186,33 @@ cd demo/demo-rust && cargo run
179186

180187
# C#
181188
cd demo/demo-csharp && dotnet run
189+
190+
# langchain-mq9
191+
cd demo/demo-langchain-mq9 && pip install -r requirements.txt && python demo.py
182192
```
183193

184194
---
185195

186196
## Repository layout
187197

188198
```
189-
python/ # Python SDK
190-
go/ # Go SDK
191-
javascript/ # JavaScript/TypeScript SDK
192-
java/ # Java SDK
193-
csharp/ # C# SDK
194-
rust/ # Rust SDK
195-
docs/ # SDK docs + protocol spec
199+
python/ # Python SDK
200+
go/ # Go SDK
201+
javascript/ # JavaScript/TypeScript SDK
202+
java/ # Java SDK
203+
csharp/ # C# SDK
204+
rust/ # Rust SDK
205+
langchain-mq9/ # LangChain integration package
206+
docs/ # SDK docs + protocol spec
196207
demo/
197-
demo-python/ # Python standalone demo project
198-
demo-go/ # Go standalone demo project
199-
demo-javascript/ # JavaScript standalone demo project
200-
demo-java/ # Java standalone demo project (Maven)
201-
demo-rust/ # Rust standalone demo project
202-
demo-csharp/ # C# standalone demo project
203-
VERSION # Canonical version (currently 0.3.5)
208+
demo-python/ # Python standalone demo
209+
demo-go/ # Go standalone demo
210+
demo-javascript/ # JavaScript standalone demo
211+
demo-java/ # Java standalone demo (Maven)
212+
demo-rust/ # Rust standalone demo
213+
demo-csharp/ # C# standalone demo
214+
demo-langchain-mq9/ # langchain-mq9 demo
215+
VERSION # Canonical version (currently 0.3.5)
204216
```
205217

206218
---

‎csharp/RobustMQ.Mq9.Tests/MQ9ClientTests.cs‎

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,93 @@ await mock.Received(1).PublishAsync(
117117
Arg.Any<byte[]>());
118118
}
119119

120+
[Fact]
121+
public async Task Send_LowPriority_CorrectSubject()
122+
{
123+
var mock = Substitute.For<INatsConnection>();
124+
var client = ClientWithMock(mock);
125+
126+
await client.SendAsync("m-001", "bg"u8.ToArray(), Priority.Low);
127+
128+
await mock.Received(1).PublishAsync(
129+
"$mq9.AI.MAILBOX.MSG.m-001.low",
130+
Arg.Any<byte[]>());
131+
}
132+
133+
// ── subscribe ─────────────────────────────────────────────────────────────
134+
135+
[Fact]
136+
public async Task Subscribe_AllPriorities_UsesWildcardSubject()
137+
{
138+
var mock = Substitute.For<INatsConnection>();
139+
var capturedSubject = "";
140+
mock.SubscribeCoreAsync<byte[]>(Arg.Any<string>(), cancellationToken: Arg.Any<CancellationToken>())
141+
.Returns(callInfo =>
142+
{
143+
capturedSubject = callInfo.ArgAt<string>(0);
144+
return ValueTask.FromResult(Substitute.For<INatsSub<byte[]>>());
145+
});
146+
var client = ClientWithMock(mock);
147+
148+
await using var _ = await client.SubscribeAsync("m-001", async _ => await Task.CompletedTask);
149+
150+
Assert.Equal("$mq9.AI.MAILBOX.MSG.m-001.*", capturedSubject);
151+
}
152+
153+
[Fact]
154+
public async Task Subscribe_SinglePriority_UsesSpecificSubject()
155+
{
156+
var mock = Substitute.For<INatsConnection>();
157+
var capturedSubject = "";
158+
mock.SubscribeCoreAsync<byte[]>(Arg.Any<string>(), cancellationToken: Arg.Any<CancellationToken>())
159+
.Returns(callInfo =>
160+
{
161+
capturedSubject = callInfo.ArgAt<string>(0);
162+
return ValueTask.FromResult(Substitute.For<INatsSub<byte[]>>());
163+
});
164+
var client = ClientWithMock(mock);
165+
166+
await using var _ = await client.SubscribeAsync("m-001", async _ => await Task.CompletedTask,
167+
priority: Priority.High);
168+
169+
Assert.Equal("$mq9.AI.MAILBOX.MSG.m-001.high", capturedSubject);
170+
}
171+
172+
[Fact]
173+
public async Task Subscribe_QueueGroup_ForwardsGroup()
174+
{
175+
var mock = Substitute.For<INatsConnection>();
176+
var capturedQueue = "";
177+
mock.SubscribeCoreAsync<byte[]>(Arg.Any<string>(), queueGroup: Arg.Any<string>(),
178+
cancellationToken: Arg.Any<CancellationToken>())
179+
.Returns(callInfo =>
180+
{
181+
capturedQueue = callInfo.ArgAt<string>(1);
182+
return ValueTask.FromResult(Substitute.For<INatsSub<byte[]>>());
183+
});
184+
var client = ClientWithMock(mock);
185+
186+
await using var _ = await client.SubscribeAsync("m-001", async _ => await Task.CompletedTask,
187+
queueGroup: "workers");
188+
189+
Assert.Equal("workers", capturedQueue);
190+
}
191+
192+
// ── close ─────────────────────────────────────────────────────────────────
193+
194+
[Fact]
195+
public async Task DisposeAsync_ClearsConnection()
196+
{
197+
var mock = Substitute.For<INatsConnection>();
198+
var client = ClientWithMock(mock);
199+
200+
await client.DisposeAsync();
201+
202+
// After dispose, any operation should throw not-connected
203+
await Assert.ThrowsAsync<InvalidOperationException>(
204+
() => client.ListAsync("m-001"));
205+
}
206+
120207
// ── list ──────────────────────────────────────────────────────────────────
121208

122209
[Fact]

‎csharp/RobustMQ.Mq9/MQ9Client.cs‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,7 @@ public async ValueTask DisposeAsync()
5151
{
5252
if (_nc is NatsConnection nc)
5353
await nc.DisposeAsync();
54+
_nc = null;
5455
}
5556

5657
// ── Create ────────────────────────────────────────────────────────────────

‎csharp/RobustMQ.Mq9/RobustMQ.Mq9.csproj‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,22 @@
1010
<Version>0.3.5</Version>
1111
<Description>RobustMQ SDK — unified messaging for AI, IoT, and data pipelines</Description>
1212
<PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
13+
<PackageProjectUrl>https://github.com/robustmq/robustmq-sdk</PackageProjectUrl>
14+
<RepositoryUrl>https://github.com/robustmq/robustmq-sdk</RepositoryUrl>
15+
<RepositoryType>git</RepositoryType>
16+
<Authors>RobustMQ</Authors>
17+
<PackageTags>messaging;mq9;nats;ai;iot</PackageTags>
18+
<PackageReadmeFile>README.md</PackageReadmeFile>
1319
</PropertyGroup>
1420

1521
<ItemGroup>
1622
<PackageReference Include="NATS.Net" Version="2.*" />
1723
</ItemGroup>
1824

25+
<ItemGroup>
26+
<None Include="../../README.md" Pack="true" PackagePath="\" />
27+
</ItemGroup>
28+
1929
<ItemGroup>
2030
<AssemblyAttribute Include="System.Runtime.CompilerServices.InternalsVisibleTo">
2131
<_Parameter1>RobustMQ.Mq9.Tests</_Parameter1>

‎demo/demo-csharp/Program.cs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
using System.Text;
1010
using RobustMQ.Mq9;
1111

12-
// demo.robustmq.com 是公共的 RobustMQ 服务,可用于验证功能和测试,也可修改为自己的服务地址。
12+
// demo.robustmq.com is a public RobustMQ service for testing. Replace with your own server address if needed.
1313
await using var client = new MQ9Client("nats://demo.robustmq.com:4222");
1414
await client.ConnectAsync();
1515
Console.WriteLine("[csharp] connected");

‎demo/demo-go/main.go‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ import (
1515
)
1616

1717
func main() {
18-
// demo.robustmq.com 是公共的 RobustMQ 服务,可用于验证功能和测试,也可修改为自己的服务地址。
18+
// demo.robustmq.com is a public RobustMQ service for testing. Replace with your own server address if needed.
1919
c := mq9.NewMQ9Client("nats://demo.robustmq.com:4222")
2020
if err := c.Connect(); err != nil {
2121
fmt.Fprintln(os.Stderr, err)

‎demo/demo-java/src/main/java/com/robustmq/demo/Demo.java‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
*/
1818
public class Demo {
1919
public static void main(String[] args) throws Exception {
20-
// demo.robustmq.com 是公共的 RobustMQ 服务,可用于验证功能和测试,也可修改为自己的服务地址。
20+
// demo.robustmq.com is a public RobustMQ service for testing. Replace with your own server address if needed.
2121
MQ9Client client = new MQ9Client("nats://demo.robustmq.com:4222");
2222
client.connect();
2323
System.out.println("[java] connected");

‎demo/demo-javascript/demo.js‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
const { MQ9Client } = require("@robustmq/sdk/mq9");
1111

1212
async function main() {
13-
// demo.robustmq.com 是公共的 RobustMQ 服务,可用于验证功能和测试,也可修改为自己的服务地址。
13+
// demo.robustmq.com is a public RobustMQ service for testing. Replace with your own server address if needed.
1414
const client = new MQ9Client({ server: "nats://demo.robustmq.com:4222" });
1515
await client.connect();
1616
console.log("[js] connected");

‎demo/demo-langchain-mq9/demo.py‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
"""
2+
langchain-mq9 demo — two Agents communicating asynchronously via mq9 mailboxes.
3+
4+
This demo does NOT require an LLM API key. It calls the tools directly to show
5+
the full mq9 communication flow:
6+
7+
Agent A → creates a mailbox → gets a mail_id
8+
Agent B → sends 3 messages to Agent A's mailbox
9+
Agent A → retrieves messages from its inbox
10+
11+
Run:
12+
cd demo/demo-langchain-mq9
13+
pip install -r requirements.txt
14+
python demo.py
15+
"""
16+
17+
import asyncio
18+
19+
from langchain_mq9 import CreateMailboxTool, GetMessagesTool, SendMessageTool
20+
21+
# demo.robustmq.com is a public RobustMQ service for testing. Replace with your own server address if needed.
22+
SERVER = "nats://demo.robustmq.com:4222"
23+
24+
25+
async def main() -> None:
26+
create = CreateMailboxTool(server=SERVER)
27+
send = SendMessageTool(server=SERVER)
28+
get = GetMessagesTool(server=SERVER)
29+
30+
# ── Agent A: create a mailbox ────────────────────────────────────────────
31+
mail_id = await create._arun(ttl=60)
32+
print(f"[agent-a] created mailbox: {mail_id}")
33+
34+
# ── Agent B: send messages to Agent A ────────────────────────────────────
35+
result = await send._arun(mail_id=mail_id, content="Urgent: server is down!", priority="high")
36+
print(f"[agent-b] {result}")
37+
38+
result = await send._arun(mail_id=mail_id, content="Daily report is ready.", priority="normal")
39+
print(f"[agent-b] {result}")
40+
41+
result = await send._arun(mail_id=mail_id, content="Background sync complete.", priority="low")
42+
print(f"[agent-b] {result}")
43+
44+
# ── Agent A: read inbox ──────────────────────────────────────────────────
45+
result = await get._arun(mail_id=mail_id, limit=10)
46+
print(f"\n[agent-a] inbox:\n{result}")
47+
48+
49+
if __name__ == "__main__":
50+
asyncio.run(main())

0 commit comments

Comments
 (0)