shoes 4.0.0.pre1 → 4.0.0.pre2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 29a51f2d1e2fbe9eb3a1f139a00a9336f86d0b17
-  data.tar.gz: 8ed0ebb6efee29a532e09a031129b679c6e8b7df
+  metadata.gz: ce88c2a93a5c4f95d25f734a138a98260f0768ec
+  data.tar.gz: 4222af5bcbe6eaa05726264d582a86de18af5291
 SHA512:
-  metadata.gz: 06c22bb69c311c08aa164f03c8e24cf25a1799aa91317a483f14daa2ef59bfb1f6aad1957a5ff07ed243e89cf801f58acf292e75a5f96d8cb273b14fd309e7b4
-  data.tar.gz: bb102f5480a16ae1fd809568ca6aeb7802e090c8c3f28d55a621a820faf1be7986ca86b80a4e76bf6db90ce55485f779cbe74921429ccda9d5fa7baf2ac342e5
+  metadata.gz: b0a085199ce52ed003ae3fc4a3ae09bca5908d1e02f68aa70060489c22f314e0e474add7ca02bf83b8fc0c925b8e0a60d140ac85b010b888535a81fe249ab5a7
+  data.tar.gz: fecd14c2ac9b6413e6cf813446856f79545abcf8144393ae39af89c41c097f041435562ce933d9fce1094c76f5f616d7a8d0cd2b9d3d1fe3364803acb4b1e73c

data/CHANGELOG

@@ -1,32 +1,84 @@
-= BROWN SHOES NEEDS A NEW RELEASE SCHEDULE!!
-* Name Suggestions anyone?
-
-= Policeman
-== 17th August, 2010
-* Move to Ruby 1.9.1
-* General stability improvements
-* Updated all dependancies
-* Ported OSX to Cocoa
-* Now works with Windows Vista and Windows 7
-
-= Raisins (0.r1134)
-== 5th December, 2008
-<http://shoooes.net/about/raisins>
-* Built-in Shoes manual. (Alt-?)
-* Error console. (Alt-/)
-* In-memory and on-disk image cache.
-* Asynchronous download method.
-* External font support.
-* Packager for building EXE, DMG, RUN and SHY.
-* Effects (blurs, shadows, glows).
-* Arbitrary shape method.
-* Image blocks.
-* Switched from Carbon to Cocoa.
-* RubyGems integration.
-
-= Curious (0.r396)
-== 8th January, 2008
-* First official release of Shoes.
-* Support for OS X, Win32 and GTK+.
-* Scrolling stacks newly added.
-* VLC embedded for Video.
+4.0.0.pre2 (438 commits)
+----------------
+
+New features (1)
+----------------
+
+* Shoes 4.0.0.pre1 was a single gem. Now we ship as as three gems [e16a0c4]:
+
+  * shoes -- Home to the shoes executable. Declares dependencies on other
+    shoes gems for ease of installation.
+  * shoes-dsl -- Code for the Shoes DSL. No direct UI rendering and will be
+    reused with all future backends.
+  * shoes-swt -- The first Shoes backend, implemented in JRuby on the SWT
+    library via the swt gem.
+
+* Full style-setting functionality (element#style, setters, hash, app level) [56d91f8]
+
+Improvements (36)
+-----------------
+
+* Update SWT to 4.4 [536ffae]
+* Update packaging dependency to 0.2.0 now supporting rubyzip > 1.0 [c3dd289]
+* Update all elements to use new style methods [1b76aa3, 29498d1, d569a77, e6eec90, 54e5edf, 1238977, 2dc222f, dbeffff, 25b2ec6, cb865a6, 49fa0a1]
+* Update list of app level styles and partially fix rotate angle issues [2affdbb]
+* Shoes application context improved to avoid conflicts between user-defined and shoes-defined methods. [732108a]
+* Builtin methods are also available from the Shoes class [de37d59]
+* #gray, #rgb and #gradient builtin methods [8f7ee92]
+* Removed redrawing triggers after Dimension methods  [61a55ba]
+* Apply fraction from progress initialize [b241240]
+* Trigger redraw on hover/leave for slot and image update [ae5dfb5]
+* Nobody Knows Shoes samples added [68e84e6]
+* Add sample56 snapshot [e7eb0d3]
+* Add scroll* methods to slots. Scrolling functionality not implemented yet. [6fb0e79]
+* Click passes element, not coordinates to most blocks [78ecb23]
+* Allow button calls without a button name [a315ef4]
+* Add common #to_s and #inspect methods for DSL objects [350c4dc]
+* Disposal for Images and Patterns. [ddcd9fb]
+* Move Swt::TextBlock related classes to subdirectory. [226e03f]
+* Revise TextBlock cursor to be more like other text functionality. [f016ee7]
+* Updated manual to show correct syntax for rect. [2fee530]
+* App#parent method to show the parent of the slot currently evaled [48e811f]
+* Add keypress to close app cleanly when running leak hunter and dispose of app-level resources. [af4d6bb]
+
+Bug Fixes (32)
+--------------
+
+* Fix running bin/shoes.bat from source [fe47075]
+* Move shoes executable from shoes-dsl to shoes [92583e6]
+* Fix for crash on empty link text [3da3159]
+* Hide only the elements of a slot, not its parent contents  [f2ea17c]
+* Fix crash for Border when hiding [1c2ab74]
+* Methods defined in widgets are available in URL instances [3a94afb]
+* Make texts know their TextBlock and hence their visibility [7b4ea24]
+* Non resizable apps can not be maximized (fixes resizable on mac) #872 [b08b215]
+* Keypress#remove removes the keys listener and does not blow up [498588c]
+* Run shape blocks with app as self [dbb0a46]
+* When an element is removed or removed, cursor shouldn't change shape over that location. [918288f, 7fcd93a]
+* Removing children from slot should trigger redraw [be35743]
+* Fix for allowing widgets to use widget DSL methods [99d22e1]
+* Fix for secret on edit lines [79c4c98]
+* Fix crash computing height with hidden elements [41ebafe]
+* Fix for unbounded height crash on centering [11fc3ae]
+* Windows build requires shoes.bat from ext/install [232ec68]
+* Reuse created fonts in the factory [7959bd8]
+* Disposal of Shape SWT resources. [650365b]
+* Fix for offsetting of second text segments [97fe79b]
+* Consider relatively positioned elements for slot height [3e71126]
+* Fix fatal exceptions in samples/simple-calc.rb [d53d588]
+* Fix slot clearing [3697802]
+* Don't clear top_slot when clear is called, clear current_slot [a57778c]
+* Handling for text centering [87405f5]
+* Fix common remove to allow removal of slots [c25df7e]
+* Clear transform after painting each object, to avoid side effects on other painters [5a57ce3]
+* Fix off by one error in slot positioning. [baee69a]
+* Dispose of transform resources. [265600c]
+* Only report start/end relative to the parent if there is one [c82e763]
+* Links must be cleared on TextBlock#replace [4b90786]
+
+Contributors (16)
+-----------------
+
+Jason R. Clark, Eric Watson, Tobias Pfeiffer, KC Erb, Charles Chamberlain,
+George, Marcell Monteiro Cruz, Glenn Murray, Jason Clark, Tim Krajcar,
+glenn-murray-bse, KCErb, PeterWAWood, Suirtimed, ashbb, Carlos R Tirado

data/Gemfile

@@ -1,3 +1,24 @@
 source 'https://rubygems.org'
 
-gemspec
+gemspec :name => 'shoes'
+gemspec :name => 'shoes-dsl'
+gemspec :name => 'shoes-swt'
+
+group :development do
+  gem "guard"
+  gem "guard-rspec"
+  gem "pry"
+
+  gem "rspec", "~>3.0.0"
+  gem "rspec-its", "~>1.0.1"
+  gem "rake"
+
+  gem "yard"
+  gem "kramdown"
+  gem 'simplecov'
+  gem 'coveralls'
+  gem "codeclimate-test-reporter"
+  gem 'jruby-lint'
+  gem 'webmock'
+  gem 'hometown'
+end

data/README.md

@@ -1,13 +1,12 @@
-# shoes4 [![Build Status](https://secure.travis-ci.org/shoes/shoes4.svg?branch=master)](http://travis-ci.org/shoes/shoes4)[![Code Climate](https://img.shields.io/codeclimate/github/shoes/shoes4.svg)](https://codeclimate.com/github/shoes/shoes4)[![Coverage Status](https://img.shields.io/coveralls/shoes/shoes4/badge/master.svg)](https://coveralls.io/r/shoes/shoes4)[![Dependency Status](https://img.shields.io/gemnasium/shoes/shoes4.svg)](https://gemnasium.com/shoes/shoes4)
+# shoes4 [![Build Status](https://secure.travis-ci.org/shoes/shoes4.svg?branch=master)](http://travis-ci.org/shoes/shoes4)[![Code Climate](https://img.shields.io/codeclimate/github/shoes/shoes4.svg)](https://codeclimate.com/github/shoes/shoes4)[![Coverage Status](https://img.shields.io/coveralls/shoes/shoes4.svg)](https://coveralls.io/r/shoes/shoes4?branch=master)[![Dependency Status](https://img.shields.io/gemnasium/shoes/shoes4.svg)](https://gemnasium.com/shoes/shoes4)
 
 Shoes 4 : the next version of Shoes
 
-## Still in development
+## Pre-alpha
 
-Hi there, thanks for checking by! Shoes4 is still in development. It doesn't support all of the shoes DSL just yet.
-But if you want to check it out, that's awesome! If you're not too adventurous just yet you can still use the [old shoes](https://github.com/shoes/shoes)!
+Hi there, thanks for checking by! Shoes 4 is still pre-alpha software. It currently supports almost all of the shoes DSL, but there are still some spots where you might get surprising results. If you're not too adventurous just yet you can still use the [old shoes](https://github.com/shoes/shoes)!
 
-There is a first preview release now :)
+There is a first [preview release](https://rubygems.org/gems/shoes/versions/4.0.0.pre1) now :)
 
 ## Installing Shoes4
 
@@ -19,11 +18,20 @@ There are two ways to get your hands on shoes 4 - the preview gem release and in
 So your first step is to install a [JDK](http://www.oracle.com/technetwork/java/javase/downloads/) (shoes also works with [OpenJDK](http://openjdk.java.net/)) and [JRuby](http://jruby.org). Make sure to grab the appropriate JRuby version for your operating system. On Linux/Mac you can also use ruby installation tools to install JRuby. For instance [rvm](http://rvm.io/):
 
     $ rvm install jruby
+    
+**Important JRuby version note:** JRuby 1.7.14 and 1.7.15 have a bug where `bundle install` won't work with shoes4. Make sure to use JRuby 1.7.16 or JRuby-1.7.13 with shoes4.
+    
+**JDK version note:** While shoes4 should generally work with JDK version 6 and up we recommend to use newer version. Also within the JDK major version make sure to have the latest updates installed, we had cases where newer versions resolved bugs.
 
 ### Installing Shoes4 as a gem
 
-    gem install shoes --pre
+#### *nix (Mac OSX/Linux)
+
+    $ gem install shoes --pre
 
+#### Windows
+
+    C:\tmp> jruby -S gem install shoes --pre
 
 ### Installing Shoes4 from github
 
@@ -64,7 +72,7 @@ Shoes 4 comes with a command-line app runner. Just pass it the filename of your
 
     $ bin/shoes samples/simple-sound.rb
 
-**Note:** For Windows, `C:\tmp\shoes4>bin\shoes samples\simple-sound.rb`
+**Note:** For Windows, `C:\tmp\shoes4>bin\shoes samples\simple-sound.rb` If you installed Shoes4 as a gem, just do `C:\tmp> shoes path\to\file.rb`
 
 There is also a simple ruby starter script which you may use as follows:
 
@@ -78,6 +86,10 @@ Another alternative yet is to put `require 'shoes'` at the top of your applicati
 
     $ jruby path/to/file.rb
 
+On OS X you still need to supply the additional parameters to JRuby
+
+    $ jruby -J-XstartOnFirstThread path/to/file.rb
+
 ## Want to see what shoes can do?
 
 You can run `rake samples` and random samples we believe are working will be run until you quit with Ctr + C. Some of them are really simple, while others are more complex or even games!
@@ -89,8 +101,7 @@ Packaging is just a baby, so be gentle.
 
 In order to package an app, you need to have the Shoes gem installed in your environment. If you didn't do the gem installation you can always generate a gem and install it from the current source:
 
-    $ rake gem
-    $ gem install pkg/shoes-4.0.0.pre1.gem
+    $ rake install:all
 
 Now, you can package an app. But first, look here:
 
@@ -103,11 +114,17 @@ Now, you can package an app. But first, look here:
 
 That's Warbler talking. Actually, we sneak the Shoes gem in anyway, but don't tell.
 
-Okay, now for real. The simplest thing is to put your script in a directory by itself and then
+Okay, now for real. The simplest thing is to put your script in a directory by itself and then:
 
     $ bin/shoes -p swt:app path/to/directory-of/your-shoes-app.rb
 
-You'll find your app at `path/to/directory-of/pkg/Shoes App.app`.
+This will produce a Mac app, which you can then find at `path/to/directory-of/pkg/Shoes App.app`.
+
+You can also package a shoes app up as a jar through:
+
+    $ bin/shoes -p swt:jar path/to/directory-of/your-shoes-app.rb
+
+You can find the jar in the same directory as above, i.e. path/to/directory-of/pkg/your-shoes-app.jar
 
 If you want more control (like you want to name your app something besides "Shoes App", or you don't want to include all of those files we talked about before), make an `app.yaml` file. See [the example](https://github.com/shoes/shoes4/blob/master/app.yaml) for more details.
 
@@ -135,8 +152,6 @@ Also there is a list of samples that already work at samples/README, along with
 
 With all you do, please make sure to write specs as Shoes 4 is developed TDD-style (see the [Running Specs](https://github.com/shoes/shoes4#running-specs) section below). So make sure that you don't break any tests :-)
 
-We write our specs in rspec and are currently in the process of migrating from the old `should` syntax to the [new `expect` syntax](http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax). We basically say that whenever you touch a spec it'd be good if you converted it to the new syntax. Also new specs should be written in the new expect syntax.
-
 If you feel unsure about testing or your implementation just open an issue or a pull request. Pull requests don't need to be done - they are great discussion starters! We're happy to help you get your contribution ready to be merged in order to help build Shoes 4!
 
 In fact we greatly appreciate early pull requests to review code and help you find your way around Shoes4! =)

data/Rakefile

@@ -1,217 +1,14 @@
 require 'rake'
 require 'rake/clean'
-require 'rubygems/package_task'
+
 require 'rspec/core/rake_task'
-require 'bundler/gem_tasks'
+
+require_relative 'tasks/changelog'
+require_relative 'tasks/gem'
+require_relative 'tasks/rspec'
+require_relative 'tasks/sample'
+require_relative 'tasks/yard'
 
 PACKAGE_DIR = 'pkg'
-SAMPLES_DIR = "samples"
 
 CLEAN.include FileList[PACKAGE_DIR, 'doc', 'coverage', "spec/test_app/#{PACKAGE_DIR}"]
-
-# Necessary for tasks to have description which is convenient in a few cases
-Rake::TaskManager.record_task_metadata = true
-
-require 'jruby'
-JRuby.runtime.instance_config.runRubyInProcess = false
-
-# thanks Dan Lucraft!
-def jruby_run(cmd, swt = false)
-  opts = "-J-XstartOnFirstThread" if swt && RbConfig::CONFIG["host_os"] =~ /darwin/
-
-  # see https://github.com/jruby/jruby/wiki/FAQs
-  # "How can I increase the heap/memory size when launching a sub-JRuby?"
-  sh( "jruby --debug --1.9 -Ispec #{opts} -S #{cmd}" )
-end
-
-def rspec(files, options = "")
-  rspec_opts = "#{options} #{files}"
-  "rspec --tty #{rspec_opts}"
-end
-
-# run rspec in separate Jruby JVM
-# options :
-#   :swt - true/false(default)  When True, will run Jruby with SWT-required -X-startOnFirstThread
-#   :rspec - string  Options to pass to Rspec commandline.
-#
-def jruby_rspec(files, args)
-  swt = args.delete(:swt)
-  rspec_opts = spec_opts_from_args(args)
-  rspec_opts << " #{ENV['RSPEC_OPTS']}"
-
-  jruby_run(rspec(files, rspec_opts), swt)
-
-  #out = jruby_run(rspec(files, rspec_opts), swt)
-  #ok, result = out.split("\n").last
-  #examples_failures = result.match /\d* examples, \d* failures/
-
-  #return { :examples => examples_failures[1], :failures => examples_failures[2] }
-end
-
-def spec_opts_from_args(args)
-  opts = []
-  opts << "-e ::#{args[:module]}" if args[:module]
-  opts += Array(args[:require]).map {|lib| "-r#{lib}"}
-  opts += args[:excludes].map { |tag| "--tag ~#{tag}:true" } if args[:excludes]
-  opts += args[:includes].map { |tag| "--tag #{tag}:true" } if args[:includes]
-  opts.join ' '
-end
-
-def swt_args(args)
-  args = args.to_hash
-  args[:swt] = true
-  args[:require] = 'swt_shoes/spec_helper'
-  # Adjust includes/excludes appropriately
-  # args[:includes] = [:swt]
-  args[:excludes] = [:no_swt]
-  args[:excludes] << :fails_on_osx if RbConfig::CONFIG["host_os"] =~ /darwin/
-  args
-end
-
-task :default => :spec
-
-desc "Run All Specs"
-task :spec, [:module] => "spec:all" do
-
-end
-
-namespace :spec do
-  desc "Run All Specs / All Modules"
-  task :default => ["spec:all"]
-
-  desc "Run Specs on Shoes + All Frameworks
-  Limit the examples to specific :modules :
-    Animation
-    App
-    Button
-    Flow
-
-  ie. $ rake spec:all[Flow]
-  "
-  task "all", [:module] do |t, args|
-    Rake::Task["spec:shoes"].invoke(args[:module])
-    Rake::Task["spec:swt"].invoke(args[:module])
-  end
-
-  task :swt, [:module] do |t, args|
-    Rake::Task['spec:swt:all'].invoke(args[:module])
-  end
-
-  namespace :swt do
-    desc "Run all specs with SWT backend
-    Limit the examples to specific :modules : "
-    task :all, [:module] do |t, args|
-      argh = swt_args(args)
-      files = (Dir['spec/swt_shoes/*_spec.rb'] + Dir['spec/shoes/*_spec.rb']).join ' '
-      jruby_rspec(files, argh)
-    end
-
-    desc "Run isolated Swt backend specs"
-    task :isolation, [:module] do |t, args|
-      argh = swt_args(args)
-      files = Dir['spec/swt_shoes/*_spec.rb'].join ' '
-      jruby_rspec(files, argh)
-    end
-
-    desc "Run integration specs with Swt backend"
-    task :integration, [:module] do |t, args|
-      argh = swt_args(args)
-      files = Dir['spec/shoes/*_spec.rb'].join ' '
-      jruby_rspec(files, argh)
-    end
-  end
-
-  desc "Specs for base Shoes libraries
-  Limit the examples to specific :modules : "
-  task "shoes", [:module] do |t, args|
-    argh = args.to_hash
-    files = Dir['spec/shoes/**/*_spec.rb'].join ' '
-    jruby_rspec(files, argh)
-  end
-
-end
-
-desc "Working with samples"
-namespace :samples do
-
-  def samples_from_file(filename)
-    samples = File.read("#{SAMPLES_DIR}/#{filename}").lines
-    samples.map {|s| s.sub(/#.*$/, '')}.map(&:strip).select {|s| s != ''}.map {|s| "#{SAMPLES_DIR}/#{s}"}
-  end
-
-  def working_samples
-    samples = samples_from_file "README"
-    puts "#{samples.size} samples are known to work"
-    samples
-  end
-
-  def non_samples
-    all_samples = Dir[File.join(SAMPLES_DIR, '*.rb')]
-    result = all_samples - working_samples
-    puts "#{result.size} samples are not known to work"
-    result
-  end
-
-  def run_sample(sample_name, index, total)
-    print "Running #{sample_name} (#{index + 1} of #{total})...quit to run next sample"
-    system "bin/shoes #{sample_name}"
-  end
-
-  def run_samples(samples)
-    samples.each_with_index do |sample, index|
-      run_sample(sample, index, samples.size)
-    end
-  end
-
-  desc "Run all working samples in random order"
-  task :random do |t|
-    puts t.comment
-    run_samples working_samples.shuffle
-  end
-
-  desc "Run all working samples in alphabetical order"
-  task :good do |t|
-    puts t.comment
-    run_samples working_samples.sort
-  end
-
-  desc "Run all non-working samples in random order"
-  task :bad do |t|
-    puts t.comment
-    run_samples non_samples.shuffle
-  end
-
-  desc "Create list of non-working samples"
-  task :bad_list do |t|
-    puts t.comment
-    non_samples.each{|non_sample| puts non_sample}
-  end
-
-  desc "Run all samples listed in samples/filename"
-  task :subset, [:filename] do |t, args|
-    puts t.comment
-    run_samples samples_from_file(args[:filename])
-  end
-end
-
-task :samples     => ['samples:random']
-task :non_samples => ['samples:bad']
-task :list_non_samples => ['samples:bad_list']
-
-begin
-  require 'yard'
-
-  YARD::Rake::YardocTask.new do |t|
-    t.options = ['-mmarkdown']
-  end
-rescue LoadError
-  desc "Generate YARD Documentation"
-  task :yard do
-    abort 'YARD is not available. Try: gem install yard'
-  end
-end
-
-spec = Gem::Specification.load('shoes.gemspec')
-Gem::PackageTask.new(spec) do |gem|
-  gem.package_dir = PACKAGE_DIR
-end