djangohitcounter 0.1.4

Pretty simple hit counter for Django ORM objects

About

Pretty simple hit counter for Django ORM objects. It collects hits for any django model objects per date.

Requirements

• Python 2 & 3

• Django 1.7+

Installation

1. Install it using pip (coming soon):

pip install djangohitcounter

or add django_hitcounter to your Python path

2. Add the django_hitcounter app to your INSTALLED_APPS:

# settings.py
INSTALLED_APPS = (
  ...,
  'django_hitcounter',
  ...
)

Usage

Usage is pretty simple too.

from django_hitcounter.models import Counter
from datetime import datetime, timedelta


obj = SomeModel.objects.get(pk=1)  # get some django object

Counter.hit(obj)  # register hit
Counter.hit(obj, amount=2)  # register 2 hits
Counter.hit(obj, date=datetime.today().date() - timedelta(days=1))  # register hit on yesterday date

Counter.objects.for_model(obj)  # get all counter records for our object
Counter.objects.for_model(obj, total=True)  # get total hits count for object

TODO

• tests and autotests on CI

• badges: pypi (ready), build (ready), coverage (after tests)

License

This software is distributed under the Apache License Version 2.0