kayessess 0.1.0

data/spec/lib/node_spec.rb

@@ -0,0 +1,101 @@
+require_relative "../../lib/kayessess/node"
+
+describe Kayessess::Node do
+  subject(:node) { Kayessess::Node.new(id, name, parent, children_hash, sections_hash) }
+  let(:id) { 'components' }
+  let(:name) { 'Components' }
+  let(:parent) { double(Kayessess::Node) }
+  let(:children_hash) { double() }
+  let(:sections_hash) { double() }
+
+  describe "#id" do
+    subject { node.id }
+    it { should == id }
+  end
+
+  describe "#name" do
+    subject { node.name }
+    it { should == name }
+  end
+
+  describe "#parent" do
+    subject { node.parent }
+    it { should == parent }
+  end
+
+  describe "#to_param" do
+    subject { node.to_param }
+
+    context "converts to lowercase" do
+      let(:name) { 'FOOBAR' }
+      it { should == 'foobar' }
+    end
+
+    context "name has spaces" do
+      let(:name) { 'Herp Derp' }
+      it { should == 'herp-derp' }
+    end
+
+    context "name has slashes" do
+      let(:name) { 'Herp \/// Derp' }
+      it { should == 'herp-derp' }
+    end
+  end
+
+  describe "#to_path" do
+    subject { node.to_path }
+    let(:parent) { double(Kayessess::Node, parent: parent1) }
+    let(:parent1) { double(Kayessess::Node, parent: nil) }
+
+    before {
+      parent.should_receive(:to_param) { 'velociraptor' }
+      parent1.should_not_receive(:to_param) { 'decepticon' }
+    }
+
+    it "returns a path that is relative to the styleguide root" do
+      expect(subject).to eq('velociraptor/components')
+    end
+
+    it "excludes the root path from the path" do
+      expect(subject).to_not include 'decepticon'
+    end
+  end
+
+  describe "#parents" do
+    subject { node.parents }
+    let(:parent) { double(Kayessess::Node, parent: parent1) }
+    let(:parent1) { double(Kayessess::Node, parent: parent2) }
+    let(:parent2) { double(Kayessess::Node, parent: parent3) }
+    let(:parent3) { double(Kayessess::Node, parent: nil) }
+
+    it "allows for enumeration over parent nodes" do
+      expect(subject.next).to be parent
+      expect(subject.next).to be parent1
+      expect(subject.next).to be parent2
+      expect(subject.next).to be parent3
+    end
+  end
+
+  describe "#children" do
+    subject { node.children }
+    let(:children_hash) { {dinosaurs: child1, robots: child2} }
+    let(:child1) { double() }
+    let(:child2) { double() }
+
+    it { should == [child1, child2] }
+  end
+
+  describe "#sections" do
+    subject { node.sections }
+    let(:sections_hash) { {dinosaurs: section1, robots: section2} }
+    let(:section1) { double() }
+    let(:section2) { double() }
+
+    it { should == [section1, section2] }
+  end
+
+  describe "#is_section?" do
+    subject { node.is_section? }
+    it { should == false }
+  end
+end

data/spec/lib/section_spec.rb

@@ -0,0 +1,47 @@
+require 'spec_helper'
+require_relative "../../lib/kayessess"
+require_relative "../../lib/kayessess/section"
+
+describe Kayessess::Section do
+  subject(:section) { Kayessess::Section.new(id, name, parent, sub_section) }
+  let(:id) { 'components' }
+  let(:name) { 'Components' }
+  let(:parent) { double(Kayessess::Node) }
+  let(:sub_section) { double(section: 'Foo.Bar.Hello World', filename: '_foobar.scss') }
+
+  describe "#reference" do
+    subject { section.reference }
+    it { should == 'Foo.Bar.Hello World' }
+  end
+
+  describe "#description" do
+    subject { section.description }
+    let(:sub_section) { double(description: 'Ice cream is **BEST!**') }
+    it { should == "<p>Ice cream is <strong>BEST!</strong></p>\n" }
+  end
+
+  describe "#modifiers" do
+    subject { section.modifiers }
+    pending
+  end
+
+  describe "#filename" do
+    subject { section.filename }
+    it { should == '_foobar.scss' }
+  end
+
+  describe "#example_partial_path" do
+    subject { section.example_partial_path }
+    it { should == "styleguide/examples/foo/bar/hello_world" }
+  end
+
+  describe "#to_partial_path" do
+    subject { section.to_partial_path }
+    it { should == "section" }
+  end
+
+  describe "#is_section?" do
+    subject { section.is_section? }
+    it { should == true }
+  end
+end

data/spec/lib/styleguide_spec.rb

@@ -0,0 +1,19 @@
+require_relative "../../lib/kayessess/styleguide"
+
+describe Kayessess::Styleguide do
+  subject(:styleguide) { Kayessess::Styleguide.new(parser) }
+  let(:parser) { double(sections: []) }
+  let(:tree) { double(Kayessess::Tree) }
+
+  describe "#sections" do
+    pending
+  end
+
+  describe "#section" do
+    pending
+  end
+
+  describe "#to_partial_path" do
+    its(:to_partial_path) { should == "styleguide" }
+  end
+end

data/spec/lib/tree_spec.rb

@@ -0,0 +1,60 @@
+require_relative "../../lib/kayessess/tree"
+
+describe Kayessess::Tree do
+  subject(:tree) { Kayessess::Tree.new(sections) }
+  let(:section1) { double(Kayessess::Section) }
+  let(:section2) { double(Kayessess::Section) }
+  let(:section3) { double(Kayessess::Section) }
+  let(:sections) do
+    [
+      ["Buttons.Primary Button", section1],
+      ["Buttons.Secondary Button", section2],
+      ["Components.Headers", section3]
+    ]
+  end
+
+  describe "#root_sections" do
+    subject { tree.root_sections }
+
+    it "returns the children of the styleguide root" do
+      expect(subject.length).to be 2
+      expect(subject[0].sections[0].id).to eq "primary-button"
+      expect(subject[0].sections[1].id).to eq "secondary-button"
+      expect(subject[1].sections[0].id).to eq "headers"
+    end
+  end
+
+  describe "#node_for_path" do
+    subject { tree.node_for_path(section_path) }
+
+    context "when the path exists" do
+      context "for a child node" do
+        let(:section_path) { "Buttons".split('.') }
+
+        it "returns the node that matches the path passed in" do
+          expect(subject.id).to eq "buttons"
+          expect(subject.parent.id).to eq :root
+          expect(subject.children).to eq []
+          expect(subject.sections.map(&:id)).to include "primary-button"
+          expect(subject.sections.map(&:id)).to include "secondary-button"
+        end
+      end
+
+      context "for a styleguide section" do
+        let(:section_path) { "Buttons.Primary Button".split('.') }
+
+        it "returns the node that matches the path passed in" do
+          expect(subject.id).to eq "primary-button"
+        end
+      end
+    end
+
+    context "when the section does not exist" do
+      let(:section_path) { ["buttons", "herp", "derp"] }
+
+      it "throws an error if the path isn't found" do
+        expect { subject }.to raise_error Kayessess::SectionNotFound
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+ENV['RAILS_ENV'] ||= 'test'
+
+if ENV['COVERAGE']
+  require_relative 'use_coveralls' if ENV['TRAVIS']
+  require_relative 'use_simplecov' unless ENV['TRAVIS']
+end
+
+require 'bundler/setup'
+require 'combustion'
+require 'rails'
+require 'kayessess'
+
+Combustion.initialize! :action_controller, :action_view, :sprockets
+
+require 'rspec/rails'
+require 'rspec/autorun'
+
+RSpec.configure do |config|
+  config.order = "random"
+end