motion_ocean 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a06c40dcba0ec2769bec760b0280d44e1db514e2
+  data.tar.gz: 371c8a2e7935258115e4454bf1213898cec2eebd
+SHA512:
+  metadata.gz: c12c7d2ebd6306085c47cc76f2770e0eec7ea74c8f7e8c4e3f4091122bf424d813f25a405770918ee1651462799072e7e4803bcb48188f387dd27f7df3d6a642
+  data.tar.gz: 1b19173cd4eacab7862b0778610d65a1525997ec32113d78686cc39c9ed6d0d93ee7942ef94ef4e1b259c4611879a173000ff015c429d4e842e3430460341731

data/README.md

@@ -0,0 +1,75 @@
+# MotionOcean
+
+RubyMotion library for [version 2 of DigitalOcean's API](https://developers.digitalocean.com/v2/)
+
+**Please note that version 2 of DigitalOcean's API is in beta, and is still
+being developed. Everything is subject to change.**
+
+### Installation
+
+Add this line to your application's Gemfile:
+
+``` ruby
+gem 'motion_ocean'
+```
+
+And then execute:
+``` sh
+$ bundle
+```
+
+Or install it yourself as:
+
+``` sh
+$ gem install motion_ocean
+```
+
+### Initialization
+
+``` ruby
+client = MotionOcean::Client.new(access_token: 'token')
+```
+
+*or*
+
+``` ruby
+client = MotionOcean::Client.new do |config|
+  config.access_token = 'token'
+end
+```
+
+### Usage
+
+Since MotionOcean is based on [AFMotion][afmotion], requests are being made asynchronous. Every MotionOcean method call therefore requires a block, which yields the data (or nil if the request failed).
+
+MotionOcean pretty much implements the DO API 1:1, so please check [their documentation](https://developers.digitalocean.com/v2/) for the available functions and options.
+
+### success?
+
+You can use `success?` to check if a successful HTTP status code was returned:
+
+``` ruby
+client.droplet.create(options) do |result|
+  result.success? # => true
+end
+```
+
+### response
+
+MotionOcean uses [AFMotion][afmotion]. You can use `response` to get to the response
+object:
+
+``` ruby
+client.droplet.create(options) do |result|
+  result.response # => AFMotion::HTTPResult
+end
+```
+[afmotion]: https://github.com/usepropellor/afmotion
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/motion_ocean/fork )
+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 a new Pull Request

data/lib/motion_ocean/client.rb

@@ -0,0 +1,45 @@
+module MotionOcean
+  class Client
+    attr_accessor :access_token
+
+    attr_reader :action
+    attr_reader :domain
+    attr_reader :droplet
+    attr_reader :image
+    attr_reader :key
+    attr_reader :region
+    attr_reader :size
+    
+    DEFAULT_OPTIONS = {}
+    DIGITAL_OCEAN_URL = 'https://api.digitalocean.com/v2'
+    
+    def initialize(options = DEFAULT_OPTIONS)
+      self.access_token = options.fetch(:access_token, nil)
+      yield(self) if block_given?
+      fail ArgumentError, 'missing access token' unless access_token
+      initialize_resources
+    end
+    
+    private
+    def initialize_resources
+      @action  = Resource::Action.new(api_client)
+      @domain  = Resource::Domain.new(api_client)
+      @droplet = Resource::Droplet.new(api_client)
+      @region  = Resource::Region.new(api_client)
+      @size    = Resource::Size.new(api_client)
+    end
+    
+    def api_client
+      @api_client ||= AFMotion::SessionClient.build(DIGITAL_OCEAN_URL) do |client|
+        client.session_configuration :default
+        
+        client.header 'Accept', 'application/json'
+        client.header 'Content-Type', 'application/json'
+        client.header 'Authorization', "Bearer #{access_token}"
+        
+        client.request_serializer :json
+        client.response_serializer :json
+      end
+    end
+  end
+end

data/lib/motion_ocean/resource/action.rb

@@ -0,0 +1,15 @@
+module MotionOcean
+  module Resource
+    class Action
+      include Resource::Base
+      
+      def all(&block)
+        get('actions', &block)
+      end
+      
+      def show(action_id, &block)
+        get("actions/#{action_id}", &block)
+      end
+    end
+  end
+end

data/lib/motion_ocean/resource/base.rb

@@ -0,0 +1,34 @@
+module MotionOcean
+  module Resource
+    module Base
+      attr_reader :api_client
+      
+      PER_PAGE = 200
+      
+      def initialize(api_client)
+        @api_client = api_client
+      end
+      
+      private
+      [:delete, :get, :head, :post, :put].each do |verb|
+        define_method verb do |url, options = {}, &block|
+          request(__method__, url, options, &block)
+        end
+      end
+      
+      def request(verb, url, options, &block)
+        opts = {}
+        opts = { per_page: PER_PAGE } if verb == :get
+        options = opts.merge(options)
+        
+        api_client.public_send(verb, url, options) do |response|
+          data = response.object.tap do |r|
+            r.define_singleton_method(:response) { response }
+            r.define_singleton_method(:success?) { response.success? }
+          end
+          block.call(data)
+        end
+      end
+    end
+  end
+end

data/lib/motion_ocean/resource/domain.rb

@@ -0,0 +1,43 @@
+module MotionOcean
+  module Resource
+    class Domain
+      include Resource::Base
+      
+      def create(options, &block)
+        post('domains', options, &block)
+      end
+      
+      def all(&block)
+        get('domains', &block)
+      end
+      
+      def show(domain_name, &block)
+        get("domains/#{domain_name}", &block)
+      end
+      
+      def destroy(domain_name, &block)
+        delete("domains/#{domain_name}", &block)
+      end
+      
+      def create_record(domain_name, options, &block)
+        post("domains/#{domain_name}/records", options, &block)
+      end
+      
+      def records(domain_name, &block)
+        get("domains/#{domain_name}/records", &block)
+      end
+      
+      def show_record(domain_name, record_id, &block)
+        get("domains/#{domain_name}/records/#{record_id}", &block)
+      end
+      
+      def update_record(domain_name, record_id, options, &block)
+        put("domains/#{domain_name}/records", options, &block)
+      end
+      
+      def destroy_record(domain_name, record_id, &block)
+        delete("domains/#{domain_name}/records", &block)
+      end
+    end
+  end
+end

data/lib/motion_ocean/resource/droplet.rb

@@ -0,0 +1,106 @@
+module MotionOcean
+  module Resource
+    class Droplet
+      include Resource::Base
+      
+      def create(options, &block)
+        post('droplets', options, &block)
+      end
+      
+      def all(&block)
+        get('droplets', &block)
+      end
+      
+      def show(droplet_name, &block)
+        get("droplets/#{droplet_name}", &block)
+      end
+      
+      def destroy(droplet_name, &block)
+        delete("droplets/#{droplet_name}", &block)
+      end
+      
+      def backups(droplet_id, &block)
+        get("droplets/#{droplet_id}/backups", &block)
+      end
+
+      def kernels(droplet_id, &block)
+        get("droplets/#{droplet_id}/kernels", &block)
+      end
+
+      def snapshots(droplet_id, &block)
+        get("droplets/#{droplet_id}/snapshots", &block)
+      end
+      
+      def rename(droplet_id, name, &block)
+        action(droplet_id, __method__, name: name, &block)
+      end
+
+      def reboot(droplet_id, &block)
+        action(droplet_id, __method__, &block)
+      end
+
+      def shutdown(droplet_id, &block)
+        action(droplet_id, __method__, &block)
+      end
+
+      def power_off(droplet_id, &block)
+        action(droplet_id, __method__, &block)
+      end
+
+      def power_cycle(droplet_id, &block)
+        action(droplet_id, __method__, &block)
+      end
+
+      def power_on(droplet_id, &block)
+        action(droplet_id, __method__, &block)
+      end
+
+      def resize(droplet_id, size, &block)
+        action(droplet_id, __method__, size: size, &block)
+      end
+
+      def rebuild(droplet_id, image_id, &block)
+        action(droplet_id, __method__, image: image_id, &block)
+      end
+
+      def restore(droplet_id, image_id, &block)
+        action(droplet_id, __method__, image: image_id, &block)
+      end
+
+      def password_reset(droplet_id, &block)
+        action(droplet_id, __method__, &block)
+      end
+
+      def change_kernel(droplet_id, kernel_id, &block)
+        action(droplet_id, __method__, kernel: kernel_id, &block)
+      end
+
+      def enable_ipv6(droplet_id, &block)
+        action(droplet_id, __method__, &block)
+      end
+
+      def disable_backups(droplet_id, &block)
+        action(droplet_id, __method__, &block)
+      end
+
+      def enable_private_networking(droplet_id, &block)
+        action(droplet_id, __method__, &block)
+      end
+
+      def actions(droplet_id, &block)
+        get("droplets/#{droplet_id}/actions", &block)
+      end
+
+      def show_action(droplet_id, action_id, &block)
+        get("droplets/#{droplet_id}/actions/#{action_id}", &block)
+      end
+      
+      private
+
+      def action(droplet_id, type, params = {}, &block)
+        post("droplets/#{droplet_id}/actions",
+             { type: type }.merge(params).to_json, &block)
+      end
+    end
+  end
+end

data/lib/motion_ocean/resource/image.rb

@@ -0,0 +1,38 @@
+module MotionOcean
+  module Resource
+    class Image
+      include Resource::Base
+
+      def all(&block)
+        get('images', &block)
+      end
+
+      def show(image_id, &block)
+        get("images/#{image_id}", &block)
+      end
+
+      def update(image_id, options, &block)
+        put("images/#{image_id}", options.to_json, &block)
+      end
+
+      def destroy(image_id, &block)
+        delete("images/#{image_id}", &block)
+      end
+
+      def transfer(image_id, region, &block)
+        action(image_id, __method__, region: region, &block)
+      end
+
+      def show_action(image_id, action_id, &block)
+        get("images/#{image_id}/actions/#{action_id}", &block)
+      end
+
+      private
+
+      def action(image_id, type, params = {}, &block)
+        post("images/#{image_id}/actions",
+             { type: type }.merge(params).to_json, &block)
+      end
+    end
+  end
+end

data/lib/motion_ocean/resource/key.rb

@@ -0,0 +1,27 @@
+module MotionOcean
+  module Resource
+    class Key
+      include Resource::Base
+
+      def create(options, &block)
+        post('account/keys', options.to_json)
+      end
+
+      def all(&block)
+        get('account/keys', &block)
+      end
+
+      def show(key_id, &block)
+        get("account/keys/#{key_id}", &block)
+      end
+
+      def update(key_id, options, &block)
+        put("account/keys/#{key_id}", options.to_json, &block)
+      end
+
+      def destroy(key_id, &block)
+        delete("account/keys/#{key_id}", &block)
+      end
+    end
+  end
+end

data/lib/motion_ocean/resource/region.rb

@@ -0,0 +1,11 @@
+module MotionOcean
+  module Resource
+    class Region
+      include Resource::Base
+      
+      def all(&block)
+        get('regions', &block)
+      end
+    end
+  end
+end

data/lib/motion_ocean/resource/size.rb

@@ -0,0 +1,11 @@
+module MotionOcean
+  module Resource
+    class Size
+      include Resource::Base
+      
+      def all(&block)
+        get('sizes', &block)
+      end
+    end
+  end
+end

data/lib/motion_ocean/version.rb

@@ -0,0 +1,3 @@
+module MotionOcean
+  VERSION = "0.1.0"
+end

data/lib/motion_ocean.rb

@@ -0,0 +1,25 @@
+require 'dbt'
+require 'afmotion'
+
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+Motion::Project::App.setup do |app|
+  core_lib = File.join(File.dirname(__FILE__), 'motion_ocean')
+
+  # scans app.files until it finds app/ (the default)
+  # if found, it inserts just before those files, otherwise it will insert to
+  # the end of the list
+  insert_point = app.files.find_index { |file| file =~ /^(?:\.\/)?app\// } || 0
+
+  Dir.glob(File.join(core_lib, '**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+
+  DBT.analyze(app)
+end
+
+module MotionOcean
+  # Your code goes here...
+end

data/spec/client_spec.rb

@@ -0,0 +1,27 @@
+describe "MotionOcean::Client" do
+  describe "#access_token" do
+    before do
+      @token ||= "some_token"
+    end
+  
+    it "can be set via a hash" do
+      client = MotionOcean::Client.new(access_token: @token)
+      expect(client.access_token).to eq(@token)
+    end
+    
+    it "can be set via a block" do
+      client = MotionOcean::Client.new do |c|
+        c.access_token = @token
+      end
+      
+      expect(client.access_token).to eq(@token)
+    end
+    
+    context "when none given" do
+      it "fails" do
+        expect { MotionOcean::Client.new }.to raise_error(ArgumentError, 'missing access token')
+      end
+    end
+    
+  end
+end

metadata

@@ -0,0 +1,179 @@
+--- !ruby/object:Gem::Specification
+name: motion_ocean
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Erwin Boskma
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dbt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: afmotion
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.3.0
+- !ruby/object:Gem::Dependency
+  name: webstub
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: motion-redgreen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: bacon-expect
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+description: MotionOcean, for RubyMotion, is an implementation of v2 of the Digital
+  Ocean API
+email:
+- erwin@datarift.nl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/motion_ocean.rb
+- lib/motion_ocean/client.rb
+- lib/motion_ocean/resource/action.rb
+- lib/motion_ocean/resource/base.rb
+- lib/motion_ocean/resource/domain.rb
+- lib/motion_ocean/resource/droplet.rb
+- lib/motion_ocean/resource/image.rb
+- lib/motion_ocean/resource/key.rb
+- lib/motion_ocean/resource/region.rb
+- lib/motion_ocean/resource/size.rb
+- lib/motion_ocean/version.rb
+- spec/client_spec.rb
+homepage: https://github.com/datarift/motion_ocean
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Digital Ocean API implementation for RubyMotion
+test_files:
+- spec/client_spec.rb