web_blocks 2.0.0.dev

data/lib/web_blocks/thor/partial/link/scss.rb

@@ -0,0 +1,23 @@
+require 'web_blocks/thor/partial/link'
+require 'web_blocks/strategy/link/scss'
+
+module WebBlocks
+  module Thor
+    module Partial
+      class Link
+
+        description = "Construct linked construct of SCSS files based on dependencies"
+        desc "scss", description
+        long_desc description
+
+        def scss
+
+          prepare_blocks!
+          ::WebBlocks::Strategy::Link::Scss.new(self).execute!
+
+        end
+
+      end
+    end
+  end
+end

data/lib/web_blocks/thor/partial/link.rb

@@ -0,0 +1,13 @@
+require 'web_blocks/thor/base'
+
+module WebBlocks
+  module Thor
+    module Partial
+      class Link < Base
+
+      end
+    end
+  end
+end
+
+Dir.glob(Pathname.new(__FILE__).parent.realpath + "link/**/*.rb").each { |r| require r }

data/lib/web_blocks/thor/partial/runner.rb

@@ -0,0 +1,14 @@
+require 'thor'
+require 'web_blocks/thor/partial/link'
+require 'web_blocks/thor/partial/compile'
+
+module WebBlocks
+  module Thor
+    module Partial
+      class Runner < ::Thor
+        register ::WebBlocks::Thor::Partial::Link, :link, "link", "Linker that prepares assets for compilation"
+        register ::WebBlocks::Thor::Partial::Compile, :compile, "compile", "Compiler that builds assets from linked sources"
+      end
+    end
+  end
+end

data/lib/web_blocks/thor/runner.rb

@@ -0,0 +1,16 @@
+require 'thor'
+require 'web_blocks/thor/inspect'
+require 'web_blocks/thor/partial/runner'
+require 'web_blocks/thor/build'
+require 'web_blocks/thor/watch'
+
+module WebBlocks
+  module Thor
+    class Runner < ::Thor
+      register ::WebBlocks::Thor::Inspect, :inspect, "inspect", "Inspect the blocks configuration and tree"
+      register ::WebBlocks::Thor::Build, :build, "build", "Link, compile and optimize all assets"
+      register ::WebBlocks::Thor::Watch, :watch, "watch", "Watch for changes and rebuild all assets"
+      register ::WebBlocks::Thor::Partial::Runner, :partial, "partial", "Perform a single step of the build process"
+    end
+  end
+end

data/lib/web_blocks/thor/watch/all.rb

@@ -0,0 +1,67 @@
+require 'pathname'
+require 'fssm'
+require 'web_blocks/thor/watch'
+require 'web_blocks/manager/parallel_builder'
+
+module WebBlocks
+  module Thor
+    class Watch
+
+      description = "Watch and rebuild all assets"
+      desc "all", description
+      long_desc description
+
+      def all
+
+        # TODO: refactor this file so it's not a run-on routine
+
+        prepare_blocks!
+
+        task = self
+
+        triggers = root.adjacency_list.keys.map(){|f| f.resolved_path.to_s }
+        triggers << base_path + 'Blockfile.rb'
+        triggers << base_path + '.blocks/cache/bower/registry.yaml'
+        triggers << base_path + 'bower_components/*/Blockfile.rb'
+
+        handler = Proc.new do |base, relative|
+
+          changed_file = Pathname.new(base) + relative
+          relink_needed = changed_file.to_s.match(/Blockfile.rb$/)
+
+          log.info("Watch"){ "Detected change to #{changed_file}" }
+
+          if relink_needed
+            root.remove_all_children
+            prepare_blocks!
+          end
+
+          begin
+
+            jobs = WebBlocks::Manager::ParallelBuilder.new task
+            jobs.start :scss
+            jobs.start :js
+            jobs.save_when_done!
+
+          rescue ::TSort::Cyclic => e
+
+            log.error { "Build failed -- Cyclical dependencies detected" }
+
+          end
+
+        end
+
+        monitor = FSSM::Monitor.new
+        monitor.path @base_path do
+          glob triggers
+          update &handler
+          delete &handler
+          create &handler
+        end
+        monitor.run
+
+      end
+
+    end
+  end
+end

data/lib/web_blocks/thor/watch.rb

@@ -0,0 +1,13 @@
+require 'web_blocks/thor/base'
+
+module WebBlocks
+  module Thor
+    class Watch < Base
+
+      default_task 'all'
+
+    end
+  end
+end
+
+Dir.glob(Pathname.new(__FILE__).parent.realpath + "watch/**/*.rb").each { |r| require r }

data/lib/web_blocks/version.rb

@@ -0,0 +1,3 @@
+module WebBlocks
+  VERSION = "2.0.0.dev"
+end

data/lib/web_blocks.rb

@@ -0,0 +1,13 @@
+require 'pathname'
+
+# This module contains WebBlocks-related libraries:
+#
+# * {WebBlocks::Framework} defines singleton accessor method framework
+# * {WebBlocks::Structure} defines the structures that comprise WebBlocks
+# * {WebBlocks::Support} defines supporting libraries used by WebBlocks
+#
+# Also see {file:REFERENCE.md full WebBlocks reference}.
+module WebBlocks; end
+
+# Require all WebBlocks library files
+Dir.glob(Pathname.new(__FILE__).parent.realpath + "**/*.rb").each { |r| require r }

data/test/init.rb

@@ -0,0 +1,7 @@
+require 'simplecov'
+require 'coveralls'
+
+SimpleCov.formatter = Coveralls::SimpleCov::Formatter
+SimpleCov.start do
+  add_filter '/test/'
+end

data/test/web_blocks/framework.rb

@@ -0,0 +1,40 @@
+require 'test/unit'
+require 'web_blocks/framework'
+
+class TestFramework < Test::Unit::TestCase
+
+  include WebBlocks::Framework
+
+  def setup
+    @@framework = nil
+  end
+
+  def test_singleton
+    previous = framework
+    @@framework = nil
+    current = framework
+    assert previous != current, "Setting @@framework nil in WebBlocks::Framework context destroys singleton"
+    assert current === framework, "framework returns same object on subsequent calls"
+  end
+
+  def test_type
+    assert framework, "framework method within WebBlocks::Framework"
+    assert framework.is_a?(::WebBlocks::Structure::Framework), "framework method returns ::WebBlocks::Structure::Framework"
+  end
+
+  def test_attributes
+    framework :test => true
+    assert framework.get(:test), 'Attribute set from method parameters on singleton instantiation'
+    framework :added_attribute => true
+    assert framework.get(:added_attribute), 'Attribute set from method parameters on singleton access'
+    framework do
+      set :block_set_attribute, true
+    end
+    assert framework.get(:block_set_attribute), 'Block context executed'
+    framework :block_override_attribute => false do
+      set :block_override_attribute, true
+    end
+    assert framework.get(:block_override_attribute), 'Block context executed after attributes set from method parameters'
+  end
+
+end

data/test/web_blocks/structure.rb

@@ -0,0 +1,42 @@
+require 'test/unit'
+require 'web_blocks/structure'
+
+class TestStructure < Test::Unit::TestCase
+
+  def test_namespace
+
+    assert_nothing_raised("Structure module defined"){ WebBlocks::Structure }
+
+  end
+
+  def test_structures_classes
+
+    ['Block','FontFile','Framework','ImgFile','JsFile','RawFile','ScssFile'].each do |type|
+      klass = nil
+      assert_nothing_raised("#{type} class defined"){ klass = eval "WebBlocks::Structure::#{type}" }
+      assert klass.class == Class
+    end
+
+  end
+
+  def test_structure_attribute_modules
+
+    ['Dependency','LooseDependency'].each do |type|
+      mod = nil
+      assert_nothing_raised("Attribute::#{type} module defined"){ mod = eval "WebBlocks::Structure::Attribute::#{type}" }
+      assert mod.class == Module
+    end
+
+  end
+
+  def test_structure_tree_classes
+
+    ['LeafNode','Node'].each do |type|
+      klass = nil
+      assert_nothing_raised("Tree::#{type} class defined"){ klass = eval "WebBlocks::Structure::Tree::#{type}" }
+      assert klass.class == Class
+    end
+
+  end
+
+end

data/test/web_blocks/support/attribute/class/container.rb

@@ -0,0 +1,29 @@
+require 'test/unit'
+require 'web_blocks/support/attributes/class/container'
+
+class TestSupportAttributesClassContainer < Test::Unit::TestCase
+
+  class Container
+    class << self
+      include WebBlocks::Support::Attributes::Class::Container
+    end
+  end
+
+  def setup
+    @name = Container.name
+  end
+
+  def test_type
+    assert Container.attributes.is_a? Hash
+    assert Container.attributes(@name).is_a? Hash
+  end
+
+  def test_set
+    assert Container.attributes(@name).length == 0
+    Container.set :test1, :value
+    assert Container.attributes(@name).is_a? Hash
+    assert Container.attributes(@name).length == 1
+    assert Container.attributes(@name)[:test1] == :value
+  end
+
+end

data/test/web_blocks/support/attribute/container.rb

@@ -0,0 +1,71 @@
+require 'test/unit'
+require 'web_blocks/support/attributes/container'
+
+class TestSupportAttributesContainer < Test::Unit::TestCase
+
+  class Container
+    include WebBlocks::Support::Attributes::Container
+  end
+
+  class ClassContainer
+    class << self
+      include WebBlocks::Support::Attributes::Class::Container
+    end
+    include WebBlocks::Support::Attributes::Container
+    set :container, :container_value
+    set :container_overridden, :container_value
+  end
+
+  class ContainerWithClassContainers < ClassContainer
+    class << self
+      include WebBlocks::Support::Attributes::Class::Container
+    end
+    include WebBlocks::Support::Attributes::Container
+    set :container_overridden, :container_overridden_value
+  end
+
+  def test_has_get_set
+    container = Container.new
+    assert !container.has?(:key)
+    container.set(:key, :value)
+    assert container.has?(:key)
+    assert container.get(:key) == :value
+    hash = container.set(:key2, :value2)
+    assert hash[:key] == :value
+    assert hash[:key2] == :value2
+  end
+
+  def test_class_attributes
+    container = ContainerWithClassContainers.new
+    class_attributes = container.class_attributes
+    assert class_attributes[:container] == :container_value
+    assert class_attributes[:container_overridden] == :container_overridden_value
+  end
+
+  def test_attributes_with_inheritance
+    container = ContainerWithClassContainers.new
+    assert container.get(:container) == :container_value
+    assert container.get(:container_overridden) == :container_overridden_value
+  end
+
+  def test_attributes_inheritance_with_override
+    container = ContainerWithClassContainers.new
+    container.attributes :container => :instance_override,
+                         :container_overridden => :instance_override
+    assert container.get(:container) == :instance_override
+    assert container.get(:container_overridden) == :instance_override
+  end
+
+  def test_push
+    container = Container.new
+    container.set :arr, []
+    container.push :arr, :val1
+    assert container.get(:arr).length == 1
+    container.push :arr, :val2
+    arr = container.get(:arr)
+    assert arr.length == 2
+    assert arr[0] == :val1
+    assert arr[1] == :val2
+  end
+
+end

data/test/web_blocks/support/tree/child.rb

@@ -0,0 +1,60 @@
+require 'test/unit'
+require 'web_blocks/support/tree/child'
+
+class TestSupportTreeChild < Test::Unit::TestCase
+
+  class Child
+    include ::WebBlocks::Support::Tree::Child
+  end
+
+  class Parent
+    attr_accessor :child
+    # stub method that just sets @child as child rather than adds to array - just for testing purposes
+    # real version in WebBlocks::Support::Tree::Parent adds it to a children array
+    def add_child parent
+      @child = parent
+    end
+  end
+
+  class ChildWithName < Child
+    attr_reader :name
+    def initialize name
+      @name = name
+    end
+  end
+
+  def test_parent
+    child = Child.new
+    assert child.respond_to? :parent
+    assert child.parent == nil
+  end
+
+  def test_set_parent
+    child = Child.new
+    parent = Parent.new
+    child.set_parent parent
+    assert child.parent === parent
+    assert parent.child === child
+  end
+
+  def test_set_parent_no_add_child_method
+    child = Child.new
+    parent_without_add_child = Child.new
+    child.set_parent parent_without_add_child
+    assert child.parent === parent_without_add_child
+  end
+
+  def test_parents
+    child = Child.new
+    parent = Child.new
+    parent_parent = Child.new
+    child.set_parent parent
+    parent.set_parent parent_parent
+    assert child.parent === parent
+    assert parent.parent === parent_parent
+    parents = child.parents
+    assert parents[0] === parent
+    assert parents[1] === parent_parent
+  end
+
+end

data/test/web_blocks/support/tree/node.rb

@@ -0,0 +1,18 @@
+require 'test/unit'
+require 'web_blocks/support/tree/node'
+
+class TestSupportTreeNode < Test::Unit::TestCase
+
+  class Node
+    include ::WebBlocks::Support::Tree::Node
+  end
+
+  def test_name
+    node = Node.new('name')
+    assert node.name == 'name'
+    assert_raise NoMethodError do
+      node.name = 'test'
+    end
+  end
+
+end

data/test/web_blocks/support/tree/parent.rb

@@ -0,0 +1,81 @@
+require 'test/unit'
+require 'web_blocks/support/tree/parent'
+
+class TestSupportTreeParent < Test::Unit::TestCase
+
+  class Parent
+    include ::WebBlocks::Support::Tree::Parent
+  end
+
+  # stub to check named node association
+  class NamedNode
+    attr_reader :name
+    def initialize name
+      @name = name
+    end
+  end
+
+  # stub to check proper call of add_parent
+  class Child < NamedNode
+    attr_reader :parent
+    def set_parent parent
+      @parent = parent
+    end
+  end
+
+  def test_children
+    parent = Parent.new
+    assert parent.children.is_a? Hash
+    assert parent.children.size == 0
+  end
+
+  def test_add_children
+
+    parent = Parent.new
+    child = Child.new 'name'
+
+    parent.add_child child
+    assert parent.children.is_a? Hash
+    assert parent.children.size == 1
+    assert parent.children.has_key? 'name'
+    assert parent.children['name'] === child
+    assert child.parent === parent
+    assert parent.has_child? 'name'
+
+    child2 = Child.new 'name2'
+
+    parent.add_child child2
+    assert parent.children.size == 2
+
+    parent.remove_child 'name2'
+    assert parent.children.size == 1
+    assert parent.children.has_key? 'name'
+    assert parent.has_child? 'name'
+    assert !parent.children.has_key?('name2')
+    assert !parent.has_child?('name2')
+
+  end
+
+  # Should use object as key if no #name method exists
+  def test_add_children_no_name
+    parent = Parent.new
+    child_without_name = Parent.new
+    parent.add_child child_without_name
+    assert parent.children.has_key?(child_without_name)
+    assert parent.children[child_without_name] == child_without_name
+    assert parent.has_child? child_without_name
+    parent.remove_child child_without_name
+    assert !parent.has_child?(child_without_name)
+  end
+
+  def test_add_children_no_set_parent
+    parent = Parent.new
+    named_node = NamedNode.new 'name'
+    assert_nothing_raised do
+      parent.add_child named_node
+    end
+    assert parent.children.has_key? 'name'
+    assert parent.children['name'] === named_node
+  end
+
+end

data/test/web_blocks/version.rb

@@ -0,0 +1,10 @@
+require 'test/unit'
+require 'web_blocks/framework'
+
+class TestVersion < Test::Unit::TestCase
+
+  def test_version
+    assert_nothing_raised("VERSION constant initialized"){ WebBlocks::VERSION }
+  end
+
+end

data/web_blocks.gemspec

@@ -0,0 +1,35 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'web_blocks/version'
+
+Gem::Specification.new do |spec|
+
+  spec.name          = 'web_blocks'
+  spec.version       = WebBlocks::VERSION
+  spec.authors       = ['Eric Bollens']
+  spec.email         = ['ebollens@ucla.edu']
+  spec.description   = 'Package, configuration and dependency manager for web assets (SCSS, JS, images, and fonts)'
+  spec.summary       = 'package, configuration and dependency manager for web assets (SCSS, JS, images, and fonts)'
+  spec.homepage      = 'http://github.com/WebBlocks/WebBlocks'
+  spec.license       = 'BSD'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'thor'
+  spec.add_dependency 'ruby-bower'
+  spec.add_dependency 'execjs'
+  spec.add_dependency 'extend_method'
+  spec.add_dependency 'compass'
+  spec.add_dependency 'sass-css-importer'
+  spec.add_dependency 'fork'
+  spec.add_dependency 'fssm'
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'coveralls'
+
+end