Skip to content

Commit ee4cee4

Browse files
committed
hotfix: resolve publish warnings about broken links in docs
1 parent 121dea5 commit ee4cee4

4 files changed

Lines changed: 35 additions & 11 deletions

File tree

CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [v1.1.1] - 2025-08-09
9+
10+
### Fixed
11+
12+
- Fixed broken links in documentation
13+
814
## [v1.1.0] - 2025-08-09
915

1016
### Added

lib/msgpack/stream_decoder.ex

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -23,10 +23,17 @@ defmodule Msgpack.StreamDecoder do
2323
alias Msgpack.Decoder
2424
alias Msgpack.Decoder.Internal
2525

26-
@typedoc "A stream that yields decoded Elixir terms."
27-
@type t :: Stream.t()
26+
@typedoc """
27+
A stream that yields decoded Elixir terms or a final error tuple.
2828
29-
@typedoc "Options passed to the decoder."
29+
The stream will produce any t:term/0 that can be decoded from the input.
30+
31+
If the input enumerable finishes while a term is only partially decoded, the
32+
last element in the stream will be {:error, :unexpected_eof}.
33+
"""
34+
@type t :: Stream.t(term() | {:error, :unexpected_eof})
35+
36+
@typedoc "Options passed to the decoder for each object."
3037
@type opts_t :: keyword()
3138

3239
@doc """
@@ -36,7 +43,7 @@ defmodule Msgpack.StreamDecoder do
3643
## Parameters
3744
3845
* `enumerable`: An `Enumerable` that yields chunks of a MessagePack binary
39-
stream (e.g., `File.stream/3` or a list of binaries).
46+
stream (e.g., `f:File.stream/3` or a list of binaries).
4047
* `opts`: A keyword list of options passed to the underlying decoder.
4148
4249
## Return Value
@@ -90,7 +97,11 @@ defmodule Msgpack.StreamDecoder do
9097
end
9198

9299
@doc false
93-
@spec transform_chunk(binary() | :eof, {binary(), opts_t()}) :: {list(), {binary(), opts_t() | nil}}
100+
@spec transform_chunk(
101+
binary() | :eof,
102+
{binary(), opts_t()}
103+
) ::
104+
{list(term() | {:error, :unexpected_eof}), {binary(), opts_t() | nil}}
94105
defp transform_chunk(:eof, {<<>>, _opts}) do
95106
{[], {<<>>, nil}}
96107
end
@@ -105,7 +116,7 @@ defmodule Msgpack.StreamDecoder do
105116
end
106117

107118
@doc false
108-
@spec do_transform(binary(), opts_t(), list()) :: {list(), binary()}
119+
@spec do_transform(binary(), opts_t(), list(term())) :: {list(term()), binary()}
109120
defp do_transform(<<>>, _opts, acc) do
110121
{Enum.reverse(acc), <<>>}
111122
end

lib/msgpack/stream_encoder.ex

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,19 @@ defmodule Msgpack.StreamEncoder do
1212
not be encoded.
1313
"""
1414

15-
@typedoc "A stream that yields encoded MessagePack objects."
15+
@typedoc """
16+
A stream that yields result tuples from an encoding operation.
17+
18+
Each element is either `{:ok, binary}` or `{:error, reason}`.
19+
"""
1620
@type t :: Stream.t(result_t())
1721

18-
@typedoc "An individual result from the encoding stream."
22+
@typedoc """
23+
The result of attempting to encode a single term.
24+
"""
1925
@type result_t :: {:ok, binary()} | {:error, any()}
2026

21-
@typedoc "Options passed to the encoder."
27+
@typedoc "Options passed to the encoder for each term."
2228
@type opts_t :: keyword()
2329

2430
@doc """
@@ -66,7 +72,7 @@ defmodule Msgpack.StreamEncoder do
6672
]
6773
```
6874
"""
69-
@spec encode(Enumerable.t(), opts_t()) :: t()
75+
@spec encode(Enumerable.t(any()), opts_t()) :: t()
7076
def encode(enumerable, opts \\ []) do
7177
Stream.map(enumerable, &Msgpack.encode(&1, opts))
7278
end

mix.exs

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
defmodule MsgpackElixir.MixProject do
22
use Mix.Project
33

4-
@version "1.1.0"
4+
@version "1.1.1"
55
@source_url "https://github.com/nrednav/msgpack_elixir"
66

77
def project do
@@ -60,6 +60,7 @@ defmodule MsgpackElixir.MixProject do
6060
extras: [
6161
"README.md",
6262
"CHANGELOG.md",
63+
"LICENSE",
6364
"guides/telemetry.md"
6465
]
6566
]

0 commit comments

Comments
 (0)