qtext 0.3.0

data/README.txt

@@ -0,0 +1,48 @@
+= qtext
+
+* FIX (url)
+
+== DESCRIPTION:
+
+Some extensions to qt4-qtruby to make it more rubyish
+
+== FEATURES/PROBLEMS:
+
+* FIX (list of features or problems)
+
+== SYNOPSIS:
+
+  FIX (code sample of usage)
+
+== REQUIREMENTS:
+
+* FIX (list of requirements)
+
+== INSTALL:
+
+* FIX (sudo gem install, anything else)
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIX
+
+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/lib/qtext.rb

@@ -0,0 +1,10 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'Qt4'
+require 'qtext/flags.rb'
+require 'qtext/extensions.rb'
+
+module QtExt
+  
+end

data/lib/qtext/extensions.rb

@@ -0,0 +1,269 @@
+# need this here otherwise the definition of BigDecimal#to_variant
+# causes and error
+require 'Qt4'
+require 'qtext/flags.rb'
+require 'bigdecimal'
+
+# Because Qt::Variant.new( obj ) is a PITA to type
+class Object
+  def to_variant
+    begin
+      Qt::Variant.fromValue( self )
+    rescue Exception => e
+      puts e.backtrace.join( "\n" )
+      puts "error converting #{self.inspect} to variant: #{e.message}"
+      nil.to_variant
+    end
+  end
+end
+
+class Class
+  def construct_exec( *args, &block )
+    raise "block is nil" if block.nil?
+    inst = self.new( *args )
+    # using the Rails implementation, included in Qt
+    block.bind( inst )[*args]
+    # return the newly configured instance
+    inst
+  end
+
+  def construct( *args, &block )
+    raise "block is nil" if block.nil?
+    inst = self.new( *args )
+    yield( inst )
+    inst
+  end
+end
+
+class NilClass
+  def to_variant
+    Qt::Variant.invalid
+  end
+end
+
+class Date
+  def to_variant
+    self.to_s.to_variant
+  end
+end
+
+class BigDecimal
+  def to_variant
+    self.to_f.to_variant
+  end
+end
+
+# convenience methods
+module Qt
+
+  class Base
+    # use the cursor constant for the application override cursor
+    # while the block is executing.
+    # Return the value of the block
+    def override_cursor( cursor_constant, &block )
+      Qt::Application.setOverrideCursor( Qt::Cursor.new( cursor_constant ) )
+      retval = yield
+      Qt::Application.restoreOverrideCursor
+      retval
+    end
+  end
+
+  class CheckBox
+    def value
+      checkState == qt_checked
+    end
+    
+    def value=( obj )
+      # This seems backwards to me, but it works
+      setCheckState( ( obj == false ? Qt::Unchecked : Qt::Checked ) )
+    end
+  end
+  
+  class RadioButton
+    def value
+      is_checked == true
+    end
+    
+    def value=( bool )
+      setChecked( bool )
+    end
+  end
+  
+  class Enum
+    def to_variant
+      to_i.to_variant
+    end
+  end
+  
+  class ItemSelection
+    include Enumerable
+    
+    def each( &block )
+      index = 0
+      max = self.count
+      while index < max
+        yield( self.at( index ) )
+        index += 1
+      end
+    end
+    
+    def size
+      self.count
+    end
+    
+  end
+  
+  class ItemSelectionRange 
+    def single_cell?
+      self.top == self.bottom && self.left == self.right
+    end
+  end
+  
+  # This provides a bunch of methods to get easy access to the entity
+  # and it's values directly from the index without having to keep
+  # asking the model and jumping through other unncessary hoops
+  class ModelIndex
+    # Because using Qt::ModelIndex.new the whole time is wasteful
+    def self.invalid
+      @@invalid ||= ModelIndex.new
+    end
+    
+    alias_method :old_inspect, :inspect
+    def inspect
+      #<Qt::ModelIndex:0xb6004e8c>
+      # fetch address from superclass inspect
+      super =~ /ModelIndex:(.*)>/
+      # format nicely
+      #~ "#<Qt::ModelIndex:#{$1} xy=(#{row},#{column}) gui_value=#{gui_value}>"
+      "#<Qt::ModelIndex:#{$1} xy=(#{row},#{column})>"
+    end
+    
+    # sort by row, then column
+    def <=>( other )
+      row_comp = self.row <=> other.row
+      if row_comp == 0
+        self.column <=> other.column
+      else
+        row_comp
+      end
+    end
+    
+  end
+
+  # make keystrokes easier to work with
+  class KeyEvent
+    # override otherwise the new method_missing fails
+    # to call the old_method_missing
+    def modifiers
+      old_method_missing( :modifiers )
+    end
+    
+    # override otherwise the new method_missing fails
+    # to call the old_method_missing
+    def key
+      old_method_missing( :key )
+    end
+
+    # override otherwise the new method_missing fails
+    # to call the old_method_missing
+    def text
+      old_method_missing( :text )
+    end
+
+    # is the control key pressed?
+    def ctrl?
+      modifiers & Qt::ControlModifier.to_i == Qt::ControlModifier.to_i
+    end
+    
+    alias_method :old_method_missing, :method_missing
+    
+    # shortcut for the Qt::Key_Whatever constants
+    # just say event.whatever?
+    def method_missing( sym, *args )
+      begin
+        if sym.to_s[-1] == "?"[0]
+          key?( sym.to_s[0..-2] )
+        else
+          old_method_missing( sym, args )
+        end
+      rescue Exception => e
+        old_method_missing( sym, args )
+      end
+    end
+    
+    def key?( name )
+      key == eval( "Qt::Key_#{name.to_s.camelize}" )
+    end
+    
+  end
+  
+  class Rect
+    alias_method :old_inspect, :inspect
+    def inspect
+      "#<Qt::Rect x=#{self.x} y=#{self.y} w=#{self.width} h=#{self.height}>"
+    end
+  end
+  
+  class Region
+    def inspect
+      "#<Qt::Region bounding_rect=#{self.bounding_rect.inspect}>"
+    end
+  end
+  
+  class TabWidget
+    include Enumerable
+    def each_tab( &block )
+      save_index = self.current_index
+      (0...self.count).each do |i|
+        yield( self.widget(i) )
+      end
+    end
+    alias_method :each, :each_tab
+  end
+  
+  class Variant
+    # return an empty variant
+    def self.invalid
+      @@invalid ||= Variant.new
+    end
+    
+    # because the qtruby inspect doesn't provide the value
+    alias_method :old_inspect, :inspect
+    def inspect
+      "#<Qt::Variant value=#{self.value} typeName=#{self.typeName}>"
+    end
+    
+    # return the string of the value of this variant
+    def to_s
+      self.value.to_s
+    end
+  end
+  
+  class Widget
+    # add a signal with the given signature, and create
+    # a method called method_name which will return the signal
+    # ready to be used in a connect. If method_name is not provided
+    # the method will be named as the name part of signature 
+    def self.construct_signal( signature, method_name = nil )
+      # add the signal
+      q_signal( signature )
+      
+      # add an accessor method that returns the result of SIGNAL
+      if method_name.nil?
+        md = /([\w_]+) *\(/.match( signature )
+        base_method_name = md[1]
+        method_name = base_method_name + '_signal'
+      end
+      
+      # create the accessor method which returns
+      # a signal ready to be connected
+      define_method method_name do
+        SIGNAL( signature )
+      end
+      
+      # TODO create the connection method
+    end
+  end
+
+end
+

data/lib/qtext/flags.rb

@@ -0,0 +1,101 @@
+require 'Qt4'
+
+=begin rdoc
+  The Qt bindings look up constants for each call. This module
+  caches the constant values. Most of these are called for each
+  cell in a table, so caching them gives us a good performance
+  increase.
+=end
+module QtFlags
+  def item_boolean_flags
+    @item_boolean_flags ||= Qt::ItemIsEnabled | Qt::ItemIsSelectable | Qt::ItemIsUserCheckable
+  end
+  
+  def qt_item_is_editable
+    @qt_item_is_editable ||= Qt::ItemIsEditable
+  end
+  
+  def qt_display_role
+    @qt_display_role ||= Qt::DisplayRole
+  end
+  
+  def qt_edit_role
+    @qt_edit_role ||= Qt::EditRole
+  end
+  
+  def qt_paste_role
+    @qt_paste_role ||= Qt::PasteRole
+  end
+  
+  def qt_checkstate_role
+    @qt_checkstate_role ||= Qt::CheckStateRole
+  end
+  
+  def qt_text_alignment_role
+    @qt_text_alignment_role ||= Qt::TextAlignmentRole
+  end
+  
+  def qt_size_hint_role
+    @qt_size_hint_role ||= Qt::SizeHintRole
+  end
+  
+  def qt_checked
+    @qt_checked ||= Qt::Checked
+  end
+  
+  def qt_unchecked
+    @qt_unchecked ||= Qt::Unchecked
+  end
+  
+  def qt_alignleft
+    @qt_alignleft ||= Qt::AlignLeft
+  end
+  
+  def qt_alignright
+    @qt_alignright ||= Qt::AlignRight
+  end
+  
+  def qt_aligncenter
+    @qt_aligncenter ||= Qt::AlignCenter
+  end
+  
+  def qt_decoration_role
+    @qt_decoration_role ||= Qt::DecorationRole
+  end
+  
+  def qt_background_role
+    @qt_background_role ||= Qt::BackgroundRole
+  end
+  
+  def qt_font_role
+    @qt_font_role ||= Qt::FontRole
+  end
+  
+  def qt_foreground_role
+    @qt_foreground_role ||= Qt::ForegroundRole
+  end
+  
+  def qt_tooltip_role
+    @qt_tooltip_role ||= Qt::ToolTipRole
+  end
+  
+  # ewww
+  def const_as_string( constant )
+    case constant
+      when qt_text_alignment_role; 'Qt::TextAlignmentRole'
+      when qt_checkstate_role; 'Qt::CheckStateRole'
+      when qt_edit_role; 'Qt:EditRole'
+      when qt_display_role; 'Qt::DisplayRole'
+      when Qt::ToolTipRole; 'Qt::ToolTipRole'
+      when Qt::StatusTipRole; 'Qt::StatusTipRole'
+      when Qt::DecorationRole; 'Qt::DecorationRole'
+      when Qt::BackgroundRole; 'Qt::BackgroundRole'
+      when Qt::FontRole; 'Qt::FontRole'
+      when Qt::ForegroundRole; 'Qt::ForegroundRole'
+      when Qt::TextColorRole; 'Qt::TextColorRole'
+      
+      else "#{constant} unknown"
+    end
+  end
+end
+

data/lib/qtext/version.rb

@@ -0,0 +1,9 @@
+module Qtext #:nodoc:
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 3
+    TINY  = 0
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,2 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/qtext'

data/test/test_qtext.rb

@@ -0,0 +1,11 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestQtext < Test::Unit::TestCase
+
+  def setup
+  end
+  
+  def test_truth
+    assert true
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: qtext
+version: !ruby/object:Gem::Version 
+  version: 0.3.0
+platform: ruby
+authors: 
+- FIXME full name
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-07-17 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.7.0
+    version: 
+description: description of gem
+email: 
+- panic@semiosix.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.txt
+files: 
+- README.txt
+- lib/qtext.rb
+- lib/qtext/version.rb
+- lib/qtext/flags.rb
+- lib/qtext/extensions.rb
+has_rdoc: true
+homepage: http://qtext.rubyforge.org
+post_install_message: |+
+  
+  For more information on qtext, see http://qtext.rubyforge.org
+  
+  NOTE: Change this information in PostInstall.txt 
+  You can also delete it if you don't want it.
+  
+  
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: qtext
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: description of gem
+test_files: 
+- test/test_qtext.rb
+- test/test_helper.rb