actr-framework-protoc-codegen

Protoc plugin for generating actr-framework code from protobuf service definitions.

Status

🚧 Placeholder - Code will be moved from cli/crates/protoc-gen-actrframework

What it generates

From a protobuf service definition:

service EchoService {
  rpc Echo (EchoRequest) returns (EchoResponse);
}

Generates:

1. Handler trait - User implements business logic
2. MessageDispatcher - Routes messages to handler methods
3. Package host entry - Loads a verified .actr package via Hyper.attach(...)
4. Message trait impl - Enables Context::call() type inference

Architecture

• Uses MessageDispatcher (not MessageRouter)
• Uses Workload::Dispatcher (not Workload::Router)
• Generates clean, idiomatic Rust code

Usage

# Install
cargo install actr-framework-protoc-codegen

# Generate code
protoc --actrframework_out=src/generated proto/*.proto

Install (macOS arm64 release asset)

Prebuilt binaries are published on Actrium/actr releases.

# Download protoc-gen-actrframework-macos-arm64.zip and its .sha256, then:
shasum -a 256 -c protoc-gen-actrframework-macos-arm64.zip.sha256
unzip protoc-gen-actrframework-macos-arm64.zip
cp protoc-gen-actrframework /usr/local/bin/

TODO

• Move code from cli/crates/protoc-gen-actrframework
• Update templates to use MessageDispatcher
• Update templates to use Workload::Dispatcher
• Add integration tests
• Add template documentation