featurevisor 0.1.1

data/lib/featurevisor/logger.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+module Featurevisor
+  # Log levels for the logger
+  LOG_LEVELS = %w[fatal error warn info debug].freeze
+  DEFAULT_LOG_LEVEL = "info".freeze
+  LOGGER_PREFIX = "[Featurevisor]".freeze
+
+  # Logger class for handling different log levels
+  class Logger
+    attr_reader :level, :handler
+
+    # Initialize a new logger
+    # @param options [Hash] Logger options
+    # @option options [String] :level Log level (default: "info")
+    # @option options [Proc] :handler Custom log handler (default: default_log_handler)
+    def initialize(options = {})
+      @level = options[:level] || DEFAULT_LOG_LEVEL
+      @handler = options[:handler] || method(:default_log_handler)
+    end
+
+    # Set the log level
+    # @param level [String] New log level
+    def set_level(level)
+      @level = level
+    end
+
+    # Log a message at a specific level
+    # @param level [String] Log level
+    # @param message [String] Log message
+    # @param details [Hash, nil] Additional details
+    def log(level, message, details = nil)
+      return unless should_handle?(level)
+
+      @handler.call(level, message, details)
+    end
+
+    # Log a debug message
+    # @param message [String] Log message
+    # @param details [Hash, nil] Additional details
+    def debug(message, details = nil)
+      log("debug", message, details)
+    end
+
+    # Log an info message
+    # @param message [String] Log message
+    # @param details [Hash, nil] Additional details
+    def info(message, details = nil)
+      log("info", message, details)
+    end
+
+    # Log a warning message
+    # @param message [String] Log message
+    # @param details [Hash, nil] Additional details
+    def warn(message, details = nil)
+      log("warn", message, details)
+    end
+
+    # Log an error message
+    # @param message [String] Log message
+    # @param details [Hash, nil] Additional details
+    def error(message, details = nil)
+      log("error", message, details)
+    end
+
+    # Log a fatal message
+    # @param message [String] Log message
+    # @param details [Hash, nil] Additional details
+    def fatal(message, details = nil)
+      log("fatal", message, details)
+    end
+
+    private
+
+    # Check if the current level should handle the given log level
+    # @param log_level [String] Log level to check
+    # @return [Boolean] True if should handle
+    def should_handle?(log_level)
+      current_index = LOG_LEVELS.index(@level)
+      target_index = LOG_LEVELS.index(log_level)
+
+      return false if current_index.nil? || target_index.nil?
+
+      current_index >= target_index
+    end
+
+    # Default log handler that outputs to console
+    # @param level [String] Log level
+    # @param message [String] Log message
+    # @param details [Hash, nil] Additional details
+    def default_log_handler(level, message, details = nil)
+      method_name = case level
+                   when "info" then "puts"
+                   when "warn" then "warn"
+                   when "error", "fatal" then "warn"
+                   else "puts"
+                   end
+
+      case method_name
+      when "puts"
+        if details && !details.empty?
+          Kernel.puts("#{LOGGER_PREFIX} #{message} #{details.inspect}")
+        else
+          Kernel.puts("#{LOGGER_PREFIX} #{message}")
+        end
+      when "warn"
+        if details && !details.empty?
+          Kernel.warn("#{LOGGER_PREFIX} #{message} #{details.inspect}")
+        else
+          Kernel.warn("#{LOGGER_PREFIX} #{message}")
+        end
+      end
+    end
+  end
+
+  # Create a new logger instance
+  # @param options [Hash] Logger options
+  # @return [Logger] New logger instance
+  def self.create_logger(options = {})
+    Logger.new(options)
+  end
+
+  # Default log handler function
+  # @param level [String] Log level
+  # @param message [String] Log message
+  # @param details [Hash, nil] Additional details
+  def self.default_log_handler(level, message, details = nil)
+    method_name = case level
+                 when "info" then "puts"
+                 when "warn" then "warn"
+                 when "error", "fatal" then "warn"
+                 else "puts"
+                 end
+
+    case method_name
+    when "puts"
+      if details && !details.empty?
+        Kernel.puts("#{LOGGER_PREFIX} #{message} #{details.inspect}")
+      else
+        Kernel.puts("#{LOGGER_PREFIX} #{message}")
+      end
+    when "warn"
+      if details && !details.empty?
+        Kernel.warn("#{LOGGER_PREFIX} #{message} #{details.inspect}")
+      else
+        Kernel.warn("#{LOGGER_PREFIX} #{message}")
+      end
+    end
+  end
+end

data/lib/featurevisor/murmurhash.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Featurevisor
+  # MurmurHash v3 implementation ported from TypeScript
+  # Original: https://github.com/perezd/node-murmurhash
+  # @param key [String, Array<Integer>] Input key to hash
+  # @param seed [Integer] Seed value for the hash
+  # @return [Integer] 32-bit hash value
+  def self.murmur_hash_v3(key, seed)
+    # Convert string to bytes if needed
+    key = key.bytes if key.is_a?(String)
+
+    remainder = key.length & 3  # key.length % 4
+    bytes = key.length - remainder
+    h1 = seed
+    c1 = 0xcc9e2d51
+    c2 = 0x1b873593
+    i = 0
+
+    # Process 4-byte chunks
+    while i < bytes
+      k1 = (key[i] & 0xff) |
+            ((key[i + 1] & 0xff) << 8) |
+            ((key[i + 2] & 0xff) << 16) |
+            ((key[i + 3] & 0xff) << 24)
+      i += 4
+
+      k1 = ((k1 & 0xffff) * c1 + ((((k1 >> 16) * c1) & 0xffff) << 16)) & 0xffffffff
+      k1 = (k1 << 15) | (k1 >> 17)
+      k1 = ((k1 & 0xffff) * c2 + ((((k1 >> 16) * c2) & 0xffff) << 16)) & 0xffffffff
+
+      h1 ^= k1
+      h1 = (h1 << 13) | (h1 >> 19)
+      h1b = ((h1 & 0xffff) * 5 + ((((h1 >> 16) * 5) & 0xffff) << 16)) & 0xffffffff
+      h1 = (h1b & 0xffff) + 0x6b64 + ((((h1b >> 16) + 0xe654) & 0xffff) << 16)
+    end
+
+    # Process remaining bytes
+    k1 = 0
+
+    # Handle remainder processing with fall-through behavior like TypeScript switch
+    if remainder >= 3
+      k1 ^= (key[i + 2] & 0xff) << 16
+    end
+    if remainder >= 2
+      k1 ^= (key[i + 1] & 0xff) << 8
+    end
+    if remainder >= 1
+      k1 ^= key[i] & 0xff
+
+      k1 = ((k1 & 0xffff) * c1 + ((((k1 >> 16) * c1) & 0xffff) << 16)) & 0xffffffff
+      k1 = (k1 << 15) | (k1 >> 17)
+      k1 = ((k1 & 0xffff) * c2 + ((((k1 >> 16) * c2) & 0xffff) << 16)) & 0xffffffff
+      h1 ^= k1
+    end
+
+    h1 ^= key.length
+
+    # Final mixing - use unsigned right shift equivalent
+    h1 ^= h1 >> 16
+    h1 = ((h1 & 0xffff) * 0x85ebca6b + ((((h1 >> 16) * 0x85ebca6b) & 0xffff) << 16)) & 0xffffffff
+    h1 ^= h1 >> 13
+    h1 = ((h1 & 0xffff) * 0xc2b2ae35 + ((((h1 >> 16) * 0xc2b2ae35) & 0xffff) << 16)) & 0xffffffff
+    h1 ^= h1 >> 16
+
+    # Convert to unsigned 32-bit integer (equivalent to >>> 0 in TypeScript)
+    h1 & 0xffffffff
+  end
+end

data/lib/featurevisor/version.rb

@@ -0,0 +1,3 @@
+module Featurevisor
+  VERSION = "0.1.1"
+end

data/lib/featurevisor.rb

@@ -0,0 +1,17 @@
+require_relative "featurevisor/version"
+require_relative "featurevisor/murmurhash"
+require_relative "featurevisor/compare_versions"
+require_relative "featurevisor/logger"
+require_relative "featurevisor/emitter"
+require_relative "featurevisor/conditions"
+require_relative "featurevisor/datafile_reader"
+require_relative "featurevisor/bucketer"
+require_relative "featurevisor/hooks"
+require_relative "featurevisor/evaluate"
+require_relative "featurevisor/instance"
+require_relative "featurevisor/child_instance"
+require_relative "featurevisor/events"
+
+module Featurevisor
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: featurevisor
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Fahad Heylaal
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Featurevisor Ruby SDK with CLI tools for feature flags management
+executables:
+- featurevisor
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/cli.rb
+- bin/commands.rb
+- bin/commands/assess_distribution.rb
+- bin/commands/benchmark.rb
+- bin/commands/test.rb
+- bin/featurevisor
+- lib/featurevisor.rb
+- lib/featurevisor/bucketer.rb
+- lib/featurevisor/child_instance.rb
+- lib/featurevisor/compare_versions.rb
+- lib/featurevisor/conditions.rb
+- lib/featurevisor/datafile_reader.rb
+- lib/featurevisor/emitter.rb
+- lib/featurevisor/evaluate.rb
+- lib/featurevisor/events.rb
+- lib/featurevisor/hooks.rb
+- lib/featurevisor/instance.rb
+- lib/featurevisor/logger.rb
+- lib/featurevisor/murmurhash.rb
+- lib/featurevisor/version.rb
+homepage: https://featurevisor.com
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Featurevisor Ruby SDK
+test_files: []