darkholme 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a622c249ab3e57ac8e924f96a3e8016eb703c1df
+  data.tar.gz: 4299d324cf08736524dfdaabc1248de738afe29b
+SHA512:
+  metadata.gz: b8eaed977e5057199acb6a6f2ce459a49d043b389aced53d02434943ee0d2325db46b08a4ac0175d0fd53ab30661cfbc5d679e15ffd3a2effcf9740110c00849
+  data.tar.gz: 3bb5b0208608cbb869b409a458d99ad7584191bca187dd6bb05519028876b914dc5ebec2be7cc511dfc85a1367ef364b09eaa0ed749710411372fed251117c27

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color --format documentation

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+cache: bundler
+rvm:
+  - 2.0.0
+  - 2.1.0
+  - jruby-19mode

data/Gemfile

@@ -0,0 +1,14 @@
+source "http://rubygems.org"
+
+group :development do
+  gem "pry", "~> 0.9.12.6"
+  gem "rspec", "~> 3.0.0.beta1"
+  gem "yard", "~> 0.7"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0"
+  gem "jeweler", "~> 2.0.1"
+  gem "simplecov", ">= 0"
+
+  gem "guard-rspec", "~> 4.2.6", require: false
+  gem "inch", "~> 0.2.3"
+end

data/Gemfile.lock

@@ -0,0 +1,117 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.5)
+    builder (3.2.2)
+    celluloid (0.15.2)
+      timers (~> 1.1.0)
+    coderay (1.1.0)
+    descendants_tracker (0.0.3)
+    diff-lcs (1.2.5)
+    docile (1.1.3)
+    faraday (0.9.0)
+      multipart-post (>= 1.2, < 3)
+    ffi (1.9.3)
+    formatador (0.2.4)
+    git (1.2.6)
+    github_api (0.11.2)
+      addressable (~> 2.3)
+      descendants_tracker (~> 0.0.1)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 1.2)
+      multi_json (>= 1.7.5, < 2.0)
+      nokogiri (~> 1.6.0)
+      oauth2
+    guard (2.4.0)
+      formatador (>= 0.2.4)
+      listen (~> 2.1)
+      lumberjack (~> 1.0)
+      pry (>= 0.9.12)
+      thor (>= 0.18.1)
+    guard-rspec (4.2.6)
+      guard (~> 2.1)
+      rspec (>= 2.14, < 4.0)
+    hashie (2.0.5)
+    highline (1.6.20)
+    inch (0.2.3)
+      sparkr (>= 0.2.0)
+      term-ansicolor
+      yard (~> 0.8.7)
+    jeweler (2.0.1)
+      builder
+      bundler (>= 1.0)
+      git (>= 1.2.5)
+      github_api
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (0.1.11)
+      multi_json (>= 1.5)
+    listen (2.4.1)
+      celluloid (>= 0.15.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.4)
+    method_source (0.8.2)
+    mini_portile (0.5.2)
+    multi_json (1.8.4)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    nokogiri (1.6.1)
+      mini_portile (~> 0.5.0)
+    oauth2 (0.9.3)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 0.1.8)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    pry (0.9.12.6)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rack (1.5.2)
+    rake (10.1.1)
+    rb-fsevent (0.9.4)
+    rb-inotify (0.9.3)
+      ffi (>= 0.5.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rspec (3.0.0.beta1)
+      rspec-core (= 3.0.0.beta1)
+      rspec-expectations (= 3.0.0.beta1)
+      rspec-mocks (= 3.0.0.beta1)
+    rspec-core (3.0.0.beta1)
+    rspec-expectations (3.0.0.beta1)
+      diff-lcs (>= 1.1.3, < 2.0)
+      rspec-support (= 3.0.0.beta1)
+    rspec-mocks (3.0.0.beta1)
+    rspec-support (3.0.0.beta1)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    slop (3.4.7)
+    sparkr (0.4.1)
+    term-ansicolor (1.3.0)
+      tins (~> 1.0)
+    thor (0.18.1)
+    timers (1.1.0)
+    tins (1.0.0)
+    yard (0.8.7.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0)
+  guard-rspec (~> 4.2.6)
+  inch (~> 0.2.3)
+  jeweler (~> 2.0.1)
+  pry (~> 0.9.12.6)
+  rdoc (~> 3.12)
+  rspec (~> 3.0.0.beta1)
+  simplecov
+  yard (~> 0.7)

data/Guardfile

@@ -0,0 +1,9 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :rspec do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2014 Massive Danger
+
+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,55 @@
+# Darkholme
+
+[![Build Status](https://travis-ci.org/massivedanger/darkholme.png?branch=master)](https://travis-ci.org/massivedanger/darkholme)
+
+> Who am I? That, my dear, is an excellent question. Though not one easily answered. 
+
+Darkholme is an [entity-component system](http://en.wikipedia.org/wiki/Entity_component_system) 
+written in Ruby. It's still early days for it, but I think it's ready for most basic use cases.
+
+## Usage
+
+_COMING SOON!_
+
+## Key concepts
+
+### Engine
+
+Generally, your game will have one Engine. It contains all the entities, systems,
+and components. Every frame of your game, you'll need to call `#update` on it. This will,
+in turn, update all its relevant systems.
+
+### Entity
+
+This is the basic component-holding class. It also has some callbacks, but it generally just
+keeps a list of what it does. These get added to Engines.
+
+### Component
+
+These define data the Systems end up working with. Also, they get added to Entities.
+
+### System
+
+These get called once per frame and they update all the entities with components they're
+interested in.
+
+### Family
+
+Systems have a Family, which defines exactly what components they're interested in. This
+means that systems won't loop through every single entity on update. They only loop through
+relevant entities. This is _awesome_. Maybe.
+
+## Contributing to darkholme
+ 
+- Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+- Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+- Fork the project.
+- Start a feature/bugfix branch.
+- Commit and push until you are happy with your contribution.
+- Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+- Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2014 Massive Danger. See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,54 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+require 'rake'
+require 'yard'
+require 'pry'
+require 'jeweler'
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://guides.rubygems.org/specification-reference/ for more options
+  gem.name = "darkholme"
+  gem.homepage = "http://github.com/evanwalsh/darkholme"
+  gem.license = "MIT"
+  gem.summary = %Q{An entity-component system in Ruby for libgdx}
+  gem.description = %Q{An entity-component system in Ruby for libgdx}
+  gem.email = "evan@massivedanger.com"
+  gem.authors = ["Massive Danger"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+desc "Code coverage detail"
+task :simplecov do
+  ENV['COVERAGE'] = "true"
+  Rake::Task['spec'].execute
+end
+
+YARD::Rake::YardocTask.new
+
+desc "Start a Pry console with the gem required"
+task :pry do
+  $LOAD_PATH.unshift("./lib")
+  Dir["./lib/*.rb"].each do |file|
+    Pry.config.requires << file
+  end
+  Pry.start
+end
+
+task :default => :spec

data/VERSION

@@ -0,0 +1 @@
+0.9.0

data/darkholme.gemspec

@@ -0,0 +1,91 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: darkholme 0.9.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "darkholme"
+  s.version = "0.9.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Massive Danger"]
+  s.date = "2014-02-22"
+  s.description = "An entity-component system in Ruby for libgdx"
+  s.email = "evan@massivedanger.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    ".travis.yml",
+    "Gemfile",
+    "Gemfile.lock",
+    "Guardfile",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "darkholme.gemspec",
+    "lib/darkholme.rb",
+    "lib/darkholme/bitset.rb",
+    "lib/darkholme/component.rb",
+    "lib/darkholme/engine.rb",
+    "lib/darkholme/entity.rb",
+    "lib/darkholme/family.rb",
+    "lib/darkholme/system.rb",
+    "spec/lib/darkholme/bitset_spec.rb",
+    "spec/lib/darkholme/component_spec.rb",
+    "spec/lib/darkholme/engine_spec.rb",
+    "spec/lib/darkholme/entity_spec.rb",
+    "spec/lib/darkholme/family_spec.rb",
+    "spec/lib/darkholme/system_spec.rb",
+    "spec/lib/darkholme_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/mock_classes.rb"
+  ]
+  s.homepage = "http://github.com/evanwalsh/darkholme"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "2.1.11"
+  s.summary = "An entity-component system in Ruby for libgdx"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<pry>, ["~> 0.9.12.6"])
+      s.add_development_dependency(%q<rspec>, ["~> 3.0.0.beta1"])
+      s.add_development_dependency(%q<yard>, ["~> 0.7"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 2.0.1"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+      s.add_development_dependency(%q<guard-rspec>, ["~> 4.2.6"])
+      s.add_development_dependency(%q<inch>, ["~> 0.2.3"])
+    else
+      s.add_dependency(%q<pry>, ["~> 0.9.12.6"])
+      s.add_dependency(%q<rspec>, ["~> 3.0.0.beta1"])
+      s.add_dependency(%q<yard>, ["~> 0.7"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_dependency(%q<jeweler>, ["~> 2.0.1"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+      s.add_dependency(%q<guard-rspec>, ["~> 4.2.6"])
+      s.add_dependency(%q<inch>, ["~> 0.2.3"])
+    end
+  else
+    s.add_dependency(%q<pry>, ["~> 0.9.12.6"])
+    s.add_dependency(%q<rspec>, ["~> 3.0.0.beta1"])
+    s.add_dependency(%q<yard>, ["~> 0.7"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.0"])
+    s.add_dependency(%q<jeweler>, ["~> 2.0.1"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+    s.add_dependency(%q<guard-rspec>, ["~> 4.2.6"])
+    s.add_dependency(%q<inch>, ["~> 0.2.3"])
+  end
+end
+

data/lib/darkholme/bitset.rb

@@ -0,0 +1,102 @@
+module Darkholme
+  class Bitset
+    attr_reader :bits, :set_indexes
+
+    def initialize(*initial_bits)
+      @bits = initial_bits.map {|bit| convert_bit(bit) }.inject(:+) || 0
+
+      @set_indexes = []
+      @set_indexes += initial_bits.uniq if initial_bits
+    end
+
+    def set(bit, value = true)
+      if value
+        @bits = union convert_bit(bit)
+        @set_indexes << bit unless @set_indexes.include?(bit)
+      elsif set?(bit)
+        @bits = xor convert_bit(bit)
+        @set_indexes.delete(bit)
+      end
+
+      @bits
+    end
+
+    def clear(bit)
+      set(bit, false) 
+    end
+
+    def set?(bit)
+      bit = convert_bit(bit) 
+      intersect(bit) == bit
+    end
+
+    def include?(other)
+      set_indexes & other.set_indexes == other.set_indexes
+    end
+
+    def intersect(other)
+      @bits & bits_from_object(other) 
+    end
+    alias_method :&, :intersect
+
+    def intersect?(other)
+      if other_bits = bits_from_object(other) > 0
+        intersect(other_bits) == other_bits
+      else
+        false
+      end
+    end
+
+    def not
+      ~@bits
+    end
+    alias_method :~, :not
+
+    def xor(other)
+      @bits ^ bits_from_object(other) 
+    end
+    alias_method :^, :xor
+
+    def union(other)
+      @bits | bits_from_object(other)
+    end
+    alias_method :|, :union
+
+    def to_s
+      @bits.to_s(2)  
+    end
+
+    def to_i
+      @bits.to_i
+    end
+
+    def to_f
+      @bits.to_f
+    end
+
+    def [](index)
+      set?(index)
+    end
+
+    def []=(index, value)
+      set(index, value)
+    end
+
+    def ==(other)
+      @bits == other.bits
+    end
+
+    private
+
+    def flip(bit)
+    end
+
+    def convert_bit(bit)
+      2 ** bit
+    end
+
+    def bits_from_object(object)
+      object.respond_to?(:bits) ? object.bits : object.to_i
+    end
+  end
+end

data/lib/darkholme/component.rb

@@ -0,0 +1,14 @@
+module Darkholme
+  class Component
+    @next_bit = 0
+    @bits = {}
+
+    def self.bit_for(klass)
+      @bits[klass] ||= @next_bit += 1
+    end
+
+    def bit
+      Component.bit_for(self.class) 
+    end
+  end
+end

data/lib/darkholme/engine.rb

@@ -0,0 +1,50 @@
+module Darkholme
+  class Engine
+    attr_reader :systems, :entities
+
+    def initialize
+      @systems = {}
+      @families = {}
+      @entities = Set.new
+    end
+
+    def add_entity(entity)
+      @entities << entity
+      entity.added_to_engine self
+    end
+
+    def remove_entity(entity)
+      @entities.delete entity
+      entity.removed_from_engine self
+    end
+
+    def add_system(system)
+      @systems[system.class] = system
+      system.added_to_engine self
+    end
+
+    def remove_system(systemClass)
+      system = @systems.delete systemClass 
+      system.removed_from_engine(self) if system
+    end
+
+    def system(systemClass)
+      @systems[systemClass]
+    end
+
+    def entities_for_family(family)
+      @families[family.index] ||= begin
+        Set.new.tap do |entities|
+          @entities.each do |entity|
+            entities << entity if family.member?(entity)
+          end
+        end
+      end
+    end
+
+    def update(delta)
+      @systems.each {|klass, system| system.update(delta) }
+    end
+
+  end
+end

data/lib/darkholme/entity.rb

@@ -0,0 +1,43 @@
+module Darkholme
+  class Entity
+    attr_accessor :engine, :components, :component_bits
+
+    def initialize
+      self.components = {}
+      self.component_bits = Bitset.new
+      self.engine = nil
+    end
+
+    def added_to_engine(engine)
+      self.engine = engine
+    end
+
+    def removed_from_engine(engine)
+      self.engine = nil
+    end
+
+    def add_component(component)
+      self.components[component.class] = component
+      self.component_bits.set(component.bit)
+
+      component 
+    end
+
+    def remove_component(component_class)
+      if removed_component = component_for(component_class)
+        self.component_bits.clear(removed_component.bit)
+        self.components.delete(component_class)
+      end
+
+      removed_component
+    end
+
+    def has_component?(component_class)
+      self.components.include? component_class
+    end
+
+    def component_for(component_class)
+      self.components[component_class]
+    end
+  end
+end

data/lib/darkholme/family.rb

@@ -0,0 +1,36 @@
+module Darkholme
+  class Family 
+    @next_index = 0
+    @families = {}
+
+    class << self
+      attr_accessor :next_index
+    end
+
+    attr_reader :index, :bits
+
+    def self.for(*component_classes)
+      bits = Bitset.new
+      component_classes.each do |klass|
+        bits.set Component.bit_for(klass)
+      end
+
+      hash = bits.to_i
+      @families[hash] ||= begin
+        new bits
+      end
+    end
+
+    def member?(entity)
+      entity.component_bits.include?(bits)
+    end
+
+    private
+
+    def initialize(bits)
+      @index = self.class.next_index += 1
+      @bits = bits
+    end
+  end
+end
+

data/lib/darkholme/system.rb

@@ -0,0 +1,33 @@
+module Darkholme
+  class System
+    class << self
+      attr_reader :family
+
+      def has_family(*component_classes)
+        @family = Family.for(*component_classes) 
+      end
+    end
+
+    attr_accessor :engine
+
+    def update(delta)
+      raise NotImplementedError.new("You must override #update(delta)")
+    end
+
+    def added_to_engine(engine)
+      self.engine = engine
+    end
+
+    def removed_from_engine(engine)
+      self.engine = nil if self.engine == engine
+    end
+
+    def entities
+      engine.entities_for_family(family)
+    end
+
+    def family
+      self.class.family
+    end
+  end
+end

data/lib/darkholme.rb

@@ -0,0 +1,10 @@
+require 'darkholme/bitset'
+require 'darkholme/engine'
+require 'darkholme/entity'
+require 'darkholme/system'
+require 'darkholme/component'
+require 'darkholme/family'
+
+module Darkholme
+   
+end

data/spec/lib/darkholme/bitset_spec.rb

@@ -0,0 +1,79 @@
+require 'spec_helper'
+
+module Darkholme
+  describe Bitset do
+    subject { Bitset.new }
+    let(:bit) { 3 }
+
+    it "can set bits" do
+      subject.set(bit)
+      expect(subject.set?(bit)).to eq(true)
+    end
+
+    it "can set bits to false" do
+      subject.set(bit)
+      expect(subject.set?(bit)).to eq(true)
+
+      subject.set(bit, false)
+      expect(subject.set?(bit)).to eq(false)
+    end
+
+    it "has a list of set indexes" do
+      subject.set(3)
+      subject.set(4)
+      subject.set(5)
+
+      expect(subject.set_indexes).to match_array([3, 4, 5])
+    end
+
+    it "can clear bits" do
+      subject.set(bit)
+      expect(subject.set?(bit)).to eq(true)
+      
+      expect {
+        subject.clear(bit)
+      }.to change { subject.bits }
+
+      expect(subject.set?(bit)).to eq(false) 
+    end
+
+    it "removes the set index during a clear" do
+      subject.set(bit)
+      expect(subject.set_indexes).to include(bit)
+      subject.clear(bit)
+
+      expect(subject.set_indexes).to be_empty
+    end
+
+    it "can check for bit set status via array operators" do
+      subject.set(bit)
+
+      expect(subject[bit]).to eq(true)
+    end
+
+    it "can set bits via array operator" do
+      subject[bit] = true
+
+      expect(subject.set?(bit)).to eq(true)
+    end
+
+    it "can be compared to other bitsets" do
+      other = Bitset.new(bit)
+      subject.set(bit)
+
+      expect(subject).to eq(other)
+    end
+
+    it "can check for complete inclusion of other bitsets" do
+      subject.set(3)
+      subject.set(4)
+      subject.set(5)
+
+      other = Bitset.new
+      other.set(4)
+      other.set(5)
+
+      expect(subject.include? other).to eq(true)
+    end
+  end
+end

data/spec/lib/darkholme/component_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+module Darkholme
+  describe Component do
+    subject { MockComponent.new }
+
+    it "returns a unique bit for Components" do
+      first_bit = Component.bit_for(MockComponent)
+      second_bit = Component.bit_for(Component)
+
+      expect(first_bit).not_to eq(second_bit)
+    end
+
+    it "gets a bit from an instance" do
+      expect(Component).to receive(:bit_for).with(MockComponent)
+                                            .and_return(:bit)
+      expect(subject.bit).to eq(:bit)
+    end
+  end
+end

data/spec/lib/darkholme/engine_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+module Darkholme
+  describe Engine do
+    subject { Engine.new }
+    let(:entity) { MockEntity.new }
+    let(:system) { MockSystem.new } 
+
+    describe "with entities" do
+      it "can add them" do
+        expect {
+          subject.add_entity(entity)
+        }.to change { subject.entities.count }.from(0).to(1) 
+      end
+
+      it "can remove them" do
+        subject.add_entity(entity)
+
+        expect { 
+          subject.remove_entity(entity)
+        }.to change { subject.entities.count }.from(1).to(0)
+      end
+      
+      it "can find them by family" do
+        entity.add_component(MockComponent.new)
+        subject.add_entity(entity)
+        subject.add_system(system)
+
+        expect(subject.entities_for_family(system.family)).to include(entity)
+      end
+    end
+
+    describe "with systems" do
+      it "can add a system" do
+        expect {
+          subject.add_system(system)
+        }.to change { subject.systems.count }.from(0).to(1)
+      end
+
+      it "can remove a system" do
+        subject.add_system(system)
+
+        expect {
+          subject.remove_system(system.class)
+        }.to change { subject.systems.count }.from(1).to(0)
+      end
+
+      it "updates them" do
+        subject.add_system(system)
+        expect(system).to receive(:update).with(:delta)
+                                          .and_return(:updated)
+
+        subject.update(:delta)
+      end
+    end
+  end
+end
+

data/spec/lib/darkholme/entity_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+
+module Darkholme
+  describe Entity do
+    subject { MockEntity.new }
+    let(:engine) { Engine.new }
+    let(:system) { MockSystem.new }
+    let(:component) { MockComponent.new }
+
+    describe "with callbacks" do
+      it "sets self.engine when added to an engine" do
+        subject.added_to_engine(engine)
+
+        expect(subject.engine).to eq(engine)
+      end
+
+      it "clears self.engine when removed from an engine" do
+        subject.engine = engine
+        expect(subject.engine).to eq(engine)
+        subject.removed_from_engine(engine)
+
+        expect(subject.engine).to be_nil
+      end
+    end
+
+    describe "with components" do
+      describe "adding one" do
+        it "makes has_component? return true" do
+          subject.add_component(component)
+          expect(subject.has_component?(component.class)).to eq(true)
+        end
+
+        it "returns the component" do
+          added = subject.add_component(component)
+          expect(added).to eq(component)
+        end
+
+        it "sets the associated component bit" do
+          bits = subject.component_bits
+          expect(bits).to receive(:set).with(component.bit)
+
+          subject.add_component(component)
+        end
+      end
+     
+      describe "removing one" do
+        let!(:added) { subject.add_component(component) }
+
+        it "makes has_component? return false" do
+          subject.remove_component(component.class)
+          expect(subject.has_component?(component.class)).to eq(false)
+        end
+
+        it "returns the component" do
+          removed = subject.remove_component(component.class)
+          expect(removed).to eq(component)
+        end
+
+        it "clears the associated component bit" do
+          bits = subject.component_bits
+          expect(bits).to receive(:clear).with(component.bit)
+
+          subject.remove_component(component.class)
+        end
+      end
+      
+      it "returns a component instance when asked for one" do
+        subject.add_component(component)
+        expect(subject.component_for(component.class)).to be_a MockComponent
+      end
+    end
+  end
+end

data/spec/lib/darkholme/family_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+module Darkholme
+  describe Family do
+    subject { Family.for(MockComponent) }
+
+    describe ".for" do
+      it "creates a new family" do
+        expect(subject).to be_a Family
+      end
+
+      it "returns the same family if it exists" do
+        second_family = Family.for(MockComponent)
+        expect(second_family).to eq(subject)
+      end
+    end
+
+    describe "#member?" do
+      let(:entity) { MockEntity.new }
+      it "returns true if the component bits match" do
+        entity.add_component(MockComponent.new)
+        expect(subject.member?(entity)).to eq(true)
+      end
+
+      it "returns false if the bits don't match" do
+        expect(subject.member?(entity)).to eq(false)
+      end
+    end
+  end
+end

data/spec/lib/darkholme/system_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+
+module Darkholme
+  describe System do
+    subject { MockSystem.new }
+
+    describe ".has_family" do
+      it "sets the class-wide family" do
+        expect { 
+          EmptySystem.has_family MockComponent
+        }.to change { EmptySystem.family }
+          .from(nil).to(an_instance_of Family)
+      end
+    end
+
+    it "raises on update" do
+      expect { subject.update(:delta) }.to raise_error NotImplementedError
+    end
+
+    describe "with callbacks" do
+      it "sets engine when added" do
+        subject.added_to_engine(:engine)
+        expect(subject.engine).to eq(:engine)
+      end
+
+      it "clears engine when removed if they match" do
+        subject.engine = :engine
+        subject.removed_from_engine(:engine)
+        expect(subject.engine).to be_nil
+      end
+
+      it "leaves engine alone when removed if they don't match" do
+        subject.engine = :no
+        subject.removed_from_engine(:engine)
+        expect(subject.engine).to eq(:no)
+      end
+    end
+
+    it "has entities" do
+      subject.engine = Engine.new
+      expect(subject.engine).to receive(:entities_for_family)
+        .with(subject.family)
+        .and_return([])
+
+      expect(subject.entities).to eq([])
+    end
+
+    it "has a family" do
+      expect(subject.family).to eq(subject.class.family)
+    end
+
+    private
+
+    class EmptySystem < System; end
+  end
+end

data/spec/lib/darkholme_spec.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe Darkholme do
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,29 @@
+require 'simplecov'
+
+module SimpleCov::Configuration
+  def clean_filters
+    @filters = []
+  end
+end
+
+SimpleCov.configure do
+  clean_filters
+  load_profile 'test_frameworks'
+end
+
+ENV["COVERAGE"] && SimpleCov.start do
+  add_filter "/.rvm/"
+end
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'rspec'
+require 'darkholme'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f }
+
+RSpec.configure do |config|
+
+end

data/spec/support/mock_classes.rb

@@ -0,0 +1,9 @@
+class MockEntity < Darkholme::Entity
+end
+
+class MockComponent < Darkholme::Component
+end
+
+class MockSystem < Darkholme::System
+  has_family MockComponent
+end

metadata

@@ -0,0 +1,198 @@
+--- !ruby/object:Gem::Specification
+name: darkholme
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- Massive Danger
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.12.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.12.6
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.0.beta1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.0.beta1
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 4.2.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 4.2.6
+- !ruby/object:Gem::Dependency
+  name: inch
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.3
+description: An entity-component system in Ruby for libgdx
+email: evan@massivedanger.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- .document
+- .rspec
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- darkholme.gemspec
+- lib/darkholme.rb
+- lib/darkholme/bitset.rb
+- lib/darkholme/component.rb
+- lib/darkholme/engine.rb
+- lib/darkholme/entity.rb
+- lib/darkholme/family.rb
+- lib/darkholme/system.rb
+- spec/lib/darkholme/bitset_spec.rb
+- spec/lib/darkholme/component_spec.rb
+- spec/lib/darkholme/engine_spec.rb
+- spec/lib/darkholme/entity_spec.rb
+- spec/lib/darkholme/family_spec.rb
+- spec/lib/darkholme/system_spec.rb
+- spec/lib/darkholme_spec.rb
+- spec/spec_helper.rb
+- spec/support/mock_classes.rb
+homepage: http://github.com/evanwalsh/darkholme
+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.1.11
+signing_key: 
+specification_version: 4
+summary: An entity-component system in Ruby for libgdx
+test_files: []