samcart_api 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 06fe1b45c2e3f892bd12685da744ad03e5f2b347714c2f5b0f142aaf6cd16a8d
+  data.tar.gz: 922fbf5b295f2edbb889128f2a68108c9093516deafd711677d6524be34c966e
+SHA512:
+  metadata.gz: '08ee150d36a9cf379a8f76e96ea40e087ff83e27d8946ff069fc3cc18f3f9bec64fe43b7f514e94334ee36ad248ffba1d22892c8e97ef9de2b2a613af651e524'
+  data.tar.gz: e2d035a48f85abb24d477881761334ca9cd8a277eacf334e1125d1596076ceea0d87e8cb1885f680fa3ac86a5c1be4ce5267395851861167b94cfcfa5a66b5ad

data/lib/samcart_api/api_request.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module SamcartApi
+  class ApiRequest
+    def initialize(method, path, params, api_key)
+      @method = method
+      @path = path
+      @params = params
+      @api_key = api_key
+      @version = SamcartApi.configuration.version
+    end
+
+    def perform
+      response = connection.send(@method) do |req|
+        req.url "/#{@version}#{@path}"
+        req.params = @params if @params
+        req.headers['Accept'] = 'application/json'
+        req.headers['sc-api'] = @api_key
+        req.headers['Content-Type'] = 'application/json'
+      end
+
+      handle_response(response)
+    end
+
+    private
+
+    def connection
+      @connection ||= Faraday.new(url: SamcartApi.configuration.api_url) do |conn|
+        conn.response :json
+        conn.adapter Faraday.default_adapter
+      end
+    end
+
+    def handle_response(response)
+      case response.status
+      when 200..299
+        response.body
+      when 401
+        raise AuthenticationError, 'Invalid API key'
+      when 403
+        raise AuthenticationError, 'Access denied'
+      when 404
+        raise ApiError, 'Resource not found'
+      else
+        raise ApiError, "API request failed: #{response.body["message"] || response.body}"
+      end
+    end
+  end
+end

data/lib/samcart_api/client.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module SamcartApi
+  # Client for interacting with the SamCart API
+  class Client
+    def initialize(api_key = nil)
+      @api_key = api_key || SamcartApi.configuration.api_key
+      raise ConfigurationError, 'API key is required' unless @api_key
+    end
+
+    def products
+      @products ||= Product.new(self)
+    end
+
+    def orders
+      @orders ||= Order.new(self)
+    end
+
+    def get(path, params = {})
+      request(:get, path, params)
+    end
+
+    def post(path, body = {})
+      request(:post, path, body)
+    end
+
+    def put(path, body = {})
+      request(:put, path, body)
+    end
+
+    def delete(path)
+      request(:delete, path)
+    end
+
+    private
+
+    def request(method, path, params = nil)
+      ApiRequest.new(method, path, params, @api_key).perform
+    end
+  end
+end

data/lib/samcart_api/order.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module SamcartApi
+  class Order
+    RESOURCE_PATH = '/orders'
+
+    class << self
+      def find(id)
+        new(id).find
+      end
+    end
+
+    def initialize(id)
+      @id = id
+    end
+
+    def find
+      order = client.get("#{RESOURCE_PATH}/#{id}")
+      SamcartApi::SamcartObject.new(order)
+    end
+
+    private
+
+    attr_reader :id
+
+    def client
+      @client ||= SamcartApi::Client.new
+    end
+  end
+end

data/lib/samcart_api/product.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module SamcartApi
+  class Product
+    RESOURCE_PATH = '/products'
+
+    class << self
+      def find(id)
+        new(id).find
+      end
+    end
+
+    def initialize(id)
+      @id = id
+    end
+
+    def find
+      product = client.get("#{RESOURCE_PATH}/#{id}")
+      SamcartApi::SamcartObject.new(product)
+    end
+
+    private
+
+    attr_reader :id
+
+    def client
+      @client ||= SamcartApi::Client.new
+    end
+  end
+end

data/lib/samcart_api/samcart_object.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module SamcartApi
+  class SamcartObject
+    def initialize(attributes = {})
+      @attributes = attributes
+    end
+
+    def [](key)
+      @attributes[key]
+    end
+
+    def method_missing(method_name, *args)
+      if @attributes.key?(method_name.to_s)
+        @attributes[method_name.to_s]
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      @attributes.key?(method_name.to_s) || super
+    end
+
+    def to_h
+      @attributes
+    end
+  end
+end

data/lib/samcart_api.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'json'
+require 'active_support'
+require 'active_support/core_ext'
+
+module SamcartApi
+  VERSION = '0.1.0'
+
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+  class AuthenticationError < Error; end
+  class ApiError < Error; end
+
+  autoload :SamcartObject, 'samcart_api/samcart_object'
+  autoload :Product, 'samcart_api/product'
+  autoload :Order, 'samcart_api/order'
+  autoload :Client, 'samcart_api/client'
+  autoload :ApiRequest, 'samcart_api/api_request'
+
+  class << self
+    def configure
+      yield(configuration)
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+  end
+
+  class Configuration
+    attr_accessor :api_key, :api_url, :version
+
+    def initialize
+      @api_url = 'https://api.samcart.com'
+      @version = 'v1'
+    end
+  end
+end

metadata

@@ -0,0 +1,151 @@
+--- !ruby/object:Gem::Specification
+name: samcart_api
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- Olumuyiwa Osiname
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-03-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.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: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.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'
+description: A Ruby gem that provides a simple interface for interacting with the
+  SamCart API, focusing on products and orders.
+email:
+- osiname@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/samcart_api.rb
+- lib/samcart_api/api_request.rb
+- lib/samcart_api/client.rb
+- lib/samcart_api/order.rb
+- lib/samcart_api/product.rb
+- lib/samcart_api/samcart_object.rb
+homepage: https://github.com/oluosiname/samcart_api
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/oluosiname/samcart_api
+  source_code_uri: https://github.com/oluosiname/samcart_api
+  changelog_uri: https://github.com/oluosiname/samcart_api/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.3
+signing_key:
+specification_version: 4
+summary: Ruby gem for interacting with the SamCart API
+test_files: []