sendgrid4r 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f63d8884d3b1ca8b9eb7091d85b912efa8bf4560
-  data.tar.gz: 3561561011662deb924811afc9b171d574b075e2
+  metadata.gz: f8127a4d5294077d6b12ed4f655dc6781a931f96
+  data.tar.gz: fd2478d82a6423d5dcb2e783407c114f546d9f5a
 SHA512:
-  metadata.gz: b9c8576c472b175ed404c66c47d2582191166e6c577fe490309c9342afb9916361b6914286ff478a177414293af4df1f9f8ab631e2ec438ba9cbc185a2f96fcd
-  data.tar.gz: 0705ed5391a47a46014cd88f26ad5101331c97576dc2535ca31ea2616bf23feb00f161304843a210d17dfa14b9a46a39c30e9a6f7441f6883709dddd16b12b67
+  metadata.gz: 9fc84962129b6444f935727954c8bfa6434e6a174f5490d2f062242c0da985101d92c6d5d09c21b3c6f7b05db040072117f82a1cf01e08293bc67d37a6251527
+  data.tar.gz: 58effad12a4cdf569e1dcc7b7e26642e03523193d934f78fb743ec1544e35844a9bc1888106900830f9ffa57ab0d384c5f391e8d03e776c03a48e72ced664e83

data/.rubocop.yml

@@ -31,4 +31,4 @@ ClassAndModuleChildren:
 # Change limitation of the class length
 ClassLength:
   CountComments: false  # count full line comments?
-  Max: 160
+  Max: 180

data/README.md

@@ -1,7 +1,8 @@
 # Sendgrid4r
 
 This gem allows you to quickly and easily access to SendGrid Web API v3 for Ruby.
-See [api reference](https://sendgrid.com/docs/API_Reference/Web_API_v3/index.html) for more detail
+See [api reference](https://sendgrid.com/docs/API_Reference/Web_API_v3/index.html) for more details.
+Also this gem provides `sg` command. `sg` is the command line interface to access SendGrid APIs. See [Command line interface Usage](Cli) for more details.
 
 [![Build Status](https://travis-ci.org/awwa/sendgrid4r.svg?branch=master)](https://travis-ci.org/awwa/sendgrid4r)
 [![Gem Version](https://badge.fury.io/rb/sendgrid4r.svg)](https://badge.fury.io/rb/sendgrid4r)

data/lib/sendgrid4r/cli/alert.rb

@@ -0,0 +1,51 @@
+module SendGrid4r::CLI
+  #
+  # SendGrid Web API v3 Alert
+  #
+  class Alert < SgThor
+    desc 'list', 'List alerts'
+    def list
+      puts @client.get_alerts
+    rescue RestClient::ExceptionWithResponse => e
+      puts e.inspect
+    end
+
+    desc 'create', 'Create an alert'
+    option :type, banner: '[stats_notification|usage_limit]', require: true
+    option :email_to, require: true
+    option :percentage, type: :numeric
+    option :frequency, banner: '[daily|weekly|monthly]'
+    def create
+      puts @client.post_alert(parameterise(options))
+    rescue RestClient::ExceptionWithResponse => e
+      puts e.inspect
+    end
+
+    desc 'get', 'Get an alert'
+    option :alert_id, type: :numeric, require: true
+    def get
+      puts @client.get_alert(parameterise(options))
+    rescue RestClient::ExceptionWithResponse => e
+      puts e.inspect
+    end
+
+    desc 'delete', 'Delete an alert'
+    option :alert_id, type: :numeric, require: true
+    def delete
+      puts @client.delete_alert(parameterise(options))
+    rescue RestClient::ExceptionWithResponse => e
+      puts e.inspect
+    end
+
+    desc 'update', 'Update an alert'
+    option :alert_id, type: :numeric, require: true
+    option :email_to, require: true
+    option :percentage, type: :numeric
+    option :frequency, banner: '[daily|weekly|monthly]'
+    def update
+      puts @client.patch_alert(parameterise(options))
+    rescue RestClient::ExceptionWithResponse => e
+      puts e.inspect
+    end
+  end
+end

data/lib/sendgrid4r/cli/campaign/campaign.rb

@@ -83,7 +83,7 @@ module SendGrid4r::CLI
 
       desc 'schedule', 'Schedule a campaign'
       option :campaign_id, type: :numeric, require: true
-      option :send_at, type: :numeric, require: true
+      option :send_at, banner: SgThor::UTS, type: :numeric, require: true
       def schedule
         puts @client.schedule_campaign(parameterise(options))
       rescue RestClient::ExceptionWithResponse => e
@@ -92,7 +92,7 @@ module SendGrid4r::CLI
 
       desc 'reschedule', 'Reschedule a campaign'
       option :campaign_id, type: :numeric, require: true
-      option :send_at, type: :numeric, require: true
+      option :send_at, banner: SgThor::UTS, type: :numeric, require: true
       def reschedule
         puts @client.reschedule_campaign(parameterise(options))
       rescue RestClient::ExceptionWithResponse => e

data/lib/sendgrid4r/cli/campaign/contact/custom_field.rb

@@ -7,7 +7,7 @@ module SendGrid4r::CLI
       class CustomField < SgThor
         desc 'create', 'Create a custom field'
         option :name, require: true
-        option :type, require: true
+        option :type, banner: SgThor::TYP, require: true
         def create
           puts @client.post_custom_field(parameterise(options))
         rescue RestClient::ExceptionWithResponse => e

data/lib/sendgrid4r/cli/campaign/contact/list.rb

@@ -45,7 +45,7 @@ module SendGrid4r::CLI
           puts e.inspect
         end
 
-        desc 'recipient', 'Add, Remove, List a recipient'
+        desc 'recipient [add|remove|list]', 'Add, Remove, List a recipient'
         option :list_id, type: :numeric, require: true
         option :recipients, type: :array, desc: 'for add action'
         option :recipient_id, desc: 'for remove action'

data/lib/sendgrid4r/cli/campaign/contact/recipient.rb

@@ -34,8 +34,8 @@ module SendGrid4r::CLI
         end
 
         desc 'list', 'List recipients'
-        option :page
-        option :page_size
+        option :page, type: :numeric
+        option :page_size, type: :numeric
         def list
           puts @client.get_recipients(parameterise(options))
         rescue RestClient::ExceptionWithResponse => e

data/lib/sendgrid4r/cli/campaign/contact/segment.rb

@@ -14,7 +14,12 @@ module SendGrid4r::CLI
         desc 'create', 'Create a segment'
         option :name, require: true
         option :list_id, type: :numeric, require: true
-        option :conditions, type: :array, require: true
+        option(
+          :conditions,
+          type: :array,
+          require: true,
+          banner: 'field:email,value:abc@abc.abc,operator:eq,and_or:'
+        )
         def create
           conditions = options[:conditions].map do |c|
             array = c.delete(' ').split(/[:,]/)
@@ -51,7 +56,11 @@ module SendGrid4r::CLI
         desc 'update', 'Update a segment'
         option :segment_id, require: true
         option :name
-        option :conditions, type: :array
+        option(
+          :conditions,
+          type: :array,
+          banner: 'field:email,value:abc@abc.abc,operator:eq,and_or:'
+        )
         def update
           conditions = options[:conditions].map do |c|
             array = c.delete(' ').split(/[:,]/)
@@ -80,7 +89,7 @@ module SendGrid4r::CLI
           puts e.inspect
         end
 
-        desc 'recipient', 'List recipients'
+        desc 'recipient [list]', 'List recipients'
         option :segment_id, require: true
         def recipient(action)
           case action

data/lib/sendgrid4r/cli/ipam/whitelist.rb

@@ -20,7 +20,7 @@ module SendGrid4r::CLI
       end
 
       desc 'delete', 'Delete Whitelisted IPs'
-      option :ids, type: :array
+      option :ids, type: :array, require: true
       def delete
         puts @client.delete_whitelisted_ips(parameterise(options))
       rescue RestClient::ExceptionWithResponse => e

data/lib/sendgrid4r/cli/settings/enforced_tls.rb

@@ -12,8 +12,8 @@ module SendGrid4r::CLI
       end
 
       desc 'update', 'Change the Enforced TLS settings'
-      option :require_tls
-      option :require_valid_cert
+      option :require_tls, type: :boolean
+      option :require_valid_cert, type: :boolean
       def update
         puts @client.patch_enforced_tls(params: parameterise(options))
       rescue RestClient::ExceptionWithResponse => e

data/lib/sendgrid4r/cli/settings/mail.rb

@@ -13,7 +13,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'whitelist', 'Get, Enable and Disable address whitelist settings'
+      desc(
+        'whitelist [get|enable|disable]',
+        'Get, Enable and Disable address whitelist settings'
+      )
       option :list, type: :array
       def whitelist(action)
         case action
@@ -30,7 +33,7 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'bcc', 'Get, Enable and Disable bcc settings'
+      desc 'bcc [get|enable|disable]', 'Get, Enable and Disable bcc settings'
       option :email
       def bcc(action)
         case action
@@ -47,7 +50,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'bounce_purge', 'Get, Enable and Disable bounce purge settings'
+      desc(
+        'bounce_purge [get|enable|disable]',
+        'Get, Enable and Disable bounce purge settings'
+      )
       option :hard_bounces, type: :numeric
       option :soft_bounces, type: :numeric
       def bounce_purge(action)
@@ -65,7 +71,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'footer', 'Get, Enable and Disable footer settings'
+      desc(
+        'footer [get|enable|disable]',
+        'Get, Enable and Disable footer settings'
+      )
       option :html_content
       option :plain_content
       def footer(action)
@@ -83,7 +92,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'forward_bounce', 'Get, Enable and Disable forward bounce settings'
+      desc(
+        'forward_bounce [get|enable|disable]',
+        'Get, Enable and Disable forward bounce settings'
+      )
       option :email
       def forward_bounce(action)
         case action
@@ -100,7 +112,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'forward_spam', 'Get, Enable and Disable forward spam settings'
+      desc(
+        'forward_spam [get|enable|disable]',
+        'Get, Enable and Disable forward spam settings'
+      )
       option :email
       def forward_spam(action)
         case action
@@ -117,7 +132,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'spam_check', 'Get, Enable and Disable spam check settings'
+      desc(
+        'spam_check [get|enable|disable]',
+        'Get, Enable and Disable spam check settings'
+      )
       option :url
       option :max_score
       def spam_check(action)
@@ -135,7 +153,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'template', 'Get, Enable and Disable template settings'
+      desc(
+        'template [get|enable|disable]',
+        'Get, Enable and Disable template settings'
+      )
       option :html_content
       def template(action)
         case action
@@ -152,7 +173,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'plain_content', 'Get, Enable and Disable plain content settings'
+      desc(
+        'plain_content [get|enable|disable]',
+        'Get, Enable and Disable plain content settings'
+      )
       def plain_content(action)
         case action
         when 'get'

data/lib/sendgrid4r/cli/settings/partner.rb

@@ -13,7 +13,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'new_relic', 'Get, Enable and Disable new relic settings'
+      desc(
+        'new_relic [get|enable|disable]',
+        'Get, Enable and Disable new relic settings'
+      )
       option :license_key
       def new_relic(action)
         case action

data/lib/sendgrid4r/cli/settings/tracking.rb

@@ -13,7 +13,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'click', 'Get, Enable and Disable click tracking settings'
+      desc(
+        'click [get|enable|disable]',
+        'Get, Enable and Disable click tracking settings'
+      )
       def click(action)
         case action
         when 'get'
@@ -28,7 +31,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'ganalytics', 'Get, Enable and Disable google analytics settings'
+      desc(
+        'ganalytics [get|enable|disable]',
+        'Get, Enable and Disable google analytics settings'
+      )
       option :utm_source
       option :utm_medium
       option :utm_term
@@ -49,7 +55,10 @@ module SendGrid4r::CLI
         puts e.inspect
       end
 
-      desc 'open', 'Get, Enable and Disable open tracking settings'
+      desc(
+        'open [get|enable|disable]',
+        'Get, Enable and Disable open tracking settings'
+      )
       def open(action)
         case action
         when 'get'
@@ -65,7 +74,7 @@ module SendGrid4r::CLI
       end
 
       desc(
-        'subscription',
+        'subscription [get|enable|disable]',
         'Get, Enable and Disable subscription tracking settings'
       )
       option :landing

data/lib/sendgrid4r/cli/sg.rb

@@ -5,26 +5,35 @@ module SendGrid4r::CLI
   class SG < Thor
     map %w(--version -v) => :print_version
 
-    desc '--version, -v', 'print the version'
+    desc '--version, -v', 'Print the version'
     def print_version
       puts SendGrid4r::VERSION
     end
 
+    desc('alert SUBCOMMAND ...ARGS', 'Manage alert settings')
+    subcommand('alert', Alert)
+
     desc('api_key SUBCOMMAND ...ARGS', 'Manage API keys')
     subcommand('api_key', ApiKeys::ApiKey)
 
+    desc('campaign SUBCOMMAND ...ARGS', 'Manage Marketing Campaigns')
+    subcommand('campaign', Campaign::Campaign)
+
     desc('cancel_schedule SUBCOMMAND ...ARGS', 'Manage canceling schedule send')
     subcommand('cancel_schedule', CancelSchedules::CancelSchedule)
 
-    desc('ip SUBCOMMAND ...ARGS', 'Manage ips')
-    subcommand('ip', Ips::Ip)
-
     desc('ipam SUBCOMMAND ...ARGS', 'Manage ip access')
     subcommand('ipam', Ipam::Ipam)
 
+    desc('ip SUBCOMMAND ...ARGS', 'Manage ips')
+    subcommand('ip', Ips::Ip)
+
     desc('settings SUBCOMMAND ...ARGS', 'Manage settings')
     subcommand('settings', Settings::Settings)
 
+    desc('stats SUBCOMMAND ...ARGS', 'Get account statistics')
+    subcommand('stats', Stats::Stats)
+
     desc('subuser SUBCOMMAND ...ARGS', 'Manage subuser')
     subcommand('subuser', Subusers::Subuser)
 
@@ -43,13 +52,10 @@ module SendGrid4r::CLI
     desc('category SUBCOMMAND ...ARGS', 'Manage categories')
     subcommand('category', Category)
 
-    desc('user SUBCOMMAND ...ARGS', 'Manage user')
-    subcommand('user', User)
-
-    desc('campaign SUBCOMMAND ...ARGS', 'Manage Marketing Campaigns')
-    subcommand('campaign', Campaign::Campaign)
-
     desc('mail SUBCOMMAND ...ARGS', 'Send mail')
     subcommand('mail', Mail)
+
+    desc('user SUBCOMMAND ...ARGS', 'Manage user')
+    subcommand('user', User)
   end
 end

data/lib/sendgrid4r/cli/sg_thor.rb

@@ -3,15 +3,29 @@ module SendGrid4r::CLI
   # SendGrid Web API v3 SgThor
   #
   class SgThor < Thor
-    class_option :api_key, desc: 'API Key'
-    class_option :user, desc: 'SendGrid username for Basic Auth'
-    class_option :pass, desc: 'SendGrid password for Basic Auth'
+    ISO = 'YYYY-MM-DD'
+    UTS = 'UNIX TIMESTAMP'
+    AGG = '[day|week|month]'
+    DIR = '[desc|asc]'
+    TYP = '[date|text|number]'
+
+    class_option :api_key, aliases: '-k', desc: 'API Key for APIKey Auth'
+    class_option :user, aliases: '-u', desc: 'Username for Basic Auth'
+    class_option :pass, aliases: '-p', desc: 'Password for Basic Auth'
+    class_option(
+      :envkey,
+      aliases: '-e',
+      desc: 'Load API Key from environment variable "SG_API_KEY"',
+      banner: ''
+    )
 
     def initialize(*args)
       super
+      api_key = options[:api_key]
+      api_key = ENV['SG_API_KEY'] if options[:envkey]
       @client = SendGrid4r::Client.new(
         username: options[:user], password: options[:pass],
-        api_key: options[:api_key], raw_response: true
+        api_key: api_key, raw_response: true
       )
     end
 
@@ -22,13 +36,15 @@ module SendGrid4r::CLI
       params = options.each_with_object({}) do |(k, v), memo|
         memo[k.to_s.to_sym] = v
       end
-      # remove auth info
-      params.delete(:api_key)
-      params.delete(:user)
-      params.delete(:pass)
-      # remove empty key and value
-      params.delete_if { |_k, v| v.nil? }
-      params
+      params.tap do |p|
+        # remove auth info
+        p.delete(:api_key)
+        p.delete(:user)
+        p.delete(:pass)
+        p.delete(:envkey)
+        # remove empty key and value
+        p.delete_if { |_k, v| v.nil? }
+      end
     end
   end
 end

data/lib/sendgrid4r/cli/stats/advanced.rb

@@ -5,10 +5,10 @@ module SendGrid4r::CLI
     #
     class Advanced < SgThor
       desc 'geo', 'Gets email statistics by country and state/province'
-      option :start_date, require: true
-      option :end_date
-      option :aggregated_by
-      option :country
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
+      option :aggregated_by, banner: SgThor::AGG
+      option :country, banner: '[US|CA]'
       def geo
         puts @client.get_geo_stats(parameterise(options))
       rescue RestClient::ExceptionWithResponse => e
@@ -16,9 +16,9 @@ module SendGrid4r::CLI
       end
 
       desc 'device', 'Gets email statistics by device type'
-      option :start_date, require: true
-      option :end_date
-      option :aggregated_by
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
+      option :aggregated_by, banner: SgThor::AGG
       def device
         puts @client.get_devices_stats(parameterise(options))
       rescue RestClient::ExceptionWithResponse => e
@@ -26,9 +26,9 @@ module SendGrid4r::CLI
       end
 
       desc 'client', 'Gets email statistics by client type'
-      option :start_date, require: true
-      option :end_date
-      option :aggregated_by
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
+      option :aggregated_by, banner: SgThor::AGG
       def client
         puts @client.get_clients_stats(parameterise(options))
       rescue RestClient::ExceptionWithResponse => e
@@ -36,10 +36,12 @@ module SendGrid4r::CLI
       end
 
       desc 'client_type', 'Gets email statistics for a single client type'
-      option :start_date, require: true
-      option :end_date
-      option :aggregated_by
-      option :client_type, require: true
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
+      option :aggregated_by, banner: SgThor::AGG
+      option(
+        :client_type, banner: '[phone|tablet|webmail|desktop]', require: true
+      )
       def client_type
         puts @client.get_clients_type_stats(parameterise(options))
       rescue RestClient::ExceptionWithResponse => e
@@ -47,9 +49,9 @@ module SendGrid4r::CLI
       end
 
       desc 'mailbox_provider', 'Gets email statistics by mailbox provider'
-      option :start_date, require: true
-      option :end_date
-      option :aggregated_by
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
+      option :aggregated_by, banner: SgThor::AGG
       option :mailbox_providers
       def mailbox_provider
         puts @client.get_mailbox_providers_stats(parameterise(options))
@@ -58,9 +60,9 @@ module SendGrid4r::CLI
       end
 
       desc 'browser', 'Gets email statistics by browser'
-      option :start_date, require: true
-      option :end_date
-      option :aggregated_by
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
+      option :aggregated_by, banner: SgThor::AGG
       option :browsers
       def browser
         puts @client.get_browsers_stats(parameterise(options))

data/lib/sendgrid4r/cli/stats/category.rb

@@ -5,9 +5,9 @@ module SendGrid4r::CLI
     #
     class Category < SgThor
       desc 'get', 'Gets email statistics for the given categories.'
-      option :start_date, require: true
-      option :end_date
-      option :aggregated_by
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
+      option :aggregated_by, banner: SgThor::AGG
       option :categories, require: true
       def get
         puts @client.get_categories_stats(parameterise(options))
@@ -19,12 +19,12 @@ module SendGrid4r::CLI
         'sums',
         'Gets the total sums of each email statistic metric for all categories'
       )
-      option :start_date, require: true
-      option :end_date
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
       option :sort_by_metric
-      option :sort_by_direction
-      option :limit
-      option :offset
+      option :sort_by_direction, banner: SgThor::DIR
+      option :limit, type: :numeric
+      option :offset, type: :numeric
       def sums
         puts @client.get_categories_stats_sums(parameterise(options))
       rescue RestClient::ExceptionWithResponse => e

data/lib/sendgrid4r/cli/stats/global.rb

@@ -5,9 +5,9 @@ module SendGrid4r::CLI
     #
     class Global < SgThor
       desc 'get', 'Gets all of your user’s email statistics.'
-      option :start_date, require: true
-      option :end_date
-      option :aggregated_by
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
+      option :aggregated_by, banner: SgThor::AGG
       def get
         puts @client.get_global_stats(parameterise(options))
       rescue RestClient::ExceptionWithResponse => e

data/lib/sendgrid4r/cli/stats/parse.rb

@@ -5,9 +5,9 @@ module SendGrid4r::CLI
     #
     class Parse < SgThor
       desc 'get', 'Gets statistics for Parse Webhook usage'
-      option :start_date, require: true
-      option :end_date
-      option :aggregated_by
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
+      option :aggregated_by, banner: SgThor::AGG
       def get
         puts @client.get_parse_stats(parameterise(options))
       rescue RestClient::ExceptionWithResponse => e

data/lib/sendgrid4r/cli/stats/subuser.rb

@@ -5,9 +5,9 @@ module SendGrid4r::CLI
     #
     class Subuser < SgThor
       desc 'get', 'Gets email statistics for the given subusers'
-      option :start_date, require: true
-      option :end_date
-      option :aggregated_by
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
+      option :aggregated_by, banner: SgThor::AGG
       option :subusers, type: :array, require: true
       def get
         puts @client.get_subusers_stats(parameterise(options))
@@ -19,10 +19,10 @@ module SendGrid4r::CLI
         'sums',
         'Gets the total sums of each email statistic metric for all subusers'
       )
-      option :start_date, require: true
-      option :end_date
+      option :start_date, banner: SgThor::ISO, require: true
+      option :end_date, banner: SgThor::ISO
       option :sort_by_metric
-      option :sort_by_direction
+      option :sort_by_direction, banner: SgThor::DIR
       option :limit, type: :numeric
       option :offset, type: :numeric
       def sums
@@ -35,10 +35,10 @@ module SendGrid4r::CLI
         'list_monthly',
         'Retrieve the monthly email statistics for all subusers'
       )
-      option :date, require: true
+      option :date, banner: SgThor::ISO, require: true
       option :subuser
       option :sort_by_metric
-      option :sort_by_direction
+      option :sort_by_direction, banner: SgThor::DIR
       option :limit, type: :numeric
       option :offset, type: :numeric
       def list_monthly
@@ -52,9 +52,9 @@ module SendGrid4r::CLI
         'Retrieve the monthly email statistics for a single subuser'
       )
       option :subuser_name, require: true
-      option :date, require: true
+      option :date, banner: SgThor::ISO, require: true
       option :sort_by_metric
-      option :sort_by_direction
+      option :sort_by_direction, banner: SgThor::DIR
       option :limit, type: :numeric
       option :offset, type: :numeric
       def get_monthly