httpclient 0,0,0,0,0 coveralls travis-ci ruby Rubygems

'httpclient' gives something like the functionality of libwww-perl (LWP) in Ruby.

httpclient - HTTP accessing library. Gem Version

Copyright © 2000-2015 NAKAMURA, Hiroshi [email protected].

‘httpclient’ gives something like the functionality of libwww-perl (LWP) in Ruby. ‘httpclient’ formerly known as ‘http-access2’.

See HTTPClient for documentation.


  • methods like GET/HEAD/POST/* via HTTP/1.1.
  • HTTPS(SSL), Cookies, proxy, authentication(Digest, NTLM, Basic), etc.
  • asynchronous HTTP request, streaming HTTP request.
  • debug mode CLI.
  • by contrast with net/http in standard distribution;
    • Cookies support
    • MT-safe
    • streaming POST (POST with File/IO)
    • Digest auth
    • Negotiate/NTLM auth for WWW-Authenticate (requires net/ntlm module; rubyntlm gem)
    • NTLM auth for Proxy-Authenticate (requires ‘win32/sspi’ module; rubysspi gem)
    • extensible with filter interface
    • you don’t have to care HTTP/1.1 persistent connection (httpclient cares instead of you)
  • Not supported now
    • Cache
    • Rather advanced HTTP/1.1 usage such as Range, deflate, etc. (of course you can set it in header by yourself)

httpclient command

Usage: 1) httpclient get
Usage: 2) httpclient

For 1) it issues a GET request to the given URI and shows the wiredump and the parsed result. For 2) it invokes irb shell with the binding that has a HTTPClient as ‘self’. You can call HTTPClient instance methods like;

get "", :q => :ruby



This program is copyrighted free software by NAKAMURA, Hiroshi. You can redistribute it and/or modify it under the same terms of Ruby’s license; either the dual license version in 2003, or any later version.

httpclient/session.rb is based on http-access.rb in http-access/0.0.4. Some part of it is copyrighted by Maebashi-san who made and published http-access/0.0.4. http-access/0.0.4 did not include license notice but when I asked Maebashi-san he agreed that I can redistribute it under the same terms of Ruby. Many thanks to Maebashi-san.


You can install httpclient via rubygems: gem install httpclient


See HTTPClient for documentation. You can also check sample/howto.rb how to use APIs.

Bug report or Feature request

Please file a ticket at the project web site.

  1. find a similar ticket from
  2. create a new ticket by clicking ‘Create Issue’ button.
  3. you can use github features such as pull-request if you like.


See ChangeLog

Related Repositories



'httpclient' gives something like the functionality of libwww-perl (LWP) in Ruby. ...



HttpClient implementations that use platform-native HTTP clients for :rocket: ...



Mirror of Apache HttpClient ...



HTTP client ...



HttpClient Android repackage buildscript ...

Top Contributors

nahi fhars amatsuda thodg ianblenke grosser eitoball adolski chetan knu johncant jsherwood0 padi sqrrrl takano32 nabeken taryneast bdo dking alexanderko poporul AnkurGel ashb abrandoned brendandc reddshack zenchild darrenleeweber aef hakanensari


-   v3.2.8 zip tar
-   v3.2.7 zip tar
-   v3.2.6 zip tar
-   v3.2.4 zip tar
-   v3.2.3 zip tar
-   v3.2.2 zip tar
-   v3.2.1 zip tar
-   v3.2.0 zip tar
-   v3.2.0.beta6 zip tar
-   v3.2.0.beta5 zip tar
-   v3.2.0.beta4 zip tar
-   v3.2.0.beta3 zip tar
-   v3.2.0.beta2 zip tar
-   v3.2.0.beta1 zip tar
-   v3.1.1 zip tar
-   v3.1.0 zip tar
-   v3.0.2 zip tar
-   v3.0.1 zip tar
-   v3.0.0 zip tar
-   v2.8.2.4 zip tar
-   v2.8.2.3 zip tar
-   v2.8.2.2 zip tar
-   v2.8.2.1 zip tar
-   v2.8.2 zip tar
-   v2.8.1 zip tar
-   v2.8.0 zip tar
-   v2.7.2 zip tar
-   v2.7.1 zip tar
-   v2.7.0.1 zip tar
-   v2.7.0 zip tar