xendit-client 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cf2037101e13b2b57ec12d52edb1ca9d1b88384518a9e4a6bac7e227345b951e
+  data.tar.gz: 106453aecae96cc27b0325d387f0730c28ffcb153eda880865169786dc722a5f
+SHA512:
+  metadata.gz: 5e2a0942541f002d3289018edc5ae4538aa1d2dff50b41c7b1b5acaa659f05bf4ac357b82f098b3de9a0d6df154d8fb3a77f62b6f6309f321f54981f3784871c
+  data.tar.gz: 29e8b22d1dd593667f5eb0137650c8ae8947fff5ee0de22d2bb9a668c3b01a727db2a26ee61757f1622b23e96330444f96cdf67ecdf6cfe6572e2677b638df8e

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+### Version 0.1.0  (date: 15 Jan 2023)
+
+* Support invoice API

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in xendit.gemspec
+gemspec
+
+gem "rake", "~> 13.0"

data/Gemfile.lock

@@ -0,0 +1,27 @@
+PATH
+  remote: .
+  specs:
+    xendit-client (0.1.0)
+      faraday (~> 2.7.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    faraday (2.7.2)
+      faraday-net_http (>= 2.0, < 3.1)
+      ruby2_keywords (>= 0.0.4)
+    faraday-net_http (3.0.2)
+    rake (13.0.6)
+    ruby2_keywords (0.0.5)
+
+PLATFORMS
+  arm64-darwin-21
+  ruby
+  universal-darwin-22
+
+DEPENDENCIES
+  rake (~> 13.0)
+  xendit-client!
+
+BUNDLED WITH
+   2.3.6

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Nasrul Gunawan
+
+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,49 @@
+# Xendit Ruby library
+
+This is the Unofficial Ruby API client/library for Xendit API.
+
+<!-- toc -->
+
+- [API Documentation](#api-documentation)
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Usage](#usage)
+  * [Invoice Service](#invoice-service)
+
+<!-- tocstop -->
+
+## API Documentation
+
+Please check [Xendit API Reference](https://xendit.github.io/apireference/).
+
+## Requirements
+- Ruby 2.5+
+
+## Installation
+
+### Using Gemfile
+Install the gem and add to the application's Gemfile by executing:
+```ruby
+bundle add xendit-client
+```
+Or add gem xendit-client to Gemfile
+```ruby
+gem 'xendit-client'
+```
+Run this command in your terminal
+
+```ruby
+bundle install
+```
+
+## Usage
+
+Get your API key from [Xendit Dashboard](https://dashboard.xendit.co/settings/developers#api-keys).
+
+Add your API key to the initializer.
+
+```ruby
+require 'xendit'
+
+Xendit.api_key = 'xnd_...'
+```

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/lib/xendit/api_client.rb

@@ -0,0 +1,56 @@
+require 'faraday'
+require_relative 'json_serializer'
+require_relative 'response'
+require_relative 'errors'
+
+module Xendit
+  class ApiClient
+    class << self
+      def get(url, params = nil)
+        conn = create_connection()
+        response = conn.get(url, params)
+        handle_response(response)
+      end
+
+      def post(url, body)
+        conn = create_connection()
+        response = conn.post(url, JSONSerializer.encode(body))
+        handle_response(response)
+      end
+
+      private
+    
+      def create_connection(additional_headers = {})
+        if Xendit.api_key.nil? || Xendit.api_key == ""
+          raise "Please configure your API key" 
+        end
+
+        default_headers =  {
+          "Accept" => "application/json",
+          "Content-Type" => "application/json",
+          "User-Agent" => "Xendit ruby client library #{Xendit::VERSION}"
+        }
+
+        default_headers = default_headers.merge!(additional_headers) if additional_headers != {}
+        
+        Faraday.new(
+          url: Xendit.base_url,
+          headers: default_headers
+        ) do |conn|
+          conn.request :authorization, :basic, Xendit.api_key, ''
+        end
+      end
+
+      def handle_response(response)
+        raise ArgumentError, "Invalid response" if response.nil?
+
+        if response.status >= 400
+          response_body = JSONSerializer.decode(response.body)
+          raise Xendit::Errors.new(response_body['error_code'], response_body['message'], response.status)
+        end
+
+        Xendit::Response.new(response)
+      end
+    end
+  end
+end

data/lib/xendit/errors.rb

@@ -0,0 +1,18 @@
+module Xendit
+  class Errors < StandardError
+    attr_reader :error_code, :error_message, :http_status
+
+    def initialize(error_code, error_message, http_status)
+      @error_code = error_code
+      @error_message = error_message
+      @http_status = http_status
+      super(message_string)
+    end
+
+    private
+    
+    def message_string
+      "Xendit API is returning API error. HTTP status #{@http_status}: #{@error_code}. Error message: #{@error_message}"
+    end
+  end
+end

data/lib/xendit/json_serializer.rb

@@ -0,0 +1,27 @@
+module Xendit
+  class JSONSerializer
+    class << self
+      # If you using Rails then it will call ActiveSupport::JSON.encode
+      # Otherwise JSON.pretty_generate
+      def encode(params)
+        if defined?(ActiveSupport) && defined?(ActiveSupport::JSON)
+          ActiveSupport::JSON.encode(params)
+        else
+          require 'json' unless defined?(JSON)
+          JSON.pretty_generate(params)
+        end
+      end
+
+      # If you using Rails then it will call ActiveSupport::JSON.decode
+      # Otherwise JSON.parse
+      def decode(params)
+        if defined?(ActiveSupport) && defined?(ActiveSupport::JSON)
+          ActiveSupport::JSON.decode(params)
+        else
+          require 'json' unless defined?(JSON)
+          JSON.parse(params)
+        end
+      end
+    end
+  end
+end

data/lib/xendit/resources/invoice.rb

@@ -0,0 +1,23 @@
+require_relative '../api_client'
+
+module Xendit
+  class Invoice 
+    class << self
+      def get(invoice_id)
+        ApiClient.get "v2/invoices/#{invoice_id}"
+      end
+
+      def create(params)
+        ApiClient.post "v2/invoices/", params
+      end
+
+      def expire(invoice_id)
+        ApiClient.post "invoices/#{invoice_id}/expire!"
+      end
+
+      def get_all
+        ApiClient.get "v2/invoices"
+      end
+    end
+  end
+end

data/lib/xendit/resources.rb

@@ -0,0 +1 @@
+require_relative 'resources/invoice'

data/lib/xendit/response.rb

@@ -0,0 +1,20 @@
+require_relative 'json_serializer'
+
+module Xendit
+  class Response
+    attr_reader :status, :body
+
+    def initialize(response)
+      @status = response.status
+      @body = JSONSerializer.decode(response.body)
+    end
+
+    def success?
+      [200, 201].include?(@status)
+    end
+
+    def created?
+      @status == 201
+    end
+  end
+end

data/lib/xendit/version.rb

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

data/lib/xendit.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative "xendit/version"
+require_relative 'xendit/resources'
+
+module Xendit
+  class << self
+    attr_accessor :api_key
+    attr_writer :base_url
+
+    def base_url
+      @base_url ||= 'https://api.xendit.co/'
+    end
+  end
+end

data/sig/xendit.rbs

@@ -0,0 +1,4 @@
+module Xendit
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: xendit-client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nasrul Gunawan
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2023-01-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.2
+description: 
+email:
+- search.nasrul@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/xendit.rb
+- lib/xendit/api_client.rb
+- lib/xendit/errors.rb
+- lib/xendit/json_serializer.rb
+- lib/xendit/resources.rb
+- lib/xendit/resources/invoice.rb
+- lib/xendit/response.rb
+- lib/xendit/version.rb
+- sig/xendit.rbs
+homepage: https://github.com/nasrulgunawan/xendit-client
+licenses: []
+metadata:
+  homepage_uri: https://github.com/nasrulgunawan/xendit-client
+  source_code_uri: https://github.com/nasrulgunawan/xendit-client
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key: 
+specification_version: 4
+summary: Xendit Ruby Client Library
+test_files: []