centro-client 0.0.1

data/.gitignore

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

data/README.md

@@ -0,0 +1,49 @@
+Centro Ruby Client
+==================
+
+The Centro Ruby Client is used to interact with the Centro API from
+Ruby.
+
+For more about the Centro API see <http://api-docs.centro.net>.
+
+Usage
+-----
+
+Start by creating a connection to Centro with your credentials:
+
+    require 'centro-centro'
+
+    centro = Centro::API.new(:api_key => API_KEY)
+
+NOTE: You can leave out the `:api_key` if `ENV['CENTRO_API_KEY']` is set
+instead.
+
+Now you can make requests to the api.
+
+Requests
+--------
+
+What follows is an overview of commands you can run for the client.
+
+For additional details about any of the commands, see the [API
+docs](http://api-docs.centro.net).
+
+Mock
+----
+
+For practice or testing you can also use a simulated Centro:
+
+    require 'centro-api'
+
+    centro = Centro::API.new(:api_key => API_KEY, :mock => true)
+
+After that commands should still behave the same, but they will only
+modify some local data instead of updating the state of things on
+Centro.
+
+Tests
+-----
+
+To run tests, first set `ENV['CENTRO_API_KEY']` to your api key.  Then
+use `bundle exec rake` to run mock tests or `MOCK=false bundle exec
+rake` to run integration tests.

data/centro-client.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'centro/client/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "centro-client"
+  gem.version       = Centro::Client::VERSION
+  gem.authors       = ["Tim Galeckas"]
+  gem.email         = ["tim@galeckas.com"]
+  gem.description   = %q{Ruby Client for the Centro api}
+  gem.summary       = %q{Ruby Client for the Centro api}
+  gem.homepage      = "http://github.com/centro/centro.rb"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'webmock'
+  gem.add_development_dependency 'guard-rspec'
+
+  gem.add_dependency  'omniauth'
+  gem.add_dependency  'omniauth-oauth2'
+  gem.add_dependency  'faraday'
+  gem.add_dependency  'faraday_middleware'
+end

data/lib/centro-client.rb

@@ -0,0 +1 @@
+require(File.join(File.dirname(__FILE__), "centro", "client"))

data/lib/centro/client.rb

@@ -0,0 +1,132 @@
+require 'omniauth'
+require 'omniauth-oauth2'
+require 'faraday_middleware'
+
+module Centro
+  class Client
+    class << self
+      def api_version
+        return @api_version if defined?(@api_version)
+        @api_version = 'v1'
+      end
+      def auth_host
+        return @auth_host if defined?(@auth_host)
+        @auth_host = 'localhost:3001'
+      end
+      def mms_host
+        return @mms_host if defined?(@mms_host)
+        @mms_host = 'localhost:3000'
+      end
+      def ssl_enabled?
+        return @ssl_enabled if defined?(@ssl_enabled)
+        @ssl_enaabled = false
+      end
+      def auth_url
+        url_from_host(auth_host)
+      end
+      def mms_url
+        url_from_host(mms_host)
+      end
+      def url_from_host(host)
+        (ssl_enabled? ? 'https://' : 'http://') +
+          host
+      end
+    end
+
+    attr_accessor :client_id, :client_secret, :access_token
+
+    def initialize(opts={})
+      @client_id = opts.delete(:client_id) if opts[:client_id]
+      @client_secret = opts.delete(:client_secret) if opts[:client_secret]
+      @access_token = opts.delete(:access_token) if opts[:access_token]
+    end
+
+    def retrieve_access_token(username, password)
+      raise 'client_id and client_secret required' unless @client_id && @client_secret
+      connection = Faraday.new self.class.auth_url do |conn|
+        set_default_connection_options(conn)
+      end
+      response = connection.post('/oauth/token',
+                 :grant_type    => 'password',
+                 :client_id     => @client_id,
+                 :client_secret => @client_secret,
+                 :username      => username,
+                 :password      => password)
+      raise 'Failed to get an access token' unless response.success? && response.body['access_token']
+      self.access_token = response.body['access_token']
+    end
+
+
+    def get_credentials
+      auth_connection.get("/api/#{self.class.api_version}/me.json").body
+    end
+
+    def get_organizations(user_id=nil)
+      options = {}
+      options[:user_id]=user_id if user_id
+      auth_connection.get("/api/#{self.class.api_version}/organizations.json", options).body
+    end
+
+    def get_members_of_organization(organization_id)
+      auth_connection.get("/api/#{self.class.api_version}/organizations/#{organization_id}/members.json").body
+    end
+
+    ##
+    # Creates a user in an organization.  If the user already exists in AuthTransis they will
+    # simply be added to the org (assuming the resource owner has rights), if they don't exist
+    # they will be created and added to the organizations.
+    #
+    # Returns a list of the organizations that they were sucessfully added to.
+    def create_user_in_organization(email, organization_id)
+      org_ids = organization_id.respond_to?(:each) ? organization_id : [organization_id]
+      successfuls = []
+      org_ids.each do |org_id|
+        response = auth_connection.post("/api/#{self.class.api_version}/organizations/#{organization_id}/members.json", {:email_address => email})
+        response.success? && successfuls << response.body
+      end
+      successfuls
+    end
+
+    def create_user(email)
+      response = auth_connection.post("/api/#{self.class.api_version}/members.json", {:email_address => email})
+      response.success? && response.body
+    end
+
+    def create_organization(org_name)
+      response = auth_connection.post("/api/#{self.class.api_version}/organizations", {:name => org_name})
+      response.success? && response.body
+    end
+
+    private
+
+    def set_default_connection_options(conn)
+      conn.request :json
+
+      conn.response :dates
+      conn.response :mashify
+      conn.response :json, :content_type => /\bjson$/
+      conn.response :raise_error
+
+      conn.adapter Faraday.default_adapter
+    end
+
+    def auth_connection
+      raise 'access_token required' unless @access_token
+      @auth_connection ||= begin
+        Faraday.new self.class.auth_url do |conn|
+          conn.request :oauth2, @access_token
+          set_default_connection_options(conn)
+        end
+      end
+    end
+    def mms_connection
+      raise 'access_token required' unless @access_token
+      @mms_connection ||= begin
+        Faraday.new self.class.mms_url do |conn|
+          conn.request :oauth2, @access_token
+          set_default_connection_options(conn)
+        end
+      end
+    end
+  end
+end

data/lib/centro/client/version.rb

@@ -0,0 +1,5 @@
+module Centro
+  class Client
+    VERSION = "0.0.1"
+  end
+end

metadata

@@ -0,0 +1,164 @@
+--- !ruby/object:Gem::Specification
+name: centro-client
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Tim Galeckas
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: omniauth
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: omniauth-oauth2
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby Client for the Centro api
+email:
+- tim@galeckas.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- README.md
+- centro-client.gemspec
+- lib/centro-client.rb
+- lib/centro/client.rb
+- lib/centro/client/version.rb
+homepage: http://github.com/centro/centro.rb
+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: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Ruby Client for the Centro api
+test_files: []
+has_rdoc: