qb 0.1.60 → 0.1.61

data/plugins/lookup_plugins/every.py

@@ -0,0 +1,165 @@
+"""
+DOCUMENTATION:
+    lookup: every
+    version_added: "QB-0.1.61"
+    short_description: Returns true for a key every X time delta (per host).
+    description:
+        -   Returns `True` if more than a specified amount of time has passed
+            since it last returned `True` for that key for the current
+            `inventory_hostname` fact.
+            
+            If it's never returned `True` for the `key` / `inventory_hostname`
+            combo it will.
+            
+            This is useful to control updating - things like "run 
+            `apt-get update` if it doesn't look like it's been run in a day",
+            etcetera.
+            
+            ** WARNING: NOT AT ALL THREAD / CONCURRENCY SAFE **
+            
+            This is meant for things that you're *rather not* have run too
+            often, it is not indented for and should not be used for
+            controlling stuff that *must not* be run more than a certain
+            frequency because it's a shit-simple implementation with 
+            **NO LOCKING / CONCURRENCY SUPPORT** so if another thread or
+            process is trying to do the same thing at the same time they will
+            potentially both return `True` or who really knows what else.
+            
+            Data is stored at `~/.ansible/qb/data/every.yml`. This should 
+            probably be configurable for for the moment it will do.
+            
+    options:
+        key:
+            description:
+                -   Required single positional argument, used as the key to
+                    store / retrieve data.
+            required: True
+        **kwargs:
+            description:
+                -   Accepts all the Python `datetime.timedelta` constructor
+                    keywords. Requires at least one.
+                     
+                    You can set the delta to zero (so it returns True every
+                    call) by providing `days=0` or similar (useful to test
+                    stuff out maybe).
+            required: True
+EXAMPLES:
+
+    -   name: Install Yarn via Homebrew, updating Homebrew at most once per day
+        homebrew:
+            name: yarn
+            update_homebrew: "{{ lookup('every', 'update_homebrew' days=1) }}"
+
+RETURN:
+
+    `True` if it's been more than the provided period since the lookup returned
+    `True` last for this key / 
+    
+"""
+
+from __future__ import (absolute_import, division, print_function)
+__metaclass__ = type
+
+from ansible.errors import AnsibleError
+from ansible.plugins.lookup import LookupBase
+
+try:
+    from __main__ import display
+except ImportError:
+    from ansible.utils.display import Display
+    display = Display()
+
+from datetime import datetime, timedelta
+import os
+import errno
+import yaml
+
+def mkdir_p(path):
+    """
+    Can't believe Python doesn't have this built-in...
+    """
+    try:
+        os.makedirs(path)
+    except OSError as exc:
+        if exc.errno == errno.EEXIST and os.path.isdir(path):
+            pass
+        else:
+            raise
+
+
+class LookupModule(LookupBase):
+    def run(self, terms, variables=None, **kwargs):
+        # Check args
+        
+        if len(terms) != 1:
+            raise AnsibleError(
+                "Requires exacty one positional argument (key)."
+            )
+        
+        if len(kwargs) == 0:
+            raise AnsibleError(
+                "Requires at least one Python timedelta keyword arg."
+            )
+        
+        # Setup variables
+        
+        key = terms[0]
+        host = variables['inventory_hostname']
+        
+        data_path = os.path.join(
+            variables['ansible_env']['HOME'],
+            '.ansible',
+            'qb',
+            'data',
+            'every.yml'
+        )
+        
+        delta = timedelta(**kwargs)
+        now = datetime.now()
+        
+        # Default to empty data
+        data = {}
+        
+        # No idea how / where to see this output...
+        # display.debug("Seeing if %s has been done in last %s" % (key, delta))
+        
+        # Ensure the data directory exists
+        mkdir_p(os.path.dirname(data_path))
+        
+        # Read the data file, overwriting `data` var (if file it exists)
+        try:
+            with open(data_path, 'r') as f:
+                data = yaml.safe_load(f)
+        except IOError as error:
+            pass 
+        
+        # If there's no entry for this host default to empty dict
+        if host not in data:
+            data[host] = {}
+        
+        # Default `should` (our return value) to True: if it's never returned
+        # `True` it will now.
+        should = True
+        
+        # If we have `data[host][key]['last']`, see if's been at least `delta`
+        # and set `should`
+        if key in data[host]:
+            if 'last' in data[host][key]:
+                should = (now - delta) >= data[host][key]['last']
+        else:
+            # Create a new dict at `data[host][key]` so we can write `now` to 
+            # it
+            data[host][key] = {}
+        
+        # If we're gonna return `True`, set `last` to `now` and write back 
+        # to the path.
+        # 
+        # WARNING Not at all thread / concurrency safe!
+        if should:
+            data[host][key]['last'] = now
+            
+            with open(data_path, 'w') as f:
+                yaml.safe_dump(data, f, default_flow_style=False)
+        
+        # And return our result
+        return should

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

@@ -0,0 +1,3 @@
+---
+# defaults file for qb.facts
+facts_github_api: false

data/roles/{qb.yarn → qb.facts}/meta/main.yml

@@ -1,5 +1,5 @@
 ---
-# meta file for qb.yarn
+# meta file for qb.facts
 
 allow_duplicates: yes
 

data/roles/{qb.yarn → qb.facts}/meta/qb.yml

@@ -1,11 +1,11 @@
 ---
-# meta/qb.yml file for qb.yarn
+# meta/qb.yml file for qb.facts
 # 
 # qb settings for this role. see README.md for more info.
 #
 
 # description of the role to show in it's help output.
-description: ensure yarn is installed and packages are present.
+description: null
 
 # prefix for role variables
 var_prefix: null
@@ -34,39 +34,34 @@ var_prefix: null
 #     -   starting at the current direcotry and climbing up to parent 
 #         directories, use the first one that contains FILENAME. error
 #         if none is found.
-default_dir: null
+default_dir: cwd
+
+# 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.
+# 
+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: true
+save_options: false
 
-# ask for an ansible vault password
-ask_vault_pass: false
+# options to pass to ansible-playbook
+ansible_options: {}
 
-options: # []
+options:
 # - name: example
 #   description: an example of a variable.
 #   required: false
 #   type: boolean # boolean (default) | string
 #   short: e
-- name: version
-  description: version to install.
-  type: string
-  short: v
-
-- name: state
-  description: >
-    present to install, absent to uninstall. the rest of the options are up to
-    you to much around with if you like.
-  see:
-  - http://docs.ansible.com/ansible/homebrew_module.html
-  type:
-    one_of:
-    - present
-    - absent
-    - latest
-    - head
-    - linked
-    - unlinked
+- name: github_api
+  description: >-
+    If path is a git repo with a GitHub origin, contact the GitHub API for
+    additonal facts (including privacy status).
+  type: boolean
+  short: g

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

@@ -0,0 +1,10 @@
+---
+# tasks file for qb.facts
+
+- path_facts:
+    path: "{{ qb_dir }}"
+    github_api: "{{ facts_github_api }}"
+  register: qb_dir_facts
+
+- debug:
+    var: qb_dir_facts

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

@@ -1,3 +1,4 @@
 ---
 # defaults file for qb.git_repo
 git_repo_dest: "{{ qb_dir }}"
+git_repo_gitignore: []

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

@@ -1,12 +1,4 @@
 ---
 # meta file for qb.git_repo
 
-dependencies:
-- role: qb.gitignore
-  gitignore_name: Global/macOS
-  gitignore_dest: "{{ git_repo_dest }}"
-  when: ansible_distribution == "MacOSX"
-  
-- role: qb.gitignore
-  gitignore_name: QB
-  gitignore_dest: "{{ git_repo_dest }}"
+dependencies: []

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

@@ -6,4 +6,29 @@
   args:
     chdir: "{{ git_repo_dest }}"
     creates: "{{ git_repo_dest }}/.git"
-  
+
+- name: Tell Git to ignore OSX artifacts 
+  when: ansible_distribution == "MacOSX"
+  include_role:
+    name: qb.gitignore
+  vars:
+    gitignore_name: Global/macOS
+    gitignore_dest: "{{ git_repo_dest }}"
+
+- name: Tell Git to ignore QB artifacts
+  include_role:
+    name: qb.gitignore
+  vars:
+    gitignore_name: QB
+    gitignore_dest: "{{ git_repo_dest }}"
+
+- name: >-
+    Tell Git to ignore each of <git_repo_gitignores>
+  with_items: "{{ git_repo_gitignores }}"
+  loop_control:
+    loop_var: name
+  include_role:
+    name: qb.gitignore
+  vars:
+    gitignore_name: "{{ name }}"
+    gitignore_dest: "{{ git_repo_dest }}"

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

@@ -36,6 +36,14 @@ var_prefix: null
 #         if none is found.
 default_dir: null
 
+# 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.
+# 
+mkdir: false
+
 # default user to become for play
 default_user: null
 

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

@@ -14,7 +14,7 @@ role_readme: false
 role_library: false
 
 # modules
-qb_role_modules: []
+role_modules: []
 
 # galaxy
 role_galaxy: false

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

@@ -145,7 +145,7 @@
 # modules
 # =======
   
-- include: module.yml
+- include: module.yml 
   with_items: "{{ role_modules }}"
   loop_control:
     loop_var: role_module

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

@@ -0,0 +1,4 @@
+---
+# defaults file for qb.yarn_release
+yarn_release_level: patch
+yarn_release_package_dir: "{{ qb_dir }}"

data/roles/{qb.release_yarn → qb.yarn_release}/meta/main.yml

@@ -1,5 +1,5 @@
 ---
-# meta file for qb.release_yarn
+# meta file for qb.yarn_release
 
 allow_duplicates: yes
 

data/roles/{qb.release_yarn → qb.yarn_release}/meta/qb.yml

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

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

@@ -0,0 +1,73 @@
+---
+# tasks file for qb.yarn_release
+
+- name: load package.json
+  include_vars:
+    file: "{{ yarn_release_package_dir }}/package.json"
+    name: yarn_release_package_json
+
+- name: get current version
+  set_fact:
+    yarn_release_current_version: "{{ yarn_release_package_json.version }}"
+
+- name: create release version
+  set_fact:
+    yarn_release_release_version: >-
+      {{ yarn_release_current_version | semver_inc(yarn_release_level) }}
+
+- name: >
+    increment to version {{ yarn_release_release_version }}
+    and create the git tag
+  command: "yarn version --new-version={{ yarn_release_release_version }}"
+  args:
+    chdir: "{{ yarn_release_package_dir }}"
+
+- name: >
+    git push the v{{ yarn_release_release_version }} tag
+  command: "git push origin v{{ yarn_release_release_version }}"
+  args:
+    chdir: "{{ yarn_release_package_dir }}"
+
+- name: >
+    npm publish v{{ yarn_release_release_version }}
+  command: npm publish
+  args:
+    chdir: "{{ yarn_release_package_dir }}"
+
+- name: create the next -dev version
+  set_fact:
+    yarn_release_next_version: "{{
+      yarn_release_release_version | semver_inc(
+        level='prerelease',
+        preid='dev'
+      )
+    }}"
+
+- name: >
+    increment to {{ yarn_release_next_version }} version
+  command: >
+    yarn version
+      --new-version={{ yarn_release_next_version }}
+      --no-git-tag-version
+  args:
+    chdir: "{{ yarn_release_package_dir }}"
+
+- name: git add package.json
+  command: git add package.json
+  args:
+    chdir: "{{ yarn_release_package_dir }}"
+
+- name: >
+    git commit next dev version
+  command: git commit -m "start {{ yarn_release_next_version }}"
+  args:
+    chdir: "{{ yarn_release_package_dir }}"
+
+- name: git push next dev version
+  command: git push
+  args:
+    chdir: "{{ yarn_release_package_dir }}"
+
+- debug:
+    msg: >
+      v{{ yarn_release_release_version }} released.

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

@@ -0,0 +1,11 @@
+---
+# defaults file for qb.yarn_setup
+yarn_setup_version: null
+yarn_setup_state: present
+yarn_setup_global_packages: []
+
+yarn_setup_force: false
+
+yarn_setup_brew_create: true
+yarn_setup_brew_tap: "{{ qb_git_user_name }}/versions"
+yarn_setup_brew_link: true