apigee-platform 0.0.2

data/Gemfile

@@ -0,0 +1,15 @@
+source "http://rubygems.org"
+
+gem "activeresource", "~> 3.2.12"
+gem 'json', '~> 1.7.7'
+gem 'oj', '>= 2.0.0'
+
+group :development do
+  gem "shoulda", ">= 0"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", ">= 1.0.0"
+  gem "jeweler", "~> 1.8.4"
+  gem "simplecov", ">= 0"
+  gem "rspec", "~> 2.8.0"
+  gem "webmock", "1.8.0"
+end

data/Gemfile.lock

@@ -0,0 +1,96 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activemodel (3.2.13)
+      activesupport (= 3.2.13)
+      builder (~> 3.0.0)
+    activeresource (3.2.13)
+      activemodel (= 3.2.13)
+      activesupport (= 3.2.13)
+    activesupport (3.2.13)
+      i18n (= 0.6.1)
+      multi_json (~> 1.0)
+    addressable (2.3.5)
+    builder (3.0.4)
+    crack (0.4.0)
+      safe_yaml (~> 0.9.0)
+    diff-lcs (1.1.3)
+    faraday (0.8.7)
+      multipart-post (~> 1.1)
+    git (1.2.5)
+    github_api (0.10.1)
+      addressable
+      faraday (~> 0.8.1)
+      hashie (>= 1.2)
+      multi_json (~> 1.4)
+      nokogiri (~> 1.5.2)
+      oauth2
+    hashie (2.0.5)
+    highline (1.6.19)
+    httpauth (0.2.0)
+    i18n (0.6.1)
+    jeweler (1.8.6)
+      builder
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      github_api (= 0.10.1)
+      highline (>= 1.6.15)
+      nokogiri (= 1.5.10)
+      rake
+      rdoc
+    json (1.7.7)
+    jwt (0.1.8)
+      multi_json (>= 1.5)
+    multi_json (1.7.7)
+    multi_xml (0.5.4)
+    multipart-post (1.2.0)
+    nokogiri (1.5.10)
+    oauth2 (0.9.2)
+      faraday (~> 0.8)
+      httpauth (~> 0.2)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    oj (2.1.3)
+    rack (1.5.2)
+    rake (10.1.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    safe_yaml (0.9.3)
+    shoulda (3.5.0)
+      shoulda-context (~> 1.0, >= 1.0.1)
+      shoulda-matchers (>= 1.4.1, < 3.0)
+    shoulda-context (1.1.4)
+    shoulda-matchers (2.2.0)
+      activesupport (>= 3.0.0)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    webmock (1.8.0)
+      addressable (>= 2.2.7)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activeresource (~> 3.2.12)
+  bundler (>= 1.0.0)
+  jeweler (~> 1.8.4)
+  json (~> 1.7.7)
+  oj (>= 2.0.0)
+  rdoc (~> 3.12)
+  rspec (~> 2.8.0)
+  shoulda
+  simplecov
+  webmock (= 1.8.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Vasiliy Sablin
+
+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,173 @@
+# ApigeePlatform
+
+ApigeePlatform is a ruby wrapper for Apigee Platform API (http://apigee.com/).
+
+Full API documentation - http://apigee.com/docs/api/api-resources
+
+Gem is based on ActiveResource.
+
+## Installation
+    gem install apigee-platform
+
+## Usage
+    
+### Initialization
+    require 'apigee-platform'
+    
+    ApigeePlatform::Objects::Base.configure :user => 'user@example.com', :password => 'your_password', :organization => 'your_apigee_org'
+
+### Examples
+  
+#### Developer
+
+  Retreive developers list
+
+    ApigeePlatform::Objects::Developer.all
+    # => ["liukang@example.com", "kano@example.com"]
+
+  Find developer. You could use email or ID here.
+
+    developer = ApigeePlatform::Objects::Developer.find 'johnny@example.com'
+
+  Create new developer
+
+    developer = ApigeePlatform::Objects::Developer.new :firstName => 'Johnny', :lastName => 'Cage', :userName => 'johnnycage', :email => 'johnny@example.com'
+    developer.save
+    # => true
+
+    developer.errors.full_messages
+    # => [] 
+
+  Update developer attributes
+
+    developer.firstName = 'SuperJohnny'
+    developer.save
+    # => true 
+
+  Get Apps assigned to developer
+
+    developer.apps
+    # => ['app1', 'app2']
+
+  Create new app for developer
+
+    new_app = developer.create_app
+    new_app.name = 'my_super_app'
+    new_app.save
+    # => true
+
+  Find developer app by name
+
+    app = developer.app 'my_super_app'
+
+    # or you could use DeveloperApp resource directly
+    app = ApigeePlatform::Objects::DeveloperApp.find 'my_super_app', :params => {:developer_id => DEVELOPER_ID_OR_EMAIL}
+
+  Get developer app keys. Keys were created automatically by Apigee with app.
+    
+    app.keys
+
+  Manage apiproducts of key
+
+    key = app.keys.first
+
+    # assigned apiproducts for key
+    key.apiproducts
+    # => {}
+
+    # existing apiproducts list
+    ApigeePlatform::Objects::Apiproduct.all
+    # => ['mkworld', 'midway']
+
+    key.add_product 'mytest'
+    # => 'pending'
+
+    key.apiproducts
+    # => {"mytest"=>"pending"} 
+
+    # approve product
+    key.approve_product 'mytest'
+    # => "approved" 
+
+    # revoke product
+    key.revoke_product 'mytest'
+    # => "revoked" 
+
+    # remove product 
+    key.remove_product 'mytest'
+    # => true
+
+  Delete developer app
+
+    app.destroy
+
+  Delete developer
+
+    developer.destroy
+
+
+#### Company
+
+  Comapnies API is similar to developers API.
+
+    company = ApigeePlatform::Objects::Company.create :name => 'my_new_company'
+    
+    company.apps
+    # => []
+
+    new_app = company.create_app
+    new_app.name = 'my_super_app2'
+    new_app.save
+    # => true
+
+    key = new_app.keys.first
+    
+    key.add_product 'mytest'
+    # => 'pending'
+
+    key.apiproducts
+    # => {"mytest"=>"pending"} 
+
+    # approve product
+    key.approve_product 'mytest'
+    # => "approved" 
+
+    # revoke product
+    key.revoke_product 'mytest'
+    # => "revoked" 
+
+    # remove product 
+    key.remove_product 'mytest'
+    # => true
+
+#### Custom attributes
+    
+  Some resources (developer, company, apiproduct) has custom attributes. It is accessible under custom_attributes method which behave like a Hash.
+
+    developer.custom_attributes
+    # => {}
+
+    developer.custom_attributes[:attr1] = 'val1'
+    developer.save
+
+## Contributing to apigee-platform
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+
+## Copyright
+
+Copyright (c) 2013 Vasiliy Sablin. See LICENSE.txt for
+further details.
+
+
+
+
+
+
+
+
+

data/Rakefile

@@ -0,0 +1,44 @@
+# encoding: utf-8
+$LOAD_PATH << "./lib/"
+require 'rubygems'
+require 'bundler'
+
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+require 'apigee-platform'
+Jeweler::Tasks.new do |gem|
+  gem.name = "apigee-platform"
+  gem.homepage = "http://github.com/woodoo/apigee-platform"
+  gem.summary = %Q{This is a ruby wrapper for Apigee Platform API (http://apigee.com/)}
+  gem.description = gem.summary
+  gem.email = "vasiliy.sablin@gmail.com"
+  gem.authors = ["Vasiliy Sablin"]
+  gem.version = ApigeePlatform::Version::STRING
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = ApigeePlatform::Version::STRING
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "apigee-platform #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/apigee-platform.rb

@@ -0,0 +1,5 @@
+require 'active_resource'
+require 'apigee-platform/version'
+require 'apigee-platform/associations'
+require 'apigee-platform/custom_attributes'
+require 'apigee-platform/objects/base'

data/lib/apigee-platform/associations.rb

@@ -0,0 +1,70 @@
+module ApigeePlatform
+  module Associations
+
+    def self.included(base)
+      base.extend ClassMethods
+    end
+
+    module ClassMethods
+
+      def has_many(*args)
+        klass_sym = args.first.to_sym
+        options = args.extract_options!
+        prefix = self.name
+        klass_name = prefix + klass_sym.to_s.classify
+
+        instance_eval do
+          define_method "#{klass_sym}" do |scope = :all|
+            klass = klass_name.constantize
+            prefix_params = klass.prefix_options.inject({}) do |res,pair| 
+              res[pair.first] = self.send(options[pair.first] || pair.last)
+              res 
+            end
+
+            if options[:through].present?
+              self.send(options[:through]).map do |el|
+                klass.instantiate_record(el.attributes, prefix_params)
+              end
+            else 
+              klass.find scope, :params => prefix_params
+            end
+          end
+
+          define_method "#{klass_sym.to_s.singularize}" do |id = nil|
+            if id
+              method(klass_sym).call(id)
+            else
+              method("create_#{klass_sym.to_s.singularize}").call
+            end
+          end
+
+          define_method "create_#{klass_sym.to_s.singularize}" do |params={}|
+            klass = klass_name.constantize
+            prefix_params = klass.prefix_options.inject({}){|res,pair| res[pair.last] = self.send(options[pair.first] || pair.last); res }
+            klass.new params.merge(prefix_params)
+          end
+
+        end
+
+      end
+
+      def belongs_to(*args)
+        klass_sym = args.first.to_sym
+        options = args.extract_options!
+        prefix = "#{self.parent}::"
+        klass_name = prefix + klass_sym.to_s.classify
+        klass_name = prefix + options[:class_name] if options[:class_name]
+
+        instance_eval do
+          define_method "#{klass_sym}" do
+            klass = klass_name.constantize
+            id_key = options[:key] ? options[:key] : klass.primary_key
+            klass.find self.send(id_key)
+          end
+        end
+
+      end
+    end
+
+  end
+end

data/lib/apigee-platform/custom_attributes.rb

@@ -0,0 +1,34 @@
+module ApigeePlatform
+  class CustomAttributes
+
+    def initialize(obj)
+      @object = obj
+      @object.attributes['attributes'] ||= []
+      @attributes = @object.attributes['attributes'].inject({}.with_indifferent_access){|res, a| res[a['name']] = a['value']; res}
+    end
+
+    def [](key)
+      @attributes[key.to_s]
+    end
+
+    def []=(key, value)
+      delete(key.to_s)
+      @object.attributes['attributes'] << {'name' => key.to_s, 'value' => value}
+      @attributes[key.to_s] = value
+    end
+
+    def delete(key)
+      @object.attributes['attributes'].reject!{|a| a['name'] == key.to_s}
+      @attributes.delete(key.to_s)
+    end
+
+    def method_missing(name)
+      @attributes.send(name)
+    end
+
+    def inspect
+      @attributes.inspect
+    end
+
+  end
+end