simple_gui_creator 0.1.0 → 0.1.2

data/ChangeLog

@@ -0,0 +1,7 @@
+0.1.2
+  better lookin' GUI :)
+
+0.1.1
+  linux compat.
+  completely change the module structure/hierarchy LOL.
+  less pollution of global namespace

data/README

@@ -10,29 +10,27 @@ You can specify "easy window layout" in ASCII text, example, if you have a layou
 It will create a window that has buttons and text "like that," with reasonable spacing.
 
 Here's how:
->> frame = ParseTemplate::JFramer.new # or optionally subclass this instead
+>> frame = SimpleGuiCreator::ParseTemplate.new # or optionally subclass this instead, and call super in your constructor
 >> frame.parse_setup_filename 'some_filename'
 
-You can program behavior, like this:
+You can then program behaviors like this:
 
 >> frame.elements['button1'].on_clicked { 
-  SimpleGui.show_blocking_message_dialog "you clicked button1!" 
+  SimpleGuiCreator.show_blocking_message_dialog "you clicked button1!" 
 }  
 
-This has the effect of separating your view from your controller, in this case, because you can store the layouts in
-an entirely separate file, or embedded in the code.  "Normal humans" can edit the design layout files, for instance,
-and the separation allows for easy peace of mind.
+This separates your views from your controllers, in this case, because you can store the layouts in
+an entirely separate file, or embedded in the code.  "Normal humans" can then edit the design layout files, for instance.
 
-It also has helper methods for common GUI tasks, like the above show_blocking_message_dialog:
-
-SimpleGui.new_nonexisting_filechooser_and_go # select file or filename for a "new file" (not yet existing)
-SimpleGui.new_existing_dir_chooser_and_go # select pre-existing directory
-SimpleGui.show_in_explorer(filename) # reveals file in Explorer for windows, Finder for OS X
-text_from_user = SimpleGui.get_user_input "Input your name:" # these raise an exception if the user cancels the dialog,
+It also has helper methods for common GUI tasks, like the above show_blocking_message_dialog, and also:
+SimpleGuiCreator.new_nonexisting_filechooser_and_go # select file or filename for a "new file" (not yet existing)
+SimpleGuiCreator.new_existing_dir_chooser_and_go # select pre-existing directory
+SimpleGuiCreator.show_in_explorer(filename) # reveals file in Explorer for windows, Finder for OS X
+text_from_user = SimpleGuiCreator.get_user_input "Input your name:" # these raise an exception if the user cancels the dialog,
 
 A select-button prompt dialog:
 
-if(SimpleGui.show_select_buttons_prompt("message title", :yes => 'text for the yes button', :no => 'text for the no button', :cancel => 'text for the cancel button') == :yes)
+if(SimpleGuiCreator.show_select_buttons_prompt("message title", :yes => 'text for the yes button', :no => 'text for the no button', :cancel => 'text for the cancel button') == :yes)
   # they chose the "yes" equivalent button...
 end
 
@@ -61,8 +59,21 @@ To install/use:
 
 $ gem install simple-ruby-gui-creator
 
->> require 'simple_gui'
->> ... [see above]
+>> require 'simple_gui_creator'
+>> ... [see other examples]
+
+== GUI Editor ==
+
+It also comes with its own "test as you go" design builder helper GUI, programmed, appropriately enough, using simple gui creator.
+$ jruby -S simple_gui_creator
+
+This pulls up a window with some demo code, and some links that let you save it.  It's almost more of a "demo of how it works" than a
+real editing tool, but feature requests/suggestions wanted!
+
+== Documentation ==
+
+Basically, see this file, the examples folder, the "bin/*" files, and also the specs and lib files themselves.
+https://github.com/rdp/ruby_simple_gui_creator
 
 == Known problems ==
 

data/Rakefile

@@ -1,3 +1,5 @@
+puts 'dont build this from a git submodule!'
+
 require 'sane'
 require 'jeweler2'
 Jeweler::Tasks.new do |gem|
@@ -8,6 +10,7 @@ Jeweler::Tasks.new do |gem|
   gem.homepage = "http://github.com/rdp/simple-ruby-gui-creator"
   gem.authors = ["rogerdpack"]
   gem.add_dependency 'sane'
+#  gem.add_dependency 'launchy'
 end
 
-Jeweler::RubygemsDotOrgTasks.new
+Jeweler::RubygemsDotOrgTasks.new

data/TODO

@@ -1,4 +1,12 @@
-on_minimized fix
+if the window goes too low, they can't see it all?
+
+Parsing failed on line "      _                       _\t  \n" number: 5!
+
+gets h,w of trivial text areas *wrong* oh so wrong
+
+= never =
+
+use launchy for url's in linux [?]
 
 ask_should_allow_on_minimize {
-}
+}

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.2

data/bin/simple_gui_creator

@@ -1,88 +1,131 @@
 #!/usr/bin/env ruby
 # assumes has rubygems loaded...since we need the sane gem
-require 'os'
+
+begin
+  require 'os'
+rescue LoadError # ease of development :P
+ require 'rubygems'
+ retry
+end
+
 if !OS.jruby?
   $stderr.puts 'jruby only for now, you can request a change to this, exiting...'
   exit 1
 end
-require File.dirname(__FILE__) + "/../lib/simple_gui_creator.rb"
+require 'simple_gui_creator'#File.dirname(__FILE__) + "/../lib/simple_gui_creator.rb"
 
-class TestWindow < ParseTemplate::JFramer
+class TestWindow < SimpleGuiCreator::ParseTemplate
 
   def initialize
     super
     string = <<-EOL
-          ---------- Simple Ruby Gui Creator Test Window ---------------------------
-          | "Edit this, then..."                                                    |
-          | [Test it out! :create_button]                                           |
-          | [      :text_area_to_use, width=70chars, height=500, font=fixed_width]  |
-          | [                                                                    ]  |
-          | [                                                                    ]  |
-          | [                                                                    ]  |
-          | [                                                                    ]  |
-          | [                                                                    ]  |
-          | [                                                                    ]  |
-          | [                                                                    ]  |
-          |                                                                         |
-          | [Show code snippet :create_snippet]                                    |
-          --------------------------------------------------------------------------
+          ---------- Simple Ruby Gui Creator Test Window ----------------------------------------
+          | "Edit this, then..."                                                                |
+          | [Test it out! :test_it_out_button]  [Insert code for this window:replace_button]    |
+          | [      :text_area_to_use, width=70chars, height=500, font=fixed_width]              |
+          | [                                                                    ]              |
+          | [                                                                    ]              |
+          | [                                                                    ]              |
+          | [                                                                    ]              |
+          | [                                                                    ]              |
+          | [                                                                    ]              |
+          | [                                                                    ]              |
+          |                                                                                     |
+          | [Create code snippet :create_snippet]                                               |
+          ---------------------------------------------------------------------------------------
     EOL
-	Kernel.print string
 	parse_setup_string string
-	elements[:text_area_to_use].text=string
-    elements[:create_button].on_clicked {
-	  ParseTemplate::JFramer.new.parse_setup_string elements[:text_area_to_use].text
+	elements[:text_area_to_use].text = <<-EOL
+    -------------A Title-------------
+      "Some text"
+      [Button text    :button1]
+      [a text area :text_area1,height=300]
+      [                                  ]      
+	EOL
+	
+	elements[:replace_button].on_clicked {
+	  elements[:text_area_to_use].text = string
+	}
+    elements[:test_it_out_button].on_clicked {
+	  frame = SimpleGuiCreator::ParseTemplate.new
+	  frame.parse_setup_string elements[:text_area_to_use].text
+	  frame.instance_eval(enumerate_elements_and_get_code) # give the buttons something to do when clicked :P
 	}
 	elements[:create_snippet].on_clicked {
-	  frame = ParseTemplate::JFramer.new.parse_setup_string elements[:text_area_to_use].text
-	  frame.close
-	  
-	  element_code = ""
-      frame.elements.each{|e| 
-        if e[1].is_a? Java::JavaxSwing::JButton
-	      element_code += "    elements[:#{e[0]}].on_clicked { puts 'clicked #{e[0]}' }\n"
-	    end
-      }	  
+	  code = create_snippet_from_current
 	  
-      code=<<-EOL
-	  
-require 'simple-ruby-gui-creator.rb'
-
-class MyWindow < ParseTemplate::JFramer
-  def initialize
-    super
-    parse_setup_filename 'my_window.template' # create this file first
-	
-#{element_code}
-  end
-  
-end
-MyWindow.new
-	  EOL
-	  frame2 = ParseTemplate::JFramer.new.parse_setup_string <<-EOL
+	  display_frame = SimpleGuiCreator::ParseTemplate.new
+	  display_frame.parse_setup_string <<-EOL
+        --------Here's your snippet!--------------------
         "Here's your snippet!"
         [:code,width=500,height=400]
         [                          ]
         [                          ]
-        [Save Code Snippet:snippet_save]
         "Here's your template:"
         [:template_text,width=500,height=400,font=fixed_width]
         [                                                    ]
-        [Save Template:template_save]
+        [Save Both files:save_all]
 	  EOL
-	  frame2.elements[:code].text = code
-	  frame2.elements[:snippet_save].on_clicked { save_file 'simple-gui-demo.rb', code}
-	  template = elements[:text_area_to_use].text
-	  frame2.elements[:template_text].text = template
-      frame2.elements[:template_save].on_clicked { save_file 'template.simple-gui-demo', template}
+	  display_frame.elements[:code].text = code
+	  template_text = elements[:text_area_to_use].text
+	  display_frame.elements[:template_text].text = template_text
+	  
+	  display_frame.elements[:save_all].on_clicked { 
+	    dir = SimpleGuiCreator.new_existing_dir_chooser_and_go "Pick directory to save both files to:"
+		template_file = dir + '/my_window.template'
+		if File.exist? template_file
+		  if(SimpleGuiCreator.show_select_buttons_prompt("#{template_file} already exists, overwrite?", :yes => 'Overwrite!') != :yes)
+		    raise 'abort this button!'
+		  end
+		end
+  
+		File.write(template_file, elements[:text_area_to_use].text)
+		rb_file = dir + '/my_window.rb'
+		File.write(rb_file, create_snippet_from_current)
+		puts 'wrote to ' + rb_file + ' and ' + template_file
+		SimpleGuiCreator.show_in_explorer rb_file
+	  }
 	}
+  end  
+  
+  def create_snippet_from_current
+      # create a demo frame, so I can then pull elements from it
+	  element_code = enumerate_elements_and_get_code
+      code=<<-END_CODE
+# demo code to parse template file
+require 'rubygems'	  
+require 'simple_gui_creator'
+
+class MyWindow < SimpleGuiCreator::ParseTemplate
+  def initialize
+    super
+    parse_setup_filename 'my_window.template' # layout/design template
+#{element_code}
   end
   
-  def save_file default_filename, text
-    location = SimpleGuiCreator.new_nonexisting_or_existing_filechooser_and_go "Choose where to save:", nil, default_filename
-	File.write(location, text)
+end
+
+MyWindow.new # runs forever until closed
+
+     END_CODE
+	 code
   end
 
+  def enumerate_elements_and_get_code
+      fake_frame = SimpleGuiCreator::ParseTemplate.new.parse_setup_string elements[:text_area_to_use].text
+	  fake_frame.close
+	  
+	  element_code = ""
+      fake_frame.elements.each{|e| 
+        if e[1].is_a? Java::JavaxSwing::JButton
+	      element_code += "    elements[:#{e[0]}].on_clicked { puts 'clicked #{e[0]}' }\n"
+	    else
+		  element_code += "    #{e[0]}_current_text = elements[:#{e[0]}].text\n"
+		end
+      }	  
+	  element_code
+  end
+  
 end
 
 TestWindow.new

data/examples/absolute_positioning.rb

@@ -2,11 +2,13 @@ require 'rubygems'
 require 'sane'
 require __DIR__ +  '/../lib/simple-ruby-gui-creator.rb'
 
-a = ParseTemplate::JFramer.new
+a = SimpleGuiCreator::ParseTemplate.new
 a.parse_setup_string <<EOL
 
+
 | [a button:button_name,width=100,height=100,abs_x=50,abs_y=50] [a third button]
 | [another button:button_name2] [another button:button_name4]|
 | [another button:button_name3] |
 
+
 EOL

data/lib/simple_gui_creator/jframe_helper_methods.rb

@@ -0,0 +1,120 @@
+require 'java'
+
+# helper/english friendlier methods for JFrame
+
+class javax::swing::JFrame
+
+   java_import javax::swing::JFrame # so we can refer to it as JFrame, without polluting the global namespace
+
+   java_import java.awt.event.ActionListener
+   
+   #class StateListener
+   #  include java.awt.event.WindowListener	
+   #end
+  
+   class CloseListener < java.awt.event.WindowAdapter
+     def initialize parent, &block
+	   super()
+	   @parent = parent
+	   @block = block
+	 end
+	 
+     def windowClosed event # sometimes this, sometimes the other...
+	   if @block
+	    b = @block # force avoid calling it twice, since swing does seem to call this method twice, bizarrely
+		@block = nil
+		b.call
+	   end
+	 end
+	 
+	 def windowClosing event
+	    #p 'windowClosing' # hitting the X goes *only* here, and twice? ok this is messed up
+		@parent.dispose
+	 end
+   end
+   
+   def initialize *args
+     super(*args) # we do always get here...
+	 # because we do this, you should *not* have to call the unsafe:
+	 # setDefaultCloseOperation(EXIT_ON_CLOSE)
+	 # which basically does a System.exit(0) when the last jframe closes. Yikes jdk, yikes.	 
+	 #addWindowListener(CloseListener.new(self))
+     dispose_on_close # don't keep running after being closed, and prevent the app from exiting! whoa!
+   end   
+   
+   def close
+     dispose # <sigh>
+   end
+   
+   def dispose_on_close
+     setDefaultCloseOperation JFrame::DISPOSE_ON_CLOSE
+   end
+   
+   def after_closed &block
+	 addWindowListener(CloseListener.new(self) {
+	   block.call 
+	 })
+   end
+   
+   def after_minimized &block
+    addWindowStateListener {|e|
+	  if e.new_state == java::awt::Frame::ICONIFIED
+        block.call	  
+	  else
+	    #puts 'non restore'
+	  end
+	}
+   end
+      
+   def after_restored_either_way &block
+    addWindowStateListener {|e|
+	  if e.new_state == java::awt::Frame::NORMAL
+        block.call	  
+	  else
+	    #puts 'non restore'
+	  end
+	}
+   end
+  
+  
+   def bring_to_front # kludgey...but said to work for swing frames...
+    java.awt.EventQueue.invokeLater{
+      unminimize
+      toFront
+      repaint
+    }      
+   end
+   
+   def minimize
+     setState(java.awt.Frame::ICONIFIED)
+   end
+  
+   def restore
+     setState(java.awt.Frame::NORMAL) # this line is probably enough, but do more just in case...
+     #setVisible(true)
+   end
+  
+   alias unminimize restore
+   
+   def maximize
+     setExtendedState(JFrame::MAXIMIZED_BOTH)
+   end
+   
+   # avoid jdk6 always on top bug http://betterlogic.com/roger/2012/04/jframe-setalwaysontop-doesnt-work-after-using-joptionpane/
+   alias always_on_top_original always_on_top=
+  
+   def always_on_top=bool 
+    always_on_top_original false
+    always_on_top_original bool
+   end
+
+   def set_always_on_top bool
+      always_on_top=bool
+   end
+  
+   def setAlwaysOnTop bool
+      always_on_top=bool
+   end
+  
+  end # class JFrame
+  

data/lib/simple_gui_creator/parse_template.rb

@@ -1,20 +1,14 @@
 require 'java'
 
-require File.dirname(__FILE__) + '/simple_gui_creator.rb' # for JFrame#close, etc., basically required as of today..
+require File.dirname(__FILE__) + '/swing_helpers.rb' # for JButton#on_clicked, etc.,
 
-# for docs, see the README/specs
-module ParseTemplate
-
-  def _dgb
-		  require 'rubygems'
-		  require 'ruby-debug'
-		  debugger
-  end
+# for documentation, see the README file
+module SimpleGuiCreator
 
   include_package 'javax.swing'; [JFrame, JPanel, JButton, JTextArea, JLabel, UIManager, JScrollPane]
   java_import java.awt.Font
   
-  class JFramer < JFrame
+  class ParseTemplate < JFrame
     
     def initialize 
       super()
@@ -204,4 +198,11 @@ module ParseTemplate
   
   end
 
+  private  
+  def _dgb
+		  require 'rubygems'
+		  require 'ruby-debug'
+		  debugger
+  end
+
 end

data/lib/simple_gui_creator/simple_gui_creator.rb

@@ -15,271 +15,27 @@ This file is part of Sensible Cinema.
     You should have received a copy of the GNU General Public License
     along with Sensible Cinema.  If not, see <http://www.gnu.org/licenses/>.
 =end
-require 'java'
-require 'sane' # gem dependency
-
-module SimpleGuiCreator
-  
- include_package 'javax.swing'
- # will use  these constants (http://jira.codehaus.org/browse/JRUBY-5107)
- [JProgressBar, JButton, JFrame, JLabel, JPanel, JOptionPane,
-   JFileChooser, JComboBox, JDialog, SwingUtilities, JSlider, JPasswordField, UIManager] 
-   
- include_package 'java.awt'
- [FlowLayout, Font, BorderFactory, BorderLayout, FileDialog]
- 
- java_import java.awt.event.ActionListener
- 
- JFile = java.io.File # no import for this one...
 
- class JOptionPane
-    JOptionReturnValuesTranslator = {0 => :yes, 1 => :no, 2 => :cancel, -1 => :exited}
-    
-    # accepts :yes => "yes text", :no => "no text"
-    # returns  :yes :no :cancel or :exited
-    # you must specify text for valid options.
-    # example, if you specify :cancel => 'cancel' then it won't raise if they cancel
-    # raises if they select cancel or exit, unless you pass in :exited => true as an option
-    def self.show_select_buttons_prompt message, names_hash = {}
-      names_hash[:yes] ||= 'Yes'
-      names_hash[:no] ||= 'No'
-      # ok ?
-      old = ['no', 'yes', 'ok'].map{|name| 'OptionPane.' + name + 'ButtonText'}.map{|name| [name, UIManager.get(name)]}
-      if names_hash[:yes]
-        UIManager.put("OptionPane.yesButtonText", names_hash[:yes])
-      end
-      if names_hash[:no]
-        UIManager.put("OptionPane.noButtonText", names_hash[:no])
-      end
-      # if names_hash[:ok] # ???
-      #   UIManager.put("OptionPane.okButtonText", names_hash[:ok])
-      # end
-      if names_hash[:cancel]
-        UIManager.put("OptionPane.noButtonText", names_hash[:cancel])
-      end
-      title = message.split(' ')[0..5].join(' ')
-      returned = JOptionPane.showConfirmDialog SwingHelpers.get_always_on_top_frame, message, title, JOptionPane::YES_NO_CANCEL_OPTION
-      SwingHelpers.close_always_on_top_frame
-      old.each{|name, old_setting| UIManager.put(name, old_setting)}
-      out = JOptionReturnValuesTranslator[returned]
-      if !out || !names_hash.key?(out)
-        raise 'canceled or exited an option prompt:' + out.to_s + ' ' + message
-      end
-      out
-    end
-    
- end
-
- class JButton
- 
-   def initialize(*args)
-    super(*args)
-    set_font Font.new("Tahoma", Font::PLAIN, 11)
-   end
-  
-   def on_clicked &block
-     raise unless block # sanity check
-     @block = block
-     add_action_listener do |e|
-       begin
-         block.call
-       rescue Exception => e
-             # e.backtrace[0] == "/Users/rogerdpack/sensible-cinema/lib/gui/create.rb:149:in `setup_create_buttons'"
-             bt_out = ""
-             for line in e.backtrace[0..1]
-               backtrace_pieces = line.split(':')
-               backtrace_pieces.shift if OS.doze? # ignore drive letter
-	       filename = backtrace_pieces[0].split('/')[-1]
-	       line_number =  backtrace_pieces[1]
-               bt_out += " #{filename}:#{line_number}" 
-             end
-         puts 'button cancelled somehow!' + e.to_s + ' ' + get_text[0..50] + bt_out
-         if $VERBOSE
-          puts "got fatal exception thrown in button [aborted] #{e} #{e.class} #{e.backtrace[0]}"
-          puts e.backtrace, e
-         end
-       end        
-     end
-     self
-   end
-  
-   def simulate_click
-     @block.call
-   end
-  
-   def tool_tip= text
-     if text
-       text = "<html>" + text + "</html>"
-       text = text.gsub("\n", "<br/>")
-     end
-     self.set_tool_tip_text text   
-   end
-  
-   def enable
-    set_enabled true
-   end
-  
-   def disable
-    set_enabled false
-   end
-  
- end
+require 'java'
+#require 'sane' # gem dependency
+require File.dirname(__FILE__) + '/swing_helpers'
 
- ToolTipManager.sharedInstance().setDismissDelay(10000) # these are way too fast normally
+$simple_creator_show_console_prompts = true
 
- class JFrame
-  
-   #class StateListener
-   #  include java.awt.event.WindowListener	
-   #end
-  
-   class CloseListener < java.awt.event.WindowAdapter
-     def initialize parent, &block
-	   super()
-	   @parent = parent
-	   @block = block
-	 end
-	 
-     def windowClosed event # sometimes this, sometimes the other...
-	   if @block
-	    b = @block # force avoid calling it twice, since swing does seem to call this method twice, bizarrely
-		@block = nil
-		b.call
-	   end
-	 end
-	 
-	 def windowClosing event
-	    #p 'windowClosing' # hitting the X goes *only* here, and twice? ok this is messed up
-		@parent.dispose
-	 end
-   end
-   
-   def initialize *args
-     super(*args) # we do always get here...
-	 # because we do this, you should *not* have to call the unsafe:
-	 # setDefaultCloseOperation(EXIT_ON_CLOSE)
-	 # which basically does a System.exit(0) when the last jframe closes. Yikes jdk, yikes.	 
-	 #addWindowListener(CloseListener.new(self))
-     dispose_on_close # don't keep running after being closed, and prevent the app from exiting! whoa!
-   end   
-   
-   def close
-     dispose # <sigh>
-   end
-   
-   def dispose_on_close
-     setDefaultCloseOperation JFrame::DISPOSE_ON_CLOSE
-   end
-   
-   def after_closed &block
-	 addWindowListener(CloseListener.new(self) {
-	   block.call 
-	 })
-   end
-   
-   def after_minimized &block
-    addWindowStateListener {|e|
-	  if e.new_state == java::awt::Frame::ICONIFIED
-        block.call	  
-	  else
-	    #puts 'non restore'
-	  end
-	}
-   end
-      
-   def after_restored_either_way &block
-    addWindowStateListener {|e|
-	  if e.new_state == java::awt::Frame::NORMAL
-        block.call	  
-	  else
-	    #puts 'non restore'
-	  end
-	}
-   end
-  
-  
-   def bring_to_front # kludgey...but said to work for swing frames...
-    java.awt.EventQueue.invokeLater{
-      unminimize
-      toFront
-      repaint
-    }      
-   end
-   
-   def minimize
-     setState(java.awt.Frame::ICONIFIED)
-   end
-  
-   def restore
-     setState(java.awt.Frame::NORMAL) # this line is probably enough, but do more just in case...
-     #setVisible(true)
-   end
-  
-   alias unminimize restore
-   
-   def maximize
-     setExtendedState(JFrame::MAXIMIZED_BOTH)
-   end
-   
-   # avoid jdk6 always on top bug http://betterlogic.com/roger/2012/04/jframe-setalwaysontop-doesnt-work-after-using-joptionpane/
-   alias always_on_top_original always_on_top=
-  
-   def always_on_top=bool 
-    always_on_top_original false
-    always_on_top_original bool
-   end
+module SimpleGuiCreator
 
-   def set_always_on_top bool
-      always_on_top=bool
-   end
+    JFile = java.io.File # no import for this one, so we don't lose access to Ruby's File class
   
-   def setAlwaysOnTop bool
-      always_on_top=bool
-   end
-  
-  end # class JFrame
-  
-  def self.open_url_to_view_it_non_blocking url
+    def self.open_url_to_view_it_non_blocking url
       raise 'non http url?' unless url =~ /^http/i
       if OS.windows?
         system("start #{url.gsub('&', '^&')}") # LODO would launchy help/work here with the full url?
       else
         system "#{OS.open_file_command} \"#{url}\""
-        sleep 2 # disallow exiting immediately after...LODO
+        sleep 2 # disallow any program exiting immediately...which can make the window *not* popup in certain circumstances...LODO fix [is it windows only?]
       end
     end
   
-  # wrapped in sensible-cinema-base
-  class JFileChooser
-    # also set_current_directory et al...
-    
-    # raises on failure...
-    def go show_save_dialog_instead = false
-      if show_save_dialog_instead
-        success = show_save_dialog nil
-      else
-        success = show_open_dialog nil
-      end
-      unless success == Java::javax::swing::JFileChooser::APPROVE_OPTION
-        java.lang.System.exit 1 # kills background proc...but we shouldn't let them do stuff while a background proc is running, anyway
-      end
-      get_selected_file.get_absolute_path
-    end
-    
-    # match FileDialog methods...
-    def set_title x
-      set_dialog_title x
-    end
-    
-    def set_file f
-      set_selected_file JFile.new(f)
-    end
-    
-    alias setFile set_file
-
-  end
-
-
     # choose a file that may or may not exist yet...
     def self.new_nonexisting_or_existing_filechooser_and_go title = nil, default_dir = nil, default_filename = nil # within JFileChooser class for now...
       out = JFileChooser.new
@@ -291,6 +47,9 @@ module SimpleGuiCreator
         out.set_file default_filename
       end
       got = out.go true
+	  if !got
+	    raise "did not select anything #{title} #{default_dir} #{default_filename}"
+	  end
 	  got
     end
 	
@@ -308,7 +67,7 @@ module SimpleGuiCreator
 	  while(!found_non_exist) 
         got = out.go true
 		if(File.exist? got) 
-		  SwingHelpers.show_blocking_message_dialog 'this file already exists, choose a new filename ' + got		  
+		  SimpleGuiCreator.show_blocking_message_dialog 'this file already exists, choose a new filename ' + got		  
 		else
 		 found_non_exist = true
 		end
@@ -317,33 +76,20 @@ module SimpleGuiCreator
     end
 
 	def self.new_existing_dir_chooser_and_go title=nil, default_dir = nil
-    chooser = JFileChooser.new;
-    chooser.setCurrentDirectory(JFile.new default_dir) if default_dir
-    chooser.set_title title
-    chooser.setFileSelectionMode(JFileChooser::DIRECTORIES_ONLY)
-    chooser.setAcceptAllFileFilterUsed(false)
-    chooser.set_approve_button_text "Select This Directory"
-
-    if (chooser.showOpenDialog(nil) == JFileChooser::APPROVE_OPTION)
-     return chooser.getSelectedFile().get_absolute_path
-    else
-     raise "No dir selected " + title.to_s
-    end
-  end
-
-  # awt...the native looking one...
-  class FileDialog
-    def go
-      show
-	  dispose # allow app to exit :P
-      if get_file 
-        # they picked something...
-        File.expand_path(get_directory + '/' + get_file)
+      chooser = JFileChooser.new;
+      chooser.setCurrentDirectory(JFile.new default_dir) if default_dir
+      chooser.set_title title
+      chooser.setFileSelectionMode(JFileChooser::DIRECTORIES_ONLY)
+      chooser.setAcceptAllFileFilterUsed(false)
+      chooser.set_approve_button_text "Select This Directory"
+
+      if (chooser.showOpenDialog(nil) == JFileChooser::APPROVE_OPTION)
+        return chooser.getSelectedFile().get_absolute_path
       else
-        nil
+       raise "No dir selected " + title.to_s
       end
     end
-  end
+
   
   # this doesn't have an "awesome" way to force existence, just loops
   def self.new_previously_existing_file_selector_and_go title, use_this_dir = nil
@@ -372,51 +118,10 @@ module SimpleGuiCreator
     got
   end
     
-  class NonBlockingDialog < JDialog
-    def initialize title_and_display_text, close_button_text = 'Close'
-      super nil # so that set_title will work
-      lines = title_and_display_text.split("\n")
-      set_title lines[0]
-      get_content_pane.set_layout nil
-      lines.each_with_index{|line, idx|
-        jlabel = JLabel.new line
-        jlabel.set_bounds(10, 15*idx, 550, 24)
-        get_content_pane.add jlabel
-      }
-      close = JButton.new( close_button_text ).on_clicked {
-        self.dispose
-      }
-      number_of_lines = lines.length
-      close.set_bounds(125,30+15*number_of_lines, close_button_text.length * 15,25)
-      get_content_pane.add close
-      set_size 550, 100+(15*number_of_lines) # XXX variable width? or use swing build in better?
-      set_visible true
-      setDefaultCloseOperation JFrame::DISPOSE_ON_CLOSE
-      setLocationRelativeTo nil # center it on the screen
-      
-    end
-    alias close dispose # yikes
-  end
-  
-  def self.get_always_on_top_frame
-    fake_frame = JFrame.new
-    fake_frame.setUndecorated true # so we can have a teeny [invisible] window
-    fake_frame.set_size 1,1
-    fake_frame.set_location 300,300 # so that option pane's won't appear upper left
-    #fake_frame.always_on_top = true
-    fake_frame.show
-    @fake_frame = fake_frame
-  end
-  
-  def self.close_always_on_top_frame
-    @fake_frame.close
-  end
-  
   # prompts for user input, raises if they cancel the prompt or if they enter nothing
   def self.get_user_input(message, default = '', cancel_or_blank_ok = false)
     p 'please enter the information in the prompt:' + message[0..50] + '...'
-    received = javax.swing.JOptionPane.showInputDialog(get_always_on_top_frame, message, default)
-    close_always_on_top_frame
+    received = javax.swing.JOptionPane.showInputDialog(nil, message, default)
     if !cancel_or_blank_ok
       raise 'user cancelled input prompt ' + message unless received
   	  raise 'did not enter anything?' + message unless received.present?
@@ -425,18 +130,30 @@ module SimpleGuiCreator
     p 'received answer:' + received
     received
   end
+  
+ def self.to_filename string
+  if File::ALT_SEPARATOR
+    File.expand_path(string).gsub('/', File::ALT_SEPARATOR)
+  else
+    File.expand_path(string)
+  end
+ end
 
   def self.show_in_explorer filename_or_path
     raise 'nonexistent file cannot reveal in explorer?' + filename_or_path unless File.exist?(filename_or_path)
+    filename_or_path = '"' + to_filename(filename_or_path.gsub('"', '\\"')) + '"' # quotify, escape it, FWIW untested
     if OS.doze?
       begin
-        c = "explorer /e,/select,#{filename_or_path.to_filename}" 
-        system c # command returns immediately...so system is ok
+        c = "explorer /e,/select,#{filename_or_path}" 
+        system c # command returns immediately...so calling system on it is ok
       rescue => why_does_this_happen_ignore_this_exception_it_probably_actually_succeeded
+	    3 # for debugging so it can break here
       end
     elsif OS.mac?
-      c = "open -R " + "\"" + filename_or_path.to_filename + "\""
-      puts c
+      c = "open -R " + "\"" + filename_or_path + "\""
+      system c # returns immediately
+    elsif OS.linux?
+      c = "nohup nautilus --no-desktop #{filename_or_path}" 
       system c
     else
       raise 'os reveal unsupported?'
@@ -444,10 +161,9 @@ module SimpleGuiCreator
   end
   
   def self.show_blocking_message_dialog message, title = message.split("\n")[0], style= JOptionPane::INFORMATION_MESSAGE
-    puts "please use GUI window popup... #{message} ..."
-    JOptionPane.showMessageDialog(get_always_on_top_frame, message, title, style)
+    puts "please use GUI window popup... #{message} ..." if $simple_creator_show_console_prompts
+    JOptionPane.showMessageDialog(nil, message, title, style)
     # the above has no return value <sigh> so just return true
-    close_always_on_top_frame
     true
   end
   
@@ -466,8 +182,7 @@ module SimpleGuiCreator
   def self.get_password_input text
     p 'please enter password at prompt'
     pwd = JPasswordField.new(10)
-    got = JOptionPane.showConfirmDialog(get_always_on_top_frame, pwd, text, JOptionPane::OK_CANCEL_OPTION) < 0
-    close_always_on_top_frame
+    got = JOptionPane.showConfirmDialog(nil, pwd, text, JOptionPane::OK_CANCEL_OPTION) < 0
     if got
       raise 'cancelled ' + text
     else
@@ -480,63 +195,10 @@ module SimpleGuiCreator
     end
   end
 
-  class DropDownSelector < JDialog # JDialog is blocking...
-    
-    def initialize parent, options_array, prompt_for_top_entry
-      super parent, true
-      set_title prompt_for_top_entry
-      @drop_down_elements = options_array
-      @selected_idx = nil
-      box = JComboBox.new
-      box.add_action_listener do |e|
-        idx = box.get_selected_index
-        if idx != 0
-          # don't count choosing the first as a real entry
-          @selected_idx = box.get_selected_index - 1
-          dispose
-        end
-      end
-
-      box.add_item @prompt = prompt_for_top_entry # put something in index 0
-      options_array.each{|drive|
-        box.add_item drive
-      }
-      add box
-      pack # how do you get this arbitrary size? what the...
-      
-    end
-    
-    # returns index from initial array that they selected, or raises if they hit the x on it
-    def go_selected_index
-      puts 'select from dropdown window'
-      show # blocks...
-      raise 'did not select, exited early ' + @prompt unless @selected_idx
-      @selected_idx
-    end
-    
-    def go_selected_value
-      puts 'select from dropdown window ' + @drop_down_elements[-1] + ' ...'
-      show # blocks...
-      raise 'did not select, exited early ' + @prompt unless @selected_idx
-      @drop_down_elements[@selected_idx]
-    end
-    
-  end
-
   def self.hard_exit!; java::lang::System.exit 0; end
   
   def self.invoke_in_gui_thread # sometimes I think I need this, but it never seems to help
     SwingUtilities.invoke_later { yield }
   end
 
-end
-
-class String
- def to_filename
-  if File::ALT_SEPARATOR
-    File.expand_path(self).gsub('/', File::ALT_SEPARATOR)
-  else
-    File.expand_path(self)
-  end
- end
-end
+end

data/lib/simple_gui_creator/swing_helpers.rb

@@ -0,0 +1,221 @@
+require 'sane' # require_relative
+require_relative 'jframe_helper_methods' # jframe stuff gets its own file, it's so much.
+
+module SimpleGuiCreator
+  
+ include_package 'javax.swing'
+ # and use  these constants (bug: http://jira.codehaus.org/browse/JRUBY-5107)
+ [JProgressBar, JButton, JLabel, JPanel, JOptionPane,
+   JFileChooser, JComboBox, JDialog, SwingUtilities, JSlider, JPasswordField, UIManager] 
+   
+ include_package 'java.awt'; [Font, FileDialog] 
+ 
+ class JOptionPane
+    JOptionReturnValuesTranslator = {0 => :yes, 1 => :no, 2 => :cancel, -1 => :exited}
+    
+    # accepts :yes => "yes text", :no => "no text"
+    # returns  :yes :no :cancel or :exited
+    # you must specify text for valid options.
+    # example, if you specify :cancel => 'cancel' then it won't raise if they cancel
+    # raises if they select cancel or exit, unless you pass in :exited => true as an option
+    def self.show_select_buttons_prompt message, names_hash = {}
+      names_hash[:yes] ||= 'Yes'
+      names_hash[:no] ||= 'No'
+      # ok ?
+      old = ['no', 'yes', 'ok'].map{|name| 'OptionPane.' + name + 'ButtonText'}.map{|name| [name, UIManager.get(name)]}
+      if names_hash[:yes]
+        UIManager.put("OptionPane.yesButtonText", names_hash[:yes])
+      end
+      if names_hash[:no]
+        UIManager.put("OptionPane.noButtonText", names_hash[:no])
+      end
+      # if names_hash[:ok] # ???
+      #   UIManager.put("OptionPane.okButtonText", names_hash[:ok])
+      # end
+      if names_hash[:cancel]
+        UIManager.put("OptionPane.noButtonText", names_hash[:cancel])
+      end
+      title = message.split(' ')[0..5].join(' ')
+      returned = JOptionPane.showConfirmDialog nil, message, title, JOptionPane::YES_NO_CANCEL_OPTION
+      old.each{|name, old_setting| UIManager.put(name, old_setting)}
+      out = JOptionReturnValuesTranslator[returned]
+      if !out || !names_hash.key?(out)
+        raise 'canceled or exited an option prompt:' + out.to_s + ' ' + message
+      end
+      out
+    end
+    
+ end
+
+ class JButton
+ 
+   def initialize(*args)
+    super(*args)
+    set_font Font.new("Tahoma", Font::PLAIN, 11)
+   end
+  
+   def on_clicked &block
+     raise unless block # sanity check
+     @block = block
+     add_action_listener do |e|
+       begin
+         block.call
+       rescue Exception => e
+             # e.backtrace[0] == "/Users/rogerdpack/sensible-cinema/lib/gui/create.rb:149:in `setup_create_buttons'"
+             bt_out = ""
+             for line in e.backtrace[0..1]
+               backtrace_pieces = line.split(':')
+               backtrace_pieces.shift if OS.doze? && backtrace_pieces[1..1] == ':' # ignore drive letter colon split, which isn't always there oddly enough [1.8 mode I guess]
+	       filename = backtrace_pieces[0].split('/')[-1]
+	       line_number =  backtrace_pieces[1]
+               bt_out += " #{filename}:#{line_number}" 
+             end
+         puts 'button cancelled somehow!' + e.to_s + ' ' + get_text[0..50] + bt_out if $simple_creator_show_console_prompts
+         if $VERBOSE
+          puts "got fatal exception thrown in button [aborted] #{e} #{e.class} #{e.backtrace[0]}" if $simple_creator_show_console_prompts
+          puts e.backtrace, e if $simple_creator_show_console_prompts
+         end
+       end        
+     end
+     self
+   end
+  
+   def simulate_click
+     @block.call
+   end
+  
+   def tool_tip= text
+     if text
+       text = "<html>" + text + "</html>"
+       text = text.gsub("\n", "<br/>")
+     end
+     self.set_tool_tip_text text   
+   end
+  
+   def enable
+    set_enabled true
+   end
+  
+   def disable
+    set_enabled false
+   end
+  
+ end
+
+ ToolTipManager.sharedInstance().setDismissDelay(10000) # these are way too fast normally
+ 
+   class JFileChooser
+    # also set_current_directory et al...
+    
+    # raises on failure...
+    def go show_save_dialog_instead = false
+      if show_save_dialog_instead
+        success = show_save_dialog nil
+      else
+        success = show_open_dialog nil
+      end
+      unless success == Java::javax::swing::JFileChooser::APPROVE_OPTION
+        return nil
+      end
+      get_selected_file.get_absolute_path
+    end
+    
+    # match FileDialog methods...
+    def set_title x
+      set_dialog_title x
+    end
+    
+    def set_file f
+      set_selected_file JFile.new(f)
+    end
+    
+    alias setFile set_file
+  end
+
+
+  # awt...the native looking one...
+  class FileDialog
+    def go
+      show
+	  dispose # allow app to exit :P
+      if get_file 
+        # they picked something...
+        File.expand_path(get_directory + '/' + get_file)
+      else
+        nil
+      end
+    end
+  end
+ 
+ 
+  class NonBlockingDialog < JDialog
+    def initialize title_and_display_text, close_button_text = 'Close'
+      super nil # so that set_title will work
+      lines = title_and_display_text.split("\n")
+      set_title lines[0]
+      get_content_pane.set_layout nil
+      lines.each_with_index{|line, idx|
+        jlabel = JLabel.new line
+        jlabel.set_bounds(10, 15*idx, 550, 24)
+        get_content_pane.add jlabel
+      }
+      close = JButton.new( close_button_text ).on_clicked {
+        self.dispose
+      }
+      number_of_lines = lines.length
+      close.set_bounds(125,30+15*number_of_lines, close_button_text.length * 15,25)
+      get_content_pane.add close
+      set_size 550, 100+(15*number_of_lines) # XXX variable width? or use swing build in better?
+      set_visible true
+      setDefaultCloseOperation JFrame::DISPOSE_ON_CLOSE
+      setLocationRelativeTo nil # center it on the screen
+      
+    end
+    alias close dispose # yikes
+  end
+
+
+  class DropDownSelector < JDialog # JDialog is blocking...
+    
+    def initialize parent, options_array, prompt_for_top_entry
+      super parent, true
+      set_title prompt_for_top_entry
+      @drop_down_elements = options_array
+      @selected_idx = nil
+      box = JComboBox.new
+      box.add_action_listener do |e|
+        idx = box.get_selected_index
+        if idx != 0
+          # don't count choosing the first as a real entry
+          @selected_idx = box.get_selected_index - 1
+          dispose
+        end
+      end
+
+      box.add_item @prompt = prompt_for_top_entry # put something in index 0
+      options_array.each{|drive|
+        box.add_item drive
+      }
+      add box
+      pack # how do you get this arbitrary size? what the...
+      
+    end
+    
+    # returns index from initial array that they selected, or raises if they hit the x on it
+    def go_selected_index
+      puts 'select from dropdown window' if $simple_creator_show_console_prompts
+      show # blocks...
+      raise 'did not select, exited early ' + @prompt unless @selected_idx
+      @selected_idx
+    end
+    
+    def go_selected_value
+      puts 'select from dropdown window ' + @drop_down_elements[-1] + ' ...' if $simple_creator_show_console_prompts
+      show # blocks...
+      raise 'did not select, exited early ' + @prompt unless @selected_idx
+      @drop_down_elements[@selected_idx]
+    end
+    
+  end
+  
+end

data/lib/simple_gui_creator.rb

@@ -1,6 +1,5 @@
-# just autoload everything always :)
 
-module SimpleGuiBootStrap
+module SimpleGuiCreator
   def self.snake_case string
     string = string.to_s.dup
     string.gsub!(/::/, '/')
@@ -12,7 +11,14 @@ module SimpleGuiBootStrap
   end
 end
 
-for clazz in [:DriveInfo, :MouseControl, :ParseTemplate, :PlayAudio, :PlayMp3Audio, :RubyClip, :SimpleGuiCreator]
-  new_path = File.dirname(__FILE__) + '/simple_gui_creator/' + SimpleGuiBootStrap.snake_case(clazz) + '.rb'
+# some autoloads, in case they save any load time...
+for clazz in [:DriveInfo, :MouseControl, :PlayAudio, :PlayMp3Audio, :RubyClip]
+  new_path = File.dirname(__FILE__) + '/simple_gui_creator/' + SimpleGuiCreator.snake_case(clazz) + '.rb'
   autoload clazz, new_path
+end
+
+require File.dirname(__FILE__) + '/simple_gui_creator/simple_gui_creator.rb'
+
+module SimpleGuiCreator
+  autoload :ParseTemplate, File.dirname(__FILE__) + '/simple_gui_creator/parse_template.rb'
 end

data/spec/parse_template.spec.rb

@@ -3,7 +3,7 @@ require File.dirname(__FILE__)+ '/common'
 describe ParseTemplate do
 
   def parse_string string
-    @frame = ParseTemplate::JFramer.new
+    @frame = SimpleGuiCreator::ParseTemplate.new
 	@frame.parse_setup_string(string)
 	@frame
   end

data/spec/swing_helpers.spec.rb

@@ -18,7 +18,8 @@ This file is part of Sensible Cinema.
 
 require File.expand_path(File.dirname(__FILE__) + '/common')
 
-module SwingHelpers
+module SimpleGuiCreator
+
  describe 'functionality' do
    puts "most of these require user interaction, sadly"
 
@@ -34,34 +35,34 @@ module SwingHelpers
   
   it "should be able to convert filenames well" do
     if OS.windows?
-      "a/b/c".to_filename.should == File.expand_path("a\\b\\c").gsub('/', "\\")
+      SimpleGuiCreator.to_filename("a/b/c").should == File.expand_path("a\\b\\c").gsub('/', "\\")
     else
-      "a/b/c".to_filename.should == File.expand_path("a/b/c")
+      SimpleGuiCreator.to_filename("a/b/c").should == File.expand_path("a/b/c")
     end
   end
 
   it "should reveal a file" do
     FileUtils.touch "a b"
-    SwingHelpers.show_in_explorer "a b"
+    SimpleGuiCreator.show_in_explorer "a b"
     Dir.mkdir "a dir" unless File.exist?('a dir')
-    SwingHelpers.show_in_explorer "a dir"
+    SimpleGuiCreator.show_in_explorer "a dir"
   end
 
   it "should reveal a url" do
-    SwingHelpers.open_url_to_view_it_non_blocking "http://www.google.com"
+    SimpleGuiCreator.open_url_to_view_it_non_blocking "http://www.google.com"
   end
   
   it "should select folders" do
-    raise unless File.directory?(c = SwingHelpers.new_existing_dir_chooser_and_go('hello', '.'))
+    raise unless File.directory?(c = SimpleGuiCreator.new_existing_dir_chooser_and_go('hello', '.'))
     p c
-    raise unless File.directory?(c = SwingHelpers.new_existing_dir_chooser_and_go)
+    raise unless File.directory?(c = SimpleGuiCreator.new_existing_dir_chooser_and_go)
     p c
   end
 
   it "should select nonexisting" do
     name = JFileChooser.new_nonexisting_filechooser_and_go 'should force you to select nonexisting..'
     raise if File.exist? name
-    name = SwingHelpers.new_previously_existing_file_selector_and_go 'should forc select existing file, try to select nonexist'
+    name = SimpleGuiCreator.new_previously_existing_file_selector_and_go 'should forc select existing file, try to select nonexist'
     raise unless File.exist? name # it forced them to retry 
   end
   

metadata

@@ -2,7 +2,7 @@
 name: simple_gui_creator
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors: 
   - rogerdpack
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-06-19 00:00:00 Z
+date: 2012-06-22 00:00:00 Z
 dependencies: 
   - !ruby/object:Gem::Dependency 
     name: sane
@@ -41,9 +41,11 @@ executables:
 extensions: []
 
 extra_rdoc_files: 
+  - ChangeLog
   - README
   - TODO
 files: 
+  - ChangeLog
   - README
   - Rakefile
   - TODO
@@ -53,6 +55,7 @@ files:
   - ext/jl1.0.1.jar
   - lib/simple_gui_creator.rb
   - lib/simple_gui_creator/drive_info.rb
+  - lib/simple_gui_creator/jframe_helper_methods.rb
   - lib/simple_gui_creator/mouse_control.rb
   - lib/simple_gui_creator/parse_template.rb
   - lib/simple_gui_creator/play_audio.rb
@@ -60,6 +63,7 @@ files:
   - lib/simple_gui_creator/ruby_clip.rb
   - lib/simple_gui_creator/simple_gui_creator.rb
   - lib/simple_gui_creator/storage.rb
+  - lib/simple_gui_creator/swing_helpers.rb
   - spec/common.rb
   - spec/diesel.mp3
   - spec/drive_info.spec.rb
@@ -102,7 +106,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.8.9
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Framework to ease in creation of ruby GUI apps. Makes designing windows a snap.