brief 1.17.0 → 1.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 379b1d59287fbfabb503d50cca774092722c3201
-  data.tar.gz: 76b5128f3003dd991804854e39c4b0c712fc7ca0
+  metadata.gz: 3d6d8f0dae8f7fc8a692782b2aa637724d54299b
+  data.tar.gz: 63459143af9c3b81c6c5624ea9713b5e6ac3652d
 SHA512:
-  metadata.gz: e7a88ddd403c7db77efb356de2e1906f67e346eaa2708c9610228fdae3720f1e21147d33c6b52ccb6aa68d2fed69970f891fc8c807c911e0287b2bbda2c9ba76
-  data.tar.gz: e63bd5e5ea3157cb8367ca99d371f6da4371a05ad15cca6d2a00541b1cf3b4456ebccdb7950a14adf725fdabda01f21b6152767916207c063c688c07a4157546
+  metadata.gz: 72b3c6b064a35c9561f17d0282dbd4c4d8fe575e267f0095c4b7c5a236a072687d3473fe834c8eab5e09bf667ebceb0926d75e80cf7e3aad072075d0d572c6f8
+  data.tar.gz: 81b53e8813875d7a708e4a9398cf5b579c6f5f4d61780e90913790a0fb9c30fa58bb39dece4d8d6cb62a1fa7e76c140da69ae721834683a1fcf3adb101aa6e66

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    brief (1.16.3)
+    brief (1.17.1)
       activesupport (> 3.2)
       commander (~> 4.3)
       em-websocket (~> 0.5)

data/apps/blueprint/lib/epic_publisher.rb

@@ -13,6 +13,17 @@ class BlueprintEpicPublisher
     end
   end
 
+  def self.syn(epic, options={})
+    via = (options.fetch(:via, :github) || :github)
+
+    if respond_to?("sync_via_#{via}")
+      send("sync_via_#{via}", epic,options)
+    else
+      raise "Invalid syncing source. Need to implement sync_via_#{via} method"
+    end
+  end
+
+
   # Epics get published to Pivotal
   # directly as epics, since Epics have first class support in pivotal
   def self.publish_via_pivotal(epic, options={})

data/apps/blueprint/lib/feature_publisher.rb

@@ -0,0 +1,29 @@
+class BlueprintFeaturePublisher
+  def self.publish(epic, options={})
+    via = (options.fetch(:via, :github) || :github)
+
+    if respond_to?("publish_via_#{via}")
+      send("publish_via_#{via}", epic,options)
+    else
+      raise "Invalid publishing source. Need to implement publish_via_#{via} method"
+    end
+  end
+
+  def self.sync(epic, options={})
+    via = (options.fetch(:via, :github) || :github)
+
+    if respond_to?("sync_via_#{via}")
+      send("sync_via_#{via}", epic,options)
+    else
+      raise "Invalid syncing source. Need to implement sync_via_#{via} method"
+    end
+  end
+
+  def self.publish_via_pivotal(epic, options={})
+    raise "Not Implemented.  Implement #{ name }.publish_via_pivotal"
+  end
+
+  def self.publish_via_github(epic, options={})
+    raise "Not Implemented.  Implement #{ name }.publish_via_github"
+  end
+end

data/apps/blueprint/lib/milestone_publisher.rb

@@ -0,0 +1,29 @@
+class BlueprintMilestonePublisher
+  def self.publish(epic, options={})
+    via = (options.fetch(:via, :github) || :github)
+
+    if respond_to?("publish_via_#{via}")
+      send("publish_via_#{via}", epic,options)
+    else
+      raise "Invalid publishing source. Need to implement publish_via_#{via} method"
+    end
+  end
+
+  def self.sync(epic, options={})
+    via = (options.fetch(:via, :github) || :github)
+
+    if respond_to?("sync_via_#{via}")
+      send("sync_via_#{via}", epic,options)
+    else
+      raise "Invalid syncing source. Need to implement sync_via_#{via} method"
+    end
+  end
+
+  def self.publish_via_pivotal(epic, options={})
+    raise "Not Implemented.  Implement #{ name }.publish_via_pivotal"
+  end
+
+  def self.publish_via_github(epic, options={})
+    raise "Not Implemented.  Implement #{ name }.publish_via_github"
+  end
+end

data/apps/blueprint/lib/project_publisher.rb

@@ -0,0 +1,29 @@
+class BlueprintProjectPublisher
+  def self.publish(epic, options={})
+    via = (options.fetch(:via, :github) || :github)
+
+    if respond_to?("publish_via_#{via}")
+      send("publish_via_#{via}", epic,options)
+    else
+      raise "Invalid publishing source. Need to implement publish_via_#{via} method"
+    end
+  end
+
+  def self.sync(epic, options={})
+    via = (options.fetch(:via, :github) || :github)
+
+    if respond_to?("sync_via_#{via}")
+      send("sync_via_#{via}", epic,options)
+    else
+      raise "Invalid syncing source. Need to implement sync_via_#{via} method"
+    end
+  end
+
+  def self.publish_via_pivotal(epic, options={})
+    raise "Not Implemented.  Implement #{ name }.publish_via_pivotal"
+  end
+
+  def self.publish_via_github(epic, options={})
+    raise "Not Implemented.  Implement #{ name }.publish_via_github"
+  end
+end

data/apps/blueprint/models/epic.rb

@@ -58,6 +58,18 @@ class Brief::Apps::Blueprint::Epic
 
   helpers do
     def features
+      briefcase.features(project: project, epic: title)
+    end
+
+    def parent_project
+      briefcase.projects(project: project).first
+    end
+
+    def find_feature_by_title(feature_title)
+      briefcase.features(project: project, epic: title, title: feature_title)
+    end
+
+    def features_data
       sections.features.items.map do |item|
         item.components = Array(item.components)
 
@@ -68,8 +80,41 @@ class Brief::Apps::Blueprint::Epic
       end
     end
 
+    def generate_feature_content(feature_heading)
+      if feature_file_for(feature_heading).exist?
+        return feature_file_for(feature_heading).read
+      end
+
+      data = {
+        status: "published",
+        project: project,
+        epic: title,
+        title: feature_heading
+      }
+
+      content = raw_content_for_feature(feature_heading)
+
+      data.to_yaml + "\n---\n" + content
+    end
+
+    def feature_file_for(feature_heading)
+      folder = features_folder
+      filename = feature_heading.strip.parameterize
+      folder.join(filename)
+    end
+
+    def features_folder
+      briefcase.docs_path.join("features", project.parameterize, title.parameterize)
+    end
+
     def raw_content_for_feature(feature_heading, include_heading=true)
-      document.content_under_heading(feature_heading, include_heading)
+      document.content_under_heading(feature_heading, include_heading).tap do |v|
+
+        # UGLY
+        # Promotes the h2 heading to an h1 for this document
+        v.gsub! "## #{ feature_heading }", "# #{ feature_heading }"
+        v.gsub! "###{ feature_heading }", "##{ feature_heading }"
+      end
     end
 
     def estimate_cli

data/apps/blueprint/models/feature.rb

@@ -11,7 +11,7 @@ class Brief::Apps::Blueprint::Feature
     persona
     goal
     behavior
-    epic_title
+    epic
     remote_id
     tags Array
   end
@@ -26,7 +26,18 @@ class Brief::Apps::Blueprint::Feature
   end
 
   actions do
-    def sync_with_github
+    def publish
+      BlueprintFeaturePublisher.publish(self, via: briefcase.settings.try(:tracking_system))
+    end
+
+    def sync
+      BlueprintFeaturePublisher.sync(self, via: briefcase.settings.try(:tracking_system))
+    end
+  end
+
+  helpers do
+    def parent_epic
+      briefcase.epics(title: epic, project: data.project).first
     end
   end
 end

data/apps/blueprint/models/milestone.rb

@@ -18,4 +18,14 @@ class Brief::Apps::Blueprint::Milestone
     paragraphs "p"
     yaml_data "code.yaml:first-of-type", :serialize => :yaml, :hide => true
   end
+
+  actions do
+    def publish
+      BlueprintMilestonePublisher.publish(self, via: briefcase.settings.try(:tracking_system))
+    end
+
+    def sync
+      BlueprintMilestonePublisher.sync(self, via: briefcase.settings.try(:tracking_system))
+    end
+  end
 end

data/apps/blueprint/models/project.rb

@@ -16,6 +16,16 @@ class Brief::Apps::Blueprint::Project
     yaml_data "code.yaml:first-of-type", :serialize => :yaml, :hide => true
   end
 
+  actions do
+    def publish
+      BlueprintProjectPublisher.publish(self, via: briefcase.settings.try(:tracking_system))
+    end
+
+    def sync
+      BlueprintProjectPublisher.sync(self, via: briefcase.settings.try(:tracking_system))
+    end
+  end
+
   def epics
     briefcase.epics(project: title)
   end

data/lib/brief/document/source_map.rb

@@ -34,15 +34,20 @@ module Brief::Document::SourceMap
   def content_under_heading(heading_element, include_heading=true)
     if heading_element.is_a?(String) && heading_element.length > 1
       heading_element = heading_element_tags.find do |el|
-        el.attr('data-heading').include?(heading_element) || el.text.to_s.include?(heading_element)
+        el.attr('data-heading').include?(heading_element.strip.downcase) || el.text.to_s.strip.downcase.include?(heading_element.strip.downcase)
       end
     end
 
+    if heading_element.nil?
+      return nil
+    end
+
     start_index = heading_element.attr('data-line-number').to_i
-    end_index = content.lines.length
 
     if next_heading = next_sibling_heading_for(heading_element)
       end_index = next_heading.attr('data-line-number').to_i
+    else
+      end_index = raw_content.lines.length + 1
     end
 
     end_index = end_index - start_index
@@ -50,6 +55,6 @@ module Brief::Document::SourceMap
 
     lines = raw_content.lines.dup.slice(start_index - 1, end_index)
 
-    (include_heading ? lines : lines.slice(1, lines.length)).join("")
+    Array(include_heading ? lines : lines.slice(1, lines.length)).join("")
   end
 end

data/lib/brief/version.rb

@@ -1,3 +1,3 @@
 module Brief
-  VERSION = '1.17.0'
+  VERSION = '1.17.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brief
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.17.1
 platform: ruby
 authors:
 - Jonathan Soeder
@@ -344,6 +344,9 @@ files:
 - apps/blueprint/examples/wireframe.md
 - apps/blueprint/extensions/middleman.rb
 - apps/blueprint/lib/epic_publisher.rb
+- apps/blueprint/lib/feature_publisher.rb
+- apps/blueprint/lib/milestone_publisher.rb
+- apps/blueprint/lib/project_publisher.rb
 - apps/blueprint/models/concept.rb
 - apps/blueprint/models/diagram.rb
 - apps/blueprint/models/epic.rb
@@ -359,6 +362,7 @@ files:
 - apps/blueprint/models/sitemap.rb
 - apps/blueprint/models/wireframe.rb
 - apps/blueprint/templates/epic.md.erb
+- apps/blueprint/templates/feature.md.erb
 - apps/blueprint/templates/milestone.md.erb
 - apps/blueprint/templates/page.md.erb
 - apps/blueprint/templates/persona.md.erb