joyce 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 17b6e2acc99201cb764f1396588e676e9ea884d9
+  data.tar.gz: 8b762837b8aaffcfe6383e2634132e4050d3858e
+SHA512:
+  metadata.gz: 83f8879e432dfd00cfaaa771d71f55d87112d6ec631af93ce5bcb46bbc91d4415b73dcc47ef06cee20f07b32b36315723783357322441b052eec750df8f2f387
+  data.tar.gz: 36053b131206f044b7e6587f09c34e166d04df90c01648d068149da0373f7fc2988821116236821d8eb98abc4a6b47fc97f2cd8dcaa59fb1319c887a6eef7429

data/.document

@@ -0,0 +1,3 @@
+- 
+ChangeLog.md
+LICENSE.txt

data/.gitignore

@@ -0,0 +1,6 @@
+/.bundle
+/.yardoc/
+/Gemfile.lock
+/doc/
+/pkg/
+/vendor/cache/*.gem

data/.rspec

@@ -0,0 +1 @@
+--colour --format documentation --tag ~@flaky

data/.yardopts

@@ -0,0 +1 @@
+--markup markdown --title "joyce Documentation" --protected

data/ChangeLog.md

@@ -0,0 +1,4 @@
+### 0.1.0 / 2016-04-07
+
+* Initial release:
+

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'gosu'
+gem 'metacosm'
+
+group :development do
+  gem 'kramdown'
+  gem 'pry'
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2016 Joseph Weissman
+
+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/README.md

@@ -0,0 +1,241 @@
+# joyce
+
+
+* [Homepage](https://rubygems.org/gems/joyce)
+* [Documentation](http://rubydoc.info/gems/joyce/frames)
+* [Email](mailto:jweissman1986 at gmail.com)
+
+[![Code Climate GPA](https://codeclimate.com/github//joyce/badges/gpa.svg)](https://codeclimate.com/github//joyce)
+
+## Description
+
+Joyce is a multiplayer game server framework built on top of Metacosm
+
+## What is the big idea?
+
+The idea is to build 'isomorphic' Ruby games: to target both a Gosu game client as well as a game server
+running in the cloud. Both are running the same code, but the responsibilities are split: 
+
+  - The game server runs game business logic, and publishes events that the clients consume to hydrate their local views
+  - Clients publish commands the the server validates and handles, updating game state and generating events
+
+One upshot of this is that all game processing is kept on the server, and clients are doing nothing but
+rendering views and when necessary figuring out what commands to publish (when the user interacts).
+
+## Features
+
+## Examples
+
+    Below is the source for a toy app that displays a list of other connected players and how long they've been connected. The server uses a ping command from clients to determine if players have disconnected.
+
+    ```ruby
+    require 'joyce'
+    module Example
+      class SampleAppView < Joyce::ApplicationView
+        def render
+          game_view.render(window, font)
+        end
+
+        def game_view
+          GameView.find_by active_player_id: application.player_id
+        end
+      end
+
+      class SampleServer < Joyce::Server
+        def setup
+          # p [ :sample_server_setup ]
+          Game.create
+        end
+
+        def tick
+          # p [ :sample_server_tick ]
+          Game.all.each(&:iterate!)
+        end
+      end
+
+      class Application < Joyce::Application
+        viewed_with Example::SampleAppView
+
+        def setup
+          # p [ :sample_app_setup ]
+          GameView.create(active_player_id: player_id)
+          sim.params[:active_player_id] = player_id
+        end
+
+        def tick
+          @ticks ||= 0
+          @ticks += 1
+          # p [ :sample_app_tick ]
+          if (@ticks % 30 == 0)
+            fire(PingCommand.create(player_id: player_id, player_name: player_name))
+          end
+        end
+
+        def player_id
+          @player_id ||= SecureRandom.uuid
+        end
+
+        def player_name
+          @player_name ||= %w[ Alice Bob Cardiff Danielle Echo Fargo ].sample
+        end
+      end
+
+      class BulletPointAtom
+        def render(color: 0xf0f0f0f0, location:,size: 10,window:)
+          x,y = location
+          window.draw_quad(x,y,color,
+                           x,y+size,color,
+                           x+size,y,color,
+                           x+size,y+size,color)
+        end
+      end
+
+      class TextBoxAtom
+        def render(message:, location:, font:)
+          x,y = *location
+          font.draw(message, x, y, 1)
+        end
+      end
+
+      class ListMolecule
+        def render(title: '', elements:, location:, font:, window:)
+          x0,y0 = location
+          font.draw(title, x0, y0, 1)
+          elements.each_with_index do |element, index|
+            x, y = x0, y0 + ((index+1)*20)
+
+            bullet_point = BulletPointAtom.new
+            bullet_point.render(location: [x-10,y], window: window)
+
+            text_box = TextBoxAtom.new
+            text_box.render(message: element, location: [x,y], font: font)
+          end
+        end
+      end
+
+      class PlayerView < Metacosm::View
+        belongs_to :game_view
+        attr_accessor :name, :joined_at, :player_id
+      end
+
+      class GameView < Metacosm::View
+        has_many :player_views
+
+        attr_accessor :active_player_id, :game_id
+        # attr_accessor :player_names
+
+        def render(window, font)
+          # p [ :render_game_view, pinged_at: pinged_at ]
+          window.draw_quad(10,10, 0xf0f0f0f0,
+                           10,20, 0xf0f0f0f0,
+                           20,10, 0xf0f0f0f0,
+                           20,20, 0xf0f0f0f0)
+
+          if player_names && player_names.any?
+            ListMolecule.new.render(
+              title: "Connected Users:",
+              elements: player_names,
+              location: [40,40],
+              font: font,
+              window: window
+            )
+          end
+        end
+
+        private
+        def player_names
+          self.player_views.map { |p| "#{p.name} (#{time_ago_in_words(p.joined_at)})" } #(&:name)
+        end
+      end
+
+      class PingCommand < Metacosm::Command
+        attr_accessor :player_id, :player_name
+      end
+
+      class PingCommandHandler
+        def handle(player_id:, player_name:)
+          p [ :ping, from_player: player_id ]
+          game = Game.find_by(players: { id: player_id })
+          if game.nil?
+            # we could try to create a new game for the player?
+            # or add them to an existing one?
+            p [ :no_game_yet! ]
+
+            game = Game.first || Game.create
+            game.admit_player(player_id: player_id, player_name: player_name)
+          end
+
+          game.ping(player_id: player_id)
+        end
+      end
+
+      #
+      # class GameController
+      #   def ping(player_id:, player_name:)
+      #     game = Game.find_by ...
+      #   end
+      # end
+      #
+
+      class ApplicationEventListener < Metacosm::EventListener
+        def game_view
+          GameView.find_by(active_player_id: active_player_id)
+        end
+
+        def active_player_id
+          self.simulation.params[:active_player_id]
+        end
+      end
+
+      class PlayerAdmittedEvent < Metacosm::Event
+        attr_accessor :player_id, :player_name, :connected_player_list
+      end
+
+      class PlayerAdmittedEventListener < ApplicationEventListener
+        def receive(player_id:, player_name:, connected_player_list:)
+          p [ :player_admitted_event_listener ]
+          if game_view
+            # game_view.create_player_view(player_id: player_id, name: player_name, joined_at: Time.now)
+            # go through connected player list and make views...
+            connected_player_list.each do |id:, name:, joined_at:|
+              player_view = game_view.player_views.where(player_id: id).first_or_create
+              player_view.update(name: name, joined_at: joined_at)
+            end
+          end
+        end
+      end
+
+      class PlayerDroppedEvent < Metacosm::Event
+        attr_accessor :player_id, :connected_player_list
+      end
+
+      class PlayerDroppedEventListener < ApplicationEventListener
+        def receive(player_id:, connected_player_list:)
+          p [ :player_dropped_event_listener! ]
+          if game_view
+            game_view.player_views.map(&:destroy)
+            connected_player_list.each do |id:, name:, joined_at:|
+              player_view = game_view.player_views.where(player_id: id).first_or_create
+              player_view.update(name: name, joined_at: joined_at)
+            end
+          end
+        end
+      end
+    end
+    ```
+
+## Requirements
+
+## Install
+
+    $ gem install joyce
+
+## Synopsis
+
+    $ joyce
+
+## Copyright
+
+Copyright (c) 2016 Joseph Weissman
+
+See {file:LICENSE.txt} for details.

data/Rakefile

@@ -0,0 +1,31 @@
+# encoding: utf-8
+
+require 'rubygems'
+
+begin
+  require 'bundler/setup'
+rescue LoadError => e
+  abort e.message
+end
+
+require 'rake'
+
+
+require 'rubygems/tasks'
+Gem::Tasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new
+
+task :test    => :spec
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new  
+task :doc => :yard
+
+require 'cucumber/rake/task'
+
+Cucumber::Rake::Task.new do |t|
+  t.cucumber_opts = %w[--format pretty]
+end

data/bin/joyce

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+root = File.expand_path(File.join(File.dirname(__FILE__),'..'))
+if File.directory?(File.join(root,'.git'))
+  Dir.chdir(root) do
+    begin
+      require 'bundler/setup'
+    rescue LoadError => e
+      warn e.message
+      warn "Run `gem install bundler` to install Bundler"
+      exit -1
+    end
+  end
+end

data/dump.rdb

@@ -0,0 +1 @@
+REDIS0006�ܳC�Z��V

data/example/application.rb

@@ -0,0 +1,203 @@
+require_relative 'models/game'
+require_relative 'models/player'
+
+module Example
+  class SampleAppView < Joyce::ApplicationView
+    def render
+      game_view.render(window, font)
+    end
+
+    def game_view
+      GameView.find_by active_player_id: application.player_id
+    end
+  end
+
+  class SampleServer < Joyce::Server
+    def setup
+      # p [ :sample_server_setup ]
+      Game.create
+    end
+
+    def tick
+      # p [ :sample_server_tick ]
+      Game.all.each(&:iterate!)
+    end
+  end
+
+  class Application < Joyce::Application
+    viewed_with Example::SampleAppView
+
+    def setup
+      # p [ :sample_app_setup ]
+      GameView.create(active_player_id: player_id)
+      sim.params[:active_player_id] = player_id
+    end
+
+    def tick
+      @ticks ||= 0
+      @ticks += 1
+      # p [ :sample_app_tick ]
+      if (@ticks % 30 == 0)
+        fire(PingCommand.create(player_id: player_id, player_name: player_name))
+      end
+    end
+
+    def player_id
+      @player_id ||= SecureRandom.uuid
+    end
+
+    def player_name
+      @player_name ||= %w[ Alice Bob Cardiff Danielle Echo Fargo ].sample
+    end
+  end
+
+  class BulletPointAtom
+    def render(color: 0xf0f0f0f0, location:,size: 10,window:)
+      x,y = location
+      window.draw_quad(x,y,color,
+                       x,y+size,color,
+                       x+size,y,color,
+                       x+size,y+size,color)
+    end
+  end
+
+  class TextBoxAtom
+    def render(message:, location:, font:)
+      x,y = *location
+      font.draw(message, x, y, 1)
+    end
+  end
+
+  class ListMolecule
+    def render(title: '', elements:, location:, font:, window:)
+      x0,y0 = location
+      font.draw(title, x0, y0, 1)
+      elements.each_with_index do |element, index|
+        x, y = x0, y0 + ((index+1)*20)
+
+        bullet_point = BulletPointAtom.new
+        bullet_point.render(location: [x-10,y], window: window)
+
+        text_box = TextBoxAtom.new
+        text_box.render(message: element, location: [x,y], font: font)
+      end
+    end
+  end
+
+  class PlayerView < Metacosm::View
+    belongs_to :game_view
+    attr_accessor :name, :joined_at, :player_id
+  end
+
+  class GameView < Metacosm::View
+    has_many :player_views
+
+    attr_accessor :active_player_id, :game_id
+    # attr_accessor :player_names
+
+    def render(window, font)
+      # p [ :render_game_view, pinged_at: pinged_at ]
+      window.draw_quad(10,10, 0xf0f0f0f0,
+                       10,20, 0xf0f0f0f0,
+                       20,10, 0xf0f0f0f0,
+                       20,20, 0xf0f0f0f0)
+
+      if player_names && player_names.any?
+        ListMolecule.new.render(
+          title: "Connected Users:",
+          elements: player_names,
+          location: [40,40],
+          font: font,
+          window: window
+        )
+      end
+    end
+
+    private
+    def player_names
+      self.player_views.map { |p| "#{p.name} (#{time_ago_in_words(p.joined_at)})" } #(&:name)
+    end
+  end
+
+  class PingCommand < Metacosm::Command
+    attr_accessor :player_id, :player_name
+  end
+
+  class PingCommandHandler
+    def handle(player_id:, player_name:)
+      p [ :ping, from_player: player_id ]
+      game = Game.find_by(players: { id: player_id })
+      if game.nil?
+        # we could try to create a new game for the player?
+        # or add them to an existing one?
+        p [ :no_game_yet! ]
+
+        game = Game.first || Game.create
+        game.admit_player(player_id: player_id, player_name: player_name)
+      end
+
+      game.ping(player_id: player_id)
+    end
+  end
+
+  #
+  # class GameController
+  #   def ping(player_id:, player_name:)
+  #     game = Game.find_by ...
+  #   end
+  # end
+  #
+
+  class ApplicationEventListener < Metacosm::EventListener
+    def game_view
+      GameView.find_by(active_player_id: active_player_id)
+    end
+
+    def active_player_id
+      self.simulation.params[:active_player_id]
+    end
+  end
+
+  class PlayerAdmittedEvent < Metacosm::Event
+    attr_accessor :player_id, :player_name, :connected_player_list
+  end
+
+  class PlayerAdmittedEventListener < ApplicationEventListener
+    def receive(player_id:, player_name:, connected_player_list:)
+      p [ :player_admitted_event_listener ]
+      if game_view
+        # game_view.create_player_view(player_id: player_id, name: player_name, joined_at: Time.now)
+        # go through connected player list and make views...
+        connected_player_list.each do |id:, name:, joined_at:|
+          player_view = game_view.player_views.where(player_id: id).first_or_create
+          player_view.update(name: name, joined_at: joined_at)
+        end
+      end
+    end
+  end
+
+  class PlayerDroppedEvent < Metacosm::Event
+    attr_accessor :player_id, :connected_player_list
+  end
+
+  class PlayerDroppedEventListener < ApplicationEventListener
+    def receive(player_id:, connected_player_list:)
+      p [ :player_dropped_event_listener! ]
+      if game_view
+        game_view.player_views.map(&:destroy)
+        connected_player_list.each do |id:, name:, joined_at:|
+          player_view = game_view.player_views.where(player_id: id).first_or_create
+          player_view.update(name: name, joined_at: joined_at)
+        end
+      end
+    end
+  end
+
+  # TODO sagas in metacosm (also controllers for commands...)
+  # class PlayerSaga < Metacosm::Saga
+  #   def player_dropped(player_id:, connected_player_list:)
+  #   end
+  #   def player_admitted(player_id:, player_name:, connected_player_list:)
+  #   end
+  # end
+end

data/example/models/game.rb

@@ -0,0 +1,66 @@
+module Example
+  class Game < Metacosm::Model
+    has_many :players
+
+    def iterate!
+      # check for dropped players
+      players_to_drop = self.players.all.select do |player|
+        player.pinged_at < 3.seconds.ago
+      end
+
+      players_to_drop.each do |player|
+        drop_player(player)
+      end
+
+      self
+    end
+
+    def ping(player_id:)
+      player = self.players.where(id: player_id).first
+      player.update(pinged_at: Time.now)
+      self
+    end
+
+    def admit_player(player_name:, player_id:)
+      self.players.create(
+        name: player_name,
+        id: player_id,
+        joined_at: Time.now,
+        pinged_at: Time.now
+      )
+
+      emit(
+        PlayerAdmittedEvent.create(
+          player_id: player_id,
+          player_name: player_name,
+          connected_player_list: connected_player_list,
+        )
+      )
+
+      self
+    end
+
+    private
+    def drop_player(player)
+      lost_player_id = player.id
+      player.destroy
+
+      emit(
+        PlayerDroppedEvent.create(
+          player_id: lost_player_id,
+          connected_player_list: connected_player_list
+        )
+      )
+    end
+
+    def connected_player_list
+      self.players.map do |player|
+        {
+          id: player.id,
+          name: player.name,
+          joined_at: player.joined_at
+        }
+      end
+    end
+  end
+end

data/example/models/player.rb

@@ -0,0 +1,6 @@
+module Example
+  class Player < Metacosm::Model
+    belongs_to :game
+    attr_accessor :name, :joined_at, :pinged_at
+  end
+end

data/features/joyce.feature

@@ -0,0 +1 @@
+Feature: Blah blah blah

data/features/step_definitions/joyce_steps.rb

@@ -0,0 +1 @@
+@wip

data/gemspec.yml

@@ -0,0 +1,21 @@
+name: joyce
+summary: "multiplayer game server framework"
+description: "isomorphic ruby games"
+license: MIT
+authors: Joseph Weissman
+email: jweissman1986@gmail.com
+homepage: https://rubygems.org/gems/joyce
+
+dependencies:
+  gosu: ~> 0.10  
+  metacosm: ~> 0.3
+  actionpack: ~> 4.2
+
+development_dependencies:
+  bundler: ~> 1.10
+  codeclimate-test-reporter: ~> 0.1
+  cucumber: ~> 0.10.2
+  rake: ~> 10.0
+  rspec: ~> 3.0
+  rubygems-tasks: ~> 0.2
+  yard: ~> 0.8

data/joyce.gemspec

@@ -0,0 +1,60 @@
+# encoding: utf-8
+
+require 'yaml'
+
+Gem::Specification.new do |gem|
+  gemspec = YAML.load_file('gemspec.yml')
+
+  gem.name    = gemspec.fetch('name')
+  gem.version = gemspec.fetch('version') do
+                  lib_dir = File.join(File.dirname(__FILE__),'lib')
+                  $LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+
+                  require 'joyce/version'
+                  Joyce::VERSION
+                end
+
+  gem.summary     = gemspec['summary']
+  gem.description = gemspec['description']
+  gem.licenses    = Array(gemspec['license'])
+  gem.authors     = Array(gemspec['authors'])
+  gem.email       = gemspec['email']
+  gem.homepage    = gemspec['homepage']
+
+  glob = lambda { |patterns| gem.files & Dir[*patterns] }
+
+  gem.files = `git ls-files`.split($/)
+  gem.files = glob[gemspec['files']] if gemspec['files']
+
+  gem.executables = gemspec.fetch('executables') do
+    glob['bin/*'].map { |path| File.basename(path) }
+  end
+  gem.default_executable = gem.executables.first if Gem::VERSION < '1.7.'
+
+  gem.extensions       = glob[gemspec['extensions'] || 'ext/**/extconf.rb']
+  gem.test_files       = glob[gemspec['test_files'] || '{test/{**/}*_test.rb']
+  gem.extra_rdoc_files = glob[gemspec['extra_doc_files'] || '*.{txt,md}']
+
+  gem.require_paths = Array(gemspec.fetch('require_paths') {
+    %w[ext lib].select { |dir| File.directory?(dir) }
+  })
+
+  gem.requirements              = Array(gemspec['requirements'])
+  gem.required_ruby_version     = gemspec['required_ruby_version']
+  gem.required_rubygems_version = gemspec['required_rubygems_version']
+  gem.post_install_message      = gemspec['post_install_message']
+
+  split = lambda { |string| string.split(/,\s*/) }
+
+  if gemspec['dependencies']
+    gemspec['dependencies'].each do |name,versions|
+      gem.add_dependency(name,split[versions])
+    end
+  end
+
+  if gemspec['development_dependencies']
+    gemspec['development_dependencies'].each do |name,versions|
+      gem.add_development_dependency(name,split[versions])
+    end
+  end
+end

data/lib/joyce.rb

@@ -0,0 +1,137 @@
+require 'gosu'
+require 'redis' # TODO move require to mc/remote_sim?
+require 'metacosm'
+require 'metacosm/remote_simulation'
+
+require 'action_view' # just for distance of time in words..
+include ActionView::Helpers::DateHelper
+
+require 'joyce/version'
+require 'joyce/application'
+
+module Joyce
+  EVENT_STREAM  = :joyce_event_stream
+  COMMAND_QUEUE = :joyce_command_queue
+
+  class ApplicationView
+    attr_reader :application
+
+    def initialize(application)
+      @application ||= application
+    end
+
+    def render
+      # ...
+    end
+
+    def window
+      @application.window
+    end
+
+    def font
+      @font ||= Gosu::Font.new(18)
+    end
+  end
+
+  class ApplicationWindow < Gosu::Window
+    attr_accessor :width, :height
+    attr_reader :app
+
+    def initialize(app, width: 800, height: 600)
+      @app = app
+      self.width  = width
+      self.height = height
+
+      super(self.width, self.height)
+    end
+
+    def draw
+      app.view.render
+    end
+
+    def update
+      app.tick
+    end
+  end
+
+  class NullWindow
+    attr_reader :app
+    def initialize(app, width: 800, height: 600)
+      # p [ :created_null_window, provided_dimensions: [ width, height ] ]
+      @app = app
+    end
+
+    def show
+      app.tick
+      false
+    end
+
+    def draw_quad(*)
+      # p [ :null_window, :draw_quad ]
+      self
+    end
+  end
+
+  class Server
+    def setup
+      # p [ :server_setup ]
+    end
+
+    def boot
+      sim.on_event(publish_to: EVENT_STREAM)
+      @cmd_thread = sim.subscribe_for_commands(channel: COMMAND_QUEUE)
+      setup
+      sim.conduct!
+      drive!
+      # cmd_thread.join
+    end
+
+    def join
+      @cmd_thread.join
+    end
+
+    def tick
+      # p [ :server_tick ]
+    end
+
+    def drive!
+      @driving = true
+      Thread.new do
+        while @driving
+          tick
+          sleep 0.05
+        end
+      end
+    end
+
+    def halt!
+      @driving = false
+    end
+
+    def sim
+      @simulation ||= Metacosm::Simulation.current
+    end
+
+    def received_commands
+      sim.received_commands
+    end
+
+    class << self
+      def kickstart!
+        server = new
+        server.boot
+        server
+      end
+    end
+  end
+
+  class RemoteSim < Metacosm::RemoteSimulation
+    def initialize
+      super(COMMAND_QUEUE, EVENT_STREAM)
+    end
+
+    def redis_connection
+      ::Redis.new
+    end
+  end
+end

data/lib/joyce/application.rb

@@ -0,0 +1,61 @@
+module Joyce
+  class Application
+    def initialize(headless: false)
+      @headless = headless
+    end
+
+    def setup
+      # ...
+    end
+
+    def tick
+      # ...
+    end
+
+    def launch
+      sim.conduct!
+      setup
+      window.show
+      self
+    end
+
+    def fire(cmd)
+      sim.fire(cmd)
+    end
+
+    def received_events
+      sim.received_events
+    end
+
+    def sim
+      @simulation ||= RemoteSim.current
+    end
+
+    def view
+      @view ||= construct_view
+    end
+
+    def window
+      @window ||= @headless ? NullWindow.new(self) : ApplicationWindow.new(self)
+    end
+
+    private
+    def construct_view
+      self.class.view_class.new(self)
+    end
+
+    class << self
+      attr_reader :view_class
+      def viewed_with(view_class)
+        @view_class ||= view_class
+        self
+      end
+
+      def kickstart!(headless: false)
+        app = new(headless: headless)
+        app.launch
+        app
+      end
+    end
+  end
+end

data/lib/joyce/version.rb

@@ -0,0 +1,4 @@
+module Joyce
+  # joyce version
+  VERSION = "0.1.2"
+end

data/spec/joyce_spec.rb

@@ -0,0 +1,91 @@
+require 'spec_helper'
+
+describe Joyce do
+  it "should have a VERSION constant" do
+    expect(subject.const_get('VERSION')).to_not be_empty
+  end
+end
+
+describe Joyce::Application do
+  describe '.kickstart' do
+    subject(:application) { instance_double(Joyce::Application) }
+    it 'should launch a new app instance' do
+      expect(Application).to receive(:new).and_return(application)
+      expect(application).to receive(:launch)
+      Application.kickstart!(headless: true)
+    end
+  end
+
+  describe "#launch" do
+    subject(:application) { Joyce::Application.new(headless: true) }
+    it 'should call #show on app window' do
+      expect(application.window).to receive(:show)
+      application.launch
+    end
+  end
+end
+
+describe Joyce::Server do
+  describe ".kickstart" do
+    subject(:server) { instance_double(Joyce::Server) }
+    it 'should call boot on a new server instance' do
+      expect(Server).to receive(:new).and_return(server)
+      expect(server).to receive(:boot)
+      Server.kickstart!
+    end
+  end
+end
+
+describe Example::Application do
+  subject(:app) { Example::Application.new(headless: true) }
+
+  it 'should have a view with the indicated class' do
+    expect(app.view.class).to eq(Example::SampleAppView)
+  end
+
+  context "#launch" do
+    it 'should call setup' do
+      expect(app).to receive(:setup)
+      app.launch
+    end
+  end
+end
+
+describe Example::SampleAppView do
+  let(:sample_app) { Example::Application.new(headless: true) }
+  let(:window) { instance_double(ApplicationWindow) }
+
+  subject(:sample_app_view) { sample_app.view }
+  before { sample_app.setup }
+
+  it 'should render to the app window' do
+    expect(sample_app).to receive(:window).and_return(window)
+    expect(window).to receive(:draw_quad)
+    sample_app_view.render
+  end
+end
+
+describe Example::SampleServer, redis: true, flaky: true do
+  subject(:server) { Example::SampleServer.new }
+  let(:app) { Example::Application.new(headless: true) }
+  let(:command) { Example::PingCommand.create(player_id: 'the_player_id', player_name: 'Alice') }
+  let(:event) { Example::PlayerAdmittedEvent.create( player_name: "Alice", player_id: 'the_player_id', connected_player_list: connected_player_list) }
+  let(:connected_player_list) do
+    [
+      { id: 'the_player_id', name: 'Alice', joined_at: 1.day.ago }
+    ]
+  end
+
+  before do
+    app.launch
+    server.boot
+  end
+
+  it 'should receive commands from app' do
+    expect { app.fire(command); sleep 3 }.to change{server.received_commands.count}.by(1)
+  end
+
+  it 'should propagate events to app' do
+    expect { server.sim.receive(event); sleep 3 }.to change{app.received_events.count}.by(1)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+require 'rspec'
+require 'pry'
+
+require 'joyce/version'
+require 'joyce/application'
+require 'joyce'
+
+include Joyce
+
+require_relative '../example/application'

metadata

@@ -0,0 +1,212 @@
+--- !ruby/object:Gem::Specification
+name: joyce
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- Joseph Weissman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-04-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gosu
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: metacosm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.2
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubygems-tasks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: isomorphic ruby games
+email: jweissman1986@gmail.com
+executables:
+- joyce
+extensions: []
+extra_rdoc_files:
+- ChangeLog.md
+- LICENSE.txt
+- README.md
+files:
+- ".document"
+- ".gitignore"
+- ".rspec"
+- ".yardopts"
+- ChangeLog.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/joyce
+- dump.rdb
+- example/application.rb
+- example/models/game.rb
+- example/models/player.rb
+- features/.gitkeep
+- features/joyce.feature
+- features/step_definitions/.gitkeep
+- features/step_definitions/joyce_steps.rb
+- gemspec.yml
+- joyce.gemspec
+- lib/joyce.rb
+- lib/joyce/application.rb
+- lib/joyce/version.rb
+- spec/joyce_spec.rb
+- spec/spec_helper.rb
+homepage: https://rubygems.org/gems/joyce
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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.4.5.1
+signing_key: 
+specification_version: 4
+summary: multiplayer game server framework
+test_files: []