{"id":1023,"date":"2010-10-30T15:00:00","date_gmt":"2010-10-30T13:00:00","guid":{"rendered":"http:\/\/j-mad.com\/blog\/?p=1023"},"modified":"2010-10-30T15:00:00","modified_gmt":"2010-10-30T13:00:00","slug":"django-qsstats-parce-quen-vraion-adore-tous-faire-des-stats","status":"publish","type":"post","link":"https:\/\/j-mad.com\/blog\/2010\/10\/30\/django-qsstats-parce-quen-vraion-adore-tous-faire-des-stats\/","title":{"rendered":"Django-qsstats, parce qu’en vrai,on adore tous faire des stats."},"content":{"rendered":"

Ce mois-ci, j’aurais pu \u00e9crire plusieurs django-app du mois. Si j’avais eu le temps. Mais bon, le jour o\u00f9 j’aurais le temps, \u00e7a se saura. Du coup, alors que l’horloge tourne et qu’il ne me reste plus qu’un jour et demi pour \u00e9crire ma django app du mois et mon polargeek, j’ai d\u00e9cid\u00e9 d’\u00e9crire ma django-app du mois pour parler de django-qsstats<\/a>, une petite application comme je les aime.<\/p>\n

C’est \u00e0 dire, qui ne fait qu’une chose, une toute petite chose, mais qui la fait bien. Et qui du coup est facilement int\u00e9grable, sans remord.<\/p>\n

1- O\u00f9 on le trouve, comment on l\u2019installe, tout \u00e7a quoi (et la doc)\u00a0?<\/h1>\n

On la trouve sur sa page github<\/a>. Il me semble bien que le seul moyen d’installation soit \u00e0 travers github. Mais bon, cloner un repository git hub, ce n’est pas le plus compliqu\u00e9.<\/p>\n

La doc, elle, se limite au fichier Readme<\/a> et \u00e0 la lecture des tests. Mais bon, honn\u00eatement, cela suffit.<\/p>\n

Par contre attention, en plus de n\u00e9cessiter django 1.1 \u00e0 minimal, cette petite app a besoin de python-dateutil<\/a> (une petite librairie qui ajoute pas mal d’extension plut\u00f4t puissante \u00e0 datetime, si vous ne connaissez pas, je vous recommande vivement d’aller jeter un oeil (mais pas les deux, apr\u00e8s vous ne pourrez plus lire la doc \u2026 ) )<\/p>\n

2- Mais au fait, \u00e0 quoi \u00e7a sert\u00a0?<\/h2>\n

A presque rien, mais c’est bien utile.:) Lorsqu’on veut faire un minimum de stats, de comparaison ou autre, on se retrouve assez vite \u00e0 vouloir trouver combien il y a eu de nouveaux articles la semaine derni\u00e8re, combien d’histoires ont \u00e9t\u00e9 \u00e9crites par des r\u00f4listes durant le mois dernier, ou d’utilisateur enregistr\u00e9 les 6 derniers mois…<\/p>\n

Faire cela est tr\u00e8s simple, un petit queryset puis des petits filters. C’est tr\u00e8s simple, mais bon, c’est rapidement chiant, et puis c’est pas tr\u00e8s DRY.<\/p>\n

Donc on se retrouve assez vite \u00e0 faire des petits fonctions pour avoir les dates du mois en cours, ou d’un mois pr\u00e9cis..<\/p>\n

O\u00f9 alors on se dit que quelqu’un \u00e0 surement du le faire \u00e0 notre place, on cherche un peu et on tombe sur django-qsstats.<\/p>\n

3- Comment \u00e7a marche\u00a0?<\/h1>\n

C’est vraiment tout simple. Il suffit de mettre l’app dans son python-path. Ensuite un peu l’utiliser. Rien \u00e0 faire de plus. M\u00eame pas de syncb vu que c’est une app sans model. (il y a un fichier models mais il n’est l\u00e0 que pour les tests).
\nEnsuite, ben un exemple sera plus parlant (je reprend l’exemple du site officiel) \u00a0:<\/p>\n

from<\/span> django.contrib<\/span>.auth<\/span> import<\/span> User
\nimport<\/span> qsstats
\n
\nqs =<\/span> User.objects<\/span>.all<\/span>(<\/span>)<\/span>
\nqss =<\/span> qsstats.QuerySetStats<\/span>(<\/span>qs,<\/span> 'date_joined'<\/span>)<\/span>
\n
\nprint<\/span> '%s new accounts today.'<\/span> % qss.this_day<\/span>(<\/span>)<\/span>
\nprint<\/span> '%s new accounts this month.'<\/span> % qss.this_month<\/span>(<\/span>)<\/span>
\nprint<\/span> '%s new accounts this year.'<\/span> % qss.this_year<\/span>(<\/span>)<\/span>
\nprint<\/span> '%s new accounts until now.'<\/span> % qss.until_now<\/span>(<\/span>)<\/span><\/div><\/div>\n

Vous le voyez, c’est assez facile. On construit son queryset et ensuite on le passe \u00e0 qsstats en lui indiquant le champ date qui devra servir au filtrage.<\/p>\n

D\u00e9j\u00e0 l\u00e0, \u00e7a serait pas mal. Mais il y a mieux. Il existe la fonction time_series qui permet de r\u00e9cup\u00e9rer une liste de valeur. Par exemple\u00a0:<\/p>\n

from<\/span> django.contrib<\/span>.auth<\/span> import<\/span> User
\nimport<\/span> datetime<\/span>,<\/span> qsstats
\n
\nqs =<\/span> User.objects<\/span>.all<\/span>(<\/span>)<\/span>
\nqss =<\/span> qsstats.QuerySetStats<\/span>(<\/span>qs,<\/span> 'date_joined'<\/span>)<\/span>
\n
\ntoday =<\/span> datetime<\/span>.date<\/span>.today<\/span>(<\/span>)<\/span>
\nseven_days_ago =<\/span> today - datetime<\/span>.timedelta<\/span>(<\/span>days=<\/span>7<\/span>)<\/span>
\n
\ntime_series =<\/span> qss.time_series<\/span>(<\/span>seven_days_ago,<\/span> today)<\/span>
\nprint<\/span> 'New users in the last 7 days: %s'<\/span> % [<\/span>t[<\/span>1<\/span>]<\/span> for<\/span> t in<\/span> time_series]<\/span><\/div><\/div>\n

qui donnera\u00a0:
\nNew users in the last 7 days: [3, 10, 7, 4, 12, 9, 11]<\/p>\n

Si cela it\u00e8re par jour, ce n’est pas magique, c’est parce jour (enfin day) est l’argument step par d\u00e9faut. Mais on peu bien entendu changer la taille du pas.<\/p>\n

Enfin, par d\u00e9faut, toutes les fonctions utilise Count pour calculer les r\u00e9sultat. (et quand je dis Count, c’est effectivement la class Count des Aggregat de django) Mais on peut changer ce comportement en donnant une valeur au param\u00e8tre agregate_class du QuerySetStats.<\/p>\n

4-Conclusion<\/h1>\n

Comme je le disais en introduction, j’aime beaucoup les petites apps qui font des petits trucs, mais qui le font bien. C’est bien souvent plus utile que les grosses apps qui font tout et le caf\u00e9 et qui sont bien plus difficile \u00e0 int\u00e9grer (ceci n’est pas une critique de pinax hein, ne me faite pas dire ce que je n’ai pas dit).<\/p>\n

Donc j’aime forc\u00e9ment, beaucoup qsstats.<\/p>\n

Une petite information un fork de qsstats a \u00e9t\u00e9 cr\u00e9\u00e9, sur bitbucket (et que vous trouverez sur pypi). Il s’appelle django-qsstats-magic<\/a>. Il rajoute la gestion des heures et des minutes, une optimisation qui fonctionne avec mysql et modifie des trucs en interne. Mais effectivement, je n’ai pas pouss\u00e9 plus loin mes investigations.<\/p>\n","protected":false},"excerpt":{"rendered":"

Ce mois-ci, j’aurais pu \u00e9crire plusieurs django-app du mois. Si j’avais eu le temps. Mais bon, le jour o\u00f9 j’aurais le temps, \u00e7a se saura. Du coup, alors que l’horloge tourne et qu’il ne me reste plus qu’un jour et demi pour \u00e9crire ma django app du mois et mon polargeek, j’ai d\u00e9cid\u00e9 d’\u00e9crire ma … Continue reading Django-qsstats, parce qu’en vrai,on adore tous faire des stats.<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[35],"tags":[99,98],"class_list":["post-1023","post","type-post","status-publish","format-standard","hentry","category-la-django-app-du-mois","tag-django","tag-python"],"aioseo_notices":[],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p12cdp-gv","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts\/1023","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/comments?post=1023"}],"version-history":[{"count":2,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts\/1023\/revisions"}],"predecessor-version":[{"id":1025,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts\/1023\/revisions\/1025"}],"wp:attachment":[{"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/media?parent=1023"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/categories?post=1023"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/tags?post=1023"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}