fdoc 0.2.7 → 0.3.0

data/README.md

@@ -70,7 +70,7 @@ fdoc is built to work around your Sinatra app specs in rspec, and provides `Fdoc
 ```ruby
 require 'fdoc/spec_watcher'
 
-describe Sinatra::Appllication do
+describe Sinatra::Application do
   include Rack::Test::Methods
   include Fdoc::SpecWatcher
 
@@ -82,11 +82,11 @@ end
 
 ### Outside a Rails App
 
-fdoc provides the `fdoc_to_html` script to transform a directory of `.fdoc` files into more human-readable HTML.
+fdoc provides the `fdoc convert` script to transform a directory of `.fdoc` files into more human-readable HTML.
 
 In this repo, try running:
 
-    bin/fdoc_to_html ./spec/fixtures ./html
+    bin/fdoc convert ./spec/fixtures --output=./html
 
 ## Example
 
@@ -137,7 +137,7 @@ Our spec file, `spec/controllers/members_controller_spec.rb` looks like:
 require 'fdoc/spec_watcher'
 
 describe MembersController do
-  content "#show", :fdoc => "members/list" do
+  context "#show", :fdoc => "members/list" do
     it "can take an offset" do
       get :show, {
         :offset => 5

data/bin/fdoc

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+$:<< File.expand_path("../lib", File.dirname(__FILE__))
+
+require "rubygems"
+require "fdoc"
+require "fdoc/cli"
+
+Fdoc::Cli.start

data/fdoc.gemspec

@@ -23,14 +23,16 @@ Gem::Specification.new do |s|
   s.files = Dir['{lib,spec}/**/*'] + %w(fdoc.gemspec Rakefile README.md Gemfile)
   s.test_files = Dir['spec/**/*']
   s.bindir        = "bin"
-  s.executables  << "fdoc_to_html"
+  s.executables  << "fdoc"
 
   s.add_dependency("json")
   s.add_dependency("json-schema", ">= 1.0.1")
   s.add_dependency("kramdown")
+  s.add_dependency("thor")
 
   s.add_development_dependency("rake")
   s.add_development_dependency("rspec", "~> 2.5")
   s.add_development_dependency("nokogiri")
   s.add_development_dependency("cane")
+  s.add_development_dependency("guard-rspec")
 end

data/lib/fdoc/cli.rb

@@ -0,0 +1,129 @@
+require 'thor'
+require 'fdoc/service'
+require 'fdoc/meta_service'
+
+module Fdoc
+  # A Thor::Error to be thrown when an fdoc directory is not found
+  class NotFound < Thor::Error; end
+
+  # A Thor::Error to be thrown when an fdoc output destination is unavailable
+  class NotADirectory < Thor::Error; end
+
+  # A Thor definition for an fdoc to HTML conversion operation
+  class Cli < Thor
+    include Thor::Actions
+
+    attr_accessor :origin_path
+
+    def self.source_root
+      File.expand_path("../templates", __FILE__)
+    end
+
+    desc "convert FDOC_PATH", "Convert fdoc to HTML"
+    method_option :output, :aliases => "-o", :desc => "HTML output path"
+    method_option :url_base_path, :aliases => "-u", :desc => "URL base path"
+    def convert(fdoc_path)
+      say_status nil, "Converting fdoc to HTML"
+
+      self.origin_path = File.expand_path(fdoc_path)
+      raise Fdoc::NotFound.new(origin_path) unless has_valid_origin?
+      say_status :using, fdoc_path
+
+      self.destination_root = output_path
+      raise Fdoc::NotADirectory.new(output_path) unless has_valid_destination?
+      say_status :inside, output_path
+
+      in_root do
+        copy_file("styles.css")
+        create_file("index.html", meta_presenter.to_html) if has_meta_service?
+      end
+
+      service_presenters.each do |service_presenter|
+        inside_service_presenter(service_presenter) do
+          create_file("index.html", service_presenter.to_html)
+
+          service_presenter.endpoints.each do |endpoint_prefix_group|
+            endpoint_prefix_group.each do |endpoint|
+              create_file(endpoint.url, endpoint.to_html)
+            end
+          end
+        end
+      end
+    end
+
+    no_tasks do
+      def inside_service_presenter(service, &block)
+        if has_meta_service?
+          inside(service.slug_name, {:verbose => true}, &block)
+        else
+          in_root(&block)
+        end
+      end
+
+      def output_path
+        @output_path ||=
+          if options[:output]
+            File.expand_path(options[:output])
+          else
+            File.expand_path("../html", origin_path)
+          end
+      end
+
+      def has_valid_origin?
+        origin.directory?
+      end
+
+      def has_valid_destination?
+        !destination.exist? || destination.directory?
+      end
+
+      def has_meta_service?
+        !meta_service.empty?
+      end
+
+      def service_presenters
+        @service_presenters ||= services.map do |service|
+          Fdoc::ServicePresenter.new(service, html_options)
+        end
+      end
+
+      def html_options
+        {
+          :static_html => true,
+          :url_base_path => options[:url_base_path],
+          :html_directory => destination_root
+        }
+      end
+    end
+
+    private
+
+    def services
+      @services ||=
+        if has_meta_service?
+          meta_service.services
+        else
+          [Fdoc::Service.new(origin_path)]
+        end
+    end
+
+    def meta_presenter
+      @meta_presenter ||= Fdoc::MetaServicePresenter.new(
+        meta_service,
+        html_options
+      )
+    end
+
+    def meta_service
+      @meta_service ||= Fdoc::MetaService.new(origin_path)
+    end
+
+    def origin
+      Pathname.new(origin_path)
+    end
+
+    def destination
+      Pathname.new(destination_root)
+    end
+  end
+end

data/lib/fdoc/endpoint.rb

@@ -22,9 +22,13 @@ class Fdoc::Endpoint
 
   def consume_response(params, status_code, successful=true)
     response_code = response_codes.find do |rc|
-      rc["status"] == status_code && rc["successful"] == successful
+      rc["successful"] == successful && (
+        rc["status"]      == status_code || # 200
+        rc["status"].to_i == status_code    # "200 OK"
+      )
     end
 
+
     if !response_code
       raise Fdoc::UndocumentedResponseCode,
         'Undocumented response: %s, successful: %s' % [

data/lib/fdoc/spec_watcher.rb

@@ -8,50 +8,62 @@ module Fdoc
       define_method(verb) do |*params|
         action, request_params = params
 
-        request_params = if request_params.kind_of?(Hash)
-          request_params
-        else
-          begin
-            JSON.parse(request_params)
-          rescue
-            {}
-          end
-        end
+        super(*params)
 
-        result = super(*params)
-
-        path = if respond_to?(:example) # Rspec 2
-          example.metadata[:fdoc]
-        else # Rspec 1.3.2
-          opts = {}
-          __send__(:example_group_hierarchy).each do |example|
-            opts.merge!(example.options)
-          end
-          opts.merge!(options)
-          opts[:fdoc]
-        end
+        check_response(verb, request_params) if path
+      end
+    end
 
-        real_response = if respond_to? :response
-          # we are on rails
-          response
-        else
-          # we are on sinatra
-          last_response
+    private
+
+    def check_response(verb, request_params)
+      successful = Fdoc.decide_success(response_params, real_response.status)
+      Service.verify!(verb, path, parsed_request_params(request_params), response_params,
+                      real_response.status, successful)
+    end
+
+    def parsed_request_params request_params
+      if request_params.kind_of?(Hash)
+        request_params
+      else
+        begin
+          JSON.parse(request_params)
+        rescue
+          {}
         end
+      end
+    end
 
-        if path
-          response_params = begin
-            JSON.parse(real_response.body)
-          rescue
-            {}
-          end
-          successful = Fdoc.decide_success(response_params, real_response.status)
-          Service.verify!(verb, path, request_params, response_params,
-            real_response.status, successful)
+    def path
+      if respond_to?(:example) # Rspec 2
+        example.metadata[:fdoc]
+      else # Rspec 1.3.2
+        opts = {}
+        __send__(:example_group_hierarchy).each do |example|
+          opts.merge!(example.options)
         end
+        opts.merge!(options)
+        opts[:fdoc]
+      end
+    end
 
-        result
+    def real_response
+      if respond_to? :response
+        # we are on rails
+        response
+      else
+        # we are on sinatra
+        last_response
       end
     end
+
+    def response_params
+      begin
+        JSON.parse(real_response.body)
+      rescue
+        {}
+      end
+    end
+
   end
 end

data/spec/fdoc/cli_spec.rb

@@ -0,0 +1,257 @@
+require "spec_helper"
+
+describe Fdoc::Cli do
+  let(:fixtures_path) { File.expand_path("../../fixtures", __FILE__) }
+  let(:temporary_path) { Dir.mktmpdir("fdoc-cli") }
+  let(:fdoc_path) { File.expand_path("fdoc", temporary_path) }
+  let(:html_path) { File.expand_path("html", temporary_path) }
+  let(:options) { {} }
+
+  subject(:cli) { Fdoc::Cli.new([fdoc_path], options) }
+
+  before { FileUtils.mkdir_p(fdoc_path) }
+
+  around { |e| capture(:stdout, &e) }
+
+  def with_fixture(fixture_file, destination_file = nil)
+    destination = File.expand_path(destination_file || fixture_file, fdoc_path)
+    FileUtils.mkdir_p(File.dirname(destination))
+    source = File.expand_path(fixture_file, fixtures_path)
+    FileUtils.cp(source, destination)
+  end
+
+  describe "#convert" do
+    let(:styles_css_path) { File.expand_path("styles.css", html_path) }
+
+    context "when the fdoc path does not exist" do
+      before { FileUtils.rmdir(fdoc_path) }
+
+      it "raises an exception" do
+        expect do
+          cli.convert(fdoc_path)
+        end.to raise_exception(Fdoc::NotFound)
+      end
+    end
+
+    context "when the fdoc path exists" do
+      context "when the destination does not exist" do
+        it "makes a destination directory" do
+          expect do
+            cli.convert(fdoc_path)
+          end.to change { File.directory?(html_path) }.to(true)
+        end
+      end
+
+      context "when the destination exists as a file" do
+        before { FileUtils.touch(html_path) }
+
+        it "raises an exception" do
+          expect do
+            cli.convert(fdoc_path)
+          end.to raise_exception(Fdoc::NotADirectory)
+        end
+      end
+
+      it "copies the css to the destination" do
+        expect do
+          cli.convert(fdoc_path)
+        end.to change { File.exist?(styles_css_path) }.from(false)
+      end
+
+      context "when there is a meta service fdoc" do
+        let(:root_html) { File.expand_path("index.html", html_path) }
+        let(:members_html) do
+          File.expand_path("members_api/index.html", html_path)
+        end
+        let(:endpoint_html) do
+          File.expand_path("members_api/add-PUT.html", html_path)
+        end
+
+        before { with_fixture("sample_group.fdoc.meta") }
+
+        context "when no service fdoc exists" do
+          specify { expect { cli.convert(fdoc_path) }.to raise_error }
+        end
+
+        context "when a service fdoc exists" do
+          before { with_fixture("members/members.fdoc.service") }
+
+          it "creates a root-level html file" do
+            expect do
+              cli.convert(fdoc_path)
+            end.to change { File.exist?(root_html) }.from(false)
+          end
+
+          it "writes the service-level html file" do
+            expect do
+              cli.convert(fdoc_path)
+            end.to change { File.exist?(members_html) }.from(false)
+          end
+
+          context "when an endpoint fdoc exists" do
+            before { with_fixture("members/add-PUT.fdoc") }
+
+            it "writes the endpoint html file" do
+              expect do
+                cli.convert(fdoc_path)
+              end.to change { File.exist?(endpoint_html) }.from(false)
+            end
+          end
+        end
+      end
+
+      context "when there is no meta service fdoc" do
+        let(:root_html) { File.expand_path("index.html", html_path) }
+        let(:endpoint_html) do
+          File.expand_path("add-PUT.html", html_path)
+        end
+
+        context "when no service fdoc exists" do
+          it "creates a dummy index" do
+            expect do
+              cli.convert(fdoc_path)
+            end.to change { File.exist?(root_html) }.from(false)
+          end
+        end
+
+        context "when a service fdoc exists" do
+          before do
+            with_fixture("members/members.fdoc.service", "a.fdoc.service")
+          end
+
+          it "writes the service-level html file" do
+            expect do
+              cli.convert(fdoc_path)
+            end.to change { File.exist?(root_html) }.from(false)
+          end
+
+          context "when an endpoint fdoc exists" do
+            before { with_fixture("members/add-PUT.fdoc", "add-PUT.fdoc") }
+
+            it "writes the endpoint html file" do
+              expect do
+                cli.convert(fdoc_path)
+              end.to change { File.exist?(endpoint_html) }.from(false)
+            end
+          end
+        end
+      end
+    end
+  end
+
+  describe "accessors" do
+    before do
+      subject.origin_path = fdoc_path
+      subject.destination_root = html_path
+    end
+
+    context "by default" do
+      it { should_not have_meta_service }
+      its(:service_presenters) { should have(1).service }
+      its(:output_path) { should =~ /html$/ }
+    end
+
+    context "when an output path is specified" do
+      let(:output_option) { "/a/path/for/html" }
+      let(:options) { {:output => output_option} }
+
+      its(:output_path) { should == output_option }
+    end
+
+    context "when a meta service file exists" do
+      before { with_fixture("sample_group.fdoc.meta") }
+
+      it { should have_meta_service }
+      its(:service_presenters) { should have(1).service }
+    end
+
+    context "when the origin is a directory" do
+      it { should have_valid_origin }
+    end
+
+    context "when the origin does not exist" do
+      before { FileUtils.rmdir(fdoc_path) }
+
+      it { should_not have_valid_origin }
+    end
+
+    context "when the origin is not a directory" do
+      before do
+        FileUtils.rmdir(fdoc_path)
+        FileUtils.touch(fdoc_path)
+      end
+
+      it { should_not have_valid_origin }
+    end
+
+    context "when the destination does not exist" do
+      it { should have_valid_destination }
+    end
+
+    context "when the destination is a directory" do
+      before { FileUtils.mkdir_p(html_path) }
+
+      it { should have_valid_destination }
+    end
+
+    context "when the destination is not a directory" do
+      before { FileUtils.touch(html_path) }
+
+      it { should_not have_valid_destination }
+    end
+  end
+
+  describe "#html_options" do
+    let(:html_path) { "/a/great/place/to/keep/html"}
+
+    before { subject.destination_root = html_path }
+
+    its(:html_options) { should include(:static_html => true) }
+    its(:html_options) { should include(:html_directory => html_path) }
+
+    context "when url_base_path is not provided" do
+      its(:html_options) { should include(:url_base_path => nil) }
+    end
+
+    context "when url_base_path is provided" do
+      let(:url_base_path) { "totally/not/like/a/wsdl" }
+      let(:options) { {:url_base_path => url_base_path} }
+
+      its(:html_options) { should include(:url_base_path => url_base_path) }
+    end
+  end
+
+  describe "#inside_service" do
+    let(:presenter) { cli.service_presenters.first }
+
+    before do
+      subject.origin_path = fdoc_path
+      subject.destination_root = html_path
+    end
+
+    context "when there is a meta service" do
+      before do
+        with_fixture("sample_group.fdoc.meta")
+        with_fixture("members/members.fdoc.service")
+      end
+
+      it "leaves the output directory" do
+        cli.inside_service_presenter(presenter) do
+          Dir.pwd.should =~ %r|#{html_path}/members_api$|
+        end
+      end
+    end
+
+    context "when there is a single service" do
+      before do
+        with_fixture("members/members.fdoc.service", "members.fdoc.service")
+      end
+
+      it "does not leave the output directory" do
+        cli.inside_service_presenter(presenter) do
+          Dir.pwd.should =~ /#{html_path}$/
+        end
+      end
+    end
+  end
+end

data/spec/fdoc/endpoint_spec.rb

@@ -217,6 +217,10 @@ describe Fdoc::Endpoint do
         subject.consume_response(good_response_params, "200 OK").should be_true
       end
 
+      it "allows either fully-qualified or integer HTTP status codes" do
+        subject.consume_response(good_response_params, 200).should be_true
+      end
+
       context "with unknown keys" do
         it "throws an error when there an unknown key at the top level" do
           bad_params = good_response_params.merge({"extra_goodness" => true})

data/spec/spec_helper.rb

@@ -1,2 +1,9 @@
 require 'fdoc'
+require 'fdoc/cli'
 require 'rspec'
+
+Dir.glob(File.expand_path("../support/*.rb", __FILE__)).each { |f| require f }
+
+RSpec.configure do |config|
+  config.include CaptureHelper
+end

data/spec/support/capture_helper.rb

@@ -0,0 +1,14 @@
+module CaptureHelper
+  def capture(stream)
+    begin
+      stream = stream.to_s
+      eval "$#{stream} = StringIO.new"
+      yield
+      result = eval("$#{stream}").string
+    ensure
+      eval("$#{stream} = #{stream.upcase}")
+    end
+
+    result
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fdoc
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -15,7 +15,7 @@ date: 2011-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &70224688026140 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -23,10 +23,15 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70224688026140
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: json-schema
-  requirement: &70224688025480 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -34,10 +39,15 @@ dependencies:
         version: 1.0.1
   type: :runtime
   prerelease: false
-  version_requirements: *70224688025480
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.1
 - !ruby/object:Gem::Dependency
   name: kramdown
-  requirement: &70224688024780 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -45,10 +55,31 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70224688024780
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70224688023900 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -56,10 +87,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70224688023900
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70224688023100 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -67,10 +103,15 @@ dependencies:
         version: '2.5'
   type: :development
   prerelease: false
-  version_requirements: *70224688023100
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.5'
 - !ruby/object:Gem::Dependency
   name: nokogiri
-  requirement: &70224688022600 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -78,10 +119,31 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70224688022600
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: cane
-  requirement: &70224688022020 !ruby/object:Gem::Requirement
+  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'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -89,16 +151,22 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70224688022020
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A tool for documenting API endpoints.
 email: support@squareup.com
 executables:
-- fdoc_to_html
+- fdoc
 extensions: []
 extra_rdoc_files:
 - README.md
 files:
 - lib/endpoint-schema.yaml
+- lib/fdoc/cli.rb
 - lib/fdoc/endpoint.rb
 - lib/fdoc/endpoint_scaffold.rb
 - lib/fdoc/meta_service.rb
@@ -115,6 +183,7 @@ files:
 - lib/fdoc/templates/service.html.erb
 - lib/fdoc/templates/styles.css
 - lib/fdoc.rb
+- spec/fdoc/cli_spec.rb
 - spec/fdoc/endpoint_scaffold_spec.rb
 - spec/fdoc/endpoint_spec.rb
 - spec/fdoc/presenters/endpoint_presenter_spec.rb
@@ -129,11 +198,12 @@ files:
 - spec/fixtures/members/members.fdoc.service
 - spec/fixtures/sample_group.fdoc.meta
 - spec/spec_helper.rb
+- spec/support/capture_helper.rb
 - fdoc.gemspec
 - Rakefile
 - README.md
 - Gemfile
-- bin/fdoc_to_html
+- bin/fdoc
 homepage: http://github.com/square/fdoc
 licenses: []
 post_install_message: 
@@ -155,11 +225,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.15
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: A tool for documenting API endpoints.
 test_files:
+- spec/fdoc/cli_spec.rb
 - spec/fdoc/endpoint_scaffold_spec.rb
 - spec/fdoc/endpoint_spec.rb
 - spec/fdoc/presenters/endpoint_presenter_spec.rb
@@ -174,4 +245,4 @@ test_files:
 - spec/fixtures/members/members.fdoc.service
 - spec/fixtures/sample_group.fdoc.meta
 - spec/spec_helper.rb
-has_rdoc: 
+- spec/support/capture_helper.rb

data/bin/fdoc_to_html

@@ -1,77 +0,0 @@
-#!/usr/bin/env ruby
-
-require File.join(File.dirname(__FILE__), '../lib/fdoc')
-
-if ARGV.length < 2
-  exec_name = File.basename($0)
-  abort "Usage: #{exec_name} [fdoc_directory] [html_directory] (url_base_path)"
-end
-
-fdoc_directory, html_directory, url_base_path = ARGV[0..2]
-fdoc_directory = File.expand_path(fdoc_directory)
-html_directory = File.expand_path(html_directory)
-
-html_options = {
-  :html_directory => html_directory,
-  :static_html => true,
-  :url_base_path => url_base_path
-}
-
-def mkdir(dirname)
-  `mkdir -p #{dirname}` unless File.directory?(dirname)
-end
-
-mkdir(html_directory)
-
-meta_service = Fdoc::MetaService.new(fdoc_directory)
-services = if !meta_service.empty?
-  meta_service.services
-else
-  Array(Fdoc::Service.new(fdoc_directory))
-end
-
-if !meta_service.empty?
-  meta_service_presenter= Fdoc::MetaServicePresenter.new(
-    meta_service, html_options
-  )
-
-  index_html_path = File.join(html_directory, "index.html")
-  File.open(index_html_path, "w") do |file|
-    file.write(meta_service_presenter.to_html)
-
-    puts "created #{index_html_path}"
-  end
-end
-
-css_path = File.join(File.dirname(__FILE__), '../lib/fdoc/templates/styles.css')
-`cp "#{css_path}" "#{html_directory}"`
-puts "created #{File.expand_path(css_path)}"
-
-services.each do |service|
-  service_presenter = Fdoc::ServicePresenter.new(service, html_options)
-  html_sub_directory = if meta_service.empty?
-    html_directory
-  else
-    File.join(html_directory, service_presenter.slug_name)
-  end
-  
-  mkdir(html_sub_directory)
-
-  index_html_path = File.join(html_sub_directory, "index.html")
-  File.open(index_html_path, "w") do |file|
-    file.write(service_presenter.to_html)
-
-    puts "created #{index_html_path}"
-  end
-
-  service_presenter.endpoints.flatten.each do |endpoint|
-    endpoint_html_path = File.join(html_sub_directory, endpoint.url)
-    mkdir(File.dirname(endpoint_html_path))
-
-    File.open(endpoint_html_path, "w") do |file|
-      file.write(endpoint.to_html)
-
-      puts "created #{endpoint_html_path}"
-    end
-  end
-end