Class: Livetext

Inherits:
Object show all
Includes:
Helpers
Defined in:
lib/livetext/more.rb,
lib/livetext/paths.rb,
lib/livetext/version.rb,
lib/livetext/skeleton.rb

Overview

Class Livetext skeleton (top level).

Defined Under Namespace

Modules: Handler, Helpers, ParsingConstants, Standard Classes: CmdData, Expansion, Functions, LineParser, ParseGeneral, ParseSet, UserAPI, Variables

Constant Summary collapse

Vars = 
Variables.new
TTY = 
::File.open("/dev/tty", "w")
Path = 
self.get_path
Plugins = 
self.get_path("../plugin")
Imports = 
self.get_path("../imports")
VERSION = 
"0.9.32"

Constants included from Helpers

Helpers::Comment, Helpers::DollarDot, Helpers::DotCmd, Helpers::ESCAPING, Helpers::Sigil, Helpers::Space

Class Attribute Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Helpers

#check_disallowed, #check_file_exists, #debug, #escape_html, #find_file, #friendly_error, #get_name_data, #grab_file, #handle_dollar_dot, #handle_dotcmd, #handle_scomment, #include_file, #invoke_dotcmd, #onoff, #process_file, #process_line, #read_variables, rx, #search_upward, #set_variables, #setfile, #setfile!, #setvar, #showme

Constructor Details

#initialize(output = ::STDOUT) ⇒ Livetext

Returns a new instance of Livetext.



115
116
117
118
119
120
121
122
123
124
125
126
127
 
# File 'lib/livetext/more.rb', line 115

def initialize(output = ::STDOUT)
  @source = nil
  @_mixins = []
  @_imports = []
  @_outdir = "."
  @no_puts = output.nil?
  @body = ""
  @main = Processor.new(self, output)
  @indentation = [0]
  @_vars = Livetext::Vars
  @api = UserAPI.new(self)
  initial_vars
end

Class Attribute Details

.output ⇒ Object

bad solution?



48
49
50
 
# File 'lib/livetext/more.rb', line 48

def output
  @output
end

Instance Attribute Details

#body ⇒ Object

Returns the value of attribute body.



45
46
47
 
# File 'lib/livetext/more.rb', line 45

def body
  @body
end

#indentation ⇒ Object

Returns the value of attribute indentation.



45
46
47
 
# File 'lib/livetext/more.rb', line 45

def indentation
  @indentation
end

#main ⇒ Object (readonly)

Returns the value of attribute main.



43
44
45
 
# File 'lib/livetext/more.rb', line 43

def main
  @main
end

#nopara ⇒ Object

Returns the value of attribute nopara.



44
45
46
 
# File 'lib/livetext/more.rb', line 44

def nopara
  @nopara
end

#nopass ⇒ Object

Returns the value of attribute nopass.



44
45
46
 
# File 'lib/livetext/more.rb', line 44

def nopass
  @nopass
end

#sources ⇒ Object (readonly)

Returns the value of attribute sources.



43
44
45
 
# File 'lib/livetext/more.rb', line 43

def sources
  @sources
end

Class Method Details

.customize(mix: [], call: [], vars: {}) ⇒ Object 



94
95
96
97
98
99
100
101
102
103
 
# File 'lib/livetext/more.rb', line 94

def self.customize(mix: [], call: [], vars: {})
  obj = self.new
  mix  = Array(mix)
  call = Array(call)
  mix.each {|lib| obj.mixin(lib) }
  call.each {|cmd| obj.main.send(cmd[1..-1]) }  # ignores leading dot, no param
  # vars.each_pair {|var, val| obj.setvar(var, val.to_s) }
  obj.api.setvars(vars)
  obj
end

.get_path(dir = "") ⇒ Object 



4
5
6
7
 
# File 'lib/livetext/paths.rb', line 4

def self.get_path(dir = "")
  path = File.join(File.dirname(__FILE__), dir)
  File.expand_path(path)
end

.interpolate(str) ⇒ Object 



55
56
57
58
59
60
 
# File 'lib/livetext/more.rb', line 55

def self.interpolate(str)
  expand = Livetext::Expansion.new(self) 
  str2 = expand.expand_variables(str)
  str3 = expand.expand_function_calls(str2)
  str3
end

Instance Method Details

#api ⇒ Object 



129
130
131
 
# File 'lib/livetext/more.rb', line 129

def api
  @api
end

#customize(mix: [], call: [], vars: {}) ⇒ Object 



105
106
107
108
109
110
111
112
113
 
# File 'lib/livetext/more.rb', line 105

def customize(mix: [], call: [], vars: {})
  mix  = Array(mix)
  call = Array(call)
  mix.each {|lib| mixin(lib) }
  call.each {|cmd| @main.send(cmd[1..-1]) }  # ignores leading dot, no param
  # vars.each_pair {|var, val| @api.set(var, val.to_s) }
  api.setvars(vars)
  self
end

#dump(file = nil) ⇒ Object

not a dot command!



82
83
84
85
86
87
 
# File 'lib/livetext/more.rb', line 82

def dump(file = nil)   # not a dot command!
  file ||= ::STDOUT
  file.puts @body
rescue => err
  TTY.puts "#dump had an error: #{err.inspect}"
end

#graceful_error(err) ⇒ Object 



89
90
91
92
 
# File 'lib/livetext/more.rb', line 89

def graceful_error(err)
  dump
  raise err
end

#initial_vars ⇒ Object 



133
134
135
136
137
 
# File 'lib/livetext/more.rb', line 133

def initial_vars
  # Other predefined variables (see also setfile)
  @api.setvar(:User, `whoami`.chomp)
  @api.setvar(:Version, Livetext::VERSION)
end

#nextline ⇒ Object 



66
67
68
 
# File 'lib/livetext/more.rb', line 66

def nextline
  @main.nextline       # delegate
end

#peek_nextline ⇒ Object 



62
63
64
 
# File 'lib/livetext/more.rb', line 62

def peek_nextline
  @main.peek_nextline  # delegate
end

#save_location ⇒ Object 



74
75
76
 
# File 'lib/livetext/more.rb', line 74

def save_location
  @save_location  # delegate
end

#save_location=(where) ⇒ Object 



78
79
80
 
# File 'lib/livetext/more.rb', line 78

def save_location=(where)
  @save_location = where  # delegate
end

#transform(text) ⇒ Object 



139
140
141
142
143
144
145
146
147
148
149
150
151
152
 
# File 'lib/livetext/more.rb', line 139

def transform(text)
  setfile!("(string)")
  enum = text.each_line
  front = text.match(/.*?\n/).to_a.first.chomp rescue ""
  @main.source(enum, "STDIN: '#{front}...'", 0)
  loop do 
    line = @main.nextline
    break if line.nil?
    process_line(line)
  end
  result = @body
#   @body = ""
  result
end

#vars ⇒ Object 



51
52
53
 
# File 'lib/livetext/more.rb', line 51

def vars
  @_vars
end

#xform(*args, file: nil, text: nil, vars: {}) ⇒ Object

EXPERIMENTAL and incomplete



155
156
157
158
159
160
161
162
163
164
165
166
167
168
 
# File 'lib/livetext/more.rb', line 155

def xform(*args, file: nil, text: nil, vars: {})
  case
    when file && text.nil?
      xform_file(file)
    when file.nil? && text
      transform(text)
    when file.nil? && text.nil?
      raise "Must specify file or text"
    when file && text
      raise "Cannot specify file and text"
  end
  self.process_file(file)
  self.body
end

#xform_file(file, vars: nil) ⇒ Object 



170
171
172
173
174
175
 
# File 'lib/livetext/more.rb', line 170

def xform_file(file, vars: nil)
  Livetext::Vars.replace(vars) unless vars.nil?
  @_vars.replace(vars) unless vars.nil?
  self.process_file(file)
  self.body
end