simple_gui_creator 0.1.4 → 0.2.0

data/ChangeLog

@@ -1,8 +1,10 @@
+0.2.0
+  add checkboxes, dropdowns, allow for more than one type on a line.
 
 0.1.4 fix gemspec
 
 0.1.3
-  same :)
+  same as 0.1.2 :)
 
 0.1.2
   better lookin' GUI :)

data/README

@@ -1,81 +1,122 @@
-This gem is meant to make GUI development in Ruby easy, and even fun.
+This gem is meant to make GUI development in Ruby apps trivial, 
+and easy to add to a project.
 
-You can specify "easy window layout" in ASCII text, example, if you have a layout like this:
+Basically it allows you to design your window GUI layout using 
+ASCII art-like text:
 
----------- A Title ---------------------------
-| [a button:button1]   [button text:button2] |
-| "some text2:text1"                         |
-----------------------------------------------
+---------------My Window Title--------------------------
+| [Click this button      :button1]                    |
+| [Click this button too! :button2]                    |
+--------------------------------------------------------
 
-It will create a window that has buttons and text "like that," with reasonable spacing.
+And then bind actions to ruby code, like this:
 
-Here's how:
->> frame = SimpleGuiCreator::ParseTemplate.new # or optionally subclass this instead, and call super in your constructor
+  elements[:button1].on_clicked { puts 'you clicked button1' }
+
+This makes the design part of the GUI much easier than trying to figure
+it out by trial and error, or "guessing" what swing or shoes are going to actually
+give for you in the end.  It comes with its own experimental "GUI Editor" for
+trying out designs on the fly.
+
+How to get it:
+
+# if you don't have jruby yet installed, for OS X or linux users (windows users use the jruby installer exe):
+$ rvm install jruby
+$ rvm use jruby
+
+# now install the gem.
+$ gem install simple_gui_creator
+
+# now run the GUI design editor
+$ jruby -S simple_gui_creator
+
+Here's how to code it:
+
+>> frame = SimpleGuiCreator::ParseTemplate.new # or optionally subclass this instead, and make sure to call super() in your constructor
 >> frame.parse_setup_filename 'some_filename'
 
-You can then program behaviors like this:
+Set behaviors like this:
 
 >> frame.elements['button1'].on_clicked { 
   SimpleGuiCreator.show_blocking_message_dialog "you clicked button1!" 
 }  
 
-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, and also:
+Having the layout as ASCII text separates views from 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 has proven quite nice at separating concerns.
+
+More complicated example:
+
+---------- Window Title ----------------------------------
+| [a button:button1]   [button text:button2]             |
+| "some text2:text1"                                     |
+| [An Editable Text Area with 4 rows:text_area]          |
+| [                                           ]          |
+| [                                           ]          |
+| [                                           ]          |
+| [Dropdown Default \/ :dropdown_name]                   |
+| [✓:checkbox_name] "Some text"                          |
+----------------------------------------------------------
+
+See the file spec/parse_template.spec.rb for examples of how to use each element.
+The window borders are also optional.
+
+The library also has helper methods for common GUI tasks, like:
+
+SimpleGuiCreator.show_blocking_message_dialog "A message box"
 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:
-
+Select-button prompt dialog:
 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
 
 etc. ...
 
-It provies a few helper methods to the ParseTemplate::JFramer (and JFrame) class, like:
+It provies a few helper methods to the SimpleGuiCreator::ParseTemplate (and JFrame) classes, like:
 
 #bring_to_front
 #minimize
+#maximize
 #restore
 #after_closed { ... }
 #after_minimized { ... }
 
-It has helpers to control/playback audio, like mp3's or wave's, starting/stopping asynchronously (see the files in the 'lib/ruby-easy-gui-creator' directory.
+See the files lib/simple_gui_creator/swing_helpers.rb and lib/simple_gui_creator/jframe_helper_methods.rb.
+
+It has helpers to playback/control audio files, like mp3's or wave's, starting/stopping asynchronously (see the files in the 'lib/simple_gui_creator/*' directory.
 It has helpers to set/get system clipboard contents.
-It has helpers to control/query the mouse (I use this, but don't know why anybody else ever would want to LOL).
+It has helpers to control/query the system mouse.
 It has helpers to query the current system for its DVD drives, be notified when disks are inserted/changed, etc.
 
 Feedback/feature requests welcome.
 http://groups.google.com/group/roger-projects,  roger-projects@googlegroups.com
-I'd even be happy to wrap other gui frameworks (currently jruby/swing only) with the same helper functions, if anybody wanted it.
-
-Enjoy!
-
-To install/use:
-
-$ gem install simple-ruby-gui-creator
-
->> require 'simple_gui_creator'
->> ... [see other examples]
+I'd even be happy to wrap other gui frameworks (currently jruby/swing only) with the same functionality, 
+if anybody wanted it.
 
 == 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
+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 using it looks like" (the bin/simple_gui_creator file) 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.
+Basically, see this README file, the examples folder, the "bin/*" file, and also the specs and lib files themselves.
 https://github.com/rdp/ruby_simple_gui_creator
 
 == Known problems ==
 
-Only allows single element types per line currently, like "all text" or "all buttons", but I'm working on it :)
-Only Jruby today, which can make loading time painful (hint: use splash screen).
+Only Jruby today, which can make load times painful (hint: use splash screen).
+
+= License ==
+
+MIT license (which is quite open), see accompanying file license.mit.txt.
+(C) 2012 Roger Pack

data/Rakefile

@@ -10,6 +10,7 @@ Jeweler::Tasks.new do |gem|
   gem.homepage = "https://github.com/rdp/ruby_simple_gui_creator"
   gem.authors = ["rogerdpack"]
   gem.add_dependency 'sane'
+  gem.add_dependency 'andand'
 #  gem.add_dependency 'launchy'
 end
 

data/TODO

@@ -1,12 +1,33 @@
-if the window goes too low, they can't see it all?
+see spec/parse_template.spec.rb for another (the real) TODO list
 
-gets h,w of trivial text areas *wrong* oh so wrong
+= maybe =
+
+ # LODO allow internal sub-boxes LOL
+ # LODO should pass the button through to on_clicked [?] or button with frame, too?
+ # LODO should be able to clear everything a button does or used to do...
+ # LODO a 'title managing' object LOL
+ # LODO rel_width=+100 or some odd
+ # LODO real documentation LOL
+ # buttons should require a code name :P
+
+if the window goes too low, they can't see it all, and it doesn't scroll?
+
+
+use native file handlers, the swing ones shuck with default save filenames
 
 = never =
 
-Parsing failed on line "      _                       _\t  \n" number: 5!
+HTML linked version. what the woot! LOL.
+  serialize the object...to RAM for now LOL.
+  pull the object from a db based on ID
+  instance_exec the [saved in RAM] proc
+    this would mean you can never "wildly redefine" action for pages though clicks...hmm...
+	or you could just pass "self" through...hmm...
+	whatever would be first pass ideal, just make that happen
+  
+fix: Parsing failed on line "      _                       _\t  \n" number: 5!
 
-use launchy for url's in linux [?]
+use launchy for at least url's in linux
 
 ask_should_allow_on_minimize {
 }

data/VERSION

@@ -1 +1 @@
-0.1.4
+0.2.0

data/lib/simple_gui_creator/parse_template.rb

@@ -1,11 +1,13 @@
+# encoding: UTF-8
 require 'java'
+require 'andand'
 
 require File.dirname(__FILE__) + '/swing_helpers.rb' # for JButton#on_clicked, etc.,
 
 # for documentation, see the README file
 module SimpleGuiCreator
 
-  include_package 'javax.swing'; [JFrame, JPanel, JButton, JTextArea, JLabel, UIManager, JScrollPane]
+  include_package 'javax.swing'; [JFrame, JPanel, JButton, JTextArea, JLabel, UIManager, JScrollPane, JCheckBox, JComboBox]
   java_import java.awt.Font
   
   class ParseTemplate < JFrame
@@ -16,193 +18,230 @@ module SimpleGuiCreator
       @elements = {}
       @panel.set_layout nil
       add @panel # why can't I just slap these down? panel? huh?
- 	  show # this always bites me...I new it up an it just doesn't appear...
-	end
-	
-	attr_reader :panel
-	attr_reader :elements
-	attr_accessor :original_title
-	attr_accessor :frame
-	
+       show # this always bites me...I new it up an it just doesn't appear...
+    end
+    
+    attr_reader :panel
+    attr_reader :elements
+    attr_accessor :original_title
+    attr_accessor :frame
+    
   def parse_setup_filename filename
     parse_setup_string File.read(filename)
-	self
+    self
   end
   
   # "matches" whatever the template string looks like...
   def parse_setup_string string
     @frame = self # LODO refactor
-	@current_y = 10
-	@window_max_x = 100
-	all_lines = string.lines.to_a
+    @current_y = 10
+    @window_max_x = 100
+    all_lines = string.lines.to_a
     all_lines.each_with_index{|line, idx|
-	  begin
-	  @current_x = 10
-	  if line =~ /\t/
-	    raise "sorry, tabs arent allowed, but you can request it"
-	  end
-	  button_line_regex = /\[(.*?)\]/
-	  #>> "|  [Setup Preferences:preferences] [Start:start] [Stop:stop] |" .scan button_line_regex
-	  #=> [["Setup Preferences:preferences"], ["Start:start"], ["Stop:stop"]]
-	  
-	  text_regex = /"([^"]+)"/ # "some text:name"
-	  blank_line_regex = /^\s*(|\|)\s+(|\|)\s*$/ # " | | " or just empty...
-	  title_regex = /\s*[-]+([\w ]+)[-]+\s*$/  # ----(a Title)---
-	  @current_line_height = 25
-	  
-	  if line =~ title_regex
-	    @frame.set_title $1 # done :)
-		@frame.original_title = $1.dup.freeze # freeze...LOL		
-	  elsif line =~ blank_line_regex
-   	    @current_y += @current_line_height
-	  elsif line =~ button_line_regex	   
-	    # button, or TextArea
-		cur_x = 0		
-		while cur_spot = (line[cur_x..-1] =~ button_line_regex)
-		  cur_spot += cur_x# we had only acted on a partial line, above, so add in the part we didn't do
-		  name = $1
-		  end_spot = cur_spot + name.length
-		  count_lines_below = 0
-		  matching_blank_text_area_string = '[' + ' '*(end_spot-cur_spot) + ']'
-		  empty_it_out = matching_blank_text_area_string.gsub(/[\[\]]/, '_') # can't actually blank it out...
-		  for line2 in all_lines[idx+1..-1]
-		    if line2[cur_spot..(end_spot+1)] == matching_blank_text_area_string
-			  line2[cur_spot, end_spot-cur_spot+2] = empty_it_out # :)
-			  count_lines_below += 1
-			else
-			  break
-			end
-		  end
-		  if count_lines_below > 0
-		    rows = count_lines_below + 1
-		    text_area = JTextArea.new(rows, name.split(':')[0].length)
-			text_area.text="\n"*rows
-			# width?
-			scrollPane = JScrollPane.new(text_area)
-            setup_element(scrollPane, name, scrollPane.getPreferredSize.height, text_area)
-		  else
-			button = JButton.new
-			setup_element(button, name)
-		  end		  
-		  cur_x = end_spot # creep forward within this line...
-		end		
- 		@current_y += @current_line_height
-	  elsif line =~ text_regex
-	    for name in line.scan(text_regex)
-	      label = JLabel.new
-		  setup_element(label, name[0])
-        end
-	    @current_y += @current_line_height
-	  end
-	  # build in realtime LOL
-	  @frame.set_size @window_max_x + 25, @current_y + 40	  
-	  rescue
-	    puts "Parsing failed on line #{line.inspect} number: #{idx+1}!"
-		raise
-	  end
-	}
+      begin
+      @current_x = 10
+      if line =~ /\t/
+        raise "sorry, tabs arent allowed, but you can request it"
+      end
+      button_line_regex = /\[(.*?)\]/
+      #>> "|  [Setup Preferences:preferences] [Start:start] [Stop:stop] |" .scan button_line_regex
+      #=> [["Setup Preferences:preferences"], ["Start:start"], ["Stop:stop"]]
+      
+      text_regex = /"([^"]+)"/ # "some text:name"
+      blank_line_regex = /^\s*(|\|)\s+(|\|)\s*$/ # matches " | | " or just empty...
+      title_regex = /\s*[-]+([\w ]+)[-]+\s*$/  # ----(a Title)---
+      @current_line_height = 25
+      
+      if line =~ title_regex
+        @frame.set_title $1 # done :)
+        @frame.original_title = $1.dup.freeze # freeze...LOL        
+      elsif line =~ blank_line_regex
+        @current_y += @current_line_height
+      else
+        # attempt an element line
+        cur_x = 0        
+        while next_match = closest_next_regex_match([button_line_regex, text_regex], line[cur_x..-1])
+          cur_spot = line[cur_x..-1] =~ next_match
+          cur_spot += cur_x # we had only acted on a partial line, above, so add in the part we didn't do, to get the right offset number
+          captured = $1
+          end_spot = cur_spot + captured.length
+          if next_match == button_line_regex
+            handle_button_at_current captured, cur_spot, end_spot, all_lines, idx
+          elsif next_match == text_regex
+            label = JLabel.new
+            setup_element(label, captured)            
+          end
+          cur_x = end_spot
+        end        
+        @current_y += @current_line_height
+      end
+      
+      # build in realtime LOL
+      @frame.set_size @window_max_x + 25, @current_y + 40      
+      rescue
+        puts "Parsing failed on line #{line.inspect} number: #{idx+1}!"
+        raise
+      end
+    }
     self
   end
   
   private
   
+  def closest_next_regex_match options, line
+    mapped = options.map{|option| line =~ option}
+    best = 10000
+    mapped.each{|number| best = [best, number].min if number}
+    if best == 10000
+      return nil
+    else
+      return options[mapped.index(best)] # yikes that was hard
+    end
+  end
+  
+  def handle_button_at_current captured, cur_spot, end_spot, all_lines, idx
+    count_lines_below = 0
+    matching_blank_text_area_string = '[' + ' '*(end_spot-cur_spot) + ']'
+    empty_it_out = matching_blank_text_area_string.gsub(/[\[]/, '_') # can't actually remove it...
+    for line2 in all_lines[idx+1..-1]
+      if line2[cur_spot..(end_spot+1)] == matching_blank_text_area_string
+        line2[cur_spot, end_spot-cur_spot+2] = empty_it_out # :)
+        count_lines_below += 1
+      else
+        break
+      end
+    end
+    text, code_name_with_attrs = split_int_text_name_and_code captured
+    text.strip! # hope we don't care for buttons...for now...
+    if count_lines_below > 0
+      rows = count_lines_below + 1 # at least 2...
+      text_area = JTextArea.new(rows, captured.split(':')[0].length)
+      text_area.text="\n"*rows
+      # width?
+      scrollPane = JScrollPane.new(text_area)
+      setup_element(scrollPane, captured, scrollPane.getPreferredSize.height, text_area)
+    elsif text == "✓"
+      check_box = JCheckBox.new
+      setup_element(check_box, ':' + code_name_with_attrs, nil, check_box, check_box.getPreferredSize.width)
+    elsif text.end_with?("\\/") || text.end_with?("▼") # dropdowns
+      drop_down = JComboBox.new
+      if text.end_with?("▼")      
+        initial_value = text = text.gsub(/▼$/, '')
+      else
+        initial_value = text[0..-3].strip
+      end
+      if initial_value.present?
+        drop_down.add_item initial_value.strip # set the top line as default
+      end
+      setup_element drop_down, ':' + code_name_with_attrs, nil, drop_down, drop_down.getPreferredSize.width
+    else
+      # a "normal" button
+      button = JButton.new
+      setup_element(button, captured)
+    end
+  end
+  
   def get_text_width text
     get_text_dimentia(text).width
   end
   
   def get_text_dimentia text
-	font = UIManager.getFont("Label.font")
+    font = UIManager.getFont("Label.font")
     frc = java.awt.font.FontRenderContext.new(font.transform, true, true)
     textLayout = java.awt.font.TextLayout.new(text, font, frc)
     textLayout.bounds # has #height and #width
   end
   
-  def setup_element element, name, height=nil, set_text_on_this = element
-		  abs_x = nil
-		  abs_y = nil
-		  #height = nil
-		  width = nil
-		  if name.include?(':') && !name.end_with?(':') # like "Start:start_button"  or "start:button:code_name,attribs" but not "Hello:" let that through
-		    text = name.split(':')[0..-2].join(':') # only accept last colon, so they can have text with colons in it
-			code_name_with_attrs = name.split(':')[-1]
-			if code_name_with_attrs.split(',')[0] !~ /=/
-			  # like code_name,width=250,x=y
-			  code_name, *attributes = code_name_with_attrs.split(',')
-			else
-			  code_name = nil
-			  attributes = code_name_with_attrs.split(',')
-			end
-			  attributes_hashed = {}
-			  attributes.each{|attr| 
-			    key, value = attr.split('=')
-			    attributes_hashed[key.strip] = value.strip
-			  }
-			  if type = attributes_hashed.delete('font')
-			    if type == "fixed_width"
-			      set_text_on_this.font=Font.new("Monospaced", Font::PLAIN, 14)
-				else
-				   raise "all we support is fixed_width font as of yet #{type} #{name}"
-				end				
-			  end
-			  
-			  for name in ['abs_x', 'abs_y', 'width', 'height']
-			    var = attributes_hashed.delete(name)
-				if var
-				  if var =~ /chars$/
-				    count = var[0..-5].to_i
-					var = get_text_width('m'*count) # TODO fails for height 30chars
-				  elsif var =~ /px$/
-				    var = var[0..-3].to_i
-				  else
-				    #raise "need to specify like 10px #{var} #{name}"					
-					var = var.to_i # allow it to be clean :P
-				  end
-				  raise "#{var} has value of zero?" if var == 0
-				  eval("#{name} = #{var}") # ugh
-				end
-			  end
-			  raise "unknown attributes found: #{attributes_hashed.keys.inspect} #{attributes_hashed.inspect} #{code_name}" if attributes_hashed.length > 0
-		  else
-		    # no code name
-		    text = name
-		  end
-		  if !width
-		    if text.blank?
-			  raise 'cannot have blank original text without some size specifier:' + name
-			end
-			if text.strip != text
-			  # let blank space count as "space" for now, but don't actually set it LOL
-			  # is this good for variable spaced fonts, though?
-			  width = get_text_width("|" + text + "|") + 35
-			  text.strip!
-			else
+  def split_int_text_name_and_code name_and_code
+      if name_and_code.include?(':') && !name_and_code.end_with?(':') # like "Start:start_button"  or "start:button:code_name,attribs" but not "Hello:" let that through
+        text = name_and_code.split(':')[0..-2].join(':') # only accept last colon, so they can have text with colons in it
+        code_name_with_attrs = name_and_code.split(':')[-1]
+        [text, code_name_with_attrs]
+      else
+        [name_and_code, nil]
+      end
+  end
+  
+  def setup_element element, name_and_code, height=nil, set_text_on_this = element, width=nil
+          abs_x = nil
+          abs_y = nil
+          text, code_name_with_attrs = split_int_text_name_and_code name_and_code
+          if code_name_with_attrs
+            # extract attributes
+            if code_name_with_attrs.split(',')[0] !~ /=/
+              # then like code_name,width=250,x=y
+              code_name, *attributes = code_name_with_attrs.split(',')
+            else
+              code_name = nil
+              attributes = code_name_with_attrs.split(',')
+            end
+            attributes_hashed = {}
+            attributes.each{|attr| 
+              key, value = attr.split('=')
+              attributes_hashed[key.strip] = value.strip
+            }
+            if type = attributes_hashed.delete('font')
+              if type == "fixed_width"
+                set_text_on_this.font = Font.new("Monospaced", Font::PLAIN, 14)
+              else
+                 raise "all we support is fixed_width font as of yet #{type} #{name_and_code}"
+              end                
+            end
+            
+            for name2 in ['abs_x', 'abs_y', 'width', 'height']
+              var = attributes_hashed.delete(name2)
+              if var
+                if var =~ /chars$/
+                  count = var[0..-5].to_i
+                  var = get_text_width('m'*count) # TODO fails for height 30chars
+                elsif var =~ /px$/
+                  var = var[0..-3].to_i
+                else
+                  var = var.to_i # allow it to be clean :P
+                end
+                raise "#{var} has value of zero?" if var == 0
+                eval("#{name2} = #{var}") # ugh
+              end
+            end
+            raise "unknown attributes found: #{attributes_hashed.keys.inspect} #{attributes_hashed.inspect} #{code_name} #{name_and_code}" if attributes_hashed.length > 0
+          end
+          if !width
+            if text.blank?
+              raise 'cannot have blank original text without width specifier:' + name
+            end
+            if text.strip != text
+              # let blank space count as "space" for now, but don't actually set it LOL
+              # is this good for variable spaced fonts, though?
+              width = get_text_width("|" + text + "|") + 35
+              text.strip!
+            else
               width = get_text_width(text) + 35
-			end
- 		  end
-		  set_text_on_this.text=text
-		  abs_x ||= @current_x
-		  abs_y ||= @current_y
-		  height ||= 20
-		  element.set_bounds(abs_x, abs_y, width, height)
+            end
+           end
+          set_text_on_this.text=text if text.present?
+          abs_x ||= @current_x
+          abs_y ||= @current_y
+          height ||= 20
+          element.set_bounds(abs_x, abs_y, width, height)
           @frame.panel.add element
-		  if code_name
-		    code_name.rstrip!
-		    raise "double name not allowed #{name} #{code_name}" if @frame.elements[code_name.to_sym]
+          if code_name
+            code_name.strip!
+            raise "double name not allowed #{name} #{code_name}" if @frame.elements[code_name.to_sym]
             @frame.elements[code_name.to_sym] = set_text_on_this # just symbol access for now...
-		  end
-		  @current_x = [@current_x, abs_x + width + 5].max
-		  @current_line_height = [@current_line_height, (abs_y + height + 5)-@current_y].max # LODO + 5 magic number? 25 - 20 hard coded? hmm...
-		  
-	      @window_max_x = [@window_max_x, @current_x].max # have to track x, but not y
+          end
+          @current_x = [@current_x, abs_x + width + 5].max
+          @current_line_height = [@current_line_height, (abs_y + height + 5)-@current_y].max # LODO + 5 magic number? 25 - 20 hard coded? hmm...
+          
+          @window_max_x = [@window_max_x, @current_x].max # have to track x, but not y
   end
   
   end
 
   private  
   def _dgb
-		  require 'rubygems'
-		  require 'ruby-debug'
-		  debugger
+          require 'rubygems'
+          require 'ruby-debug'
+          debugger
   end
 
 end

data/lib/simple_gui_creator/swing_helpers.rb

@@ -6,7 +6,7 @@ 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] 
+   JFileChooser, JComboBox, JDialog, SwingUtilities, JSlider, JPasswordField, JCheckBox, UIManager] 
    
  include_package 'java.awt'; [Font, FileDialog] 
  
@@ -174,6 +174,19 @@ module SimpleGuiCreator
     alias close dispose # yikes
   end
 
+  class JComboBox
+    def on_select_new_element &block
+       add_item_listener { |e|
+         block.call(get_item_at(get_selected_index), get_selected_index)
+       }
+    end
+    
+    def add_items items
+      for item in items
+        add_item item
+      end
+    end
+  end
 
   class DropDownSelector < JDialog # JDialog is blocking...
     
@@ -193,8 +206,8 @@ module SimpleGuiCreator
       end
 
       box.add_item @prompt = prompt_for_top_entry # put something in index 0
-      options_array.each{|drive|
-        box.add_item drive
+      options_array.each{|option|
+        box.add_item option
       }
       add box
       pack # how do you get this arbitrary size? what the...
@@ -218,4 +231,23 @@ module SimpleGuiCreator
     
   end
   
-end
+  class JCheckBox
+  
+   def after_checked &block
+     add_action_listener {
+       if isSelected # they just 'added' a check mark
+         block.call
+       end
+     }
+   end
+   
+  def after_unchecked &block
+     add_action_listener {
+       if !isSelected # they just "unchecked" it
+         block.call
+       end
+     }
+   end
+   end
+  
+end

data/license.mit.txt

@@ -0,0 +1,19 @@
+Copyright (c) <year> <copyright holders>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/spec/parse_template.spec.rb

@@ -1,25 +1,26 @@
+# encoding: UTF-8
 require File.dirname(__FILE__)+ '/common'
 
-describe ParseTemplate do
+describe SimpleGuiCreator::ParseTemplate do
 
   def parse_string string
     @frame = SimpleGuiCreator::ParseTemplate.new
-	@frame.parse_setup_string(string)
-	@frame
+	  @frame.parse_setup_string(string)
+	  @frame
   end
   
   after do
     @frame.close if @frame
   end
   
-  it "should parse titles" do
+  it "should parse title lines" do
     frame = parse_string " ------------A Title-------------------------------------------"
-	frame.title.should == "A Title"
-	frame.get_title.should == "A Title" # java method mapping :)
-	frame.original_title.should == "A Title"
-	frame.title= 'new title'
-	frame.get_title.should == "new title"
-	frame.original_title.should == "A Title"
+	  frame.title.should == "A Title"
+	  frame.get_title.should == "A Title" # java method mapping :)
+	  frame.original_title.should == "A Title"
+	  frame.title= 'new title'
+	  frame.get_title.should == "new title"
+	  frame.original_title.should == "A Title"
   end
   
   it "should parse button only lines, with several buttons same line" do
@@ -39,14 +40,23 @@ describe ParseTemplate do
    frame.get_size.width.should be > 0
   end
   
-#  it "should parse drop down lines"
-#    frame = parse_string "| [some dropdown lines:dropdowns \/] |"
-# end
+  it "should parse drop down lines" do
+    for string in ["[some dropdown lines \\/:dropdown_name]", "[some dropdown lines \\/ : dropdown_name]", "[some dropdown lines\\/: dropdown_name]", "[some dropdown lines ▼ : dropdown_name]"]
+      frame = parse_string string
+      frame.elements[:dropdown_name].class.should ==  Java::JavaxSwing::JComboBox
+      frame.elements[:dropdown_name].add_items ['a', 'b', 'c']
+      frame.elements[:dropdown_name].get_item_at(0).should == 'some dropdown lines'
+      frame.elements[:dropdown_name].on_select_new_element{|element, idx| p element, idx} # seems to work...
+      frame.close
+    end
+    frame = parse_string "[\\/:dropdown_name]"
+    frame.elements[:dropdown_name].get_item_at(0).should be_nil    
+ end
 
   it "should parse text strings" do
     frame = parse_string '|  "Temp Dir location:temp_dir" |'
-	assert frame.elements.length == 1
-	frame.elements[:temp_dir].should_not be nil
+	  assert frame.elements.length == 1
+	  frame.elements[:temp_dir].should_not be nil
   end
   
   it "should handle a string below buttons" do
@@ -61,7 +71,7 @@ describe ParseTemplate do
   
   it "should split escaped colons" do
     frame = parse_string "| \"some stuff ::my_name\""
-	frame.elements[:my_name].text.should == 'some stuff :'
+	  frame.elements[:my_name].text.should == 'some stuff :'
   end
   
   it "should not accept zero length strings without width spec" do  
@@ -70,7 +80,7 @@ describe ParseTemplate do
   
   it "should accept zero length strings if they have a width spec" do
     frame = parse_string "| \":my_name,width=250\""
-	frame.elements[:my_name].text.should == ''
+	  frame.elements[:my_name].text.should == ''
   end
   
   it "should not add codeless items to elements" do
@@ -82,16 +92,20 @@ describe ParseTemplate do
     proc { parse_string " \" text:name,fake=fake \" "}.should raise_exception
   end
   
- # LODO allow internal sub-boxes LOL
- # TODO mixeds on the same line
- # LODO should pass the button through to on_clicked [?] or button with frame, too?
- # LODO should be able to clear everything a button does or used to do...
- # LODO a 'title managing' object LOL
- # LODO rel_width=+100 or some odd
- # buttons should require a code name :P
+  it "should allow mixed on the same line" do
+    frame = parse_string %! "text:text", [button:button] !
+	  frame.elements.size.should == 2
+	  frame.elements[:button].should_not be_nil
+	  frame.elements[:text].should_not be_nil
+  end
+  
+ # LODO gets h,w of trivial text areas *wrong* oh so wrong
+ # TODO you can line up stuff to get start coords for everything
+ #   end sizes
  # allow prepropagation of textareas, for easier width detection...and/or separating out concerns...hmm...
+ #    YAML-possible for the layout, in a separate file.  Then it's still semi-separated LOL
  #    parse_setup_string string, :text_area_to_use_text => string
- # parse_setup_string :default_font =>
+ #      Make a GUI editor for editing YAML
  
  it "should accept height, width, abs_x, abs_y" do
    frame = parse_string ' [a:my_name,abs_x=1,abs_y=2,width=100,height=101] '
@@ -152,7 +166,15 @@ describe ParseTemplate do
 	frame = parse_string string
 	frame.elements[:text_area].class.should == Java::JavaxSwing::JTextArea
 	frame.elements.length.should == 1 # not create fake empty buttons underneath :)
-	get_dimentia(frame.elements[:text_area]).should == [0, 0, 32, 319]# it's "sub-contained"  in a jscrollpane <sigh>
+	text_area_dimentia(frame.elements[:text_area]).should == [0, 0, 32, 319] # it's "sub-contained"  in a jscrollpane so these numbers are relative to that <sigh>
+ end
+ 
+ def text_area_dimentia(element)
+   while(get_dimentia(element) == [0,0,0,0])
+     puts 'weird TextArea 0,0,0,0'
+     sleep 0.2
+   end
+   get_dimentia(element)
  end
  
  it "should let you use ending colons" do
@@ -166,7 +188,19 @@ describe ParseTemplate do
    get_dimentia(frame.elements[:text])[3].should == 200
  end
  
- it "should parse text areas that aren't first, also one right next to it both sides"
+ it "should allow for non symbol names" do
+   frame = parse_string "[button : button]"
+   frame.elements[:button].should_not be_nil
+ end
+ 
+ it "should parse text areas that aren't first, also one right next to it both sides" do
+   frame = parse_string <<-EOL
+   [button : button][textare : textarea]
+                    [                  ]
+   EOL
+   text_area_dimentia(frame.elements[:textarea]).should == [0, 0, 32, 88]
+   
+ end
  
  it "should allow for blank lines to mean spacing" do
    frame = parse_string "| [ a button] |\n [ a button] \n[ a button]"
@@ -175,5 +209,16 @@ describe ParseTemplate do
    frame = parse_string "| [ a button] |\n [ a button] \n[ a button]\n| |"
    frame.size.height.should == 150
  end
+ 
+ it "should allow for checkboxes" do
+   for string in ["[✓:checkbox_name]", "[✓ : checkbox_name]", "[_:checkbox_name"] # UTF-8 <sigh>
+     f = parse_string string
+     f.elements[:checkbox_name].get_text.should == ""
+     f.elements[:checkbox_name].class.should == Java::JavaxSwing::JCheckBox
+     f.elements[:checkbox_name].after_checked { puts 'checked!' }
+     f.elements[:checkbox_name].after_unchecked { puts 'unchecked!' }
+     f.close
+   end
+ end
 
 end

metadata

@@ -2,7 +2,7 @@
 name: simple_gui_creator
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.1.4
+  version: 0.2.0
 platform: ruby
 authors: 
   - rogerdpack
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-06-22 00:00:00 Z
+date: 2012-06-29 00:00:00 Z
 dependencies: 
   - !ruby/object:Gem::Dependency 
     name: sane
@@ -24,7 +24,7 @@ dependencies:
     type: :runtime
     version_requirements: *id001
   - !ruby/object:Gem::Dependency 
-    name: sane
+    name: andand
     prerelease: false
     requirement: &id002 !ruby/object:Gem::Requirement 
       none: false
@@ -34,6 +34,28 @@ dependencies:
             version: "0"
     type: :runtime
     version_requirements: *id002
+  - !ruby/object:Gem::Dependency 
+    name: sane
+    prerelease: false
+    requirement: &id003 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: "0"
+    type: :runtime
+    version_requirements: *id003
+  - !ruby/object:Gem::Dependency 
+    name: andand
+    prerelease: false
+    requirement: &id004 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: "0"
+    type: :runtime
+    version_requirements: *id004
 description: Framework to ease in creation of ruby GUI apps. Makes designing windows a snap.
 email: rogerdpack@gmail.com
 executables: 
@@ -44,6 +66,7 @@ extra_rdoc_files:
   - ChangeLog
   - README
   - TODO
+  - license.mit.txt
 files: 
   - ChangeLog
   - README
@@ -64,6 +87,7 @@ files:
   - lib/simple_gui_creator/simple_gui_creator.rb
   - lib/simple_gui_creator/storage.rb
   - lib/simple_gui_creator/swing_helpers.rb
+  - license.mit.txt
   - spec/common.rb
   - spec/diesel.mp3
   - spec/drive_info.spec.rb