Skip to content

Commit 99052a8

Browse files
committed
[DOCS] Updates release notes, changelog
1 parent 015e747 commit 99052a8

File tree

2 files changed

+77
-1
lines changed

2 files changed

+77
-1
lines changed

CHANGELOG.md

+34
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,37 @@
1+
## 7.17.10
2+
3+
Backports support for Faraday 2 from `elastic-transport`. ¡Gracias [santiagorodriguez96](https://github.com/santiagorodriguez96)!
4+
5+
This version of the gem now supports Faraday v2. If you don't have a locked version of Faraday in your project, when you upgrade your gems, Faraday v2 will be installed. The main change on dependencies when using Faraday v2 is all adapters, except for the default `net_http` one, have been moved out of Faraday into separate gems. This means if you're not using the default adapter and you migrate to Faraday v2, you'll need to add the adapter gems to your Gemfile.
6+
7+
These are the gems required for the different adapters with Faraday 2, instead of the libraries on which they were based:
8+
```ruby
9+
# HTTPCLient
10+
gem 'faraday-httpclient'
11+
12+
# NetHTTPPersistent
13+
gem 'faraday-net_http_persistent'
14+
15+
# Patron
16+
gem 'faraday-patron'
17+
18+
# Typhoeus
19+
gem 'faraday-typhoeus'
20+
```
21+
22+
Things should work fine if you migrate to Faraday 2 as long as you include the adapter (unless you're using the default one `net-http`), but worst case scenario, you can always lock the version of Faraday in your project to 1.x:
23+
`gem 'faraday', '~> 1'`
24+
25+
Be aware if migrating to Faraday v2 that it requires at least Ruby `2.6`, unlike Faraday v1 which requires `2.4`.
26+
27+
*Troubleshooting*
28+
29+
If you see a message like:
30+
`:adapter is not registered on Faraday::Adapter (Faraday::Error)`
31+
Then you probably need to include the adapter library in your gemfile and require it.
32+
33+
Please [submit an issue](https://github.com/elastic/elasticsearch-ruby/issues) if you encounter any problems.
34+
135
## 7.17.9
236

337
- Backports fix from `elastic-transport`: [#66](https://github.com/elastic/elastic-transport-ruby/issues/66) - Manticore transport unable to send custom headers with `perform_request` [Pull Request](https://github.com/elastic/elastic-transport-ruby/pull/69).

docs/release_notes/717.asciidoc

+43-1
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,53 @@
11
[[release_notes_717]]
22
=== 7.17 Release notes
33

4+
[discrete]
5+
[[release_notes_71710]]
6+
=== 7.17.10 Release notes
7+
8+
Backports support for Faraday 2 from `elastic-transport`. ¡Gracias https://github.com/santiagorodriguez96[santiagorodriguez96]!
9+
10+
This version of the gem now supports Faraday v2. If you don't have a locked version of Faraday in your project, when you upgrade your gems, Faraday v2 will be installed. The main change on dependencies when using Faraday v2 is all adapters, except for the default `net_http` one, have been moved out of Faraday into separate gems. This means if you're not using the default adapter and you migrate to Faraday v2, you'll need to add the adapter gems to your Gemfile.
11+
12+
These are the gems required for the different adapters with Faraday 2, instead of the libraries on which they were based:
13+
14+
[source,ruby]
15+
------------------------------------
16+
# HTTPCLient
17+
gem 'faraday-httpclient'
18+
19+
# NetHTTPPersistent
20+
gem 'faraday-net_http_persistent'
21+
22+
# Patron
23+
gem 'faraday-patron'
24+
25+
# Typhoeus
26+
gem 'faraday-typhoeus'
27+
------------------------------------
28+
29+
Things should work fine if you migrate to Faraday 2 as long as you include the adapter (unless you're using the default one `net-http`), but worst case scenario, you can always lock the version of Faraday in your project to 1.x:
30+
gem 'faraday', '~> 1'
31+
32+
Be aware if migrating to Faraday v2 that it requires at least Ruby `2.6`, unlike Faraday v1 which requires `2.4`.
33+
34+
*Troubleshooting*
35+
36+
If you see a message like:
37+
38+
[source,ruby]
39+
------------------------------------
40+
:adapter is not registered on Faraday::Adapter (Faraday::Error)
41+
------------------------------------
42+
Then you probably need to include the adapter library in your gemfile and require it.
43+
44+
Please https://github.com/elastic/elasticsearch-ruby/issues[submit an issue] if you encounter any problems.
45+
446
[discrete]
547
[[release_notes_7179]]
648
=== 7.17.9 Release notes
749

8-
- Backports fix from `elastic-transport`, fixes https://github.com/elastic/elastic-transport-ruby/issues/66[#66]: Manticore transport unable to send custom headers with `perform_request` https://github.com/elastic/elastic-transport-ruby/pull/69[Pull Request].
50+
- Backports fix from `elastic-transport`, fixes https://github.com/elastic/elastic-transport-ruby/issues/66[#66]: Manticore transport unable to send custom headers with `perform_request` https://github.com/elastic/elastic-transport-ruby/pull/69[Pull Request].
951

1052
[discrete]
1153
[[release_notes_7178]]

0 commit comments

Comments
 (0)