Skip to main content

Please note: Django MStats is in early development and the API is very likely to change.

MStats is a super simple, re-usable, stateless Django app for visualizing and browsing statistics, mainly based on existing Django models.

My motivation for creating MStats is to have a dead simple way, with as little effort as possible, to get visualization of key metrics in different Django projects.

The goal of Django MStats is not to be the ultimate metrics/statistics solution™. It will not support different backends for different Metrics services and databases. MStats makes all queries in real-time, and does not store any permanent data itself, even though Django’s cache might be used.

In other words, Django MStats is a reusable app for those who want to get basic statistics browsing with minimum effort. Since MStats is stateless, it can easily be tested out, and thrown away in favor of something more advanced, if a project grow out of it.

What does M in Mstats stand for?

Model or Mini. Whichever you like best.

Requirements

Currently MStats depends on PostgreSQL, because it uses a Postgres specific SQL functions for retrieving stats.

Installation

  1. Install from PyPI:

    pip install django-mstats
  2. Add django_mstats to INSTALLED_APPS

  3. Add URL route to your urls.py:

    url(r"^mstats/", include("django_mstats.urls")),
  4. Create mstats.py file(s) in your Django apps (see below).

Defining different metrics

Once you have added django_mstats to your INSTALLED_APPS, you can create mstats.py files within your Django apps. In those files you should create classes that inherits from ModelStats. Below are some examples.

Statistics for newly registered users:

from django_mstats.models import ModelStats
from django.contrib.auth.models import User

class NewUsers(ModelStats):
    model = User
    datetime_field = "date_joined"

Specifying a name:

class NewUsers(ModelStats):
    model = User
    datetime_field = "date_joined"
    name = "User registrations"

Author

Django-MStats is developed by Jonatan Heyman.

License

BSD License

Metadata

Release files for django-mstats 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-mstats 0.1.2
File Size Uploaded
django-mstats-0.1.2.tar.gz 17.7 kB Details

Release files / django-mstats-0.1.2.tar.gz

Download URL django-mstats-0.1.2.tar.gz
Size 17.7 kB
Tags Source
SHA-256 checksum
How to use checksums
ceaccb98fa29d53e80fb7983bb188bc9c4a373a8a79447391416e15ddc173cef
BLAKE2b-256 checksum
How to use checksums
b1b31d36ce620c66aba2fffe205b4c6fb32681fdbc18a7413dcf69797dcf39f7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.2 This release

1 release file

0.1.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page