mirror of
https://github.com/jnunemaker/httparty
synced 2023-03-27 23:23:07 -04:00
1.5 KiB
1.5 KiB
= httparty
Makes http fun again!
== 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
== 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.
== Command Line Interface
httparty also includes the executable httparty 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 httparty --help 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