Class: Opal::CLI

Inherits:
Object
  • Object
show all
Defined in:
opal/lib/opal/cli.rb

Class Attribute Summary collapse

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = nil) ⇒ CLI

Returns a new instance of CLI

Raises:

  • (ArgumentError) 


16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'opal/lib/opal/cli.rb', line 16

def initialize options = nil
  options ||= {}

  # Runner
  @runner_type = options.delete(:runner)     || :nodejs
  @port        = options.delete(:port)       || 3000

  @options     = options
  @compile     = !!options.delete(:compile)
  @sexp        = options.delete(:sexp)
  @file        = options.delete(:file)
  @map         = options.delete(:map)
  @no_exit     = options.delete(:no_exit)
  @lib_only    = options.delete(:lib_only)
  @argv        = options.delete(:argv)       || []
  @evals       = options.delete(:evals)      || []
  @load_paths  = options.delete(:load_paths) || []
  @gems        = options.delete(:gems)       || []
  @stubs       = options.delete(:stubs)      || []
  @preload     = options.delete(:preload)    || []
  @output      = options.delete(:output)     || self.class.stdout || $stdout
  @verbose     = options.fetch(:verbose, false); options.delete(:verbose)
  @debug       = options.fetch(:debug, false);   options.delete(:debug)
  @filename    = options.fetch(:filename) { @file && @file.path }; options.delete(:filename)

  @requires    = options.delete(:requires)   || []
  @requires.unshift('opal') unless options.delete(:skip_opal_require)

  @compiler_options = Hash[
    *compiler_option_names.map do |option|
      key = option.to_sym
      next unless options.has_key? key
      value = options.delete(key)
      [key, value]
    end.compact.flatten
  ]

  raise ArgumentError, "no libraries to compile" if @lib_only and @requires.length == 0
  raise ArgumentError, "no runnable code provided (evals or file)" if @evals.empty? and @file.nil? and not(@lib_only)
  raise ArgumentError, "can't accept evals or file in `library only` mode" if (@evals.any? or @file) and @lib_only
  raise ArgumentError, "unknown options: #{options.inspect}" unless @options.empty?
end

Class Attribute Details

.stdout ⇒ Object

Returns the value of attribute stdout



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

def stdout
  @stdout
end

Instance Attribute Details

#argv ⇒ Object (readonly)

Returns the value of attribute argv



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def argv
  @argv
end

#compiler_options ⇒ Object (readonly)

Returns the value of attribute compiler_options



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def compiler_options
  @compiler_options
end

#debug ⇒ Object (readonly)

Returns the value of attribute debug



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def debug
  @debug
end

#evals ⇒ Object (readonly)

Returns the value of attribute evals



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def evals
  @evals
end

#exit_status ⇒ Object (readonly)

Returns the value of attribute exit_status



81
82
83
 
# File 'opal/lib/opal/cli.rb', line 81

def exit_status
  @exit_status
end

#file ⇒ Object (readonly)

Returns the value of attribute file



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def file
  @file
end

#filename ⇒ Object (readonly)

Returns the value of attribute filename



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def filename
  @filename
end

#gems ⇒ Object (readonly)

Returns the value of attribute gems



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def gems
  @gems
end

#lib_only ⇒ Object (readonly)

Returns the value of attribute lib_only



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def lib_only
  @lib_only
end

#load_paths ⇒ Object (readonly)

Returns the value of attribute load_paths



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def load_paths
  @load_paths
end

#no_exit ⇒ Object (readonly)

Returns the value of attribute no_exit



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def no_exit
  @no_exit
end

#options ⇒ Object (readonly)

Returns the value of attribute options



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def options
  @options
end

#output ⇒ Object (readonly)

Returns the value of attribute output



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def output
  @output
end

#port ⇒ Object (readonly)

Returns the value of attribute port



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def port
  @port
end

#preload ⇒ Object (readonly)

Returns the value of attribute preload



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def preload
  @preload
end

#requires ⇒ Object (readonly)

Returns the value of attribute requires



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def requires
  @requires
end

#stubs ⇒ Object (readonly)

Returns the value of attribute stubs



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def stubs
  @stubs
end

#verbose ⇒ Object (readonly)

Returns the value of attribute verbose



8
9
10
 
# File 'opal/lib/opal/cli.rb', line 8

def verbose
  @verbose
end

Instance Method Details

#builder ⇒ Object 



83
84
85
 
# File 'opal/lib/opal/cli.rb', line 83

def builder
  @builder ||= create_builder
end

#compiler_option_names ⇒ Object 



126
127
128
129
130
131
132
133
134
135
136
137
 
# File 'opal/lib/opal/cli.rb', line 126

def compiler_option_names
  %w[
    method_missing
    arity_check
    dynamic_require_severity
    source_map_enabled
    irb_enabled
    inline_operators
    enable_source_location
    parse_comments
  ]
end

#create_builder ⇒ Object 



87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
 
# File 'opal/lib/opal/cli.rb', line 87

def create_builder
  builder = Opal::Builder.new stubs: stubs, compiler_options: compiler_options

  # --include
  builder.append_paths(*load_paths)

  # --gem
  gems.each { |gem_name| builder.use_gem gem_name }

  # --require
  requires.each { |required| builder.build(required) }

  # --preload
  preload.each { |path| builder.build_require(path) }

  # --verbose
  builder.build_str '$VERBOSE = true', '(flags)' if verbose

  # --debug
  builder.build_str '$DEBUG = true', '(flags)' if debug

  # --eval / stdin / file
  evals_or_file { |source, filename| builder.build_str(source, filename) }

  # --no-exit
  builder.build_str 'Kernel.exit', '(exit)' unless no_exit

  builder
end

#evals_or_file ⇒ Object

Internal: Yields a string of source code and the proper filename for either evals, stdin or a filepath.



141
142
143
144
145
146
147
148
149
150
151
152
 
# File 'opal/lib/opal/cli.rb', line 141

def evals_or_file
  # --library
  return if lib_only

  if evals.any?
    yield evals.join("\n"), '-e'
  else
    if file and (filename != '-' or evals.empty?)
      yield file.read, filename
    end
  end
end

#puts(*args) ⇒ Object 



154
155
156
 
# File 'opal/lib/opal/cli.rb', line 154

def puts(*args)
  output.puts(*args)
end

#run ⇒ Object 



59
60
61
62
63
64
65
66
67
68
69
70
 
# File 'opal/lib/opal/cli.rb', line 59

def run
  return show_sexp if @sexp

  compiled_source = builder.to_s

  File.write @map, builder.source_map if @map

  return puts compiled_source if @compile

  runner.run(compiled_source, argv)
  @exit_status = runner.exit_status
end

#runner ⇒ Object 



72
73
74
75
76
77
78
79
 
# File 'opal/lib/opal/cli.rb', line 72

def runner
  @runner ||= begin
    const_name = @runner_type.to_s.capitalize
    CliRunners.const_defined?(const_name) or
      raise ArgumentError, "unknown runner: #{@runner_type.inspect}"
    CliRunners.const_get(const_name).new(output: output, port: port)
  end
end

#show_sexp ⇒ Object 



117
118
119
120
121
122
123
124
 
# File 'opal/lib/opal/cli.rb', line 117

def show_sexp
  evals_or_file do |contents, filename|
    buffer = ::Opal::Source::Buffer.new(filename)
    buffer.source = contents
    sexp = Opal::Parser.default_parser.parse(buffer)
    puts sexp.inspect
  end
end