https://github.com/typhoeus/ethon

Very simple libcurl wrapper.
https://github.com/typhoeus/ethon

Keywords from Contributors

activerecord activejob mvc rubygems rspec rack sinatra crash-reporting nokogiri ruby-gem

Last synced: about 22 hours ago
JSON representation

Repository metadata

Very simple libcurl wrapper.

Host: GitHub
URL: https://github.com/typhoeus/ethon
Owner: typhoeus
License: mit
Created: 2012-05-24T14:26:52.000Z (almost 14 years ago)
Default Branch: master
Last Pushed: 2025-11-03T03:06:02.000Z (4 months ago)
Last Synced: 2026-02-22T12:23:44.805Z (9 days ago)
Language: Ruby
Homepage:
Size: 802 KB
Stars: 140
Watchers: 13
Forks: 141
Open Issues: 28
Releases: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Ethon

In Greek mythology, Ethon, the son of Typhoeus and Echidna, is a gigantic eagle. So much for the history.
In the modern world, Ethon is a very basic libcurl wrapper using ffi.

Installation

With bundler:

gem "ethon"

With rubygems:

gem install ethon

Usage

Making the first request is simple:

easy = Ethon::Easy.new(url: "www.example.com")
easy.perform
#=> :ok

You have access to various options, such as following redirects:

easy = Ethon::Easy.new(url: "www.example.com", followlocation: true)
easy.perform
#=> :ok

Once you're done you can inspect the response code and body:

easy = Ethon::Easy.new(url: "www.example.com", followlocation: true)
easy.perform
easy.response_code
#=> 200
easy.response_body
#=> "<!doctype html><html ..."

Http

In order to make life easier, there are some helpers for making HTTP requests:

easy = Ethon::Easy.new
easy.http_request("www.example.com", :get, { params: {a: 1} })
easy.perform
#=> :ok

easy = Ethon::Easy.new
easy.http_request("www.example.com", :post, { params: { a: 1 }, body: { b: 2 } })
easy.perform
#=> :ok

This is really handy when making requests since you don't have to care about setting
everything up correctly.

Http2

Standard http2 servers require the client to connect once and create a session (multi) and then add simple requests to the multi handler.
The perform method then takes all the requests in the multi handler and sends them to the server.

See the following example

multi = Ethon::Multi.new
easy = Ethon::Easy.new

easy.http_request("www.example.com/get", :get, { http_version: :httpv2_0 })

# Sending a request with http version 2 will send an Upgrade header to the server, which many older servers will not support
# See below for more info: https://everything.curl.dev/http/http2
# If this is a problem, send the below:
easy.http_request("www.example.com/get", :get, { http_version: :httpv2_prior_knowledge })

# To set the server to use http2 with https and http1 with http, send the following:
easy.http_request("www.example.com/get", :get, { http_version: :httpv2_tls })

multi.add(easy)
multi.perform

LICENSE

(The MIT License)

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without
limitation the rights to use, copy, modify, merge, publish, distribute,
sublicense, and/or sell copies of the Software, and to permit persons
to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

Owner metadata

Name: Typhoeus
Login: typhoeus
Email: me@hans.io
Kind: organization
Description:
Website:
Location: Berlin
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/1745513?v=4
Repositories: 4
Last ynced at: 2024-03-25T19:31:40.198Z
Profile URL: https://github.com/typhoeus

GitHub Events

Total

Pull request event: 26
Fork event: 3
Issues event: 19
Watch event: 2
Issue comment event: 34
Push event: 9
Pull request review comment event: 3
Pull request review event: 4
Create event: 1

Last Year

Pull request event: 25
Fork event: 2
Issues event: 17
Watch event: 2
Issue comment event: 33
Push event: 9
Pull request review comment event: 3
Pull request review event: 3
Create event: 1

Committers metadata

Last synced: 3 days ago

Total Commits: 597
Total Committers: 71
Avg Commits per committer: 8.408
Development Distribution Score (DDS): 0.343

Commits in past year: 23
Committers in past year: 4
Avg Commits per committer in past year: 5.75
Development Distribution Score (DDS) in past year: 0.348

Name	Email	Commits
Hans Hasselberg	me@h****o	392
Felipe Mesquita	f**a@h**m	15
Jethro Beekman	j**o@j**l	15
Tasos Laskos	t**s@g**m	13
Linmiao Xu	l**u@g**m	10
Marcello Barnaba	v**t@o**t	9
Matt Burke	s**s@g**m	9
Richie Vos	r**e@g**m	9
ojab	o**b@o**u	9
Holger Arndt	h**t@h**m	7
Kyle Oppenheim	k**o@g**m	6
Geremia Taglialatela	t**v@g**m	6
Vít Ondruch	v**h@r**m	5
Craig Little	c**l@g**m	5
Sebastian Skałacki	s**e@g**m	4
Brent York	b**k@b**m	3
Eric Hayes	e**c@d**m	3
HappyHax0r	h**r@g**m	3
Jonas Wagner	j**s@2**h	3
Oleksandr Petrov	o**v@g**m	3
Orien Madgwick	4****n	3
Pericles Theodorou	p**o@g**m	3
Theo Julienne	t**e@g**m	3
Adrien Jarthon	j**s@a**m	2
Yuki Nishijima	y**a@g**m	2
Vasily Kolesnikov	r**v@g**m	2
Travis Pew	t**p@g**m	2
Paul Schuegraf	p**l@v**a	2
Nate Greene	n**e@s**m	2
John Doe	a**r@e**m	2
and 41 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 3 days ago

Total issues: 59
Total pull requests: 78
Average time to close issues: about 3 years
Average time to close pull requests: 4 months
Total issue authors: 55
Total pull request authors: 46
Average comments per issue: 4.54
Average comments per pull request: 1.19
Merged pull request: 50
Bot issues: 0
Bot pull requests: 0

Past year issues: 5
Past year pull requests: 15
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 5 days
Past year issue authors: 5
Past year pull request authors: 3
Past year average comments per issue: 2.8
Past year average comments per pull request: 0.53
Past year merged pull request: 9
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/typhoeus/ethon

Top Issue Authors

tagliala (4)
jethrogb (2)
vjt (1)
ValentinoRusconi-EH (1)
prasanna-munnangi (1)
scivola (1)
itsrainy (1)
davidfavor (1)
ben (1)
frojasg (1)
cguess (1)
andxyz (1)
gtmax (1)
Ch4s3 (1)
arianf (1)

Top Pull Request Authors

Kjarrigan (10)
felipedmesquita (8)
voxik (5)
tagliala (4)
Zapotek (3)
yuki24 (2)
jayscruggs856 (2)
ryonkn (2)
theojulienne (2)
olleolleolle (2)
orien (2)
PericlesTheo (2)
mingulov (1)
ric2b (1)
etipton (1)

Top Issue Labels

good first issue (1)
bug (1)

Top Pull Request Labels

Package metadata

Total packages: 14
Total downloads:
- rubygems: 526,824,709 total
Total docker downloads: 1,299,419,654
Total dependent packages: 18 (may contain duplicates)
Total dependent repositories: 367,997 (may contain duplicates)
Total versions: 151
Total maintainers: 2

gem.coop: ethon

Very lightweight libcurl wrapper.

Homepage: https://github.com/typhoeus/ethon
Documentation: http://www.rubydoc.info/gems/ethon/
Licenses: MIT
Latest release: 0.18.0 (published 4 months ago)
Last Synced: 2026-03-01T00:31:23.486Z (2 days ago)
Versions: 46
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 263,356,605 Total
Docker Downloads: 649,709,827
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.059%
- Downloads: 0.098%
- Docker downloads count: 0.139%
Maintainers (2)
- felipem
- i0rek

rubygems.org: ethon

Very lightweight libcurl wrapper.

Homepage: https://github.com/typhoeus/ethon
Documentation: http://www.rubydoc.info/gems/ethon/
Licenses: MIT
Latest release: 0.18.0 (published 4 months ago)
Last Synced: 2026-03-02T10:31:39.361Z (about 23 hours ago)
Versions: 46
Dependent Packages: 17
Dependent Repositories: 367,996
Downloads: 263,468,104 Total
Docker Downloads: 649,709,827
Rankings:
- Dependent repos count: 0.054%
- Downloads: 0.103%
- Docker downloads count: 0.207%
- Dependent packages count: 1.182%
- Average: 1.419%
- Forks count: 2.221%
- Stargazers count: 4.75%
Maintainers (2)
- i0rek
- felipem

proxy.golang.org: github.com/typhoeus/ethon

Homepage:
Documentation: https://pkg.go.dev/github.com/typhoeus/ethon#section-documentation
Licenses: mit
Latest release: v0.18.0 (published 4 months ago)
Last Synced: 2026-02-28T11:03:12.120Z (3 days ago)
Versions: 47
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent packages count: 6.999%
- Average: 8.173%
- Dependent repos count: 9.346%

conda-forge.org: rb-ethon

Homepage: https://rubygems.org/gems/ethon
Licenses: MIT
Latest release: 0.12.0 (published over 6 years ago)
Last Synced: 2026-03-01T12:29:44.858Z (2 days ago)
Versions: 2
Dependent Packages: 1
Dependent Repositories: 1
Rankings:
- Forks count: 15.784%
- Dependent repos count: 24.412%
- Average: 25.005%
- Dependent packages count: 28.988%
- Stargazers count: 30.835%

ubuntu-22.04: ruby-ethon

Homepage: https://github.com/typhoeus/ethon
Licenses:
Latest release: 0.15.0-2 (published 18 days ago)
Last Synced: 2026-02-13T13:16:20.470Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

debian-10: ruby-ethon

Homepage: https://github.com/typhoeus/ethon
Documentation: https://packages.debian.org/buster/ruby-ethon
Licenses:
Latest release: 0.9.0-2 (published 20 days ago)
Last Synced: 2026-02-13T04:21:05.187Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-24.04: ruby-ethon

Homepage: https://github.com/typhoeus/ethon
Licenses:
Latest release: 0.16.0-1ubuntu1 (published 26 days ago)
Last Synced: 2026-02-05T07:42:55.873Z (26 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:

ubuntu-20.04: ruby-ethon

Homepage: https://github.com/typhoeus/ethon
Licenses:
Latest release: 0.9.0-2 (published 18 days ago)
Last Synced: 2026-02-13T07:13:06.524Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-23.04: ruby-ethon

Homepage: https://github.com/typhoeus/ethon
Licenses:
Latest release: 0.16.0-1 (published 20 days ago)
Last Synced: 2026-02-11T00:29:47.571Z (20 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-24.10: ruby-ethon

Homepage: https://github.com/typhoeus/ethon
Licenses:
Latest release: 0.16.0-2 (published 23 days ago)
Last Synced: 2026-02-08T06:35:08.056Z (23 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:

ubuntu-23.10: ruby-ethon

Homepage: https://github.com/typhoeus/ethon
Licenses:
Latest release: 0.16.0-1 (published 22 days ago)
Last Synced: 2026-02-09T20:07:15.190Z (22 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:

debian-11: ruby-ethon

Homepage: https://github.com/typhoeus/ethon
Documentation: https://packages.debian.org/bullseye/ruby-ethon
Licenses:
Latest release: 0.9.0-2 (published 20 days ago)
Last Synced: 2026-02-13T08:20:01.879Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

debian-12: ruby-ethon

Homepage: https://github.com/typhoeus/ethon
Documentation: https://packages.debian.org/bookworm/ruby-ethon
Licenses:
Latest release: 0.16.0-1 (published 18 days ago)
Last Synced: 2026-02-12T23:28:50.327Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

debian-13: ruby-ethon

Homepage: https://github.com/typhoeus/ethon
Documentation: https://packages.debian.org/trixie/ruby-ethon
Licenses:
Latest release: 0.16.0-3 (published 19 days ago)
Last Synced: 2026-02-13T13:15:07.615Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

Dependencies

Gemfile rubygems

benchmark-ips >= 0 development
curb >= 0 development
json < 2 development
json >= 0 development
mime-types ~> 1.18 development
mustermann = 0.4.0 development
mustermann = 0.3.1 development
mustermann >= 0 development
patron >= 0 development
rspec ~> 3.4 development
sinatra >= 0 development
webrick >= 0 development
rake >= 0
rake < 11

ethon.gemspec rubygems

ffi >= 1.15.0

.github/workflows/ruby.yml actions

actions/checkout v2 composite
ruby/setup-ruby v1 composite

Score: 30.712373882280453