singly 0.1.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in singly.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Timehop
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,63 @@
+# Singly
+
+A Ruby Gem to interact with the Singly API.
+
+Developed using straight-up bunder, as per [these instructions](https://github.com/radar/guides/blob/master/gem-development.md).
+
+## Installation
+
+This gem has not been released to rubygems yet. To install it manually:
+
+```sh
+git clone git@github.com:timehop/singly.git singly
+cd singly
+bundle install
+rake install
+```
+
+## Use in your project
+
+Add Singly to your Gemfile:
+
+```ruby
+gem "singly"
+```
+
+Then, initialize the gem. If you're using Rails, then this can be easily accomplished with an initializer file. Edit a file at `config/initializers/singly.rb` to include:
+
+```ruby
+Singly.client_id = "<client_id>"
+Singly.client_secret = "<client_secret>"
+Singly.verbose = true # Set to false to disable logging
+```
+
+## Use the gem directly
+
+You may also experiment with this gem in a headless fashion (ie: without installing the gem):
+
+```sh
+git clone git@github.com:timehop/singly.git singly
+cd singly
+bundle install
+rake console
+```
+
+This will look for an optional file at `.config/console.rb` where you can write arbitrary ruby code and have it loaded into your irb session. 
+
+For example, edit `.config/console.rb` to include:
+
+```ruby
+Singly.client_id = "<client_id>"
+Singly.client_secret = "<client_secret>"
+Singly.verbose = true # Set to false to disable logging
+```
+
+This avoids having to configure your singly credentials every time you run `rake console`.
+
+## 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. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+
+desc "Open an irb session preloaded with this library and an optional file at .config/console.rb"
+task :console do
+  singly_class = "#{File.dirname(__FILE__)}/lib/singly.rb"
+  console_script = "#{File.dirname(__FILE__)}/.config/console.rb"
+  sh "irb -r #{singly_class} -r #{console_script}"
+end

data/lib/singly/account.rb

@@ -0,0 +1,63 @@
+module Singly
+  class Account
+    attr_reader :access_token
+
+    def initialize(access_token, account=nil)
+      @access_token = access_token
+      @account = account
+    end
+
+    def account_id
+      @account ||= profiles.fetch["id"]
+    end
+
+    def profile
+      Singly::Profile.new(access_token: access_token)
+    end
+
+    def profiles(params={})
+      Singly::Profiles.new(params.merge(access_token: access_token))
+    end
+
+    def types
+      Singly::Types.new(access_token: access_token)
+    end
+
+    def services
+      Singly::Services.new(access_token: access_token)
+    end
+
+    def friends
+      Singly::Friends.new(access_token: access_token)
+    end
+
+    def id(id, params={})
+      Singly::Id.new(params.merge(access_token: access_token, id: id))
+    end
+
+    def proxy
+      Singly::Proxy.new(access_token)
+    end
+
+    # Alternative to calling #profiles.<service>.delete.
+    # Useful if you don't know the exact service at runtime.
+    def delete(service, id=nil)
+      Singly::Profiles::Service.new(access_token: access_token, service: service.to_s).delete(id)
+    end
+
+    # Shortcut to Singly.auth.merge(source: <source>, dest: <dest>)
+    # where <dest> is always this account's access_token.
+    def merge(source)
+      Singly.auth.merge(source: source, dest: access_token)
+    end
+
+    # Shortcut to Singly.auth.<service>.apply(account: <account_id>, token: <token> [, token_secret: <token_secret>])
+    # where <account_id> is always this account's account_id.
+    # If the account_id is not present, it is fetched from the api.
+    def apply(service, params)
+      is_oauth1 = !params[:token_secret].nil?
+      service = Singly::Auth::Service.new(service, is_oauth1)
+      service.apply(params.merge(account: account_id))
+    end
+  end
+end

data/lib/singly/api/auth/merge.rb

@@ -0,0 +1,8 @@
+module Singly
+  class Auth
+    class Merge
+      include Singly::Endpoint
+      endpoint :get, "/auth/merge", required: [:source, :dest]
+    end
+  end
+end

data/lib/singly/api/auth/service/oauth1_apply.rb

@@ -0,0 +1,13 @@
+module Singly
+  class Auth
+    class Service
+      class Oauth1Apply
+        include Singly::Endpoint
+        endpoint :get, "/auth/:service/apply", {
+          required: [:token, :token_secret, :client_id, :client_secret], 
+          optional: [:account]
+        }
+      end
+    end
+  end
+end

data/lib/singly/api/auth/service/oauth2_apply.rb

@@ -0,0 +1,13 @@
+module Singly
+  class Auth
+    class Service
+      class Oauth2Apply
+        include Singly::Endpoint
+        endpoint :get, "/auth/:service/apply", {
+          required: [:token, :client_id, :client_secret], 
+          optional: [:account]
+        }
+      end
+    end
+  end
+end

data/lib/singly/api/auth/service.rb

@@ -0,0 +1,23 @@
+module Singly
+  class Auth
+    class Service
+      attr_reader :service
+      attr_reader :is_oauth1
+
+      def initialize(service, is_oauth1=false)
+        @service = service
+        @is_oauth1 = is_oauth1
+      end
+
+      def apply(params={})
+        params ||= {}
+        apply_type = is_oauth1 ? Singly::Auth::Service::Oauth1Apply : Singly::Auth::Service::Oauth2Apply
+        apply_type.new(params.merge({
+          service: service.to_s,
+          client_id: Singly.client_id, 
+          client_secret: Singly.client_secret
+        }))
+      end
+    end
+  end
+end

data/lib/singly/api/auth.rb

@@ -0,0 +1,163 @@
+module Singly
+  class Auth
+
+    def merge(params)
+      params ||= {}
+      Singly::Auth::Merge.new(params)
+    end
+
+    def thirtysevensignals
+      oauth2_service("37signals")
+    end
+
+    def bodymedia
+      oauth2_service(__method__)
+    end
+
+    def dropbox
+      oauth2_service(__method__)
+    end
+
+    def dwolla
+      oauth2_service(__method__)
+    end
+
+    def facebook
+      oauth2_service(__method__)
+    end
+
+    def fitbit
+      oauth2_service(__method__)
+    end
+
+    def foursquare
+      oauth2_service(__method__)
+    end
+
+    def gcal
+      oauth2_service(__method__)
+    end
+
+    def gcontacts
+      oauth2_service(__method__)
+    end
+
+    def gdocs
+      oauth2_service(__method__)
+    end
+
+    def github
+      oauth2_service(__method__)
+    end
+
+    def gmail
+      oauth2_service(__method__)
+    end
+
+    def google
+      oauth2_service(__method__)
+    end
+
+    def gplus
+      oauth2_service(__method__)
+    end
+
+    def imgur
+      oauth2_service(__method__)
+    end
+
+    def instagram
+      oauth2_service(__method__)
+    end
+
+    def klout
+      oauth2_service(__method__)
+    end
+
+    def linkedin
+      oauth2_service(__method__)
+    end
+
+    def meetup
+      oauth2_service(__method__)
+    end
+
+    def paypal
+      oauth2_service(__method__)
+    end
+
+    def picasa
+      oauth2_service(__method__)
+    end
+
+    def rdio
+      oauth2_service(__method__)
+    end
+
+    def reddit
+      oauth2_service(__method__)
+    end
+
+    def runkeeper
+      oauth2_service(__method__)
+    end
+
+    def shutterfly
+      oauth2_service(__method__)
+    end
+
+    def soundcloud
+      oauth2_service(__method__)
+    end
+
+    def stocktwits
+      oauth2_service(__method__)
+    end
+
+    def tout
+      oauth2_service(__method__)
+    end
+
+    def withings
+      oauth2_service(__method__)
+    end
+
+    def wordpress
+      oauth2_service(__method__)
+    end
+
+    def yammer
+      oauth2_service(__method__)
+    end
+
+    def youtube
+      oauth2_service(__method__)
+    end
+
+    def zeo
+      oauth2_service(__method__)
+    end
+
+    def flickr
+      oauth1_service(__method__)
+    end
+
+    def tumblr
+      oauth1_service(__method__)
+    end
+
+    def twitter
+      oauth1_service(__method__)
+    end
+
+    private
+
+    def oauth1_service(service)
+      Singly::Auth::Service.new(service, true)
+    end
+
+    def oauth2_service(service)
+      Singly::Auth::Service.new(service)
+    end
+  end
+end

data/lib/singly/api/friends/group.rb

@@ -0,0 +1,12 @@
+module Singly
+  class Friends
+    class Group
+      include Singly::Endpoint
+
+      endpoint :get, "/friends/:group", {
+        required: [:access_token],
+        optional: [:limit, :offset, :services, :full, :sort, :toc, :q, :bio]
+      }
+    end
+  end
+end

data/lib/singly/api/friends.rb

@@ -0,0 +1,76 @@
+module Singly
+  class Friends
+    include Singly::Endpoint
+
+    endpoint :get, "/friends", required: [:access_token], optional: [:data, :verify]
+
+    def all(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def peers(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def ios(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def android(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def facebook(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def twitter(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def linkedin(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def gcontacts(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def instagram(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def foursquare(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def github(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def tumblr(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def flickr(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def yammer(params={})
+      group_endpoint(__method__, params)
+    end
+
+    def klout(params={})
+      group_endpoint(__method__, params)
+    end
+
+    private
+
+    def group_endpoint(group, params)
+      params ||= {}
+      Singly::Friends::Group.new(creds.merge(params.merge({
+        group: group.to_s
+      })))
+    end
+  end
+end

data/lib/singly/api/id.rb

@@ -0,0 +1,6 @@
+module Singly
+  class Id
+    include Singly::Endpoint
+    endpoint :get, "/id/:id", required: [:access_token], optional: [:map]
+  end
+end

data/lib/singly/api/multi.rb

@@ -0,0 +1,6 @@
+module Singly
+  class Multi
+    include Singly::Endpoint
+    endpoint :get, "/multi", required: [:urls]
+  end
+end

data/lib/singly/api/profile.rb

@@ -0,0 +1,6 @@
+module Singly
+  class Profile
+    include Singly::Endpoint
+    endpoint :get, "/profile", required: [:access_token]
+  end
+end

data/lib/singly/api/profiles/delete.rb

@@ -0,0 +1,8 @@
+module Singly
+  class Profiles
+    class Delete
+      include Singly::Endpoint
+      endpoint :delete, "/profiles", required: [:access_token]
+    end
+  end
+end

data/lib/singly/api/profiles/delete_profile.rb

@@ -0,0 +1,8 @@
+module Singly
+  class Profiles
+    class DeleteProfile
+      include Singly::Endpoint
+      endpoint :delete, "/profiles/:id@:service", required: [:access_token]
+    end
+  end
+end

data/lib/singly/api/profiles/delete_service.rb

@@ -0,0 +1,8 @@
+module Singly
+  class Profiles
+    class DeleteService
+      include Singly::Endpoint
+      endpoint :delete, "/profiles/:service", required: [:access_token]
+    end
+  end
+end

data/lib/singly/api/profiles/self.rb

@@ -0,0 +1,8 @@
+module Singly
+  class Profiles
+    class Self
+      include Singly::Endpoint
+      endpoint :get, "/profiles/self", required: [:access_token]
+    end
+  end
+end

data/lib/singly/api/profiles/self_update.rb

@@ -0,0 +1,8 @@
+module Singly
+  class Profiles
+    class SelfUpdate
+      include Singly::Endpoint
+      endpoint :post, "/profiles/self", required: [:access_token]
+    end
+  end
+end

data/lib/singly/api/profiles/service.rb

@@ -0,0 +1,18 @@
+module Singly
+  class Profiles
+    class Service
+      include Singly::Endpoint
+
+      endpoint :get, "/profiles/:service", required: [:access_token], optional: [:auth]
+
+      def delete(id=nil)
+        service = route_params[:service]
+        if id
+          Singly::Profiles::DeleteProfile.new(creds.merge({service: service, id: id.to_s}))
+        else
+          Singly::Profiles::DeleteService.new(creds.merge({service: service}))
+        end
+      end
+    end
+  end
+end