humidifier 4.0.2 → 4.1.1

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,90 @@
+PATH
+  remote: .
+  specs:
+    humidifier (4.1.1)
+      aws-sdk-cloudformation (~> 1.25)
+      aws-sdk-s3 (~> 1.48)
+      fast_underscore (~> 0.3)
+      nokogiri (~> 1.10)
+      thor (~> 1.0)
+      thor-hollaback (~> 0.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    aws-eventstream (1.2.0)
+    aws-partitions (1.531.0)
+    aws-sdk-cloudformation (1.60.0)
+      aws-sdk-core (~> 3, >= 3.122.0)
+      aws-sigv4 (~> 1.1)
+    aws-sdk-core (3.122.1)
+      aws-eventstream (~> 1, >= 1.0.2)
+      aws-partitions (~> 1, >= 1.525.0)
+      aws-sigv4 (~> 1.1)
+      jmespath (~> 1.0)
+    aws-sdk-kms (1.51.0)
+      aws-sdk-core (~> 3, >= 3.122.0)
+      aws-sigv4 (~> 1.1)
+    aws-sdk-s3 (1.105.1)
+      aws-sdk-core (~> 3, >= 3.122.0)
+      aws-sdk-kms (~> 1)
+      aws-sigv4 (~> 1.4)
+    aws-sigv4 (1.4.0)
+      aws-eventstream (~> 1, >= 1.0.2)
+    docile (1.4.0)
+    fast_underscore (0.3.3)
+    hollaback (0.1.1)
+    jmespath (1.4.0)
+    mini_portile2 (2.6.1)
+    minitest (5.14.4)
+    nokogiri (1.12.5)
+      mini_portile2 (~> 2.6.1)
+      racc (~> 1.4)
+    parallel (1.21.0)
+    parser (3.0.2.0)
+      ast (~> 2.4.1)
+    racc (1.6.0)
+    rainbow (3.0.0)
+    rake (13.0.6)
+    regexp_parser (2.1.1)
+    rexml (3.2.5)
+    rubocop (1.23.0)
+      parallel (~> 1.10)
+      parser (>= 3.0.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.12.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.13.0)
+      parser (>= 3.0.1.1)
+    ruby-progressbar (1.11.0)
+    simplecov (0.21.2)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.3)
+    thor (1.1.0)
+    thor-hollaback (0.2.0)
+      hollaback (~> 0.1.0)
+      thor (>= 0.19.1)
+    unicode-display_width (2.1.0)
+    yard (0.9.26)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  humidifier!
+  minitest (~> 5.13)
+  rake (~> 13.0)
+  rubocop (~> 1.0)
+  simplecov (~> 0.17)
+  yard (~> 0.9)
+
+BUNDLED WITH
+   2.2.3

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016-present Kevin Deisz
+Copyright (c) 2016-present Kevin Newton
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,7 +1,7 @@
 # Humidifier
 
-[![Build Status](https://travis-ci.com/kddeisz/humidifier.svg?branch=master)](https://travis-ci.com/kddeisz/humidifier)
-[![Gem Version](https://img.shields.io/gem/v/humidifier.svg?maxAge=3600)](https://rubygems.org/gems/humidifier)
+[![Build Status](https://github.com/kddnewton/humidifier/workflows/Main/badge.svg)](https://github.com/kddnewton/humidifier/actions)
+[![Gem Version](https://img.shields.io/gem/v/humidifier.svg)](https://rubygems.org/gems/humidifier)
 
 Humidifier is a ruby tool for managing [AWS CloudFormation](https://aws.amazon.com/cloudformation/) stacks. You can use it to build and manage stacks programmatically or you can use it as a command line tool to manage stacks through configuration files.
 
@@ -22,6 +22,7 @@ Humidifier is a ruby tool for managing [AWS CloudFormation](https://aws.amazon.c
     - [`deploy [?stack] [*parameters]`](#deploy-stack-parameters)
     - [`display [stack] [?pattern]`](#display-stack-pattern)
     - [`stacks`](#stacks)
+    - [`upgrade`](#upgrade)
     - [`upload [?stack]`](#upload-stack)
     - [`validate [?stack]`](#validate-stack)
   - [Parameters](#parameters)
@@ -190,7 +191,7 @@ AdminUser:
   - Administration
 ```
 
-The top-level keys are the logical resource names that will be displayed in the CloudFormation screen. They point to a map of key/value pairs that will be passed on to `humidifier`. Any `humidifier` (and therefore any CloudFormation) attribute may be specified. For more information on CloudFormation templates and which attributes may be specified, see both the [`humidifier` docs](http://kddeisz.github.io/humidifier) and the [CloudFormation docs](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html).
+The top-level keys are the logical resource names that will be displayed in the CloudFormation screen. They point to a map of key/value pairs that will be passed on to `humidifier`. Any `humidifier` (and therefore any CloudFormation) attribute may be specified. For more information on CloudFormation templates and which attributes may be specified, see both the [`humidifier` docs](http://kddnewton.github.io/humidifier) and the [CloudFormation docs](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html).
 
 ### Mappers
 
@@ -259,6 +260,10 @@ Displays the specified stack in JSON format on the command line. If you optional
 
 Displays the names of all of the stacks that `humidifier` is managing.
 
+#### `upgrade`
+
+Downloads the latest CloudFormation resource specification. Periodically AWS will update the file that `humidifier` is based on, in which case the attributes of the resources that were changed could change. This gem usually stays relatively in sync, but if you need to use the latest specs and this gem has not yet released a new version containing them, then you can run this command to download the latest specs onto your system.
+
 #### `upload [?stack]`
 
 Upload one or all stacks in the repo to S3 for reference later. Note that this must be combined with the `humidifier` `s3_bucket` configuration option.
@@ -397,7 +402,7 @@ The specs pulled from the CFN docs is saved to `CloudFormationResourceSpecificat
 
 ### Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/kddeisz/humidifier.
+Bug reports and pull requests are welcome on GitHub at https://github.com/kddnewton/humidifier.
 
 ### License
 

data/Rakefile

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'fileutils'
+require 'rake/testtask'
+require 'yard'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+  t.warning = false
+end
+
+task default: :test
+
+YARD::Rake::YardocTask.new(:yard) do |t|
+  filepath = File.join('lib', 'humidifier', 'magic.rb')
+
+  t.stats_options = ['--list-undoc']
+  t.before = lambda do
+    require 'humidifier'
+    require_relative 'yard/dynamic'
+    Dynamic.generate(filepath)
+  end
+  t.after = -> { FileUtils.rm(filepath) }
+end

data/exe/humidifier

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# If there is a `bin/humidifier` file, then swap out execution of this default
+# CLI with the custom CLI instead.
+if File.file?(File.join('bin', 'humidifier'))
+  exec(File.join('bin', 'humidifier'))
+end
+
+require 'bundler/setup'
+
+$LOAD_PATH.unshift File.expand_path(File.join('..', 'lib'), __dir__)
+require 'humidifier'
+
+Humidifier::CLI.start(ARGV)

data/humidifier.gemspec

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require_relative 'lib/humidifier/version'
+
+version = Humidifier::VERSION
+repository = 'https://github.com/kddnewton/humidifier'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'humidifier'
+  spec.version       = version
+  spec.authors       = ['Kevin Newton']
+  spec.email         = ['kddnewton@gmail.com']
+
+  spec.summary       = 'CloudFormation made easy'
+  spec.description   = 'Programmatically generate and manage AWS ' \
+                       'CloudFormation templates, stacks, and change sets.'
+  spec.homepage      = repository
+  spec.license       = 'MIT'
+
+  spec.metadata      = {
+    'bug_tracker_uri' => "#{repository}/issues",
+    'changelog_uri' => "#{repository}/blob/v#{version}/CHANGELOG.md",
+    'source_code_uri' => repository,
+    'rubygems_mfa_required' => 'true'
+  }
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.match(%r{^(bin|docs|example|test|yard)/})
+    end
+  end
+
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'aws-sdk-cloudformation', '~> 1.25'
+  spec.add_dependency 'aws-sdk-s3', '~> 1.48'
+  spec.add_dependency 'fast_underscore', '~> 0.3'
+  spec.add_dependency 'nokogiri', '~> 1.10'
+  spec.add_dependency 'thor', '~> 1.0'
+  spec.add_dependency 'thor-hollaback', '~> 0.2'
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'minitest', '~> 5.13'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rubocop', '~> 1.0'
+  spec.add_development_dependency 'simplecov', '~> 0.17'
+  spec.add_development_dependency 'yard', '~> 0.9'
+end

data/lib/humidifier/cli.rb

@@ -48,10 +48,18 @@ module Humidifier
 
     desc 'stacks', 'List the stacks known to Humidifier'
     def stacks
-      puts '🗒  Listing stacks'
+      puts '🗒 Listing stacks'
       puts Humidifier.config.stack_names.sort.map { |name| "- #{name}" }
     end
 
+    desc 'upgrade', 'Download the latest CloudFormation resource specification'
+    def upgrade
+      print '💾 Downloading...'
+
+      version = Upgrade.perform
+      puts " upgraded to v#{version}"
+    end
+
     desc 'upload [?stack]', 'Upload one or all stacks to S3'
     def upload(name = nil)
       authorize

data/lib/humidifier/loader.rb

@@ -31,8 +31,9 @@ module Humidifier
       # loop through the specs and register each class
       def load
         parsed = parse_spec
-        types = PropertyTypes.new(parsed['PropertyTypes'])
+        return unless parsed
 
+        types = PropertyTypes.new(parsed['PropertyTypes'])
         parsed['ResourceTypes'].each do |key, spec|
           match = key.match(/\A(\w+)::(\w+)::(\w+)\z/)
           register(match[1], match[2], match[3], spec, types.search(key))
@@ -55,10 +56,10 @@ module Humidifier
       end
 
       def parse_spec
-        relative =
-          File.join('..', '..', 'CloudFormationResourceSpecification.json')
+        path = File.expand_path(File.join('..', '..', SPECIFICATION), __dir__)
+        return unless File.file?(path)
 
-        JSON.parse(File.read(File.expand_path(relative, __dir__)))
+        JSON.parse(File.read(path))
       end
 
       def register(top, group, resource, spec, substructs)

data/lib/humidifier/serializer.rb

@@ -5,7 +5,7 @@ module Humidifier
   class Serializer
     class << self
       # dumps the given object out to CFN syntax recursively
-      def dump(node)
+      def dump(node) # rubocop:disable Metrics/CyclomaticComplexity
         case node
         when Hash    then node.map { |key, value| [key, dump(value)] }.to_h
         when Array   then node.map { |value| dump(value) }

data/lib/humidifier/upgrade.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Humidifier
+  class Upgrade
+    PATH = -File.expand_path(File.join('..', '..', SPECIFICATION), __dir__)
+    URL = 'https://docs.aws.amazon.com/AWSCloudFormation/latest' \
+          '/UserGuide/cfn-resource-specification.html'
+
+    def perform
+      require 'net/http'
+      require 'nokogiri'
+
+      response = Net::HTTP.get_response(uri).body
+      parsed = JSON.parse(response)
+
+      File.write(PATH, JSON.pretty_generate(parsed))
+      parsed['ResourceSpecificationVersion']
+    end
+
+    def self.perform
+      new.perform
+    end
+
+    private
+
+    def page
+      Net::HTTP.get_response(URI.parse(URL)).body
+    end
+
+    def uri
+      Nokogiri::HTML(page).css('table tr').detect do |tr|
+        name = tr.at_css('td:first-child p')
+        next if !name || name.text.strip != 'US East (N. Virginia)'
+
+        break URI.parse(tr.at_css('td:nth-child(3) p a').attr('href'))
+      end
+    end
+  end
+end

data/lib/humidifier/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Humidifier
-  VERSION = '4.0.2'
+  VERSION = '4.1.1'
 end

data/lib/humidifier.rb

@@ -22,6 +22,9 @@ String.prepend(
 
 # container module for all gem classes
 module Humidifier
+  # The file name of the specification for consistency.
+  SPECIFICATION = 'CloudFormationResourceSpecification.json'
+
   # A parent class for all Humidifier errors for easier rescuing.
   class Error < StandardError; end
 
@@ -77,6 +80,7 @@ require 'humidifier/parameter'
 require 'humidifier/resource'
 require 'humidifier/serializer'
 require 'humidifier/stack'
+require 'humidifier/upgrade'
 require 'humidifier/version'
 
 require 'humidifier/config'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: humidifier
 version: !ruby/object:Gem::Version
-  version: 4.0.2
+  version: 4.1.1
 platform: ruby
 authors:
-- Kevin Deisz
-autorequire: 
-bindir: bin
+- Kevin Newton
+autorequire:
+bindir: exe
 cert_chain: []
-date: 2019-12-11 00:00:00.000000000 Z
+date: 2021-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-cloudformation
@@ -53,75 +53,75 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.3'
 - !ruby/object:Gem::Dependency
-  name: thor
+  name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.20'
+        version: '1.10'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.20'
+        version: '1.10'
 - !ruby/object:Gem::Dependency
-  name: thor-hollaback
+  name: thor
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: thor-hollaback
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
+        version: '0.2'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
-  name: minitest
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.13'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.13'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: nokogiri
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '5.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '5.13'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -142,14 +142,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.77'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.77'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -181,14 +181,27 @@ dependencies:
 description: Programmatically generate and manage AWS CloudFormation templates, stacks,
   and change sets.
 email:
-- kevin.deisz@gmail.com
-executables: []
+- kddnewton@gmail.com
+executables:
+- humidifier
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
+- ".github/workflows/main.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- ".yardopts"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
 - CloudFormationResourceSpecification.json
+- Gemfile
+- Gemfile.lock
 - LICENSE
 - README.md
+- Rakefile
+- exe/humidifier
+- humidifier.gemspec
 - lib/humidifier.rb
 - lib/humidifier/cli.rb
 - lib/humidifier/condition.rb
@@ -206,12 +219,17 @@ files:
 - lib/humidifier/resource.rb
 - lib/humidifier/serializer.rb
 - lib/humidifier/stack.rb
+- lib/humidifier/upgrade.rb
 - lib/humidifier/version.rb
-homepage: https://github.com/kddeisz/humidifier
+homepage: https://github.com/kddnewton/humidifier
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  bug_tracker_uri: https://github.com/kddnewton/humidifier/issues
+  changelog_uri: https://github.com/kddnewton/humidifier/blob/v4.1.1/CHANGELOG.md
+  source_code_uri: https://github.com/kddnewton/humidifier
+  rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -219,15 +237,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.2.3
+signing_key:
 specification_version: 4
 summary: CloudFormation made easy
 test_files: []