Litmos-client

Litmos-client is a Ruby gem that provides a wrapper for interacting with the Litmos LMS API.

Loosely based on the Hominid gem by Brian Getting, thanks Brian!

Requirements

You will need a Litmos account. Once you have your Litmos account set up, you will need to get your API key.

Installation

(sudo) gem install litmos-client

Usage

Please refer to the Litmos API Documentation for information about what methods are available, the arguments that can be passed to each method, and the output that the API will return. Start by creating an API object:

litmos = LitmosClient::API.new('your_api_key', 'your_source_domain')

You can then query the API for users:

litmos.users
litmos.find_user_by_id(id)

LitmosClient will automatically convert the result into a ruby object and de-CamelCase the result keys:

# API returns: {"LastName" => "Ballou", "FirstName" => "Kennon", "Id" => "bS5zBrR3"}
user = litmos.find_user_by_id("bS5zBrR3")
user.id
user.first_name
user.last_name

The Litmos API supports searching and pagination for some methods, so you can pass the options :start, :limit, :sort, :dir, and :search. By default the API returns up to the first 100 records.

users = litmos.users :limit => 100, :start => 100

For methods that aren't yet implemented in the gem, you can simply use the get method:

litmos.get "teams"

Dependencies

Litmos-client depends on the Rest-client, and JSON gems (should be automatically loaded via the gemspec).

TODO

Contributing to litmos-client

Copyright © 2012-2016 Kennon Ballou. See LICENSE.txt for further details.