qb 0.3.15 → 0.3.16

data/roles/qb/{gem → ruby/gem}/bin_stubs/defaults/main.yml

@@ -1,5 +1,5 @@
 ---
-# defaults file for qb/gem/bin_stubs
+# defaults file for qb/ruby/gem/bin_stubs
 
 gem_root: >-
   {{ qb_dir }}

data/roles/qb/{gem → ruby/gem}/bin_stubs/meta/main.yml

@@ -1,5 +1,5 @@
 ---
-# meta file for qb/gem/bin_stubs
+# meta file for qb/ruby/gem/bin_stubs
 
 allow_duplicates: yes
 

data/roles/qb/{gem → ruby/gem}/bin_stubs/meta/qb.yml

@@ -1,5 +1,5 @@
 ---
-# meta/qb.yml file for qb/gem/bin_stubs
+# meta/qb.yml file for qb/ruby/gem/bin_stubs
 # 
 # qb settings for this role. see README.md for more info.
 #

data/roles/qb/{gem → ruby/gem}/bin_stubs/tasks/main.yml

@@ -1,5 +1,5 @@
 ---
-# tasks file for qb/gem/bin_stubs
+# tasks file for qb/ruby/gem/bin_stubs
 
 # Figure out where they gonna go...
 

data/roles/qb/ruby/gem/bin_stubs/templates/console

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+
+# Load `nrser` gem and use refinements if it's available
+begin
+  require 'nrser'
+rescue LoadError => error
+  puts "WARN -- Failed to load `nrser` gem."
+  puts "WARN -- Add it do your dependencies or edit #{ __FILE__ }"
+else
+  using NRSER
+  using NRSER::Types
+end
+
+require '{{ qb_gem_info.name }}'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# Load `pry` if it's available, falling back to `irb`
+begin
+  require "pry"
+rescue LoadError => error
+  puts "WARN -- Failed to load `pry` gem."
+  puts "WARN -- Add it do your dependencies or edit #{ __FILE__ }"
+  puts "INFO -- Starting `IRB`..."
+  
+  require "irb"
+  IRB.start
+else
+  Pry.start
+end

data/roles/qb/{gem → ruby/gem}/build/defaults/main.yml

@@ -1,6 +1,6 @@
 ---
 ##############################################################################
-# Variable defaults for `qb/gem/build` role
+# Variable defaults for `qb/ruby/gem/build` role
 ##############################################################################
 
 # Default the gem root to the DIRECTORY from QB

data/roles/qb/{gem → ruby/gem}/build/meta/qb.yml

@@ -1,6 +1,6 @@
 ---
 ##############################################################################
-# QB metadata for `qb/gem/build` role
+# QB metadata for `qb/ruby/gem/build` role
 # 
 # qb settings for this role. see README.md for more info.
 #

data/roles/qb/{gem → ruby/gem}/build/tasks/main.yml

@@ -1,6 +1,6 @@
 ---
 ##############################################################################
-# Main tasks for `qb/gem/build` role
+# Main tasks for `qb/ruby/gem/build` role
 ##############################################################################
 
 - when: get_root_facts is not defined

data/roles/qb/{gem → ruby/gem}/install/meta/main.yml

@@ -3,7 +3,7 @@
 allow_duplicates: yes
 
 dependencies:
-- role: qb/gem/build
+- role: qb/ruby/gem/build
 
 - role: nrser.rbenv_gem
   rbenv_gem_rubies: >-

data/roles/qb/{gem → ruby/gem}/new/defaults/main.yml

@@ -1,5 +1,5 @@
 ---
-# defaults file for qb/gem/new
+# defaults file for qb/ruby/gem/new
 
 gem_is_project: false
 

data/roles/qb/{gem → ruby/gem}/new/meta/main.yml

@@ -1,5 +1,5 @@
 ---
-# meta file for qb/gem/new
+# meta file for qb/ruby/gem/new
 
 allow_duplicates: yes
 

data/roles/qb/{gem → ruby/gem}/new/meta/qb.yml

@@ -1,5 +1,5 @@
 ---
-# meta/qb.yml file for qb/gem/new
+# meta/qb.yml file for qb/ruby/gem/new
 # 
 # qb settings for this role. see README.md for more info.
 #

data/roles/qb/{gem → ruby/gem}/new/tasks/main.yml

@@ -1,5 +1,5 @@
 ---
-# tasks file for qb/gem/new
+# tasks file for qb/ruby/gem/new
 
 - include: >-
     {{ role_path }}/tasks/bundle_gem.yml

data/roles/qb/ruby/gem/release/defaults/main.yml

@@ -0,0 +1,5 @@
+---
+# defaults file for qb/ruby/gem/release
+
+gem_root: >-
+  {{ qb_dir }}

data/roles/qb/{gem → ruby/gem}/release/meta/main.yml

@@ -1,5 +1,5 @@
 ---
-# meta file for qb/gem/release
+# meta file for qb/ruby/gem/release
 
 allow_duplicates: yes
 

data/roles/qb/ruby/gem/release/meta/qb.yml

@@ -0,0 +1,27 @@
+---
+# meta/qb.yml file for qb/ruby/gem/release
+# 
+# qb settings for this role. see README.md for more info.
+#
+
+description: |
+  Release a gem, handling version change, tagging, committing, pushing, etc.
+  
+  Depends on `rake` and `bundler` gems, using the `release` task that
+  {Bundler::GemHelpers} provides.
+
+# prefix for role variables
+var_prefix: gem_release
+
+# how to get a default for `dir` if it's not provided as the
+default_dir: null
+
+# Set to false to not save options
+save_options: false
+
+options:
+# - name: example
+#   description: an example of a variable.
+#   required: false
+#   type: boolean # boolean (default) | string
+#   short: e

data/roles/qb/{gem → ruby/gem}/release/tasks/main.yml

@@ -1,5 +1,5 @@
 ---
-# tasks file for qb/gem/release
+# tasks file for qb/ruby/gem/release
 
 - name: >-
     Check that the git repo at {{ gem_root }} is clean.
@@ -147,11 +147,9 @@
 
 
 - name: >-
-    Release with Bundler via `bundle exec rake release`.
-  shell: bundle exec rake release
-  args:
-    chdir: >-
-      {{ gem_root }}
+    Do the actual release via Rake and Bundler's gem helper tasks
+  include_tasks: >-
+    {{ role_path }}/tasks/release.yml
 
 
 - name: >-

data/roles/qb/ruby/gem/release/tasks/release.yml

@@ -0,0 +1,42 @@
+##
+# Do the release by invoking `rake release` if there's a `Rakefile`, and
+# otherwise by executing a small script that manually loads up the
+# {Bundler::GemHelper} tasks and execute the `release` task.
+# 
+# NOTE  This will *still* fail if the `rake` gem isn't present at all, but
+#       it's installed by default in all generated gems, so it seems like a
+#       decent bet it will be there.
+# 
+##
+
+- name: >-
+    See if there is a `Rakefile` in `{{ gem_root }}`
+  stat:
+    path: >-
+      {{ gem_root }}/Rakefile
+  register: gem_rakefile_stat_res
+
+
+- when: gem_rakefile_stat_res.stat.exists
+  name: >-
+    Release via `bundle exec rake release` task
+  stream:
+    log: true
+    chdir: >-
+      {{ gem_root }}
+    cmd: bundle exec rake release
+
+
+- when: not gem_rakefile_stat_res.stat.exists
+  name: >-
+    Release by executing a small script that calls the Rake release task
+  stream:
+    chdir: >-
+      {{ gem_root }}
+    stream:
+      log: true
+      cmd: bundle exec ruby -e <%= script %>
+      kwds:
+        script: |
+          Bundler::GemHelper.install_tasks
+          Rake::Task['release'].execute

data/roles/qb/ruby/rspec/setup/defaults/main.yml

@@ -0,0 +1,7 @@
+---
+##############################################################################
+# Variable defaults for `qb/ruby/rspec/setup` role
+#
+# @see http://docs.ansible.com/ansible/latest/playbooks_reuse_roles.html#role-default-variables
+# 
+##############################################################################

data/roles/qb/ruby/rspec/setup/meta/main.yml

@@ -0,0 +1,9 @@
+---
+##############################################################################
+# Ansible metadata for `qb/ruby/rspec/setup` role
+##############################################################################
+
+allow_duplicates: no
+
+dependencies: []
+# - role: role-name

data/roles/qb/ruby/rspec/setup/meta/qb.yml

@@ -0,0 +1,47 @@
+---
+##############################################################################
+# QB metadata for `qb/ruby/rspec/setup` role.
+# 
+# QB settings for this role.
+# 
+# @see http://www.rubydoc.info/gems/qb/file/doc/qb_roles/metadata.md
+#
+##############################################################################
+
+# Shown in help output, etc.
+description: >-
+  TODO describe qb/ruby/rspec/setup role
+
+# Gemspec-style requirements. Right now only `.gems.qb` is used.
+requirements:
+  gems:
+    qb: ~> 0.3.0
+
+# Prefix for role variables
+var_prefix: setup
+
+# How to get a default for `DIRECTORY` arg if not provided by user.
+# 
+# @see http://www.rubydoc.info/gems/qb/file/doc/qb_roles/metadata/default_dir.md
+# 
+default_dir: null # means use *must* provide `DIRECTORY` arg
+
+# If `true`, QB will ensure `DIRECTORY` exists before starting the play.
+mkdir: false
+
+# Default user to become for play
+default_user: null
+
+# Save options in `.qb-options.yml` files
+save_options: true
+
+# Options to pass to `ansible-playbook`
+ansible_options: {}
+
+# Role CLI options that become Ansible vars
+options: []
+# - name: example
+#   description: an example of a variable.
+#   required: false
+#   type: boolean # boolean (default) | string
+#   short: e

data/roles/qb/ruby/rspec/setup/tasks/main.yml

@@ -0,0 +1,4 @@
+---
+##############################################################################
+# Main tasks for `qb/ruby/rspec/setup` role
+##############################################################################

data/roles/qb/ruby/yard/clean/defaults/main.yml

@@ -0,0 +1,7 @@
+---
+##############################################################################
+# Variable defaults for `qb/ruby/yard/clean` role
+#
+# @see http://docs.ansible.com/ansible/latest/playbooks_reuse_roles.html#role-default-variables
+# 
+##############################################################################

data/roles/qb/ruby/yard/clean/meta/main.yml

@@ -0,0 +1,9 @@
+---
+##############################################################################
+# Ansible metadata for `qb/ruby/yard/clean` role
+##############################################################################
+
+allow_duplicates: yes
+
+dependencies:
+- role: qb/ruby/yard/config

data/roles/qb/ruby/yard/clean/meta/qb.yml

@@ -0,0 +1,48 @@
+---
+##############################################################################
+# QB metadata for `qb/ruby/yard/clean` role.
+# 
+# QB settings for this role.
+# 
+# @see http://www.rubydoc.info/gems/qb/file/doc/qb_roles/metadata.md
+#
+##############################################################################
+
+# Shown in help output, etc.
+description: >-
+  TODO describe qb/ruby/yard/clean role
+
+# Gemspec-style requirements. Right now only `.gems.qb` is used.
+requirements:
+  gems:
+    qb: ~> 0.3.0
+
+# Prefix for role variables
+var_prefix: clean
+
+# How to get a default for `DIRECTORY` arg if not provided by user.
+# 
+# @see http://www.rubydoc.info/gems/qb/file/doc/qb_roles/metadata/default_dir.md
+# 
+default_dir:
+  from_role: qb/ruby/yard/config
+
+# If `true`, QB will ensure `DIRECTORY` exists before starting the play.
+mkdir: false
+
+# Default user to become for play
+default_user: null
+
+# Save options in `.qb-options.yml` files
+save_options: true
+
+# Options to pass to `ansible-playbook`
+ansible_options: {}
+
+# Role CLI options that become Ansible vars
+options: []
+# - name: example
+#   description: an example of a variable.
+#   required: false
+#   type: boolean # boolean (default) | string
+#   short: e

data/roles/qb/ruby/yard/clean/tasks/main.yml

@@ -0,0 +1,27 @@
+---
+##############################################################################
+# Main tasks for `qb/ruby/yard/clean` role
+##############################################################################
+
+- name: >-
+    Remove `{{ bundle_root }}/.yardoc`
+  file:
+    path: >-
+      {{ bundle_root }}/.yardoc
+    state: absent
+
+- when: yard_output_abs_dir is not defined
+  yard.get_output_dir:
+    bundle_root: >-
+      {{ bundle_root }}
+
+- name: >-
+    Remove generated documents
+  stream:
+    cmd: git clean -fdX <%= path %>
+    kwds:
+      path: >-
+        {{ yard_output_dir }}
+    chdir: >-
+      {{ bundle_root }}
+    log: true

data/roles/qb/ruby/yard/config/.qb-options.yml

@@ -0,0 +1,4 @@
+---
+qb/role/qb:
+  modules:
+  - yard.get_output_dir

data/roles/qb/ruby/yard/config/defaults/main.yml

@@ -0,0 +1,15 @@
+---
+##############################################################################
+# Variable defaults for `qb/ruby/yard/config` role
+#
+# @see http://docs.ansible.com/ansible/latest/playbooks_reuse_roles.html#role-default-variables
+# 
+##############################################################################
+
+bundle_root: >-
+  {{ qb_dir }}
+
+yard_opts_file_rel_path: .yardopts
+
+yard_opts_file_path: >-
+  {{ bundle_root | path_join( yard_opts_file_rel_path ) }}