actr-framework-protoc-codegen 0.4.0

Protoc plugin for generating actr-framework code from protobuf definitions
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

# 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:

```protobuf
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

```bash
# 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](https://github.com/Actrium/actr/releases).

```bash
# 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