saran 0.0.1

data/Gemfile

@@ -0,0 +1,6 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in villan.gemspec
+gemspec
+
+gem 'open_auth2', :git => 'https://github.com/sent-hil/open_auth2.git'

data/Rakefile

@@ -0,0 +1,113 @@
+require 'date'
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  line = File.read("lib/#{name}/version.rb")[/^\s*VERSION\s*=\s*.*/]
+  line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+end
+
+def date
+  Date.today.to_s
+end
+
+def rubyforge_project
+  name
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
+end
+
+# Standard tasks
+
+task :default => :spec
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rspec_opts = ['--backtrace']
+end
+
+desc "Generate SimpleCov test coverage and open in your browser"
+task :coverage do
+  sh "rake spec COVERAGE=true"
+  sh "open coverage/index.html"
+end
+
+desc "Open an irb session preloaded with this library"
+task :irb do
+  sh "irb -rubygems -r ./lib/#{name}.rb"
+end
+
+desc "Open a pry session preloaded with this library"
+task :pry do
+  sh "pry -r ./lib/#{name}.rb"
+end
+
+# Custom tasks (add your own tasks here)
+
+desc "Open a pry session preloaded with this Facebook example"
+task :facebook do
+  sh "pry -r ./examples/facebook.rb"
+end
+
+# Packaging tasks
+
+desc "Create tag v#{version} and build and push #{gem_file} to Rubygems"
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
+  end
+  sh "git commit --allow-empty -a -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push origin v#{version}"
+  sh "gem push pkg/#{name}-#{version}.gem"
+end
+
+desc "Build #{gem_file} into the pkg directory"
+task :build => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+desc "Generate #{gemspec_file}"
+task :gemspec do
+  # read spec file and split out manifest section
+  spec = File.read(gemspec_file)
+  head, manifest, tail = spec.split("  # = MANIFEST =\n")
+
+  # replace name version and date
+  replace_header(head, :name)
+  replace_header(head, :version)
+  replace_header(head, :date)
+  #comment this out if your rubyforge_project has a different name
+  replace_header(head, :rubyforge_project)
+
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject { |file| file =~ /^\./ }.
+    reject { |file| file =~ /^(rdoc|pkg)/ }.
+    map { |file| "    #{file}" }.
+    join("\n")
+
+  # piece file back together and write
+  manifest = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
+  File.open(gemspec_file, 'w') { |io| io.write(spec) }
+  puts "Updated #{gemspec_file}"
+end

data/Spec.md

@@ -0,0 +1,121 @@
+# Saran
+
+DSL for wrapping RESTful apis.
+
+## Config
+
+Accepted variables: `endpoint`, `access_token`, `provider` (for OpenAuth2).
+
+```
+class GoogleCalendar
+  include Wrappable
+
+  endpoint 'https://www.googleapis.com/calendar/v3'
+  provdier :google
+end
+
+# getters
+fb.endpoint #=> 'https://graph.facebook.com'
+
+# setters
+fb.endpoint('something else')
+```
+
+### Resources:
+
+```
+class GoogleCalendar
+  include Wrappable
+
+  endpoint 'https://www.googleapis.com/calendar/v3'
+  provdier :google
+
+  resources :calendars
+end
+
+GoogleCalendar::Calendars
+GoogleCalendar::Calendar
+```
+
+#### Collection:
+
+```
+class GoogleCalendar
+  include Wrappable
+
+  endpoint 'https://www.googleapis.com/calendar/v3'
+  provdier :google
+
+  resources :calendars do
+    collection do
+      get  '/calendars' # fails, expects collection of cals
+      post '/calendars'
+    end
+  end
+end
+
+cls = GoogleCalendar::Calendars.new
+cls.post(:params => '')
+cls.get
+```
+
+#### Member:
+
+```
+class GoogleCalendar
+  include Wrappable
+
+  endpoint 'https://www.googleapis.com/calendar/v3'
+  provdier :google
+
+  resources :calendars do
+    member do
+      get    '/:id'
+      delete '/:id'
+      put    '/:id'
+    end
+  end
+end
+
+cal = GoogleCalendar::Calendar.new(1).get
+cal.delete
+cal.put(:param => '')
+```
+
+#### Nested Resources:
+
+```
+class GoogleCalendar
+  include Wrappable
+
+  endpoint 'https://www.googleapis.com/calendar/v3'
+  provdier :google
+
+  resources :calendars do
+    member do
+      resources :acls do
+        collection do
+          post '/acl'
+          get  '/acl'
+        end
+
+        member do
+          get    '/:id'
+          delete '/:id'
+          put    '/:id'
+        end
+      end
+    end
+  end
+end
+
+cal  = GoogleCalendar::Calendar.new(cal_id)
+
+# returns [acl, acl, acl]
+acls = cal.acls
+acl  = acls.first
+
+# acl needs to have `id` param for following to work
+acl.get
+acl.delete
+```

data/examples/facebook.rb

@@ -0,0 +1,53 @@
+require_relative '../lib/saran'
+
+class Facebook
+  include Wrappable
+
+  endpoint 'https://graph.facebook.com'
+  provider :facebook
+
+  resources :users do
+    member do
+      get '/:id' do
+        get  '/albums'
+        get  '/apprequests'
+        post '/apprequests'
+        get '/events', :resource => :events
+      end
+    end
+  end
+
+  resources :events do
+    member do
+      get    '/:id'
+      delete '/:id'
+    end
+  end
+
+  resources :pages do
+    member do
+      get '/:id' do
+        get '/events'
+      end
+    end
+  end
+end
+
+# /me
+user  = Facebook::User.new(user_id).get
+user.albums.get
+user.apprequests.get
+user.apprequests.post
+
+user.events
+event = user.events.first
+event.post
+event.delete
+
+page = Facebook::Page.new(page_id).get
+event = page.events.first
+event.post
+event.delete
+
+event = Facebook::Event.new(event_id).get
+event.delete

data/examples/google_cal.rb

@@ -0,0 +1,78 @@
+require_relative '../lib/saran'
+
+class GoogleCalendar
+  include Wrappable
+
+  endpoint 'https://www.googleapis.com/calendar/v3'
+  provdier :google
+
+  resources :calendar_lists do
+    collection do
+      post '/users/me/calendarsList'
+      get  '/users/me/calendarsList', :resouce => :calendar
+    end
+
+    member do
+      delete '/users/me/calendarsList/:id'
+      get    '/users/me/calendarsList/:id'
+      update '/users/me/calendarsList/:id'
+      patch  '/users/me/calendarsList/:id'
+    end
+  end
+
+  resources :calendars do
+    collection do
+      post '/calendars'
+    end
+
+    member do
+      post   '/calendars/:id/clear'
+      delete '/calendars/:id'
+      get    '/calendars/:id'
+      put    '/calendars/:id'
+      patch  '/calendars/:id'
+
+      resources :events do
+        member do
+          delete '/events/:id'
+          get    '/events/:id'
+          post   '/events/import'
+          post   '/events'
+          get    '/events/:id/instances'
+          get    '/events'
+          post   '/events/:id/move'
+          post   '/events/quickAdd'
+          put    '/events/:id'
+          patch  '/events/:id'
+        end
+      end
+
+      resources :acls do
+        collection do
+          post '/acl'
+          get  '/acl'
+        end
+
+        member do
+          delete '/acl/:id'
+          get    '/acl/:id'
+          put    '/acl/:id'
+          patch  '/acl/:id'
+        end
+      end
+    end
+  end
+
+  get  '/color'
+  post '/freeBusy'
+
+  resource :settings do
+    collection do
+      get '/users/me/settings'
+    end
+
+    member do
+      get '/users/me/settings/:id'
+    end
+  end
+end

data/lib/saran/version.rb

@@ -0,0 +1,3 @@
+module Saran
+  VERSION = '0.0.1'
+end

data/saran.gemspec

@@ -0,0 +1,45 @@
+# -*- encoding: utf-8 -*-
+require './lib/saran/version'
+
+Gem::Specification.new do |s|
+  s.name              = "saran"
+  s.version           = Saran::VERSION
+  s.authors           = ["sent-hil"]
+  s.email             = ["me@sent-hil.com"]
+  s.homepage          = "https://github.com/sent-hil/wrappable"
+  s.description       = %q{Dsl for wrapping RESTful apis.}
+  s.summary           = %q{Dsl for wrapping RESTful apis.}
+
+  s.rubyforge_project = "saran"
+
+  s.files             = `git ls-files`.split("\n")
+  s.test_files        = `git ls-files -- spec/*`.split("\n")
+  s.executables       = `git ls-files -- bin/*`.split("\n").map do |f|
+    File.basename(f)
+  end
+
+  s.require_paths     = ["lib"]
+
+  s.add_dependency 'rake', '~> 0.9.5'
+
+  s.add_development_dependency 'rspec', '~> 2.12'
+  s.add_development_dependency 'vcr', '~> 2.3.0'
+  s.add_development_dependency 'webmock', '1.8.9'
+  s.add_development_dependency 'pry', '~> 0.9.1'
+
+  # = MANIFEST =
+  s.files = %w[
+    Gemfile
+    Rakefile
+    Readme.md
+    Spec.md
+    examples/facebook.rb
+    examples/google_cal.rb
+    lib/saran.rb
+    lib/saran/version.rb
+    saran.gemspec
+    spec/saran_spec.rb
+    spec/spec_helper.rb
+  ]
+  # = MANIFEST =
+end

data/spec/saran_spec.rb

@@ -0,0 +1 @@
+require 'spec_helper'

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+require 'pry'
+require 'saran'
+require 'vcr'
+
+VCR.configure do |c|
+  c.cassette_library_dir = 'spec/vcr'
+  c.hook_into :webmock
+end
+
+def mock_access_token
+  1
+end
+
+def mock_api_endpoint
+  'http://localhost:9393'
+end

metadata

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: saran
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- sent-hil
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.8.9
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.8.9
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+description: Dsl for wrapping RESTful apis.
+email:
+- me@sent-hil.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Rakefile
+- Readme.md
+- Spec.md
+- examples/facebook.rb
+- examples/google_cal.rb
+- lib/saran.rb
+- lib/saran/version.rb
+- saran.gemspec
+- spec/saran_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/sent-hil/wrappable
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: saran
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Dsl for wrapping RESTful apis.
+test_files:
+- spec/saran_spec.rb
+- spec/spec_helper.rb
+has_rdoc: