elliottcable-lobby 1

data/.manifest

@@ -0,0 +1,5 @@
+lib/lobby.rb
+Rakefile.rb
+README.markdown
+spec/lobby_spec.rb
+.manifest

data/README.markdown

@@ -0,0 +1,79 @@
+Lobby
+=====
+Welcome to Ruby. Pull up a chair:
+    
+    require 'lobby'
+    LobbyConstructor::construct!
+    
+Tell us about yourself!
+    
+    def i_am
+      "me"
+    end
+    
+    class Somewhere
+      class Deep
+        class In
+          class A
+            class GodForsaken
+              class Wasteland
+                
+                puts Kernel::lobby.instance_eval { i_am }
+                
+              end
+            end
+          end
+        end
+      end
+    end
+    
+From where do you hail?
+    
+    class Somewhere
+      class Deep
+        class In
+          class A
+            class GodForsaken
+              class Wasteland
+                
+                class ::Lobby
+                  def who_knows
+                    puts "somewere deep..."
+                  end
+                end
+                
+              end
+            end
+          end
+        end
+      end
+    end
+    
+    who_knows()
+    
+Getting
+-------
+The authoritative source for this project is available at
+<http://github.com/elliottcable/lobby>. You can clone your own copy with
+the following command:
+
+    git clone git://github.com/elliottcable/lobby.git
+
+If you want to make changes to the codebase, you need to fork your own GitHub
+repository for said changes. Send a pullrequest to [elliottcable](http://github.com/elliottcable "elliottcable on GitHub")
+when you've got something ready for the master branch that you think should be
+merged.
+
+Requirements
+------------
+To use Lobby, you need... nothing!
+
+Contributing
+------------
+To develop and contribute to Lobby, you need...
+
+- `gem install rake`
+- `gem install elliottcable-echoe`
+- `gem install rspec`
+- `gem install relevance-rcov`
+- `gem install lsegal-yard`

data/Rakefile.rb

@@ -0,0 +1,130 @@
+($:.unshift File.expand_path(File.join( File.dirname(__FILE__), 'lib' ))).uniq!
+require "lobby"
+
+default_tasks = Array.new
+
+# =======================
+# = Gem packaging tasks =
+# =======================
+begin
+  require 'echoe'
+  
+  default_tasks << :'package:manifest' unless ENV['CI']
+  default_tasks << :'package:verify'
+  
+  task :install => :'package:install'
+  task :package => :'package:package'
+  task :manifest => :'package:manifest'
+  namespace :package do
+    Echoe.new('lobby', LobbyConstructor::Version) do |g|
+      g.author = ['elliottcable']
+      g.email = ["Lobby@elliottcable.com"]
+      g.summary = "Welcome to Ruby. Enjoy your stay. Here's a chair."
+      g.url = 'http://github.com/elliottcable/lobby'
+      g.runtime_dependencies = []
+      g.development_dependencies = ['echoe >= 3.0.2', 'rspec', 'rcov', 'yard']
+      g.manifest_name = '.manifest'
+      g.retain_gemspec = true
+      g.rakefile_name = 'Rakefile.rb'
+      g.ignore_pattern = /^\.git\/|^meta\/|\.gemspec/
+    end
+  
+    desc 'Tests packaged files to ensure they are all present'
+    task :verify => :package do
+      # An error message will be displayed if files are missing
+      if system %(ruby -e "require 'rubygems'; require 'pkg/lobby-#{LobbyConstructor::Version}/lib/lobby'")
+        puts "\nThe library files are present."
+      end
+    end
+  end
+  
+rescue LoadError => exception
+  raise exception unless exception.message =~ /(echoe)$/
+  desc '!! You need the `echoe` gem to package or install this project!'
+  task :package
+end
+
+# =======================
+# = Spec/Coverage tasks =
+# =======================
+begin
+  require 'spec'
+  require 'rcov'
+  require 'spec/rake/spectask'
+  
+  default_tasks << :'coverage:run'
+  default_tasks << :'coverage:open' unless ENV['CI']
+  
+  task :coverage => :'coverage:run'
+  namespace :coverage do
+    Spec::Rake::SpecTask.new(:run) do |t|
+      t.spec_opts = ["--format", "specdoc"]
+      t.spec_opts << "--colour" unless ENV['CI']
+      t.spec_files = Dir[File.join('spec', '**', '*_spec.rb')].sort
+      t.libs = ['lib']
+      t.rcov = true
+      t.rcov_opts = ['--exclude-only', '".*"', '--include-file', '"^lib"',
+        '--sort', 'loc', '--sort-reverse',
+        '--comments', '--profile', '--text-report', '-w' ]
+      t.rcov_dir = File.join('meta', 'coverage')
+    end
+    
+    task :open do
+      system 'open ' + File.join('meta', 'coverage', 'index.html')
+    end if RUBY_PLATFORM =~ /darwin/
+  end
+  
+rescue LoadError => exception
+  raise exception unless exception.message =~ /(rcov|spec)$/
+  desc '!! You need the `rcov` and `rspec` gems to run specs or coverage!'
+  task :coverage
+end
+
+# =======================
+# = Documentation tasks =
+# =======================
+begin
+  require 'yard'
+  require 'yard/rake/yardoc_task'
+  
+  default_tasks << :'documentation:generate'
+  default_tasks << :'documentation:open' unless ENV['CI']
+  
+  task :documentation => :'documentation:generate'
+  namespace :documentation do
+    YARD::Rake::YardocTask.new :generate do |t|
+      t.files   = [File.join('lib', '**', '*.rb')]
+      t.options = ['--output-dir', File.join('meta', 'documentation'),
+                   '--readme', 'README.markdown']
+    end
+    
+    YARD::Rake::YardocTask.new :yardoc do |t|
+      t.files   = [File.join('lib', '**', '*.rb')]
+      t.options = ['--no-output',
+                   '--readme', 'README.markdown']
+    end
+    
+    task :open do
+      system 'open ' + File.join('meta', 'documentation', 'index.html')
+    end if RUBY_PLATFORM =~ /darwin/
+  end
+  
+rescue LoadError => exception
+  raise exception unless exception.message =~ /(yard)$/
+  desc '!! You need the `yard` gem to generate documentation!'
+  task :documentation
+end
+
+# =================
+# = Miscellaneous =
+# =================
+desc 'Removes all meta producs'
+task :clobber do
+  `rm -rf #{File.expand_path(File.join( File.dirname(__FILE__), 'meta' ))} #{File.expand_path(File.join( File.dirname(__FILE__), 'pkg' ))}`
+end
+
+desc 'Run all default tasks'
+task :default => default_tasks do
+  puts "** Successfully ran the following tasks:"
+  puts "** #{Rake.application.tasks.select {|t| t.name == 'default' }.first.prerequisites.join(', ')}"
+end

data/lib/lobby.rb

@@ -0,0 +1,30 @@
+##
+# Simply the "root class" of this library, to expediate things.
+class LobbyConstructor
+  Version = 1
+  
+  ##
+  # This method is responsible for constructing the "lobby environment."
+  def self.construct!
+    lobby = ::Kernel::lobby
+    def lobby.inspect
+      "lobby"
+    end
+    
+    root_object_eigenclass = class<<lobby;self;end
+    ::Kernel.send :const_set, "Lobby", root_object_eigenclass
+    def root_object_eigenclass.inspect
+      "Lobby"
+    end
+  end
+end
+
+module ::Kernel
+  
+  ##
+  # This method returns the global "root object," also known as "main."
+  def lobby
+    ::Kernel.eval('self', ::TOPLEVEL_BINDING)
+  end
+  
+end

data/lobby.gemspec

@@ -0,0 +1,43 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{lobby}
+  s.version = "1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["elliottcable"]
+  s.date = %q{2009-06-17}
+  s.description = %q{Welcome to Ruby. Enjoy your stay. Here's a chair.}
+  s.email = ["Lobby@elliottcable.com"]
+  s.extra_rdoc_files = ["README.markdown", "lib/lobby.rb"]
+  s.files = ["README.markdown", "Rakefile.rb", "lib/lobby.rb", "spec/lobby_spec.rb", ".manifest", "lobby.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/elliottcable/lobby}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Lobby", "--main", "README.markdown"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{lobby}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Welcome to Ruby. Enjoy your stay. Here's a chair.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<echoe>, [">= 0", "= 3.0.2"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+    else
+      s.add_dependency(%q<echoe>, [">= 0", "= 3.0.2"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<yard>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<echoe>, [">= 0", "= 3.0.2"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<yard>, [">= 0"])
+  end
+end

data/spec/lobby_spec.rb

@@ -0,0 +1,55 @@
+($:.unshift File.expand_path(File.join( File.dirname(__FILE__), '..', 'lib' ))).uniq!
+require 'lobby'
+
+describe LobbyConstructor do
+  describe '::construct!' do
+    before :all do
+      LobbyConstructor::construct!
+    end
+    
+    it 'should rename the root object to "lobby"' do
+      ::Kernel.eval('self', ::TOPLEVEL_BINDING).inspect.should == "lobby"
+    end
+    
+    it 'should provide a singleton class named "Lobby"' do
+      class<<::Kernel.eval('self', ::TOPLEVEL_BINDING);self;end.inspect.should == "Lobby"
+    end
+    
+    it 'should provide the "Lobby" singleton class under the Lobby constant' do
+      class<<::Kernel.eval('self', ::TOPLEVEL_BINDING);self;end.should == 
+        ::Kernel.eval('Lobby', ::TOPLEVEL_BINDING)
+    end
+    
+    it 'should not allow instantiation of Lobby' do
+      lambda {
+        class<<::Kernel.eval('Lobby', ::TOPLEVEL_BINDING);self;end.new
+      }.should raise_error(TypeError)
+    end
+    
+    it 'should allow the definition of methods on Lobby' do
+      ::Kernel.eval(<<-END, ::TOPLEVEL_BINDING)
+        class Lobby
+          def foo
+            return "foo"
+          end
+        end
+      END
+      
+      ::Kernel.eval("foo()", ::TOPLEVEL_BINDING).should == "foo"
+    end
+  end
+end
+
+describe 'Kernel#lobby' do
+  it 'should be made available' do
+    lambda { ::Kernel.eval('self', ::TOPLEVEL_BINDING).instance_eval {
+      lobby
+    } }.should_not raise_error
+  end
+  
+  it 'should make the main object available from anywhere' do
+    ::Kernel.eval('self', ::TOPLEVEL_BINDING).instance_eval {
+      lobby
+    }.should == ::Kernel.eval('self', ::TOPLEVEL_BINDING)
+  end
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification 
+name: elliottcable-lobby
+version: !ruby/object:Gem::Version 
+  version: "1"
+platform: ruby
+authors: 
+- elliottcable
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-06-17 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 3.0.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Welcome to Ruby. Enjoy your stay. Here's a chair.
+email: 
+- Lobby@elliottcable.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+- lib/lobby.rb
+files: 
+- README.markdown
+- Rakefile.rb
+- lib/lobby.rb
+- spec/lobby_spec.rb
+- .manifest
+- lobby.gemspec
+has_rdoc: true
+homepage: http://github.com/elliottcable/lobby
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Lobby
+- --main
+- README.markdown
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: lobby
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Welcome to Ruby. Enjoy your stay. Here's a chair.
+test_files: []
+