hasu 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b3cfdb948da98b6e0712df3e70d5632c96122f95
-  data.tar.gz: 548c124e21f6282c6a38a5b99907bc7da88ca2a8
+  metadata.gz: b2f7ee58112372fb8e8114ae99fc4a7b8befe080
+  data.tar.gz: 736cb6f783a78dc33339df3cc2660ff29d400ebe
 SHA512:
-  metadata.gz: d1d630051aa3183af6e2cebeaaf61c731bf0489eaf2c25d6de96842e0ce8864a989e7c6087eb527fcda7b1a6ed4752c7b9c8391a5c648dc2428daf27d95ca43d
-  data.tar.gz: 8f8e1b297e61a1280b7a905da1ab451081a7c26ee374a215f5e0b50503aaf3ec8a1cda2415ca2ae49d8c385ce3e947fbc81713b5ebe59e2dbba3c16fe532c972
+  metadata.gz: 9c3d778bf199a8d6d2314d1dd0ef65f70dc460fec6ff75eb75098290a6db82ee4f160b1c301c8f679a6c8f98aef476b117030ca40d4157530c60a11ad577a712
+  data.tar.gz: e44614e265e3bcf6a23ff988676e35a3c54b0d0a824076cfdea4f907e6fc9929a7499b13ac3604c8bdc0064907fb2f34218a0a2a55c592e8c58d123be820cb21

data/README.md

@@ -1 +1,94 @@
-Makes iterating with Gosu more better.
+# Hasu
+
+Helps you develop [Gosu](http://www.libgosu.org/) games more quickly.
+
+## How?
+
+### Hot code loading
+
+Normally, when you change the code for a Gosu game, you have to close and restart the game for the code to take affect.
+With Hasu, modified source files will be reloaded each time through the game loop.
+
+### Exception catching
+
+When an exception bubbles up out of your game loop, Gosu will crash.
+When an exception occurs in a Hasu game, Hasu pauses your game, prints the exception details into your window, and resumes your game once the code that fixes it is loaded.
+
+### Reset
+
+Hot code loading unfortunately is worthless for your `initialize` method since your window will only be initialized once,
+Instead of putting your game's setup code in `initialize`, place it in `reset` and press R whenever you want to re-initialize your game state.
+
+## Using Hasu
+
+__The above features only work on Ruby 2+, though Hasu will still load on earlier versions (in case you want to pack up your game with Releasy).__
+
+### 0: Install Hasu
+
+Add this line to your application's Gemfile:
+
+    gem hasu
+
+Or install it yourself as:
+
+    $ gem install hasu
+
+### 1: Subclass `Hasu::Window` (or prepend `Hasu::Guard`).
+
+Instead of subclassing `Gosu::Window`, use `Hasu::Window`:
+
+```ruby
+class Game < Hasu::Window
+  def initialize
+    super(640, 480, false)
+  end
+
+  def reset
+    # ...
+  end
+
+  def update
+    # ...
+  end
+
+  def draw
+    # ...
+  end
+end
+```
+
+If you're using Chingu (or another library which has its own window subclass), you can prepend `Hasu::Guard` onto your window for the same effect:
+
+```ruby
+class Game < Chingu::Window
+  prepend Hasu::Guard
+
+  def initialize
+    super(640, 480, false)
+  end
+
+  def reset
+    # ...
+  end
+
+  def update
+    # ...
+  end
+
+  def draw
+    # ...
+  end
+end
+```
+
+### 2: Use `Hasu.load` to require your game's files.
+
+For the files you want to be hot loaded, use `Hasu.load` instead of `require`.
+
+```ruby
+Hasu.load "ball.rb"
+```
+
+### 3: Run your game with `.run`
+
+Instead of `Game.new.show`, run your Hasu game with `Game.run`.

data/examples/chingu/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+gem "hasu", :path => "../../"
+gem "chingu"

data/examples/chingu/ball.rb

@@ -0,0 +1,30 @@
+class Ball < Chingu::GameObject
+  SIZE = 20
+
+  def initialize(*)
+    super
+
+    @x = 320
+    @y = 240
+
+    @dx = rand * 10
+    @dy = rand * 10
+  end
+
+  def update
+    @x += @dx
+    if @x < 0 || @x > 640
+      @dx *= -1
+    end
+
+    @y += @dy
+    if @y < 0 || @y > 480
+      @dy *= -1
+    end
+  end
+
+  def draw
+    rect = Chingu::Rect.new(@x - SIZE/2, @y - SIZE/2, SIZE, SIZE)
+    $window.draw_rect(rect, Gosu::Color::RED, 0)
+  end
+end

data/examples/chingu/game.rb

@@ -0,0 +1,20 @@
+require "chingu"
+require "hasu"
+
+Hasu.load "ball.rb"
+
+class Game < Chingu::Window
+  prepend Hasu::Guard
+
+  def initialize
+    super(640, 480, false)
+    reset
+  end
+
+  def reset
+    Ball.create
+    Ball.create
+  end
+end
+
+Game.new.show

data/lib/hasu/version.rb

@@ -1,3 +1,3 @@
 module Hasu
-  VERSION = "0.1.4"
+  VERSION = "0.1.5"
 end

data/lib/hasu/window.rb

@@ -18,10 +18,10 @@ module Hasu
       reset  unless Hasu.error
     end
 
-    def self.run
+    def self.run(*args)
       unless @running
         @running = true
-        new.show
+        new(*args).show
       end
     end
   end

data/todo

@@ -0,0 +1,4 @@
+guard "macro"
+dead code removal
+autoload?
+constant reloading?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hasu
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Michael Fairley
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-23 00:00:00.000000000 Z
+date: 2014-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gosu
@@ -64,13 +64,17 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- example/example.rb
-- example/rect.rb
+- examples/chingu/Gemfile
+- examples/chingu/ball.rb
+- examples/chingu/game.rb
+- examples/gosu/example.rb
+- examples/gosu/rect.rb
 - hasu.gemspec
 - lib/hasu.rb
 - lib/hasu/guard.rb
 - lib/hasu/version.rb
 - lib/hasu/window.rb
+- todo
 homepage: https://github.com/michaelfairley/hasu
 licenses:
 - MIT