Class: YARD::CLI::Server

Inherits:
Command show all
Defined in:
lib/yard/cli/server.rb

Overview

A local documentation server

Since:

  • 0.6.0

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Command

#common_options, #load_script, #parse_options, run

Instance Attribute Details

#adapterAdapter

Returns the adapter to use for loading the web server

Returns:

  • (Adapter)

    the adapter to use for loading the web server

Since:

  • 0.6.0



16
17
18
# File 'lib/yard/cli/server.rb', line 16

def adapter
  @adapter
end

#librariesHash

Returns a list of library names and yardoc files to serve

Returns:

  • (Hash)

    a list of library names and yardoc files to serve

Since:

  • 0.6.0



13
14
15
# File 'lib/yard/cli/server.rb', line 13

def libraries
  @libraries
end

#optionsHash

Returns a list of options to pass to the doc server

Returns:

  • (Hash)

    a list of options to pass to the doc server

Since:

  • 0.6.0



7
8
9
# File 'lib/yard/cli/server.rb', line 7

def options
  @options
end

#scriptsArray<String>

Returns a list of scripts to load

Returns:

Since:

  • 0.6.2



20
21
22
# File 'lib/yard/cli/server.rb', line 20

def scripts
  @scripts
end

#server_optionsHash

Returns a list of options to pass to the web server

Returns:

  • (Hash)

    a list of options to pass to the web server

Since:

  • 0.6.0



10
11
12
# File 'lib/yard/cli/server.rb', line 10

def server_options
  @server_options
end

#template_pathsArray<String>

Returns a list of template paths to register

Returns:

  • (Array<String>)

    a list of template paths to register

Since:

  • 0.6.2



24
25
26
# File 'lib/yard/cli/server.rb', line 24

def template_paths
  @template_paths
end

Instance Method Details

#descriptionObject

Since:

  • 0.6.0



26
27
28
# File 'lib/yard/cli/server.rb', line 26

def description
  "Runs a local documentation server"
end

#run(*args) ⇒ Object

Since:

  • 0.6.0



30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
# File 'lib/yard/cli/server.rb', line 30

def run(*args)
  self.scripts = []
  self.template_paths = []
  self.libraries = {}
  self.options = SymbolHash.new(false).update(
    :single_library => true,
    :caching => false
  )
  self.server_options = {:Port => 8808}
  optparse(*args)

  select_adapter.setup
  load_scripts
  load_template_paths
  adapter.new(libraries, options, server_options).start
end