ruby_on_skis 0.0.0

data/README.textile

@@ -0,0 +1,88 @@
+h1. Ruby on Skis
+
+h2. Introduction
+
+The aim of Ruby on Skis is to provide a starting structure within which to program your wxRuby project. The template provides a directory structure, a set of Rakefiles to manage, and most importantly, to _package_ your Ruby application for distribution as a standalone program when completed. It also includes an environment to get the application running and provide basic services to the program code. For now, the template only supports packaging for Mac OSX and Windows, although various flavors of Linux should be easily accommodated and are planned for the future.
+
+h2. Audience
+
+This template is initially aimed at Rubyists with some experience. If this is your very first Ruby project, then this template probably is not for you. This is alpha-grade software. As the work progresses, it should become a viable choice for less experienced developers. 
+
+h2. Features
+
+* Packaging for Windows and Mac OSX into a standalone program with an installer. 
+* Support for inclusion of specific versions of Ruby Gems. (Active Record is included in the template as an example)
+* Support for including arbitrary files needed to run specific Ruby Gems. 
+* A script/console command for interacting with your non-GUI code. 
+* Environment code that requires all of the code, and provides basic services to your code. 
+* Includes a basic example of creating/reading/deleting objects via ActiveRecord. 
+
+h2. Required tools 
+
+In order to use the template effectively, you must use the following tools:
+
+* "wxRuby":http://wxruby.rubyforge.org
+* "wxFormBuilder":http://wxformbuilder.org/
+* XRCise tool from "wxSugar":http://wxruby.rubyforge.org/wiki/wiki.pl?WxSugar. 
+* "RSpec":http://rspec.info/ for testing. 
+* "Platypus":http://www.sveinbjorn.org/platypus packager for creating the final package on Mac OS X. 
+* "NSIS":http://nsis.sourceforge.net/Main_Page packager for creating the final package on Windows. 
+
+h2. General Workflow
+
+The general workflow will be something like:
+
+# Clone the project. Use 'rake run' in the project directory to run the project and fix any problems. 
+# Remove the example code. 
+# Name your project by redefining the app_name method in config/environment.rb
+# Define Frames, Panels etc. with the appropriate Subclass names, filled with buttons, labels and other widgets with the appropriate names in wxFormBuilder. 
+# Press 'F8' (Generate XRC source) to create the XRC file in your project.
+# Write the appropriate handlers in subclasses of the generated Wx subclasses. 
+# Exceute 'rake run' which will generate the GUI glue code via XRCise and run the project. 
+# Repeat as necessary. 
+# Once you are ready to package the project, examine and modify installer.nsi as necessary for the windows packager. 
+# Run 'rake package:mswin[1.0]' to package the project for windows. The '1.0' is the version number, use what is appropriate for your project. You must run the packaging code on Windows to create a Windows package. 
+# Run 'rake package:dmg[1.0]' to package the code for OSX. Again, the '1.0' is just an example, use what is appropriate for your project. You must run the packaging code on OSX to create an OSX package. 
+
+Note: Due to the way the packaging code works, you need to require everything in the environment file when the program starts up. There should be no 'requires' sprinkled throughout the code, or there is a chance that the packaging code will not find the required library and package it.
+
+
+h2. Further work 
+
+Keep in mind that this template is very much a work in progress. I have used it to complete a couple of small projects, and it has worked well for that aim, but right now it is very specific to the job it does, and is pretty hacky in places. Planned work for the future:
+
+* Instead of a template, the goal is to create a script packaged in a gem that will generate the required directory structure and generate the code that glues it all together. 
+* Create a DEB installer for Linux.
+* Create an RPM installer for Linux. 
+* Generalize into a system for packaging all kinds of Ruby applications, not just those based on wxRuby. 
+* Create Wx mock class for unit testing Wx subclasses.
+* Include Nobbie examples
+* Better RSpec configuration support. 
+
+
+h2. A word about the included binaries
+
+I have included Mac OSX and Windows binaries for the libraries needed to run the example code. The included binaries are from Ruby 1.8.7-p72. Including the binaries is probably not the best long-term solution, however, I feel it is the pragmatic approach to quickly get this thing off the ground. If you need a different Ruby version, feel free to replace the binaries in your project. 
+
+h2. A note on Virtual Machines
+
+I develop on Mac OSX, then run the projects on Windows in a virtual machine, using Parallels to debug and ensure that it works in Windows. Using Parallels is recommended because it will mount your OSX drives in Windows. This way, you can still edit the source in OSX, and then simply use a command line in Windows to run the project. Once you are ready for packaging, you can simply export the project, and again just run the packager in Windows at the command line on the mounted OSX drive. This also points up the fact that the template might not work so well on Windows as the development environment, so there may be some problems with using that approach that I'm not aware of at this point. Feel free to file an issue with the Github issue tracker. 
+
+h2. Thanks
+
+I want to give a special thanks to Alex Fenton for his post on the wxRuby forum and some of the code that it points to, which made it into the template, and otherwise paved the way for the creation of this template. 
+
+I would also like to thank the creators and contributors of wxWidgets, wxRuby and wxSugar for their outstanding work, otherwise this work would not have been possible. 
+
+I also want to thank the Rails team and contributors. You'll probably notice a certain rails-ish flavor to the template. I've also incorporated some stuff from ActiveRecord tasks into the mix, so thanks guys!
+
+h2. License 
+
+While I really don't care about licenses much, it is probably necessary to state here that this template is hereby released under Ruby's license, which seems pretty liberal. Some kudos in your app to me would be nice if you base it on this work. 
+
+h2. Finally, Be Gentle
+
+There are quite a few things that need work, and some things I plain don't like about the code, but it works for me on my development box. There may be things I've forgotten to include that exist on my box, which may not exist on yours. Please file reports via Github's issue tracker and I'll attempt to take care of them as I have time. The project is nowhere near polished, but I wanted to get it out there as soon as I can to give back to the community and garner feedback as I work to create a polished offering. 
+
+As with many open-source developers, I have a day job and this is a side project, please be patient. 
+ 

data/Rakefile

@@ -0,0 +1,67 @@
+require 'rake'
+require 'spec/rake/spectask'
+require 'logger'
+
+config_path = File.expand_path(File.dirname(__FILE__) + '/config')
+$LOAD_PATH << config_path unless $LOAD_PATH.include?(config_path)
+require 'environment'
+Environment.load_tasks
+
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_files = FileList["#{Environment.spec_path}/**/*_spec.rb"]
+  t.spec_opts = ['--options', "#{Environment.spec_path}/spec.opts"]
+end
+
+desc "Run Project"
+task :run => Environment.base_class_path do
+  ENV[Environment.app_env_const] = 'development'
+  executable = File.join( Config::CONFIG['bindir'],
+                          Config::CONFIG['RUBY_INSTALL_NAME'] +
+                          Config::CONFIG['EXEEXT'] )
+  exec("#{executable} #{Environment.app_file}")
+end
+
+desc "Generate Wx Base Classes from XRC"
+file Environment.base_class_path => Environment.xrc_file do | t |
+  $stderr.puts "Generating GUI Base Classes"
+  sh "xrcise -o #{Environment.base_class_path} #{Environment.xrc_file} && touch #{Environment.base_class_path}"
+  make_bases_relative
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "ruby_on_skis"
+    gemspec.summary = "Provide a starting structure within which to program your wxRuby project"
+    gemspec.description = <<-DESCRIPTION
+      The aim of Ruby on Skis is to provide a starting structure within which to program your wxRuby project. 
+      The template provides a directory structure, a set of Rakefiles to manage, and most importantly, to 
+      package your Ruby application for distribution as a standalone program when completed. It also includes 
+      an environment to get the application running and provide basic services to the program code. 
+      For now, the template only supports packaging for Mac OSX and Windows, although various flavors of 
+      Linux should be easily accommodated and are planned for the future    
+    DESCRIPTION
+    gemspec.email = "duskhacker@duskhacker.com"
+    gemspec.homepage = "http://github.com/duskhacker/ruby_on_skis"
+    gemspec.authors = ["Daniel P. Zepeda"]
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end
+
+
+def make_bases_relative
+  Dir.glob(Environment.base_class_path + '/*.rb') do | file |
+    fh = File.open(file, "r+") 
+    data = fh.readlines
+    data.each do | line |
+      line.gsub! /"#{Environment.xrc_file}"/, "File.dirname(__FILE__) + '/../app.xrc'"
+    end
+    fh.rewind
+    fh.truncate(0)
+    fh.puts data
+    fh.close
+  end
+end
+
+task :default  => :spec

data/VERSION

@@ -0,0 +1 @@
+0.0.0

data/bin/init.rb

@@ -0,0 +1,18 @@
+# Development init. There is some common code with the production-mode 'pinit.rb', 
+# but it's not worth the extra effort to refactor it out, you'll probably hardly 
+# ever touch these files.
+
+$LOAD_PATH << File.expand_path(File.dirname(__FILE__) + '/../../config')
+require 'environment'
+env = ENV[Environment.app_env_const] || 'production'
+Environment.setup(env)
+title = Environment.app_name.camelize
+title << " (#{ENV[Environment.app_env_const].upcase})" unless env == 'production'
+
+unless  ENV['ASSEMBLING'] ==  "true"
+  Wx::App.run do 
+    self.app_name = title
+    @frame = AppFrame.new(title)
+    @frame.show
+  end
+end

data/bin/pinit.rb

@@ -0,0 +1,27 @@
+# Production init. There is some common code with the development-mode 'init.rb', 
+# but it's not worth the extra effort to refactor it out, you'll probably hardly 
+# ever touch these files.
+
+bundle_path = File.expand_path(File.dirname(__FILE__) + '/../lib' )
+
+$LOAD_PATH.clear
+$LOAD_PATH << "#{bundle_path}"
+Dir.glob("#{bundle_path}/*") do | path |
+  if File.directory?(path)
+    $LOAD_PATH << path
+  end
+end
+
+require 'environment'
+env = ENV[Environment.app_env_const] || 'production'
+Environment.setup(env, true, true)
+title = Environment.app_name.camelize
+title << " (#{ENV[Environment.app_env_const].upcase})" unless env == 'production'
+
+unless  ENV['ASSEMBLING'] ==  "true"
+  Wx::App.run do 
+    self.app_name = title
+    @frame = AppFrame.new(title)
+    @frame.show
+  end
+end

data/config/environment.rb

@@ -0,0 +1,189 @@
+module Environment
+  class << self 
+ 
+    attr_accessor :environment # Accessor for testing
+    
+    # Change this for each application, many settings are 
+    # based off of this setting. 
+    def app_name
+      "RubyOnSkis"
+    end
+ 
+    def setup(environment, load_gui_components = true, loading_from_package = false)
+      @environment = environment
+      $LOAD_PATH << ( app_root + '/config' )
+      require_libs(load_gui_components, loading_from_package)
+      Dir.mkdir( data_path ) unless File.exists?(data_path)
+      backup_database
+      establish_connection
+      migrate
+      load_fixtures
+    end
+ 
+    def require_libs(load_gui_components=true, loading_from_package=false)
+      require 'yaml'
+      config = YAML.load_file(app_root + '/config/requires.yml')
+
+      # Only do this when in development mode
+      unless loading_from_package
+        require 'gemconfigure'
+        gem_config = []
+
+        config.each_pair do | name, values |
+          next if !load_gui_components && name =~/wx/
+          gem_config << [name, values["version"]]
+        end
+      
+        Gem.configure(gem_config)
+      end
+      
+      config.each_pair do | name, values |
+        next if !load_gui_components && name =~/wx/
+        require values["require"]
+      end
+      
+      # app-specific 
+      
+      require 'find'
+      Find.find(File.expand_path(File.dirname(__FILE__) + '/../lib')) do | path |
+        Find.prune if !File.directory?(path) || File.basename(path).index('.') == 0 
+        $LOAD_PATH << path
+      end
+      
+      app_files = Dir.glob( app_root + '/lib/extensions/**/*.rb')
+      app_files += Dir.glob( app_root + '/lib/models/*.rb')
+
+      if load_gui_components
+        app_files += Dir.glob( "#{base_class_path}/*.rb")
+        app_files += Dir.glob( app_root + '/lib/wx/helpers/*.rb')
+        app_files += Dir.glob( app_root + '/lib/wx/app/*.rb')
+      end
+
+      app_files.each do | file |
+        require file.gsub(/#{app_root}\/lib\//, '')
+      end
+    end
+ 
+    def establish_connection
+      unless production?
+        ActiveRecord::Base.logger = Logger.new("#{data_path}/#{environment}.log")
+        ActiveRecord::Base.logger.level = Logger::DEBUG
+      end
+      ActiveRecord::Base.establish_connection(
+        :adapter => "sqlite3",
+        :dbfile => db_file
+      )
+    end
+ 
+    def migrate
+      if production? 
+        ActiveRecord::Migration.verbose=false
+        ActiveRecord::Base.logger = Logger.new("#{data_path}/#{environment}.log")
+      end
+
+      ActiveRecord::Migrator.migrate(app_root + "/migrate/", ENV["VERSION"] ? ENV["VERSION"].to_i : nil)
+      ActiveRecord::Base.logger = nil if production? 
+    end
+ 
+    def load_fixtures
+      fixture_files = Dir.glob(app_root + "/fixtures/*.{yml,csv}")
+      return if fixture_files.empty? 
+      require 'active_record/fixtures'
+      fixture_files.each do |fixture_file|
+        klass = File.basename(fixture_file).gsub(/\.yml/,'').titleize.singularize.constantize
+        next if klass.count > 0 
+        Fixtures.create_fixtures( app_root + '/fixtures', File.basename(fixture_file, '.yml'))    
+      end
+    end
+    
+    def load_tasks
+      Dir["#{Environment.app_root}/tasks/**/*.rake"].sort.each { |ext| load ext }
+    end
+ 
+    def db_file(env=environment)
+      File.join(data_path, "#{app_name.underscore}_#{env}.db")
+    end
+    
+    def xrc_file
+      "#{app_root}/lib/wx/app.xrc"
+    end
+    
+    def base_class_path
+      "#{app_root}/lib/wx/base"
+    end
+    
+    def app_file
+      "#{app_root}/bin/common/init.rb"
+    end
+    
+    def spec_path
+      "#{app_root}/spec"
+    end
+ 
+    def app_root
+      File.expand_path(File.dirname(__FILE__) + '/../')
+    end
+ 
+    def app_env_const
+      app_name.upcase + "_ENV"
+    end
+    
+    def have_console?
+      open("CONOUT$", "w") {} 
+      true 
+    rescue SystemCallError 
+      false 
+    end
+
+    def data_path
+      @data_path ||= if mswin?
+        File.expand_path(File.join(ENV['APPDATA'].gsub(/\\/,'/'), app_name.camelize))
+      else
+        "#{ENV['HOME']}/.#{app_name.underscore}/"
+      end
+    end
+
+    def tmpdir
+      if mswin?
+        ENV['TMP'] || ENV['TEMP']
+      else
+        ENV['TMPDIR']
+      end
+    end
+    
+    def production? 
+      environment == "production"
+    end
+    
+    def development? 
+      environment == "development"
+    end
+    
+    def test? 
+      environment == "test"
+    end
+    
+    def mswin?
+      RUBY_PLATFORM == 'i386-mswin32'
+    end
+    
+    def darwin?
+      RUBY_PLATFORM == 'i686-darwin9'
+    end
+    
+    def backup_database
+      return unless Environment.production?
+      file_index_matcher = /#{File.basename(Environment.db_file)}\.(\d)$/
+      Dir.glob("#{Environment.db_file}.*").sort.reverse.each do | file |
+        next if file == "#{Environment.db_file}.#{backup_limit}"
+        file_index = file_index_matcher.match(file)[1].to_i
+        FileUtils.mv file, "#{Environment.db_file}.#{file_index+1}"
+      end
+      FileUtils.cp(Environment.db_file, "#{Environment.db_file}.1") if File.exists?(Environment.db_file)
+    end
+    
+    def backup_limit
+      10
+    end
+  end
+end

data/config/gemconfigure.rb

@@ -0,0 +1,24 @@
+#--
+# Copyright 2006 by Chad Fowler, Rich Kilmer, Jim Weirich and others.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+module Gem
+
+  # Activate the gems specfied by the gem_pairs list.
+  #
+  # gem_pairs ::
+  #   List of gem/version pairs.
+  #   Eg.  [['rake', '= 0.8.15'], ['RedCloth', '~> 3.0']]
+  # options ::
+  #   options[:verbose] => print gems as they are required.
+  #
+  def self.configure(gem_pairs, options={})
+    gem_pairs.each do |name, version|
+      require 'rubygems' 
+      puts "Activating gem #{name} (version #{version})" if options[:verbose]
+      gem name, version
+    end
+  end
+end

data/config/requires.yml

@@ -0,0 +1,15 @@
+# Include the gems and the versions you want to use here. This file is only used in production,
+# when the program is packaged, this file is ignored in favor of what is available in the package.
+---
+activerecord:    
+  require: activerecord
+  version: =2.2.2
+activesupport:  
+  require: activesupport
+  version: =2.2.2
+sqlite3-ruby:    
+  require: sqlite3
+  version: =1.2.3
+wxruby:
+  require: wx
+  version: =2.0.0

data/data/lorem.txt

@@ -0,0 +1,101 @@
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor
+incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis 
+nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. 
+Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore 
+eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, 
+sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, 
+turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis 
+sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus 
+et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut 
+ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt 
+sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. 
+Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, 
+consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl 
+adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque 
+nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, 
+laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, 
+feugiat in, orci. In hac habitasse platea dictumst.
+
+Fusce convallis, mauris imperdiet gravida bibendum, nisl turpis suscipit 
+mauris, sed placerat ipsum urna sed risus. In convallis tellus a mauris. 
+Curabitur non elit ut libero tristique sodales. Mauris a lacus. Donec mattis 
+semper leo. In hac habitasse platea dictumst. Vivamus facilisis diam at odio. 
+Mauris dictum, nisi eget consequat elementum, lacus ligula molestie metus, non 
+feugiat orci magna ac sem. Donec turpis. Donec vitae metus. Morbi tristique 
+neque eu mauris. Quisque gravida ipsum non sapien. Proin turpis lacus, 
+scelerisque vitae, elementum at, lobortis ac, quam. Aliquam dictum eleifend 
+risus. In hac habitasse platea dictumst. Etiam sit amet diam. Suspendisse odio.
+Suspendisse nunc. In semper bibendum libero.
+
+Proin nonummy, lacus eget pulvinar lacinia, pede felis dignissim leo, vitae 
+tristique magna lacus sit amet eros. Nullam ornare. Praesent odio ligula, 
+dapibus sed, tincidunt eget, dictum ac, nibh. Nam quis lacus. Nunc eleifend 
+molestie velit. Morbi lobortis quam eu velit. Donec euismod vestibulum massa. 
+Donec non lectus. Aliquam commodo lacus sit amet nulla. Cras dignissim elit et 
+augue. Nullam non diam. Pellentesque habitant morbi tristique senectus et netus 
+et malesuada fames ac turpis egestas. In hac habitasse platea dictumst. Aenean 
+vestibulum. Sed lobortis elit quis lectus. Nunc sed lacus at augue bibendum dapibus.
+
+Aliquam vehicula sem ut pede. Cras purus lectus, egestas eu, vehicula at, 
+imperdiet sed, nibh. Morbi consectetuer luctus felis. Donec vitae nisi. Aliquam 
+tincidunt feugiat elit. Duis sed elit ut turpis ullamcorper feugiat. Praesent 
+pretium, mauris sed fermentum hendrerit, nulla lorem iaculis magna, pulvinar 
+scelerisque urna tellus a justo. Suspendisse pulvinar massa in metus. Duis quis 
+quam. Proin justo. Curabitur ac sapien. Nam erat. Praesent ut quam.
+
+Vivamus commodo, augue et laoreet euismod, sem sapien tempor dolor, ac egestas 
+sem ligula quis lacus. Donec vestibulum tortor ac lacus. Sed posuere vestibulum 
+nisl. Curabitur eleifend fermentum justo. Nullam imperdiet. Integer sit amet 
+mauris imperdiet risus sollicitudin rutrum. Ut vitae turpis. Nulla facilisi. 
+Quisque tortor velit, scelerisque et, facilisis vel, tempor sed, urna. Vivamus 
+nulla elit, vestibulum eget, semper et, scelerisque eget, lacus. Pellentesque 
+viverra purus. Quisque elit. Donec ut dolor.
+
+Duis volutpat elit et erat. In at nulla at nisl condimentum aliquet. Quisque 
+elementum pharetra lacus. Nunc gravida arcu eget nunc. Nulla iaculis egestas 
+magna. Aliquam erat volutpat. Sed pellentesque orci. Etiam lacus lorem, iaculis 
+sit amet, pharetra quis, imperdiet sit amet, lectus. Integer quis elit ac mi 
+aliquam pretium. Nullam mauris orci, porttitor eget, sollicitudin non, 
+vulputate id, risus. Donec varius enim nec sem. Nam aliquam lacinia enim. 
+Quisque eget lorem eu purus dignissim ultricies. Fusce porttitor hendrerit 
+ante. Mauris urna diam, cursus id, mattis eget, tempus sit amet, risus. 
+Curabitur eu felis. Sed eu mi. Nullam lectus mauris, luctus a, mattis ac, 
+tempus non, leo. Cras mi nulla, rhoncus id, laoreet ut, ultricies id, odio.
+
+Donec imperdiet. Vestibulum auctor tortor at orci. Integer semper, nisi eget 
+suscipit eleifend, erat nisl hendrerit justo, eget vestibulum lorem justo ac 
+leo. Integer sem velit, pharetra in, fringilla eu, fermentum id, felis. 
+Vestibulum sed felis. In elit. Praesent et pede vel ante dapibus condimentum. 
+Donec magna. Quisque id risus. Mauris vulputate pellentesque leo. Duis 
+vulputate, ligula at venenatis tincidunt, orci nunc interdum leo, ac egestas 
+elit sem ut lacus. Etiam non diam quis arcu egestas commodo. Curabitur nec 
+massa ac massa gravida condimentum. Aenean id libero. Pellentesque vitae 
+tellus. Fusce lectus est, accumsan ac, bibendum sed, porta eget, augue. Etiam 
+faucibus. Quisque tempus purus eu ante.
+
+Vestibulum sapien nisl, ornare auctor, consectetuer quis, posuere tristique, 
+odio. Fusce ultrices ullamcorper odio. Ut augue nulla, interdum at, adipiscing 
+non, tristique eget, neque. Pellentesque habitant morbi tristique senectus et 
+netus et malesuada fames ac turpis egestas. Ut pede est, condimentum id, 
+scelerisque ac, malesuada non, quam. Proin eu ligula ac sapien suscipit 
+blandit. Suspendisse euismod. Ut accumsan, neque id gravida luctus, arcu pede 
+sodales felis, vel blandit massa arcu eget ligula. Aenean sed turpis. 
+Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac 
+turpis egestas. Donec sem eros, ornare ut, commodo eu, tempor nec, risus. Donec
+laoreet dapibus ligula. Praesent orci leo, bibendum nec, ornare et, nonummy in, 
+elit. Donec interdum feugiat leo. Vestibulum ante ipsum primis in faucibus orci 
+luctus et ultrices posuere cubilia Curae; Pellentesque feugiat ullamcorper 
+ipsum. Donec convallis tincidunt urna.
+
+Suspendisse et orci et arcu porttitor pellentesque. Sed lacus nunc, fermentum 
+vel, vehicula in, imperdiet eget, urna. Nam consectetuer euismod nunc. Nulla 
+dignissim posuere nulla. Integer iaculis lacinia massa. Nullam sapien augue, 
+condimentum vel, venenatis id, rhoncus pellentesque, sapien. Donec sed ipsum 
+ultrices turpis consectetuer imperdiet. Duis et ipsum ac nisl laoreet commodo. 
+Mauris eu est. Suspendisse id turpis quis orci euismod consequat. Donec tellus 
+mi, luctus sit amet, ultrices a, convallis eu, lorem. Proin faucibus convallis 
+elit. Maecenas rhoncus arcu at arcu. Proin libero. Proin adipiscing. In quis 
+lorem vitae elit consectetuer pretium. Nullam ligula urna, adipiscing nec, 
+iaculis ut, elementum non, turpis. Fusce pulvinar.

data/fixtures/messages.yml

@@ -0,0 +1,7 @@
+---
+message_001:
+  name: First 
+  content: Hello
+message_002:
+  name: Second
+  content: World

data/lib/extensions/string/truncate.rb

@@ -0,0 +1,16 @@
+module Extensions
+  module String
+    module Truncate
+
+      def truncate(size = 20)
+        ellipsis = "..."
+        return self if size < ellipsis.size  || self.size == ellipsis.size
+        size -= ellipsis.size
+        self.size > size ? self.slice(0,size) + "..." : self
+      end
+
+    end
+  end
+end
+
+String.send :include,  Extensions::String::Truncate

data/lib/models/message.rb

@@ -0,0 +1,11 @@
+class Message < ActiveRecord::Base
+  validates_presence_of :name, :content
+  validates_uniqueness_of :name
+  
+  named_scope :ordered_by_name, :order => "name COLLATE NOCASE"
+  
+  def self.names
+    connection.select_values("SELECT name FROM messages ORDER BY name COLLATE NOCASE")
+  end
+  
+end

data/lib/wx/app/app_frame.rb

@@ -0,0 +1,56 @@
+# AppFrameBase will be defined by the XRC generated from
+# wxFormBuilder. Use the "Subclass" property in wxFB to define
+# it.
+class AppFrame < AppFrameBase
+  include AppHelper
+  
+  def initialize(title)
+    super()
+
+    if Environment.darwin?
+      @tbicon = MyTaskBarIcon.new(self)
+    elsif Environment.mswin?
+      icon_file = File.join(Environment.app_root, 'images', "#{Environment.app_name.underscore}.ico")
+      icon = Wx::Icon.new(icon_file, Wx::BITMAP_TYPE_ICO)
+      set_icon(icon)
+    end
+
+    evt_menu Wx::ID_EXIT, :on_quit
+    evt_menu Wx::ID_ABOUT, :on_about
+
+    evt_menu quit_menu_item, :on_quit
+    
+    self.title = title 
+    self.size = [ 1024, 868 ]
+
+    self.status_text = "Welcome to #{Environment.app_name}!"
+    status_bar.set_min_height 80
+
+    # The apps I've written so far are single window affairs with several notebook pages. wxFormBuilder doesn't seem to 
+    # support this directly, so creating an AppFrame, and then the notebook pages as separate panels, and tying them together
+    # here seems to work well. 
+    message_panel = MessagePanel.new(notebook)
+    notebook.add_page(message_panel, "Messages")
+  end
+  
+  def on_quit
+    @tbicon.remove_icon unless @tbicon.nil?
+    destroy()
+    exit()
+  end
+
+  # show an 'About' dialog
+  def on_about
+    # TODO: Make version dynamic somehow.
+    msg =  sprintf("Welcome to #{Environment.app_name}, version 0.1")
+
+    # create a simple message dialog with OK button
+    about_dlg = Wx::MessageDialog.new( self, msg, "About #{Environment.app_name}",
+    Wx::OK|Wx::ICON_INFORMATION )
+    about_dlg.show_modal
+  end
+end
+# icon_file = File.join( File.dirname(__FILE__), "mondrian.png")
+# # PNG can be used on all platforms, but icon type must be specified
+# # to work on Windows; OS X doesn't have "Frame" icons.
+# self.icon = Wx::Icon.new(icon_file, Wx::BITMAP_TYPE_PNG)