Skip to content

feat: PROTO.SETFIELD and PROTO.DELFIELD for field-level mutations #88

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kacy merged 2 commits into from
Feb 11, 2026
Merged

feat: PROTO.SETFIELD and PROTO.DELFIELD for field-level mutations #88

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
60c0bb3
feat: PROTO.SETFIELD and PROTO.DELFIELD for field-level mutations
kacy Feb 10, 2026
5c7c860
fix: harden proto field ops and document protobuf commands
kacy Feb 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 27 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ a low-latency, memory-efficient, distributed cache written in Rust. designed to
- **key commands** — DEL, EXISTS, EXPIRE, TTL, PEXPIRE, PTTL, PERSIST, TYPE, SCAN, KEYS, RENAME
- **server commands** — PING, ECHO, INFO, DBSIZE, FLUSHDB, BGSAVE, BGREWRITEAOF, AUTH, QUIT
- **pub/sub** — SUBSCRIBE, UNSUBSCRIBE, PSUBSCRIBE, PUNSUBSCRIBE, PUBLISH, plus PUBSUB introspection
- **protobuf storage** — schema-validated protobuf values with field-level access (compile with `--features protobuf`)
- **authentication** — `--requirepass` for redis-compatible AUTH (legacy and username/password forms)
- **tls support** — redis-compatible TLS on a separate port, with optional mTLS for client certificates
- **protected mode** — rejects non-loopback connections when no password is set on public binds
Expand Down Expand Up @@ -118,6 +119,31 @@ DBSIZE # => (integer) 6
ember-cli -p 6380 --tls --tls-insecure PING
```

## protobuf storage

ember can store schema-validated protobuf messages and access individual fields server-side. compile with `--features protobuf` to enable.

```bash
# build with protobuf support
cargo build --release --features protobuf
```

**commands**:

| command | description |
|---------|-------------|
| `PROTO.REGISTER name <descriptor>` | register a compiled FileDescriptorSet |
| `PROTO.SET key type_name <data> [EX s] [PX ms] [NX\|XX]` | store a validated protobuf value |
| `PROTO.GET key` | retrieve the full encoded message |
| `PROTO.TYPE key` | return the message type name |
| `PROTO.SCHEMAS` | list all registered schema names |
| `PROTO.DESCRIBE name` | list message types in a schema |
| `PROTO.GETFIELD key field_path` | read a single field (dot-separated nested paths) |
| `PROTO.SETFIELD key field_path value` | update a single scalar field |
| `PROTO.DELFIELD key field_path` | clear a field to its default value |

field-level operations decode/mutate/re-encode on the server, so clients don't need protobuf libraries for simple reads and writes. nested paths use dot notation (e.g., `address.city`). complex types (repeated, map, nested messages) require `PROTO.GET`/`PROTO.SET` for full replacement.

## configuration

| flag | default | description |
Expand Down Expand Up @@ -241,7 +267,7 @@ contributions welcome — see [CONTRIBUTING.md](CONTRIBUTING.md).
| 4 | clustering (raft, gossip, slots, migration) | ✅ complete |
| 5 | developer experience (observability, CLI, clients) | 🚧 in progress |

**current**: 85 commands, 906 tests, ~18k lines of code (excluding tests)
**current**: 94 commands, 967 tests, ~18k lines of code (excluding tests)

## security

Expand Down
Loading
Loading