Skip to content
This repository has been archived by the owner on Jul 14, 2020. It is now read-only.

InlineManual/inlinemanual-ruby

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

InlineManual - Ruby bindings

Warning: This gem is under heavy development! Check TODO for the overview of the current state.

Official Ruby gem for the Inline Manual API with Rails integration.

Compatibility:

Tested only with Ruby 1.9.2 and Rails 3.2.x

Features:

  • Fetch list of the site topics (tours).
  • Fetch content of the topic.

Installation

Add this line to your application's Gemfile:

gem 'inlinemanual'

And then execute:

$ bundle

Or install it yourself as:

$ gem install inlinemanual

Usage

Example usage:

require 'inlinemanual'

InlineManual.site_api_key = 'YOUR_SITE_API_KEY'

begin
  topics = InlineManual::SiteTopic::fetch_all
  topics.each do |t|
    puts InlineManual::SiteTopic::fetch(t[:id])
  end
rescue InlineManual::InlineManualError => e
  puts e.message
end

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Make sure that your changes pass the tests (bundle exec rake test)
  5. Push to the branch (git push origin my-new-feature)
  6. Create new Pull Request

For testing purposes you can also change the base path of the API and disable SSL verification if needed:

InlineManual.api_base = 'http://localhost:3000/api'
InlineManual.verify_ssl_certs = false

Credits

Developed with love by fine folks of Inline Manual

Some parts of the code (especially the API exception handling) were inspired by the Stripe Ruby bindings.

License

The MIT License

Copyright © 2013- Inline Manual (https://inlinemanual.com)

About

Ruby gem for accessing Inline Manual API.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages