sendgrid-ruby 1.1.6 → 6.0.4

data/examples/user/user.rb

@@ -0,0 +1,293 @@
+require 'sendgrid-ruby'
+
+
+sg = SendGrid::API.new(api_key: ENV['SENDGRID_API_KEY'])
+
+
+##################################################
+# Get a user's account information. #
+# GET /user/account #
+
+response = sg.client.user.account.get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Retrieve your credit balance #
+# GET /user/credits #
+
+response = sg.client.user.credits.get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Update your account email address #
+# PUT /user/email #
+
+data = JSON.parse('{
+  "email": "example@example.com"
+}')
+response = sg.client.user.email.put(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Retrieve your account email address #
+# GET /user/email #
+
+response = sg.client.user.email.get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Update your password #
+# PUT /user/password #
+
+data = JSON.parse('{
+  "new_password": "new_password", 
+  "old_password": "old_password"
+}')
+response = sg.client.user.password.put(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Update a user's profile #
+# PATCH /user/profile #
+
+data = JSON.parse('{
+  "city": "Orange", 
+  "first_name": "Example", 
+  "last_name": "User"
+}')
+response = sg.client.user.profile.patch(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Get a user's profile #
+# GET /user/profile #
+
+response = sg.client.user.profile.get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Cancel or pause a scheduled send #
+# POST /user/scheduled_sends #
+
+data = JSON.parse('{
+  "batch_id": "YOUR_BATCH_ID", 
+  "status": "pause"
+}')
+response = sg.client.user.scheduled_sends.post(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Retrieve all scheduled sends #
+# GET /user/scheduled_sends #
+
+response = sg.client.user.scheduled_sends.get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Update user scheduled send information #
+# PATCH /user/scheduled_sends/{batch_id} #
+
+data = JSON.parse('{
+  "status": "pause"
+}')
+batch_id = "test_url_param"
+response = sg.client.user.scheduled_sends._(batch_id).patch(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Retrieve scheduled send #
+# GET /user/scheduled_sends/{batch_id} #
+
+batch_id = "test_url_param"
+response = sg.client.user.scheduled_sends._(batch_id).get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Delete a cancellation or pause of a scheduled send #
+# DELETE /user/scheduled_sends/{batch_id} #
+
+batch_id = "test_url_param"
+response = sg.client.user.scheduled_sends._(batch_id).delete()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Update Enforced TLS settings #
+# PATCH /user/settings/enforced_tls #
+
+data = JSON.parse('{
+  "require_tls": true, 
+  "require_valid_cert": false
+}')
+response = sg.client.user.settings.enforced_tls.patch(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Retrieve current Enforced TLS settings. #
+# GET /user/settings/enforced_tls #
+
+response = sg.client.user.settings.enforced_tls.get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Update your username #
+# PUT /user/username #
+
+data = JSON.parse('{
+  "username": "test_username"
+}')
+response = sg.client.user.username.put(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Retrieve your username #
+# GET /user/username #
+
+response = sg.client.user.username.get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Update Event Notification Settings #
+# PATCH /user/webhooks/event/settings #
+
+data = JSON.parse('{
+  "bounce": true, 
+  "click": true, 
+  "deferred": true, 
+  "delivered": true, 
+  "dropped": true, 
+  "enabled": true, 
+  "group_resubscribe": true, 
+  "group_unsubscribe": true, 
+  "open": true, 
+  "processed": true, 
+  "spam_report": true, 
+  "unsubscribe": true, 
+  "url": "url"
+}')
+response = sg.client.user.webhooks.event.settings.patch(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Retrieve Event Webhook settings #
+# GET /user/webhooks/event/settings #
+
+response = sg.client.user.webhooks.event.settings.get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Test Event Notification Settings  #
+# POST /user/webhooks/event/test #
+
+data = JSON.parse('{
+  "url": "url"
+}')
+response = sg.client.user.webhooks.event.test.post(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Create a parse setting #
+# POST /user/webhooks/parse/settings #
+
+data = JSON.parse('{
+  "hostname": "myhostname.com", 
+  "send_raw": false, 
+  "spam_check": true, 
+  "url": "http://email.myhosthame.com"
+}')
+response = sg.client.user.webhooks.parse.settings.post(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Retrieve all parse settings #
+# GET /user/webhooks/parse/settings #
+
+response = sg.client.user.webhooks.parse.settings.get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Update a parse setting #
+# PATCH /user/webhooks/parse/settings/{hostname} #
+
+data = JSON.parse('{
+  "send_raw": true, 
+  "spam_check": false, 
+  "url": "http://newdomain.com/parse"
+}')
+hostname = "test_url_param"
+response = sg.client.user.webhooks.parse.settings._(hostname).patch(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Retrieve a specific parse setting #
+# GET /user/webhooks/parse/settings/{hostname} #
+
+hostname = "test_url_param"
+response = sg.client.user.webhooks.parse.settings._(hostname).get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Delete a parse setting #
+# DELETE /user/webhooks/parse/settings/{hostname} #
+
+hostname = "test_url_param"
+response = sg.client.user.webhooks.parse.settings._(hostname).delete()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Retrieves Inbound Parse Webhook statistics. #
+# GET /user/webhooks/parse/stats #
+
+params = JSON.parse('{"aggregated_by": "day", "limit": "test_string", "start_date": "2016-01-01", "end_date": "2016-04-01", "offset": "test_string"}')
+response = sg.client.user.webhooks.parse.stats.get(query_params: params)
+puts response.status_code
+puts response.body
+puts response.headers
+

data/gemfiles/Sinatra_1.gemfile

@@ -0,0 +1,6 @@
+source 'http://rubygems.org'
+
+gemspec path: '..'
+
+gem 'ruby_http_client'
+gem 'sinatra', '~> 1.4'

data/gemfiles/Sinatra_2.gemfile

@@ -0,0 +1,6 @@
+source 'http://rubygems.org'
+
+gemspec path: '..'
+
+gem 'ruby_http_client'
+gem 'sinatra', '>= 2.0.0.rc2'

data/lib/sendgrid/client.rb

@@ -1,62 +1,38 @@
-require 'faraday'
+# Quickly and easily access the Twilio SendGrid API.
+require 'ruby_http_client'
+require_relative 'version'
 
 module SendGrid
-  class Client
-    attr_accessor :api_user, :api_key, :protocol, :host, :port, :url, :endpoint,
-                  :user_agent, :template
-    attr_writer :adapter, :conn, :raise_exceptions
-
-    def initialize(params = {})
-      self.api_user         = params.fetch(:api_user, nil)
-      self.api_key          = params.fetch(:api_key, nil)
-      self.protocol         = params.fetch(:protocol, 'https')
-      self.host             = params.fetch(:host, 'api.sendgrid.com')
-      self.port             = params.fetch(:port, nil)
-      self.url              = params.fetch(:url, protocol + '://' + host + (port ? ":#{port}" : ''))
-      self.endpoint         = params.fetch(:endpoint, '/api/mail.send.json')
-      self.adapter          = params.fetch(:adapter, adapter)
-      self.conn             = params.fetch(:conn, conn)
-      self.user_agent       = params.fetch(:user_agent, "sendgrid/#{SendGrid::VERSION};ruby")
-      self.raise_exceptions = params.fetch(:raise_exceptions, true)
-      yield self if block_given?
-    end
-
-    def send(mail)
-      res = conn.post do |req|
-        payload = mail.to_h
-        req.url(endpoint)
-
-        # Check if using username + password or API key
-        if api_user
-          # Username + password
-          payload = payload.merge(api_user: api_user, api_key: api_key)
-        else
-          # API key
-          req.headers['Authorization'] = "Bearer #{api_key}"
-        end
-
-        req.body = payload
-      end
-
-      fail SendGrid::Exception, res.body if raise_exceptions? && res.status != 200
-
-      SendGrid::Response.new(code: res.status, headers: res.headers, body: res.body)
-    end
-
-    def conn
-      @conn ||= Faraday.new(url: url) do |conn|
-        conn.request :multipart
-        conn.request :url_encoded
-        conn.adapter adapter
-      end
-    end
-
-    def adapter
-      @adapter ||= Faraday.default_adapter
-    end
-
-    def raise_exceptions?
-      @raise_exceptions
+  # Initialize the HTTP client
+  class API
+    attr_accessor :client
+    attr_reader :request_headers, :host, :version, :impersonate_subuser
+    # * *Args*    :
+    #   - +api_key+ -> your Twilio SendGrid API key
+    #   - +host+ -> the base URL for the API
+    #   - +request_headers+ -> any headers that you want to be globally applied
+    #   - +version+ -> the version of the API you wish to access,
+    #                  currently only "v3" is supported
+    #
+    def initialize(api_key: '', host: nil, request_headers: nil, version: nil, impersonate_subuser: nil)
+      @api_key             = api_key
+      @host                = host ? host : 'https://api.sendgrid.com'
+      @version             = version ? version : 'v3'
+      @impersonate_subuser = impersonate_subuser
+      @user_agent          = "sendgrid/#{SendGrid::VERSION};ruby"
+      @request_headers     = JSON.parse('
+        {
+          "Authorization": "Bearer ' + @api_key + '",
+          "Accept": "application/json",
+          "User-agent": "' + @user_agent + '"
+        }
+      ')
+      @request_headers['On-Behalf-Of'] = @impersonate_subuser if @impersonate_subuser
+
+
+      @request_headers = @request_headers.merge(request_headers) if request_headers
+      @client = Client.new(host: "#{@host}/#{@version}",
+                           request_headers: @request_headers)
     end
   end
 end

data/lib/sendgrid/helpers/inbound/README.md

@@ -0,0 +1,98 @@
+**This helper is a stand alone module to help get you started consuming and processing Inbound Parse data.**
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start for Local Testing with Sample Data](#quick-start-for-local-testing-with-sample-data)
+- [Quick Start for Local Testing with Real Data](#quick-start-for-local-testing-with-real-data)
+- [Code Walkthrough](#code-walkthrough)
+  - [app.rb](#apprb)
+  - [config.yml](#configyml)
+  - [send.rb & /sample_data](#sendrb--sampledata)
+- [Contributing](#contributing)
+
+<a name="quick_start_local_sample"></a>
+
+
+# Installation
+
+In addition to the installation instructions in
+[the main readme](https://github.com/sendgrid/sendgrid-ruby/tree/master/#installation),
+you must also add sinatra to your Gemfile:
+
+```
+gem 'sinatra', '>= 1.4.7', '< 3'
+```
+
+
+# Quick Start for Local Testing with Sample Data
+
+```bash
+git clone https://github.com/sendgrid/sendgrid-ruby.git
+cd sendgrid-ruby
+bundle install
+```
+
+Run the Inbound Parse listener in your terminal:
+
+```ruby
+rackup
+```
+
+In another terminal, run the test data sender:
+
+```bash
+cd [path to sendgrid-ruby]
+bundle install
+ruby ./lib/sendgrid/helpers/inbound/send.rb ./lib/sendgrid/helpers/inbound/sample_data/default_data.txt
+```
+
+More sample data can be found [here](https://github.com/sendgrid/sendgrid-ruby/tree/master/lib/sendgrid/helpers/inbound/sample_data).
+
+View the results in the first terminal.
+
+<a name="quick_start_local_real"></a>
+# Quick Start for Local Testing with Real Data
+
+[Setup your MX records.](https://sendgrid.com/docs/Classroom/Basics/Inbound_Parse_Webhook/setting_up_the_inbound_parse_webhook.html#-Setup) Depending on your domain name host, you may need to wait up to 48 hours for the settings to propagate.
+
+Run the Inbound Parse listener in your terminal:
+
+```bash
+git clone https://github.com/sendgrid/sendgrid-ruby.git
+cd sendgrid-ruby
+bundle install
+rackup
+```
+
+In another terminal, use [ngrok](https://ngrok.com/) to allow external access to your machine:
+```bash
+ngrok http 9292
+```
+
+Update your Twilio SendGrid Incoming Parse settings: [Settings Page](https://app.sendgrid.com/settings/parse) | [Docs](https://sendgrid.com/docs/Classroom/Basics/Inbound_Parse_Webhook/setting_up_the_inbound_parse_webhook.html#-Pointing-to-a-Hostname-and-URL)
+
+- For the HOSTNAME field, use the domain that you changed the MX records (e.g. inbound.yourdomain.com)
+- For the URL field, use the URL generated by ngrok + /inbound, e.g http://XXXXXXX.ngrok.io/inbound
+
+Next, send an email to [anything]@inbound.yourdomain.com, then look at the terminal where you started the Inbound Parse listener.
+
+<a name="code_walkthrough"></a>
+# Code Walkthrough
+
+## app.rb
+
+This module runs a [Sinatra](http://www.sinatrarb.com/) server, that by default (you can change those settings [here](https://github.com/sendgrid/sendgrid-ruby/blob/master/sendgrid/helpers/inbound/config.yml)), listens for POSTs on http://localhost:9292. When the server receives the POST, it parses and prints the key/value data.
+
+## config.yml
+
+This module loads application environment variables (located in [config.yml](https://github.com/sendgrid/sendgrid-ruby/blob/master/sendgrid/helpers/inbound/config.yml)).
+
+## send.rb & /sample_data
+
+This module is used to send sample test data. It is useful for testing and development, particularly while you wait for your MX records to propagate.
+
+<a name="contributing"></a>
+# Contributing
+
+If you would like to contribute to this project, please see our [contributing guide](https://github.com/sendgrid/sendgrid-ruby/blob/master/CONTRIBUTING.md). Thanks!

data/lib/sendgrid/helpers/inbound/app.rb

@@ -0,0 +1,32 @@
+begin
+  require 'sinatra'
+rescue LoadError
+  puts <<-NOTE
+    As of sengrid verison 6, sinatra is no longer specified as a dependency of
+    the sendgrid gem. All the functionality of the inbound server is still the same
+    and fully supported, but you just need to include the sinatra dependency in your gemfile
+    yourself, like so:
+
+        gem 'sinatra', '>= 1.4.7', '< 3'
+  NOTE
+  raise
+end
+require 'logger'
+require 'json'
+require 'yaml'
+
+class Main < Sinatra::Base
+  configure :production, :development do
+    enable :logging
+    set :config, YAML.load_file(File.dirname(__FILE__) + '/config.yml')
+  end
+
+  get '/' do
+    redirect to('index.html')
+  end
+
+  post settings.config['endpoint'] do
+    filtered = params.select {|k, v| settings.config['keys'].include?(k)}
+    logger.info JSON.pretty_generate(filtered)
+  end
+end

data/lib/sendgrid/helpers/inbound/config.yml

@@ -0,0 +1,26 @@
+# Incoming Parse endpoint for receiver
+endpoint: '/inbound'
+
+# List all Incoming Parse fields you would like parsed
+# Reference: https://sendgrid.com/docs/Classroom/Basics/Inbound_Parse_Webhook/setting_up_the_inbound_parse_webhook.html
+keys:
+ - from
+ - attachments
+ - headers
+ - text
+ - envelope
+ - to
+ - html
+ - sender_ip
+ - attachment-info
+ - subject
+ - dkim
+ - SPF
+ - charsets
+ - content-ids
+ - spam_report
+ - spam_score
+ - email
+
+# URL that the sender will POST to
+host: 'http://127.0.0.1:9292/inbound'

data/lib/sendgrid/helpers/inbound/public/index.html

@@ -0,0 +1,10 @@
+<html>
+  <head>
+    <title>Twilio SendGrid Incoming Parse</title>
+  </head>
+  <body>
+    <h1>You have successfuly launched the server!</h1>
+
+       Check out <a href="https://github.com/sendgrid/sendgrid-ruby/tree/master/sendgrid/helpers/inbound">the documentation</a> on how to use this software to utilize the SendGrid Inbound Parse webhook.
+  </body>
+</html>

data/lib/sendgrid/helpers/inbound/sample_data/default_data.txt

@@ -0,0 +1,58 @@
+--xYzZY
+Content-Disposition: form-data; name="headers"
+
+MIME-Version: 1.0
+Received: by 0.0.0.0 with HTTP; Wed, 10 Aug 2016 18:10:13 -0700 (PDT)
+From: Example User <test@example.com>
+Date: Wed, 10 Aug 2016 18:10:13 -0700
+Subject: Inbound Parse Test Data
+To: inbound@inbound.example.com
+Content-Type: multipart/alternative; boundary=001a113df448cad2d00539c16e89
+
+--xYzZY
+Content-Disposition: form-data; name="dkim"
+
+{@sendgrid.com : pass}
+--xYzZY
+Content-Disposition: form-data; name="to"
+
+inbound@inbound.example.com
+--xYzZY
+Content-Disposition: form-data; name="html"
+
+<html><body><strong>Hello Twilio SendGrid!</body></html>
+
+--xYzZY
+Content-Disposition: form-data; name="from"
+
+Example User <test@example.com>
+--xYzZY
+Content-Disposition: form-data; name="text"
+
+Hello Twilio SendGrid!
+
+--xYzZY
+Content-Disposition: form-data; name="sender_ip"
+
+0.0.0.0
+--xYzZY
+Content-Disposition: form-data; name="envelope"
+
+{"to":["inbound@inbound.example.com"],"from":"test@example.com"}
+--xYzZY
+Content-Disposition: form-data; name="attachments"
+
+0
+--xYzZY
+Content-Disposition: form-data; name="subject"
+
+Testing non-raw
+--xYzZY
+Content-Disposition: form-data; name="charsets"
+
+{"to":"UTF-8","html":"UTF-8","subject":"UTF-8","from":"UTF-8","text":"UTF-8"}
+--xYzZY
+Content-Disposition: form-data; name="SPF"
+
+pass
+--xYzZY--

data/lib/sendgrid/helpers/inbound/sample_data/raw_data.txt

@@ -0,0 +1,57 @@
+--xYzZY
+Content-Disposition: form-data; name="dkim"
+
+{@sendgrid.com : pass}
+--xYzZY
+Content-Disposition: form-data; name="email"
+
+MIME-Version: 1.0
+Received: by 0.0.0.0 with HTTP; Wed, 10 Aug 2016 14:44:21 -0700 (PDT)
+From: Example User <test@example.com>
+Date: Wed, 10 Aug 2016 14:44:21 -0700
+Subject: Inbound Parse Test Raw Data
+To: inbound@inbound.inbound.com
+Content-Type: multipart/alternative; boundary=001a113ee97c89842f0539be8e7a
+
+--001a113ee97c89842f0539be8e7a
+Content-Type: text/plain; charset=UTF-8
+
+Hello Twilio SendGrid!
+
+--001a113ee97c89842f0539be8e7a
+Content-Type: text/html; charset=UTF-8
+Content-Transfer-Encoding: quoted-printable
+
+<html><body><strong>Hello Twilio SendGrid!</body></html>
+
+--001a113ee97c89842f0539be8e7a--
+
+--xYzZY
+Content-Disposition: form-data; name="to"
+
+inbound@inbound.inbound.com
+--xYzZY
+Content-Disposition: form-data; name="from"
+
+Example User <test@example.com>
+--xYzZY
+Content-Disposition: form-data; name="sender_ip"
+
+0.0.0.0
+--xYzZY
+Content-Disposition: form-data; name="envelope"
+
+{"to":["inbound@inbound.inbound.com"],"from":"test@example.com"}
+--xYzZY
+Content-Disposition: form-data; name="subject"
+
+Testing with Request.bin
+--xYzZY
+Content-Disposition: form-data; name="charsets"
+
+{"to":"UTF-8","subject":"UTF-8","from":"UTF-8"}
+--xYzZY
+Content-Disposition: form-data; name="SPF"
+
+pass
+--xYzZY--