Ruby library for Apixu Weather API
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


This is the client library for apixu's weather api.


Add this line to your application's Gemfile:

gem 'apixu'

And then execute:

$ bundle

Or install it yourself as:

$ gem install apixu


> require 'apixu'
> client = "<APIXU KEY>"
> client.current "Paris"
{ "current" => <...>, "location" => <...> }
> client.forecast "Paris", days=3 # days is an optional parameter.
{ "current" => <...>, "forecast" => <...>, "location" => <...>}


After checking out the repo, run bin/setup to install dependencies. Then, to test, run:


You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to


The output for a successful test run would look something like this:

$ rake
  has a version number
  allows creating new clients
  stores API key
  supports API key environment variable
  does not allow overriding key
  constructs urls
  supports for querying current weather
  supports for weather forecasts

Finished in 9.09 seconds (files took 0.61258 seconds to load)
8 examples, 0 failures