qb 0.1.36 → 0.1.37

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ba8c588f4c5401fbefe1a8000ea8354707269fe6
-  data.tar.gz: 5fcac34c7a16b53e92b5db9190edf215cadd8884
+  metadata.gz: cafbcb81c0a8179b326824b5b89203534604398c
+  data.tar.gz: 46823f3b27926e4c5652f4fac6b2932d3d74250a
 SHA512:
-  metadata.gz: 76ca3d2c460501ed7ece33233a38f33e9f0fd70eaee54e1f0cff8c5339b348806d4afd010099b7d933409210c0e54d8dbfb08770ee24b7a7767f608da013533c
-  data.tar.gz: cb7bd2957dab55aaabbb49bd996cc3e8b7425ec0f3688c5f5bfe0c7c8c0c8221d047e29b027ebf7c00c4899c5a593f8323f066e112856d144bde970f9867a809
+  metadata.gz: b6d08dab932b56a417c31fd56dd3584d8cf6874f6f467dcd22e575806fe39e8894fa447905f18258023be19a0f2c0b17389d1bdb941397058b63f567180fdb8c
+  data.tar.gz: 3167ccdd9f411767e2302c58adf8d697e428c7515d5c30502e645fe4c43a2d707d34e99fe2c77850c45e77b0607f33dff6bde49744de9ea855ecc48cea16daa0

data/ansible.cfg

@@ -1,5 +1,5 @@
 [defaults]
 
-# roles_path = ./tmp/roles:./roles
+roles_path = ./dev/scratch
 filter_plugins = ./roles/qb.gem/filter_plugins
 retry_files_enabled = False

data/bin/rake

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+bundle exec rake

data/dev/scratch/ansible_module/defaults/main.yml

@@ -0,0 +1,2 @@
+---
+# defaults file for ansible_module

data/dev/scratch/ansible_module/library/test

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+# WANT_JSON
+
+# init bundler in dev env
+if ENV['QB_DEV_ENV']
+  ENV.each {|k, v|
+    if k.start_with? 'QB_DEV_ENV_'
+      ENV[k.sub('QB_DEV_ENV_', '')] = v
+    end
+  }
+  require 'bundler/setup'
+end
+
+require 'qb'
+
+class Test < QB::AnsibleModule
+  def main
+    changed! blah: "blow me: #{ @args['x'] }"
+  end
+end
+
+Test.new.run

data/dev/scratch/ansible_module/meta/main.yml

@@ -0,0 +1,8 @@
+---
+# meta file for ansible_module
+
+allow_duplicates: yes
+
+dependencies: []
+# - role: role-name
+

data/dev/scratch/ansible_module/meta/qb.yml

@@ -0,0 +1,44 @@
+---
+# meta/qb.yml file for ansible_module
+# 
+# qb settings for this role. see README.md for more info.
+#
+
+# description of the role to show in it's help output.
+description: null
+
+# prefix for role variables
+var_prefix: null
+
+# how to get a default for `dir` if it's not provided as the only
+# positional argument. if a positional argument is provided it will
+# override the method defined here.
+# 
+# options:
+# 
+# -   null
+#     -   require the value on the command line.
+# -   git_root
+#     -   use the git root fof the directory that the `qb` command is invoked
+#         from. useful for 'project-centric' commands so they can be invoked
+#         from anywhere in the repo.
+# -   cwd
+#     -   use the directory the `qb` command is invoked form.
+# -   {exe: PATH}
+#     -   invoke an execuable, passing a JSON serialization of the options 
+#         mapping their CLI names to values. path can be relative to role
+#         directory.
+default_dir: cwd
+
+# default user to become for play
+default_user: null
+
+# set to false to not save options in .qb-options.yml files
+save_options: false
+
+options: []
+# - name: example
+#   description: an example of a variable.
+#   required: false
+#   type: boolean # boolean (default) | string
+#   short: e

data/dev/scratch/ansible_module/tasks/main.yml

@@ -0,0 +1,9 @@
+---
+# tasks file for ansible_module
+
+- name: test QB::AnsibleModule
+  test:
+    x: ex
+
+- debug:
+    msg: "{{ blah }}"

data/dev/scratch/stdio/defaults/main.yml

@@ -0,0 +1,4 @@
+---
+stdio_raise: false
+stdio_count: false
+  

data/dev/scratch/stdio/library/test

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+# WANT_JSON
+
+# init bundler in dev env
+if ENV['QB_DEV_ENV']
+  ENV.each {|k, v|
+    if k.start_with? 'QB_DEV_ENV_'
+      ENV[k.sub('QB_DEV_ENV_', '')] = v
+    end
+  }
+  require 'bundler/setup'
+end
+
+require 'qb'
+require 'pp'
+
+class Test < QB::AnsibleModule
+  def main
+    QB.debug args: @args
+    
+    if @args['count']
+      (1..10).each {|i|
+        puts i
+        sleep 1
+      }
+    end
+    
+    raise "HERE" if @args['raise']
+    
+    nil
+  end
+end
+
+Test.new.run

data/dev/scratch/stdio/meta/main.yml

@@ -0,0 +1,8 @@
+---
+# meta file for stdio
+
+allow_duplicates: yes
+
+dependencies: []
+# - role: role-name
+

data/dev/scratch/stdio/meta/qb.yml

@@ -0,0 +1,55 @@
+---
+# meta/qb.yml file for stdio
+# 
+# qb settings for this role. see README.md for more info.
+#
+
+# description of the role to show in it's help output.
+description: null
+
+# prefix for role variables
+var_prefix: null
+
+# how to get a default for `dir` if it's not provided as the only
+# positional argument. if a positional argument is provided it will
+# override the method defined here.
+# 
+# options:
+# 
+# -   null
+#     -   require the value on the command line.
+# -   git_root
+#     -   use the git root fof the directory that the `qb` command is invoked
+#         from. useful for 'project-centric' commands so they can be invoked
+#         from anywhere in the repo.
+# -   cwd
+#     -   use the directory the `qb` command is invoked form.
+# -   {exe: PATH}
+#     -   invoke an execuable, passing a JSON serialization of the options 
+#         mapping their CLI names to values. path can be relative to role
+#         directory.
+default_dir: cwd
+
+# default user to become for play
+default_user: null
+
+# set to false to not save options in .qb-options.yml files
+save_options: false
+
+options:
+# - name: example
+#   description: an example of a variable.
+#   required: false
+#   type: boolean # boolean (default) | string
+#   short: e
+- name: raise
+  description: raise an error in main.
+  required: false
+  type: boolean
+  short: r
+
+- name: count
+  description: count to 10 on stdout with 1 sec sleeps between
+  required: false
+  type: boolean
+  short: c

data/dev/scratch/stdio/tasks/main.yml

@@ -0,0 +1,5 @@
+---
+# tasks file for stdio
+- test:
+    count: "{{ stdio_count }}"
+    raise: "{{ stdio_raise }}"

data/exe/qb

@@ -42,7 +42,7 @@ end
 
 def set_debug! args
   if DEBUG_ARGS.any? {|arg| args.include? arg}
-    QB.debug = true
+    ENV['QB_DEBUG'] = 'true'
     debug "ON"
     DEBUG_ARGS.each {|arg| args.delete arg}
   end
@@ -78,11 +78,15 @@ def with_clean_env &block
       ].include?(k)
     }
     
+    qb_env = ENV.select {|k, v| k.start_with? 'QB_'}
+    
     Bundler.with_clean_env do
       # now that we're in a clean env, copy the Bundler env vars into 
       # 'QB_DEV_ENV_<NAME>' vars.
       dev_env.each {|k, v| ENV["QB_DEV_ENV_#{ k }"] = v}
       
+      qb_env.each {|k, v| ENV[k] = v}
+      
       # and set QB_DEV_ENV=true
       ENV['QB_DEV_ENV'] = 'true'
       
@@ -352,8 +356,17 @@ def main args
       
       puts "COMMAND: #{ cmd }"
       
+      # boot up stdio services so that ansible modules can stream to our
+      # stdout and stderr to print stuff (including debug lines) in real-time
+      stdio_services = {'out' => $stdout, 'err' => $stderr}.map do |name, dest|
+        QB::Util::STDIO::Service.new(name, dest).tap {|s| s.open! }
+      end
+      
       status = Cmds.stream cmd
       
+      # close the stdio services
+      stdio_services.each {|s| s.close! }
+      
       if status != 0
         puts "ERROR ansible-playbook failed."
       end

data/lib/qb.rb

@@ -1,6 +1,9 @@
 require 'nrser/extras'
 
 require "qb/version"
+require "qb/util"
+require 'qb/util/stdio'
+require "qb/ansible_module"
 
 module QB
   ROOT = (Pathname.new(__FILE__).dirname + '..').expand_path
@@ -10,16 +13,8 @@ module QB
   class Error < StandardError
   end
   
-  # TODO this should be in an instance that is run instead of module global
-  # hack for now
-  @@debug = false
-  
-  def self.debug= bool
-    @@debug = !!bool
-  end
-  
   def self.debug *args
-    return unless @@debug && args.length > 0
+    return unless ENV['QB_DEBUG'] && args.length > 0
     
     header = 'DEBUG'
     

data/lib/qb/ansible_module.rb

@@ -0,0 +1,65 @@
+require 'json'
+
+module QB
+  class AnsibleModule
+    def self.stringify_keys hash
+      hash.map {|k, v| [k.to_s, v]}.to_h
+    end
+    
+    def initialize
+      @changed = false
+      @input_file = ARGV[0]
+      @input = File.read @input_file
+      @args = JSON.load @input
+      @facts = {}
+      
+      # if QB_STDIO_ env vars are set send stdout and stderr
+      # to those sockets to print in the parent process
+      
+      if ENV['QB_STDIO_OUT']
+        $stdout = UNIXSocket.new ENV['QB_STDIO_OUT']
+      end
+      
+      if ENV['QB_STDIO_ERR']
+        $stderr = UNIXSocket.new ENV['QB_STDIO_ERR']
+      end
+    end
+    
+    def run
+      result = main
+      
+      case result
+      when nil
+        # pass
+      when Hash
+        @facts.merge! result
+      else
+        raise "result of #main should be nil or Hash, found #{ result.inspect }"
+      end
+      
+      done
+    end
+    
+    def changed! facts = {}
+      @changed = true
+      @facts.merge! facts
+      done
+    end
+    
+    def done
+      exit_json changed: @changed,
+                ansible_facts: self.class.stringify_keys(@facts)
+    end
+    
+    def exit_json hash
+      # print JSON response to process' actual STDOUT (instead of $stdout,
+      # which may be pointing to the qb parent process)
+      STDOUT.print JSON.dump(self.class.stringify_keys(hash))
+      exit 0
+    end
+    
+    def fail msg
+      exit_json failed: true, msg: msg
+    end
+  end
+end # QB

data/lib/qb/options.rb

@@ -161,7 +161,7 @@ module QB
       
       qb_options = {
         'hosts' => ['localhost'],
-        'facts' => false,
+        'facts' => true,
       }
       
       if role.meta['default_user']
@@ -212,11 +212,10 @@ module QB
         end
         
         opts.on(
-          '-F',
-          '--FACTS',
-          "gather facts (often un-needed)",
+          '--NO-FACTS',
+          "don't gather facts",
         ) do |value|
-          qb_options['facts'] = value
+          qb_options['facts'] = false
         end
         
         add opts, role_options, role

data/lib/qb/role.rb

@@ -1,5 +1,6 @@
 require 'yaml'
 require 'cmds'
+require 'parseconfig'
 
 module QB
   class Role
@@ -46,17 +47,44 @@ module QB
       ['qb.yml', 'qb'].any? {|filename| pathname.join('meta', filename).file?}
     end
     
-    # array of Pathname places to look for role dirs.
-    def self.search_path
-      [
-        QB::ROLES_DIR,
-        Pathname.new(Dir.getwd).join('roles'),
-        Pathname.new(Dir.getwd).join('ansible', 'roles'),
-        Pathname.new(Dir.getwd).join('dev', 'roles'),
-        Pathname.new(Dir.getwd).join('dev', 'roles', 'tmp'),
+    # get role paths from ansible.cfg if it exists in a directory.
+    # 
+    # @param dir [Pathname] directory to look for ansible.cfg in.
+    # 
+    # @return [Array<String>] role paths
+    # 
+    def self.cfg_roles_path dir
+      path = dir.join 'ansible.cfg'
+      
+      if path.file?
+        config = ParseConfig.new path.to_s
+        config['defaults']['roles_path'].split(':').map {|path|
+          QB::Util.resolve dir, path
+        }
+      else
+        []
+      end
+    end
+    
+    # @param dir [Pathname] dir to include.
+    def self.roles_paths dir
+      cfg_roles_path(dir) + [
+        dir.join('roles'),
+        dir.join('roles', 'tmp')
       ]
     end
     
+    # @return [Array<Pathname>] places to look for role dirs.
+    def self.search_path
+      [QB::ROLES_DIR] + [
+        QB::Util.resolve,
+        QB::Util.resolve('ansible'),
+        QB::Util.resolve('dev'),
+      ].map {|dir|
+        roles_paths dir
+      }.flatten
+    end
+    
     # array of QB::Role found in search path.
     def self.available
       search_path.
@@ -69,6 +97,8 @@ module QB
           search_dir.children.select {|child| role_dir? child }
         }.
         flatten.
+        # should allow uniq to remove dups
+        map {|role_dir| role_dir.realpath }.
         # needed when qb is run from the qb repo since QB::ROLES_DIR and
         # ./roles are the same dir
         uniq.
@@ -79,8 +109,10 @@ module QB
     
     # get an array of QB::Role that match an input string
     def self.matches input
+      available = self.available
+      
       available.each {|role|
-        # exact match to relitive path
+        # exact match to relative path
         return [role] if role.rel_path.to_s == input
       }.each {|role|
         # exact match to full name
@@ -88,12 +120,29 @@ module QB
       }.each {|role|
         # exact match without the namespace prefix ('qb.' or similar)
         return [role] if role.namespaceless == input
-      }.select {|role|
-        # select any that have that string in them
-        role.rel_path.to_s.include? input
-      }.tap {|matches|
-        QB.debug "role matches" => matches
       }
+      
+      # see if we prefix match any full names
+      name_prefix_matches = available.select {|role|
+        role.name.start_with? input
+      }
+      return name_prefix_matches unless name_prefix_matches.empty?
+      
+      # see if we prefix match any name
+      namespaceless_prefix_matches = available.select {|role|
+        role.namespaceless.start_with? input
+      }
+      unless namespaceless_prefix_matches.empty?
+        return namespaceless_prefix_matches 
+      end
+      
+      # see if we word match any names
+      name_word_matches = available.select {|role|
+        QB::Util.words_start_with? role.name, input
+      }
+      return name_word_matches unless name_word_matches.empty?
+      
+      []
     end
     
     # find exactly one matching role for the input string or raise.

data/lib/qb/util.rb

@@ -0,0 +1,54 @@
+module QB
+  module Util
+    # split a string into 'words' for word-based matching
+    def self.words string
+      string.split(/[\W_-]+/).reject {|w| w.empty?}
+    end # .words
+    
+    # see if words from an input match words 
+    def self.words_start_with? full_string, input
+      # QB.debug "does #{ input } match #{ full_string }?"
+      
+      input_words = words input
+      full_string_words = words full_string
+      
+      full_string_words.each_with_index {|word, start_index|
+        # compute the end index in full_string_words
+        end_index = start_index + input_words.length - 1
+        
+        # short-circuit if can't match (more input words than full words left)
+        if end_index >= full_string_words.length
+          return false
+        end
+        
+        # create the slice to test against
+        slice = full_string_words[start_index..end_index]
+        
+        # see if every word in the slice starts with the corresponding word
+        # in the input
+        if slice.zip(input_words).all? {|full_word, input_word|
+          full_word.start_with? input_word
+        }
+          # got a match!
+          return true
+        end
+      }
+      
+      # no match
+      false
+    end # .match_words?
+    
+    # @return [Pathname] absolute resolved path.
+    def self.resolve *segments
+      joined = Pathname.new ''
+      
+      ([Dir.pwd] + segments).reverse.each_with_index {|segment, index|
+        joined = Pathname.new(segment).join joined
+        return joined if joined.absolute?
+      }
+      
+      # shouldn't ever happen
+      raise "resolution failed: #{ segments.inspect }"
+    end
+  end # Util
+end # QB

data/lib/qb/util/stdio.rb

@@ -0,0 +1,86 @@
+require 'thread'
+require 'socket'
+require 'securerandom'
+require 'fileutils'
+require 'nrser'
+
+using NRSER
+
+module QB; end
+module QB::Util; end
+
+module QB::Util::STDIO
+  SOCKET_DIR = Pathname.new('/').join 'tmp', 'qb-stdio'
+  
+  # STDIO as a service exposed on a UNIX socket so that modules can stream
+  # their output to it, which is in turn printed to the console `qb` is running
+  # in.
+  class Service
+    def initialize name, dest
+      @name = name
+      @dest = dest
+      @thread = nil
+      @server = nil
+      @socket = nil
+      @env_key = "QB_STDIO_#{ name.upcase }"
+      
+      unless SOCKET_DIR.exist?
+        FileUtils.mkdir SOCKET_DIR
+      end
+      
+      @path = SOCKET_DIR.join "#{ name }.#{ SecureRandom.uuid }.sock"
+      
+      @debug_header = "#{ name }@#{ @path.to_s }"
+    end
+    
+    def debug *args
+      QB.debug "#{ @debug_header }", *args
+    end
+    
+    def open!
+      debug "opening..."
+      
+      # make sure env var is not already set (basically just prevents you from
+      # accidentally opening two instances with the same name)
+      if ENV.key? @env_key
+        raise <<-END.squish
+          env already contains key #{ @env_key } with value #{ ENV[@env_key] }
+        END
+      end
+      
+      @thread = Thread.new do
+        debug "thread started."
+        
+        @server = UNIXServer.new @path.to_s
+        @socket = @server.accept
+        
+        while (line = @socket.gets) do
+          @dest.puts line
+        end
+      end
+      
+      # set the env key so children can find the socket path
+      ENV[@env_key] = @path.to_s
+      debug "set env var #{ @env_key }=#{ ENV[@env_key] }"
+      
+      debug "service open."
+    end # open
+    
+    def close!
+      # clean up.
+      # 
+      # TODO not sure how correct this is...
+      # 
+      debug "closing..."
+      
+      @thread.kill
+      @socket.close
+      @socket = nil
+      @server.close
+      @server = nil
+      FileUtils.rm @path
+      
+      debug "closed."
+    end
+  end # Service
+end # QB::Util::STDIO

data/lib/qb/version.rb

@@ -1,7 +1,7 @@
 module QB
   GEM_NAME = 'qb'
   
-  VERSION = "0.1.36"
+  VERSION = "0.1.37"
   
   def self.gemspec
     Gem.loaded_specs[GEM_NAME]

data/qb.gemspec

@@ -44,6 +44,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "cmds",'~> 0.0', ">= 0.0.9"
   spec.add_dependency "nrser-extras", '~> 0.0', ">= 0.0.3"
   spec.add_dependency "state_mate", '~> 0.0', ">= 0.0.9"
+  spec.add_dependency 'parseconfig', '~> 1.0', '>= 1.0.8'
   
   
   if QB::VERSION.end_with? '.dev'

data/roles/qb.git_submodule_update/.qb-options.yml

@@ -0,0 +1,3 @@
+---
+qb.qb_role:
+  readme: true

data/roles/qb.git_submodule_update/README.md

@@ -0,0 +1,5 @@
+qb.git_submodule_update
+=======================
+
+init / update submodules, checking out branch if the commit points to the 
+head of exactly one.

data/roles/qb.git_submodule_update/defaults/main.yml

@@ -0,0 +1,3 @@
+---
+# defaults file for qb.git_submodule_update
+git_submodule_update_dir: "{{ qb_dir }}"

data/roles/qb.git_submodule_update/library/git_submodule_update

@@ -0,0 +1,167 @@
+#!/usr/bin/env ruby
+
+#!/usr/bin/env ruby
+# WANT_JSON
+
+# init bundler in dev env
+if ENV['QB_DEV_ENV']
+  ENV.each {|k, v|
+    if k.start_with? 'QB_DEV_ENV_'
+      ENV[k.sub('QB_DEV_ENV_', '')] = v
+    end
+  }
+  require 'bundler/setup'
+end
+
+require 'qb'
+require 'cmds'
+require 'nrser'
+
+class GitSubmoduleUpdate < QB::AnsibleModule
+  def main_dir
+    File.realpath @args['dir']
+  end
+  
+  def resolve *path
+    QB::Util.resolve main_dir, *path
+  end
+  
+  def submodules
+    out = Dir.chdir main_dir do
+      Cmds.out! "git submodule"
+    end
+    
+    out.lines.map {|line|
+      match = line.match /([0-9a-f]{40})\s(\S+)\s/
+      commit = match[1]
+      rel_dir = match[2]
+      dir = resolve rel_dir
+      
+      {
+        commit: commit,
+        dir: dir,
+        rel_dir: rel_dir,
+        detached: detached?(dir),
+        dirty: dirty?(dir),
+      }
+    }
+  end
+  
+  def dirty? repo_dir
+    Dir.chdir repo_dir do
+      !Cmds.out!("git status --porcelain").empty?
+    end
+  end
+  
+  def detached? repo_dir
+    Dir.chdir repo_dir do
+      out = Cmds.out! "git branch"
+      
+      !!(out.lines[0].match /\*\ \(HEAD\ detached\ at [0-9a-f]{7}\)/)
+    end
+  end
+  
+  def branch_heads repo_dir
+    Dir.chdir repo_dir do
+      Cmds.out!("git show-ref").lines.map {|line|
+        m = line.match(/([0-9a-f]{40})\s+(\S+)\s/)
+        commit = m[1]
+        ref = m[2]
+        
+        {
+          commit: commit,
+          ref: ref,
+        }
+      }
+    end
+  end
+  
+  def branch_heads_for_commit submodule
+    branch_heads(submodule[:dir]).select {|branch_head|
+      branch_head[:commit] == submodule[:commit]
+    }.reject {|branch_head| branch_head[:ref].end_with? 'HEAD'}
+  end
+  
+  def attach! submodule
+    branch_heads = branch_heads_for_commit submodule
+    branch_head = nil
+    
+    case branch_heads.length
+    when 0
+      # commit does not point to any branch heads - which means it's
+      # probably a commit in a branch that's behind the head
+      # 
+      # we could figure out which branch it's in but we don't want to
+      # automatically update it because that might break shit.
+      # 
+      # do nothing
+      return false
+    when 1
+      # commit is head of only one branch
+      branch_head = branch_heads[0]
+    else
+      # commit is head of multiple branches
+      local = branch_heads.select {|bh| bh[:ref].start_with? 'refs/heads'}
+      
+      case local.length
+      when 0
+        # commit is head of multiple remote branches
+        # see if one is master
+        branch_head = branch_heads.find {|bh| bh[:ref].end_with? 'master'}
+        
+        # if none do we're hosed - not sure which one it should be on
+        if branch_head.nil?
+          raise NRSER.squish <<-END
+            submodule #{ submodule[:rel_dir] } points to commit
+            #{ submodule[:commit] } that heads multiple non-master remote
+            branches: #{ branch_heads.map {|bh| bh[:ref]} }
+          END
+        end
+        
+      when 1
+        # the commit is head of one local branch, use it
+        branch_head = local[0]
+      
+      else
+        # the commit heads multiple local branches
+        # again, see if one is master
+        branch_head = local.find {|b| b[:ref].end_with? 'master'}
+        
+        # if none do we're hosed - not sure which one it should be on
+        if branch_head.nil?
+          raise NRSER.squish <<-END
+            submodule #{ submodule[:rel_dir] } points to commit
+            #{ submodule[:commit] } that heads multiple non-master local
+            branches: #{ local.map {|bh| bh[:ref]} }
+          END
+        end
+      end # case
+    end
+    
+    branch = branch_head[:ref].split('/')[-1]
+    
+    Dir.chdir submodule[:dir] do
+      # checkout the branch
+      Cmds! "git checkout <%= branch %>", branch: branch
+      
+      # do a pull if the head was on the remote
+      if branch_head[:ref].start_with? 'refs/remotes'
+        Cmds! "git pull origin <%= branch %>", branch: branch
+      end
+    end
+    
+    @changed = true
+  end
+  
+  def main
+    submodules.select {|sub|
+      sub[:detached]
+    }.each {|sub|
+      attach! sub
+    }
+    
+    nil
+  end
+end
+
+GitSubmoduleUpdate.new.run

data/roles/qb.git_submodule_update/meta/main.yml

@@ -0,0 +1,8 @@
+---
+# meta file for qb.git_submodule_update
+
+allow_duplicates: yes
+
+dependencies: []
+# - role: role-name
+

data/roles/qb.git_submodule_update/meta/qb.yml

@@ -0,0 +1,44 @@
+---
+# meta/qb.yml file for qb.git_submodule_update
+# 
+# qb settings for this role. see README.md for more info.
+#
+
+# description of the role to show in it's help output.
+description: null
+
+# prefix for role variables
+var_prefix: null
+
+# how to get a default for `dir` if it's not provided as the only
+# positional argument. if a positional argument is provided it will
+# override the method defined here.
+# 
+# options:
+# 
+# -   null
+#     -   require the value on the command line.
+# -   git_root
+#     -   use the git root fof the directory that the `qb` command is invoked
+#         from. useful for 'project-centric' commands so they can be invoked
+#         from anywhere in the repo.
+# -   cwd
+#     -   use the directory the `qb` command is invoked form.
+# -   {exe: PATH}
+#     -   invoke an execuable, passing a JSON serialization of the options 
+#         mapping their CLI names to values. path can be relative to role
+#         directory.
+default_dir: git_root
+
+# default user to become for play
+default_user: null
+
+# set to false to not save options in .qb-options.yml files
+save_options: false
+
+options: []
+# - name: example
+#   description: an example of a variable.
+#   required: false
+#   type: boolean # boolean (default) | string
+#   short: e

data/roles/qb.git_submodule_update/tasks/main.yml

@@ -0,0 +1,11 @@
+---
+# tasks file for qb.git_submodule_update
+
+- name: update submodules
+  command: git submodule update --init
+  args:
+    chdir: "{{ git_submodule_update_dir }}"
+
+- name: checkout branch for any commits that are exactly one head
+  git_submodule_update:
+    dir: "{{ git_submodule_update_dir }}"

data/roles/qb.role/defaults/main.yml

@@ -9,6 +9,7 @@ role_meta: true
 role_tasks: true
 role_templates: false
 role_vars: false
+role_readme: false
 
 # galaxy
 role_galaxy: false

data/roles/qb.role/meta/qb.yml

@@ -62,6 +62,11 @@ vars:
   description: include galaxy info in meta/main.yml
   short: g
 
+- name: readme
+  type: boolean
+  description: include README.md
+  short: r
+
 - name: project
   type: boolean
   description: create a project repo for this role

data/roles/qb.role/tasks/main.yml

@@ -115,3 +115,14 @@
     dest: "{{ dir }}/vars/main.yml"
     force: "{{ role_force }}"
   when: role_vars
+
+# readme
+# ======
+
+- name: create README.md
+  template:
+    src: README.md.j2
+    dest: "{{ dir }}/README.md"
+    force: "{{ role_force }}"
+  when: role_readme
+  

data/roles/qb.role/templates/README.md.j2

@@ -0,0 +1,4 @@
+{{ role_role_name }}
+{{ '=' * (role_role_name | length) }}
+
+{{ role_role_name }} role.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: qb
 version: !ruby/object:Gem::Version
-  version: 0.1.36
+  version: 0.1.37
 platform: ruby
 authors:
 - nrser
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-12-01 00:00:00.000000000 Z
+date: 2016-12-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -112,6 +112,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.0.9
+- !ruby/object:Gem::Dependency
+  name: parseconfig
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.8
 description: 
 email:
 - neil@ztkae.com
@@ -133,23 +153,37 @@ files:
 - bin/console
 - bin/print-error
 - bin/qb
+- bin/rake
 - bin/setup
 - bin/ungem
 - dev/ansible.cfg
 - dev/hosts
 - dev/requirements.yml
+- dev/scratch/ansible_module/defaults/main.yml
+- dev/scratch/ansible_module/library/test
+- dev/scratch/ansible_module/meta/main.yml
+- dev/scratch/ansible_module/meta/qb.yml
+- dev/scratch/ansible_module/tasks/main.yml
 - dev/scratch/case.rb
 - dev/scratch/empty/defaults/main.yml
 - dev/scratch/empty/meta/main.yml
 - dev/scratch/empty/meta/qb.yml
 - dev/scratch/empty/tasks/main.yml
 - dev/scratch/stateSpec.js
+- dev/scratch/stdio/defaults/main.yml
+- dev/scratch/stdio/library/test
+- dev/scratch/stdio/meta/main.yml
+- dev/scratch/stdio/meta/qb.yml
+- dev/scratch/stdio/tasks/main.yml
 - dev/setup.yml
 - exe/qb
 - lib/qb.rb
+- lib/qb/ansible_module.rb
 - lib/qb/options.rb
 - lib/qb/options/option.rb
 - lib/qb/role.rb
+- lib/qb/util.rb
+- lib/qb/util/stdio.rb
 - lib/qb/version.rb
 - library/git_mkdir.py
 - library/qb_facts.py
@@ -283,6 +317,13 @@ files:
 - roles/qb.git_repo/meta/main.yml
 - roles/qb.git_repo/meta/qb.yml
 - roles/qb.git_repo/tasks/main.yml
+- roles/qb.git_submodule_update/.qb-options.yml
+- roles/qb.git_submodule_update/README.md
+- roles/qb.git_submodule_update/defaults/main.yml
+- roles/qb.git_submodule_update/library/git_submodule_update
+- roles/qb.git_submodule_update/meta/main.yml
+- roles/qb.git_submodule_update/meta/qb.yml
+- roles/qb.git_submodule_update/tasks/main.yml
 - roles/qb.gitignore/defaults/main.yml
 - roles/qb.gitignore/files/gitignore/.github/PULL_REQUEST_TEMPLATE.md
 - roles/qb.gitignore/files/gitignore/Actionscript.gitignore
@@ -523,6 +564,7 @@ files:
 - roles/qb.role/meta/qb.yml
 - roles/qb.role/tasks/main.yml
 - roles/qb.role/templates/.gitkeep
+- roles/qb.role/templates/README.md.j2
 - roles/qb.role/templates/defaults/main.yml.j2
 - roles/qb.role/templates/handlers/main.yml.j2
 - roles/qb.role/templates/meta/main.yml.j2