add app.

Author: zachpendleton

.bundle/config

@@ -0,0 +1,3 @@
+---
+BUNDLE_PATH: vendor
+BUNDLE_DISABLE_SHARED_GEMS: '1'

.gitignore

@@ -1,18 +1,2 @@
-*.gem
-*.rbc
-.bundle
-.config
-coverage
-InstalledFiles
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-
-# YARD artifacts
-.yardoc
-_yardoc
-doc/
+config/*.yml
+vendor/ruby

Gemfile

@@ -0,0 +1,10 @@
+source :rubygems
+
+gem 'faraday'
+gem 'faraday_middleware'
+gem 'multi_json'
+gem 'sinatra'
+
+group :development do
+  gem 'pry'
+end

Gemfile.lock

@@ -0,0 +1,34 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    coderay (1.0.6)
+    faraday (0.8.1)
+      multipart-post (~> 1.1)
+    faraday_middleware (0.8.7)
+      faraday (>= 0.7.4, < 0.9)
+    method_source (0.7.1)
+    multi_json (1.3.6)
+    multipart-post (1.1.5)
+    pry (0.9.9.6)
+      coderay (~> 1.0.5)
+      method_source (~> 0.7.1)
+      slop (>= 2.4.4, < 3)
+    rack (1.4.1)
+    rack-protection (1.2.0)
+      rack
+    sinatra (1.3.2)
+      rack (~> 1.3, >= 1.3.6)
+      rack-protection (~> 1.2)
+      tilt (~> 1.3, >= 1.3.3)
+    slop (2.4.4)
+    tilt (1.3.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  faraday
+  faraday_middleware
+  multi_json
+  pry
+  sinatra

README.md

@@ -1,4 +1,12 @@
-instructurecon2012
-==================
+#instructurecon2012
 
-Example code using the Canvas API.
+Example code using the Canvas API.
+
+To get started:
+  * `bundle install --local --path vendor/ruby`
+  * `bundle exec rackup`
+
+The site will be running on `localhost:9292`
+
+##TODO
+  * Add examples beyond pagination.

config.ru

@@ -0,0 +1,4 @@
+require './config/environment.rb'
+require 'example'
+
+run Example

config/canvas.yml.example

@@ -0,0 +1,3 @@
+domain: http://canvas.instructure.com
+access_token: # your canvas access token here.
+account_id: # the id of your canvas account

config/environment.rb

@@ -0,0 +1,16 @@
+$: << File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+require 'bundler'
+require 'find'
+require 'json'
+require 'yaml'
+
+Bundler.require
+
+Find.find('lib').each do |path|
+  require path if path.match(/\.rb$/)
+end
+
+config = YAML::load_file('config/canvas.yml')
+CANVAS = Canvas::Client.new(config)
+ACCOUNT_ID = config['account_id']

example.rb

@@ -0,0 +1,45 @@
+class Example < Sinatra::Base
+  get '/' do
+    erb :index
+  end
+
+  # Use some simple pagination code to pull page links from header
+  # and use then to navigate classes. Setting per_page to 1 in this
+  # example so any user with > 1 courses will see pagination links.
+  get '/pagination' do
+    page     = params[:page]     || 1
+    per_page = params[:per_page] || 2
+
+    result = CANVAS.get("accounts/#{ACCOUNT_ID}/users") do |req|
+      req.params['per_page'] = per_page
+      req.params['page'] = page
+    end
+
+    @users = result.body
+    @pages = parse_page_links(result)
+    erb :pagination
+  end
+
+  protected
+  def parse_page_links(resp)
+    link_header  = resp.headers['link'].split(',')
+
+    # Matches the name of each link: "next," "prev," "first," or "last."
+    name_regex = /rel="([a-z]+)/
+
+    # Matches the full link, e.g. "/api/v1/accounts/1/users?page=1&per_page=15"
+    link_regex = /^<([^>]+)/
+
+    # Matches only the querystring in the link, e.g. "?page=1&per_page=15"
+    params_regex = /(\?[^>]+)/
+
+    # Reduce the link header into a hash.
+    link_header.inject({}) do |links, link|
+      key = link.match(name_regex)[1].to_sym
+      val = link.match(params_regex)[1]
+      links[key] = val
+
+      links
+    end
+  end
+end

lib/canvas/client.rb

@@ -0,0 +1,34 @@
+module Canvas
+  class Client
+    attr_reader :conn
+
+    # Create a new Faraday instance for connecting to Canvas.
+    #
+    # opts - A hash of options used to init the client.
+    #        domain - The url Canvas it located at. Should be something like
+    #                 "http://canvas.local".
+    #        access_token - An access token for a user with permissions to make
+    #                       the example calls.
+    #
+    # Examples
+    #
+    # client = Canvas::Client.new(:url => 'http://canvas.local',
+    #                             :key => 'SOOxF61Qdyb...')
+    def initialize(opts = {})
+      opts = opts.inject({}) { |n, o| n[o[0].to_sym] = o[1]; n }
+
+      @conn = Faraday.new(:url => "#{opts[:domain]}/api/v1/") do |conn|
+        conn.request :oauth2, opts[:access_token]
+        conn.request :json
+        conn.response :json, :content_type => /\bjson$/
+        conn.adapter Faraday.default_adapter
+      end
+    end
+
+    # If an unknown method is called, pass it to the Faraday client.
+    def method_missing(method, *args, &block)
+      args.first.sub!(%r{^/api/v1/}, '')
+      @conn.send(method, *args, &block)
+    end
+  end
+end