{"id":1392,"date":"2011-04-30T18:24:00","date_gmt":"2011-04-30T16:24:00","guid":{"rendered":"http:\/\/j-mad.com\/blog\/?p=1392"},"modified":"2011-04-30T18:24:00","modified_gmt":"2011-04-30T16:24:00","slug":"django-extended-choices-lapp-qui-te-donne-le-choix-mais-pas-la-date","status":"publish","type":"post","link":"https:\/\/j-mad.com\/blog\/2011\/04\/30\/django-extended-choices-lapp-qui-te-donne-le-choix-mais-pas-la-date\/","title":{"rendered":"Django-extended-choices, l’app qui te donne le choix (mais pas la date)"},"content":{"rendered":"

J’avais plein d’app possible \u00e0 pr\u00e9senter pour ce billet du mois d’avril. Mais en r\u00e9fl\u00e9chissant, je me suis dit que la meilleure app possible \u00e0 pr\u00e9senter ce moi-si c’\u00e9tait celle qui a \u00e9t\u00e9 lib\u00e9r\u00e9 pendant les DjangoCongs \u00e0 savoir Django-extended-choices.<\/p>\n

Et en plus, ce qui est bien, c’est que comme c’est une toute petite app, \u00e7a ne sera pas fatiguant du tout d’\u00e9crire ce billet.<\/p>\n

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

L\u00e0 c’est tout simple, on la trouve sur github. Et uniquement sur github. Quand \u00e0 la doc elle tient toute enti\u00e8re dans le fichier Readme.rst qui se trouve lui aussi sur github. (et vous la trouverez aussi en docstring de l’unique classe que contient l’app).<\/p>\n

Pour l’installation il suffit ou plut\u00f4t il faut forc\u00e9ment, cloner le repo github.<\/p>\n

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

A g\u00e9rer d’une mani\u00e8re propre les Choices que l’on peut avoir \u00e0 mettre en place dans les fields Django.  Parce qu’il est vrai que la m\u00e9thode normale, \u00e0 base de constantes que l’on ne sait pas trop o\u00f9 d\u00e9clarer et de tuples de tuples, me si elle fonctionne bien, n’est pas super \u00e9l\u00e9gante.<\/p>\n

L’app permet donc d’encapsuler tout \u00e7a dans une belle petite classe<\/p>\n

3- Comment \u00e7a marche ?<\/h2>\n

Bon la je vais, sans aucun remords, faire un petit copi\u00e9\/coll\u00e9 de la doc. Parce que l’explication de comment \u00e7a marche est tr\u00e8s bien faite.<\/p>\n

Donc en fait cela marche comme \u00e7a :<\/p>\n

from<\/span> extended_choices import<\/span> Choices
\n
\nSTATES =<\/span> Choices(<\/span>
\n    (<\/span>'ONLINE'<\/span>,<\/span>  1<\/span>,<\/span> 'Online'<\/span>)<\/span>,<\/span>
\n    (<\/span>'DRAFT'<\/span>,<\/span>   2<\/span>,<\/span> 'Draft'<\/span>)<\/span>,<\/span>
\n    (<\/span>'OFFLINE'<\/span>,<\/span> 3<\/span>,<\/span> 'Offline'<\/span>)<\/span>,<\/span>
\n)<\/span>
\n
\nclass<\/span> ContentModel(<\/span>models.Model<\/span>)<\/span>:
\n    title      =<\/span> models.CharField<\/span>(<\/span>max_length=<\/span>255<\/span>)<\/span>
\n    content    =<\/span> models.TextField<\/span>(<\/span>)<\/span>
\n    state      =<\/span> models.PositiveSmallIntegerField<\/span>(<\/span>choices=<\/span>STATES.CHOICES<\/span>,<\/span> default=<\/span>STATES.DRAFT<\/span>)<\/span>
\n    related_to =<\/span> models.ManyToManyField<\/span>(<\/span>'self'<\/span>,<\/span> through=<\/span>"ContentToContent"<\/span>,<\/span> symmetrical=<\/span>False<\/span>,<\/span> blank=<\/span>True<\/span>,<\/span> null=<\/span>True<\/span>)<\/span>
\n
\n    def<\/span> __unicode__<\/span>(<\/span>self<\/span>)<\/span>:
\n        return<\/span> u'Content "%s" (state=%s)'<\/span> % (<\/span>self<\/span>.title<\/span>,<\/span> STATES.CHOICES_DICT<\/span>[<\/span>self<\/span>.state<\/span>]<\/span>)<\/span>
\n
\n    def<\/span> get_related_content(<\/span>self<\/span>)<\/span>:
\n        return<\/span> self<\/span>.related_to<\/span>.select_related<\/span>(<\/span>)<\/span>.filter<\/span>(<\/span>state=<\/span>STATES.ONLINE<\/span>)<\/span><\/div><\/div>\n

plut\u00f4t clair non ?<\/p>\n

Et cela remplace ce code l\u00e0 :<\/p>\n

STATE_ONLINE\u00a0 =<\/span> 1<\/span>
\nSTATE_DRAFT\u00a0\u00a0 =<\/span> 2<\/span>
\nSTATE_OFFLINE =<\/span> 3<\/span>
\n
\nSTATE_CHOICES =<\/span> (<\/span>
\n    (<\/span>STATE_ONLINE,<\/span>  'Online'<\/span>)<\/span>,<\/span>
\n    (<\/span>STATE_DRAFT,<\/span>   'Draft'<\/span>)<\/span>,<\/span>
\n    (<\/span>STATE_OFFLINE,<\/span> 'Offline'<\/span>)<\/span>,<\/span>
\n)<\/span>
\n
\nSTATE_DICT =<\/span> dict<\/span>(<\/span>STATE_CHOICES)<\/span>
\n
\nclass<\/span> ContentModel(<\/span>models.Model<\/span>)<\/span>:
\n    title      =<\/span> models.CharField<\/span>(<\/span>max_length=<\/span>255<\/span>)<\/span>
\n    content    =<\/span> models.TextField<\/span>(<\/span>)<\/span>
\n    state      =<\/span> models.PositiveSmallIntegerField<\/span>(<\/span>choices=<\/span>STATE_CHOICES,<\/span> default=<\/span>STATE_DRAFT)<\/span>
\n    related_to =<\/span> models.ManyToManyField<\/span>(<\/span>'self'<\/span>,<\/span> through=<\/span>"ContentToContent"<\/span>,<\/span> symmetrical=<\/span>False<\/span>,<\/span> blank=<\/span>True<\/span>,<\/span> null=<\/span>True<\/span>)<\/span>
\n
\n    def<\/span> __unicode__<\/span>(<\/span>self<\/span>)<\/span>:
\n        return<\/span> u'Content "%s" (state=%s)'<\/span> % (<\/span>self<\/span>.title<\/span>,<\/span> STATE_DICT[<\/span>self<\/span>.state<\/span>]<\/span>)<\/span>
\n
\n    def<\/span> get_related_content(<\/span>self<\/span>)<\/span>:
\n        return<\/span> self<\/span>.related_to<\/span>.select_related<\/span>(<\/span>)<\/span>.filter<\/span>(<\/span>state=<\/span>STATE_ONLINE)<\/span><\/div><\/div>\n

Personnellement, je trouve que la notation point\u00e9e  STATES.CHOICES ou  STATES.DRAFT est bien bien plus clair que la notation pr\u00e9c\u00e9dente.<\/p>\n

Conclusion<\/h4>\n

Une petite app qui ne fait qu’une chose mais qui le fait bien. A utiliser de partout donc. (Il ne manque juste que des tests ..:) ) .<\/p>\n","protected":false},"excerpt":{"rendered":"

J’avais plein d’app possible \u00e0 pr\u00e9senter pour ce billet du mois d’avril. Mais en r\u00e9fl\u00e9chissant, je me suis dit que la meilleure app possible \u00e0 pr\u00e9senter ce moi-si c’\u00e9tait celle qui a \u00e9t\u00e9 lib\u00e9r\u00e9 pendant les DjangoCongs \u00e0 savoir Django-extended-choices. Et en plus, ce qui est bien, c’est que comme c’est une toute petite app, … Continue reading Django-extended-choices, l’app qui te donne le choix (mais pas la date)<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_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}},"categories":[35],"tags":[99,98],"class_list":["post-1392","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-ms","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts\/1392","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=1392"}],"version-history":[{"count":2,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts\/1392\/revisions"}],"predecessor-version":[{"id":1394,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts\/1392\/revisions\/1394"}],"wp:attachment":[{"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/media?parent=1392"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/categories?post=1392"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/tags?post=1392"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}