bit_analytics 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: 8978bfb9dd2bf699d69081776c673859b7893687
+  data.tar.gz: 22dce94749ec582804d3fba2de027effa55de4b9
+!binary "U0hBNTEy":
+  metadata.gz: a24a71ba813bdb1b5daf2177450a91bd7fb544d322cbb7e10dd58e82006751678cf6a74a79781606b034b61703f5672b16584c7cbd39aae612076bdbe1a4f039
+  data.tar.gz: c5fdc49e40652c6eb5529f1cb23106ce3bf1f3cf5f0557d0112157da15aaf7f1cc4da956ab09c829ed63d08692c03ff6e534686db5add1e01e25a738fdbef3df

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in bit_analytics.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,28 @@
+Copyright: 2012 by Doist Ltd., Amir Salihefendic
+Copyright (c) 2014 Jure Triglav.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    1. Redistributions of source code must retain the above copyright notice,
+       this list of conditions and the following disclaimer.
+
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+    3. Neither the name of BitAnalytics nor the names of its contributors may be used
+       to endorse or promote products derived from this software without
+       specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,115 @@
+# bit_analytics: a powerful analytics library for Redis for Ruby
+
+This Ruby gem (a port of [@amix's bitmapist library for Python](https://github.com/Doist/bitmapist)) makes it possible to implement real-time, highly scalable analytics that can answer following questions:
+
+* Has user 123 been online today? This week? This month?
+* Has user 123 performed action "X"?
+* How many users have been active have this month? This hour?
+* How many unique users have performed action "X" this week?
+* How many % of users that were active last week are still active?
+* How many % of users that were active last month are still active this month?
+
+This gem is very easy to use and enables you to create your own reports easily.
+
+Using Redis bitmaps you can store events for millions of users in a very little amount of memory (megabytes).
+You should be careful about using huge ids (e.g. 2^32 or bigger) as this could require larger amounts of memory.
+
+If you want to read more about bitmaps please read following:
+
+* http://blog.getspool.com/2011/11/29/fast-easy-realtime-metrics-using-redis-bitmaps/
+* http://redis.io/commands/setbit
+* http://en.wikipedia.org/wiki/Bit_array
+* http://www.slideshare.net/crashlytics/crashlytics-on-redis-analytics
+* http://amix.dk/blog/post/19714 [my blog post]
+
+Requires Redis 2.6+.
+
+# Installation
+
+```
+$ gem install bit_analytics
+```
+
+# Ports
+
+* Original Python library: https://github.com/Doist/bitmapist
+* PHP port: https://github.com/jeremyFreeAgent/Bitter
+
+# Examples
+
+Setting things up:
+
+```ruby
+require 'date'
+now = Time.now.getutc
+last_month = (Date.today << 1).to_time
+
+# This connects to the default Redis (localhost:6379)
+@bit_analytics = BitAnalytics.new
+
+# You can also use custom Redis options
+@bit_analytics = BitAnalytics.new(host: "10.0.1.1", port: 6380)
+```
+
+Mark user 123 as active and has played a song:
+
+```ruby
+@bit_anaytics.mark_event('active', 123)
+@bit_anaytics.mark_event('song:played', 123)
+```
+
+Answer if user 123 has been active this month:
+
+```ruby
+@bit_analytics.month_events('active', now.year, now.month).includes?(123)
+@bit_analytics.month_events('song:played', now.year, now.month).includes?(123)
+@bit_analytics.month_events('active', now.year, now.month).has_events_marked == true
+```
+
+How many users have been active this week?:
+
+```ruby
+this_week = Time.now.strftime('%V')
+@bit_analytics.week_events('active', now.year, this_week)
+```
+
+Perform bit operations. How many users that have been active last month are still active this month?
+
+```ruby
+active_2_months = @bit_analytics.bit_op_and(
+    @bit_analytics.month_events('active', last_month.year, last_month.month),
+    @bit_analytics.month_events('active', now.year, now.month)
+)
+puts active_2_months.length
+ 
+# Is 123 active for 2 months?
+active_2_months.includes?(123)
+```
+
+Work with nested bit operations (imagine what you can do with this ;))!
+
+```ruby
+active_2_months = @bit_analytics.bit_op_and(
+    @bit_analytics.bit_op_and(
+        @bit_analytics.month_events('active', last_month.year, last_month.month),
+        @bit_analytics.month_events('active', now.year, now.month)
+    ),
+    @bit_analytics.month_events('active', now.year, now.month)
+)
+puts active_2_months.length
+active_2_months.includes?(123)
+
+# Delete the temporary AND operation
+active_2_months.delete
+```
+
+Tracking hourly is disabled by default to save memory, but you can supply an extra argument to `mark_event` to track events hourly:
+
+```ruby
+@bit_analytics.mark_event('active', 123, track_hourly: true)
+```
+
+Original library: Copyright: 2012 by Doist Ltd. Developer: Amir Salihefendic ( http://amix.dk ) License: BSD
+
+Ruby port: Copyright 2014 Jure Triglav License: BSD
+

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.options = "-v"
+  t.test_files = FileList["test/*_test.rb"]
+end

data/bit_analytics.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bit_analytics/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "bit_analytics"
+  spec.version       = BitAnalytics::VERSION
+  spec.authors       = ["Jure Triglav"]
+  spec.email         = ["juretriglav@gmail.com"]
+  spec.description   = %q{Analytics library built with Redis bitmaps}
+  spec.summary       = %q{Implements a powerful analytics library on top of Redis's support for bitmaps and bitmap operations.}
+  spec.homepage      = "http://www.github.com/jure/bit_analytics"
+  spec.license       = "BSD"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "redis", "~> 3.0"
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "pry"
+end

data/lib/bit_analytics/version.rb

@@ -0,0 +1,3 @@
+class BitAnalytics
+  VERSION = "0.0.1"
+end

data/lib/bit_analytics.rb

@@ -0,0 +1,259 @@
+require "bit_analytics/version"
+require 'redis'
+
+class BitAnalytics
+  attr_accessor :redis
+
+  def initialize(options=nil)
+    @redis = if options
+      Redis.new(options)
+    else
+      Redis.new
+    end
+  end
+
+  #--- Events marking and deleting ---
+  # Marks an event for hours, days, weeks and months.
+  # :param :event_name The name of the event, could be "active" or "new_signups"
+  # :param :uuid An unique id, typically user id. The id should not be huge, read Redis documentation why (bitmaps)
+  # :param :now Which date should be used as a reference point, default is `datetime.utcnow`
+  # :param :track_hourly Should hourly stats be tracked, defaults to bitanalytics.TRACK_HOURLY, but an be changed
+  # Examples:
+  # Mark id 1 as active
+  # mark_event('active', 1)
+  # Mark task completed for id 252
+  # mark_event('tasks:completed', 252)
+  def mark_event(event_name, uuid, now: nil, track_hourly: nil)
+    # Has memory applications
+    track_hourly ||= false
+    now ||= Time.now.getutc
+    # E.g. ['2014', '03'] for 17th of January 2014
+    iso_date = now.strftime('%Y-%V').split('-')
+
+    events = [
+      MonthEvents.new(event_name, now.year, now.month),
+      WeekEvents.new(event_name, iso_date[0], iso_date[1]),
+      DayEvents.new(event_name, now.year, now.month, now.day),
+    ]
+
+    if track_hourly
+      events << HourEvents.new(event_name, now.year, now.month, now.day, now.hour) 
+    end
+
+    @redis.pipelined do 
+      events.each do |event|
+        @redis.setbit(event.redis_key, uuid, 1)
+      end
+    end
+  end
+
+  # Delete all events from the database.
+  def delete_all_events
+    keys = @redis.keys('bitanalytics_*')
+    @redis.del(*keys) unless keys.empty?
+  end
+
+  # Delete all temporary keys that are used when using bit operations.
+  def delete_temporary_bitop_keys
+    keys = @redis.keys('bitanalytics_bitop_*')
+    @redis.del(keys) unless keys.empty?
+  end
+
+  #--- Events ---
+
+  def month_events(event_name, year, month)
+    month_events = MonthEvents.new(event_name, year, month)
+    month_events.redis = @redis
+    month_events
+  end
+
+  def week_events(event_name, year, week)
+    week_events = WeekEvents.new(event_name, year, week)
+    week_events.redis = @redis
+    week_events
+  end
+
+  def day_events(event_name, year, month, day)
+    day_events = DayEvents.new(event_name, year, month, day)
+    day_events.redis = @redis
+    day_events
+  end
+
+  def hour_events(event_name, year, month, day, hour)
+    hour_events = HourEvents.new(event_name, year, month, day, hour)
+    hour_events.redis = @redis
+    hour_events
+  end
+
+  #--- BitOps ---
+
+  def bit_op_and(event, *events)
+    bit_operation = BitOperation.new('AND', event, *events)
+    bit_operation.redis = @redis
+    bit_operation.execute
+    bit_operation
+  end
+
+  def bit_op_or(event, *events)
+    bit_operation = BitOperation.new('OR', event, *events)
+    bit_operation.redis = @redis
+    bit_operation.execute
+    bit_operation
+  end
+
+  def bit_op_xor(event, *events)
+    bit_operation = BitOperation.new('XOR', event, *events)
+    bit_operation.redis = @redis
+    bit_operation.execute
+    bit_operation
+  end
+
+  #--- Private ---
+
+  def _prefix_key(event_name, date)
+    return 'bitanalytics_%s_%s' % [event_name, date]
+  end
+
+  #--- Events ---
+
+  # Extends with an obj.has_events_marked()
+  # that returns `True` if there are any events marked,
+  # otherwise `False` is returned.
+
+  # Extens also with a obj.delete()
+  # (useful for deleting temporary calculations).
+
+  module MixinEventsMisc
+    def has_events_marked
+      @redis.get(@redis_key) != nil
+    end
+    def delete
+      @redis.del(@redis_key)
+    end
+  end
+
+  # Extends with an obj.get_count() that uses BITCOUNT to
+  # count all the events. Supports also __len__
+
+  module MixinCounts
+    def get_count
+      @redis.bitcount(@redis_key)
+    end
+    
+    def length
+      return get_count
+    end
+  end
+
+  # Makes it possible to see if an uuid has been marked.
+  # Example: 
+  # user_active_today = 123 in DayEvents('active', 2012, 10, 23)
+  module MixinContains
+    def includes?(uuid)
+      if @redis.getbit(self.redis_key, uuid) == 1
+        true
+      else
+        false
+      end
+    end
+  end
+
+  module RedisConnection
+    attr_accessor :redis
+    attr_reader :redis_key
+  end
+end
+
+
+# Events for a month.
+# Example:
+# MonthEvents('active', 2012, 10)
+class MonthEvents < BitAnalytics
+  include RedisConnection
+  include MixinCounts
+  include MixinContains
+  include MixinEventsMisc
+
+  attr_reader :redis_key
+  
+  def initialize(event_name, year, month)
+    @redis_key = _prefix_key(event_name,'%s-%s' % [year, month])
+  end
+end
+
+# Events for a week.
+# Example:
+# WeekEvents('active', 2012, 48)
+class WeekEvents < BitAnalytics
+  include RedisConnection
+  include MixinCounts
+  include MixinContains
+  include MixinEventsMisc
+  
+  def initialize(event_name, year, week)
+    @redis_key = _prefix_key(event_name,'W%s-%s' % [year, week])
+  end
+end
+
+# Events for a day.
+# Example:
+# DayEvents('active', 2012, 10, 23)
+class DayEvents < BitAnalytics
+  include RedisConnection
+  include MixinCounts
+  include MixinContains
+  include MixinEventsMisc
+
+  def initialize(event_name, year, month, day)
+    @redis_key = _prefix_key(event_name,'%s-%s-%s' % [year, month, day])
+  end
+end
+
+# Events for a hour.
+# Example:
+# HourEvents('active', 2012, 10, 23, 13)
+class HourEvents < BitAnalytics
+  include RedisConnection
+  include MixinCounts
+  include MixinContains
+  include MixinEventsMisc
+
+  def initialize(event_name, year, month, day, hour)
+    @redis_key = _prefix_key(event_name,'%s-%s-%s-%s' % [year, month, day, hour])
+  end
+end
+
+#--- Bit operations ---
+# Base class for bit operations (AND, OR, XOR).
+# Please note that each bit operation creates a new key prefixed with `bitanalytics_bitop_`.
+# These temporary keys can be deleted with `delete_temporary_bitop_keys`.
+
+# You can even nest bit operations.
+# Example:
+#     active_2_months = BitOpAnd(
+#         MonthEvents('active', last_month.year, last_month.month),
+#         MonthEvents('active', now.year, now.month)
+#     )
+#     active_2_months = BitOpAnd(
+#         BitOpAnd(
+#             MonthEvents('active', last_month.year, last_month.month),
+#             MonthEvents('active', now.year, now.month)
+#         ),
+#         MonthEvents('active', now.year, now.month)
+#     )
+class BitOperation < BitAnalytics
+  include MixinContains
+  include MixinCounts
+  include MixinEventsMisc
+  include RedisConnection
+
+  def initialize(op_name, *events)
+    @op_name = op_name
+    @event_redis_keys = events.map(&:redis_key)
+    @redis_key = 'bitanalytics_bitop_%s_%s' % [@op_name, @event_redis_keys.join('-')]
+  end
+
+  def execute
+    @redis.bitop(@op_name, @redis_key, @event_redis_keys)
+  end
+end

data/test/bit_analytics_test.rb

@@ -0,0 +1,142 @@
+require 'date'
+require 'test/unit'
+require 'bit_analytics'
+
+class BitAnalyticsTest < Test::Unit::TestCase
+  def setup
+    @bit_analytics = BitAnalytics.new
+  end
+
+  def test_mark_with_diff_days
+    @bit_analytics.delete_all_events
+    @bit_analytics.mark_event('active', 123, track_hourly: true)
+
+    now = Time.now.getutc
+
+    # E.g. ['2014', '03'] for 17th of January 2014
+    iso_date = now.strftime('%Y-%V').split('-')
+
+    # Month
+    assert @bit_analytics.month_events('active', now.year, now.month).includes?(123)
+    assert !@bit_analytics.month_events('active', now.year, now.month).includes?(124)
+
+    # Week
+    assert @bit_analytics.week_events('active', now.year, iso_date[1]).includes?(123)
+    assert !@bit_analytics.week_events('active', now.year, iso_date[1]).includes?(124)
+
+    # Day
+    assert @bit_analytics.day_events('active', now.year, now.month, now.day).includes?(123)
+    assert !@bit_analytics.day_events('active', now.year, now.month, now.day).includes?(124)
+
+    # Hour
+    assert @bit_analytics.hour_events('active', now.year, now.month, now.day, now.hour).includes?(123)
+    assert !@bit_analytics.hour_events('active', now.year, now.month, now.day, now.hour).includes?(124)
+    assert !@bit_analytics.hour_events('active', now.year, now.month, now.day, now.hour-1).includes?(124)
+  end
+
+  def test_mark_counts
+      @bit_analytics.delete_all_events
+
+      now = Time.now.getutc
+      assert @bit_analytics.month_events('active', now.year, now.month).get_count == 0
+
+      @bit_analytics.mark_event('active', 123)
+      @bit_analytics.mark_event('active', 23232)
+
+      assert @bit_analytics.month_events('active', now.year, now.month).length == 2
+  end
+
+  def test_different_dates
+    @bit_analytics.delete_all_events
+
+    now = Time.now.getutc
+    yesterday = (Date.today - 1).to_time
+
+    @bit_analytics.mark_event('active', 123, now: now)
+    @bit_analytics.mark_event('active', 23232, now: yesterday)
+
+    assert @bit_analytics.day_events('active',
+      now.year,
+      now.month,
+      now.day).get_count == 1
+
+    assert @bit_analytics.day_events('active',
+      yesterday.year,
+      yesterday.month,
+      yesterday.day).get_count == 1
+  end
+
+  def test_different_buckets
+    @bit_analytics.delete_all_events
+
+    now = Time.now.getutc
+
+    @bit_analytics.mark_event('active', 123)
+    @bit_analytics.mark_event('tasks:completed', 23232)
+
+    assert @bit_analytics.month_events('active', now.year, now.month).get_count == 1
+    assert @bit_analytics.month_events('tasks:completed', now.year, now.month).get_count == 1
+  end
+
+  def test_bit_operations
+    @bit_analytics.delete_all_events
+
+    now = Time.now.getutc
+    last_month = (Date.today << 1).to_time
+
+    # 123 has been active for two months
+    @bit_analytics.mark_event('active', 123, now: now)
+    @bit_analytics.mark_event('active', 123, now: last_month)
+
+    # 224 has only been active last_month
+    @bit_analytics.mark_event('active', 224, now: last_month)
+
+    # Assert basic premises
+    assert @bit_analytics.month_events('active', last_month.year, last_month.month).get_count == 2
+    assert @bit_analytics.month_events('active', now.year, now.month).get_count == 1
+
+    # Try out with bit AND operation
+    active_2_months = @bit_analytics.bit_op_and(
+        @bit_analytics.month_events('active', last_month.year, last_month.month),
+        @bit_analytics.month_events('active', now.year, now.month)
+    )
+    assert active_2_months.get_count == 1
+    assert active_2_months.includes?(123)
+    assert !(active_2_months).includes?(224)
+    active_2_months.delete
+
+    # Try out with bit OR operation
+    assert @bit_analytics.bit_op_or(
+        @bit_analytics.month_events('active', last_month.year, last_month.month),
+        @bit_analytics.month_events('active', now.year, now.month)
+    ).get_count == 2
+
+    # Try nested operations
+    active_2_months = @bit_analytics.bit_op_and(
+        @bit_analytics.bit_op_and(
+            @bit_analytics.month_events('active', last_month.year, last_month.month),
+            @bit_analytics.month_events('active', now.year, now.month)
+        ),
+        @bit_analytics.month_events('active', now.year, now.month)
+    )
+
+    assert active_2_months.includes?(123)
+    assert !active_2_months.includes?(224)
+    active_2_months.delete
+  end
+  
+  def test_events_marked
+    @bit_analytics.delete_all_events
+
+    now = Time.now.getutc
+
+    assert @bit_analytics.month_events('active', now.year, now.month).get_count == 0
+    assert @bit_analytics.month_events('active', now.year, now.month).has_events_marked == false
+
+    @bit_analytics.mark_event('active', 123, now: now)
+
+    assert @bit_analytics.month_events('active', now.year, now.month).get_count == 1
+    assert @bit_analytics.month_events('active', now.year, now.month).has_events_marked == true
+  end
+end
+

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: bit_analytics
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jure Triglav
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Analytics library built with Redis bitmaps
+email:
+- juretriglav@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bit_analytics.gemspec
+- lib/bit_analytics.rb
+- lib/bit_analytics/version.rb
+- test/bit_analytics_test.rb
+homepage: http://www.github.com/jure/bit_analytics
+licenses:
+- BSD
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Implements a powerful analytics library on top of Redis's support for bitmaps
+  and bitmap operations.
+test_files:
+- test/bit_analytics_test.rb