ruroku 0.0.1

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/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Gosha Arinich
+
+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,149 @@
+# Ruroku
+
+The Ruby client for Heroku API, built on top of official `heroku.rb`
+gem.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'ruroku'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ruroku
+
+## Usage
+
+Start by initiating a connection with Heroku API:
+
+    heroku = Ruroku::API.new api_key: YOUR_HEROKU_API_KEY
+
+(You can leave out `:api_key` if `ENV['HEROKU_API_KEY']` is set
+instead.)
+
+Now you can interact with Heroku API using Ruroku.
+
+### Apps
+
+Each API object has apps associated with the Heroku account. You can
+access an Array of all the associated apps with `#apps`:
+
+    heroku.apps
+    # => [#<App>, #<App>, #<App>]
+    
+    app = heroku.apps.first
+
+You then can get additional app info:
+
+    app.id
+    app.name
+    app.stack
+    app.git_url
+    app.slug_size
+    app.repo_size
+    app.dynos
+    apps.workers
+    # and a few less interesting ones
+
+Maintenance mode can be turned on and off:
+
+    app.maintenance!
+    app.no_maintenance!
+
+### Addons
+
+To get a list of addons used by a particular app:
+
+    addons = app.addons
+    # => [#<Addon>, #<Addon>, #<Addon>]
+    
+    addon = app.addons.first
+
+It's possible perform several actions on addon collections:
+
+#### Add an addon
+
+    addons.add 'addon:plan'
+
+#### Remove an addon
+
+    addons.delete 'addon-name'
+
+#### Upgrade an addon
+
+    addons.upgrade 'addon:new-plan'
+
+Each addon object is associated with the application. You can delete
+addons from the app by calling `#delete` method on the addon object as
+well:
+
+    addon.delete!
+
+### Collaborators
+
+List all app collaborators:
+
+    collaborators = app.collaborators
+
+#### Add a collaborator
+
+    collaborators.add 'email@me.com'
+
+#### Remove a collaborator
+
+    collaborators.delete 'email@me.com'
+
+or
+
+    collaborator.delete!
+
+### Config variables
+
+List all app config vars:
+
+    app.config_vars
+
+### Domains
+
+Access domains used by the application:
+
+    app.domains
+
+### Processes
+
+Get current application processes:
+
+    app.collaborators
+
+### Releases
+
+List all app releases:
+
+    app.releases
+
+## Mock
+
+For practice or testing you can also use a simulated Heroku:
+
+    require 'ruroku'
+
+    heroku = Ruroku::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 Heroku.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+Released under the MIT license.

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/TODO.md

@@ -0,0 +1,6 @@
+* Logs
+* Stacks
+* Keys
+* User info
+* Collection finder methods
+* Specs

data/lib/ruroku/addon.rb

@@ -0,0 +1,15 @@
+module Ruroku
+  class Addon < NestedBase
+    attr_accessor :name, :description, :url, :state, :price, :beta
+    deletable :name
+
+    # Public: Check if the addon is in beta.
+    def beta?
+      !!beta
+    end
+
+    def price=(value)
+      @price = value
+    end
+  end
+end

data/lib/ruroku/addon_set.rb

@@ -0,0 +1,14 @@
+module Ruroku
+  class AddonSet < ResourceSet
+    # Map API methods to collection methods.
+    #
+    # Examples
+    #
+    #   addons.add 'addon-name'
+    #   addons.upgrade 'addon-name'
+    #   addon.delete 'addon-name'
+    map_api add: :post_addon,
+      upgrade: :put_addon,
+      delete: :delete_addon
+  end
+end

data/lib/ruroku/api.rb

@@ -0,0 +1,16 @@
+module Ruroku
+  class API
+    attr_accessor :heroku_api
+
+    def initialize(options = {})
+      self.heroku_api = Heroku::API.new options
+    end
+
+    # Public: Get apps associated with current heroku account.
+    #
+    # Returns the Array[App].
+    def apps
+      heroku_api.get_apps.body.map { |app| App.new heroku_api, app }
+    end
+  end
+end

data/lib/ruroku/app.rb

@@ -0,0 +1,54 @@
+module Ruroku
+  class App < Base
+    attr_accessor :id, :name, :create_status, :created_at, :stack, :git_url,
+      :requested_stack, :repo_migrate_status, :slug_size, :repo_size,
+      :dynos, :workers
+
+    # Public: Get addons associated with current app.
+    def addons
+      AddonSet.new self, *api.get_addons(name).body.map { |addon| Addon.new self, addon }
+    end
+
+    # Public: Get collaborators associated with current app.
+    def collaborators
+      CollaboratorSet.new self, *api.get_collaborators(name).body.map { |collaborator| Collaborator.new self, collaborator }
+    end
+
+    # Public: Get config vars associated with current app.
+    def config_vars
+      ConfigVarSet.new self, *api.get_config_vars(name).body.map { |key, value| ConfigVar.new self, key: key, value: value }
+    end
+
+    # Public: Get processes associated with current app.
+    def processes
+      ProcessSet.new self, *api.get_ps(name).body.map { |ps| Process.new self, ps }
+    end
+
+    # Public: Get releases associated with current app.
+    def releases
+      ReleaseSet.new self, *api.get_releases(name).body.map { |release| Release.new self, release }
+    end
+
+    # Public: Turn the maintenance mode on.
+    def maintenance!
+      api.post_app_maintenance name, '1'
+    end
+
+    # Public: Turn the maintenance mode off.
+    def no_maintenance!
+      api.post_app_maintenance name, '0'
+    end
+
+    def created_at=(value)
+      @created_at = Time.parse value
+    end
+
+    def slug_size=(value)
+      @slug_size = value.to_i.bytes
+    end
+
+    def repo_size=(value)
+      @repo_size = value.to_i.bytes
+    end
+  end
+end

data/lib/ruroku/base.rb

@@ -0,0 +1,14 @@
+module Ruroku
+  class Base
+    attr_accessor :api
+
+    def initialize(api, attributes = {})
+      self.api = api
+
+      attributes.each do |key, value|
+        method = "#{key}="
+        send method, value if respond_to? method
+      end
+    end
+  end
+end

data/lib/ruroku/collaborator.rb

@@ -0,0 +1,6 @@
+module Ruroku
+  class Collaborator < NestedBase
+    attr_accessor :email, :access
+    deletable :email
+  end
+end

data/lib/ruroku/collaborator_set.rb

@@ -0,0 +1,12 @@
+module Ruroku
+  class CollaboratorSet < ResourceSet
+    # Map API methods to collection methods.
+    #
+    # Examples
+    #
+    #   collaborators.add 'collaborator-email'
+    #   collaborators.delete 'collaborator-email'
+    map_api add: :post_collaborator,
+      delete: :delete_collaborator
+  end
+end

data/lib/ruroku/config_var.rb

@@ -0,0 +1,15 @@
+module Ruroku
+  class ConfigVar < NestedBase
+    attr_accessor :key, :value
+    deletable :key
+
+    def value=(new_value)
+      if @value.nil?
+        @value = new_value
+      else
+        api.put_config_vars app.name, key => new_value
+        @value = new_value
+      end
+    end
+  end
+end

data/lib/ruroku/config_var_set.rb

@@ -0,0 +1,12 @@
+module Ruroku
+  class ConfigVarSet < ResourceSet
+    # Map API methods to collection methods.
+    #
+    # Examples
+    #
+    #   config_vars.add 'KEY' => 'value'
+    #   config_vars.delete 'KEY' => 'value'
+    map_api add: :post_config_vars,
+      delete: :delete_config_var
+  end
+end

data/lib/ruroku/domain.rb

@@ -0,0 +1,14 @@
+module Ruroku
+  class Domain < NestedBase
+    attr_accessor :id, :domain, :base_domain, :default, :created_at, :updated_at
+    deletable :domain
+
+    def created_at=(value)
+      @created_at = Time.parse value
+    end
+
+    def updated_at=(value)
+      @updated_at = Time.parse value
+    end
+  end
+end

data/lib/ruroku/domain_set.rb

@@ -0,0 +1,12 @@
+module Ruroku
+  class DomainSet < ResourceSet
+    # Map API methods to collection methods.
+    #
+    # Examples
+    #
+    #   domains.add 'domain.com'
+    #   domains.delete 'domain.com'
+    map_api add: :post_domains,
+      delete: :delete_domain
+  end
+end

data/lib/ruroku/nested_base.rb

@@ -0,0 +1,21 @@
+module Ruroku
+  class NestedBase < Base
+    attr_accessor :app, :api
+
+    def initialize(app, attributes = {})
+      self.app = app
+
+      super app.api, attributes
+    end
+
+    def self.deletable(resource_id)
+      resource_name = name.demodulize.underscore
+
+      define_method :delete! do
+        api_method = "delete_#{resource_name}"
+        resource_id = send resource_id
+        api.send api_method, app.name, resource_id
+      end
+    end
+  end
+end

data/lib/ruroku/process.rb

@@ -0,0 +1,25 @@
+module Ruroku
+  class Process < NestedBase
+    attr_accessor :process, :type, :command, :upid, :slug, :action,
+      :pretty_state, :elapsed, :rendezvous_url, :attached, :transitioned_at
+
+    # Public: Restart the process.
+    def restart
+      api.post_ps_restart app.name, 'ps' => process
+    end
+
+    # Public: Stop the process.
+    def stop
+      api.post_ps_stop app.name, 'ps' => process
+    end
+
+    # Public: Check if the process is attached.
+    def attached?
+      !!attached
+    end
+
+    def transitioned_at=(value)
+      @transitioned_at = Time.parse value
+    end
+  end
+end

data/lib/ruroku/process_set.rb

@@ -0,0 +1,37 @@
+module Ruroku
+  class ProcessSet < ResourceSet
+    # Publc: Run the command.
+    #
+    # command - The String command.
+    def run(command)
+      api.post_ps app.name, command
+    end
+
+    # Public: Restart all the processes.
+    def restart
+      api.post_ps_restart app.name
+    end
+
+    # Public: Scale processes.
+    #
+    # type - The String process type.
+    # qty  - The Integer process quantity.
+    def scale(type, qty)
+      api.ps_scale app.name, type, qty
+    end
+
+    # Public: Stop the process(es).
+    #
+    # options - The Hash
+    #           either :ps   - The String process name
+    #               or :type - The String process type
+    # 
+    # Examples
+    #
+    #   processes.stop 'ps' => 'web.1'
+    #   processes.stop 'type' => 'web'
+    def stop(options)
+      api.post_ps_stop app.name, options
+    end
+  end
+end

data/lib/ruroku/release.rb

@@ -0,0 +1,10 @@
+module Ruroku
+  class Release < NestedBase
+    attr_accessor :name, :descr, :user, :commit, :env, :addons, :pstable,
+      :created_at
+
+    def created_at=(value)
+      @created_at = Time.parse value
+    end
+  end
+end

data/lib/ruroku/release_set.rb

@@ -0,0 +1,10 @@
+module Ruroku
+  class ReleaseSet < ResourceSet
+    # Map API methods to collection methods.
+    #
+    # Examples
+    #
+    #   releases.rollback 'v1'
+    map_api rollback: :post_release
+  end
+end

data/lib/ruroku/resource_set.rb

@@ -0,0 +1,20 @@
+module Ruroku
+  class ResourceSet < Array
+    attr_accessor :app, :api
+
+    def initialize(app, *args)
+      self.app = app
+      self.api = app.api
+
+      super args
+    end
+
+    def self.map_api(methods)
+      methods.each do |method_name, api_mapping|
+        define_method method_name do |resource_name|
+          api.send api_mapping, app.name, resource_name
+        end
+      end
+    end
+  end
+end

data/lib/ruroku/version.rb

@@ -0,0 +1,3 @@
+module Ruroku
+  VERSION = "0.0.1"
+end

data/lib/ruroku.rb

@@ -0,0 +1,27 @@
+require "heroku-api"
+require "time"
+require "active_support/core_ext/numeric"
+require "active_support/core_ext/string"
+
+require "ruroku/base"
+require "ruroku/nested_base"
+require "ruroku/resource_set"
+
+require "ruroku/api"
+require "ruroku/app"
+require "ruroku/addon"
+require "ruroku/addon_set"
+require "ruroku/collaborator"
+require "ruroku/collaborator_set"
+require "ruroku/config_var"
+require "ruroku/config_var_set"
+require "ruroku/domain"
+require "ruroku/domain_set"
+require "ruroku/process"
+require "ruroku/process_set"
+require "ruroku/release"
+require "ruroku/release_set"
+require "ruroku/version"
+
+module Ruroku
+end

data/ruroku.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/ruroku/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Gosha Arinich"]
+  gem.email         = ["me@goshakkk.name"]
+  gem.description   = %q{Ruby client for the Heroku API}
+  gem.summary       = %q{Ruby client for the Heroku API}
+  gem.homepage      = ""
+
+  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.name          = "ruroku"
+  gem.require_paths = ["lib"]
+  gem.version       = Ruroku::VERSION
+
+  gem.add_runtime_dependency 'heroku-api', '~> 0.2.4'
+  gem.add_runtime_dependency 'activesupport', '~> 3.2.5'
+
+  gem.add_development_dependency 'rspec'
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: ruroku
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Gosha Arinich
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: heroku-api
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.4
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.5
+- !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'
+description: Ruby client for the Heroku API
+email:
+- me@goshakkk.name
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- TODO.md
+- lib/ruroku.rb
+- lib/ruroku/addon.rb
+- lib/ruroku/addon_set.rb
+- lib/ruroku/api.rb
+- lib/ruroku/app.rb
+- lib/ruroku/base.rb
+- lib/ruroku/collaborator.rb
+- lib/ruroku/collaborator_set.rb
+- lib/ruroku/config_var.rb
+- lib/ruroku/config_var_set.rb
+- lib/ruroku/domain.rb
+- lib/ruroku/domain_set.rb
+- lib/ruroku/nested_base.rb
+- lib/ruroku/process.rb
+- lib/ruroku/process_set.rb
+- lib/ruroku/release.rb
+- lib/ruroku/release_set.rb
+- lib/ruroku/resource_set.rb
+- lib/ruroku/version.rb
+- ruroku.gemspec
+homepage: ''
+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'
+      segments:
+      - 0
+      hash: 2659213015072619677
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 2659213015072619677
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Ruby client for the Heroku API
+test_files: []