hasu 0.1.1 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: a45d0dbe556192cdd7439d67b88b687a6169161b
-  data.tar.gz: 6f286b979b972a9f4329892d0f0e31280749894f
+SHA256:
+  metadata.gz: 8583e858bca02a15e8c5c5f4f61c929f0cc8de1df248df46c0c0188920d5e34c
+  data.tar.gz: 30c6cc0b25dcdd2c80108ab5c02dfb0b56d6a2f0fe5258eb06e414ddcd2af2e8
 SHA512:
-  metadata.gz: d22f2e8e1f42f3dc0cca7f44bb42d125b8519e8a3518ac1bf7be26888d1c1b277a1888133e62ba2a369f899f58809b82d684317db5bcd8eabcb2f70afb1b062d
-  data.tar.gz: f0b3fe40df87ac9840e4a7ed5b6a5d111ca14c52542f45adb199915f4d7b8bc0f51bd864b5463937048e5d78875207a15fdbf83bb2b5ae6ff6dd520f4fb17e68
+  metadata.gz: 3c6aa1c076649850a2bf7806274b2513abea42e8876cde7cdc5c256b90ab8faaacbfffdf7bc2bd6e0e6d7bd1c029aa6a11c26a95ebfb84275152f516464bbed9
+  data.tar.gz: '009c6cfd365db7a2842d2e60c8b219312523f886fb96dd2e8b059e199504690ec4900b5b1c1fdad24d12f2f4510f65a33fd92526fbeacaf7d01bbee234c5fc65'

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/guard.rb

@@ -0,0 +1,52 @@
+module Hasu
+  module Guard
+    def update(*)
+      if Hasu.reload!
+        Hasu.error = nil
+      end
+      unless Hasu.error
+        super
+      end
+    rescue => e
+      Hasu.error = e
+    end
+
+    def reset
+      super  if defined?(super)
+      Hasu.error = nil
+    rescue => e
+      Hasu.error = e
+    end
+
+    def draw(*)
+      if Hasu.error
+        ([Hasu.error.inspect] + Hasu.error.backtrace).each_with_index do |line, i|
+          _hasu_font.draw_text(line.gsub("\n",''), 10, 10 + i * 16, 0)
+        end
+      else
+        begin
+          super
+        rescue => e
+          Hasu.error = e
+          draw
+        end
+      end
+    end
+
+    def _hasu_font
+      @_hasu_font ||= Gosu::Font.new(self, Gosu::default_font_name, 16)
+    end
+
+    def button_down(id)
+      if id == Gosu::KbR
+        reset
+      else
+        begin
+          super(id)
+        rescue => e
+          Hasu.error = e
+        end
+      end
+    end
+  end
+end

data/lib/hasu/version.rb

@@ -1,3 +1,3 @@
 module Hasu
-  VERSION = "0.1.1"
+  VERSION = "0.1.6"
 end

data/lib/hasu/window.rb

@@ -1,71 +1,27 @@
 require "gosu"
-
-class Hasu::Window < Gosu::Window
-  def self.inherited(other)
-    includer = caller.first.split(":").first
-    Hasu.reloads[includer] = File.mtime(includer)
-  end
-
-  def self.run
-    unless @running
-      @running = true
-      new.show
+require "hasu/guard"
+
+module Hasu
+  class Window < Gosu::Window
+    def self.inherited(other)
+      includer = caller.first.split(":").first
+      Hasu.reloads[includer] = File.mtime(includer)
+      if other.respond_to?(:prepend, true)
+        other.send(:prepend, Hasu::Guard)
+      else
+        warn "Most of Hasu's nifty features (e.g. error catching, file reloading) are only available on Ruby >= 2.0."
+      end
     end
-  end
 
-  def initialize(*)
-    super
-    reset
-  end
-
-  def update(*)
-    if Hasu.reload!
-      Hasu.error = nil
-    end
-    unless Hasu.error
+    def initialize(*)
       super
+      reset  unless Hasu.error
     end
-  rescue => e
-    Hasu.error = e
-  end
-
-  def reset
-    super  if defined?(super)
-    Hasu.error = nil
-  rescue => e
-    Hasu.error = e
-  end
-
-  def draw(*)
-    if Hasu.error
-      ([Hasu.error.inspect] + Hasu.error.backtrace).each_with_index do |line, i|
-        _hasu_font.draw(line.gsub("\n",''), 10, 10 + i * 16, 0)
-      end
-    else
-      begin
-        super
-      rescue => e
-        Hasu.error = e
-        draw
-      end
-    end
-  end
-
-  def _hasu_font
-    @_hasu_font ||= Gosu::Font.new(self, Gosu::default_font_name, 16)
-  end
 
-  def button_down(id)
-    case id
-    when Gosu::KbEscape
-      close
-    when Gosu::Window.char_to_button_id('r')
-      reset
-    else
-      begin
-        super(id)
-      rescue => e
-        Hasu.error = e
+    def self.run(*args)
+      unless @running
+        @running = true
+        new(*args).show
       end
     end
   end

data/todo

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

metadata

@@ -1,55 +1,55 @@
 --- !ruby/object:Gem::Specification
 name: hasu
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.6
 platform: ruby
 authors:
 - Michael Fairley
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-13 00:00:00.000000000 Z
+date: 2020-06-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gosu
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: Prototype Gosu games with ease
@@ -59,17 +59,22 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - Gemfile
 - 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
@@ -80,17 +85,16 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 3.0.1
 signing_key: 
 specification_version: 4
 summary: Prototype Gosu games with ease