postageapp 1.2.5 → 1.4.0

data/lib/postageapp/cli/command/config.rb

@@ -0,0 +1,74 @@
+PostageApp::CLI::Command.define do
+  argument :'no-header',
+    optional: true,
+    boolean: true,
+    desc: 'An identifier to refer to this mailbox on subsequent API calls'
+
+  argument :markdown,
+    optional: true,
+    boolean: true,
+    desc: 'Emit markdown formatted description of variables'
+
+  perform do |arguments|
+    if (arguments[:markdown])
+      PostageApp::Configuration.params.each do |param, config|
+        case (default = config[:default])
+        when Proc
+          default = default.call
+        end
+
+        puts '* `%s`: %s (%s)' % [
+          param,
+          config[:desc],
+          case (config[:required])
+          when String
+            'required %s' % config[:required]
+          when true
+            'required'
+          else
+            default ? 'default: `%s`' % default : 'optional'
+          end
+        ]
+
+        config[:aliases]&.each do |param_alias|
+          puts '* `%s`: Alias for `%s`' % [
+            param_alias,
+            param
+          ]
+        end
+      end
+    else
+      unless (arguments[:'no-header'])
+        puts '%-40s %s' % [ 'Variable', 'Description' ]
+        puts '-' * 78
+      end
+  
+      PostageApp::Configuration.params.each do |param, config|
+        case (default = config[:default])
+        when Proc
+          default = default.call
+        end
+
+        puts '%-40s %s (%s)' % [
+          param,
+          config[:desc],
+          case (config[:required])
+          when String
+            'required %s' % config[:required]
+          when true
+            'required'
+          else
+            default ? 'default: %s' % default : 'optional'
+          end
+        ]
+
+        config[:aliases]&.each do |param_alias|
+          puts '%-40s Alias for %s' % [
+            param_alias,
+            param
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/postageapp/cli/command/create_mailbox.rb

@@ -0,0 +1,21 @@
+PostageApp::CLI::Command.define do
+  api_key :account
+
+  argument :uid,
+    optional: true,
+    desc: 'An identifier to refer to this mailbox on subsequent API calls'
+  argument :label,
+    optional: true,
+    desc: 'A descriptive name for this mailbox'
+  argument :host,
+    desc: 'IMAP server hostname'
+  argument :port,
+    optional: true,
+    desc: 'IMAP server port (default 993)'
+  argument :username,
+    desc: 'Username/email-address used to authenticate with the IMAP server'
+  argument :password,
+    desc: 'Password used to authenticate with the IMAP server'
+  argument :postback_url,
+    desc: 'The URL to post received email content to'
+end

data/lib/postageapp/cli/command/env.rb

@@ -0,0 +1,58 @@
+PostageApp::CLI::Command.define do
+  argument :'no-header',
+    optional: true,
+    boolean: true,
+    desc: 'Suppress display of header'
+
+  argument :markdown,
+    optional: true,
+    boolean: true,
+    desc: 'Emit markdown formatted description of variables'
+
+  perform do |arguments|
+    if (arguments[:markdown])
+      PostageApp::Configuration.params.each do |param, config|
+        config[:env_vars]&.each_with_index do |var, i|
+          case (i)
+          when 0
+            case (default = config[:default])
+            when Proc
+              default = default.call
+            end
+
+            puts '* `%s`: %s (%s)' % [
+              var,
+              config[:desc],
+              case (config[:required])
+              when String
+                'required %s' % config[:required]
+              when true
+                'required'
+              else
+                default ? 'default: `%s`' % default : 'optional'
+              end
+            ]
+          else
+            puts '* `%s`: Alias for `%s`' % [
+              var,
+              config[:env_vars][0]
+            ]
+          end
+        end
+      end
+    else
+      unless (arguments[:'no-header'])
+        puts '%-40s %s' % [ 'Variable', 'Setting' ]
+        puts '-' * 78
+      end
+  
+      PostageApp::Configuration.params.each do |param, config|
+        config[:env_vars]&.each do |var|
+          puts '%-40s %s' % [
+            var, ENV[var]
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/postageapp/cli/command/get_project_info.rb

@@ -0,0 +1,3 @@
+PostageApp::CLI::Command.define do
+  # No arguments required for this command
+end

data/lib/postageapp/configuration.rb

@@ -32,90 +32,294 @@
 # -------------
 # :proxy_host - Proxy server hostname
 # :proxy_port - Proxy server port
-# :proxy_user - Proxy server username
-# :proxy_pass - Proxy server password
+# :proxy_username - Proxy server username
+# :proxy_password - Proxy server password
 
 # Advanced Options
 # ----------------
 # :port - The port to make HTTP/HTTPS requests (default based on secure option)
-# :protocol - Set to either `http` or `https` (default based on secure option)
+# :scheme - Set to either `http` or `https` (default based on secure option)
 # :requests_to_resend - List of API calls that should be replayed if they fail.
 #                       (default: send_message)
 
 class PostageApp::Configuration
-  attr_accessor :secure
-  attr_writer :protocol
-  attr_accessor :host
-  attr_writer :port
-  attr_accessor :proxy_host
-  attr_accessor :proxy_port
-  attr_accessor :proxy_user
-  attr_accessor :proxy_pass
-  attr_accessor :http_open_timeout
-  attr_accessor :http_read_timeout
-  attr_accessor :recipient_override
-  attr_accessor :requests_to_resend
-  attr_accessor :project_root
-  attr_accessor :framework
-  attr_accessor :environment
-  attr_accessor :logger
-  
-  def initialize
-    @secure = true
-    @host = 'api.postageapp.com'
+  # == Constants ============================================================
+
+  SOCKS5_PORT_DEFAULT = 1080
+  HTTP_PORT_DEFAULT = 80
+  HTTPS_PORT_DEFAULT = 443
+
+  SCHEME_FOR_SECURE = {
+    true => 'https'.freeze,
+    false => 'http'.freeze
+  }.freeze
+
+  CONFIG_PARAMS = {
+    api_key: {
+      default: nil,
+      desc: 'Project API key to use',
+      required: 'for project API functions'
+    },
+    account_api_key: {
+      default: nil,
+      desc: 'Account API key to use',
+      required: 'for account API functions'
+    },
+    postback_secret: {
+      default: nil,
+      desc: 'Secret to use for validating ActionMailbox requests'
+    },
+    project_root: {
+      default: -> {
+        if (defined?(Rails) and Rails.respond_to?(:root))
+          Rails.root
+        else
+          Dir.pwd
+        end
+      },
+      desc: 'Project root for logging purposes'
+    },
+    recipient_override: {
+      default: nil,
+      interrogator: true,
+      desc: 'Override sender on `send_message` calls'
+    },
+    logger: {
+      default: nil,
+      env: false,
+      desc: 'Logger instance to use'
+    },
+    secure: {
+      default: true,
+      interrogator: true,
+      env: false,
+      after_set: -> (config) {
+        if (config.secure?)
+          config.protocol = 'https'
+          if (config.port == 80)
+            config.port = 443
+          end
+        else
+          config.protocol = 'http'
+          if (config.port == 443)
+            config.port = 80
+          end
+        end
+      },
+      desc: 'Enable verifying TLS connections'
+    },
+    verify_tls: {
+      default: true,
+      aliases: [ :verify_certificate ],
+      interrogator: true,
+      parse: -> (v) {
+        case (v)
+        when 'true', 'yes', 'on'
+          true
+        when String
+          v.to_i != 0
+        else
+          !!v
+        end
+      },
+      desc: 'Enable TLS certificate verification'
+    },
+    host: {
+      default: 'api.postageapp.com'.freeze,
+      desc: 'API host to contact'
+    },
+    port: {
+      default: 443,
+      desc: 'API port to contact'
+    },
+    scheme: {
+      default: 'https'.freeze,
+      aliases: [ :protocol ],
+      desc: 'HTTP scheme to use'
+    },
+    proxy_username: {
+      default: nil,
+      aliases: [ :proxy_user ],
+      desc: 'SOCKS5 proxy username'
+    },
+    proxy_password: {
+      default: nil,
+      aliases: [ :proxy_pass ],
+      desc: 'SOCKS5 proxy password'
+    },
+    proxy_host: {
+      default: nil,
+      desc: 'SOCKS5 proxy host'
+    },
+    proxy_port: {
+      default: 1080,
+      parse: -> (v) { v.to_i },
+      desc: 'SOCKS5 proxy port'
+    },
+    open_timeout: {
+      default: 5,
+      aliases: [ :http_open_timeout ],
+      parse: -> (v) { v.to_i },
+      desc: 'Timeout in seconds when initiating requests'
+    },
+    read_timeout: {
+      default: 10,
+      aliases: [ :http_read_timeout ],
+      parse: -> (v) { v.to_i },
+      desc: 'Timeout in seconds when awaiting responses'
+    },
+    retry_methods: {
+      default: %w[ send_message ].freeze,
+      aliases: [ :requests_to_resend ],
+      parse: -> (v) {
+        case (v)
+        when String
+          v.split(/\s*(?:,|\s)\s*/).grep(/\S/)
+        else
+          v
+        end
+      },
+      desc: 'Which API calls to retry, comma and/or space separated'
+    },
+    framework: {
+      default: -> {
+        if (defined?(Rails) and Rails.respond_to?(:version))
+          'Ruby %s / Ruby on Rails %s' % [
+            RUBY_VERSION,
+            Rails.version
+          ]
+        else
+          'Ruby %s' % RUBY_VERSION
+        end
+      },
+      desc: 'Framework used'
+    },
+    environment: {
+      default: 'production',
+      desc: 'Environment to use'
+    }
+  }.freeze
+
+  # == Properties ===========================================================
+
+  CONFIG_PARAMS.each do |param, config|
+    attr_reader param
+
+    ivar = config[:ivar] ||= :"@#{param}"
+    mutator_method = :"#{param}="
+    config[:sources] = [ param ]
+    after_set = config[:after_set]
+
+    if (parser = config[:parse])
+      define_method(mutator_method) do |v|
+        instance_variable_set(ivar, parser.call(v))
+      end
+    else
+      define_method(mutator_method) do |v|
+        instance_variable_set(ivar, v)
+
+        after_set and after_set[self]
+      end
+    end
+
+    interrogator_method = nil
+
+    if (config[:interrogator])
+      interrogator_method = :"#{param}?"
+      define_method(interrogator_method) do
+        !!instance_variable_get(ivar)
+      end
+    end
+
+    if (param_aliases = config[:aliases])
+      param_aliases.each do |param_alias|
+        config[:sources] << param_alias
 
-    @http_open_timeout = 5
-    @http_read_timeout = 10
+        alias_method param_alias, param
+        alias_method :"#{param_alias}=", mutator_method
 
-    @requests_to_resend = %w[ send_message ]
+        if (config[:interrogator])
+          alias_method :"#{param_alias}?", interrogator_method
+        end
+      end
+    end
 
-    @framework = 'Ruby'
+    unless (config[:env] === false)
+      config[:env_vars] = config[:sources].map do |source|
+        'POSTAGEAPP_' + source.to_s.upcase
+      end
+    end
 
-    @environment = 'production'
+    # config[:getters] = config[:sources].map do |source|
+    #   -> (credentials) { credentials[:source] }
+    # end + config[:env_vars].map do |var|
+    #   -> (_) { ENV[var] }
+    # end
   end
-  
-  alias_method :secure?, :secure
-  
-  # Assign which API key is used to make API calls. Can also be specified
-  # using the `POSTAGEAPP_API_KEY` environment variable.
-  def api_key=(key)
-    @api_key = key
+
+  # == Class Methods ========================================================
+
+  def self.params
+    CONFIG_PARAMS
   end
-  
-  # Returns the API key used to make API calls. Can be specified as the
-  # `POSTAGEAPP_API_KEY` environment variable.
-  def api_key
-    @api_key ||= ENV['POSTAGEAPP_API_KEY']
+
+  # == Instance Methods =====================================================
+
+  def initialize
+    credentials = self.rails_credentials
+
+    CONFIG_PARAMS.each do |param, config|
+      value = (
+        config[:sources]&.map { |s| credentials[s] }&.compact&.first ||
+        config[:env_vars]&.map { |v| ENV[v] }&.compact&.first
+      )
+
+      if (value)
+        if (config[:parse])
+          instance_variable_set(config[:ivar], config[:parse].call(value))
+        else
+          instance_variable_set(config[:ivar], value)
+        end
+      else
+        case (config[:default])
+        when Proc
+          instance_variable_set(config[:ivar], config[:default].call)
+        else
+          instance_variable_set(config[:ivar], config[:default])
+        end
+      end
+    end
   end
-  
-  # Returns the HTTP protocol used to make API calls
-  def protocol
-    @protocol ||= (secure? ? 'https' : 'http')
+
+  # Returns true if the port used for the API is the default port, otherwise
+  # false. 80 for HTTP, 443 for HTTPS.
+  def port_default?
+    self.port == (self.secure? ? HTTPS_PORT_DEFAULT : HTTP_PORT_DEFAULT)
   end
-  
-  # Returns the port used to make API calls
-  def port
-    @port ||= (secure? ? 443 : 80)
+
+  # Returns true if a proxy is defined, otherwise false.
+  def proxy?
+    self.proxy_host and self.proxy_host.match(/\A\S+\z/)
   end
-  
+
   # Returns the endpoint URL to make API calls
   def url
-    "#{self.protocol}://#{self.host}:#{self.port}"
+    '%s://%s%s' % [
+      self.scheme,
+      self.host,
+      self.port_default? ? '' : (':%d' % self.port)
+    ]
   end
 
-  # Returns a properly configured Net::HTTP connection
+  # Returns a connection aimed at the API endpoint
   def http
-    http = Net::HTTP::Proxy(
-      self.proxy_host,
-      self.proxy_port,
-      self.proxy_user,
-      self.proxy_pass
-    ).new(self.host, self.port)
-    
-    http.read_timeout = self.http_read_timeout
-    http.open_timeout = self.http_open_timeout
-    http.use_ssl = self.secure?
-
-    http
+    PostageApp::HTTP.connect(self)
+  end
+
+protected
+  def rails_credentials
+    if (PostageApp::Env.rails_with_encrypted_credentials?)
+      Rails.application.credentials.postageapp
+    end or { }
   end
 end