URL: https://linuxfr.org/users/_moumoutte/journaux/sqla_helpers-quelques-trucs-en-vrac Title: sqla_helpers : Quelques trucs en vrac Authors: Guillaume Camera Date: 2013年09月29日T16:40:14+02:00 License: CC By-SA Tags: Score: 6 Salut Nal', Décidément, si je prend la plume c'est toujours pour t'écrire autour du même sujet. Je me doute que tout cela t'ennuie, mais à moi ça me ~~fait de la pub~~ du bien et crois moi, je t'en suis très reconnaissant. Alors, je vais te parler de mon tout petit projet sur lequel de temps en temps j'écris quelques lignes de code. Pour rappel, il s'agit [sqla_helpers](http://sqla-helpers.readthedocs.org/en/latest/sqla_helpers.html) qui a pour première fonctionnalité de fournir du sucre syntaxique pour interroger ta base favorite à travers d'objets python et tout cela , grâce à ce merveilleux ORM qu'est SQLAlchemy. Allez, je vais tenter de te mettre l'eau à la bouche si tu ne connais pas ou si tu ne t'en souviens pas : Avec SQLAlchemy session.query(Treatment).filter(Treatment.name=='bar').one() session.query(Treatment).join(Status, Status.id == Treatment.status_id).filter(Status.name == u'SUCCESS').all() # Oui, on pourrait utiliser la jointure implicite ce qui donnerait session.query(Treatment).filter(Status.name == u'SUCCESS').all() Avec sqla_helpers Treatment.get(foo='bar') Treatment.filter(status__name=u'SUCCESS') A l'époque j'avais écrit ça pour le boulot, venant du monde de Django et commençant à travailler avec SQLAlchemy. L'utilité de ce machin là est à mon sens hyper subjectif. On aime ou on aime pas. J'ai continué à le maintenir à peu près et à lui apporter quelques petites bricoles, sachant que un ou deux projets s'en servent. En 6 mois d'existence, on a réussi à trouver un petit bug qui a rapidement était corrigé mais d'un point de vue fonctionnalités, y'a pas grand chose à rajouter, sachant que tout le boulot est bien sûr délégué à SQLAlchemy, pas question de faire son taf, il le fait très bien. J'en arrive donc à toutes les questions que j'ai pour toi cher journal, Stabilisation du logiciel ------------------------- Aujourd'hui je viens de publier la version 0.4.0 et en 6 mois d'existence, il y a vraiment peu eu d'évolution de fonctionnalités. Alors je te le demande cher journal, est-ce qu'il faut stabiliser la version et passer en 1.0.0 pour de bon ? Appel à la traduction ---------------------- Aujourd'hui, il y a une documentation en anglais. Initialement, tout était en français , car je préférerai avoir une bonne doc en français qu'un truc incompréhensible en anglais. Un collègue à l'époque avait fait cette traduction pour moi, et je l'en remercie, car moi même je n'aurai pas trouver le courage de le faire. Seulement aujourd'hui, cette traduction contient , je pense certain passage encore un peu flou. Oui, il n'est pas bilingue malheureusement et en plus de ça l'erreur est humaine. Donc, j'ai vue quelques erreurs (dictonnary..) que j'ai corrigé, mais je suis bien trop mauvais pour être exhaustif. Et je pense qu'il y certains passages dont la signification est encore un peu fausse . (Attention, je ne suis pas en train de cracher sur son travail, il a été super sympa de me la faire cette traduction, sans lui tout serait encore en français). Donc, si tu es bon en anglais et est-ce que tu aurais l'amabilité de faire un tour sur la documentation et selon ton bon vouloir, soit me remonter ce qui ne va pas (orthographe, syntaxe, expression, flou...) soit carrément faire un commit sur le projet ( que je serais ravis d'accueillir !) Le logiciel est-il utilisé ? ---------------------------- Je sais que un ou deux projets s'en servent. Je n'avais aucune intention de révolutionner le monde et de faire de ce truc là un standard. Sauf que voilà, quand je regarde sur pypi.python.org, il me dit qu'il y a peu près 560 téléchargements qui ont été fait le mois derniers (sachant qu'il est sortie depuis février 2013). Je sais bien qu'entre les builds automatiques et les upgrades de version, ça ne fait pas 500 utilisateurs tous les mois. Mais à ton avis, cher journal, est-ce que c'est un indicateur auquel on peut se fier ? Sachant que personne n'est venu me demander quoi que ce soit à propos du projet (bug, moyen d'utilisation, doc, etc). Bookmark ======== Doc : http://sqla-helpers.readthedocs.org/en/latest/sqla_helpers.html Github : https://github.com/moumoutte/sqla_helpers