posthog-rails 3.5.0

data/lib/posthog/utils.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module PostHog
+  class InconclusiveMatchError < StandardError
+  end
+
+  module Utils
+    module_function
+
+    # public: Return a new hash with keys converted from strings to symbols
+    #
+    def symbolize_keys(hash)
+      hash.transform_keys(&:to_sym)
+    end
+
+    # public: Convert hash keys from strings to symbols in place
+    #
+    def symbolize_keys!(hash)
+      hash.replace symbolize_keys hash
+    end
+
+    # public: Return a new hash with keys as strings
+    #
+    def stringify_keys(hash)
+      hash.transform_keys(&:to_s)
+    end
+
+    # public: Returns a new hash with all the date values in the into iso8601
+    #         strings
+    #
+    def isoify_dates(hash)
+      hash.transform_values do |v|
+        datetime_in_iso8601(v)
+      end
+    end
+
+    # public: Converts all the date values in the into iso8601 strings in place
+    #
+    def isoify_dates!(hash)
+      hash.replace isoify_dates hash
+    end
+
+    # public: Returns a uid string
+    #
+    def uid
+      arr = SecureRandom.random_bytes(16).unpack('NnnnnN')
+      arr[2] = (arr[2] & 0x0fff) | 0x4000
+      arr[3] = (arr[3] & 0x3fff) | 0x8000
+
+      '%08x-%04x-%04x-%04x-%04x%08x' % arr # rubocop:disable Style/FormatStringToken, Style/FormatString
+    end
+
+    def datetime_in_iso8601(datetime)
+      case datetime
+      when Time
+        time_in_iso8601 datetime
+      when DateTime
+        time_in_iso8601 datetime.to_time
+      when Date
+        date_in_iso8601 datetime
+      else
+        datetime
+      end
+    end
+
+    def time_in_iso8601(time, fraction_digits = 3)
+      fraction =
+        (('.%06i' % time.usec)[0, fraction_digits + 1] if fraction_digits.positive?) # rubocop:disable Style/FormatString
+
+      "#{time.strftime('%Y-%m-%dT%H:%M:%S')}#{fraction}#{formatted_offset(time, true, 'Z')}"
+    end
+
+    def date_in_iso8601(date)
+      date.strftime('%F')
+    end
+
+    def formatted_offset(time, colon = true, alternate_utc_string = nil)
+      (time.utc? && alternate_utc_string) ||
+        seconds_to_utc_offset(time.utc_offset, colon)
+    end
+
+    def seconds_to_utc_offset(seconds, colon = true)
+      format((colon ? UTC_OFFSET_WITH_COLON : UTC_OFFSET_WITHOUT_COLON), (seconds.negative? ? '-' : '+'),
+             seconds.abs / 3600, (seconds.abs % 3600) / 60)
+    end
+
+    def convert_to_datetime(value)
+      if value.respond_to?(:strftime)
+        value
+
+      elsif value.respond_to?(:to_str)
+        begin
+          DateTime.parse(value)
+        rescue ArgumentError
+          raise InconclusiveMatchError, "#{value} is not in a valid date format"
+        end
+      else
+        raise InconclusiveMatchError, 'The date provided must be a string or date object'
+      end
+    end
+
+    UTC_OFFSET_WITH_COLON = '%s%02d:%02d'
+    UTC_OFFSET_WITHOUT_COLON = UTC_OFFSET_WITH_COLON.sub(':', '')
+
+    # TODO: Rename to `valid_regex?` in future version
+    def is_valid_regex(regex) # rubocop:disable Naming/PredicateName
+      Regexp.new(regex)
+      true
+    rescue RegexpError
+      false
+    end
+
+    # public: Get value from hash by symbol key first, then string key
+    #         Handles falsy values correctly (unlike ||)
+    #
+    # hash - Hash to lookup value in
+    # key  - Symbol or String key to lookup
+    #
+    # Returns the value if found, nil otherwise
+    def get_by_symbol_or_string_key(hash, key)
+      symbol_key = key.to_sym
+      string_key = key.to_s
+
+      if hash.key?(symbol_key)
+        hash[symbol_key]
+      else
+        hash[string_key]
+      end
+    end
+
+    class SizeLimitedHash < Hash
+      def initialize(max_length, ...)
+        super(...)
+        @max_length = max_length
+      end
+
+      def []=(key, value)
+        clear if length >= @max_length
+        super
+      end
+    end
+  end
+end

data/lib/posthog/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module PostHog
+  VERSION = '3.5.0'
+end

data/lib/posthog.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'posthog/version'
+require 'posthog/defaults'
+require 'posthog/utils'
+require 'posthog/field_parser'
+require 'posthog/client'
+require 'posthog/send_worker'
+require 'posthog/transport'
+require 'posthog/response'
+require 'posthog/logging'
+require 'posthog/exception_capture'
+require 'posthog/feature_flag_error'
+require 'posthog/feature_flag_result'

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification
+name: posthog-rails
+version: !ruby/object:Gem::Version
+  version: 3.5.0
+platform: ruby
+authors:
+- PostHog
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-02-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.0
+- !ruby/object:Gem::Dependency
+  name: posthog-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+description: Automatic exception tracking and instrumentation for Ruby on Rails applications
+  using PostHog
+email: hey@posthog.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/posthog.rb
+- lib/posthog/backoff_policy.rb
+- lib/posthog/client.rb
+- lib/posthog/defaults.rb
+- lib/posthog/exception_capture.rb
+- lib/posthog/feature_flag.rb
+- lib/posthog/feature_flag_error.rb
+- lib/posthog/feature_flag_result.rb
+- lib/posthog/feature_flags.rb
+- lib/posthog/field_parser.rb
+- lib/posthog/logging.rb
+- lib/posthog/message_batch.rb
+- lib/posthog/noop_worker.rb
+- lib/posthog/response.rb
+- lib/posthog/send_feature_flags_options.rb
+- lib/posthog/send_worker.rb
+- lib/posthog/transport.rb
+- lib/posthog/utils.rb
+- lib/posthog/version.rb
+homepage: https://github.com/PostHog/posthog-ruby
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.10
+signing_key:
+specification_version: 4
+summary: PostHog integration for Rails
+test_files: []