qb 0.3.13 → 0.3.14

data/roles/nrser.rbenv_gem/tasks/main.yml

@@ -36,11 +36,11 @@
 #     msg: "{{ rbenv_gem_rubies_list }}"
 
 # this will clone the repo, build the .gem and point rbenv_gem_source to it
-- include: clone-repo.yml
+- include_tasks: clone-repo.yml
   when: rbenv_gem_repo is defined
 
-- include: manage-source.yml
+- include_tasks: manage-source.yml
   when: rbenv_gem_source is defined
 
-- include: manage-version.yml
+- include_tasks: manage-version.yml
   when: rbenv_gem_source is not defined

data/roles/qb/gem/build/defaults/main.yml

@@ -0,0 +1,12 @@
+---
+##############################################################################
+# Variable defaults for `qb/gem/build` role
+##############################################################################
+
+# Default the gem root to the DIRECTORY from QB
+gem_root: >-
+  {{ qb_dir }}
+
+# Where to move the built gem to
+gem_build_dest: >-
+  {{ gem_root }}/pkg

data/roles/qb/gem/build/meta/qb.yml

@@ -0,0 +1,42 @@
+---
+##############################################################################
+# QB metadata for `qb/gem/build` role
+# 
+# qb settings for this role. see README.md for more info.
+#
+##############################################################################
+
+# description of the role to show in it's help output.
+description: Build an installable `.gem` file from a source directory.
+
+# Gemspec-style requirements. Right now only `gems:qb` is used, but plan to
+# generalize in the future.
+requirements:
+  gems:
+    qb: ~> 0.3.0
+
+# prefix for role variables
+var_prefix: gem_build
+
+# Closest gemspec climbing down tree from working dir
+default_dir:
+  find_up: '*.gemspec'
+
+# Have QB ensure DIRECTORY exists before starting the play.
+mkdir: false
+
+# 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 to pass to ansible-playbook
+ansible_options: {}
+
+options:
+- name: dest
+  description: Destination directory for the `.gem` file
+  required: false
+  type: path
+  short: d

data/roles/qb/gem/build/tasks/main.yml

@@ -0,0 +1,61 @@
+---
+##############################################################################
+# Main tasks for `qb/gem/build` role
+##############################################################################
+
+- when: get_root_facts is not defined
+  name: >-
+    Get the QB path facts for `gem_root={{ gem_root }}`
+  path_facts:
+    path: >-
+      {{ gem_root }}
+  register: gem_root_facts
+
+
+- name: >-
+    Set `gem_build_filename` to the (presumed) filename of the new `.gem`
+  set_fact:
+    gem_build_filename: >-
+      {{ gem_root_facts.gem.name }}-{{ gem_root_facts.gem.version.raw }}.gem
+
+
+- name: >
+    Set `gem_build_path` to the absolute path we want
+    `{{ gem_build_filename }}` to end up at
+  set_fact:
+    gem_build_path: >-
+      {{ gem_build_dest | path_resolve( gem_build_filename ) }}
+
+
+- when: not gem_root_facts.gem.version.is_dev
+  block:
+  - name: >-
+      Stat destination path `{{ gem_build_path }}`
+    stat:
+      path: >-
+        {{ gem_build_path }}
+    register: gem_build_path_stat
+  
+  - when: gem_build_path_stat.stat.exists
+    fail:
+      msg: >-
+        Gem build destination `{{ gem_build_path }}` exists
+        (and gem at `{{ gem_root }}` is not at a `dev` version)
+  
+
+- name: >-
+    Build gem from {{ gem_root_facts.gem.gemspec_path }}
+  stream:
+    cmd: gem build {{ gem_root_facts.gem.gemspec_path | basename | quote }}
+    chdir: >-
+      {{ gem_root }}
+
+
+- when: gem_root != gem_build_dest
+  name: >-
+    Move new `{{ gem_build_filename }}` file to `{{ gem_build_path }}`
+  command: >-
+    mv {{ gem_build_filename | quote }} {{ gem_build_path | quote }}
+  args:
+    chdir: >-
+      {{ gem_root }}

data/roles/{qb.install_gem → qb/gem/install}/defaults/main.yml

@@ -1,3 +1,3 @@
 ---
 # defaults file for qb.install_gem
-install_gem_rubies: current
+gem_install_rubies: current

data/roles/qb/gem/install/meta/main.yml

@@ -0,0 +1,17 @@
+---
+# meta file for qb.install_gem
+allow_duplicates: yes
+
+dependencies:
+- role: qb/gem/build
+
+- role: nrser.rbenv_gem
+  rbenv_gem_rubies: >-
+    {{ gem_install_rubies }}
+  rbenv_gem_name: >-
+    {{ gem_root_facts.gem.name }}
+  # Ugh... this is named "source" because that's what it's called in Ansible's
+  # `gem` module, but it's *not* the source directory, it's the `.gem` file
+  rbenv_gem_source: >-
+    {{ gem_build_path }}
+  rbenv_gem_state: present

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

@@ -1,5 +1,8 @@
 ---
-default_dir: cwd
+default_dir:
+  find_up: '*.gemspec'
+  parent_dir:
+    $where:
 
 save_options: false
   
@@ -7,4 +10,4 @@ vars:
 - name: rubies
   description: rubies to install for
   required: false
-  type: string
+  type: string

data/roles/qb/git/ignore/files/gitignore/Eagle.gitignore

@@ -4,6 +4,9 @@
 *.s#?
 *.b#?
 *.l#?
+*.b$?
+*.s$?
+*.l$?
 
 # Eagle project file
 # It contains a serial number and references to the file structure
@@ -31,14 +34,19 @@ eagle.epf
 *.drl
 *.gpi
 *.pls
+*.ger
+*.gpi
+*.xln
 
 *.drd
 *.drd.*
 
+*.s#*
+*.b#*
+
 *.info
 
 *.eps
 
 # file locks introduced since 7.x
 *.lck
-

data/roles/qb/git/ignore/files/gitignore/Global/Eclipse.gitignore

@@ -23,6 +23,9 @@ local.properties
 # CDT-specific (C/C++ Development Tooling)
 .cproject
 
+# CDT- autotools 
+.autotools
+
 # Java annotation processor (APT)
 .factorypath
 

data/roles/qb/git/ignore/files/gitignore/Go.gitignore

@@ -1,5 +1,6 @@
 # Binaries for programs and plugins
 *.exe
+*.exe~
 *.dll
 *.so
 *.dylib

data/roles/qb/git/ignore/files/gitignore/Node.gitignore

@@ -57,3 +57,5 @@ typings/
 # dotenv environment variables file
 .env
 
+# next.js build output
+.next

data/roles/qb/git/ignore/files/gitignore/Python.gitignore

@@ -1,3 +1,10 @@
+# General Git ignore file for Python
+# 
+# Packaging and distribution patterns have been moved out to
+# 
+#     //Python/Packaging.gitignore
+# 
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
@@ -6,25 +13,6 @@ __pycache__/
 # C extensions
 *.so
 
-# Distribution / packaging
-.Python
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-MANIFEST
-
 # PyInstaller
 #  Usually these files are written by a python script from a template
 #  before PyInstaller builds the exe, so as to inject date/other infos into it.

data/roles/qb/git/ignore/files/gitignore/Python/Packaging.gitignore

@@ -0,0 +1,25 @@
+# Patterns that are only applicable if you are packaging and distributing
+# your Python source.
+# 
+# Moved here from `//Python.gitignore` because they include several common
+# directory names *that are ignored anywhere in the directory tree* and you
+# probably don't want or need those sweeping effects for the common case of 
+# ignoring `*.pyc` and the like.
+# 
+
+.Python
+# env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg

data/roles/qb/git/ignore/files/gitignore/Ruby.gitignore

@@ -1,3 +1,17 @@
+# General Git ignore file for Ruby, including support for:
+# 
+# -   Bundler
+# -   RDoc and Yard
+# -   RBEnv and RVM
+# -   DotEnv (optional)
+# 
+# Additional support is available in separate ignore files:
+# 
+# -   Gem.gitignore (for gem source directories)
+# -   Rails.gitignore
+# -   RubyMotion.gitignore
+# 
+
 /*.gem
 *.rbc
 /.config
@@ -24,11 +38,7 @@
 /vendor/bundle
 /lib/bundler/man/
 
-# for a library or gem, you might want to ignore these files since the code is
-# intended to run in multiple environments; otherwise, check them in:
-# Gemfile.lock
-# .ruby-version
-# .ruby-gemset
+# for a library or gem, add `Gem.gitignore`
 
 # unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
 .rvmrc

data/roles/qb/git/ignore/files/gitignore/Umbraco.gitignore

@@ -16,8 +16,8 @@
 
 # Don't ignore Umbraco packages (VisualStudio.gitignore mistakes this for a NuGet packages folder)
 # Make sure to include details from VisualStudio.gitignore BEFORE this
-!**/App_Data/[Pp]ackages/
-!**/[Uu]mbraco/[Dd]eveloper/[Pp]ackages
+!**/App_Data/[Pp]ackages/*
+!**/[Uu]mbraco/[Dd]eveloper/[Pp]ackages/*
 
 # ImageProcessor DiskCache 
 **/App_Data/cache/

data/roles/qb/git/ignore/files/gitignore/VisualStudio.gitignore

@@ -219,6 +219,10 @@ ClientBin/
 *.publishsettings
 orleans.codegen.cs
 
+# Including strong name files can present a security risk 
+# (https://github.com/github/gitignore/pull/2483#issue-259490424)
+#*.snk
+
 # Since there are multiple workflows, uncomment next line to ignore bower_components
 # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
 #bower_components/

data/roles/qb/role/qb/templates/qb.yml.j2

@@ -1,64 +1,44 @@
 ---
-# meta/qb.yml file for {{ role_role_name }}
+##############################################################################
+# QB metadata for `{{ role_role_name }}` role.
 # 
-# qb settings for this role. see README.md for more info.
+# QB settings for this role.
+# 
+# @see http://www.rubydoc.info/gems/qb/file/doc/qb_roles/metadata.md
 #
+##############################################################################
 
-# description of the role to show in it's help output.
-description: null
+# Shown in help output, etc.
+description: >-
+  TODO describe {{ role_role_name }} role
 
-# Gemspec-style requirements. Right now only `gems:qb` is used, but plan to
-# generalize in the future.
+# Gemspec-style requirements. Right now only `.gems.qb` is used.
 requirements:
   gems:
     qb: ~> 0.3.0
 
-# prefix for role variables
+# Prefix for role variables
 var_prefix: {{ role_namespaceless }}
 
-# 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.
+# How to get a default for `DIRECTORY` arg if not provided by user.
 # 
-# options:
+# @see http://www.rubydoc.info/gems/qb/file/doc/qb_roles/metadata/default_dir.md
 # 
-# -   null
-#     -   require the value on the command line.
-# -   false
-#     -   don't provide qb_dir (means doesn't load or save options either).
-# -   git_root
-#     -   use the git root of 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 executable, passing a JSON serialization of the options 
-#         mapping their CLI names to values. path can be relative to role
-#         directory.
-# -   {find_up: FILENAME}
-#     -   starting at the current directory and climbing up to parent 
-#         directories, use the first one that contains FILENAME. error
-#         if none is found.
-default_dir: null
+default_dir: null # means use *must* provide `DIRECTORY` arg
 
-# If `true`, QB will ensure the default dir exists before starting the play.
-# 
-# For legacy reasons, this defaults to `true` if not present, but we want to 
-# default declare it as `false` here so new roles can turn it on only if 
-# they need it.
-# 
+# If `true`, QB will ensure `DIRECTORY` exists before starting the play.
 mkdir: false
 
-# default user to become for play
+# Default user to become for play
 default_user: null
 
-# set to false to not save options in .qb-options.yml files
+# Save options in `.qb-options.yml` files
 save_options: true
 
-# options to pass to ansible-playbook
+# Options to pass to `ansible-playbook`
 ansible_options: {}
 
+# Role CLI options that become Ansible vars
 options: []
 # - name: example
 #   description: an example of a variable.

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

@@ -4,7 +4,7 @@
 {{ role_role_name }} role.
 
 {{ '-' * 78 }}
-usage
+Usage
 {{ '-' * 78 }}
 
 CLI help: