Sha256: 005a918873df6a1fbba90445bc11b20dee1401767011a165548158f8268f5ce1

Contents?: true

Size: 1.17 KB

Versions: 14

Compression:

Stored size: 1.17 KB

Contents

# Upgrade / Migration Guide

## Version 1.1.8 to 1.2.0

### Notable Changes
This release is all about channel options. Here is the full [changelog](https://github.com/ably/ably-ruby/blob/main/CHANGELOG.md)

* Channel options were extracted into a seperate model [ChannelOptions](https://github.com/ably/ably-ruby/blob/main/lib/ably/models/channel_options.rb). However it's still backward campatible with `Hash` and you don't need to do make any adjustments to your code

* The `ChannelOptions` class now supports `:params`, `:modes` and `:cipher` as options. Previously only `:cipher` was available

* The client `:idempotent_rest_publishing` option is `true` by default. Previously `:idempotent_rest_publishing` was `false` by default.

### Breaking Changes

* Changing channel options with `Channels#get` is now deprecated in favor of explicit options change

  1. If channel state is attached or attaching an exception will be raised
  2. Otherwise the library will emit a warning

For example, the following code
```
  client.channels.get(channel_name, new_channel_options)
```

Should be changed to:
```
  channel = client.channels.get(channel_name)
  channel.options = new_channel_options
```

Version data entries

14 entries across 14 versions & 2 rubygems

Version Path
ably-rest-1.2.7 lib/submodules/ably-ruby/UPDATING.md
ably-1.2.7 UPDATING.md
ably-rest-1.2.6 lib/submodules/ably-ruby/UPDATING.md
ably-1.2.6 UPDATING.md
ably-rest-1.2.4 lib/submodules/ably-ruby/UPDATING.md
ably-1.2.4 UPDATING.md
ably-rest-1.2.3 lib/submodules/ably-ruby/UPDATING.md
ably-1.2.3 UPDATING.md
ably-rest-1.2.2 lib/submodules/ably-ruby/UPDATING.md
ably-1.2.2 UPDATING.md
ably-rest-1.2.1 lib/submodules/ably-ruby/UPDATING.md
ably-1.2.1 UPDATING.md
ably-rest-1.2.0 lib/submodules/ably-ruby/UPDATING.md
ably-1.2.0 UPDATING.md