dj_mano

Materialized Annotations for Django Models. Typical use-case is to keep track of the number of comments in a post, or the number of contributions a user has made.

Installation

pip install dj_mano

Usage

In-code

Using dj_mano is pretty straightforward, you just create a field and give it the annotation you want it to hold.

If you want, you can apply some filter to the annotation you’re doing, like to count only positive reviews by example. In this case, you can provide a function that will return the queryset that will be annotated. Beware, the queryset must be “starting” from the object holding the materialized annotation field.

Models

from django.db import models
from dj_mano import MaterializedAnnotationIntegerField


def swag_model_c():
    return ModelA.objects.filter(models_b__models_c__has_swag=True)


class ModelA(models.Model):
    count_b = MaterializedAnnotationIntegerField(models.Count('models_b'))
    count_c = MaterializedAnnotationIntegerField(models.Count('models_b__models_c'))
    count_swag = MaterializedAnnotationIntegerField(
        models.Count('models_b__models_c'),
        swag_model_c
    )


class ModelB(models.Model):
    model_a = models.ForeignKey('ModelA', related_name='models_b')


class ModelC(models.Model):
    model_b = models.ForeignKey('ModelB', related_name='models_c')
    has_swag = models.BooleanField(default=False)

urls.py

from django.conf.urls import patterns
from dj_mano import hook_it_all

hook_it_all()

urlpatterns = patterns('',
    ...
)

Command

There is a command that will simply synchronize all fields to their actual value.

Note: if you want to use this command, you have to put dj_mano in your INSTALLED_APPS.

./manage.py dj_mano_sync

Licence

This library is licensed under the terms of the WTFPL. Please see the attached LICENSE file.

Metadata

Release files for dj_mano 0.2.1

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

Source distribution (sdist)

Source distribution for dj_mano 0.2.1
File	Size	Uploaded	Provenance
dj_mano-0.2.1.tar.gz	5.1 kB	Feb 8, 2015	Without provenance	Details

Release files / dj_mano-0.2.1.tar.gz

Download URL	dj_mano-0.2.1.tar.gz
Size	5.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`64031bffb671716f15b0507ad584d89ab77cd7c53adc0e70e8ed9a1cbf6017d4`
BLAKE2b-256 checksum How to use checksums	`98866d61fd143ef70679de174d2a9cd190dd2d0b500c182b53206dac93603097`
Upload date	Feb 8, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No

Security for dj_mano 0.2.1

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.