govdelivery-tms 0.8.0 → 0.8.1

data/Gemfile

@@ -3,7 +3,7 @@ gemspec
 
 group :development, :test do
   gem "appraisal"
-  gem 'rspec', '~> 2.99'
+  gem 'rspec', '~> 3.2.0'
   gem 'rspec-its'
   gem 'rake'
   gem 'redcarpet', :platform => :ruby

data/README.md

@@ -21,11 +21,11 @@ $ gem install govdelivery-tms
 
 Connecting
 ----------
-Loading an instance of `TMS::Client` will automatically connect to the API to query the available resources for your account.
+Loading an instance of `GovDelivery::TMS::Client` will automatically connect to the API to query the available resources for your account.
 
 ```ruby
 # default api root endpoint is https://tms.govdelivery.com
-client = TMS::Client.new('auth_token', :api_root => 'https://stage-tms.govdelivery.com')
+client = GovDelivery::TMS::Client.new('auth_token', :api_root => 'https://stage-tms.govdelivery.com')
 ```
 
 Messages
@@ -51,13 +51,13 @@ message.post             # true
 message.recipients.collection.detect{|r| r.errors } # {"phone"=>["is not a number"]}
 # save succeeded, but we have one bad recipient
 message.href             # "/messages/sms/87"
-message.get              # <TMS::SmsMessage href=/messages/sms/87 attributes={...}>
+message.get              # <GovDelivery::TMS::SmsMessage href=/messages/sms/87 attributes={...}>
 ```
 
 ### Retrieving Inbound SMS Messages
 ```ruby
-client.inbound_sms_messages.get                             # <TMS::InboundSmsMessages href=/inbound/sms attributes={...}>
-inbound_sms = client.inbound_sms_messages.collection.first  # <TMS::InboundSmsMessage href=/inbound/sms/10041 attributes={...}>
+client.inbound_sms_messages.get                             # <GovDelivery::TMS::InboundSmsMessages href=/inbound/sms attributes={...}>
+inbound_sms = client.inbound_sms_messages.collection.first  # <GovDelivery::TMS::InboundSmsMessage href=/inbound/sms/10041 attributes={...}>
 inbound_sms.to                                              # "+15559999999"
 inbound_sms.from                                            # "+15005550006"
 inbound_sms.attributes                                      # {:from=>"+15005550006", :to=>"+15559999999", :body=>"test", :command_status=>"success", :keyword_response=>"kwidjebo", :created_at=>"2014-11-05T17:15:01Z"}
@@ -76,7 +76,7 @@ message.post             # true
 message.recipients.collection.detect{|r| r.errors } # {"email"=>["can't be blank"]}
 # save succeeded, but we have one bad recipient
 message.href             # "/messages/email/87"
-message.get              # <TMS::EmailMessage href=/messages/email/88 attributes={...}>
+message.get              # <GovDelivery::TMS::EmailMessage href=/messages/email/88 attributes={...}>
 ```
 
 #### Sending an Email with Macros
@@ -256,11 +256,11 @@ Logging
 
 Any instance of a [Logger](http://www.ruby-doc.org/stdlib-1.9.3/libdoc/logger/rdoc/Logger.html "Ruby Logger")-like class can be passed in to the client; incoming and outgoing request information will then be logged to that instance.
 
-The example below configures `TMS::Client` to log to `STDOUT`:
+The example below configures `GovDelivery::TMS::Client` to log to `STDOUT`:
 
 ```ruby
 logger = Logger.new(STDOUT)
-client = TMS::Client.new('auth_token', :logger => logger)
+client = GovDelivery::TMS::Client.new('auth_token', :logger => logger)
 ```
 
 ActionMailer integration

data/govdelivery-tms.gemspec

@@ -1,10 +1,10 @@
 # -*- encoding: utf-8 -*-
 $:.push File.expand_path("../lib", __FILE__)
-require "govdelivery-tms/version"
+require "govdelivery/tms/version"
 
 Gem::Specification.new do |s|
   s.name        = "govdelivery-tms"
-  s.version     = TMS::VERSION
+  s.version     = GovDelivery::TMS::VERSION
   s.platform    = Gem::Platform::RUBY
   s.authors     = ["GovDelivery"]
   s.email       = ["support@govdelivery.com"]

data/lib/{govdelivery-tms → govdelivery/tms}/base.rb

@@ -1,11 +1,11 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   module Base
     def self.included(base)
-      base.send(:include, TMS::Util::HalLinkParser)
+      base.send(:include, GovDelivery::TMS::Util::HalLinkParser)
       base.extend(ClassMethods)
       base.send(:include, InstanceMethods)
-      base.send(:include, TMS::CoreExt)
-      base.send(:extend, TMS::CoreExt)
+      base.send(:include, GovDelivery::TMS::CoreExt)
+      base.send(:extend, GovDelivery::TMS::CoreExt)
     end
 
     attr_accessor :client, :href, :errors, :new_record

data/lib/{govdelivery-tms → govdelivery/tms}/client.rb

@@ -1,12 +1,12 @@
 require 'logger'
 # The client class to connect and talk to the TMS REST API.
-class TMS::Client
-  include TMS::Util::HalLinkParser
-  include TMS::CoreExt
+class GovDelivery::TMS::Client
+  include GovDelivery::TMS::Util::HalLinkParser
+  include GovDelivery::TMS::CoreExt
 
   attr_accessor :connection, :href, :api_root, :logger
 
-  DEFAULTS = {:api_root => 'https://tms.govdelivery.com', :logger => nil}.freeze
+  DEFAULTS = {api_root: 'https://tms.govdelivery.com', logger: nil}.freeze
 
   # Create a new client and issue a request for the available resources for a given account.
   #
@@ -30,7 +30,7 @@ class TMS::Client
   end
 
   def connect!(auth_token, options={})
-    self.connection = TMS::Connection.new({:auth_token => auth_token, :api_root => api_root, :logger => logger}.merge!(options))
+    self.connection = GovDelivery::TMS::Connection.new({auth_token: auth_token, api_root: api_root, logger: logger}.merge!(options))
   end
 
   def discover!
@@ -42,11 +42,11 @@ class TMS::Client
     response = raw_connection.get(href)
     case response.status
       when 500..599
-        raise TMS::Request::Error.new(response.status)
+        raise GovDelivery::TMS::Request::Error.new(response.status)
       when 401..499
-        raise TMS::Request::Error.new(response.status)
+        raise GovDelivery::TMS::Request::Error.new(response.status)
       when 202
-        raise TMS::Request::InProgress.new(response.body['message'])
+        raise GovDelivery::TMS::Request::InProgress.new(response.body['message'])
       else
         return response
     end
@@ -74,7 +74,7 @@ class TMS::Client
       when 200...299
         return response
       else
-        raise TMS::Request::Error.new(response.status)
+        raise GovDelivery::TMS::Request::Error.new(response.status)
     end
   end
 

data/lib/{govdelivery-tms → govdelivery/tms}/collection_resource.rb

@@ -1,10 +1,10 @@
-module TMS::CollectionResource
+module GovDelivery::TMS::CollectionResource
   def self.included(base)
     base.send(:include, InstanceMethods)
   end
 
   module InstanceMethods
-    include TMS::Base
+    include GovDelivery::TMS::Base
     attr_accessor :collection
 
     def initialize(client, href, items=nil)

data/lib/{govdelivery-tms → govdelivery/tms}/connection.rb

@@ -1,4 +1,4 @@
-class TMS::Connection
+class GovDelivery::TMS::Connection
   attr_accessor :auth_token, :api_root, :connection, :logger
 
   def get(href)
@@ -18,12 +18,12 @@ class TMS::Connection
   end
 
   def setup_connection
-    self.connection = Faraday.new(:url => self.api_root) do |faraday|
-      faraday.use TMS::Logger, self.logger if self.logger
+    self.connection = Faraday.new(url: self.api_root) do |faraday|
+      faraday.use GovDelivery::TMS::Logger, self.logger if self.logger
       faraday.request :json
       faraday.headers['X-AUTH-TOKEN'] = auth_token
       faraday.headers[:user_agent] = "GovDelivery Ruby TMS::Client #{TMS::VERSION}"
-      faraday.response :json, :content_type => /\bjson$/
+      faraday.response :json, content_type: /\bjson$/
       faraday.adapter :net_http
     end
   end

data/lib/{govdelivery-tms → govdelivery/tms}/errors.rb

@@ -1,4 +1,4 @@
-module TMS
+module GovDelivery::TMS
   module Request
 # The generic TMS error class
     class Error < StandardError

data/lib/govdelivery/tms/instance_resource.rb

@@ -0,0 +1,219 @@
+module GovDelivery::TMS::InstanceResource
+  def self.included(base)
+    base.send(:include, GovDelivery::TMS::Base)
+    base.extend(ClassMethods)
+    base.send(:include, InstanceMethods)
+  end
+
+  attr_accessor :response
+
+  module ClassMethods
+    ##
+    # Writeable attributes are sent on POST/PUT.
+    #
+    def writeable_attributes(*attrs)
+      @writeable_attributes ||= []
+      if attrs.any?
+        @writeable_attributes.map!(&:to_sym).concat(attrs).uniq! if attrs.any?
+        setup_attributes(@writeable_attributes, false)
+      end
+      @writeable_attributes
+    end
+
+    ##
+    # Linkable attributes are sent on POST/PUT.
+    #
+    def linkable_attributes(*attrs)
+      @linkable_attributes ||= []
+      if attrs.any?
+        @linkable_attributes.map!(&:to_sym).concat(attrs).uniq! if attrs.any?
+      end
+      @linkable_attributes
+    end
+
+    ##
+    # Readonly attributes don't get POSTed.
+    # (timestamps are included by default)
+    #
+    def readonly_attributes(*attrs)
+      @readonly_attributes ||= [:created_at, :updated_at, :completed_at]
+      if attrs.any?
+        @readonly_attributes.map!(&:to_sym).concat(attrs).uniq!
+        setup_attributes(@readonly_attributes, true)
+      end
+      @readonly_attributes
+    end
+
+    ##
+    # For collections that are represented as attributes (i.e. inline, no href)
+    #
+    # @example
+    #     collection_attributes :recipients
+    #
+    def collection_attributes(*attrs)
+      @collection_attributes ||= []
+      if attrs.any?
+        @collection_attributes.map!(&:to_sym).concat(attrs).uniq!
+        @collection_attributes.each { |a| setup_collection(a) }
+      end
+      @collection_attributes
+    end
+
+    def custom_class_names
+      @custom_class_names ||= {}
+    end
+
+    ##
+    # For collections that are represented as attributes (i.e. inline, no href)
+    # and that have a class name other than the one we would infer.
+    #
+    # @example
+    #    collection_attributes :recipients, 'EmailRecipient'
+    #
+    def collection_attribute(attr, tms_class)
+      @collection_attributes ||= []
+      @collection_attributes.push(attr).uniq!
+      setup_collection(attr, GovDelivery::TMS.const_get(tms_class))
+    end
+
+    ##
+    # Read-only collection attributes don't get POSTed.
+    # Use this for collections that are represented as attributes, but cannot be modified.
+    #
+    # @example
+    #      readonly_collection_attribute :opens
+    #
+    def readonly_collection_attribute(attr, tms_class)
+      @readonly_collection_attributes ||= []
+      @readonly_collection_attributes.push(attr).uniq!
+      setup_collection(attr, GovDelivery::TMS.const_get(tms_class))
+    end
+
+    def setup_attributes(attrs, readonly=false)
+      attrs.map(&:to_sym).each do |property|
+        self.send :define_method, :"#{property}=", &lambda { |v| @attributes[property] = v } unless readonly
+        self.send :define_method, property.to_sym, &lambda { @attributes[property] }
+      end
+    end
+
+    def setup_collection(property, klass=nil)
+      if klass
+        custom_class_names[property] = klass
+      else
+        klass ||= GovDelivery::TMS.const_get(property.to_s.capitalize)
+      end
+
+      self.send :define_method, property.to_sym, &lambda { @attributes[property] ||= klass.new(self.client, nil, nil) }
+    end
+  end
+
+  module InstanceMethods
+    attr_reader :links
+
+    def initialize(client, href=nil, attrs=nil)
+      super(client, href)
+      @attributes = {}
+      @links = {}
+      set_attributes_from_hash(attrs) if attrs
+    end
+
+    def attributes
+      @attributes
+    end
+
+    def get
+      raise GovDelivery::TMS::Errors::InvalidGet if self.new_record?
+      process_response(client.get(self.href), :get) && self
+    end
+    alias_method :get!, :get
+
+    def post
+      self.errors = nil
+      process_response(client.post(self), :post)
+    end
+
+    def post!
+      self.post or raise GovDelivery::TMS::Errors::InvalidPost.new(self)
+    end
+
+    def put
+      process_response(client.put(self), :put)
+    end
+
+    def put!
+      process_response(client.put(self), :put) or raise GovDelivery::TMS::Errors::InvalidPut.new(self)
+    end
+
+    def delete
+      process_response(client.delete(self.href), :delete)
+    end
+
+    def delete!
+      process_response(client.delete(self.href), :delete) or raise GovDelivery::TMS::Errors::InvalidDelete.new(self)
+    end
+
+    def to_s
+      "<#{self.class.inspect}#{' href=' + self.href if self.href} attributes=#{@attributes.inspect}>"
+    end
+
+    def to_json
+      json_hash = {}
+      self.class.writeable_attributes.each do |attr|
+        json_hash[attr] = self.send(attr)
+      end
+      self.class.collection_attributes.each do |coll|
+        json_hash[coll] = self.send(coll).to_json
+      end
+      self.class.linkable_attributes.each do |attr|
+        json_hash[:_links] ||= {}
+        json_hash[:_links][attr] = @links[attr]
+      end
+      json_hash
+    end
+
+    protected
+
+    def relation_class(rel)
+      self.class.custom_class_names[rel.to_sym] || super
+    end
+
+    def process_response(response, method)
+      self.response = response
+      error_class   = GovDelivery::TMS::Errors.const_get("Invalid#{method.to_s.capitalize}")
+      case response.status
+        when 204
+          return true
+        when 200..299
+          set_attributes_from_hash(response.body) if response.body.is_a?(Hash)
+          @links = {}
+          self.new_record=false
+          return true
+        when 401
+          raise error_class.new("401 Not Authorized")
+        when 404
+          raise(error_class.new("Can't POST to #{self.href}"))
+        when 500..599
+          raise(GovDelivery::TMS::Errors::ServerError.new(response))
+        else # 422?
+          if response.body['errors']
+            self.errors = response.body['errors']
+          end
+      end
+      return false
+    end
+
+    def set_attributes_from_hash(hash)
+      hash.reject { |k, _| k=~/^_/ }.each do |property, value|
+        if self.class.collection_attributes.include?(property.to_sym)
+          klass                        = self.class.custom_class_names[property] || GovDelivery::TMS.const_get(property.to_s.capitalize)
+          @attributes[property.to_sym] = klass.new(client, nil, value)
+        else
+          @attributes[property.to_sym] = value
+        end
+      end
+      self.errors = hash['errors']
+      parse_links(hash['_links'])
+    end
+
+  end
+end

data/lib/{govdelivery-tms → govdelivery/tms}/logger.rb

@@ -1,4 +1,4 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   class Logger < Faraday::Response::Middleware #:nodoc:
     extend Forwardable
 

data/lib/{govdelivery-tms → govdelivery/tms}/mail/delivery_method.rb

@@ -1,7 +1,7 @@
 require 'govdelivery-tms'
 require 'mail'
 require 'mail/check_delivery_params'
-module TMS
+module GovDelivery::TMS
   module Mail
     # Use TMS from the mail gem or ActionMailer as a delivery method.
     #
@@ -24,7 +24,7 @@ module TMS
       attr_accessor :settings
 
       def deliver!(mail)
-        raise TMS::Errors::NoRelation.new('email_messages', client) unless client.respond_to?(:email_messages)
+        raise GovDelivery::TMS::Errors::NoRelation.new('email_messages', client) unless client.respond_to?(:email_messages)
 
         envelope_from = mail.return_path || mail.sender || mail.from_addrs.first
 
@@ -38,26 +38,26 @@ module TMS
                end.decoded
 
         tms_message = client.email_messages.build(
-          :from_name => mail[:from].display_names.first,
-          :subject => mail.subject,
-          :body => body
+          from_name: mail[:from].display_names.first,
+          subject: mail.subject,
+          body: body
         )
 
-        mail.to.each { |recip| tms_message.recipients.build(:email => recip) }
+        mail.to.each { |recip| tms_message.recipients.build(email: recip) }
         tms_message.post!
         tms_message
       end
 
       def client
-        @client ||= TMS::Client.new(settings[:auth_token], settings)
+        @client ||= GovDelivery::TMS::Client.new(settings[:auth_token], settings)
       end
     end
   end
 end
 
 if defined?(ActionMailer)
-  ActionMailer::Base.add_delivery_method :govdelivery_tms, TMS::Mail::DeliveryMethod, {
-    :auth_token => nil,
-    :logger => ActionMailer::Base.logger,
-    :api_root => TMS::Client::DEFAULTS[:api_root]}
+  ActionMailer::Base.add_delivery_method :govdelivery_tms, GovDelivery::TMS::Mail::DeliveryMethod, {
+    auth_token: nil,
+    logger: ActionMailer::Base.logger,
+    api_root: GovDelivery::TMS::Client::DEFAULTS[:api_root]}
 end

data/lib/govdelivery/tms/resource/collections.rb

@@ -0,0 +1,98 @@
+class GovDelivery::TMS::Emails
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::SmsMessages
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::EmailMessages
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::Recipients
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::EmailRecipients
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::EmailRecipientOpens
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::EmailRecipientClicks
+  include GovDelivery::TMS::CollectionResource
+end
+
+# A collection of Keyword objects.
+#
+# @example
+#    keywords = client.keywords.get
+#
+class GovDelivery::TMS::Keywords
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::InboundSmsMessages
+  include GovDelivery::TMS::CollectionResource
+end
+
+# A collection of CommandType instances.
+# This resource changes infrequently.  It may be used to dynamically construct a
+# user interface for configuring arbitrary SMS keywords for an account.
+#
+# This resource is read-only.
+#
+# @example
+#    client.command_types.get
+#    client.command_types.collection.each {|at| ... }
+class GovDelivery::TMS::CommandTypes
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::Commands
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::CommandActions
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::IpawsEventCodes
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::IpawsCategories
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::IpawsResponseTypes
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::IpawsAlerts
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::IpawsNwemAreas
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::Webhooks
+  include GovDelivery::TMS::CollectionResource
+end
+
+# A collection of Email Template objects.
+#
+# @example
+#    email_template = client.email_template.get
+#
+class GovDelivery::TMS::EmailTemplates
+  include GovDelivery::TMS::CollectionResource
+end
+
+class GovDelivery::TMS::FromAddresses
+  include GovDelivery::TMS::CollectionResource
+end

data/lib/{govdelivery-tms → govdelivery/tms}/resource/command.rb

@@ -1,11 +1,11 @@
-module TMS #:nodoc:
-  # A command is a combination of behavior and parameters that should be executed 
+module GovDelivery::TMS #:nodoc:
+  # A command is a combination of behavior and parameters that should be executed
   # when an incoming SMS message matches the associated Keyword.
   #
-  # @attr name [String] The name of the command.  This will default to the command_type if not supplied. 
-  # @attr command_type [String] The type of this command.  A list of valid types can be found by querying the CommandType list. 
-  # @attr params [Hash] A Hash of string/string pairs used as configuration for this command.  
-  # 
+  # @attr name [String] The name of the command.  This will default to the command_type if not supplied.
+  # @attr command_type [String] The type of this command.  A list of valid types can be found by querying the CommandType list.
+  # @attr params [Hash] A Hash of string/string pairs used as configuration for this command.
+  #
   # @example
   #    command = keyword.commands.build(:name => "subscribe to news", :command_type => "dcm_subscribe", :dcm_account_code => "NEWS", :dcm_topic_codes => "NEWS_1, NEWS_2")
   #    command.post
@@ -17,7 +17,7 @@ module TMS #:nodoc:
 
     # @!parse attr_accessor :name, :command_type, :params
     writeable_attributes :name, :command_type, :params
-    
+
     # @!parse attr_reader :created_at, :updated_at
     readonly_attributes :created_at, :updated_at
 

data/lib/{govdelivery-tms → govdelivery/tms}/resource/command_action.rb

@@ -1,4 +1,4 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   # CommandAction object represent the results of Commands for a particular input (e.g. an incoming SMS message)
   #
   # This resource is read-only.

data/lib/{govdelivery-tms → govdelivery/tms}/resource/command_type.rb

@@ -1,4 +1,4 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   # CommandType is a pair of values (name, string_fields, array_fields) that can be attached
   # to a Keyword (in a Command object).
   #

data/lib/{govdelivery-tms → govdelivery/tms}/resource/email_message.rb

@@ -1,4 +1,4 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   # An EmailMessage is used to create and send a email to a collection of EmailRecipient
   # objects.  Certain metrics are available after the email is sent, including
   # the collection of recipients who clicked or opened the email.

data/lib/{govdelivery-tms → govdelivery/tms}/resource/email_recipient.rb

@@ -1,4 +1,4 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   # An EmailRecipient is used in conjunction with an EmailMessage to send email.
   #
   # @attr email [String] The recipient email address

data/lib/{govdelivery-tms → govdelivery/tms}/resource/email_recipient_click.rb

@@ -1,4 +1,4 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   class EmailRecipientClick
     include InstanceResource
 

data/lib/{govdelivery-tms → govdelivery/tms}/resource/email_recipient_open.rb

@@ -1,4 +1,4 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   class EmailRecipientOpen
     include InstanceResource
 

data/lib/{govdelivery-tms → govdelivery/tms}/resource/email_template.rb

@@ -1,4 +1,4 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   class EmailTemplate
     include InstanceResource
 

data/lib/{govdelivery-tms → govdelivery/tms}/resource/from_address.rb

@@ -1,4 +1,4 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   class FromAddress
     include InstanceResource
 

data/lib/{govdelivery-tms → govdelivery/tms}/resource/inbound_sms_message.rb

@@ -1,4 +1,4 @@
-module TMS #:nodoc:
+module GovDelivery::TMS #:nodoc:
   class InboundSmsMessage
     include InstanceResource
     

data/lib/{govdelivery-tms → govdelivery/tms}/resource/ipaws_acknowledgement.rb

@@ -1,4 +1,4 @@
-module TMS
+module GovDelivery::TMS
   class IpawsAcknowledgement
 
     include InstanceResource

data/lib/{govdelivery-tms → govdelivery/tms}/resource/ipaws_alert.rb

@@ -1,4 +1,4 @@
-module TMS
+module GovDelivery::TMS
   class IpawsAlert
 
     include InstanceResource