Metadata-Version: 1.1
Name: django-autometrics-nonrel
Version: 0.9.1a5
Summary: A Django+Djangae app to collect session and access metrics.
Home-page: https://github.com/seawolf42/django-autometrics
Author: jeffrey k eliasen
Author-email: jeff+django-autometrics@jke.net
License: MIT License
Description: ==========================
        Django Autometrics Non-Rel
        ==========================
        
        This package installs models and middleware used to simplify user tracking across sessions and correlate access to resources to the user requesting such access.
        
        Some of the tools in this project assume you are running in a non-relational environment (so far only Google App Engine is supported) for your views of interest. As such, the project depends on the `djangae` package. Some day perhaps I will split this into relational and non-relational sub-packages.
        
        
        Quick start
        -----------
        
        The easiest way to use `django-autometrics-nonrel` is to use the `RestFrameworkGenericViewSetAutoMetricsMixin` to provide built-in recording of user retrieval of entities:
        
        Add the project to your `INSTALLED_APPS`:
        
            INSTALLED_APPS = [
                ...
                'autometrics_nonrel',
                ...
            ]
        
        Add the middleware to `MIDDLEWARE_CLASSES` anywhere *after* `SessionMiddleware`:
        
            MIDDLEWARE_CLASSES = (
                ...
                'django.contrib.sessions.middleware.SessionMiddleware',
                'autometrics_nonrel.middleware.UserSessionTrackingMiddleware',
                ...
            )
        
        Use the mixin on your Django REST Framework `GenericViewSet` (or any viewset derived from `GenericViewSet`) to automatically log user access to items:
        
            from rest_framework import viewsets
            from autometrics_nonrel import mixins
            from myapp.models import MyModel
            class MyViewSet(
                    viewsets.ReadOnlyModelViewSet,
                    RestFrameworkGenericViewSetAutoMetricsMixin
            ):
                model = MyModel
                queryset = MyModel.objects.all()
                ...
        
Keywords: django analytics
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: System :: Logging
