nodester 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Martin Wawrusch
+
+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,58 @@
+
+WARNING: NOT RELEASED YET
+
+= Nodester
+
+An API wrapper for the nodester API (http://nodester.com). The initial version uses a straight approach, an ActiveResource like interface might be added if there is enough interest.
+
+== Install
+
+Include this in your gemfile
+
+gem 'nodester'
+
+== Use
+
+client = Nodester::Client.new("username","password")
+client.create_app 'myappname','server.js'
+...
+
+Note: There are a couple of methods, notably the platform_create_request and platform_status methods that
+operate against www.nodester.com and not api.nodester.com, those do not require a userid/password. Just choose dummy/dummy or something similar.
+
+All results are hashes, with strings (not symbols) as keys. 
+
+In case of an error either a ResponseError or a StandardError is raised.
+
+== Dependencies
+
+* Httparty 
+
+
+== Acknowledgments
+
+Thanks to 
+
+* Aaron Russel (https://github.com/aaronrussell) whose cloudapp api helped a lot (some spec code is taken verbatim) 
+* John Nunemaker (https://github.com/jnunemaker) for httparty and all his other contributions.
+
+
+== Trivia
+
+This gem was created to the tunes of Natalia Kills and Nicki Minaj.
+
+== Contributing to nodester
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* 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.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Martin Wawrusch, inc. See LICENSE for
+further details.
+

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+desc 'Run the specs'
+RSpec::Core::RakeTask.new do |r|
+  r.verbose = false
+end
+
+task :default => :spec

data/lib/nodester/client.rb

@@ -0,0 +1,194 @@
+require 'httparty'
+
+module Nodester
+  # An API wrapper for the nodester.com API
+  # @example Request a nodester.com coupon
+  #   client = Nodester::Client.new("","")
+  #   client.platform_coupon_request('arthur@dent.com')
+  # 
+  # @example Convert a coupon (received per email) to an account
+  #   client = Nodester::Client.new("","")
+  #   client.platform_create_user("coupon",'arthur','dent','arthur@dent.com','rsakey')
+  #
+  # @example Get the platform status
+  #   client = Nodester::Client.new("","")
+  #   res = client.platform_status()
+  #   puts "Status #{res['status']} Apps Hosted #{res['appshosted']} Apps Running #{res['appsrunning']}"
+  # 
+  # @example Create an app
+  #   client = Nodester::Client.new("arthur","dent")
+  #   client.create_app 'myappname','server.js'
+  #
+  #   
+  class Client
+    include HTTParty
+    base_uri 'http://api.nodester.com'
+
+    PLATFORM_URI = 'http://nodester.com'
+  
+    def initialize(u, p )
+      @auth = {:username => u, :password => p}
+    end
+          
+
+    # Examines a bad response and raises an approriate exception
+    #
+    # @param [HTTParty::Response] response
+    def self.bad_response(response)
+      if response.class == HTTParty::Response
+       raise ResponseError, response
+      end
+      raise StandardError, "Unkown error"
+    end
+
+    def handle_result(res)
+      res.ok? ? res : bad_response(res) 
+    end
+
+    # ------------------------------------
+    # Nodester.com platform specific functions
+    # ------------------------------------
+  
+    # Creates a coupon request against nodester.com for early access
+    # Flow is as follows: You post this and receive a coupon per email.
+    # Parameters:
+    #   email (required) : "x@y.com"
+    # Returns:
+    #   status : "success - you are now in queue to receive an invite on our next batch!"
+    def platform_coupon_request(email)
+      options={ :body => {:email => email}, :base_uri => PLATFORM_URI}
+      handle_result self.class.post('/coupon', options)
+    end
+
+    # Returns the nodester.com platform status
+    # {:status=>"up", :appshosted=>1599, :appsrunning=>988} 
+    def platform_status()
+      options = {:base_uri => PLATFORM_URI}
+      handle_result self.class.get('/status', options)
+    end
+
+    # Creates a new user from the coupon given.
+    def platform_create_user(coupon,user,password,email,rsakey)
+      options={ :body => {:coupon => coupon,:user =>user,:password=>password,:email=>email,:rsakey=>rsakey}, :base_uri => PLATFORM_URI}
+      handle_result self.class.post('/user', options)
+    end
+    
+    # ------------------------------------
+    # API specific functions
+    # ------------------------------------
+  
+    # Updates the current user.
+    def update_user(opts={})
+      options={:body => opts,:basic_auth => @auth}
+      handle_result self.class.put('/user', options)
+    end
+
+    # Deletes the current user.
+    def platform_delete_user()
+      options={:basic_auth => @auth}
+      handle_result self.class.delete('/user', options)
+    end
+  
+
+
+    # Creates a new app
+    # Parameters are:
+    #   appname (required). The name of the app.
+    #   start (required). The file to start, for example server.js.
+    # Returns:
+    #   status : "success" | "failure"
+    #   message : "some text" ==> Only if failure
+    #   port : 12345
+    #   gitrepo : 'git@nodester.com:/node/git/mwawrusch/blah.git'
+    #   start : "the value of start, for example servre.js"
+    #   running : true | false 
+    #   pid : "unknown" | some pid 
+    def create_app(appname,start)
+      options={:body => {:appname=>appname,:start=>start}, :basic_auth => @auth}
+      handle_result self.class.post('/app', options)
+    end
+
+    
+    def update_app(appname,opts = {})
+      opts.merge!({:appname => appname})
+      
+      options={:body=> opts, :basic_auth => @auth}
+      handle_result self.class.put('/app', options)
+    end
+
+    def start_stop_app(appname,running = true)
+      
+      options={:body=> {:appname => appname, :running=>start}, :basic_auth => @auth}
+      handle_result self.class.put('/app', options)
+    end
+
+
+    def delete_app(appname)
+      options={:body => {:appname => appname}, :basic_auth => @auth}
+      handle_result self.class.delete('/app', options)
+    end
+  
+    def app(appname)
+      options={:body => {},:basic_auth => @auth}
+      handle_result self.class.get("/app/#{appname}", options)
+    end
+  
+    # Get a list of all apps.
+    # Returns:
+    #   An array containing a list of apps, if any.
+    #
+    # App object format:
+    #   name : testxyz1
+    #   port : 12344
+    #   gitrepo : 'git@nodester.com:/node/git/mwawrusch/blah.git'
+    #   running : false
+    #   pid : "unknown" | some pid 
+    #   gitrepo : 'git@nodester.com:/node/git/mwawrusch/2914-2295037e88fed947a9b3b994171c5a9e.git", "running"=>false, "pid"=>"unknown"} 
+    def apps()
+      options={:basic_auth => @auth}
+      handle_result self.class.get('/apps', options)
+    end
+  
+  
+  
+    def update_env(appname,key,value)
+      options={:body => {:appname => appname,:key=>key,:value=>value},:basic_auth => @auth}
+      handle_result self.class.put('/env', options)
+    end
+
+    def delete_env(appname,key)
+      options={:body => {:appname => appname,:key=>key},:basic_auth => @auth}
+      handle_result self.class.delete('/env', options)
+    end
+  
+    def env(appname,key)
+      options={:body => {:appname => appname,:key=>key},:basic_auth => @auth}
+      handle_result self.class.get('/env', options)
+    end
+  
+    def update_npm(action,package)
+      options={:body => {:action => action,:package=>package},:basic_auth => @auth}
+      handle_result self.class.post('/npm', options)
+    end
+  
+  
+    def create_appdomain(appname,domain)
+      options={:body => {:appname => appname,:domain=>domain},:basic_auth => @auth}
+      handle_result self.class.post('/appdomains', options)
+    end
+  
+    def delete_appdomain(appname,domain)
+      options={:body => {:appname => appname,:domain=>domain},:basic_auth => @auth}
+      handle_result self.class.delete('/appdomains', options)
+    end
+  
+    def appdomains()
+      options={:basic_auth => @auth}
+      handle_result self.class.get('/appdomains', options)
+    end
+  
+  
+  end
+
+end
+

data/lib/nodester/version.rb

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

data/lib/nodester.rb

@@ -0,0 +1,5 @@
+require "nodester/version"
+
+module Nodester
+  require "nodester/client"
+end

data/nodester.gemspec

@@ -0,0 +1,43 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "nodester/version"
+
+
+Gem::Specification.new do |s|
+  s.name        = "nodester"
+  s.version     = Nodester::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Martin Wawrusch"]
+  s.email       = ["martin@wawrusch.com"]
+  s.homepage    = "http://github.com/scottyapp/nodester"
+  s.summary     = %q{An API wrapper for the nodester API (http://nodester.com).}
+  s.description = %q{A gem that implements the nodester.com API which allows you to cloud-host node.js applications.}
+  s.extra_rdoc_files   = ["LICENSE","README.md"]
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.rubyforge_project = "nodester"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_runtime_dependency "httparty"  
+  s.add_development_dependency "rspec", "~> 2.1"
+  s.add_development_dependency "rake", "~> 0.8"
+  s.add_development_dependency "fakeweb",">= 0"
+  s.add_development_dependency "bundler","~> 1.0.0"
+  #s.add_development_dependency "rcov", ">= 0"
+  s.post_install_message=<<eos
+**********************************************************************************
+  Thank you for using this gem.
+  
+  Follow @martin_sunset on Twitter for announcements, updates and news
+  https://twitter.com/martin_sunset
+
+  To get the source go to http://github.com/scottyapp/nodester
+
+**********************************************************************************    
+eos
+  
+  
+end

data/spec/client_spec.rb

@@ -0,0 +1,131 @@
+require 'spec_helper'
+require 'nodester'
+
+describe Nodester::Client do
+  before(:each) do
+    fake_it_all
+    @client = Nodester::Client.new("arthur","dent")
+  end
+  
+
+  context "when invoking platform_coupon_request" do
+    it "should be a success" do
+      res = @client.platform_coupon_request "arthur@dent.com"
+      res['status'].start_with?('success').should == true
+    end
+  end
+  
+  context "when invoking platform_status" do
+    it "should return a status" do
+      res = @client.platform_status
+      res['status'].should == "up"
+      res['appshosted'].should == 1599
+      res['appsrunning'].should == 988
+    end
+  end
+
+  # Need testing:
+  #platform_create_user
+  #update_user
+  #platform_delete_user
+
+  context "when invoking create_app" do
+    it "should create an app" do
+      res = @client.create_app "testapp","server.js"
+      res['status'].should == "success"
+      res['port'].should > 0
+      res['gitrepo'].start_with?('git@nodester.com:/node/git/').should == true
+      res['start'].should == 'server.js'
+      res['running'].should == false
+      res['pid'].should == 'unknown'
+      
+    end
+  end
+
+=begin
+  context "when invoking update_app" do
+    it "should update an app" do
+      res = @client.update_app
+    end
+  end
+
+  context "when invoking start_stop_app" do
+    it "should start an app" do
+      res = @client.start_stop_app('testapp',true)
+    end
+  end
+  
+  context "when invoking delete_app" do
+    it "should delete an app" do
+      res = @client.delete_app
+    end
+  end
+=end
+
+  context "when invoking app" do
+    it "should return app info" do
+      res = @client.app 'a1234'
+      res['status'].should == "success"
+      res['port'].should > 0
+      res['gitrepo'].start_with?('git@nodester.com:/node/git/').should == true
+      res['start'].should == 'server.js'
+      res['running'].should == false
+      res['pid'].should == 'unknown'
+      
+    end
+  end
+
+  context "when invoking apps" do
+    it "should return a list of apps" do
+      res = @client.apps
+      res.length.should == 2
+      res[0]['name'].should == 'a1234'
+    end
+  end
+
+=begin
+  context "when invoking update_env" do
+    it "should set an env value" do
+      res = @client.update_env
+    end
+  end
+  
+  context "when invoking delete_env" do
+    it "should remove an env value" do
+      res = @client.delete_env
+    end
+  end
+
+  context "when invoking env" do
+    it "should return an env value" do
+      res = @client.env
+    end
+  end
+
+  context "when invoking update_npm" do
+    it "should perform an op against the npm" do
+      res = @client.update_npm
+    end
+  end
+
+
+  context "when invoking create_appdomain" do
+    it "should create an app domain" do
+      res = @client.create_appdomain
+    end
+  end
+
+  context "when invoking delete_appdomain" do
+    it "should delete an app domain" do
+      res = @client.delete_appdomain
+    end
+  end
+
+  context "when invoking appdomains" do
+    it "should list all available appdomains" do
+      res = @client.update_npm
+    end
+  end
+=end
+
+end

data/spec/fakeweb_helper.rb

@@ -0,0 +1,37 @@
+require 'fakeweb'
+
+FakeWeb.allow_net_connect = false
+
+def stub_file(stub)
+  File.join(File.dirname(__FILE__), 'stubs', stub)
+end
+
+def fake_it_all
+  FakeWeb.clean_registry
+  #FakeWeb.register_uri :head, %r{http://(api.)|(www.)?nodester.com(/items)?}, :status => ["200", "OK"]
+ 
+  {
+    # GET URLs
+    :get => {
+      'http://nodester.com/status' => 'platform_get_status',
+      'http://arthur:dent@api.nodester.com/apps' => 'get_apps',
+      %r|http://arthur:dent@api.nodester.com/app/[a-zA-Z0-0]+| => 'get_app'
+    },
+    # POST URLs
+    :post => {
+      'http://nodester.com/coupon' => 'platform_post_coupon',
+      'http://arthur:dent@api.nodester.com/app' => 'post_app'      
+    },
+    # PUT URLs
+    :put => {
+    },
+    # DELETE URLs
+    :delete => {
+    }
+  }.each do |method, requests|
+    requests.each do |url, response|
+      FakeWeb.register_uri(method, url, :response => stub_file(response))
+    end
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+require 'rubygems'
+require 'bundler/setup'
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'rspec'
+require 'nodester'
+require 'httparty'
+require 'fakeweb_helper.rb'
+
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.color_enabled = true
+end
+
+
+

data/spec/stubs/get_app

@@ -0,0 +1,5 @@
+HTTP/1.1 200 OK
+Status: 200
+Content-Type: application/json; charset=utf-8
+
+{"status":"success","port":11092,"gitrepo":"git@nodester.com:/node/git/mwawrusch/2939-bf58ab1dd19cc93cc4427bb920c0ff4b.git","start":"server.js","running":false,"pid":"unknown"}

data/spec/stubs/get_apps

@@ -0,0 +1,5 @@
+HTTP/1.1 200 OK
+Status: 200
+Content-Type: application/json; charset=utf-8
+
+[{"name":"a1234","port":11092,"gitrepo":"git@nodester.com:/node/git/mwawrusch/2939-bf58ab1dd19cc93cc4427bb920c0ff4b.git","running":false,"pid":"unknown"},{"name":"testxyz123","port":11067,"gitrepo":"git@nodester.com:/node/git/mwawrusch/2914-2295037e88fed947a9b3b994171c5a9e.git","running":false,"pid":"unknown"}]

data/spec/stubs/platform_get_status

@@ -0,0 +1,5 @@
+HTTP/1.1 200 OK
+Status: 200
+Content-Type: application/json; charset=utf-8
+
+{ status : 'up', appshosted : 1599, appsrunning : 988}

data/spec/stubs/platform_post_coupon

@@ -0,0 +1,5 @@
+HTTP/1.1 200 OK
+Status: 200
+Content-Type: application/json; charset=utf-8
+
+{ status : 'success - you are now in queue to receive an invite on our next batch!'}

data/spec/stubs/post_app

@@ -0,0 +1,5 @@
+HTTP/1.1 200 OK
+Status: 200
+Content-Type: application/json; charset=utf-8
+
+{"status":"success","port":11092,"gitrepo":"git@nodester.com:/node/git/mwawrusch/2939-bf58ab1dd19cc93cc4427bb920c0ff4b.git","start":"server.js","running":false,"pid":"unknown"}

metadata

@@ -0,0 +1,145 @@
+--- !ruby/object:Gem::Specification 
+name: nodester
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Martin Wawrusch
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-28 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "2.1"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.8"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :development
+  version_requirements: *id005
+description: A gem that implements the nodester.com API which allows you to cloud-host node.js applications.
+email: 
+- martin@wawrusch.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/nodester.rb
+- lib/nodester/client.rb
+- lib/nodester/version.rb
+- nodester.gemspec
+- spec/client_spec.rb
+- spec/fakeweb_helper.rb
+- spec/spec_helper.rb
+- spec/stubs/get_app
+- spec/stubs/get_apps
+- spec/stubs/platform_get_status
+- spec/stubs/platform_post_coupon
+- spec/stubs/post_app
+has_rdoc: true
+homepage: http://github.com/scottyapp/nodester
+licenses: []
+
+post_install_message: |
+  **********************************************************************************
+    Thank you for using this gem.
+    
+    Follow @martin_sunset on Twitter for announcements, updates and news
+    https://twitter.com/martin_sunset
+  
+    To get the source go to http://github.com/scottyapp/nodester
+  
+  **********************************************************************************    
+
+rdoc_options: 
+- --charset=UTF-8
+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: nodester
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: An API wrapper for the nodester API (http://nodester.com).
+test_files: 
+- spec/client_spec.rb
+- spec/fakeweb_helper.rb
+- spec/spec_helper.rb
+- spec/stubs/get_app
+- spec/stubs/get_apps
+- spec/stubs/platform_get_status
+- spec/stubs/platform_post_coupon
+- spec/stubs/post_app