acdp 0.2.0

Rust client library for the Agent Context Distribution Protocol (ACDP v0.1.0)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# acdp-rs — convenience targets for the Rust library and its language
# bindings. The bindings are standalone Cargo packages with their own
# [workspace] tables, so each is built and tested in its own directory.
# The root crate is single-package and untouched by these targets.

PY_DIR    := bindings/acdp-py
NODE_DIR  := bindings/acdp-node
INTEROP   := bindings/interop

.PHONY: help test sdk-py sdk-node interop sdk-all clean-bindings ci-bindings

help:
	@echo "Targets:"
	@echo "  test          - cargo test --all-features on the root crate"
	@echo "  sdk-py        - maturin develop + pytest in $(PY_DIR)"
	@echo "  sdk-node      - npm install + napi build:debug + node --test in $(NODE_DIR)"
	@echo "  sdk-all       - build both SDKs (no tests)"
	@echo "  interop       - sdk-py + sdk-node + pytest $(INTEROP)"
	@echo "  ci-bindings   - what bindings.yml runs locally"
	@echo "  clean-bindings - rm bindings/**/target node_modules and built artifacts"

test:
	cargo test --all-features

# ── Python SDK ──────────────────────────────────────────────────────────
# maturin must be installed (pip install maturin or pipx install maturin).
# `develop` installs an editable extension into the active venv.
sdk-py:
	cd $(PY_DIR) && maturin develop
	cd $(PY_DIR) && pytest tests/

# ── Node.js SDK ─────────────────────────────────────────────────────────
# `npm install` brings in @napi-rs/cli; `build:debug` is the fast path.
# Use the explicit `tests/*.mjs` glob: Node 22+ treats a bare directory
# argument to `--test` as a module path and fails with MODULE_NOT_FOUND,
# instead of recursing into the directory for test files.
sdk-node:
	cd $(NODE_DIR) && npm install
	cd $(NODE_DIR) && npm run build:debug
	cd $(NODE_DIR) && node --test tests/*.mjs

sdk-all: sdk-py-build sdk-node-build

sdk-py-build:
	cd $(PY_DIR) && maturin develop

sdk-node-build:
	cd $(NODE_DIR) && npm install && npm run build:debug

# ── Interop ─────────────────────────────────────────────────────────────
# Builds both bindings first, then runs the cross-language pytest suite.
# Runs the whole interop dir: cross-language behavioral parity
# (test_interop.py) AND the API-surface / version drift guards
# (test_parity.py). A new parity test file is picked up automatically.
interop: sdk-py-build sdk-node-build
	cd $(INTEROP) && pytest

# What the CI workflow runs locally. Useful before pushing.
ci-bindings: test sdk-py sdk-node interop

# ── Cleanup ─────────────────────────────────────────────────────────────
clean-bindings:
	rm -rf $(PY_DIR)/target $(NODE_DIR)/target $(NODE_DIR)/node_modules
	rm -f  $(NODE_DIR)/index.js $(NODE_DIR)/index.d.ts $(NODE_DIR)/acdp.*.node