apiaryio 0.2.5 → 0.3.0

data/.travis.yml

@@ -1,4 +1,5 @@
 language: ruby
+sudo: false
 rvm:
   - "1.9.3"
   - "2.0.0"
@@ -17,13 +18,6 @@ matrix:
     - rvm: rbx-2
 cache: bundler
 notifications:
-  email:
-    recipients:
-      - lukas@apiary.io
-      - adam@apiary.io
-      - ladislav@apiary.io
-    on_success: change
-    on_failure: always
   hipchat:
     rooms:
       secure: "HqBUrmf4P2bgvwb4b9PL1tBae2wcZaXadOgwRwAFhdhDZFHaKXIXlJRUW8tN\ntdO83OZgatxJrpWWQj8VYTfDuhlE3b3NxVWeXc3PkfrHmuvejQf4veh7kwR0\njLVE6jb+ZbFIwRE2W0VFLFKYQHI6PLem4W0OKXW5Shqzy8Ewlow="

data/README.md

@@ -3,7 +3,7 @@ apiaryio
 
 Apiary.io CLI
 
-[![Build Status](https://travis-ci.org/apiaryio/apiary-client.png?branch=master)](https://travis-ci.org/apiaryio/apiary-client)
+[![Build Status](https://travis-ci.org/apiaryio/apiary-client.png?branch=master)](https://travis-ci.org/apiaryio/apiary-client) [![Build status](https://ci.appveyor.com/api/projects/status/0hmkivbnhf9p3f8d/branch/master?svg=true)](https://ci.appveyor.com/project/Apiary/apiary-client/branch/master)
 
 
 ## Install

data/appveyor.yml

@@ -0,0 +1,22 @@
+---
+version: "{build}"
+clone_depth: 10
+install:
+  - SET PATH=C:\Ruby%ruby_version%\bin;%PATH%
+  - ruby --version
+  - gem --version
+  - gem install bundler --quiet --no-ri --no-rdoc
+  - bundler --version
+build_script:
+  - bundle install
+test_script:
+  - rake test
+artifacts:
+  - path: pkg\*.gem
+environment:
+  matrix:
+    - ruby_version: "193"
+    - ruby_version: "200"
+    - ruby_version: "200-x64"
+    - ruby_version: "21"
+    - ruby_version: "21-x64"

data/lib/apiary.rb

@@ -1,8 +1,7 @@
 require 'rubygems'
-require "apiary/version"
-require "apiary/cli"
-require "apiary/common"
-Dir["#{File.dirname(__FILE__)}/apiary/command/*.rb"].each { |f| require(f) }
+require 'apiary/version'
+require 'apiary/cli'
+require 'apiary/common'
 
 module Apiary
 end

data/lib/apiary/cli.rb

@@ -1,39 +1,39 @@
 # encoding: utf-8
-require "thor"
-require "apiary/command/fetch"
-require "apiary/command/preview"
-require "apiary/command/publish"
+require 'thor'
+require 'apiary/command/fetch'
+require 'apiary/command/preview'
+require 'apiary/command/publish'
 
 module Apiary
   class CLI < Thor
 
-    desc "fetch", "Fetch apiary.apib from API_NAME.apiary.io"
+    desc 'fetch', 'Fetch apiary.apib from API_NAME.apiary.io'
     method_option :api_name, :type => :string, :required => true, :default => ''
-    method_option :api_host, :type => :string, :banner => "HOST", :desc => "Specify apiary host"
-    method_option :output, :type => :string, :banner => "FILE", :desc => "Write apiary.apib into specified file"
+    method_option :api_host, :type => :string, :banner => 'HOST', :desc => 'Specify apiary host'
+    method_option :output, :type => :string, :banner => 'FILE', :desc => 'Write apiary.apib into specified file'
 
     def fetch
       cmd = Apiary::Command::Fetch.new options
       cmd.execute
     end
 
-    desc "preview", "Show API documentation in default browser"
-    method_option :browser, :type => :string, :enum => %w(chrome safari firefox), :banner => "chrome|safari|firefox", :desc => "Show API documentation in specified browser"
-    method_option :output, :type => :string, :banner => "FILE", :desc => "Write generated HTML into specified file"
-    method_option :path, :type => :string, :desc => "Specify path to blueprint file", :default => 'apiary.apib'
-    method_option :api_host, :type => :string, :banner => "HOST", :desc => "Specify apiary host"
-    method_option :server, :type => :boolean, :desc => "Start standalone web server on port 8080"
-    method_option :port, :type => :numeric, :banner => "PORT", :desc => "Set port for --server option"
+    desc 'preview', 'Show API documentation in default browser'
+    method_option :browser, :type => :string, :enum => %w(chrome safari firefox), :banner => 'chrome|safari|firefox', :desc => 'Show API documentation in specified browser'
+    method_option :output, :type => :string, :banner => 'FILE', :desc => 'Write generated HTML into specified file'
+    method_option :path, :type => :string, :desc => 'Specify path to blueprint file', :default => 'apiary.apib'
+    method_option :api_host, :type => :string, :banner => 'HOST', :desc => 'Specify apiary host'
+    method_option :server, :type => :boolean, :desc => 'Start standalone web server on port 8080'
+    method_option :port, :type => :numeric, :banner => 'PORT', :desc => 'Set port for --server option'
 
     def preview
       cmd = Apiary::Command::Preview.new options
       cmd.execute
     end
 
-    desc "publish", "Publish apiary.apib on docs.API_NAME.apiary.io"
-    method_option :message, :type => :string, :banner => "COMMIT_MESSAGE", :desc => "Publish with custom commit message"
-    method_option :path, :type => :string, :desc => "Specify path to blueprint file", :default => 'apiary.apib'
-    method_option :api_host, :type => :string, :banner => "HOST", :desc => "Specify apiary host"
+    desc 'publish', 'Publish apiary.apib on docs.API_NAME.apiary.io'
+    method_option :message, :type => :string, :banner => 'COMMIT_MESSAGE', :desc => 'Publish with custom commit message'
+    method_option :path, :type => :string, :desc => 'Specify path to blueprint file', :default => 'apiary.apib'
+    method_option :api_host, :type => :string, :banner => 'HOST', :desc => 'Specify apiary host'
     method_option :api_name, :type => :string, :required => true, :default => ''
 
     def publish
@@ -41,7 +41,7 @@ module Apiary
       cmd.execute
     end
 
-    desc "version", "Show version"
+    desc 'version', 'Show version'
     method_option :aliases => "-v"
 
     def version

data/lib/apiary/command/fetch.rb

@@ -8,7 +8,6 @@ module Apiary
   module Command
     # Retrieve blueprint from apiary
     class Fetch
-
       attr_reader :options
 
       # TODO: use OpenStruct to store @options
@@ -43,10 +42,10 @@ module Apiary
         end
 
         response = self.query_apiary(@options.api_host, @options.path)
-        unless @options.output
-          response["code"]
-        else
+        if @options.output
           write_generated_path(response["code"], @options.output)
+        else
+          response["code"]
         end
       end
 

data/lib/apiary/command/preview.rb

@@ -3,30 +3,39 @@ require 'rest_client'
 require 'rack'
 require 'ostruct'
 require 'json'
+require 'tmpdir'
+require 'erb'
 
 require "apiary/common"
+require "apiary/helpers/javascript_helper"
 
 module Apiary
   module Command
     # Display preview of local blueprint file
     class Preview
 
+      include Apiary::Helpers::JavascriptHelper
+
+      PREVIEW_TEMPLATE_PATH = "#{File.expand_path File.dirname(__FILE__)}/../file_templates/preview.erb"
+
       BROWSERS = {
-        :safari => "Safari",
-        :chrome => "Google Chrome",
-        :firefox => "Firefox"
+        :safari => 'Safari',
+        :chrome => 'Google Chrome',
+        :firefox => 'Firefox'
       }
 
       attr_reader :options
 
       def initialize(opts)
         @options = OpenStruct.new(opts)
-        @options.path         ||= "apiary.apib"
-        @options.api_host     ||= "api.apiary.io"
-        @options.headers      ||= {:accept => "text/html", :content_type => "text/plain"}
+        @options.path         ||= 'apiary.apib'
+        @options.api_host     ||= 'api.apiary.io'
+        @options.headers      ||= {:accept => 'text/html', :content_type => 'text/plain'}
         @options.port         ||= 8080
         @options.proxy        ||= ENV['http_proxy']
         @options.server       ||= false
+
+        validate_apib_file
       end
 
       def execute
@@ -42,12 +51,12 @@ module Apiary
       end
 
       def show
-        generate_static(@options.path)
+        generate_static
       end
 
-      def validate_apib_file(apib_file)
+      def validate_apib_file
         common = Apiary::Common.new
-        common.validate_apib_file(apib_file)
+        common.validate_apib_file(@options.path)
       end
 
       def path
@@ -66,45 +75,12 @@ module Apiary
 
       def run_server
         app = self.rack_app do
-          self.query_apiary(@options.api_host, @options.path)
+          generate
         end
 
         Rack::Server.start(:Port => @options.port, :app => app)
       end
 
-      def preview_path(path)
-        basename = File.basename(@options.path)
-        "/tmp/#{basename}-preview.html"
-      end
-
-      def query_apiary(host, path)
-        url  = "https://#{host}/blueprint/generate"
-        if validate_apib_file(path)
-          begin
-            data = File.read(path)
-          rescue
-            abort "File #{path} not found."
-          end
-
-          RestClient.proxy = @options.proxy
-
-          begin
-            RestClient.post(url, data, @options.headers)
-          rescue RestClient::BadRequest => e
-            err = JSON.parse e.response
-            if err.has_key? 'parserError'
-              abort "#{err['message']}: #{err['parserError']} (Line: #{err['line']}, Column: #{err['column']})"
-            else
-              abort "Apiary service responded with an error: #{err['message']}"
-            end
-          rescue RestClient::Exception => e
-            abort "Apiary service responded with an error: #{e.message}"
-          end
-        else
-          abort "Sorry, Apiary can't display invalid blueprint."
-        end
-      end
-
       # TODO: add linux and windows systems
       def open_generated_page(path)
         exec "open #{browser_options} #{path}"
@@ -114,17 +90,49 @@ module Apiary
         File.write(outfile, File.read(path))
       end
 
-      def generate_static(path)
-        File.open(preview_path(path), "w") do |file|
-          file.write(query_apiary(@options.api_host, path))
+      def generate
+        template = load_preview_template
+
+        data = {
+          title: File.basename(@options.path, '.*'),
+          blueprint: load_blueprint
+        }
+
+        template.result(binding)
+      end
+
+      def generate_static
+        preview_string = generate
+
+        File.open(preview_path, 'w') do |file|
+          file.write preview_string
+          file.flush
           @options.output ? write_generated_path(file.path, @options.output) : open_generated_page(file.path)
         end
       end
 
+      def load_blueprint
+        file = File.open @options.path, 'r'
+        file.read
+      end
+
+      def preview_path
+        basename = File.basename(@options.path, '.*')
+        temp = Dir.tmpdir
+        "#{temp}/#{basename}-preview.html"
+      end
+
+      def load_preview_template
+        file = File.open(PREVIEW_TEMPLATE_PATH, 'r')
+        template_string = file.read
+        ERB.new(template_string)
+      end
+
       private
-        def browser_options
-          "-a #{BROWSERS[@options.browser.to_sym]}" if @options.browser
-        end
+
+      def browser_options
+        "-a #{BROWSERS[@options.browser.to_sym]}" if @options.browser
+      end
     end
   end
 end

data/lib/apiary/file_templates/preview.erb

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title><%= data[:title] %></title>
+</head>
+<body>
+  <script src="https://api.apiary.io/seeds/embed.js"></script>
+  <script>
+    var embed = new Apiary.Embed({
+      apiBlueprint: "<%= escape_javascript data[:blueprint] %>"
+    });
+  </script>
+</body>
+</html>

data/lib/apiary/helpers/javascript_helper.rb

@@ -0,0 +1,29 @@
+# encoding: utf-8
+module Apiary
+  module Helpers
+    module JavascriptHelper
+      JS_ESCAPE_MAP = {
+        '\\'    => '\\\\',
+        '</'    => '<\/',
+        "\r\n"  => '\n',
+        "\n"    => '\n',
+        "\r"    => '\n',
+        '"'     => '\\"',
+        "'"     => "\\'"
+      }
+
+      JS_ESCAPE_MAP["\342\200\250".force_encoding(Encoding::UTF_8).encode!] = '&#x2028;'
+      JS_ESCAPE_MAP["\342\200\251".force_encoding(Encoding::UTF_8).encode!] = '&#x2029;'
+
+      def escape_javascript(javascript)
+        if javascript
+          javascript.gsub(/(\\|<\/|\r\n|\342\200\250|\342\200\251|[\n\r"'])/u) {|match| JS_ESCAPE_MAP[match] }
+        else
+          ''
+        end
+      end
+
+      alias_method :j, :escape_javascript
+    end
+  end
+end

data/lib/apiary/version.rb

@@ -1,3 +1,3 @@
 module Apiary
-  VERSION = "0.2.5"
+  VERSION = "0.3.0"
 end

data/spec/command/preview_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe Apiary::Command::Preview do
+
+  let(:command) do
+    opts = {
+      path: "#{File.expand_path File.dirname(__FILE__)}/../../features/fixtures/apiary.apib"
+    }
+    Apiary::Command::Preview.new(opts)
+  end
+
+  it 'check tmp path if contains filename' do
+    expect(command.preview_path()).to end_with('apiary-preview.html')
+  end
+
+  it 'shoud contain html5 doctype' do
+    expect(command.generate()).to include('<!DOCTYPE html>')
+  end
+
+  it 'should contain embed javascript' do
+    expect(command.generate()).to include('https://api.apiary.io/seeds/embed.js')
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: apiaryio
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-05 00:00:00.000000000 Z
+date: 2015-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -193,6 +193,7 @@ files:
 - README.md
 - Rakefile
 - apiary.gemspec
+- appveyor.yml
 - bin/apiary
 - circle.yml
 - features/fetch.feature
@@ -211,9 +212,12 @@ files:
 - lib/apiary/command/preview.rb
 - lib/apiary/command/publish.rb
 - lib/apiary/common.rb
+- lib/apiary/file_templates/preview.erb
+- lib/apiary/helpers/javascript_helper.rb
 - lib/apiary/version.rb
 - spec/cli_spec.rb
 - spec/command/fetch_spec.rb
+- spec/command/preview_spec.rb
 - spec/common_spec.rb
 - spec/spec_helper.rb
 - spec/support/aruba.rb
@@ -230,18 +234,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -821896092872960155
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -821896092872960155
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23
@@ -261,6 +259,7 @@ test_files:
 - features/version.feature
 - spec/cli_spec.rb
 - spec/command/fetch_spec.rb
+- spec/command/preview_spec.rb
 - spec/common_spec.rb
 - spec/spec_helper.rb
 - spec/support/aruba.rb