Skip to main content

Implements a powerful analytics library using Redis bitmaps.

Project description

bitmapist

Implements a powerful analytics library using Redis bitmaps.

This library 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 library 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.

Now with Cohort charts! Read more here:

If you want to read more about bitmaps please read following:

Requires Redis 2.6+ and newest version of redis-py.

Examples

Setting things up:

from datetime import datetime, timedelta
from bitmapist import setup_redis, delete_all_events, mark_event,                          MonthEvents, WeekEvents, DayEvents, HourEvents,                          BitOpAnd, BitOpOr

now = datetime.utcnow()
last_month = datetime.utcnow() - timedelta(days=30)

Mark user 123 as active and has played a song:

mark_event('active', 123)
mark_event('song:played', 123)

Answer if user 123 has been active this month:

assert 123 in MonthEvents('active', now.year, now.month)
assert 123 in MonthEvents('song:played', now.year, now.month)
assert MonthEvents('active', now.year, now.month).has_events_marked() == True

How many users have been active this week?:

print len(WeekEvents('active', now.year, now.isocalendar()[1]))

Perform bit operations. How many users that have been active last month are still active this month?:

active_2_months = BitOpAnd(
    MonthEvents('active', last_month.year, last_month.month),
    MonthEvents('active', now.year, now.month)
)
print len(active_2_months)

# Is 123 active for 2 months?
assert 123 in active_2_months

Work with nested bit operations (imagine what you can do with this ;-)):

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)
)
print len(active_2_months)
assert 123 in active_2_months

Copyright: 2012 by Doist Ltd.

Developer: Amir Salihefendic ( http://amix.dk )

License: BSD

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bitmapist-2.22.tar.gz (8.6 kB view details)

Uploaded Source

Built Distribution

bitmapist-2.22-py2.7.egg (16.7 kB view details)

Uploaded Source

File details

Details for the file bitmapist-2.22.tar.gz.

File metadata

  • Download URL: bitmapist-2.22.tar.gz
  • Upload date:
  • Size: 8.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for bitmapist-2.22.tar.gz
Algorithm Hash digest
SHA256 9d845a953407bb537c34abf2d2dc27e259f1a9128213a465d82651257909edcc
MD5 e602f19eaee11a38d89b6f8e4c2e2480
BLAKE2b-256 75bf27ee1d6b25b5ced0bc88ac37bfe951f32f09ccfb158d01d7d6d2450f0b1c

See more details on using hashes here.

Provenance

File details

Details for the file bitmapist-2.22-py2.7.egg.

File metadata

  • Download URL: bitmapist-2.22-py2.7.egg
  • Upload date:
  • Size: 16.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for bitmapist-2.22-py2.7.egg
Algorithm Hash digest
SHA256 d486b93f555c3a7cbed4618bc2041c564c0ad26105e8bafeb088977d96b23604
MD5 bab86368f92764d49b993bd665e3ecbd
BLAKE2b-256 857ec6d204205d33d57268dcdf1f8cd7cc0dbd8285c2a7cddf370ffcb147e165

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page