og_pilot_ruby 0.4.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c58555c3ed39eb0b1bd4948ef10c79492111730917b25ba1d30455079447917
-  data.tar.gz: 12b44e9f843610011c42a308a2907449c30598f413aa3a1edc8fa3a3c73b653f
+  metadata.gz: 7dfbdfc6efc8c0fc36a6b92c6b99af56c0e0ef3b3831d7b91b8e56056b09dd16
+  data.tar.gz: 4fe12f91a949bd6117a915b48b88df8d25fda2d9665a5bba1d78533557cad202
 SHA512:
-  metadata.gz: 9f99983ecc6ee9de233d087ca93ea3b82f84a7f89c1d5aa75d79c8dbe1aa4bd7ad312cf752ed8f614af04e445028e84c4a8b8969836dd9bb3a51f6d8d6f6feb1
-  data.tar.gz: cc38075c320be5bfda43e9d1d0d957ecb8a67564908e56e6b04c5d003ff04cc3098f9b91b11ccda2f43bd37483dc2715ac7c7d58b03c7efd16113bdc80ad000f
+  metadata.gz: 6cb305db104f09b0fb0cfc430f8fd1fdc276d02d048e4f4936bde4ba5273569568e351e5fdafe9287bb33fc9f9ba5d94279c38f161ebb4f1a36a87aa56a331c0
+  data.tar.gz: e144441605b592d95c672242cb90813c1056dc498fd045a10ee0882dfa157a30600585f11effa2fb976983189e14a53170888a3323c8f4cc3198f458c96a6ca8

data/README.md

@@ -61,6 +61,15 @@ image_url = OgPilotRuby.create_image(
 If you omit `iat`, OG Pilot will cache the image indefinitely. Provide an `iat` to
 refresh the cache daily.
 
+### Fail-safe behavior
+
+`create_image` is non-blocking. If any error occurs (request, configuration,
+validation, parsing, etc.), the gem does not raise to your app and logs an
+error-level message instead.
+
+- URL mode (`json: false`, default): returns `nil`
+- JSON mode (`json: true`): returns `{ "image_url" => nil }`
+
 ### Template helpers
 
 `create_image` defaults to the `page` template when `template` is omitted.
@@ -119,7 +128,7 @@ The gem handles `iss` (domain) and `sub` (API key prefix) automatically.
 
 | Option    | Default | Description                                                              |
 |-----------|---------|--------------------------------------------------------------------------|
-| `json`    | `false` | When `true`, sends `Accept: application/json` and parses the JSON response |
+| `json`    | `false` | When `true`, sends `Accept: application/json` and parses the JSON response. On failure, returns `{ "image_url" => nil }` |
 | `headers` | —       | Additional HTTP headers to include with the request                      |
 | `default` | `false` | Forces `path` to `/` when `true`, unless a manual `path` is provided (see [Path handling](#path-handling)) |
 
@@ -173,7 +182,7 @@ Fetch JSON metadata instead:
 ```ruby
 payload = {
   template: "page",
-  title: "Hello OG Pilot"q
+  title: "Hello OG Pilot"
 }
 
 data = OgPilotRuby.create_image(**payload, json: true)
@@ -190,7 +199,7 @@ Multiple extensions are also stripped (`/archive.tar.gz` becomes `/archive`).
 Dotfiles like `/.hidden` are left unchanged. Query strings are preserved.
 
 ```ruby
-OgPilotRuby.configure do |config|›
+OgPilotRuby.configure do |config|
   config.strip_extensions = true
 end
 

data/lib/og_pilot_ruby/client.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "json"
+require "logger"
 require "net/http"
 require "uri"
 
@@ -32,12 +33,31 @@ module OgPilotRuby
       else
         response["Location"] || final_uri.to_s
       end
+    rescue StandardError => e
+      log_create_image_failure(e, json:)
+      json ? { "image_url" => nil } : nil
     end
 
     private
 
       attr_reader :config
 
+      def log_create_image_failure(error, json:)
+        mode = json ? "json" : "url"
+        message = "OgPilotRuby create_image failed (mode=#{mode}): #{error.class}: #{error.message}"
+        create_image_logger&.error(message)
+      rescue StandardError
+        nil
+      end
+
+      def create_image_logger
+        if defined?(::Rails) && ::Rails.respond_to?(:logger) && ::Rails.logger
+          ::Rails.logger
+        else
+          @create_image_logger ||= Logger.new($stderr)
+        end
+      end
+
       def request(uri, json:, headers:, method: :post, redirects_left: MAX_REDIRECTS)
         http = Net::HTTP.new(uri.host, uri.port)
         http.use_ssl = uri.scheme == "https"

data/lib/og_pilot_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OgPilotRuby
-  VERSION = "0.4.1"
+  VERSION = "0.4.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: og_pilot_ruby
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.2
 platform: ruby
 authors:
 - Sunergos IT LLC