aboutsummaryrefslogtreecommitdiffstats
path: root/doc/src/guide/upcoming_2.0_changes.asciidoc
blob: f60bde68c12c4f247a7ae916b0931e1032c89a07 (plain) (blame)
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
== Upcoming changes in Ranch 2.0

The following changes will be done in Ranch 2.0. In most
cases an alternative is already available in the most
recent Ranch version.

* The function `ranch:start_listener/6` has been deprecated
  in favor of `ranch:start_listener/5`. The number of acceptors
  was removed and will be taken from the transport options.

* The function `ranch:child_spec/6` has also been deprecated,
  in favor of `ranch:child_spec/5`.

* The function `ranch:accept_ack/1` has been deprecated in
  favor of `ranch:handshake/1,2`.

* The function `ranch:info/1,2` will return a map containing
  each listener's information rather than a list of key/values.
  The `num_acceptors` key will be removed.

* The socket will no longer be passed to the protocol when
  starting it. It will be available as a return value from
  `ranch:handshake/1,2` only.

* Starting from Ranch 2.0 it will no longer be allowed to
  pass Ranch options along with socket options as a proplist.
  The only forms allowed will be the `ranch:opts()` map or socket
  options as-is. The `ranch:opts()` map must be used in case socket
  options also use a map.

* The `socket` option will be removed. A more viable solution
  is to define a custom transport module that returns a fresh
  socket when `Transport:listen/1` is called.