talkgh 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9d7123a6858aa39ee476856f48e8d9825e1ae246264676404d9f9f7a42339c5a
+  data.tar.gz: ee372d9c20209b41e820fce88c612327126544b446e58822b6c7d41b1c94534b
+SHA512:
+  metadata.gz: 40cc974674ecef226c95d03e61485821fd9bfb72ba3b35e2e895c6d056d799173a243725c8c8b0ef7050052e07f4caea739b183e72621a00b829af201d9ef659
+  data.tar.gz: 68c5146a93b53038b7a9f71283084904b184c43ac2bce1654386db834396a8d0a2eb859f5553f5a6fcdd4254dddec30ba83301c46fd3cf6727b9d5bdaab0e541

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 TODO: Write your name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,43 @@
+# Talkgh
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/talkgh`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'talkgh'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install talkgh
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/talkgh. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Talkgh project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/talkgh/blob/master/CODE_OF_CONDUCT.md).

data/lib/talkgh.rb

@@ -0,0 +1,12 @@
+require "talkgh/version"
+require "talkgh/keys"
+require "talkgh/errors/error"
+require "talkgh/errors/client_error"
+require "talkgh/errors/server_error"
+require "talkgh/errors/authentication_error"
+require "talkgh/namespace"
+require "talkgh/client"
+require "talkgh/sms"
+require "talkgh/params"
+require "talkgh/entity"
+require "talkgh/logger"

data/lib/talkgh/client.rb

@@ -0,0 +1,34 @@
+module Talkgh
+    class Client
+        attr_writer :api_token
+
+        def initialize(options = {})
+            @api_token = options[:api_token] || ENV['TALKGH_API_TOKEN']
+
+            self.logger = options[:logger] || (defined?(Rails.logger) && Rails.logger)
+        end
+
+        def api_token
+            unless @api_token
+              raise AuthenticationError.new('No API token provided. ' \
+                'See https://talkgh.com for details.')
+            end
+      
+            @api_token
+        end
+        
+        def sms
+            @sms ||= SMS.new(self)
+        end
+
+        def logger
+            @logger
+          end
+      
+          def logger=(logger)
+            @logger = Logger.new(logger)
+          end
+
+    end
+end
+  

data/lib/talkgh/entity.rb

@@ -0,0 +1,36 @@
+module Talkgh
+    class Entity
+      include Keys
+  
+      def initialize(**kwargs)
+        @attributes = kwargs
+      end
+  
+      def []=(key, value)
+        @attributes[attribute_key(key)] = value
+      end
+  
+      def respond_to_missing?(name, include_private = false)
+        @attributes.key?(name) or super
+      end
+  
+      def method_missing(name, *args)
+        return super unless @attributes.key?(name)
+  
+        @attributes[name]
+      end
+  
+      def ==(entity)
+        entity.class == self.class && entity.attributes == @attributes
+      end
+  
+      def to_h
+        @attributes
+      end
+  
+      attr_reader :attributes
+  
+      protected :attributes
+    end
+  end
+  

data/lib/talkgh/errors/authentication_error.rb

@@ -0,0 +1,4 @@
+module Talkgh
+    class AuthenticationError < ClientError
+    end
+end

data/lib/talkgh/errors/client_error.rb

@@ -0,0 +1,4 @@
+module Talkgh
+    class ClientError < Error
+    end
+end

data/lib/talkgh/errors/error.rb

@@ -0,0 +1,31 @@
+require 'json'
+
+module Talkgh
+    class Error < StandardError
+        def self.parse(response)
+            exception_class = case response
+            when Net::HTTPUnauthorized
+              AuthenticationError
+            when Net::HTTPClientError
+              ClientError
+            when Net::HTTPServerError
+              ServerError
+            else
+              Error
+            end
+    
+          message = if content_type = response['Content-Type']
+            case content_type.split(';').first
+            when 'application/problem+json'
+              Problem.parse(response.body)
+            when 'application/json'
+              hash = ::JSON.parse(response.body)
+              hash['error_title']
+            end
+          end
+    
+          exception_class.new(message)
+        end
+
+    end
+end

data/lib/talkgh/errors/server_error.rb

@@ -0,0 +1,4 @@
+module Talkgh
+    class ServerError < Error
+    end
+end

data/lib/talkgh/keys.rb

@@ -0,0 +1,45 @@
+
+module Talkgh
+    module Keys
+      if {}.respond_to?(:transform_keys)
+        def hyphenate(hash)
+          hash.transform_keys { |k| hyphenate_key(k) }
+        end
+  
+        def camelcase(hash)
+          hash.transform_keys { |k| camelcase_key(k) }
+        end
+      else
+        def hyphenate(hash)
+          hash.each_with_object({}) { |(k, v), h| h[hyphenate_key(k)] = v }
+        end
+  
+        def camelcase(hash)
+          hash.each_with_object({}) { |(k, v), h| h[camelcase_key(k)] = v }
+        end
+      end
+  
+      def hyphenate_key(k)
+        k.to_s.tr('_', '-')
+      end
+  
+      def camelcase_key(k)
+        k.to_s.gsub(/_(\w)/) { $1.upcase }
+      end
+  
+      ATTRIBUTE_KEYS = Hash.new { |h, k| h[k] = k.split(PATTERN).join('_').downcase.to_sym }
+  
+      PATTERN = /[\-_]|(?<=\w)(?=[A-Z])/
+  
+      private_constant :ATTRIBUTE_KEYS
+  
+      private_constant :PATTERN
+  
+      def attribute_key(k)
+        return k if k.is_a?(Symbol)
+  
+        ATTRIBUTE_KEYS[k]
+      end
+    end
+  end
+  

data/lib/talkgh/logger.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+require 'logger'
+require 'forwardable'
+
+module Talkgh
+  class Logger # :nodoc:
+    def initialize(logger)
+      @logger = logger || ::Logger.new(nil)
+    end
+
+    extend Forwardable
+
+    ::Logger::Severity.constants.map(&:downcase).each do |name|
+      def_delegator :@logger, name, name
+    end
+
+    def log_request_info(request)
+      info do
+        format('Talkgh API request', {
+          method: request.method,
+          path: request.uri.path
+        })
+      end
+    end
+
+    def log_response_info(response, host)
+      info do
+        format('Talkgh API response', {
+          host: host,
+          status: response.code,
+          type: response.content_type,
+          length: response.content_length
+        })
+      end
+    end
+
+    private
+
+    def format(message, hash)
+      return message if hash.nil?
+
+      fields = hash.map { |key, value| "#{key}=#{value}" if value }.compact
+      fields.unshift(message)
+      fields.join(' ')
+    end
+  end
+end

data/lib/talkgh/namespace.rb

@@ -0,0 +1,71 @@
+require 'net/http'
+require 'json'
+
+module Talkgh
+    class Namespace
+        def initialize(client)
+            @client = client
+            @host = self.class.host
+            @logger = client.logger
+            @api_token = client.api_token
+        end
+
+        def self.host
+            @host ||= 'api.talkgh.com/api/'
+        end
+
+        def self.host=(host)
+            @host = host
+        end
+
+
+        private
+
+        Get = Net::HTTP::Get
+        Put = Net::HTTP::Put
+        Post = Net::HTTP::Post
+        Delete = Net::HTTP::Delete
+
+        def request(params: nil, type: Get)
+            uri = URI('https://' + @host + @api_token)
+
+            params ||= {}
+
+            unless type::REQUEST_HAS_BODY || params.empty?
+                uri.query = Params.encode(params)
+            end
+      
+            http = Net::HTTP.new(uri.host, uri.port)
+            http.use_ssl = true
+
+            message = type.new(uri)
+
+            @logger.log_request_info(message)
+      
+            response = http.request(message)
+
+            @logger.log_response_info(response, @host)
+
+            @logger.debug(response.body) if response.body
+      
+            parse(response)
+        end
+
+        def parse(response)
+            case response
+            when Net::HTTPNoContent
+              :no_content
+            when Net::HTTPSuccess
+              if response['Content-Type'].split(';').first == 'application/json'
+                ::JSON.parse(response.body, object_class: Talkgh::Entity)
+              else
+                response
+              end
+            else
+              raise Error.parse(response)
+            end
+        end
+
+
+    end
+end

data/lib/talkgh/params.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+require 'cgi'
+
+module Talkgh
+    class Params
+        def self.encode(params)
+            params.flat_map { |k, vs| Array(vs).map { |v| "#{escape(k)}=#{escape(v)}" } }.join('&')
+          end
+      
+          def self.join(string, params)
+            encoded = encode(params)
+      
+            return encoded if string.nil?
+      
+            string + '&' + encoded
+          end
+      
+          def self.escape(component)
+            CGI.escape(component.to_s)
+          end
+      
+          private_class_method :escape
+    end
+end

data/lib/talkgh/sms.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Talkgh
+  class SMS < Namespace
+    include Keys
+  
+    self.host = 'api.talkgh.com/api/'
+  
+    def send(params)
+      request(params: hyphenate(params), type: Get)
+    end
+  end
+end
+  

data/lib/talkgh/version.rb

@@ -0,0 +1,3 @@
+module Talkgh
+  VERSION = "0.0.1"
+end

data/talkgh.gemspec

@@ -0,0 +1,27 @@
+require File.expand_path('lib/talkgh/version', File.dirname(__FILE__))
+
+Gem::Specification.new do |s|
+  s.name = 'talkgh'
+  s.version = Talkgh::VERSION
+  s.license = 'MIT'
+  s.platform = Gem::Platform::RUBY
+  s.authors = ['Talkgh']
+  s.email = ['devrel@talkgh.com']
+  s.homepage = 'https://github.com/Talkgh/talkgh-ruby'
+  s.description = 'Talkgh Client Library for Ruby'
+  s.summary = 'This is the Ruby client library for Talkgh\'s API. To use it you\'ll need a Talkgh account. Sign up for free at https://www.talkgh.com'
+  s.files = Dir.glob('lib/**/*.rb') + %w(LICENSE.txt README.md talkgh.gemspec)
+  s.required_ruby_version = '>= 2.1.0'
+  s.add_dependency('jwt', '~> 2')
+  s.add_development_dependency('rake', '~> 12.0')
+  s.add_development_dependency('minitest', '~> 5.0')
+  s.add_development_dependency('webmock', '~> 3.0')
+  s.add_development_dependency('simplecov', '~> 0.16')
+  s.require_path = 'lib'
+  s.metadata = {
+    'homepage' => 'https://github.com/Talkgh/talkgh-ruby',
+    'source_code_uri' => 'https://github.com/Talkgh/talkgh-ruby',
+    'bug_tracker_uri' => 'https://github.com/Talkgh/talkgh-ruby/issues',
+    'changelog_uri' => 'https://github.com/Talkgh/talkgh-ruby/blob/master/CHANGES.md'
+  }
+end

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: talkgh
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Talkgh
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-12-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+description: Talkgh Client Library for Ruby
+email:
+- devrel@talkgh.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/talkgh.rb
+- lib/talkgh/client.rb
+- lib/talkgh/entity.rb
+- lib/talkgh/errors/authentication_error.rb
+- lib/talkgh/errors/client_error.rb
+- lib/talkgh/errors/error.rb
+- lib/talkgh/errors/server_error.rb
+- lib/talkgh/keys.rb
+- lib/talkgh/logger.rb
+- lib/talkgh/namespace.rb
+- lib/talkgh/params.rb
+- lib/talkgh/sms.rb
+- lib/talkgh/version.rb
+- talkgh.gemspec
+homepage: https://github.com/Talkgh/talkgh-ruby
+licenses:
+- MIT
+metadata:
+  homepage: https://github.com/Talkgh/talkgh-ruby
+  source_code_uri: https://github.com/Talkgh/talkgh-ruby
+  bug_tracker_uri: https://github.com/Talkgh/talkgh-ruby/issues
+  changelog_uri: https://github.com/Talkgh/talkgh-ruby/blob/master/CHANGES.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.4
+signing_key: 
+specification_version: 4
+summary: This is the Ruby client library for Talkgh's API. To use it you'll need a
+  Talkgh account. Sign up for free at https://www.talkgh.com
+test_files: []