apiaryio 0.0.1 → 0.0.2

data/lib/apiary/command/help.rb

@@ -0,0 +1,34 @@
+# encoding: utf-8
+module Apiary
+  module Command
+    # Display help
+    class Help
+
+      def self.execute(options)
+        banner
+        commands
+      end
+
+      def self.banner
+        puts "\nUsage: apiary command [options]"
+        puts "Try 'apiary help' for more information."
+      end
+
+      def self.commands
+        puts "\nCurrently available apiary commands are:\n\n"
+        puts "\tpreview                                     Show API documentation in default browser"
+        puts "\tpreview --browser [chrome|safari|firefox]   Show API documentation in specified browser"
+        puts "\tpreview --path [PATH]                       Specify path to blueprint file"
+        puts "\tpreview --api_host [HOST]                   Specify apiary host"
+        puts "\tpreview --server                            Start standalone web server on port 8080"
+        puts "\tpreview --server --port [PORT]              Start standalone web server on specified port"
+        puts "\n"
+        puts "\thelp                                        Show help"
+        puts "\n"
+        puts "\tversion                                     Show version"
+        puts "\n"
+      end
+
+    end
+  end
+end

data/lib/apiary/command/preview.rb

@@ -0,0 +1,103 @@
+# encoding: utf-8
+require 'rest_client'
+require 'rack'
+module Apiary
+  module Command
+    # Display preview of local blueprint file
+    class Preview
+
+      BROWSERS = {
+        :safari => "Safari",
+        :chrome => "Google Chrome",
+        :firefox => "Firefox"
+      }
+
+      attr_reader :options
+
+      def initialize(args)
+        @options = {}
+        @options[:apib_path]   = "apiary.apib"
+        @options[:api_host]    = "api.apiary.io"
+        @options[:headers]     = {:accept => "text/html", :content_type => "text/plain"}
+        @options[:port]        = 8080
+        @options.merge! args
+      end
+
+      def self.execute(args)
+        args[:server] ? new(args).server : new(args).show
+      end
+
+      def server
+        run_server
+      end
+
+      def show
+        generate_static(apib_path)
+      end
+
+      def validate_apib_file(apib_file)
+        unless File.exist?(apib_file)
+          abort "Apiary definition file hasn't been found: #{apib_file.inspect}"
+        end
+      end
+
+      def apib_path
+        @options[:apib_path] || "#{File.basename(Dir.pwd)}.apib"
+      end
+
+      def browser
+        BROWSERS[@options[:browser]]  || nil
+      end
+
+      def api_host
+        @options[:api_host]
+      end
+
+      def port
+        @options[:port]
+      end
+
+      def rack_app(&block)
+        Rack::Builder.new do
+          run lambda { |env| [200, Hash.new, [block.call]] }
+        end
+      end
+
+      def run_server
+        app = self.rack_app do
+          self.query_apiary(api_host, apib_path)
+        end
+
+        Rack::Server.start(:Port => port, :app => app)
+      end
+
+      def preview_path(apib_path)
+        basename = File.basename(apib_path)
+        "/tmp/#{basename}-preview.html"
+      end
+
+      def query_apiary(host, apib_path)
+        url  = "https://#{host}/blueprint/generate"
+        data = File.read(apib_path)
+        RestClient.post(url, data, @options[:headers])
+      end
+
+      # TODO: add linux and windows systems
+      def open_generated_page(path)
+        exec "open #{browser_options} #{path}"
+      end
+
+      def generate_static(apib_path)
+        File.open(preview_path(apib_path), "w") do |file|
+          file.write(query_apiary(api_host, apib_path))
+          open_generated_page(file.path)
+        end
+      end
+
+      private
+        def browser_options
+          "-a #{BROWSERS[@options[:browser].to_sym]}" if @options[:browser]
+        end
+    end
+  end
+end

data/lib/apiary/command/runner.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+module Apiary
+  module Command
+    # Run commands
+    class Runner
+
+      def self.run(cmd, options)
+        Apiary::Command.const_get(cmd.to_s.capitalize).send(:execute, options)
+      end
+
+    end
+  end
+end

data/lib/apiary/command/version.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+module Apiary
+  module Command
+    # Display version
+    class Version
+
+      def self.execute(options)
+        puts Apiary::VERSION
+      end
+
+    end
+ end
+end

data/lib/apiary/version.rb

@@ -1,3 +1,3 @@
 module Apiary
-  VERSION = "0.0.1"
-end
+  VERSION = "0.0.2"
+end

data/spec/cli_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+describe Apiary::CLI do
+
+  it 'pass the test' do
+    true.should be_true
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require 'rspec'
+require 'apiary'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: apiaryio
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-12 00:00:00.000000000 Z
+date: 2012-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -18,7 +18,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.6.1
+        version: 1.6.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -26,42 +26,108 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.6.1
+        version: 1.6.7
 - !ruby/object:Gem::Dependency
-  name: launchy
+  name: rack
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 0.3.2
+        version: 1.4.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.11.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.11.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.2.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 0.3.2
-description: Apiary.io API client
-email: team@apiary.io
+        version: 0.8.2.1
+description: Apiary.io CLI
+email:
+- team@apiary.io
 executables:
 - apiary
 extensions: []
 extra_rdoc_files: []
 files:
+- .gitignore
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE
 - README.md
+- Rakefile
+- apiary.gemspec
 - bin/apiary
+- doc/Apiary.html
+- doc/Apiary/CLI.html
+- doc/Apiary/Command.html
+- doc/Apiary/Command/Help.html
+- doc/Apiary/Command/Preview.html
+- doc/Apiary/Command/Runner.html
+- doc/Apiary/Command/Version.html
+- doc/_index.html
+- doc/class_list.html
+- doc/css/common.css
+- doc/css/full_list.css
+- doc/css/style.css
+- doc/file.README.html
+- doc/file_list.html
+- doc/frames.html
+- doc/index.html
+- doc/js/app.js
+- doc/js/full_list.js
+- doc/js/jquery.js
+- doc/method_list.html
+- doc/top-level-namespace.html
 - lib/apiary.rb
 - lib/apiary/cli.rb
-- lib/apiary/cmd.rb
-- lib/apiary/commands/base.rb
-- lib/apiary/commands/preview.rb
+- lib/apiary/command/help.rb
+- lib/apiary/command/preview.rb
+- lib/apiary/command/runner.rb
+- lib/apiary/command/version.rb
 - lib/apiary/version.rb
-homepage: http://apiary.io/
+- spec/cli_spec.rb
+- spec/spec_helper.rb
+homepage: http://apiary.io
 licenses:
 - MIT
-post_install_message: 
+post_install_message: This gem is a client for http://apiary.io. Apiary is in closed
+  beta version now, you need an invitation. If you don't have one, visit http://apiary.us2.list-manage.com/subscribe?u=b89934a238dcec9533f4a834a&id=08f2bdde55
+  to get on the waiting list!
 rdoc_options: []
 require_paths:
 - lib
@@ -82,5 +148,8 @@ rubyforge_project:
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: Apiary.io API client
-test_files: []
+summary: Apiary.io CLI
+test_files:
+- spec/cli_spec.rb
+- spec/spec_helper.rb
+has_rdoc: 

data/lib/apiary/cmd.rb

@@ -1,63 +0,0 @@
-# Base skeleton taken from Heroku base command,
-# https://github.com/heroku/heroku/blob/master/lib/heroku/command.rb
-# (c) Heroku and contributors
-
-module Apiary
-  module Command
-    class CommandFailed  < RuntimeError; end
-
-    def self.commands
-      @@commands ||= {}
-    end
-
-    def self.command_aliases
-      @@command_aliases ||= {}
-    end
-
-    def self.load
-      Dir[File.join(File.dirname(__FILE__), "commands", "*.rb")].each do |file|
-        require file
-      end
-    end
-
-    def self.parse(cmd)
-      commands[cmd] || commands[command_aliases[cmd]]
-    end
-
-    def self.prepare_run(cmd, args=[])
-      command = parse(cmd)
-
-      unless command
-        if %w( -v --version ).include?(cmd)
-          command = parse('version')
-        else
-          error([
-            "`#{cmd}` is not an apiary command.",
-          ].compact.join("\n"))
-        end
-      end
-
-      # add args, opts
-      [ command[:klass].new(), command[:method] ]
-    end
-
-    def self.register_command(command)
-      commands[command[:command]] = command
-    end
-
-
-	def self.run(cmd, arguments=[])
-      object, method = prepare_run(cmd, arguments.dup)
-      object.send(method)
-	rescue CommandFailed => e
-      error e.message
-    rescue OptionParser::ParseError
-      commands[cmd] ? run("help", [cmd]) : run("help")
-    end
-
-    def self.error(message)
-      $stderr.puts(message)
-      exit(1)
-    end
-  end
-end

data/lib/apiary/commands/base.rb

@@ -1,41 +0,0 @@
-class Apiary::Command::Base
-
-  attr_reader :args
-  attr_reader :options
-
-  def initialize(args=[], options={})
-    @args = args
-    @options = options
-  end
-
-  def self.namespace
-    self.to_s.split("::").last.downcase
-  end
-
-  attr_reader :args
-  attr_reader :options
-
-  def self.method_added(method)
-    return if self == Apiary::Command::Base
-    return if private_method_defined?(method)
-    return if protected_method_defined?(method)
-
-    # help = extract_help_from_caller(caller.first)
-    resolved_method = (method.to_s == "index") ? nil : method.to_s
-    command = [ self.namespace, resolved_method ].compact.join(":")
-    # banner = extract_banner(help) || command
-
-    Apiary::Command.register_command(
-      :klass       => self,
-      :method      => method,
-      :namespace   => self.namespace,
-      :command     => command
-      # :banner      => banner.strip,
-      # :help        => help.join("\n"),
-      # :summary     => extract_summary(help),
-      # :description => extract_description(help),
-      # :options     => extract_options(help)
-    )
-  end
-
-end