Class: Flammarion::Engraving

Inherits:
Object
  • Object
show all
Includes:
Revelator, Writeable
Defined in:
lib/flammarion/engraving.rb

Overview

Note:

Right now, there is no persistence of Engravings. Once it is closed, everything is erased, and you’ll need to set it up all over again.

Note:

If you try to display something to a closed window, it will open a new blank window, and then display that thing.

The engraving class represents a window. It contains everything you need to display on the screen and interacts with a user. An Engraving contains one or more panes, which are containers for writeable areas. Most of the power of the panes comes from the Writeable module, which is also included in Engraving (operating on the default pane) for convenience.

See Also:

Constant Summary

Constants included from Revelator

Revelator::CHROME_PATH

Instance Attribute Summary collapse

Attributes included from Writeable

#engraving

Instance Method Summary collapse

Methods included from Writeable

#break, #button, #button_box, #callback_link, #checkbox, #clear, #dropdown, #embedded_button, #emoji, #gets, #hide, #highlight, #html, #icon, #image, #input, #live_reload_template, #map, #markdown, #pane, #plot, #puts, #replace, #script, #search, #send, #show, #status, #style, #subpane, #table, #template

Methods included from Revelator

#open_a_window, #wait_for_a_connection

Constructor Details

#initialize(options = {}) ⇒ Engraving

Creates a new Engraving (i.e., a new display window)

Parameters:

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :on_connect (Proc) —

    Called when the display window is connected (i.e., displayed)

  • :on_disconnect (Proc) —

    Called when the display windows is disconnected (i.e., closed)

  • :exit_on_disconnect (Boolean) — default: false —

    Will call exit when the widow is closed if this option is true.

  • :close_on_exit (Boolean) — default: false —

    Will close the window when the process exits if this is true. Otherwise, it will just stay around, but not actually be interactive.

  • :title (String) —

    The initial title of the engraving. If empty, a random title will be generated.

Raises:

  • (SetupError) —

    if neither chrome nor electron is set up correctly and and Flammarion is unable to display the engraving.



33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
 
# File 'lib/flammarion/engraving.rb', line 33

def initialize(options = {})
  options = {:title => options} if options.is_a?(String)
  @chrome = OpenStruct.new
  @sockets = []
  @actions = {}
  @engraving = self
  @pane_name = "default"
  @on_connect = options[:on_connect]
  @on_disconnect = options[:on_disconnect]
  @exit_on_disconnect = options.fetch(:exit_on_disconnect, false)

  start_server
  @window_id = @@server.register_window(self)
  open_a_window(options) unless options[:no_window]
  @callbacks = {}
  wait_for_a_connection unless options[:no_wait]

  at_exit {close if window_open?} if options.fetch(:close_on_exit, true)

  title options[:title] if options[:title]
end

Instance Attribute Details

#actions ⇒ Object

Returns the value of attribute actions.



15
16
17
 
# File 'lib/flammarion/engraving.rb', line 15

def actions
  @actions
end

#callbacks ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



16
17
18
 
# File 'lib/flammarion/engraving.rb', line 16

def callbacks
  @callbacks
end

#on_connect ⇒ Object

Returns the value of attribute on_connect.



15
16
17
 
# File 'lib/flammarion/engraving.rb', line 15

def on_connect
  @on_connect
end

#on_disconnect ⇒ Object

Returns the value of attribute on_disconnect.



15
16
17
 
# File 'lib/flammarion/engraving.rb', line 15

def on_disconnect
  @on_disconnect
end

#sockets ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



16
17
18
 
# File 'lib/flammarion/engraving.rb', line 16

def sockets
  @sockets
end

Instance Method Details

#alert(text) ⇒ Object

Pops up an alert message containing text.



67
68
69
 
# File 'lib/flammarion/engraving.rb', line 67

def alert(text)
  send_json(action:'alert', text:text)
end

#close ⇒ Object

Attempts to close the window.



85
86
87
 
# File 'lib/flammarion/engraving.rb', line 85

def close
  send_json({action:'close'})
end

#disconnect(ws) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



112
113
114
115
116
 
# File 'lib/flammarion/engraving.rb', line 112

def disconnect(ws)
  @sockets.delete ws
  exit 0 if @exit_on_disconnect
  @on_disconnect.call if @on_disconnect
end

#get_save_path ⇒ Object

Opens a native “Save File” Dialog box, prompting the user for a file.



90
91
92
93
94
95
96
 
# File 'lib/flammarion/engraving.rb', line 90

def get_save_path
  if Gem.win_platform?
    `powershell "Add-Type -AssemblyName System.windows.forms|Out-Null;$f=New-Object System.Windows.Forms.SaveFileDialog;$f.InitialDirectory='%cd%';$f.Filter='All Files (*.*)|*.*';$f.showHelp=$true;$f.ShowDialog()|Out-Null;$f.FileName"`.strip
  else
    `zenity --file-selection --save --confirm-overwrite`.strip
  end
end

#layout(file) ⇒ Object

Allows you to load a custom layout file. This replaces all html in the window with a custom slim layout. You probably don’t want this unless your writing a very complex application.



101
102
103
104
 
# File 'lib/flammarion/engraving.rb', line 101

def layout(file)
  data = Slim::Template.new(file).render
  send_json({action:'layout', data:data})
end

#live_reload_layout(file) ⇒ Object 



106
107
108
109
 
# File 'lib/flammarion/engraving.rb', line 106

def live_reload_layout(file)
  layout(file); yield if block_given?
  FileWatcher.new(file).watch {|file| layout(file); yield if block_given? }
end

#make_id ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



144
145
146
147
148
 
# File 'lib/flammarion/engraving.rb', line 144

def make_id
  @id ||= 0
  @id += 1
  "i#{@id}"
end

#orientation=(orientation) ⇒ Object

Changes the orientation of the panes in this engraving. Options are

  • :horizontal

  • :vertical

Raises:

  • (ArgumentError) 


74
75
76
77
 
# File 'lib/flammarion/engraving.rb', line 74

def orientation=(orientation)
  raise ArgumentError.new("Orientation must be :horizontal or :vertical") unless [:horizontal, :vertical].include?(orientation)
  send_json({action:'reorient', orientation:orientation})
end

#process_message(msg) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
 
# File 'lib/flammarion/engraving.rb', line 119

def process_message(msg)
  @last_msg = msg
  m = {}
  begin
    m = JSON.parse(msg)
  rescue JSON::ParserError
    log "Invalid JSON String"
    return
  end

  case m["action"]
  when 'callback'
    callback = @callbacks[m['id']]
    unless callback.nil?
      if callback.arity == 1
        callback.call(m)
      else
        callback.call
      end
    end
  end
  @actions[m["action"]].call(m) if @actions.include?(m["action"])
end

#send_json(val) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



159
160
161
162
163
164
165
166
 
# File 'lib/flammarion/engraving.rb', line 159

def send_json(val)
  if @sockets.empty? then
    open_a_window
    wait_for_a_connection
  end
  @sockets.each{|ws| ws.send val.to_json}
  nil
end

#server ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



156
 
# File 'lib/flammarion/engraving.rb', line 156

def server; @@server; end

#start_server ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



151
152
153
 
# File 'lib/flammarion/engraving.rb', line 151

def start_server
  @@server ||= Server.new
end

#title(str) ⇒ Object

Sets the title of the window



80
81
82
 
# File 'lib/flammarion/engraving.rb', line 80

def title(str)
  send_json({action:'title', title:str})
end

#wait_until_closed ⇒ Object

Blocks the current thread until the window has been closed. All user interactions and callbacks will continue in other threads.



57
58
59
 
# File 'lib/flammarion/engraving.rb', line 57

def wait_until_closed
  sleep 1 until @sockets.empty?
end

#window_open? ⇒ Boolean

Is this Engraving displayed on the screen.

Returns:

  • (Boolean) 


62
63
64
 
# File 'lib/flammarion/engraving.rb', line 62

def window_open?
  not @sockets.empty?
end