posthog-ruby 2.9.0 → 2.10.0

data/lib/posthog/field_parser.rb

@@ -1,30 +1,36 @@
+require 'posthog/logging'
+
 class PostHog
   class FieldParser
     class << self
       include PostHog::Utils
+      include PostHog::Logging
 
       # In addition to the common fields, capture accepts:
       #
       # - "event"
       # - "properties"
       # - "groups"
+      # - "uuid"
       def parse_for_capture(fields)
         common = parse_common_fields(fields)
 
         event = fields[:event]
         properties = fields[:properties] || {}
         groups = fields[:groups]
-
+        uuid = fields[:uuid]
         check_presence!(event, 'event')
         check_is_hash!(properties, 'properties')
 
         if groups
           check_is_hash!(groups, 'groups')
-          properties["$groups"] = groups
+          properties['$groups'] = groups
         end
 
         isoify_dates! properties
 
+        common['uuid'] = uuid if uuid? uuid
+
         common.merge(
           {
             type: 'capture',
@@ -49,7 +55,7 @@ class PostHog
           {
             type: 'identify',
             event: '$identify',
-            '$set': properties,
+            :'$set' => properties,
             properties: properties.merge(common[:properties] || {})
           }
         )
@@ -73,10 +79,10 @@ class PostHog
           {
             event: '$groupidentify',
             properties: {
-              "$group_type": group_type,
-              "$group_key": group_key,
-              "$group_set": properties.merge(common[:properties] || {})
-            },
+              :'$group_type' => group_type,
+              :'$group_key' => group_key,
+              :'$group_set' => properties.merge(common[:properties] || {})
+            }
           }
         )
       end
@@ -139,34 +145,39 @@ class PostHog
           active_feature_variants = {}
           feature_variants.each do |key, value|
             parsed[:properties]["$feature/#{key}"] = value
-            if value != false
-              active_feature_variants[key] = value
-            end
+            active_feature_variants[key] = value if value != false
           end
-          parsed[:properties]["$active_feature_flags"] = active_feature_variants.keys
+          parsed[:properties]['$active_feature_flags'] = active_feature_variants.keys
         end
         parsed
       end
 
       def check_timestamp!(timestamp)
-        unless timestamp.is_a? Time
-          raise ArgumentError, 'Timestamp must be a Time'
-        end
+        return if timestamp.is_a? Time
+
+        raise ArgumentError, 'Timestamp must be a Time'
       end
 
       # private: Ensures that a string is non-empty
       #
-      # obj    - String|Number that must be non-blank
-      # name   - Name of the validated value
+      # obj    - String|Number that must be not blank
+      # name   - The name of the validated value
       def check_presence!(obj, name)
-        if obj.nil? || (obj.is_a?(String) && obj.empty?)
-          raise ArgumentError, "#{name} must be given"
-        end
+        return unless obj.nil? || (obj.is_a?(String) && obj.empty?)
+
+        raise ArgumentError, "#{name} must be given"
       end
 
       def check_is_hash!(obj, name)
         raise ArgumentError, "#{name} must be a Hash" unless obj.is_a? Hash
       end
+
+      def uuid?(uuid)
+        is_valid_uuid = uuid.match?(/^[0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12}$/i) if uuid
+        logger.warn "UUID is not valid: #{uuid}. Ignoring it." unless is_valid_uuid
+
+        is_valid_uuid
+      end
     end
   end
 end

data/lib/posthog/logging.rb

@@ -42,7 +42,7 @@ class PostHog
           if defined?(Rails)
             Rails.logger
           else
-            logger = Logger.new STDOUT
+            logger = Logger.new $stdout
             logger.progname = 'PostHog'
             logger.level = Logger::WARN
             logger

data/lib/posthog/noop_worker.rb

@@ -9,7 +9,8 @@ class PostHog
       # Does nothing
     end
 
-    def is_requesting?
+    # TODO: Rename to `requesting?` in future version
+    def is_requesting? # rubocop:disable Naming/PredicateName
       false
     end
   end

data/lib/posthog/send_worker.rb

@@ -52,7 +52,8 @@ class PostHog
 
     # public: Check whether we have outstanding requests.
     #
-    def is_requesting?
+    # TODO: Rename to `requesting?` in future version
+    def is_requesting? # rubocop:disable Naming/PredicateName
       @lock.synchronize { !@batch.empty? }
     end
 

data/lib/posthog/transport.rb

@@ -21,10 +21,10 @@ class PostHog
         options[:port] = uri.port
       end
 
-      options[:host] = !options[:host].nil? ? options[:host] : HOST
-      options[:port] = !options[:port].nil? ? options[:port] : PORT
-      options[:ssl] = !options[:ssl].nil? ? options[:ssl] : SSL
-      
+      options[:host] = options[:host].nil? ? HOST : options[:host]
+      options[:port] = options[:port].nil? ? PORT : options[:port]
+      options[:ssl] = options[:ssl].nil? ? SSL : options[:ssl]
+
       @headers = options[:headers] || HEADERS
       @path = options[:path] || PATH
       @retries = options[:retries] || RETRIES
@@ -34,9 +34,7 @@ class PostHog
       http.use_ssl = options[:ssl]
       http.read_timeout = 8
       http.open_timeout = 4
-      if options[:skip_ssl_verification]
-        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
-      end
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE if options[:skip_ssl_verification]
 
       @http = http
     end
@@ -77,7 +75,7 @@ class PostHog
     def should_retry_request?(status_code, body)
       if status_code >= 500
         true # Server error
-      elsif status_code == 429
+      elsif status_code == 429 # rubocop:disable Lint/DuplicateBranch
         true # Rate limited
       elsif status_code >= 400
         logger.error(body)
@@ -123,7 +121,7 @@ class PostHog
 
       if self.class.stub
         logger.debug "stubbed request to #{@path}: " \
-                       "api key = #{api_key}, batch = #{JSON.generate(batch)}"
+                     "api key = #{api_key}, batch = #{JSON.generate(batch)}"
 
         [200, '{}']
       else
@@ -137,7 +135,7 @@ class PostHog
       attr_writer :stub
 
       def stub
-        @stub || ENV['STUB']
+        @stub || ENV.fetch('STUB', nil)
       end
     end
   end

data/lib/posthog/utils.rb

@@ -1,12 +1,11 @@
 require 'securerandom'
 
 class PostHog
-
   class InconclusiveMatchError < StandardError
   end
 
   module Utils
-    extend self
+    module_function
 
     # public: Return a new hash with keys converted from strings to symbols
     #
@@ -47,7 +46,8 @@ class PostHog
       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
+
+      '%08x-%04x-%04x-%04x-%04x%08x' % arr # rubocop:disable Style/FormatStringToken, Style/FormatString
     end
 
     def datetime_in_iso8601(datetime)
@@ -65,7 +65,7 @@ class PostHog
 
     def time_in_iso8601(time, fraction_digits = 3)
       fraction =
-        (('.%06i' % time.usec)[0, fraction_digits + 1] if fraction_digits > 0)
+        (('.%06i' % time.usec)[0, fraction_digits + 1] if fraction_digits > 0) # rubocop:disable Style/FormatString
 
       "#{time.strftime('%Y-%m-%dT%H:%M:%S')}#{fraction}#{formatted_offset(time, true, 'Z')}"
     end
@@ -75,44 +75,39 @@ class PostHog
     end
 
     def formatted_offset(time, colon = true, alternate_utc_string = nil)
-      time.utc? && alternate_utc_string ||
+      (time.utc? && alternate_utc_string) ||
         seconds_to_utc_offset(time.utc_offset, colon)
     end
 
     def seconds_to_utc_offset(seconds, colon = true)
-      (colon ? UTC_OFFSET_WITH_COLON : UTC_OFFSET_WITHOUT_COLON) % [
-        (seconds < 0 ? '-' : '+'),
-        (seconds.abs / 3600),
-        ((seconds.abs % 3600) / 60)
-      ]
+      format((colon ? UTC_OFFSET_WITH_COLON : UTC_OFFSET_WITHOUT_COLON), (seconds < 0 ? '-' : '+'),
+             seconds.abs / 3600, (seconds.abs % 3600) / 60)
     end
 
     def convert_to_datetime(value)
       if value.respond_to?(:strftime)
-        parsed_date = value
-        return parsed_date
+        value
+
       elsif value.respond_to?(:to_str)
         begin
-          parsed_date = DateTime.parse(value)
-          return parsed_date
-        rescue ArgumentError => e
-          raise InconclusiveMatchError.new("#{value} is not in a valid date format")
+          DateTime.parse(value)
+        rescue ArgumentError
+          raise InconclusiveMatchError, "#{value} is not in a valid date format"
         end
       else
-        raise InconclusiveMatchError.new("The date provided must be a string or date object")
+        raise InconclusiveMatchError, 'The date provided must be a string or date object'
       end
     end
 
-    UTC_OFFSET_WITH_COLON = '%s%02d:%02d'
+    UTC_OFFSET_WITH_COLON = '%s%02d:%02d'.freeze
     UTC_OFFSET_WITHOUT_COLON = UTC_OFFSET_WITH_COLON.sub(':', '')
 
-    def is_valid_regex(regex)
-      begin
-        Regexp.new(regex)
-        return true
-      rescue RegexpError
-        return false
-      end
+    # 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
 
     class SizeLimitedHash < Hash
@@ -122,9 +117,7 @@ class PostHog
       end
 
       def []=(key, value)
-        if length >= @max_length
-          clear
-        end
+        clear if length >= @max_length
         super
       end
     end

data/lib/posthog/version.rb

@@ -1,3 +1,3 @@
 class PostHog
-  VERSION = '2.9.0'
+  VERSION = '2.10.0'.freeze
 end

data/lib/posthog-ruby.rb

@@ -1 +1,3 @@
+# rubocop:disable Naming/FileName
 require 'posthog'
+# rubocop:enable Naming/FileName

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: posthog-ruby
 version: !ruby/object:Gem::Version
-  version: 2.9.0
+  version: 2.10.0
 platform: ruby
 authors:
 - ''
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-30 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -24,104 +23,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1'
-- !ruby/object:Gem::Dependency
-  name: commander
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.4'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.4'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.1'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.13'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.13'
-- !ruby/object:Gem::Dependency
-  name: tzinfo
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '7.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '7.1'
-- !ruby/object:Gem::Dependency
-  name: oj
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.16.3
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.16.3
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.51.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.51.0
 description: The PostHog ruby library
 email: hey@posthog.com
 executables:
@@ -151,8 +52,8 @@ files:
 homepage: https://github.com/PostHog/posthog-ruby
 licenses:
 - MIT
-metadata: {}
-post_install_message:
+metadata:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -167,8 +68,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.10
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: PostHog library
 test_files: []