git-story-workflow 1.4.2 → 1.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57fd6d4ff94ab8ef89840a6c7fd9af4ff8865a6aa15ab9c562cbe536c98675af
-  data.tar.gz: 4831ce63881313940343c5e0bf447cba8de302c122ffedb8682cd0ce6125a7f3
+  metadata.gz: b81ff3a4b94ba6bed90472b28eccdad8d3df7e4af30dc3ffe772cbef4ab78cc0
+  data.tar.gz: b2b7347b35bd6d1f1ac63389091b8c0fe80bfb744604ba9b379e5a896fd3b682
 SHA512:
-  metadata.gz: a873c02d9271925c6855017e64034d4a06dba3706c27c6e64d588e5a7aaec12097a3ea0dca44caa6a6202e4867e8ea1b4232cb4e6be9fea54633e1fdd06a4cbe
-  data.tar.gz: 0e9afef53d03a5f306ee92796d2066cf5ce62edc78c42442d8cdb84667fafe4d331a0f6a850b16baf6cb6d8cad8ceddcd76413baab81210fbe57520df1eec202
+  metadata.gz: '05349a0f364e7531b7a22602f4dea569498130b09aa90ab42a749d20b37a29b19a4da542b08fc88b418867d55e352d84a4c2ca7e4435585e8fe679b28807f604'
+  data.tar.gz: b4fe39f78898e26603998ee218223a6d8b76ea895c50c2dcfe6329947e7e13923ef03921bea9bc28e8cd5488c06475a76618a1a3931404777208df81c5a298c1

data/Rakefile

@@ -27,6 +27,7 @@ GemHadar do
   development_dependency 'rake'
   development_dependency 'simplecov'
   development_dependency 'rspec'
+  development_dependency 'byebug'
   licenses << 'Apache-2.0'
 end
 

data/VERSION

@@ -1 +1 @@
-1.4.2
+1.6.2

data/config/story.yml

@@ -1,5 +1,8 @@
 ---
-pivotal_token: <%= ENV['PIVOTAL_TOKEN'] %>
-pivotal_project: 123456789
+pivotal_token:   <%= ENV['PIVOTAL_TOKEN'] %>
+pivotal_project: 1254912
+pivotal_reference_prefix: pivotal
 deploy_tag_prefix: production_deploy_
-semaphore_project_url: https://xxx.semaphoreci.com/projects/yyy
+semaphore_auth_token: <%= ENV['SEMAPHORE_AUTH_TOKEN'] %>
+semaphore_project_url: https://betterplace.semaphoreci.com/projects/betterplace
+todo_nudging: <%= ENV['TODO_NUDGING'].to_i == 1 %>

data/git-story-workflow.gemspec

@@ -1,14 +1,14 @@
 # -*- encoding: utf-8 -*-
-# stub: git-story-workflow 1.4.2 ruby lib
+# stub: git-story-workflow 1.6.2 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "git-story-workflow".freeze
-  s.version = "1.4.2"
+  s.version = "1.6.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Florian Frank".freeze]
-  s.date = "2021-09-27"
+  s.date = "2022-01-12"
   s.description = "Gem abstracting a git workflow\u2026".freeze
   s.email = "flori@ping.de".freeze
   s.executables = ["git-story".freeze]
@@ -17,7 +17,7 @@ Gem::Specification.new do |s|
   s.homepage = "http://flori.github.com/git-story-workflow".freeze
   s.licenses = ["Apache-2.0".freeze]
   s.rdoc_options = ["--title".freeze, "Git-story-workflow".freeze, "--main".freeze, "README.md".freeze]
-  s.rubygems_version = "3.2.15".freeze
+  s.rubygems_version = "3.2.22".freeze
   s.summary = "Gem abstracting a git workflow".freeze
   s.test_files = ["spec/git/story/app_spec.rb".freeze, "spec/spec_helper.rb".freeze]
 
@@ -30,6 +30,7 @@ Gem::Specification.new do |s|
     s.add_development_dependency(%q<rake>.freeze, [">= 0"])
     s.add_development_dependency(%q<simplecov>.freeze, [">= 0"])
     s.add_development_dependency(%q<rspec>.freeze, [">= 0"])
+    s.add_development_dependency(%q<byebug>.freeze, [">= 0"])
     s.add_runtime_dependency(%q<infobar>.freeze, [">= 0"])
     s.add_runtime_dependency(%q<tins>.freeze, [">= 0"])
     s.add_runtime_dependency(%q<mize>.freeze, [">= 0"])
@@ -41,6 +42,7 @@ Gem::Specification.new do |s|
     s.add_dependency(%q<rake>.freeze, [">= 0"])
     s.add_dependency(%q<simplecov>.freeze, [">= 0"])
     s.add_dependency(%q<rspec>.freeze, [">= 0"])
+    s.add_dependency(%q<byebug>.freeze, [">= 0"])
     s.add_dependency(%q<infobar>.freeze, [">= 0"])
     s.add_dependency(%q<tins>.freeze, [">= 0"])
     s.add_dependency(%q<mize>.freeze, [">= 0"])

data/lib/git/story/app.rb

@@ -39,7 +39,13 @@ class Git::Story::App
     @opts      = go 'n:', @argv
     @debug     = debug
     determine_command
-    Git::Story::Setup.perform
+    if !cc.story? && @command != :setup
+      warn "git story configuration file " +
+        "config/story.yml".bold + " is missing.\n\nCall " +
+        "git story setup".bold + " to create an initial one, inspect and " +
+        "edit it yourself, and also set the appropriate env vars.\n\n"
+      @command, @argv = :help, []
+    end
   end
 
   def run
@@ -72,6 +78,15 @@ class Git::Story::App
     )
   end
 
+  command doc: 'initialize git story config file if missing'
+  def setup
+    if cc.config?
+      red("config/story.yml configration already exists!")
+    else
+      Git::Story::Setup.perform
+    end
+  end
+
   command doc: 'output the current story branch if it is checked out'
   def current(check: true)
     if check
@@ -85,31 +100,9 @@ class Git::Story::App
     end
   end
 
-  def provide_name(story_id = nil)
-    until story_id.present?
-      story_id = ask(prompt: 'Story id? ').strip
-    end
-    story_id = story_id.gsub(/[^0-9]+/, '')
-    @story_id = Integer(story_id)
-    if stories.any? { |s| s.story_id == @story_id }
-      @reason = "story for ##@story_id already created"
-      return
-    end
-    if name = fetch_story_name(@story_id)
-      name = normalize_name(
-        name,
-        max_size: 128 - 'story'.size - @story_id.to_s.size - 2 * ?_.size
-      ).full? || name
-      [ 'story', name, @story_id ] * ?_
-    else
-      @reason = "name for ##@story_id could not be fetched from tracker"
-      return
-    end
-  end
-
   command doc: '[STORY_ID] fetch status of current story, -n SECONDS refreshes'
   def status(story_id = current(check: true)&.[](/_(\d+)\z/, 1)&.to_i)
-    if story = fetch_story(story_id)
+    if story = fetch_story(story_id, with_owner: true)
       color_state =
         case cs = story.current_state
         when 'unscheduled', 'planned', 'unstarted'
@@ -132,20 +125,21 @@ class Git::Story::App
         else
           t
         end
-      owners = Array(fetch_story_owners(story_id)).map { |o| "#{o.name} <#{o.email}>" }
       result = <<~end
         Id: #{(?# + story.id.to_s).green}
         Name: #{story.name.inspect.bold}
         Type: #{color_type}
         Estimate: #{story.estimate.to_s.full? { |e| e.yellow.bold } || 'n/a'}
         State: #{color_state}
-        Branch: #{current_branch_checked?&.color('#ff5f00')}
         Labels: #{story.labels.map { |l| l.name.on_color(91) }.join(' ')}
-        Owners: #{owners.join(', ').yellow}
+        Owners: #{story.owners.map { |o| "%s <%s>" % [ o.name, o.email ] }.join(', ').yellow}
         Pivotal: #{story.url.color(33)}
       end
-      if url = github_url(current_branch_checked?)
-        result << "Github: #{url.color(33)}\n"
+      if branch = current_branch_checked? and url = github_url(current_branch_checked?)
+        result << <<~end
+          Github: #{url.color(33)}
+          Branch: #{branch.color('#ff5f00')}
+        end
       end
       result
     end
@@ -211,7 +205,8 @@ class Git::Story::App
     fetch_tags
     opts = ([
       '--color=never',
-      '--pretty=%B'
+      '--pretty=%B',
+      '--reverse',
     ] | rest) * ' '
     output = capture("git log #{opts} #{ref}")
     pivotal_ids = SortedSet[]
@@ -219,18 +214,48 @@ class Git::Story::App
     fetch_statuses(pivotal_ids) * (?┄ * Tins::Terminal.cols << ?\n)
   end
 
-  def fetch_statuses(pivotal_ids)
-    tg = ThreadGroup.new
-    pivotal_ids.each do |pid|
-      tg.add Thread.new { Thread.current[:status] = status(pid) }
+  command doc: '[REF] Create some parts of deploy document'
+  def deploy_document(ref = default_ref, rest: [])
+    ref = build_ref_range(ref)
+    fetch_commits
+    fetch_tags
+    opts = ([
+      '--color=never',
+      '--pretty=%B'
+    ] | rest) * ' '
+    output = capture("git log #{opts} #{ref}")
+    pivotal_ids = SortedSet[]
+    output.scan(/\[\s*#\s*(\d+)\s*\]/) { pivotal_ids << $1.to_i }
+    stories   = ''
+    attendees = Set[]
+    fetch_stories(pivotal_ids) do |pid|
+      story = fetch_story(pid, with_owner: true)
+      if !story
+        stories << "• ** Story with id #{pid} could not be found **"
+        next
+      end
+      attendees.merge story.owners
+      stories << <<~end
+      • [##{story.id}] #{story.name}
+        ○ Pivotal: https://www.pivotaltracker.com/story/show/#{pid}
+        ○ Type: #{story.story_type}
+        ○ Status: #{story.current_state}
+        ○ Owners: #{story.owners.map { |o| "%s <%s>" % [ o.name, o.email ] }.join(', ')}
+        ○ Tasks to be done before deployment:
+          ☐ …
+        ○ Tasks to be done after deployment:
+         ☐ …
+      end
     end
-    tg.list.with_infobar(label: 'Story').map do |t|
-      +infobar
-      t.join
-      t[:status]
+    attendees.map! { |a| "• @#{a.email}" }
+    <<~end
+      #{attendees.join(?\n)}
+
+      #{stories}
     end
   end
 
+
   command doc: '[REF] output diff since last production deploy tag'
   def deploy_diff(ref = default_ref, rest: [])
     ref = build_ref_range(ref)
@@ -261,8 +286,8 @@ class Git::Story::App
     "Story #{name} created.".green
   end
 
-  command doc: '[PATTERN] switch to story matching PATTERN'
-  def switch(pattern = nil)
+  command doc: 'switch to selected story branch'
+  def switch
     fetch_commits
     if branch = pick_branch(prompt: 'Switch to story? %s')
       sh "git checkout #{branch}"
@@ -270,7 +295,7 @@ class Git::Story::App
     end
   end
 
-  command doc: '[PATTERN] delete story branch matching PATTERN'
+  command doc: 'delete selected story branch'
   def delete(pattern = nil)
     fetch_commits
     if branch = pick_branch(prompt: 'Delete story branch? %s', symbol: ?⌦)
@@ -322,6 +347,28 @@ class Git::Story::App
 
   private
 
+  def provide_name(story_id = nil)
+    until story_id.present?
+      story_id = ask(prompt: 'Story id? ').strip
+    end
+    story_id = story_id.gsub(/[^0-9]+/, '')
+    @story_id = Integer(story_id)
+    if stories.any? { |s| s.story_id == @story_id }
+      @reason = "story for ##@story_id already created"
+      return
+    end
+    if name = fetch_story_name(@story_id)
+      name = normalize_name(
+        name,
+        max_size: 128 - 'story'.size - @story_id.to_s.size - 2 * ?_.size
+      ).full? || name
+      [ 'story', name, @story_id ] * ?_
+    else
+      @reason = "name for ##@story_id could not be fetched from tracker"
+      return
+    end
+  end
+
   def determine_command
     c, command = [], nil
     possible_commands = []
@@ -433,11 +480,6 @@ class Git::Story::App
     name
   end
 
-  def apply_pattern(pattern, stories)
-    pattern = pattern.gsub(?#, '')
-    stories.grep(/#{Regexp.quote(pattern)}/)
-  end
-
   def error(msg)
     puts msg.red
     exit 1
@@ -455,8 +497,11 @@ class Git::Story::App
     fetch_story(story_id)&.name
   end
 
-  def fetch_story(story_id)
-    pivotal_get("projects/#{pivotal_project}/stories/#{story_id}").full?
+  def fetch_story(story_id, with_owner: false)
+    if story = pivotal_get("projects/#{pivotal_project}/stories/#{story_id}").full?
+      story.owners = Array((fetch_story_owners(story_id) if with_owner))
+    end
+    story
   end
 
   def fetch_story_owners(story_id)
@@ -571,4 +616,30 @@ class Git::Story::App
     url = url.sub('git@github.com:', 'https://github.com/')
     url = url.sub(/(\.git)\z/, "/tree/#{branch}")
   end
+
+  def fetch_stories(pivotal_ids, &block)
+    block or raise ArgumentError, '&block parameter is required'
+    tg = ThreadGroup.new
+    pivotal_ids.each do |pid|
+      order = 0
+      tg.add(
+        Thread.new do
+          Thread.current[:order] = order
+          Thread.current[:result] = block.(pid)
+        rescue
+        end
+      )
+    end
+    tg.list.with_infobar(label: 'Story').map do |t|
+      t.join
+      +infobar
+      [ t[:order], t[:result] ]
+    end.sort_by(&:first).transpose[1]
+  end
+
+  def fetch_statuses(pivotal_ids)
+    fetch_stories(pivotal_ids) do |pid|
+      status(pid)
+    end
+  end
 end

data/lib/git/story/setup.rb

@@ -8,15 +8,35 @@ module Git::Story::Setup
   PREPARE_COMMIT_MESSAGE_SRC = File.join(__dir__, 'prepare-commit-msg')
   PREPARE_COMMIT_MESSAGE_DST = File.join(HOOKS_DIR, 'prepare-commit-msg')
 
+  CONFIG_TEMPLATE = <<~end
+    ---
+    pivotal_token:   <%= ENV['PIVOTAL_TOKEN'] %>
+    pivotal_project: 123456789
+    pivotal_reference_prefix: pivotal
+    deploy_tag_prefix: production_deploy_
+    semaphore_auth_token: <%= ENV['SEMAPHORE_AUTH_TOKEN'] %>
+    semaphore_project_url: https://betterplace.semaphoreci.com/projects/betterplace
+    todo_nudging: <%= ENV['TODO_NUDGING'].to_i == 1 %>
+  end
+
+
   module_function
 
   def perform(force: false)
+    unless File.directory?('.git')
+      puts "No directory .git found, you need an initialized git repo for this to work"
+      return
+    end
+    install_config('config/story.yml', force: force)
+    install_hooks(force: force)
+    "Setup was performed."
+  end
+
+  def install_hooks(force: false)
     for filename in %w[ prepare-commit-msg pre-push ]
       if path = file_installed?(filename)
-        if force
+        if force || File.read(path).match?(MARKER)
           install_file filename
-        elsif File.read(path).match?(MARKER)
-          ;
         else
           ask(
             prompt: "File #{path.inspect} not created by git-story."\
@@ -43,6 +63,28 @@ module Git::Story::Setup
 
   def install_file(filename)
     File.exist?(HOOKS_DIR) or mkdir_p(HOOKS_DIR)
-    cp File.join(__dir__, filename), File.join(HOOKS_DIR, filename)
+    cp File.join(__dir__, filename), dest = File.join(HOOKS_DIR, filename)
+    puts "#{filename.to_s.inspect} was installed to #{dest.to_s.inspect}."
+  end
+
+  def install_config(filename, force: false)
+    filename = File.expand_path(filename)
+    if !force && File.exist?(filename)
+      ask(
+        prompt: "File #{filename.to_s.inspect} exists."\
+        " Overwrite? (y/n, default is %s) ",
+        default: ?n,
+      ) do |response|
+        if response != ?y
+          puts "Skipping creation of #{filename.to_s.inspect}."
+          return
+        end
+      end
+    end
+    mkdir_p File.dirname(filename)
+    File.secure_write(filename) do |io|
+      io.puts CONFIG_TEMPLATE
+    end
+    puts "#{filename.to_s.inspect} was created."
   end
 end

data/lib/git/story/version.rb

@@ -1,6 +1,6 @@
 module Git::Story
   # Git::Story version
-  VERSION         = '1.4.2'
+  VERSION         = '1.6.2'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: git-story-workflow
 version: !ruby/object:Gem::Version
-  version: 1.4.2
+  version: 1.6.2
 platform: ruby
 authors:
 - Florian Frank
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-27 00:00:00.000000000 Z
+date: 2022-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gem_hadar
@@ -66,6 +66,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: infobar
   requirement: !ruby/object:Gem::Requirement
@@ -204,7 +218,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.2.22
 signing_key:
 specification_version: 4
 summary: Gem abstracting a git workflow