bunny_storage_client 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3f0aea9ab1dacb2b662005e40f68f20c0d685eedb868b45741fc940f60f75d4a
+  data.tar.gz: ac6d9ed2ddc79efa19dcf068c0d43093fea1c0f4d0b0324d219aff66b449c149
+SHA512:
+  metadata.gz: dddf5d629fe5cc9d6f42fdb9f71af078dba20b2de12cc2be2c531977c725464c1dda3c985deccfae851f203fcd4f0e7cd0ffa6870ea88744b708ac9610ec85cc
+  data.tar.gz: 3ea20f37ed5010d17efe7e30a9b55a6e9dd84cb9d50acd612a0aa21f84d304939e8ab7b52e63b9617b3877e955d6fc6ce4f8a4cb696a320366cbb2c678f221b5

data/lib/bunny_storage_client.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'uri'
+require 'logger'
+
+# BunnyStorageClient is a Ruby SDK for interacting with BunnyCDN storage services.
+# API Reference: https://docs.bunny.net/reference/storage-api
+class BunnyStorageClient
+  VERSION = '1.0.0'
+  BASE_URL = 'https://storage.bunnycdn.com/'
+
+  # Initializes the SDK with access credentials and optional logger.
+  #
+  # @param access_key [String] the access key for storage operations
+  # @param api_key [String] the API key for cache purging
+  # @param storage_zone_name [String, nil] the default storage zone name
+  # @param logger [Logger] the logger instance for logging errors and info
+  def initialize(access_key, api_key, storage_zone_name = nil, logger = Logger.new($stdout))
+    @access_key = access_key
+    @api_key = api_key
+    @storage_zone_name = storage_zone_name
+    @logger = logger
+  end
+
+  # Sets the object filename and optional storage zone name for operations.
+  #
+  # @param filename [String] the name of the file
+  # @param storage_zone_name [String, nil] the storage zone name
+  # @return [BunnyStorageClient] the instance of the SDK
+  def object(filename, storage_zone_name = nil)
+    @filename = filename
+    @storage_zone_name = storage_zone_name || @storage_zone_name
+    self
+  end
+
+  # Retrieves a file from BunnyCDN storage.
+  #
+  # @param storage_zone_name [String, nil] the storage zone name
+  # @param filename [String, nil] the name of the file
+  # @return [String, nil] the file content
+  def get_file(storage_zone_name: nil, filename: nil, as: :string)
+    storage_zone_name ||= @storage_zone_name
+    filename ||= @filename
+
+    uri = build_uri(storage_zone_name, filename)
+    request = Net::HTTP::Get.new(uri)
+    request['AccessKey'] = @access_key
+    request['accept'] = '*/*'
+    response = make_request(uri, request)
+
+    if as == :file
+      generate_tempfile(filename, response.body)
+    else
+      response.body
+    end
+  rescue StandardError => e
+    @logger.error("Failed to get file from #{storage_zone_name}/#{filename}: #{e.message}")
+    nil
+  end
+
+  # Uploads a file to BunnyCDN storage.
+  #
+  # @param storage_zone_name [String, nil] the storage zone name
+  # @param filename [String, nil] the name of the file
+  # @param body [String, File, Tempfile] the file content
+  def upload_file(storage_zone_name: nil, filename: nil, body:)
+    storage_zone_name ||= @storage_zone_name
+    filename ||= @filename
+    uri = build_uri(storage_zone_name, filename)
+    request = Net::HTTP::Put.new(uri)
+    request['AccessKey'] = @access_key
+    request['content-type'] = 'application/octet-stream'
+
+    body = body.read if body.is_a?(File) || body.is_a?(Tempfile)
+    request.body = body
+    response = make_request(uri, request)
+
+    raise StandardError, "Response code #{response.code} is not OK!" unless success_code?(response.code)
+  rescue StandardError => e
+    @logger.error("Failed to upload file to #{storage_zone_name}/#{filename}: #{e.message}")
+    raise
+  end
+
+  # Deletes a file from BunnyCDN storage.
+  #
+  # @param storage_zone_name [String, nil] the storage zone name
+  # @param filename [String, nil] the name of the file
+  # @return [Bool, nil] true if the file was deleted successfully
+  def delete_file(storage_zone_name: nil, filename: nil)
+    storage_zone_name ||= @storage_zone_name
+    filename ||= @filename
+    uri = build_uri(storage_zone_name, filename)
+    request = Net::HTTP::Delete.new(uri)
+    request['AccessKey'] = @access_key
+    response = make_request(uri, request)
+    raise StandardError, "Response code #{response.code} is not OK!" unless success_code?(response.code)
+
+    true
+  rescue StandardError => e
+    @logger.error("Failed to delete file: #{e.message}")
+    raise
+  end
+
+  # Purges the cache for a specific file in BunnyCDN.
+  #
+  # @param storage_zone_name [String, nil] the storage zone name
+  # @param filename [String, nil] the name of the file
+  # @return [String, nil] the response code
+  def purge_cache(storage_zone_name: nil, filename: nil)
+    storage_zone_name ||= @storage_zone_name
+    filename ||= @filename
+    url = "https://#{storage_zone_name}.b-cdn.net/#{filename}"
+    uri = URI("https://api.bunny.net/purge?url=#{url}&async=true")
+    request = Net::HTTP::Post.new(uri)
+    request['AccessKey'] = @api_key
+    response = make_request(uri, request)
+
+    response.code
+  rescue StandardError => e
+    @logger.error("Failed to purge cache for #{storage_zone_name}/#{filename}: #{e.message}")
+    nil
+  end
+
+  private
+
+  def build_uri(storage_zone_name, filename)
+    url = File.join(BASE_URL, storage_zone_name, filename)
+    url = url[...-1] if url.end_with?(File::SEPARATOR)
+    URI(url)
+  end
+
+  def make_request(uri, request)
+    https = Net::HTTP.new(uri.host, uri.port)
+    https.use_ssl = true
+    https.request(request)
+  end
+
+  def generate_tempfile(filename, body)
+    file = Tempfile.new(filename)
+    file.write(body)
+    file.rewind
+    file
+  end
+
+  def success_code?(code)
+    code.to_i.between?(200, 299)
+  end
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: bunny_storage_client
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Ramit Koul
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-06-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+description: BunnyStorage Client is a Ruby SDK for interacting with BunnyCDN storage
+  services.
+email:
+- ramitkaul@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/bunny_storage_client.rb
+homepage: https://github.com/rkwap/bunny_storage_client
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/rkwap/bunny_storage_client
+  source_code_uri: https://github.com/rkwap/bunny_storage_client
+  changelog_uri: https://github.com/rkwap/bunny_storage_client/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.5'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.33
+signing_key:
+specification_version: 4
+summary: A Ruby Client SDK for interacting with BunnyCDN storage services.
+test_files: []