glib-web 7.1.0 → 7.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e178f9febdf54e054c6415f98e2dba1168d13ca1eea53c3a2e4c7aba62a434e9
-  data.tar.gz: f882a75e2b6c4c56b09b02419eb67b08e3d771958f5d3445f51ebbd93ffba806
+  metadata.gz: f04f2fbd4180b48a75af32ed8bd22321fc818224ecfb00802edc88b04992c287
+  data.tar.gz: a5340d00dee67cacb6175428130344910c8ddbeaf69e73a64e0b8bfd8f13f639
 SHA512:
-  metadata.gz: 5ad0e0bbe190e4e3c908561a379513b88d134cf2fafc454d8a843b0467a90d51577f9d1d40ab553774588ce23c454bccac19ba6608239fe5503ae2a5cf4ff4cd
-  data.tar.gz: 02f96c88f95bde1860894cb3e84d849b1a62bf35285178997ead4992ee4f9a8572ea9b48e7a5c73e0bf573cc3be56ee2dc056f2bce008792d180a286b8940813
+  metadata.gz: fbe295ea4776d69d9b07f9bf554be771195f1296f5a61c690274c28a72432b43d7f7093884b2fc20cf3d12502880590d86856cb965318c1b0d62383d7952801b
+  data.tar.gz: 7cbfcda693f301216d38735f7a288b6d0006f38f1bb59a1a5db6a6837d4ea1dbdea43f1663314b214bbdee046245e40c0a4126cceb4c7b35c2956b1541cd3140

data/app/models/g_log.rb

@@ -0,0 +1,92 @@
+# Top-level (NOT namespaced under Glib::) by design — same constraint as
+# SnapshotBlobReference: a top-level name keeps the facade's call-site
+# ergonomics (`DLog.error` → `GLog.error`, one character per site), and the
+# engine's autoloader resolves app/models files as top-level constants anyway.
+#
+# A routing facade, nothing more. The value is the seam: one place where
+# destination, level policy, and (later) redaction live, and call sites that
+# name their destination (`GLog.local_info` vs `GLog.error`).
+module GLog
+  # Use this to log functional errors that should not happen, but could happen
+  # since it is dependent on external factors.
+  def self.error(*args)
+    remote(:error, *args)
+  end
+
+  def self.warn(*args)
+    remote(:warn, *args)
+  end
+
+  def self.info(*args)
+    remote(:info, *args)
+  end
+
+  def self.error_excluding_test(*args)
+    if Rails.env.test?
+      warn(*args)
+    else
+      error(*args)
+    end
+  end
+
+  def self.local_debug(*args)
+    Rails.logger.debug(*args)
+  end
+
+  def self.local_info(*args)
+    Rails.logger.info(*args)
+  end
+
+  def self.local_warn(*args)
+    Rails.logger.warn(*args)
+  end
+
+  def self.local_error(*args)
+    Rails.logger.error(*args)
+  end
+
+  # Remote methods route to Rollbar when the host defines it. The gem itself
+  # declares no rollbar dependency (see glib-web.gemspec), so without it they
+  # fall through to the local logger tagged [GLog:remote] — non-Rollbar
+  # consumers still see the message, and tests can exercise both modes.
+  # Tagged receives the bare tag (tagged adds its own brackets), and a logger
+  # without `tagged` (a plain BroadcastLogger, no TaggedLogging) gets a
+  # prefixed message instead: the fallback must never raise on the logger
+  # shape the host configured.
+  def self.remote(level, *args)
+    if defined?(Rollbar)
+      Rollbar.public_send(level, *args)
+    else
+      log_remotely_locally(level, args)
+    end
+  end
+
+  def self.log_remotely_locally(level, args)
+    message = format_remote_args(args)
+    logger = Rails.logger
+    if logger.respond_to?(:tagged)
+      logger.tagged('GLog:remote') { |tagged_logger| tagged_logger.public_send(level, message) }
+    else
+      logger.public_send(level, "[GLog:remote] #{message}")
+    end
+  end
+
+  # Rollbar's API is variadic (`Rollbar.error(e, 'msg', extra)`), and the
+  # facade inherits that shape; the local logger's level methods take ONE
+  # message. Render the argument list into a single line: exceptions as
+  # `Class: message`, strings as-is, everything else (context hashes, kwargs
+  # collected into a trailing hash) via inspect, joined with ' | '.
+  def self.format_remote_args(args)
+    args.map do |arg|
+      if arg.is_a?(Exception)
+        "#{arg.class}: #{arg.message}"
+      elsif arg.is_a?(String)
+        arg
+      else
+        arg.inspect
+      end
+    end.join(' | ')
+  end
+
+  private_class_method :remote, :log_remotely_locally, :format_remote_args
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glib-web
 version: !ruby/object:Gem::Version
-  version: 7.1.0
+  version: 7.2.0
 platform: ruby
 authors:
 - ''
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-12 00:00:00.000000000 Z
+date: 2026-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activestorage
@@ -272,6 +272,7 @@ files:
 - app/models/concerns/glib/nilify_blanks.rb
 - app/models/concerns/glib/snapshot_v2.rb
 - app/models/concerns/glib/soft_deletable.rb
+- app/models/g_log.rb
 - app/models/glib/active_storage/attachment.rb
 - app/models/glib/active_storage/blob.rb
 - app/models/glib/application_record.rb