packer-client 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YzljNzQ3MDI0YTI4ZDk0ZWYzNGQ3NWI4NTg0NzMwZTA0NjA3YzEwZQ==
+  data.tar.gz: !binary |-
+    NzBmZmRjZmJlNjVjYTkwZjY1ODQyY2JlNzI3OTNhZTY4OGE5YTg1Mw==
+SHA512:
+  metadata.gz: !binary |-
+    ZTk1MzQ5YmU1MDJmMTYwOGUwZTBjY2Q1NzVkZjRiOGY0NGFhNTE3YTM4YTIy
+    ZDdjYjU4YjI5YjllMmMxODUzMDhmOTQ4YmQ2ZGQyOTk4MDI1N2EyMzMzNTg4
+    OTQwNTRmZTYxYTIwYWM5MzZjYTZhZTFlZjdjYTc1MWMxYWFjZjI=
+  data.tar.gz: !binary |-
+    MDMzZWNlMjM3NDFkNTRiOTAwMjUwOGZmYTRhNTdhMmM5MjkxNjExNGFlMGZm
+    ZmE5YjE0NWIxMWYxYTE3ZTUwZTZmMmUwN2NjZjhlOGJmZWJlYTE3MjFhZmQy
+    ZDk3NDVhY2JjMzkwNmI5NTRkMmFiMzE4MDNmMTQwY2Q5MjA4ZWU=

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,2 @@
+Metrics/LineLength:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+rvm:
+- 2.2.5
+- 2.3.1
+before_install: gem install bundler -v 1.10.6
+deploy:
+  provider: rubygems
+  on:
+    tags: true
+  api_key:
+    secure: E4iOts6aVaN7qavJ39NKoAhtJPXVqXG0XQIXbJKshacxzs9WdZxB8v9lxCNCq9nAaybzw++e/CybT3jv+OeujMMJRF61qQ6LxD5btBJlrMItB1RIU0Gb6I0xjb/iIZk5hQejYxxi1wSezUBwwxP+AtyaY5Dw8CB/hH+jk8EgZwWpb70fpK6IARrZNM5XpoEIB/f/ZF1JU6Mfcdvik4mG6sbqTz/3bjv6QbzDw80ejIjzlFeAx7hek4XuIV5KAHU2+ArpRuMIpm03yOBgqrMke481Zqhu6XATz/SV9MLzpVgehttxziTj9fNEkW8Lfn35s4+CxNK1f+UHRraTBXFaiHCCclKAt8NmaxnaCSzHziYzRrryY0tHICiyirdftt6exFf3a+RUECEQim/BrOq7b3T1qMDewtWOp6zH2An+QQ/mVfcx/SPuzkrkZ1zU+MkZhQmJWCgbJQT7P4aeJLUhE9oi37PZg2Kurv5Ul0ERpjVfV0Y102IegfHlp8S/67oDeeQJmh9vhd22EhVnwWYnKxlnEsCFJeaclKtNfCb6VIoyzXmpRdwJyNzMvgHv5WnATQXBhzWXAssaZyEF2FLj88/vHByjJodFfTg3YS2Vj1DbozeLbySXr21+VxHiF0xclsCseQLtogiXkUCcfbHlBe3dCK3VPUVOgA1g0FDI6sE=
+notifications:
+  slack:
+    secure: I1CCQzA99RbTG/urNV+zB/fH2H6o8SiMmr4WlXmJKHDJEdVwiFmEGLy0Hch1V2Me6udT3FW8uBMshVz2oVhCpu+vuGcky5raf9moHxM3go7kocFPET+NFBexJ0ejNZn+/P9VhFokafYR27AJyTU5TRR7gysnVqmw3kJBC66JyQRaly2zsL2cxkTtCAseArnou0e1K9SqKi8vQAT24nk7Vqxl9LcnCFjGuzNjjVA39SLRa2OSA9O2TOC/nQwSqQCMc0CiOd2qDD9PHC49uSvMnNjVRU5FLHUu3muBEY2ytSVlN1kQZRd4cdYEM4JXcfyEABrH/JggdastlSOAHDjJEarq9vNdaOBoNgiKqH1hF0yW/niv8+0ux0yRfdNEw6543U3KB5YWAlEtlm0cB5HJAx3urZxask2gHyApFOGjASItxDnPH9Z8S9HTTnUEy51oY1ELXUvANXdkRHI0ACGHeBaM3Pnm5//QpUT+V0jYo82yTe8j8H8O+w8eMQ86LEZ1I8hB+H8hqS3BLU3NiVa0MPpGwOfsbpNIOlUP61LS1dcTchAdMxZHeHp+d8gmzAlJCeesZeb+zv6kmu2iN+/ESsT0CT9Bq0TGyK3C+87y7vmB1k+qibnFt11/IAm/r23fYU6ctDTDY2Z/h4uDpN7Fycqeh4xfYqsmQKuEs66aZY0=

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in packer.gemspec
+gemspec
+
+group :development do
+  gem 'guard'
+  gem 'guard-rspec'
+  gem 'rubocop'
+end

data/Guardfile

@@ -0,0 +1,5 @@
+guard :rspec, cmd: 'rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/unit/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { 'spec' }
+end

data/Jenkinsfile

@@ -0,0 +1,110 @@
+stage('Install dependencies') {
+    node {
+        checkout scm
+        withRvm('ruby-2.3.1') {
+            sh 'bundle -v || gem install bundler'
+            sh 'bundle install'
+            stash includes: 'Gemfile.lock, .bundle', name: 'bundle'
+        }
+    }
+}
+
+stage('Style checks') {
+    parallel(Rubocop: {
+        node {
+          checkout scm
+            withRvm('ruby-2.3.1') {
+                unstash 'bundle'
+                bundle_exec 'rake style:rubocop'
+            }
+        }
+    })
+}
+
+stage('Tests') {
+    parallel(Unit: {
+        node {
+            checkout scm
+            withRvm('ruby-2.3.1') {
+                unstash 'bundle'
+                bundle_exec 'rake spec:unit'
+            }
+        }
+    }, Integration: {
+        node {
+            checkout scm
+            withRvm('ruby-2.3.1') {
+                unstash 'bundle'
+                bundle_exec 'rake spec:integration'
+            }
+        }
+    }, System: {
+        node {
+            checkout scm
+            withRvm('ruby-2.3.1') {
+                unstash 'bundle'
+                bundle_exec 'rake spec:system'
+            }
+        }
+    })
+}
+
+if (isRelease()) {
+    stage('Publish') {
+        echo 'Would publish to rubygems.org' // TODO
+        slackSend "Published ${name()} gem version ${version()} to the rubygems.org", color: 'good'
+    }
+}
+
+def bundle_exec(command) {
+    sh "bundle exec ${command}"
+}
+
+def isRelease() {
+    false // FIXME: Building git tags is not yet supported (JENKINS-34395)
+}
+
+def name() {
+    node {
+        def matcher = readFile('packer-client.gemspec') =~ "spec.name += '(.+)'"
+        matcher ? matcher[0][1] : null
+    }
+}
+
+def version() {
+    node {
+        def matcher = readFile('lib/packer/version.rb') =~ "VERSION = '(.+)'"
+        matcher ? matcher[0][1] : null
+    }
+}
+
+def withRvm(version, cl) {
+    withRvm(version, "executor-${env.EXECUTOR_NUMBER}") {
+        cl()
+    }
+}
+
+def withRvm(version, gemset, cl) {
+    RVM_HOME='$HOME/.rvm'
+    paths = [
+        "$RVM_HOME/gems/$version@$gemset/bin",
+        "$RVM_HOME/gems/$version@global/bin",
+        "$RVM_HOME/rubies/$version/bin",
+        "$RVM_HOME/bin",
+        "${env.PATH}"
+    ]
+    def path = paths.join(':')
+    withEnv(["PATH=${env.PATH}:$RVM_HOME", "RVM_HOME=$RVM_HOME"]) {
+        sh "#!/bin/bash\nset +x; source $RVM_HOME/scripts/rvm; rvm use --create --install --binary $version@$gemset"
+    }
+    withEnv([
+        "PATH=$path",
+        "GEM_HOME=$RVM_HOME/gems/$version@$gemset",
+        "GEM_PATH=$RVM_HOME/gems/$version@$gemset:$RVM_HOME/gems/$version@global",
+        "MY_RUBY_HOME=$RVM_HOME/rubies/$version",
+        "IRBRC=$RVM_HOME/rubies/$version/.irbrc",
+        "RUBY_VERSION=$version"
+    ]) {
+        cl()
+    }
+}

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Ben Vidulich
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,95 @@
+# Packer Client
+
+[![Build Status](https://travis-ci.org/zl4bv/packer-ruby.svg?branch=master)](https://travis-ci.org/zl4bv/packer-ruby)
+
+A ruby client for HashiCorp's [Packer](https://www.packer.io) tool.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'packer-client'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install packer-client
+
+## Usage
+
+```ruby
+require 'packer'
+client = Packer::Client.new
+
+# Override path to Packer executable
+client.executable_path = 'C:\HashiCorp\Packer\packer.exe'
+
+# Override maximum time that Packer may execute for
+client.execution_timeout = 7200
+```
+
+### Build: Build image(s) from template
+
+```ruby
+client.build('template.json')
+
+# Get build artifacts
+client.build('template.json').artifacts
+```
+
+### Fix: Fix template
+
+```ruby
+# Get the fixed template JSON
+client.fix('template.json').json
+
+# Determine if template is valid
+client.fix('template.json').valid?
+```
+
+### Inspect: See components of a template
+
+```ruby
+# Get user variables
+client.inspect_template('template.json').template_variables
+
+# Get builders
+client.inspect_template('template.json').template_builders
+
+# Get provisioners
+client.inspect_template('template.json').template_provisioners
+```
+
+### Push: Push a template to a Packer build service
+
+```ruby
+client.push('template.json')
+```
+
+### Validate: Check that a template is valid
+
+```ruby
+client.validate('template.json').valid?
+```
+
+### Version: Get the Packer version
+
+```ruby
+# Get version
+client.version.version
+
+# Get version commit
+client.version.version_commit
+
+# Get prerelease version
+client.version.version_prerelease
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/zl4bv/packer-ruby. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

data/Rakefile

@@ -0,0 +1,29 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+namespace :style do
+  RuboCop::RakeTask.new(:rubocop) do |t|
+    t.options = ['--fail-level', 'warning']
+  end
+end
+
+desc 'Run all style checks'
+task style: ['style:rubocop']
+
+namespace :spec do
+  RSpec::Core::RakeTask.new(:unit) do |t|
+    t.pattern = 'spec/unit/**/*_spec.rb'
+  end
+
+  RSpec::Core::RakeTask.new(:integration) do |t|
+    t.pattern = 'spec/integration/**/*_spec.rb'
+  end
+
+  # Note you must have Packer installed to run the system tests
+  RSpec::Core::RakeTask.new(:system) do |t|
+    t.pattern = 'spec/system/**/*_spec.rb'
+  end
+end
+
+task default: [:style, 'spec:unit', 'spec:integration']

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'packer'
+
+# 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.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require 'pry'
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/packer.rb

@@ -0,0 +1,24 @@
+require 'csv'
+require 'mixlib/shellout'
+require 'os'
+
+require 'packer/message/base'
+require 'packer/message/artifact'
+require 'packer/message/artifact_file'
+require 'packer/message/error'
+require 'packer/message/template_builder'
+require 'packer/message/template_provisioner'
+require 'packer/message/template_variable'
+require 'packer/message/ui'
+
+require 'packer/output/base'
+require 'packer/output/machine_readable'
+require 'packer/output/build'
+require 'packer/output/fix'
+require 'packer/output/inspect'
+require 'packer/output/push'
+require 'packer/output/validate'
+require 'packer/output/version'
+
+require 'packer/client'
+require 'packer/version'

data/lib/packer/client.rb

@@ -0,0 +1,187 @@
+module Packer
+  # Ruby client for HashiCorp Packer.
+  class Client
+    # Sets the path to the Packer executable.
+    attr_writer :executable_path
+
+    # Sets the maximum amount of time Packer may execute for before timing
+    # out.
+    attr_writer :execution_timeout
+
+    # Executes +packer build+.
+    #
+    # Will execute multiple builds in parallel as defined in the template.
+    # The various artifacts created by the template will be outputted.
+    #
+    # @param [String,Packer::Template] template the Packer template
+    # @param [Hash] options
+    # @option options [Boolean] :force force a build to continue if artifacts
+    #   exist, deletes existing artifacts
+    # @option options [Array<String>] :except build all builds other than
+    #   these
+    # @option options [Array<String>] :only only build the given builds by
+    #   name
+    # @option options [Boolean] :parallel disable parallelization (on by
+    #   default)
+    # @option options [Hash] :vars variables for templates
+    # @option options [String] :var_file path to JSON file containing user
+    #   variables
+    # @return [Packer::Output::Build]
+    def build(template, options = {})
+      args = ['build', '-machine-readable']
+      args << '-force' if options.key?(:force)
+      args << "-except=#{options[:except].join(',')}" if options.key?(:except)
+      args << "-only=#{options[:only].join(',')}" if options.key?(:only)
+      args << "-parallel=#{options[:parallel]}" if options.key?(:parallel)
+      args << "-var-file=#{options[:var_file]}" if options.key?(:var_file)
+
+      vars = options[:vars] || {}
+      vars.each { |key, val| args << "-var '#{key}=#{val}'" }
+
+      args << template
+
+      Packer::Output::Build.new(command(args))
+    end
+
+    # @api private
+    # @param [Array<String>] args to pass to Packer
+    def command(args)
+      cmd = [executable_path, args].join(' ')
+      so = Mixlib::ShellOut.new(cmd, timeout: execution_timeout)
+      so.run_command
+    end
+
+    # Gets the path to the Packer executable. Defaults to +packer.exe+ on
+    # Windows and +packer+ on other platforms. The default values expect the
+    # Packer executable to be available via the PATH.
+    #
+    # @return [String] path to Packer executable
+    def executable_path
+      return @executable_path if @executable_path
+
+      if OS.windows?
+        'packer.exe'
+      else
+        'packer'
+      end
+    end
+
+    # Gets the maximum amount of time Packer may execute for before timing
+    # out. Defaults to 2 hours.
+    #
+    # @return [Fixnum] execution timeout
+    def execution_timeout
+      @execution_timeout || 7200 # 2 hours
+    end
+
+    # Executes +packer fix+.
+    #
+    # Reads the JSON template and attempts to fix know backwards
+    # incompatibilities. The fixed template will be outputted to standard out.
+    #
+    # If the template cannot be fixed due to an error, the command will exit
+    # will a non-zero exist status. Error messages will appear on standard
+    # error.
+    #
+    # @param [String,Packer::Template] template the Packer template
+    # @return [Packer::Output::Fix]
+    def fix(template)
+      Packer::Output::Fix.new(command(['fix', template]))
+    end
+
+    # Excutes +packer inspect+
+    #
+    # Inspects a template, parsing and outputting the components a template
+    # defines. This does not validate the contents of a template (other than
+    # basic syntax by necessity).
+    #
+    # @param [String,Packer::Template] template the Packer template
+    # @return [Packer::Output::Inspect]
+    def inspect_template(template)
+      args = ['inspect', '-machine-readable', template]
+
+      Packer::Output::Inspect.new(command(args))
+    end
+
+    # Executes +packer push+.
+    #
+    # Push the given template and supporting files to a Packer build service
+    # such as Atlas.
+    #
+    # If a build configuration for the given template does not exist, it will
+    # be created automatically. If the build configuration already exists, a
+    # new version will be created with this template and the supporting files.
+    #
+    # Additional configuration options (such as Atlas server URL and files to
+    # include) may be specified in the "push" section of the Packer template.
+    # Please see the online documentation about these configurables.
+    #
+    # @param [String,Packer::Template] template the Packer template
+    # @param [Hash] options
+    # @option options [String] :message a message to identify the purpose of
+    #   changes in this Packer template much like a VCS commit message
+    # @option options [String] :name the destination build in Atlas. This is
+    #   in a format "username/name".
+    # @option options [String] :token the access token to use when uploading
+    # @option options [Hash] :vars variables for templates
+    # @option options [String] :var_file path to JSON file containing user
+    #   variables
+    # @return [Packer::Output::Push]
+    def push(template, options = {})
+      args = ['push']
+      args << "-message=#{options[:message]}" if options.key?(:message)
+      args << "-name=#{options[:name]}" if options.key?(:name)
+      args << "-token=#{options[:token]}" if options.key?(:token)
+      args << "-var-file=#{options[:var_file]}" if options.key?(:var_file)
+
+      vars = options[:vars] || {}
+      vars.each { |key, val| args << "-var '#{key}=#{val}'" }
+
+      args << template
+
+      Packer::Output::Push.new(command(args))
+    end
+
+    # Executes +packer validate+
+    #
+    # Checks the template is valid by parsing the template and also checking
+    # the configuration with the various builders, provisioners, etc.
+    #
+    # If it is not valid, the errors will be shown and the command will exit
+    # with a non-zero exit status. If it is valid, it will exist with a zero
+    # exist status.
+    #
+    # @param [String,Packer::Template] template the Packer template
+    # @param [Hash] options
+    # @option options [Boolean] :syntax_only only check syntax. Do not verify
+    #   config of the template.
+    # @option options [Array<String>] :except validate all builds other than
+    #   these
+    # @option options [Array<String>] :only validate only these builds
+    # @option options [Hash] :vars variables for templates
+    # @option options [String] :var_file path to JSON file containing user
+    #   variables
+    # @return [Packer::Output::Validate]
+    def validate(template, options = {})
+      args = ['validate']
+      args << '-syntax-only' if options.key?(:syntax_only)
+      args << "-except=#{options[:except].join(',')}" if options.key?(:except)
+      args << "-only=#{options[:only].join(',')}" if options.key?(:only)
+      args << "-var-file=#{options[:var_file]}" if options.key?(:var_file)
+
+      vars = options[:vars] || {}
+      vars.each { |key, val| args << "-var '#{key}=#{val}'" }
+
+      args << template
+
+      Packer::Output::Validate.new(command(args))
+    end
+
+    # Executes +packer version+
+    #
+    # @return [Packer::Output::Version]
+    def version
+      Packer::Output::Version.new(command(['version', '-machine-readable']))
+    end
+  end
+end

data/lib/packer/message/artifact.rb

@@ -0,0 +1,23 @@
+module Packer
+  module Message
+    # Message representing an artifact produced by a builder
+    class Artifact < Base
+      # Zero-based index of the artifact being described
+      attr_accessor :artifact_index
+
+      # The unique ID of the builder
+      attr_accessor :builder_id
+
+      attr_accessor :files
+
+      # The ID (if any) of the artifact that was built
+      attr_accessor :id
+
+      # If +true+, this means the artifact was nil
+      attr_accessor :nil
+
+      # The human-readable string description of the artifact
+      attr_accessor :string
+    end
+  end
+end

data/lib/packer/message/artifact_file.rb

@@ -0,0 +1,25 @@
+module Packer
+  module Message
+    # Message representing a file associated with an artifact
+    class ArtifactFile < Base
+      # The zero-based index of the file
+      attr_accessor :file_index
+
+      # The filename
+      attr_accessor :filename
+
+      # @api private
+      # @param [Array<String>] fields
+      def self.from_fields(fields)
+        msg = new
+        msg.timestamp = fields[0]
+        msg.target = fields[1]
+        msg.type = fields[2]
+        msg.data = fields[3..-1]
+        msg.file_index = fields[5]
+        msg.filename = fields[6]
+        msg
+      end
+    end
+  end
+end

data/lib/packer/message/base.rb

@@ -0,0 +1,29 @@
+module Packer
+  module Message
+    # Base class for all message types
+    class Base
+      # Unix timestamp in UTC of when the message was printed
+      attr_accessor :timestamp
+
+      # Target of the following output
+      attr_accessor :target
+
+      # Type of message outputted by Packer
+      attr_accessor :type
+
+      # Zero or more values associated with the message type
+      attr_accessor :data
+
+      # @api private
+      # @param [Array<String>] fields
+      def self.from_fields(fields)
+        msg = new
+        msg.timestamp = fields[0]
+        msg.target = fields[1]
+        msg.type = fields[2]
+        msg.data = fields[3..-1]
+        msg
+      end
+    end
+  end
+end

data/lib/packer/message/error.rb

@@ -0,0 +1,21 @@
+module Packer
+  module Message
+    # Represents an error message
+    class Error < Base
+      # The error message
+      attr_accessor :error
+
+      # @api private
+      # @param [Array<String>] fields
+      def self.from_fields(fields)
+        msg = new
+        msg.timestamp = fields[0]
+        msg.target = fields[1]
+        msg.type = fields[2]
+        msg.data = fields[3..-1]
+        msg.error = fields[3]
+        msg
+      end
+    end
+  end
+end

data/lib/packer/message/template_builder.rb

@@ -0,0 +1,27 @@
+module Packer
+  module Message
+    # Message representing a builder defined within the template
+    #
+    # @see https://www.packer.io/docs/machine-readable/command-inspect.html
+    class TemplateBuilder < Base
+      # The name of the builder
+      attr_accessor :name
+
+      # The type of the builder
+      attr_accessor :builder_type
+
+      # @api private
+      # @param [Array<String>] fields
+      def self.from_fields(fields)
+        msg = new
+        msg.timestamp = fields[0]
+        msg.target = fields[1]
+        msg.type = fields[2]
+        msg.data = fields[3..-1]
+        msg.name = fields[3]
+        msg.builder_type = fields[4]
+        msg
+      end
+    end
+  end
+end

data/lib/packer/message/template_provisioner.rb

@@ -0,0 +1,23 @@
+module Packer
+  module Message
+    # Message representing a provisioner defined within the template
+    #
+    # @see https://www.packer.io/docs/machine-readable/command-inspect.html
+    class TemplateProvisioner < Base
+      # The name/type of the provisioner
+      attr_accessor :name
+
+      # @api private
+      # @param [Array<String>] fields
+      def self.from_fields(fields)
+        msg = new
+        msg.timestamp = fields[0]
+        msg.target = fields[1]
+        msg.type = fields[2]
+        msg.data = fields[3..-1]
+        msg.name = fields[3]
+        msg
+      end
+    end
+  end
+end

data/lib/packer/message/template_variable.rb

@@ -0,0 +1,31 @@
+module Packer
+  module Message
+    # Message representing a user variable defined within the template
+    #
+    # @see https://www.packer.io/docs/machine-readable/command-inspect.html
+    class TemplateVariable < Base
+      # The name of the variable
+      attr_accessor :name
+
+      # The default value of the variable
+      attr_accessor :default
+
+      # If non-zero, then this variable is required
+      attr_accessor :required
+
+      # @api private
+      # @param [Array<String>] fields
+      def self.from_fields(fields)
+        msg = new
+        msg.timestamp = fields[0]
+        msg.target = fields[1]
+        msg.type = fields[2]
+        msg.data = fields[3..-1]
+        msg.name = fields[3]
+        msg.default = fields[4]
+        msg.required = fields[5]
+        msg
+      end
+    end
+  end
+end

data/lib/packer/message/ui.rb

@@ -0,0 +1,25 @@
+module Packer
+  module Message
+    # Represents a message destined for a UI
+    class Ui < Base
+      # The type of UI message
+      attr_accessor :ui_message_type
+
+      # The string output to be displayed by the UI
+      attr_accessor :output
+
+      # @api private
+      # @param [Array<String>] fields
+      def self.from_fields(fields)
+        msg = new
+        msg.timestamp = fields[0]
+        msg.target = fields[1]
+        msg.type = fields[2]
+        msg.data = fields[3..-1]
+        msg.ui_message_type = fields[3]
+        msg.output = fields[4]
+        msg
+      end
+    end
+  end
+end

data/lib/packer/output/base.rb

@@ -0,0 +1,25 @@
+module Packer
+  module Output
+    # Base class for output from all Packer commands
+    class Base
+      # @param [Mixlib::ShellOut] output from the build command
+      def initialize(output)
+        @output = output
+      end
+
+      # Returns the raw standard error output
+      #
+      # @return [String]
+      def stderr
+        @output.stderr
+      end
+
+      # Returns the raw standard output
+      #
+      # @return [String]
+      def stdout
+        @output.stdout
+      end
+    end
+  end
+end

data/lib/packer/output/build.rb

@@ -0,0 +1,51 @@
+module Packer
+  module Output
+    # Represents the output from +packer build+.
+    #
+    # @see https://www.packer.io/docs/command-line/build.html
+    class Build < MachineReadable
+      # Information about an artifact of the targeted item.
+      #
+      # @return [Array<Packer::Message::Artifact]
+      def artifacts
+        afcts = []
+
+        afct ||= Packer::Message::Artifact.new
+        select_messages('artifact').each do |fields|
+          afct.timestamp ||= fields[0]
+          afct.target ||= fields[1]
+          afct.type ||= 'artifact'
+          afct.artifact_index ||= fields[3]
+
+          case fields[4]
+          when 'builder-id'
+            afct.builder_id = fields[5]
+          when 'end'
+            afcts << afct
+            afct = Packer::Message::Artifact.new
+          when 'file'
+            afct.files ||= []
+            afct.files << Packer::Message::ArtifactFile.from_fields(fields)
+          when 'files-count'
+            next
+          when 'id'
+            afct.id = fields[5]
+          when 'nil'
+            afct.nil = true
+          when 'string'
+            afct.string = fields[5]
+          end
+        end
+
+        afcts
+      end
+
+      # Build errors that occurred
+      #
+      # @return [Array<Packer::Message::Error]
+      def errors
+        select_messages('error').map { |fields| Packer::Message::Error.from_fields(fields) }
+      end
+    end
+  end
+end

data/lib/packer/output/fix.rb

@@ -0,0 +1,25 @@
+module Packer
+  module Output
+    # Represents the output from +packer fix+.
+    #
+    # @see https://www.packer.io/docs/command-line/fix.html
+    class Fix < Base
+      # JSON representing the fixed template or +nil+ if the fixing fails or the
+      # template is not valid.
+      #
+      # @return [String]
+      def json
+        return nil unless valid?
+
+        stdout
+      end
+
+      # Returns +true+ if the fixing was successful and the template is valid.
+      #
+      # @return [Boolean]
+      def valid?
+        @output.exitstatus.zero?
+      end
+    end
+  end
+end

data/lib/packer/output/inspect.rb

@@ -0,0 +1,29 @@
+module Packer
+  module Output
+    # Represents the output from +packer inspect+.
+    #
+    # @see https://www.packer.io/docs/command-line/inspect.html
+    class Inspect < MachineReadable
+      # User variables defined within the template.
+      #
+      # @return [Array<Packer::Message::TemplateVariable]
+      def template_variables
+        select_messages('template-variable').map { |fields| Packer::Message::TemplateVariable.from_fields(fields) }
+      end
+
+      # Builders defined within the template.
+      #
+      # @return [Array<Packer::Message::TemplateVariable]
+      def template_builders
+        select_messages('template-builder').map { |fields| Packer::Message::TemplateBuilder.from_fields(fields) }
+      end
+
+      # Provisioners defined within the template.
+      #
+      # @return [Array<Packer::Message::TemplateVariable]
+      def template_provisioners
+        select_messages('template-provisioner').map { |fields| Packer::Message::TemplateProvisioner.from_fields(fields) }
+      end
+    end
+  end
+end

data/lib/packer/output/machine_readable.rb

@@ -0,0 +1,26 @@
+module Packer
+  module Output
+    # Represents commands that produce machine-readable output
+    class MachineReadable < Base
+      # Outputs that would have normally gone to the console if Packer were
+      # running in human-readable mode.
+      #
+      # @return [Array<Packer::Message::Ui>]
+      def ui_messages
+        select_messages('ui').map { |fields| Packer::Message::Ui.from_fields(fields) }
+      end
+
+      private
+
+      # @api private
+      # @param [String] type of message
+      # @return [Array<Array>] lists of message fields
+      def select_messages(type)
+        stdout
+          .split("\n")
+          .map { |line| CSV.parse(line).first }
+          .select { |fields| fields[2] == type }
+      end
+    end
+  end
+end

data/lib/packer/output/push.rb

@@ -0,0 +1,10 @@
+module Packer
+  module Output
+    # Represents the output from +packer push+.
+    #
+    # @see https://www.packer.io/docs/command-line/push.html
+    class Push < Base
+      # TODO: Determine if output from push command needs additional processing
+    end
+  end
+end

data/lib/packer/output/validate.rb

@@ -0,0 +1,15 @@
+module Packer
+  module Output
+    # Represents the output from +packer validate+.
+    #
+    # @see https://www.packer.io/docs/command-line/validate.html
+    class Validate < Base
+      # Returns +true+ if the template is valid.
+      #
+      # @return [Boolean]
+      def valid?
+        @output.exitstatus.zero?
+      end
+    end
+  end
+end

data/lib/packer/output/version.rb

@@ -0,0 +1,33 @@
+module Packer
+  module Output
+    # Represents the output from +packer version+.
+    #
+    # @see https://www.packer.io/docs/machine-readable/command-version.html
+    class Version < MachineReadable
+      # The version of Packer running, only including the major, minor, and
+      # patch versions.
+      #
+      # @return [String]
+      def version
+        msgs = select_messages('version')
+        msgs[0][3]
+      end
+
+      # The SHA1 of the Git commit that build this version of Packer.
+      #
+      # @return [String]
+      def version_commit
+        msgs = select_messages('version-commit')
+        msgs[0][3]
+      end
+
+      # The prerelease tag (if any) for the running version of packer.
+      #
+      # @return [String]
+      def version_prerelease
+        msgs = select_messages('version-prelease')
+        msgs[0][3]
+      end
+    end
+  end
+end

data/lib/packer/version.rb

@@ -0,0 +1,3 @@
+module Packer
+  VERSION = '0.1.0'.freeze
+end

data/packer-client.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'packer/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'packer-client'
+  spec.version       = Packer::VERSION
+  spec.authors       = ['Ben Vidulich']
+  spec.email         = ['ben@vidulich.co.nz']
+
+  spec.summary       = "A Ruby client for HashiCorp's Packer tool."
+  spec.description   = "A Ruby client for HashiCorp's Packer tool."
+  spec.homepage      = 'https://github.com/zl4bv/packer-ruby'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.10'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rspec-its'
+
+  spec.add_runtime_dependency 'mixlib-shellout', '~> 2.2'
+  spec.add_runtime_dependency 'os', '~> 0.9'
+end

metadata

@@ -0,0 +1,161 @@
+--- !ruby/object:Gem::Specification
+name: packer-client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ben Vidulich
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-10-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mixlib-shellout
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: os
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: A Ruby client for HashiCorp's Packer tool.
+email:
+- ben@vidulich.co.nz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rubocop.yml
+- .travis.yml
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Guardfile
+- Jenkinsfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/packer.rb
+- lib/packer/client.rb
+- lib/packer/message/artifact.rb
+- lib/packer/message/artifact_file.rb
+- lib/packer/message/base.rb
+- lib/packer/message/error.rb
+- lib/packer/message/template_builder.rb
+- lib/packer/message/template_provisioner.rb
+- lib/packer/message/template_variable.rb
+- lib/packer/message/ui.rb
+- lib/packer/output/base.rb
+- lib/packer/output/build.rb
+- lib/packer/output/fix.rb
+- lib/packer/output/inspect.rb
+- lib/packer/output/machine_readable.rb
+- lib/packer/output/push.rb
+- lib/packer/output/validate.rb
+- lib/packer/output/version.rb
+- lib/packer/version.rb
+- packer-client.gemspec
+homepage: https://github.com/zl4bv/packer-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: A Ruby client for HashiCorp's Packer tool.
+test_files: []