twilito 0.1.0 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7761e9e3ab42c77312bdb7207896ece722ce001a9a1c099c4a79b702f72c2aba
-  data.tar.gz: e1e4830cf7ea75dd00f55ffb796bf034128490a2ecbc6e066d8195771e6bf133
+  metadata.gz: 3cfb75e4c673aacee3f2e2d4d76bc4106c0129820825918b12f6ccd0c440a2bb
+  data.tar.gz: de0d9a0d43911c1db4cd3406aab39a4beb89f6f17d75e02b4dd0c13863c5bd8e
 SHA512:
-  metadata.gz: 12b4f5cf4934394c5e4e2f2ff3a9931c42ea6d33ebdd8faa0e7a53f27ee89a6a7a779b2cac9b122264cfbd7358556c974728e7550075db92449b1f873a6b2ba8
-  data.tar.gz: 7a4e56dfac70088de70c35bd34012573bb87c807461883062ec41a6149716676d2317f3fb849947b8a36b8bafe88251550f0f9d61d083c2840cc2a1ebe24efcc
+  metadata.gz: 37fdc8154d808290a9b85c6d55a5a93905882d558203ebdd587148d6a2b9f4661cc5455287a86a3d0739792aee9cabbe58b58eefe150980e13bebcdcb2646479
+  data.tar.gz: 607ad6172943a0ddc9d8bdfd9ed51b78e9d3f1f005bb34a6003967b1c6b089013eec8974d48cebd4b699ca7a3ccc6a621fcdb696908d201c6322de5314376fc4

data/.github/workflows/main.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: ["2.4", "2.5", "2.6", "2.7", "3.0"]
+    name: Run Tests (Ruby ${{ matrix.ruby }})
+    steps:
+      - uses: actions/checkout@master
+      - name: Setup ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run tests
+        run: bundle exec rake

data/.gitignore

@@ -1,9 +1,10 @@
 /.bundle/
 /.yardoc
 /_yardoc/
+/docs/
 /coverage/
-/doc/
 /pkg/
 /tmp/
 
-.ruby-version
+.ruby-version
+.DS_Store

data/Gemfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-ruby '2.6.1'
+ruby '>= 2.4.0'
 
 source "https://rubygems.org"
 

data/Gemfile.lock

@@ -1,29 +1,50 @@
 PATH
   remote: .
   specs:
-    twilito (0.1.0)
+    twilito (0.3.3)
 
 GEM
   remote: https://rubygems.org/
   specs:
     addressable (2.6.0)
       public_suffix (>= 2.0.2, < 4.0)
+    ast (2.4.1)
     coderay (1.1.2)
     crack (0.4.3)
       safe_yaml (~> 1.0.0)
     hashdiff (0.3.8)
     method_source (0.9.2)
     minitest (5.11.3)
+    parallel (1.19.2)
+    parser (2.7.1.3)
+      ast (~> 2.4.0)
     pry (0.12.2)
       coderay (~> 1.1.0)
       method_source (~> 0.9.0)
     public_suffix (3.0.3)
-    rake (10.5.0)
+    rainbow (3.0.0)
+    rake (13.0.1)
+    regexp_parser (1.7.1)
+    rexml (3.2.4)
+    rubocop (0.85.1)
+      parallel (~> 1.10)
+      parser (>= 2.7.0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.0.3)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.0.3)
+      parser (>= 2.7.0.1)
+    ruby-progressbar (1.10.1)
     safe_yaml (1.0.5)
+    unicode-display_width (1.7.0)
     webmock (3.5.1)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
       hashdiff
+    yard (0.9.25)
 
 PLATFORMS
   ruby
@@ -32,12 +53,14 @@ DEPENDENCIES
   bundler (~> 2.0)
   minitest (~> 5.11)
   pry
-  rake (~> 10.0)
+  rake (~> 13.0)
+  rubocop
   twilito!
   webmock (~> 3)
+  yard (~> 0.9)
 
 RUBY VERSION
-   ruby 2.6.1p33
+   ruby 2.7.2p137
 
 BUNDLED WITH
-   2.0.1
+   2.2.14

data/README.md

@@ -1,19 +1,23 @@
 # Twilito
 
-[![Build Status](https://travis-ci.org/alexford/twilito.svg?branch=master)](https://travis-ci.org/alexford/twilito)
+A tiny, zero dependency helper for sending text messages with Twilio. Just enough of a wrapper to abstract away Twilio's REST API for sending messages, without _anything_ else.
 
-A tiny, zero dependency helper for sending text messages with Twilio
+[![Gem Version](https://badge.fury.io/rb/twilito.svg)](https://badge.fury.io/rb/twilito) [![Actions Status](https://github.com/alexford/twilito/workflows/CI/badge.svg)](https://github.com/alexford/twilito/actions)
 
 ## Why
 
-Twilio's full on Ruby library does a lot, and has a large memory footprint—too large for just sending an SMS. It's also more difficult to mock and verify than I'd like for a simple task like sending an individual SMS.
+Twilio's [full Ruby library](https://github.com/twilio/twilio-ruby) does a _lot_, and has a large memory footprint to go with it—too large for just sending a message. It's also more difficult to mock and verify in tests than I'd like.
 
-Using Twilio's REST API directly is fine, but can be cumbersome.
+Using [Twilio's REST API](https://www.twilio.com/docs/usage/api) directly is fine, but can be cumbersome.
 
-Twilito is just enough of a wrapper to abstract away the REST API without loading the rest of the Twilio ecosystem.
+You should consider using Twilito if the only thing you need to do is send text messages and you don't want to worry about making HTTP requests to Twilio yourself.
+
+If you use more of Twilio, consider [twilio-ruby](https://github.com/twilio/twilio-ruby) or interact with the REST API in another way.
 
 ## Usage
 
+Twilito should work on Ruby 2.4 and up.
+
 #### Install the gem
 
 ```
@@ -23,16 +27,17 @@ gem 'twilito'
 #### Simplest case
 
 ```ruby
-# All options are required (but can be defaulted, see below)
+# All of these arguments are required, but can be defaulted (see below)
 result = Twilito.send_sms(
   to: '+15555555555',
   from: '+15554444444',
-  content: 'This is my content'
+  content: 'This is my content',
   account_sid: '...', # Twilio Credentials
   auth_token: '...'
 )
 
-# Returns Twilito::Result struct
+
+# Returns instance of Twilito::Result
 
 result.success? # => boolean
 result.errors # => [] or error messages
@@ -41,7 +46,7 @@ result.response # => Raw response (instance of Net::HTTPResponse)
 result.data # => Hash of response data (parsed from JSON)
 ```
 
-#### Use send! to raise on error instead
+#### Use send_sms! to raise on error instead
 
 ```ruby
 begin
@@ -78,26 +83,34 @@ end
 Twilito.send_sms!(to: '+15555555555', body: 'Foo')
 ```
 
-#### Really, everything
+**Everything can be defaulted, including the message body, so that a bare `Twilio.send_sms!` can work in your code**
+
+#### Sending MMS
 
 ```ruby
-# In an initializer or something like that:
+# Use the optional media_url argument, which is sent
+# to Twilio as MediaUrl
 
-Twilito.configure do |config|
-  # Store your secrets elsewhere
-  config.account_sid = ENV['TWILIO_ACCOUNT_SID']
-  config.auth_token = ENV['TWILIO_AUTH_TOKEN']
+result = Twilito.send_sms(
+  to: '+15555555555',
+  content: 'This is my content',
+  media_url: 'https://example.com/image.png',
+)
 
-  config.from = '+16145555555'
-  config.to = '+15555555555'
-  config.body = 'A new user signed up'
-end
 ```
 
+#### Set the optional `callback_url` argument if you want to receive HTTP callbacks from Twilio
+
 ```ruby
-# Later, in your code:
+# Use the optional media_url argument, which is sent
+# to Twilio as MediaUrl
+
+result = Twilito.send_sms(
+  to: '+15555555555',
+  content: 'This is my content',
+  status_callback: 'https://your.app.io/sms/callback',
+)
 
-Twilito.send_sms!
 ```
 
 ## Testing your code
@@ -106,4 +119,23 @@ _TODO: Add examples of mocking and/or test helpers for asserting your code sends
 
 ## Contributing
 
-_TODO_
+### Contribute Feedback, Ideas, and Bug Reports
+
+- Create or comment on an issue
+
+### Contribute Code
+
+- Find an open issue or create one
+- Fork this repo and open a PR
+- Write unit tests for your change
+
+### Contribute Docs
+
+- Open a PR to make the README better, or help with contribution guidelines, etc.
+- There is currently an open issue for adding RDoc/YARD documentation
+
+### Contribute Beer
+
+Did Twilito save you some RAM?
+
+<a href="https://www.buymeacoffee.com/alexford" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/lato-white.png" alt="Buy Me A Beer" height="51" width="217" style="height: 51px !important;width: 217px !important;" ></a>

data/Rakefile

@@ -2,6 +2,7 @@
 
 require "bundler/gem_tasks"
 require "rake/testtask"
+require 'yard'
 
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
@@ -10,3 +11,8 @@ Rake::TestTask.new(:test) do |t|
 end
 
 task default: :test
+
+YARD::Rake::YardocTask.new do |t|
+  t.files = ['lib/**/*.rb'] # optional
+  t.options = ['-odocs'] # optional
+end

data/lib/twilito.rb

@@ -13,7 +13,7 @@ module Twilito
     include API
 
     def send_sms(**args)
-      response = send_sms!(args)
+      response = send_sms!(**args)
       Result.success(
         response: response,
         sid: JSON.parse(response.read_body)['sid']
@@ -28,21 +28,17 @@ module Twilito
       args = merge_configuration(args)
 
       send_response(args).tap do |response|
-        unless response.is_a? Net::HTTPSuccess
-          raise SendError.new('Error from Twilio API', response)
-        end
+        raise SendError.new('Error from Twilio API', response) unless response.is_a? Net::HTTPSuccess
       end
     end
 
     private
 
-    def merge_configuration(**args)
+    def merge_configuration(args)
       configuration.to_h.merge(args).tap do |merged|
         missing_keys = merged.select { |_k, v| v.nil? }.keys
 
-        if missing_keys.any?
-          raise ArgumentError, "Missing argument(s): #{missing_keys.join(', ')}"
-        end
+        raise ArgumentError, "Missing argument(s): #{missing_keys.join(', ')}" if missing_keys.any?
       end
     end
   end

data/lib/twilito/api.rb

@@ -7,6 +7,7 @@ module Twilito
 
       Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
         req = Net::HTTP::Post.new(uri)
+        req.initialize_http_header('User-Agent' => user_agent)
         req.basic_auth(args[:account_sid], args[:auth_token])
         req.set_form_data(twilio_params(args))
 
@@ -34,8 +35,14 @@ module Twilito
       {
         'To' => args[:to],
         'From' => args[:from],
-        'Body' => args[:body]
-      }
+        'Body' => args[:body],
+        'MediaUrl' => args[:media_url],
+        'StatusCallback' => args[:status_callback]
+      }.compact
+    end
+
+    def user_agent
+      "Ruby Twilito/#{Twilito::VERSION}"
     end
   end
 end

data/lib/twilito/result.rb

@@ -1,29 +1,38 @@
 # frozen_string_literal: true
 
 module Twilito
-  Result = Struct.new(:success?, :errors, :sid, :response, keyword_init: true) do
-    def self.success(**args)
-      new(success?: true, **args)
+  class Result
+    attr_reader :success, :errors, :sid, :response
+
+    def initialize(success:, errors: [], sid: nil, response: nil)
+      @success = success
+      @errors = errors
+      @sid = sid
+      @response = response
     end
 
-    def self.failure(**args)
-      new(success?: false, **args)
+    def self.success(response:, sid:)
+      new(success: true, response: response, sid: sid)
     end
 
-    def errors
-      to_h[:errors] || []
+    def self.failure(response:, errors:)
+      new(success: false, response: response, errors: errors)
     end
 
     def data
       JSON.parse(response_body || '{}')
     end
 
+    def success?
+      success || false
+    end
+
     private
 
     def response_body
-      return nil unless to_h[:response]&.respond_to?(:read_body)
+      return nil unless response&.respond_to?(:read_body)
 
-      to_h[:response].read_body
+      response.read_body
     end
   end
 end

data/lib/twilito/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Twilito
-  VERSION = "0.1.0"
+  VERSION = "0.3.3"
 end

data/twilito.gemspec

@@ -9,7 +9,8 @@ Gem::Specification.new do |spec|
   spec.licenses      = ['MIT']
   spec.version       = Twilito::VERSION
   spec.authors       = ["Alex Ford"]
-  spec.email         = ["alexford87@me.com"]
+  spec.email         = ["alexford@hey.com"]
+  spec.required_ruby_version = '>= 2.4.0'
 
   spec.summary       = "A tiny, zero dependency, and easy to test helper for sending text messages with Twilio"
   spec.homepage      = "https://github.com/alexford/twilito"
@@ -24,6 +25,8 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", "~> 2.0"
   spec.add_development_dependency "minitest", "~> 5.11"
   spec.add_development_dependency "pry"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rubocop"
   spec.add_development_dependency "webmock", "~> 3"
+  spec.add_development_dependency "yard", "~> 0.9"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twilito
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.3
 platform: ruby
 authors:
 - Alex Ford
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-09-27 00:00:00.000000000 Z
+date: 2021-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -58,14 +58,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -80,13 +94,28 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3'
-description: 
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description:
 email:
-- alexford87@me.com
+- alexford@hey.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/main.yml"
 - ".gitignore"
 - ".rubocop.yml"
 - ".travis.yml"
@@ -108,7 +137,7 @@ homepage: https://github.com/alexford/twilito
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -116,15 +145,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: A tiny, zero dependency, and easy to test helper for sending text messages
   with Twilio