# `OmniBuf.Protobuf`
[🔗](https://github.com/omnibuf/omnibuf-elixir/blob/v0.1.0/lib/omnibuf/protobuf.ex#L1)

Tier 2: Direct OmniBuf v0.1 serialization and deserialization for standard
`elixir-protobuf` (`use Protobuf`) message structs using `__message_props__/0`.

# `decode`

```elixir
@spec decode(binary(), module()) :: {:ok, struct()} | {:error, OmniBuf.Error.t()}
```

Decodes OmniBuf wire bytes into a fresh `elixir-protobuf` struct of `mod` (replace mode).

# `encode`

```elixir
@spec encode(struct(), keyword()) :: binary()
```

Encodes a standard `elixir-protobuf` struct into OmniBuf wire bytes.
Pass `self_describing: true` to prepend Field #0 `SchemaMeta`.

# `encode_iodata`

```elixir
@spec encode_iodata(struct(), module(), keyword()) :: iodata()
```

Encodes a standard `elixir-protobuf` struct into OmniBuf iodata.

# `merge`

```elixir
@spec merge(struct(), binary()) :: {:ok, struct()} | {:error, OmniBuf.Error.t()}
```

Merges OmniBuf wire bytes onto an existing `elixir-protobuf` struct (merge mode).

# `schema_meta`

```elixir
@spec schema_meta(module(), MapSet.t()) :: OmniBuf.SchemaMeta.t()
```

Builds an `OmniBuf.SchemaMeta` from an `elixir-protobuf` module's `__message_props__/0`.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
