initial commit

.github/workflows/tests.yaml

@@ -0,0 +1,18 @@
+name: Run tests
+
+on:
+  - push
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: checkout
+        uses: actions/checkout@v2
+        with:
+          path: "${{ github.repository }}"
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip setuptools wheel
+          pip install -r requirements_dev.txt
+          tox .

.gitignore

@@ -0,0 +1,9 @@
+.idea/
+.vscode
+env/
+
+!demos/gallery/tackle.yaml
+demos/gallery/*
+ouput.json
+
+before.yaml

README.md

@@ -0,0 +1,58 @@
+# tackle-demo
+
+Simple demo to introduce the format and features for [`tackle-box`](https://github.com/geometry-labs/tackle-box)
+
+```
+pip3 install tackle-box 
+tackle https://github.com/robcxyz/tackle-demo
+```
+
+This demo walks you through many of the aspects of tackle boxes DSL. 
+
+```shell
+? What demos do you want to do?  (<up>, <down> to move, <space> to select, <a> to toggle, <i> to invert)
+ ❯○ Monty Python basic demo
+  ○ Embedded tackle boxes
+  ○ A tutorial of all the hooks and providers
+  ○ A tutorial on useful patterns with jinja
+  ○ Galllery of the most popular cookiecutters
+```
+
+### Basic Demo 
+
+Simply write your tackle box per this format. The key in the jinja syntax defaults to the context filename for the template, in this case `yaml`.
+
+A `tackle.yaml` file placed in a directory and run with `tackle .` would call the script.
+```yaml
+---
+name:
+  type: input
+  message: What is your name?
+
+colors:
+  type: checkbox
+  message: What are your favorite colors?
+  choices:
+    - blue
+    - green
+    - grey
+
+wingspeed:
+  type: select
+  message: What is the airspeed velocity of an unladen swallow??
+  choices:
+    - I donno
+    - What do you mean? African or European swallow?
+
+bad_outcome:
+  type: print
+  statement: Wrong answer {{ name }}... (Flung off bridge)
+  when: "{{ 'I donno' in wingspeed }}"
+
+color_essays:
+  type: input
+  message: Please tell me how much you like the color {{item}}?
+  default: Oh color {{item}}, you are so frickin cool...
+  loop: "{{ colors }}"
+  when: "{{ colors|length > 0 }}"
+```

demos/all-providers/providers/aws/tackle.yaml

@@ -0,0 +1,43 @@
+---
+
+aws_enable:
+  type: confirm
+  message: |
+    You can route various AWS Calls that are common. Right now
+      we have some basic helpers that wrap boto commands.
+
+regions:
+  type: aws_regions
+
+regions_blurb:
+  type: confirm
+  message: |
+    Here is an example of the regions hook:
+
+    regions:
+      type: aws_regions
+
+    It outputs a list per this output:
+    {% raw %}
+    {{ regions }} = {% endraw %}{{ aws.regions }}
+
+azs:
+  type: aws_azs
+  regions:
+    - us-east-1
+    - us-east-2
+
+azs_blurb:
+  type: confirm
+  message: |
+    Here is an example of the regions hook:
+
+    azs:
+      type: aws_azs
+      regions:
+        - us-east-1
+        - us-east-2
+
+    It outputs a list per this output:
+    {% raw %}
+    {{ azs }} = {% endraw %}{{ aws.azs }}

demos/all-providers/providers/pyinquirer/checkbox.yaml

@@ -0,0 +1,17 @@
+checkbox:
+  type: checkbox
+  choices:
+    - stuff
+    - things
+  message: |
+    This is an example of a checkbox hook. It takes in a number of options
+    with a list input and outputs a list.
+    
+    Basic example:
+      type: checkbox
+      message: Some message...
+      choices:
+        - stuff
+        - things
+    
+    Returns list

demos/all-providers/providers/pyinquirer/confirm.yaml

@@ -0,0 +1,11 @@
+confirm:
+  type: confirm
+  message: |
+    This is an example of a basic confirm hook.
+    
+    Example:
+      confirm:
+        type: confirm
+        message: Some message...
+
+    Returns boolean

demos/all-providers/providers/pyinquirer/input.yaml

@@ -0,0 +1,11 @@
+input:
+  type: input
+  default: stuff and things
+  message: |
+    This is an example of a input hook. It takes in a string.
+    
+    Basic example:
+      type: input
+      message: Some message...
+    
+    Returns string

demos/all-providers/providers/pyinquirer/list.yaml

@@ -0,0 +1,16 @@
+select:
+  type: select
+  choices:
+    - stuff
+    - things
+  message: |
+    This is an example of a list hook. It takes in a list and returns on item.
+    
+    Basic example:
+      type: input
+      choices:
+        - stuff
+        - things
+      message: Some message...
+    
+    Returns string

demos/all-providers/providers/pyinquirer/tackle.yaml

@@ -0,0 +1,15 @@
+---
+
+ops:
+  type: stat
+  input:
+    - confirm
+    - input
+    - list
+    - checkbox
+
+hook_run:
+  type: tackle
+  template: .
+  context_file: "{{ item }}.yaml"
+  loop: "{{ ops }}"

demos/all-providers/providers/system/command.yaml

@@ -0,0 +1,17 @@
+command:
+  type: command
+  command: pwd
+
+confirm_command:
+  type: confirm
+  message: |
+    This is an example of a command hook. It runs arbitrary system commands
+    and returns the value of stdout to the variable.
+    
+    command:
+      type: command
+      command: pwd
+
+    It outputs a string per:
+    {% raw %}
+    {{ command }} = {% endraw %}{{ command }}

demos/all-providers/providers/system/find_in_parent.yaml

@@ -0,0 +1,19 @@
+demos_dir:
+  type: find_in_parent
+  target: demos
+
+confirm_command:
+  type: confirm
+  message: |
+    This is an example of a find_in_parent hook. It finds the absolute path
+    to whatever target directory that you need to find in the parent directories.
+    It is useful for setting absolute references to files and folders while
+    switching contexts in and out of other tackle boxes.
+
+    demos_dir:
+      type: find_in_parent
+      target: demos
+
+    It outputs a string per:
+    {% raw %}
+    {{ demos_dir }} = {% endraw %}{{ demos_dir }}

demos/all-providers/providers/system/jinja.yaml

@@ -0,0 +1,34 @@
+hold:
+  type: confirm
+  message: hold jinja
+
+render_var:
+  type: var
+  input: 42
+
+jinja:
+  type: jinja
+  template_path: templates/things.py.j2
+  output_path: testing.py
+
+confirm:
+  type: path_exists
+  path: testing.py
+
+confirm_jinja:
+  type: confirm
+  message: |
+    This is an example of a jinja hook. It renders arbitrary templates
+    with the context dictionary that we are building.
+    
+    jinja:
+      type: jinja
+      command: pwd
+    
+    It outputs a string per:
+    {% raw %}
+    {{ jinja }} = {% endraw %}{{ jinja }}
+
+remove:
+  type: remove
+  path: testing.py

demos/all-providers/providers/system/listdir.yaml

@@ -0,0 +1,21 @@
+hold:
+  type: confirm
+  message: hold listdir
+
+listdir:
+  type: listdir
+  path: .
+
+confirm_listdir:
+  type: confirm
+  message: |
+    This is an example of a listdir hook. It outputs a list of files and folders
+    based on a given path.  Has a few options per below.
+    
+    listdir:
+      type: listdir
+      path: {{ cwd }} # We have special variables too!
+    
+    It outputs a string per:
+    {% raw %}
+    {{ listdir }} = {% endraw %}{{ listdir }}

demos/all-providers/providers/system/tackle.yaml

@@ -0,0 +1,14 @@
+---
+
+ops:
+  type: stat
+  input:
+    - command
+    - listdir
+    - jinja
+
+hook_run:
+  type: tackle
+  template: .
+  context_file: "{{ item }}.yaml"
+  loop: "{{ ops }}"

demos/all-providers/providers/system/templates/things.py.j2

@@ -0,0 +1 @@
+x = {{ render_var }}

demos/all-providers/providers/tackle/docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = python -msphinx
+SPHINXPROJ    = python_boilerplate
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

demos/all-providers/providers/tackle/docs/authors.rst

@@ -0,0 +1 @@
+.. include:: ../AUTHORS.rst