impromptu 1.0.0

data/lib/impromptu/symbol.rb

@@ -0,0 +1,43 @@
+# Extensions to all Symbols to make it easier to deal
+# with namespaced, nested symbol names
+class Symbol
+  # True if this symbol contains namespaces (is a nested
+  # symbol such as A::B).
+  def nested?
+    self.to_s.include? '::'
+  end
+  
+  # True if this symbol contains no namespaces (is a root
+  # symbol such as A, in contrast to to A::B).
+  def unnested?
+    !self.nested?
+  end
+  
+  # Split a symbol into its component names (A::B =>
+  # [:A, :B])
+  def nested_symbols
+    self.to_s.split('::').collect(&:to_sym)
+  end
+  
+  # Retrieve the base (end or final) symbol name from this
+  # symbol (the Class or Module actually being referred to).
+  def base_symbol
+    self.nested_symbols.last
+  end
+  
+  # Retrieve the root (first) symbol name from this symbol.
+  def root_symbol
+    self.nested_symbols.first
+  end
+  
+  # Iterate through a namespaced symbol by visiting each
+  # name in turn, including its parent names. e.g calling
+  # on A::B::C would yield :A, :A::B, and :A::B::C
+  def each_namespaced_symbol
+    self.nested_symbols.inject([]) do |name, symbol|
+      name << symbol
+      yield name.join('::').to_sym
+      name
+    end
+  end
+end

data/lib/impromptu.rb

@@ -0,0 +1,12 @@
+require 'pathname'
+require 'set'
+
+require 'impromptu/symbol'
+require 'impromptu/ordered_set'
+require 'impromptu/component_set'
+require 'impromptu/resource'
+require 'impromptu/file'
+require 'impromptu/folder'
+require 'impromptu/component'
+require 'impromptu/impromptu'
+require 'impromptu/autoload'

data/test/framework/copies/extra_klass2.rb

@@ -0,0 +1,7 @@
+module Framework
+  class Klass2
+    def self.new_method
+      true
+    end
+  end
+end

data/test/framework/copies/new_klass.rb

@@ -0,0 +1,10 @@
+module Framework
+  class Klass
+    def self.overriden_method
+      3
+    end
+    
+    def self.new_method
+    end
+  end
+end

data/test/framework/copies/new_unseen.rb

@@ -0,0 +1,7 @@
+module Framework
+  module Unseen
+    def self.test_method
+      true
+    end
+  end
+end

data/test/framework/copies/original_klass.rb

@@ -0,0 +1,10 @@
+module Framework
+  class Klass
+    def self.standard_method
+    end
+    
+    def self.overriden_method
+      1
+    end
+  end
+end

data/test/framework/ext/extensions/blog.rb

@@ -0,0 +1,6 @@
+module Framework
+  module Extensions
+    class Blog
+    end
+  end
+end

data/test/framework/ext/extensions.rb

@@ -0,0 +1,4 @@
+module Framework
+  module Extensions
+  end
+end

data/test/framework/lib/group/klass2.rb

@@ -0,0 +1,4 @@
+module Framework
+  class Klass2
+  end
+end

data/test/framework/lib/klass.rb

@@ -0,0 +1,10 @@
+module Framework
+  class Klass
+    def self.standard_method
+    end
+    
+    def self.overriden_method
+      1
+    end
+  end
+end

data/test/framework/other/also.rb

@@ -0,0 +1,8 @@
+class OtherName
+  def self.overriden_method
+    3
+  end
+  
+  def self.one
+  end
+end

data/test/framework/other/ignore.rb

@@ -0,0 +1,2 @@
+class Ignore
+end

data/test/framework/other/load.rb

@@ -0,0 +1,2 @@
+class Load
+end

data/test/framework/other/two.rb

@@ -0,0 +1,14 @@
+module ModOne
+end
+
+module ModTwo
+end
+
+class OtherName
+  def self.overriden_method
+    4
+  end
+  
+  def self.two
+  end
+end

data/test/framework/private/klass.rb

@@ -0,0 +1,10 @@
+module Framework
+  class Klass
+    def self.extension_method
+    end
+    
+    def self.overriden_method
+      2
+    end
+  end
+end

data/test/framework/test.components

@@ -0,0 +1,23 @@
+component 'framework' do
+	namespace :Framework
+	requires  'mathn'
+	folder    'lib', nested_namespaces: false
+end
+
+component 'framework.extensions' do
+	namespace :Framework
+	folder    'ext'
+end
+
+component 'other' do
+  folder 'other' do
+    file 'load.rb'
+    file 'also.rb', :provides => :OtherName
+    file 'two.rb', :provides => [:ModOne, :ModTwo, :OtherName]
+  end
+end
+
+component 'private' do
+  namespace :Framework
+  folder 'private'
+end

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'impromptu'
+
+class Test::Unit::TestCase
+end

data/test/test_autoload.rb

@@ -0,0 +1,32 @@
+require 'helper'
+
+class TestAutload < Test::Unit::TestCase
+  context "A component with a namespace and no resources" do
+    setup do
+      Impromptu.reset
+      Impromptu.define_components do
+        component 'test' do
+          namespace :Namespace
+        end
+      end
+    end
+    
+    should "have a single component with a namespace" do
+      assert_equal 1, Impromptu.components.size
+      assert_equal :Namespace, Impromptu.components['test'].namespace
+      assert_not_nil Impromptu.root_resource.child(:Namespace)
+    end
+    
+    should "be able to have the namespace loaded using the autoload extension" do
+      assert_nothing_raised do
+        ::Namespace
+      end
+    end
+    
+    should "raise an appropriate exception when accessing a non existant resource" do
+      assert_raise NameError do
+        ::IDontExistSoRaiseAnException
+      end
+    end
+  end
+end

data/test/test_component.rb

@@ -0,0 +1,133 @@
+require 'helper'
+
+class TestComponent < Test::Unit::TestCase
+  context "A new component" do
+    setup { @component = Impromptu::Component.new(nil, 'component') }
+    should "have a default path of the cwd" do
+      assert_equal Pathname.new('.').realpath, @component.base_path
+    end
+    
+    should "respond to :requires" do
+      assert_respond_to @component, :requires
+    end
+    
+    should "respond to :namespace" do
+      assert_respond_to @component, :namespace
+    end
+    
+    should "respond to :folder" do
+      assert_respond_to @component, :folder
+    end
+    
+    should "have a name" do
+      assert_not_nil @component.name
+    end
+    
+    should "have no requirements" do
+      assert_equal 0, @component.requirements.size
+    end
+    
+    should "have no folders" do
+      assert_equal 0, @component.folders.size
+    end
+
+    # ----------------------------------------
+    # Requirements
+    # ----------------------------------------
+    context "with two requirements" do
+      setup { @component.requires('gem', 'other') }
+      should "store two requirements" do
+        assert_equal 2, @component.requirements.size
+      end
+      
+      context "and with two more, overlapping requirements" do
+        setup { @component.requires('another', 'gem') }
+        should "only store new requirements" do
+          assert_equal 3, @component.requirements.size
+        end
+      end
+    end
+
+    # ----------------------------------------
+    # Namespaces
+    # ----------------------------------------
+    context "with a namespace" do
+      setup { @component.namespace(:Framework) }
+      should "have a namespace" do
+        assert_equal :Framework, @component.namespace
+      end
+    end
+    
+    # ----------------------------------------
+    # Folders
+    # ----------------------------------------
+    context "with a folder" do
+      setup { @component.folder(['test', 'framework']) }
+      should "have one folder" do
+        assert_equal 1, @component.folders.size
+      end
+      
+      should "have a folder that is a folder" do
+        assert_instance_of Impromptu::Folder, @component.folders.first
+      end
+    end
+    
+    # ----------------------------------------
+    # Freezing
+    # ----------------------------------------
+    should "be able to be frozen" do
+      assert_respond_to @component, :freeze
+      assert_respond_to @component, :frozen?
+    end
+    
+    should "not be frozen by default" do
+      assert_equal false, @component.frozen?
+    end
+    
+    context "which is frozen" do
+      setup { @component.freeze }
+      should "be frozen after calling freeze" do
+        assert_equal true, @component.frozen?
+      end
+    
+      should "raise an exception when being modified" do
+        assert_raise RuntimeError do
+          @component.requires('ignored')
+        end
+        assert_raise RuntimeError do
+          @component.folder('ignored')
+        end
+        assert_raise RuntimeError do
+          @component.namespace(:Ignored)
+        end
+      end
+    end
+    
+    # ----------------------------------------
+    # Loading dependencies
+    # ----------------------------------------
+    context "with some external requirements" do
+      setup { @component.requires 'matrix' }
+      should "ensure unloaded requirements are not already loaded" do
+        assert_raise NameError do
+          Matrix
+        end
+      end
+      
+      should "load external requirements when requested" do
+        success = @component.load_external_dependencies
+        assert_equal true, success
+        assert_nothing_raised do
+          Matrix
+        end
+      end
+      
+      should "only load requirements once" do
+        success = @component.load_external_dependencies
+        assert_equal true, success
+        success = @component.load_external_dependencies
+        assert_equal false, success
+      end
+    end
+  end
+end

data/test/test_component_set.rb

@@ -0,0 +1,20 @@
+require 'helper'
+
+class TestComponentSet < Test::Unit::TestCase
+  context "A component set with two components" do
+    setup do
+      @set = Impromptu::ComponentSet.new
+      @a = @set << Impromptu::Component.new(nil, 'a')
+      @b = @set << Impromptu::Component.new(nil, 'b')
+    end
+    
+    should "have two components" do
+      assert_equal 2, @set.size
+    end
+    
+    should "be able to find both components by name" do
+      assert_equal @a, @set['a']
+      assert_equal @b, @set['b']
+    end
+  end
+end

data/test/test_folder.rb

@@ -0,0 +1,4 @@
+require 'helper'
+
+class TestFolder < Test::Unit::TestCase
+end

data/test/test_impromptu.rb

@@ -0,0 +1,43 @@
+require 'helper'
+
+class TestImpromptu < Test::Unit::TestCase
+  context "Impromptu" do
+    should "respond to root_resource" do
+      assert_respond_to Impromptu, :root_resource
+    end
+  
+    should "respond to components" do
+      assert_respond_to Impromptu, :components
+    end
+  
+    should "respond to reset" do
+      assert_respond_to Impromptu, :reset
+    end
+  
+    should "respond to define_components" do
+      assert_respond_to Impromptu, :define_components
+    end
+  
+    should "respond to parse_file" do
+      assert_respond_to Impromptu, :parse_file
+    end
+  
+    should "respond to component" do
+      assert_respond_to Impromptu, :component
+    end
+  
+    should "return a resource from root_resource" do
+      assert_instance_of Impromptu::Resource, Impromptu.root_resource
+    end
+    
+    should "return a component set from components" do
+      assert_instance_of Impromptu::ComponentSet, Impromptu.components
+    end
+    
+    should "rase an exception if a block is not supplied to define_components" do
+      assert_raise RuntimeError do
+        Impromptu.define_components
+      end
+    end
+  end
+end