1
0
Fork 0
mirror of https://github.com/jnunemaker/httparty synced 2023-03-27 23:23:07 -04:00
🎉 Makes http fun again!
Find a file
2012-04-12 12:59:26 -04:00
bin Merge branch 'master' of https://github.com/SixArm/httparty into SixArm-master 2012-04-12 12:57:16 -04:00
examples Added documentation via example of how to send custom user agents 2011-12-22 20:11:04 -05:00
features Ruby 1.9 instance_eval doesn't like lambdas, use a proc instead 2012-04-12 12:46:18 -04:00
lib Merge branch 'fragmented_responses' of https://github.com/fabiokr/httparty into fabiokr-fragmented_responses 2012-04-12 12:59:26 -04:00
spec Merge branch 'fragmented_responses' of https://github.com/fabiokr/httparty into fabiokr-fragmented_responses 2012-04-12 12:59:26 -04:00
website Updated website to point to github issues instead of lighthouse. 2009-08-22 10:25:14 -04:00
.gitignore Ignore Gemfile.lock. 2011-04-15 18:31:21 -04:00
cucumber.yml Cucumber features and steps for most functionality as of the 0.2.8 2009-01-29 17:12:03 +08:00
Gemfile You can now party without crack. 2011-09-13 12:29:26 -04:00
History Release 0.8. 2011-09-13 12:34:47 -04:00
httparty.gemspec You can now party without crack. 2011-09-13 12:29:26 -04:00
MIT-LICENSE Removing .txt from files (it has always annoyed me). Boo Windows! 2008-12-05 17:11:58 -05:00
Rakefile Switch to bundler for release management and use hand made gemspec. 2011-04-16 14:43:20 -04:00
README.rdoc Update readme with google gorup. 2012-04-04 11:36:36 -04:00

= httparty

Makes http fun again!

== Note on Releases

Releases are tagged on github and also released as gems on github and rubyforge. Master is pushed to whenever I add a patch or a new feature. To build from master, you can clone the code, generate the updated gemspec, build the gem and install.

* rake gemspec
* gem build httparty.gemspec
* gem install the gem that was built

== Note on Patches/Pull Requests

* Fork the project.
* Make your feature addition or bug fix.
* Add tests for it. This is important so I don't break it in a future version unintentionally.
* Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself in another branch so I can ignore when I pull)
* Send me a pull request. Bonus points for topic branches.

== Features:

* Easy get, post requests
* Basic http authentication
* Default request query string parameters (ie: for api keys that are needed on each request)
* Automatic parsing of JSON and XML into ruby hashes based on response content-type

== Examples

See http://github.com/jnunemaker/httparty/tree/master/examples

== Command Line Interface

httparty also includes the executable <tt>httparty</tt> which can be
used to query web services and examine the resulting output. By default
it will output the response as a pretty-printed Ruby object (useful for
grokking the structure of output). This can also be overridden to output
formatted XML or JSON. Execute <tt>httparty --help</tt> for all the
options. Below is an example of how easy it is.

  httparty "http://twitter.com/statuses/public_timeline.json"

== Requirements

* multijson and multixml
* You like to party!

== Install

* sudo gem install httparty

== Help and Docs

* https://groups.google.com/forum/#!forum/httparty-gem
* http://rdoc.info/projects/jnunemaker/httparty