awspec 1.11.1 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: 5fc6f65927df3c5bce28f2194e28e2295faaa76dcda4178e6a45c3ed0bb5d734
-  data.tar.gz: fd91c29eaa74f61f74be806370564496c462d4ce8850a8e2fa5072273edb7db7
+SHA1:
+  metadata.gz: 5be81c89f451b385efcbd7d18de2324d4484045b
+  data.tar.gz: 68e0de83941e97259ec93fa70d67056b4ce4474d
 SHA512:
-  metadata.gz: a55c537349f48a6d97106cbd3b7da029ee148bc39f7a1360ed40977a2b1fc71c3bf85d980babe943fbd9042d1450a7a86f5136ba76ea04072b52e31b5c39903a
-  data.tar.gz: 8e405e7f0a87cdbff849a78b6f3f7d020a28d241ab36c656d6e5297f098344a9bacfd9c32dc6a90afa0bca7f49678a2ebbb3136c52db2e3c7facaa927b220895
+  metadata.gz: 73b78a236ae3f1822544afccb7a808ede0f41d4aeb245dbf55feb0c837e4aaac6e337e6eebb3325ffda5ddc2fb46bbfa0f80ce3a6bf885e1dc6ad45ce6c589ab
+  data.tar.gz: 101db4cfdbaba74ea7a125a5154cf231b118b81bf4875d2733359afbe777855eb32e54601e8812892a0cd3e38d11ea785181b726597fd0e10235da377fd93b63

data/doc/_resource_types/ec2.md

@@ -39,6 +39,16 @@ describe ec2('my-ec2-classic') do
 end
 ```
 
+### have_credit_specification
+
+The credit option for CPU usage of T2 or T3 instance.
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_credit_specification('unlimited') }
+end
+```
+
 ### have_ebs
 
 ```ruby
@@ -151,3 +161,43 @@ describe ec2('my-ec2') do
   its('resource.vpc.id') { should eq 'vpc-ab123cde' }
 end
 ```
+
+#### Awspec::DuplicatedResourceTypeError exception
+
+EC2 resources might have the same tag value and if you try to search for a
+specific instance using that tag/tag value you might found multiples results
+and receive a `Awspec::DuplicatedResourceTypeError` exception as result.
+
+To avoid such situations, you will want to use EC2 instances ID's and then use
+those ID's to test whatever you need.
+
+There are several different ways to provide such ID's, like using [Terraform output](https://www.terraform.io/docs/configuration/outputs.html) or even the
+AWS SDK directly:
+
+```ruby
+require 'awspec'
+require 'aws-sdk-ec2'
+
+tag_name = 'tag:Name'
+tag_value = 'foobar'
+servers = {}
+ec2 = Aws::EC2::Resource.new
+ec2.instances({filters: [{name: "#{tag_name}",
+                          values: ["#{tag_value}"]}]}).each do |i|
+  servers.store(i.id, i.subnet_id)
+end
+
+if servers.size == 0
+  raise "Could not find any EC2 instance with #{tag_name} = #{tag_value}!"
+end
+
+servers.each_pair do |instance_id, subnet_id|
+  describe ec2(instance_id) do
+    it { should exist }
+    it { should be_running }
+    its(:image_id) { should eq 'ami-12345foobar' }
+    its(:instance_type) { should eq 't2.micro' }
+    it { should belong_to_subnet(subnet_id) }
+  end
+end
+```

data/doc/_resource_types/emr.md

@@ -0,0 +1,21 @@
+### exist
+
+```ruby
+describe emr('my-emr') do
+  it { should exist }
+end
+```
+### be_healthy
+
+```ruby
+describe emr('my-emr') do
+  it { should be_healthy }
+end
+```
+### be_running, be_waiting, be_starting, be_bootstrapping
+
+```ruby
+describe emr('my-emr') do
+  it { should be_running }
+end
+```

data/doc/_resource_types/sns_topic.md

@@ -0,0 +1,102 @@
+### Common arguments
+
+`topic_arn` is a string of the ARN of the SNS Topic.
+
+`subscribed` is a string of the SNS Topic subscription ARN.
+
+### exist
+
+```ruby
+describe sns_topic(topic_arn) do
+  it { should exist }
+end
+```
+
+### name
+
+```ruby
+describe sns_topic(topic_arn) do
+  its(:name) { should eq 'foobar' }
+end
+```
+
+### confirmed_subscriptions
+
+```ruby
+describe sns_topic(topic_arn) do
+  its(:confirmed_subscriptions) { should eq 1 }
+end
+```
+
+### pending_subscriptions
+
+```ruby
+describe sns_topic(topic_arn) do
+  its(:pending_subscriptions) { should eq 0 }
+end
+```
+
+### topic_arn
+
+```ruby
+describe sns_topic(topic_arn) do
+  its(:topic_arn) { should eq topic_arn }
+end
+```
+
+### display_name
+
+```ruby
+describe sns_topic(topic_arn) do
+  its(:display_name) { should eq 'ShortName' }
+end
+```
+
+### deleted_subscriptions
+
+```ruby
+describe sns_topic(topic_arn) do
+  its(:deleted_subscriptions) { should eq 0 }
+end
+```
+
+### include_subscribed
+
+```ruby
+describe sns_topic(topic_arn) do
+  it { should include_subscribed(subscribed) }
+end
+```
+
+### have_subscription_attributes
+
+```ruby
+describe sns_topic(topic_arn) do
+  let(:expected_attribs) do
+    { protocol: 'lambda',
+      owner: '123456789',
+      subscription_arn: subscribed, # this is required
+      endpoint: 'arn:aws:lambda:us-east-1:123456789:function:foobar' }
+  end
+
+  describe '#subscribed' do
+    it do
+      should have_subscription_attributes(expected_attribs)
+    end
+  end
+end
+```
+
+Where `:expected_attribs` is a hash with keys as properties that are part of a SNS Topic subscription:
+
+* subscription_arn
+* owner
+* protocol
+* endpoint
+* topic_arn
+
+You can use any combinations of key/values that will be used by `have_subscription_attributes`, but the `subscription_arn` is required and if it is missing, an exception will be generated.
+
+### advanced
+
+You may want to validate the subscriptions too. For that, you probably will want to  use the methods `subscriptions` (that will return a list of the subscriptions ARN as symbols) and `has_subscription?` (that expects a SNS Topic subscription as parameter and will return `true` of `false` if it exists as a subscription) of the class `Awspec::Type::SnsTopic` to build the fixture in order to use the matcher `have_subscription_attributes`.

data/doc/contributing.md

@@ -5,10 +5,19 @@
 1. Create your feature branch (`git checkout -b add-type-redshift`)
 2. Generate template files (`bundle exec bin/toolbox template redshift`)
 3. Fill files with code.
-4. Generate [doc/resource_types.md](doc/resource_types.md) (`bundle exec bin/toolbox docgen > doc/resource_types.md`)
-5. Run test (`bundle exec rake spec`)
-6. Push to the branch (`git push origin add-type-redshift`)
-7. Create a new Pull Request
+4. `bundle update` to update gems.
+5. Generate [doc/resource_types.md](doc/resource_types.md) (`bundle exec bin/toolbox docgen > doc/resource_types.md`)
+6. Run test (`bundle exec rake spec`)
+7. Push to the branch (`git push origin add-type-redshift`)
+8. Create a new Pull Request
+
+### Troubleshooting
+
+#### CI Failed 'Awspec::Generator::Doc::Type generate_doc output should be the same as doc/resource_types.md'
+
+Maybe, your `aws-sdk-ruby` is not latest. Please exec `bundle update` and `bundle exec bin/toolbox docgen > doc/resource_types.md`.
+
+( `aws-sdk-ruby` is often updated. )
 
 ## Add new account attribute type (ex. CloudFormation::Client#describe_account_attributes )
 

data/doc/resource_types.md

@@ -35,6 +35,7 @@
 | [elasticsearch](#elasticsearch)
 | [elastictranscoder_pipeline](#elastictranscoder_pipeline)
 | [elb](#elb)
+| [emr](#emr)
 | [firehose](#firehose)
 | [iam_group](#iam_group)
 | [iam_policy](#iam_policy)
@@ -59,6 +60,7 @@
 | [s3_bucket](#s3_bucket)
 | [security_group](#security_group)
 | [ses_identity](#ses_identity)
+| [sns_topic](#sns_topic)
 | [sqs](#sqs)
 | [ssm_parameter](#ssm_parameter)
 | [subnet](#subnet)
@@ -884,6 +886,17 @@ end
 ```
 
 
+### have_credit_specification
+
+The credit option for CPU usage of T2 or T3 instance.
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_credit_specification('unlimited') }
+end
+```
+
+
 ### have_ebs
 
 ```ruby
@@ -1009,6 +1022,46 @@ describe ec2('my-ec2') do
 end
 ```
 
+#### Awspec::DuplicatedResourceTypeError exception
+
+EC2 resources might have the same tag value and if you try to search for a
+specific instance using that tag/tag value you might found multiples results
+and receive a `Awspec::DuplicatedResourceTypeError` exception as result.
+
+To avoid such situations, you will want to use EC2 instances ID's and then use
+those ID's to test whatever you need.
+
+There are several different ways to provide such ID's, like using [Terraform output](https://www.terraform.io/docs/configuration/outputs.html) or even the
+AWS SDK directly:
+
+```ruby
+require 'awspec'
+require 'aws-sdk-ec2'
+
+tag_name = 'tag:Name'
+tag_value = 'foobar'
+servers = {}
+ec2 = Aws::EC2::Resource.new
+ec2.instances({filters: [{name: "#{tag_name}",
+                          values: ["#{tag_value}"]}]}).each do |i|
+  servers.store(i.id, i.subnet_id)
+end
+
+if servers.size == 0
+  raise "Could not find any EC2 instance with #{tag_name} = #{tag_value}!"
+end
+
+servers.each_pair do |instance_id, subnet_id|
+  describe ec2(instance_id) do
+    it { should exist }
+    it { should be_running }
+    its(:image_id) { should eq 'ami-12345foobar' }
+    its(:instance_type) { should eq 't2.micro' }
+    it { should belong_to_subnet(subnet_id) }
+  end
+end
+```
+
 ## <a name="ecr_repository">ecr_repository</a>
 
 EcrRepository resource type.
@@ -1423,6 +1476,39 @@ end
 
 
 ### its(:health_check_target), its(:health_check_interval), its(:health_check_timeout), its(:health_check_unhealthy_threshold), its(:health_check_healthy_threshold), its(:load_balancer_name), its(:dns_name), its(:canonical_hosted_zone_name), its(:canonical_hosted_zone_name_id), its(:backend_server_descriptions), its(:availability_zones), its(:subnets), its(:vpc_id), its(:security_groups), its(:created_time), its(:scheme)
+## <a name="emr">emr</a>
+
+Emr resource type.
+
+### exist
+
+```ruby
+describe emr('my-emr') do
+  it { should exist }
+end
+```
+
+### be_healthy
+
+```ruby
+describe emr('my-emr') do
+  it { should be_healthy }
+end
+```
+
+### be_ok
+
+### be_ready
+
+### be_running, be_waiting, be_starting, be_bootstrapping
+
+```ruby
+describe emr('my-emr') do
+  it { should be_running }
+end
+```
+
+### its(:id), its(:name), its(:instance_collection_type), its(:log_uri), its(:requested_ami_version), its(:running_ami_version), its(:release_label), its(:auto_terminate), its(:termination_protected), its(:visible_to_all_users), its(:service_role), its(:normalized_instance_hours), its(:master_public_dns_name), its(:configurations), its(:security_configuration), its(:auto_scaling_role), its(:scale_down_behavior), its(:custom_ami_id), its(:ebs_root_volume_size), its(:repo_upgrade_on_boot)
 ## <a name="firehose">firehose</a>
 
 Firehose resource type.
@@ -2337,7 +2423,7 @@ end
 ```
 
 
-### its(:vpc_id), its(:db_instance_identifier), its(:db_instance_class), its(:engine), its(:db_instance_status), its(:master_username), its(:db_name), its(:endpoint), its(:allocated_storage), its(:instance_create_time), its(:preferred_backup_window), its(:backup_retention_period), its(:db_security_groups), its(:availability_zone), its(:preferred_maintenance_window), its(:pending_modified_values), its(:latest_restorable_time), its(:multi_az), its(:engine_version), its(:auto_minor_version_upgrade), its(:read_replica_source_db_instance_identifier), its(:read_replica_db_instance_identifiers), its(:read_replica_db_cluster_identifiers), its(:license_model), its(:iops), its(:character_set_name), its(:secondary_availability_zone), its(:publicly_accessible), its(:status_infos), its(:storage_type), its(:tde_credential_arn), its(:db_instance_port), its(:db_cluster_identifier), its(:storage_encrypted), its(:kms_key_id), its(:dbi_resource_id), its(:ca_certificate_identifier), its(:domain_memberships), its(:copy_tags_to_snapshot), its(:monitoring_interval), its(:enhanced_monitoring_resource_arn), its(:monitoring_role_arn), its(:promotion_tier), its(:db_instance_arn), its(:timezone), its(:iam_database_authentication_enabled), its(:performance_insights_enabled), its(:performance_insights_kms_key_id), its(:performance_insights_retention_period), its(:enabled_cloudwatch_logs_exports), its(:processor_features), its(:deletion_protection)
+### its(:vpc_id), its(:db_instance_identifier), its(:db_instance_class), its(:engine), its(:db_instance_status), its(:master_username), its(:db_name), its(:endpoint), its(:allocated_storage), its(:instance_create_time), its(:preferred_backup_window), its(:backup_retention_period), its(:db_security_groups), its(:availability_zone), its(:preferred_maintenance_window), its(:pending_modified_values), its(:latest_restorable_time), its(:multi_az), its(:engine_version), its(:auto_minor_version_upgrade), its(:read_replica_source_db_instance_identifier), its(:read_replica_db_instance_identifiers), its(:read_replica_db_cluster_identifiers), its(:license_model), its(:iops), its(:character_set_name), its(:secondary_availability_zone), its(:publicly_accessible), its(:status_infos), its(:storage_type), its(:tde_credential_arn), its(:db_instance_port), its(:db_cluster_identifier), its(:storage_encrypted), its(:kms_key_id), its(:dbi_resource_id), its(:ca_certificate_identifier), its(:domain_memberships), its(:copy_tags_to_snapshot), its(:monitoring_interval), its(:enhanced_monitoring_resource_arn), its(:monitoring_role_arn), its(:promotion_tier), its(:db_instance_arn), its(:timezone), its(:iam_database_authentication_enabled), its(:performance_insights_enabled), its(:performance_insights_kms_key_id), its(:performance_insights_retention_period), its(:enabled_cloudwatch_logs_exports), its(:processor_features), its(:deletion_protection), its(:listener_endpoint)
 ### :unlock: Advanced use
 
 `rds` can use `Aws::RDS::DBInstance` resource (see http://docs.aws.amazon.com/sdkforruby/api/Aws/RDS/DBInstance.html).
@@ -2741,6 +2827,65 @@ end
 ```
 
 ### its(:dkim_enabled), its(:dkim_verification_status), its(:bounce_topic), its(:complaint_topic), its(:delivery_topic), its(:forwarding_enabled), its(:verification_status), its(:verification_token)
+## <a name="sns_topic">sns_topic</a>
+
+SnsTopic resource type.
+
+### exist
+
+```ruby
+describe sns_topic(topic_arn) do
+  it { should exist }
+end
+```
+
+
+### have_subscription
+
+### have_subscription_attributes
+
+```ruby
+describe sns_topic(topic_arn) do
+  let(:expected_attribs) do
+    { protocol: 'lambda',
+      owner: '123456789',
+      subscription_arn: subscribed, # this is required
+      endpoint: 'arn:aws:lambda:us-east-1:123456789:function:foobar' }
+  end
+
+  describe '#subscribed' do
+    it do
+      should have_subscription_attributes(expected_attribs)
+    end
+  end
+end
+```
+
+Where `:expected_attribs` is a hash with keys as properties that are part of a SNS Topic subscription:
+
+* subscription_arn
+* owner
+* protocol
+* endpoint
+* topic_arn
+
+You can use any combinations of key/values that will be used by `have_subscription_attributes`, but the `subscription_arn` is required and if it is missing, an exception will be generated.
+
+
+### include_subscribed
+
+```ruby
+describe sns_topic(topic_arn) do
+  it { should include_subscribed(subscribed) }
+end
+```
+
+
+### its(:policy), its(:owner), its(:pending_subscriptions), its(:topic_arn), its(:effective_delivery_policy), its(:display_name), its(:confirmed_subscriptions), its(:deleted_subscriptions), its(:name)
+### :unlock: Advanced use
+
+You may want to validate the subscriptions too. For that, you probably will want to  use the methods `subscriptions` (that will return a list of the subscriptions ARN as symbols) and `has_subscription?` (that expects a SNS Topic subscription as parameter and will return `true` of `false` if it exists as a subscription) of the class `Awspec::Type::SnsTopic` to build the fixture in order to use the matcher `have_subscription_attributes`.
+
 ## <a name="sqs">sqs</a>
 
 SQS resource type.

data/lib/awspec/generator/doc/type/emr.rb

@@ -0,0 +1,19 @@
+module Awspec::Generator
+  module Doc
+    module Type
+      class Emr < Base
+        def initialize
+          super
+          @type_name = 'Emr'
+          @type = Awspec::Type::Emr.new('my-emr')
+          @ret = @type.resource_via_client
+          @matchers = [
+            Awspec::Type::Emr::STATES.map { |state| 'be_' + state.downcase }.join(', ')
+          ]
+          @ignore_matchers = Awspec::Type::Emr::STATES.map { |state| 'be_' + state.downcase }
+          @describes = []
+        end
+      end
+    end
+  end
+end

data/lib/awspec/generator/doc/type/sns_topic.rb

@@ -0,0 +1,18 @@
+module Awspec::Generator
+  module Doc
+    module Type
+      class SnsTopic < Base
+        def initialize
+          super
+          @type_name = 'SnsTopic'
+          @type = Awspec::Type::SnsTopic.new('my-sns')
+          @ret = @type.resource_via_client
+          @matchers = %w(include_subscribed have_subscription_attributes)
+          @ignore_matchers = []
+          @describes = %w(policy owner pending_subscriptions topic_arn effective_delivery_policy display_name
+                          confirmed_subscriptions deleted_subscriptions name)
+        end
+      end
+    end
+  end
+end

data/lib/awspec/generator/spec/cloudwatch_logs.rb

@@ -15,7 +15,7 @@ module Awspec::Generator
       end
 
       def generate_log_stream_spec(log_group)
-        log_stream = find_cloudwatch_logs_stream_by_log_group_name(log_group)
+        log_stream = last_cloudwatch_logs_stream_by_log_group_name(log_group)
         "it { should have_log_stream('#{log_stream.log_stream_name}') }" unless log_stream.nil?
       end
 

data/lib/awspec/generator/spec/ec2.rb

@@ -19,6 +19,7 @@ module Awspec::Generator
           eips = select_eip_by_instance_id(instance_id)
           volumes = select_ebs_by_instance_id(instance_id)
           network_interfaces = select_network_interface_by_instance_id(instance_id)
+          credit_specification = find_ec2_credit_specifications(instance_id)
           content = ERB.new(ec2_spec_template, nil, '-').result(binding).gsub(/^\n/, '')
         end
         specs.join("\n")
@@ -69,6 +70,9 @@ describe ec2('<%= instance_id %>') do
 <% network_interfaces.each do |interface| %>
   it { should have_network_interface('<%= interface.network_interface_id %>') }
 <% end %>
+<%- if credit_specification.cpu_credits -%>
+  it { should have_credit_specification('<%= credit_specification.cpu_credits %>') }
+<%- end -%>
 end
 EOF
         template

data/lib/awspec/helper/finder.rb

@@ -40,6 +40,8 @@ require 'awspec/helper/finder/apigateway'
 require 'awspec/helper/finder/kinesis'
 require 'awspec/helper/finder/batch'
 require 'awspec/helper/finder/eks'
+require 'awspec/helper/finder/sns_topic'
+require 'awspec/helper/finder/emr'
 
 require 'awspec/helper/finder/account_attributes'
 
@@ -89,6 +91,8 @@ module Awspec::Helper
     include Awspec::Helper::Finder::Kinesis
     include Awspec::Helper::Finder::Batch
     include Awspec::Helper::Finder::Eks
+    include Awspec::Helper::Finder::SNSTopic
+    include Awspec::Helper::Finder::Emr
 
     CLIENTS = {
       ec2_client: Aws::EC2::Client,
@@ -126,7 +130,9 @@ module Awspec::Helper
       apigateway_client: Aws::APIGateway::Client,
       kinesis_client: Aws::Kinesis::Client,
       batch_client: Aws::Batch::Client,
-      eks_client: Aws::EKS::Client
+      eks_client: Aws::EKS::Client,
+      sns_client: Aws::SNS::Client,
+      emr_client: Aws::EMR::Client
     }
 
     CLIENT_OPTIONS = {

data/lib/awspec/helper/finder/cloudwatch_logs.rb

@@ -9,6 +9,10 @@ module Awspec::Helper
         end
       end
 
+      def last_cloudwatch_logs_stream_by_log_group_name(id)
+        cloudwatch_logs_client.describe_log_streams({ log_group_name: id }).log_streams.last
+      end
+
       def find_cloudwatch_logs_stream_by_log_group_name(id, stream_name)
         req = {
           log_group_name: id,

data/lib/awspec/helper/finder/ec2.rb

@@ -28,6 +28,13 @@ module Awspec::Helper
                                                      })
       end
 
+      def find_ec2_credit_specifications(id)
+        res = ec2_client.describe_instance_credit_specifications({
+                                                                   instance_ids: [id]
+                                                                 })
+        res.instance_credit_specifications.first if res.instance_credit_specifications.count == 1
+      end
+
       def find_ec2_status(id)
         res = ec2_client.describe_instance_status({
                                                     instance_ids: [id]

data/lib/awspec/helper/finder/emr.rb

@@ -0,0 +1,9 @@
+module Awspec::Helper
+  module Finder
+    module Emr
+      def find_emr_cluster(cluster_id)
+        emr_client.describe_cluster({ cluster_id: cluster_id }).cluster
+      end
+    end
+  end
+end

data/lib/awspec/helper/finder/iam.rb

@@ -89,20 +89,20 @@ module Awspec::Helper
       end
 
       def select_all_iam_users
-        iam_client.list_users.map do |responce|
-          responce.users
+        iam_client.list_users.map do |response|
+          response.users
         end.flatten
       end
 
       def select_all_iam_groups
-        iam_client.list_groups.map do |responce|
-          responce.groups
+        iam_client.list_groups.map do |response|
+          response.groups
         end.flatten
       end
 
       def select_all_iam_roles
-        iam_client.list_roles.map do |responce|
-          responce.roles
+        iam_client.list_roles.map do |response|
+          response.roles
         end.flatten
       end
     end

data/lib/awspec/helper/finder/lambda.rb

@@ -23,8 +23,8 @@ module Awspec::Helper
       end
 
       def select_all_lambda_functions
-        res = lambda_client.list_functions.map do |responce|
-          responce.functions
+        res = lambda_client.list_functions.map do |response|
+          response.functions
         end.flatten
       end
     end

data/lib/awspec/helper/finder/sns_topic.rb

@@ -0,0 +1,47 @@
+module Awspec::Helper
+  module Finder
+    module SNSTopic
+      class SnsTopic
+        # to make testing results easier to the eyes instead of using Rspec
+        # include matcher for hashes
+        attr_reader :policy, :owner, :pending_subscriptions, :topic_arn, :effective_delivery_policy,
+                    :display_name, :confirmed_subscriptions, :deleted_subscriptions, :name
+
+        def initialize(attribs)
+          @policy = attribs['Policy']
+          @owner = attribs['Owner']
+          @pending_subscriptions = attribs['SubscriptionsPending'].to_i
+          @topic_arn = attribs['TopicArn']
+          @effective_delivery_policy = attribs['EffectiveDeliveryPolicy']
+          @display_name = attribs['DisplayName']
+          @confirmed_subscriptions = attribs['SubscriptionsConfirmed'].to_i
+          @deleted_subscriptions = attribs['SubscriptionsDeleted'].to_i
+          @name = attribs['TopicArn'].split(':')[-1]
+        end
+
+        def to_s
+          output = ["SnsTopic: #{self.name}"]
+          self.instance_variables.each do |attrib|
+            tmp = attrib.to_s.sub('@', '')
+            output << "  #{tmp} = #{self.send(tmp)}"
+          end
+          output.join("\n")
+        end
+      end
+
+      def find_sns_topic(topic_arn)
+        response = sns_client.get_topic_attributes({ topic_arn: topic_arn })
+        SnsTopic.new(response.attributes)
+      end
+
+      def find_sns_topic_subs(topic_arn)
+        response = sns_client.list_subscriptions_by_topic({ topic_arn: topic_arn })
+        subscriptions = {}
+        response.subscriptions.each do |subscribed|
+          subscriptions[subscribed['subscription_arn'].to_sym] = subscribed
+        end
+        subscriptions
+      end
+    end
+  end
+end

data/lib/awspec/helper/type.rb

@@ -12,13 +12,13 @@ module Awspec
         batch_compute_environment batch_job_definition batch_job_queue cloudtrail
         cloudwatch_alarm cloudwatch_event directconnect_virtual_interface
         ebs ec2 ecr_repository ecs_cluster ecs_container_instance ecs_service ecs_task_definition
-        efs eks elasticache elasticache_cache_parameter_group elasticsearch elb firehose iam_group
+        efs eks elasticache elasticache_cache_parameter_group elasticsearch elb emr firehose iam_group
         iam_policy iam_role iam_user kinesis kms lambda launch_configuration nat_gateway
         network_acl network_interface nlb nlb_listener nlb_target_group
         rds rds_db_cluster_parameter_group rds_db_parameter_group route53_hosted_zone
         route_table s3_bucket security_group ses_identity subnet vpc cloudfront_distribution
         elastictranscoder_pipeline waf_web_acl customer_gateway vpn_gateway vpn_connection internet_gateway acm
-        cloudwatch_logs dynamodb_table eip sqs ssm_parameter cloudformation_stack codebuild
+        cloudwatch_logs dynamodb_table eip sqs ssm_parameter cloudformation_stack codebuild sns_topic
       )
 
       ACCOUNT_ATTRIBUTES = %w(

data/lib/awspec/matcher.rb

@@ -70,3 +70,7 @@ require 'awspec/matcher/belong_to_nlb'
 # VPC
 require 'awspec/matcher/be_connected_to_vpc'
 require 'awspec/matcher/have_vpc_peering_connection'
+
+# SNSTopic
+require 'awspec/matcher/include_subscribed'
+require 'awspec/matcher/have_subscription_attributes'

data/lib/awspec/matcher/have_subscription_attributes.rb

@@ -0,0 +1,16 @@
+RSpec::Matchers.define :have_subscription_attributes do |expected_attribs|
+  match do |sns_topic|
+    unless expected_attribs.key?(:subscription_arn)
+      raise '"subscription_arn" is the only required attribute to validate'
+    end
+    subscribed = sns_topic.subscribed(expected_attribs[:subscription_arn])
+    temp = subscribed.to_h
+    to_remove = temp.keys - expected_attribs.keys
+    to_remove.each { |key| temp.delete(key) }
+    temp == expected_attribs
+  end
+
+  failure_message do |sns_topic|
+    "expected SNS topic #{sns_topic.name} to have a subscription with the following attributes: #{expected_attribs}"
+  end
+end

data/lib/awspec/matcher/include_subscribed.rb

@@ -0,0 +1,5 @@
+RSpec::Matchers.define :include_subscribed do |subscribed_arn|
+  match do |sns_topic|
+    sns_topic.has_subscription?(subscribed_arn)
+  end
+end

data/lib/awspec/stub/dynamodb_table.rb

@@ -10,11 +10,11 @@ Aws.config[:dynamodb] = {
         },
         attribute_definitions: [
           {
-            attribute_name: 'my-dynamodb-table-attaribute1',
+            attribute_name: 'my-dynamodb-table-attribute1',
             attribute_type: 'S'
           },
           {
-            attribute_name: 'my-dynamodb-table-attaribute2',
+            attribute_name: 'my-dynamodb-table-attribute2',
             attribute_type: 'N'
           }
         ],

data/lib/awspec/stub/ec2.rb

@@ -222,6 +222,14 @@ Aws.config[:ec2] = {
           interface_type: nil
         }
       ]
+    },
+    describe_instance_credit_specifications: {
+      instance_credit_specifications: [
+        {
+          instance_id: 'i-ec12345a',
+          cpu_credits: 'unlimited'
+        }
+      ]
     }
   }
 }

data/lib/awspec/stub/emr.rb

@@ -0,0 +1,65 @@
+Aws.config[:emr] = {
+  stub_responses:  {
+    describe_cluster: {
+      cluster: {
+        name: 'my cluster',
+        log_uri: 's3n://aws-logs-232939870606-us-east-1/elasticmapreduce/',
+        applications: [
+          {
+            name: 'Spark',
+            version: '2.3.1',
+            args: [],
+            additional_info: {}
+          },
+          {
+            name: 'Hadoop',
+            version: '10.0.1',
+            args: [],
+            additional_info: {}
+          }
+        ],
+        tags: [{ key: 'Name', value: 'My Cluster' }],
+        status: {
+          state: 'RUNNING',
+          state_change_reason: {
+            code: '',
+            message: ''
+          },
+          timeline: {
+            creation_date_time: Time.parse('2018-10-29 22:41:38 -0400'),
+            ready_date_time: Time.parse('2018-10-29 22:41:38 -0400'),
+            end_date_time: nil
+          }
+        },
+        auto_scaling_role: 'EMR_AutoScaling_DefaultRole',
+        scale_down_behavior: 'TERMINATE_AT_TASK_COMPLETION',
+        ebs_root_volume_size: 30,
+        instance_collection_type: 'INSTANCE_FLEET',
+        security_configuration: 'sg-1828281-madeup',
+        master_public_dns_name: 'ec2-54-167-31-38.compute-1.amazonaws.com',
+        service_role: 'EMR_EC2_DefaultRole',
+        visible_to_all_users: false,
+        kerberos_attributes: {
+          realm: 'EXAMPLE.COM',
+          kdc_admin_password: 'password',
+          cross_realm_trust_principal_password: 'emr-password',
+          ad_domain_join_user: 'johny',
+          ad_domain_join_password: 'begood'
+        },
+        ec2_instance_attributes: {
+          ec2_key_name: 'my-key',
+          ec2_subnet_id: 'sb-0bfc9360',
+          requested_ec2_subnet_ids: [],
+          ec2_availability_zone: 'us-east-1a',
+          requested_ec2_availability_zones: [],
+          emr_managed_master_security_group: 'sg-0bfc9360',
+          emr_managed_slave_security_group: 'sg-0bfc9360',
+          service_access_security_group: 'sg-0bfc9360',
+          iam_instance_profile: 'EMR_EC2_DefaultRole',
+          additional_master_security_groups: [],
+          additional_slave_security_groups: []
+        }
+      }
+    }
+  }
+}

data/lib/awspec/stub/sns_topic.rb

@@ -0,0 +1,29 @@
+Aws.config[:sns] = {
+  stub_responses: {
+    get_topic_attributes: {
+      attributes: {
+        # rubocop:disable LineLength
+        'Policy'                  => '{\"Version\":\"2008-10-17\",\"Id\":\"__default_policy_ID\",\"Statement\":[{\"Sid\":\"__default_statement_ID\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"*\"},\"Action\":[\"SNS:GetTopicAttributes\",\"SNS:SetTopicAttributes\",\"SNS:AddPermission\",\"SNS:RemovePermission\",\"SNS:DeleteTopic\",\"SNS:Subscribe\",\"SNS:ListSubscriptionsByTopic\",\"SNS:Publish\",\"SNS:Receive\"],\"Resource\":\"arn:aws:sns:us-east-1:123456789:foobar-lambda-sample\",\"Condition\":{\"StringEquals\":{\"AWS:SourceOwner\":\"123456789\"}}}]}',
+        'Owner'                   => '123456789',
+        'SubscriptionsPending'    => '0',
+        'TopicArn'                => 'arn:aws:sns:us-east-1:123456789:foobar',
+        'EffectiveDeliveryPolicy' => '{\"http\":{\"defaultHealthyRetryPolicy\":{\"minDelayTarget\":20,\"maxDelayTarget\":20,\"numRetries\":3,\"numMaxDelayRetries\":0,\"numNoDelayRetries\":0,\"numMinDelayRetries\":0,\"backoffFunction\":\"linear\"},\"disableSubscriptionOverrides\":false}}',
+        'SubscriptionsConfirmed'  => '1',
+        'DisplayName'             => 'Useless',
+        'SubscriptionsDeleted'    => '0'
+      }
+    },
+    list_subscriptions_by_topic: {
+      subscriptions: [
+        {
+          subscription_arn: 'arn:aws:sns:us-east-1:123456789:Foobar:3dbf4999-b3e2-4345-bd11-c34c9784ecca',
+          owner: '123456789',
+          protocol: 'lambda',
+          endpoint: 'arn:aws:lambda:us-east-1:123456789:function:foobar',
+          topic_arn: 'arn:aws:sns:us-east-1:123456789:foobar'
+        }
+      ],
+      next_token: nil
+    }
+  }
+}

data/lib/awspec/type/ec2.rb

@@ -132,6 +132,11 @@ module Awspec::Type
       return true if ret
     end
 
+    def has_credit_specification?(cpu_credits)
+      ret = find_ec2_credit_specifications(id)
+      ret.cpu_credits == cpu_credits
+    end
+
     private
 
     def match_group_ids?(sg_ids)

data/lib/awspec/type/emr.rb

@@ -0,0 +1,40 @@
+module Awspec::Type
+  class Emr < ResourceBase
+    attr_reader :id
+
+    def initialize(id)
+      super
+      @id = id
+    end
+
+    def resource_via_client
+      @resource_via_client ||= find_emr_cluster(@id)
+    end
+
+    STARTING_STATES = %w(STARTING BOOTSTRAPPING)
+    READY_STATES = %w(RUNNING WAITING)
+    STATES = (READY_STATES + STARTING_STATES)
+
+    STATES.each do |state|
+      define_method state.downcase + '?' do
+        resource_via_client.status.state == state
+      end
+    end
+
+    def applications
+      resource_via_client.applications.map { |a| { name: a.name, version: a.version } }
+    end
+
+    def tags
+      resource_via_client.tags.map { |t| { t.key.to_sym => t.value } }
+    end
+
+    def ok?
+      READY_STATES.include?(resource_via_client.status.state)
+    end
+
+    alias_method :healthy?, :ok?
+    alias_method :ready?, :ok?
+    alias_method :bootstrapping?, :starting?
+  end
+end

data/lib/awspec/type/sns_topic.rb

@@ -0,0 +1,47 @@
+module Awspec::Type
+  class SnsTopic < ResourceBase
+    def initialize(topic_arn)
+      super
+      @topic_arn = topic_arn
+      # lazy instantiation
+      @subscriptions = nil
+    end
+
+    def subscriptions
+      @subscriptions.keys
+    end
+
+    def resource_via_client
+      @resource_via_client ||= find_sns_topic(@topic_arn)
+    end
+
+    def id
+      # A SNS Topic doesn't have an ID...
+      @id ||= resource_via_client.topic_arn if resource_via_client
+    end
+
+    def has_subscription?(subscribed_arn)
+      fetch_subscriptions
+      @subscriptions.key?(subscribed_arn.to_sym)
+    end
+
+    def subscribed(subscribed_arn)
+      subs_key = subscribed_arn.to_sym
+      fetch_subscriptions
+      raise "'#{subscribed_arn}' is not a valid subscription ARN" unless @subscriptions.key?(subs_key)
+      @subscriptions[subs_key]
+    end
+
+    def method_missing(method_name)
+      # delegates the method invocation to Awspec::Helper::Finder::SnsTopic::SnsTopic class
+      @resource_via_client.send method_name
+    end
+
+    private
+
+    def fetch_subscriptions
+      @subscriptions = find_sns_topic_subs(@topic_arn) if @subscriptions.nil?
+      @subscriptions
+    end
+  end
+end

data/lib/awspec/version.rb

@@ -1,3 +1,3 @@
 module Awspec
-  VERSION = '1.11.1'
+  VERSION = '1.12.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: awspec
 version: !ruby/object:Gem::Version
-  version: 1.11.1
+  version: 1.12.0
 platform: ruby
 authors:
 - k1LoW
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-10-29 00:00:00.000000000 Z
+date: 2018-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk
@@ -248,6 +248,7 @@ files:
 - doc/_resource_types/elasticsearch.md
 - doc/_resource_types/elastictranscoder_pipeline.md
 - doc/_resource_types/elb.md
+- doc/_resource_types/emr.md
 - doc/_resource_types/firehose.md
 - doc/_resource_types/iam_group.md
 - doc/_resource_types/iam_policy.md
@@ -275,6 +276,7 @@ files:
 - doc/_resource_types/security_group.md
 - doc/_resource_types/ses_identity.md
 - doc/_resource_types/ses_send_quota.md
+- doc/_resource_types/sns_topic.md
 - doc/_resource_types/sqs.md
 - doc/_resource_types/ssm_parameter.md
 - doc/_resource_types/subnet.md
@@ -336,6 +338,7 @@ files:
 - lib/awspec/generator/doc/type/elasticsearch.rb
 - lib/awspec/generator/doc/type/elastictranscoder_pipeline.rb
 - lib/awspec/generator/doc/type/elb.rb
+- lib/awspec/generator/doc/type/emr.rb
 - lib/awspec/generator/doc/type/firehose.rb
 - lib/awspec/generator/doc/type/iam_group.rb
 - lib/awspec/generator/doc/type/iam_policy.rb
@@ -363,6 +366,7 @@ files:
 - lib/awspec/generator/doc/type/security_group.rb
 - lib/awspec/generator/doc/type/ses_identity.rb
 - lib/awspec/generator/doc/type/ses_send_quota.rb
+- lib/awspec/generator/doc/type/sns_topic.rb
 - lib/awspec/generator/doc/type/sqs.rb
 - lib/awspec/generator/doc/type/ssm_parameter.rb
 - lib/awspec/generator/doc/type/subnet.rb
@@ -434,6 +438,7 @@ files:
 - lib/awspec/helper/finder/elasticsearch.rb
 - lib/awspec/helper/finder/elastictranscoder.rb
 - lib/awspec/helper/finder/elb.rb
+- lib/awspec/helper/finder/emr.rb
 - lib/awspec/helper/finder/firehose.rb
 - lib/awspec/helper/finder/iam.rb
 - lib/awspec/helper/finder/kinesis.rb
@@ -445,6 +450,7 @@ files:
 - lib/awspec/helper/finder/s3.rb
 - lib/awspec/helper/finder/security_group.rb
 - lib/awspec/helper/finder/ses.rb
+- lib/awspec/helper/finder/sns_topic.rb
 - lib/awspec/helper/finder/sqs.rb
 - lib/awspec/helper/finder/ssm_parameter.rb
 - lib/awspec/helper/finder/subnet.rb
@@ -482,9 +488,11 @@ files:
 - lib/awspec/matcher/have_record_set.rb
 - lib/awspec/matcher/have_route.rb
 - lib/awspec/matcher/have_rule.rb
+- lib/awspec/matcher/have_subscription_attributes.rb
 - lib/awspec/matcher/have_subscription_filter.rb
 - lib/awspec/matcher/have_tag.rb
 - lib/awspec/matcher/have_vpc_peering_connection.rb
+- lib/awspec/matcher/include_subscribed.rb
 - lib/awspec/resource_reader.rb
 - lib/awspec/setup.rb
 - lib/awspec/shared_context.rb
@@ -528,6 +536,7 @@ files:
 - lib/awspec/stub/elasticsearch.rb
 - lib/awspec/stub/elastictranscoder_pipeline.rb
 - lib/awspec/stub/elb.rb
+- lib/awspec/stub/emr.rb
 - lib/awspec/stub/firehose.rb
 - lib/awspec/stub/iam_group.rb
 - lib/awspec/stub/iam_policy.rb
@@ -552,6 +561,7 @@ files:
 - lib/awspec/stub/s3_bucket.rb
 - lib/awspec/stub/security_group.rb
 - lib/awspec/stub/ses_identity.rb
+- lib/awspec/stub/sns_topic.rb
 - lib/awspec/stub/sqs.rb
 - lib/awspec/stub/ssm_parameter.rb
 - lib/awspec/stub/subnet.rb
@@ -600,6 +610,7 @@ files:
 - lib/awspec/type/elasticsearch.rb
 - lib/awspec/type/elastictranscoder_pipeline.rb
 - lib/awspec/type/elb.rb
+- lib/awspec/type/emr.rb
 - lib/awspec/type/firehose.rb
 - lib/awspec/type/iam_group.rb
 - lib/awspec/type/iam_policy.rb
@@ -628,6 +639,7 @@ files:
 - lib/awspec/type/security_group.rb
 - lib/awspec/type/ses_identity.rb
 - lib/awspec/type/ses_send_quota.rb
+- lib/awspec/type/sns_topic.rb
 - lib/awspec/type/sqs.rb
 - lib/awspec/type/ssm_parameter.rb
 - lib/awspec/type/subnet.rb
@@ -656,7 +668,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 2.6.14
 signing_key: 
 specification_version: 4
 summary: RSpec tests for your AWS resources.