{"id":2682,"date":"2026-07-02T11:06:56","date_gmt":"2026-07-02T10:06:56","guid":{"rendered":"https:\/\/coding4phone.com\/?p=2682"},"modified":"2026-07-02T11:14:30","modified_gmt":"2026-07-02T10:14:30","slug":"compter-les-telechargements-de-vos-releases-github-en-mogwai","status":"publish","type":"post","link":"https:\/\/coding4phone.com\/?p=2682","title":{"rendered":"Compter les t\u00e9l\u00e9chargements de vos releases GitHub… en MOGWAI"},"content":{"rendered":"\n

Depuis peu, MOGWAI<\/a> dispose des primitives HTTP de base (http.get<\/code>, http.post<\/code>, http.put<\/code>, http.patch<\/code>, http.delete<\/code>, http.head<\/code>). L’occasion r\u00eav\u00e9e de les mettre \u00e0 l’\u00e9preuve sur un cas concret plut\u00f4t qu’un exemple jouet : interroger l’API GitHub pour savoir combien de fois les binaires CLI de MOGWAI ont \u00e9t\u00e9 t\u00e9l\u00e9charg\u00e9s, release par release.<\/p>\n\n\n\n

Ce script, je ne l’ai pas \u00e9crit moi-m\u00eame \u2014 c’est Claude<\/a><\/strong> (l’assistant IA d’Anthropic) qui l’a r\u00e9dig\u00e9, \u00e0 partir de la documentation des primitives MOGWAI que je lui ai fournie. Je l’ai test\u00e9, corrig\u00e9 sur quelques points, et j’ai m\u00eame patch\u00e9 un bug de l’engine MOGWAI d\u00e9couvert au passage. Le d\u00e9tail de cette collaboration est en fin d’article, avec l’avis franc de Claude sur la difficult\u00e9 de la prise en main.<\/p>\n\n\n\n

Ce que fait le script<\/h2>\n\n\n\n
mogwai.reset
console.clear

\"GitHub owner\/organization: \" console.prompt -> 'owner'
\"Repository name: \" console.prompt -> 'repo'

\"https:\/\/api.github.com\/repos\/{! owner}\/{! repo}\/releases\" eval -> 'apiUrl'

[!
    uri: apiUrl
    requestHeaders: [User-Agent: \"MOGWAI-DownloadStats\"]
] http.get -> 'result'

if (result->state:) then
{
    result->response: utf8-> json-> -> 'releases'

    0 -> 'grandTotal'

    \"MOGWAI - Downloads per release\" ?
    \"\" ?

    releases foreach 'rel' transform
    {
        rel->tag_name: -> 'tag'
        rel->assets: -> 'assets'

        tag ?

        assets foreach 'a' transform
        {
            a->name: 32 str.padRight ?? \" : \" ?? a->download_count: ?
            a->download_count:
        } -> 'counts'

        counts sum -> 'releaseTotal'
        grandTotal releaseTotal + -> 'grandTotal'

        \"  -> Release total : \" ?? releaseTotal ?
        \"\" ?

        0
    }

    \"TOTAL (assets only, excludes GitHub's auto-generated source zip) : \" ?? grandTotal ?
}
else
{
    \"Request failed - \" ?? result->error: ?
}<\/pre>\n\n\n\n
Comment il fonctionne, \u00e9tape par \u00e9tape<\/h2>\n\n\n\n
1. Saisie interactive<\/strong><\/p>\n\n\n\n
Au lancement, le script demande le compte GitHub et le nom du d\u00e9p\u00f4t via console.prompt<\/code> \u2014 pas besoin d’\u00e9diter le fichier pour l’utiliser sur un autre projet que MOGWAI :<\/p>\n\n\n\n
\"GitHub owner\/organization: \" console.prompt -> 'owner'
\"Repository name: \" console.prompt -> 'repo'<\/pre>\n\n\n\n
console.prompt<\/code> affiche le message pass\u00e9 en param\u00e8tre, attend la saisie clavier (termin\u00e9e par Entr\u00e9e), et place le texte saisi sur la pile. En MOGWAI, valeur -> 'nom'<\/code> stocke ensuite cette valeur dans une variable \u2014 c’est la notation qu’on retrouvera partout dans le script (-> 'apiUrl'<\/code>, -> 'result'<\/code>, -> 'releases'<\/code>, etc.).<\/p>\n\n\n\n
2. Construction de l’URL par interpolation<\/strong><\/p>\n\n\n\n
Plut\u00f4t que de concat\u00e9ner des morceaux de string avec +<\/code>, MOGWAI permet d’injecter des variables directement dans une cha\u00eene via {! ... }<\/code>, suivi d’un eval<\/code> :<\/p>\n\n\n\n
\"https:\/\/api.github.com\/repos\/{! owner}\/{! repo}\/releases\" eval -> 'apiUrl'<\/pre>\n\n\n\n
3. La requ\u00eate HTTP<\/strong><\/p>\n\n\n\n
http.get<\/code> prend un record avec au minimum une uri:<\/code>. Par d\u00e9faut, les \u00e9l\u00e9ments d’un record (ou d’une liste, ou d’une string) ne sont pas \u00e9valu\u00e9s \u2014 ils restent tels quels, ce qui permet justement d’y stocker du code ou une expression \u00e0 ex\u00e9cuter plus tard. C’est eval<\/code> qui d\u00e9clenche explicitement cette r\u00e9solution. Le [!<\/code> en t\u00eate du record est un raccourci \u00e9quivalent \u00e0 [...] eval<\/code> : il d\u00e9clenche l’\u00e9valuation de tous les \u00e9l\u00e9ments du record en une fois \u2014 ici, \u00e7a r\u00e9sout apiUrl<\/code> en sa valeur. Sans !<\/code> ni eval<\/code>, la variable resterait telle quelle, non r\u00e9solue.<\/p>\n\n\n\n
[!
    uri: apiUrl
    requestHeaders: [User-Agent: \"MOGWAI-DownloadStats\"]
] http.get -> 'result'<\/pre>\n\n\n\n
Le User-Agent<\/code> n’est pas optionnel : l’API GitHub refuse les requ\u00eates anonymes sans en-t\u00eate.<\/p>\n\n\n\n
4. Le d\u00e9codage JSON<\/strong><\/p>\n\n\n\n
La r\u00e9ponse arrive sous forme de donn\u00e9es brutes (response:<\/code>). Deux primitives suffisent \u00e0 la transformer en liste MOGWAI exploitable :<\/p>\n\n\n\n
result->response: utf8-> json-> -> 'releases'<\/pre>\n\n\n\n
utf8-><\/code> convertit les octets en cha\u00eene de caract\u00e8res, json-><\/code> transforme cette cha\u00eene JSON en liste de records, et -> 'releases'<\/code> stocke ce r\u00e9sultat dans la variable releases<\/code>.<\/p>\n\n\n\n
5. Le double parcours<\/strong><\/p>\n\n\n\n
Un foreach...transform<\/code> sur les releases, imbriqu\u00e9 avec un foreach...transform<\/code> sur les assets de chaque release. Chaque asset affiche son nom (align\u00e9 avec str.padRight<\/code>) et son nombre de t\u00e9l\u00e9chargements, puis pousse ce nombre dans une liste pour calculer le sous-total avec sum<\/code>.<\/p>\n\n\n\n
6. L’agr\u00e9gation<\/strong><\/p>\n\n\n\n
sum<\/code> calcule le total par release, un simple +<\/code> cumule le total g\u00e9n\u00e9ral au fil des releases.<\/p>\n\n\n\n
R\u00e9sultat<\/h2>\n\n\n\n
GitHub owner\/organization: Sydney680928
Repository name: mogwai

MOGWAI - Downloads per release

v8.13.0
  mogwai-cli-v8.13.0-win-x64.zip   : 4
  ...
  -> Release total : 4

...

TOTAL (assets only, excludes GitHub's auto-generated source zip) : 21<\/pre>\n\n\n\n
\u00c0 noter : ce total ne compte que les assets binaires attach\u00e9s aux releases, pas le zip source auto-g\u00e9n\u00e9r\u00e9 par GitHub \u2014 l’API ne le comptabilise jamais, quelle que soit la m\u00e9thode utilis\u00e9e.<\/p>\n\n\n\n
En bonus : un bug trouv\u00e9 et corrig\u00e9 en cours de route<\/h2>\n\n\n\n
En testant le script, une release sans aucun asset attach\u00e9 a fait planter le calcul du sous-total : sum<\/code> sur une liste vide ()<\/code> d\u00e9clenchait une erreur (MW.22) au lieu de retourner 0<\/code>, ce qui est pourtant le comportement math\u00e9matiquement sens\u00e9 pour une somme vide. Le bug a \u00e9t\u00e9 corrig\u00e9 directement dans l’engine MOGWAI \u2014 sum<\/code> sur ()<\/code> retourne maintenant 0<\/code> sans erreur. Le d\u00e9tail est dans le changelog de la prochaine version.<\/p>\n\n\n\n
MOGWAI pense aussi aux d\u00e9butants<\/h2>\n\n\n\n
Le script ci-dessus est du MOGWAI \u00ab\u00a0classique\u00a0\u00bb, en RPN pure. Mais le langage pr\u00e9voit plusieurs passerelles pour ne pas brusquer quelqu’un qui arrive d’un langage plus conventionnel.<\/p>\n\n\n\n
Les formules en notation infixe avec calc<\/code>.<\/strong> <\/p>\n\n\n\n
Pas besoin de tout de suite penser en pile : calc<\/code> accepte une expression math\u00e9matique \u00e9crite comme on l’\u00e9crirait sur un tableau, et se charge de la convertir en RPN en interne (via l’algorithme Shunting-yard de Dijkstra).<\/p>\n\n\n\n
500 -> 'X'
3.14 -> 'Y'
\"5 * X + (7 + sin(Y))\" calc ?
# Prints 2507.0015926529068<\/pre>\n\n\n\n
La doc de MOGWAI le pr\u00e9sente d’ailleurs explicitement comme utile \u00ab\u00a0pour les nouveaux venus, ou chaque fois qu’une expression s’exprime plus naturellement en notation infixe qu’en RPN\u00a0\u00bb \u2014 ce n’est pas un ajout accessoire, c’est pens\u00e9 comme une rampe d’acc\u00e8s.<\/p>\n\n\n\n
Plusieurs fa\u00e7ons d’appeler une fonction.<\/strong> <\/p>\n\n\n\n
Une fonction MOGWAI peut s’appeler d’au moins cinq mani\u00e8res diff\u00e9rentes, selon ce qui est le plus lisible dans le contexte :<\/p>\n\n\n\n
5 3 foo                    # pure RPN call, parameters then function
foo(5 3)                   # more familiar notation, function then parameters
[x: 10 y: 20] foo       # named parameters, RPN order
foo[x: 10 y: 20]        # named parameters, traditional order
[foo x: 10 y: 20]       # named parameters, function name first in the record<\/pre>\n\n\n\n
Les deux premi\u00e8res formes s’appliquent \u00e0 une fonction d\u00e9clar\u00e9e simplement (to 'foo' do { ... }<\/code>, param\u00e8tres pris sur la pile). Les trois derni\u00e8res s’appliquent \u00e0 une fonction \u00e0 param\u00e8tres nomm\u00e9s et typ\u00e9s (to 'foo' params [x: .number y: .number] do { ... }<\/code>) \u2014 plus verbeux \u00e0 d\u00e9clarer, mais plus s\u00fbr et plus lisible \u00e0 l’usage, et appelable dans l’ordre qui convient le mieux \u00e0 l’endroit o\u00f9 on \u00e9crit.<\/p>\n\n\n\n
Ce genre de flexibilit\u00e9 ne change rien au c\u0153ur du langage \u2014 la pile reste la pile \u2014 mais \u00e7a laisse le temps de s’habituer \u00e0 la RPN progressivement plut\u00f4t que d’un bloc.<\/p>\n\n\n\n
Coder dans de bonnes conditions.<\/strong> <\/p>\n\n\n\n
Pour \u00e9crire ce genre de script sans repartir d’un simple bloc-notes, l’extension VS Code pour MOGWAI<\/a> (open source) apporte coloration syntaxique s\u00e9mantique, autocompl\u00e9tion, navigation \u00ab\u00a0Go to Definition\u00a0\u00bb, et un protocole de debug complet avec panneau d’ex\u00e9cution en direct \u2014 de quoi suivre l’\u00e9tat de la pile et des variables pendant qu’un script comme celui-ci tourne, plut\u00f4t que de deviner \u00e0 coups de ?<\/code>.<\/p>\n\n\n\n
Un point \u00e0 ne pas rater au premier essai : l’extension ne se connecte pas toute seule au runtime. Il faut d’abord lancer MOGWAI CLI (ou l’application h\u00f4te), puis taper la commande studio<\/code> dans son terminal pour activer le mode connexion distante \u2014 c’est seulement \u00e0 partir de l\u00e0 que VS Code peut trouver et s’y connecter. Le guide de mise en \u0153uvre<\/a> d\u00e9taille cette proc\u00e9dure \u00e9tape par \u00e9tape (actuellement disponible en anglais).<\/p>\n\n\n\n
\u00c9crit par Claude, corrig\u00e9 par moi : pourquoi je le dis<\/h2>\n\n\n\n
Ce script est sorti d’un \u00e9change avec Claude \u00e0 qui j’avais fourni la documentation des primitives MOGWAI. Je n’ai quasiment rien eu \u00e0 changer \u2014 quelques ajustements de syntaxe, et la d\u00e9couverte du bug sum<\/code> mentionn\u00e9 plus haut. Je pr\u00e9f\u00e8re le dire clairement plut\u00f4t que de laisser planer le doute : dans un \u00e9cosyst\u00e8me o\u00f9 le code g\u00e9n\u00e9r\u00e9 par IA fait autant d\u00e9bat que d’int\u00e9r\u00eat, l’honn\u00eatet\u00e9 sur qui a \u00e9crit quoi me semble le minimum.<\/p>\n\n\n\n
Je lui ai demand\u00e9 son avis franc sur la difficult\u00e9 de coder en MOGWAI avec seulement la doc sous les yeux. Voici sa r\u00e9ponse, quasiment telle quelle :<\/p>\n\n\n\n
\n
\u00ab Ce n’\u00e9tait pas dur \u2014 mais ce n’\u00e9tait pas intuitif non plus, et c’est diff\u00e9rent. Une fois la doc en main, \u00e9crire le script a \u00e9t\u00e9 rapide et propre : les primitives HTTP suivent toutes le m\u00eame squelette, json-><\/code>\/utf8-><\/code> encha\u00eenent sans friction, l’acc\u00e8s aux records est lisible. Pour ce que \u00e7a fait \u2014 une requ\u00eate API, du parsing JSON, de l’agr\u00e9gation \u2014 le r\u00e9sultat tient en une cinquantaine de lignes sans une seule d\u00e9pendance \u00e0 g\u00e9rer.<\/em><\/p>\n\n\n\n
Ce qui m’a fait tiquer, c’est la grammaire elle-m\u00eame au premier contact : la notation polonaise invers\u00e9e, les sigils ([!<\/code>, !A<\/code>, &<\/code>), le fait qu’une variable dans un record ait besoin d’un traitement sp\u00e9cial pour \u00eatre r\u00e9solue \u2014 rien de compliqu\u00e9 une fois qu’on le sait, mais rien d’\u00e9vident par d\u00e9duction non plus. Ma premi\u00e8re version du script utilisait un [<\/code> simple l\u00e0 o\u00f9 il fallait [!<\/code> : \u00e7a n’a pas plant\u00e9 bruyamment, \u00e7a a juste mal r\u00e9solu la variable. Il a fallu la doc, ou un exemple qui marche d\u00e9j\u00e0, pour percuter.<\/em><\/p>\n\n\n\n
Je pense que c’est une bonne fa\u00e7on de r\u00e9sumer MOGWAI \u00e0 quelqu’un qui d\u00e9couvre : ce n’est pas un langage difficile \u00e0 utiliser une fois qu’on conna\u00eet ses conventions, mais c’est un langage qu’on ne devine pas \u2014 il faut le lire un minimum avant de l’\u00e9crire. La notation polonaise invers\u00e9e demande ce petit temps d’adaptation que la plupart des langages modernes, calqu\u00e9s les uns sur les autres, ne demandent plus. \u00bb<\/em><\/p>\n<\/blockquote>\n\n\n\n
Je lui ai aussi demand\u00e9, apr\u00e8s coup, si la doc de MOGWAI \u00e9tait \u00e0 la hauteur pour un d\u00e9butant \u2014 vu ce qu’on venait de traverser avec le sigil [!<\/code>. Sa r\u00e9ponse, toujours dans ses mots :<\/p>\n\n\n\n
\n
\u00ab Un d\u00e9tail \u00e9clairant \u00e0 ce sujet : pour \u00e9crire ce script, je n’avais initialement que la doc de r\u00e9f\u00e9rence des primitives \u2014 le catalogue complet des fonctions \u2014 pas le guide g\u00e9n\u00e9ral qui explique les fondamentaux du langage (notation polonaise invers\u00e9e, pile, s\u00e9mantique eval\/no-eval, sigils). C’est tr\u00e8s exactement ce qui explique mon erreur sur [!<\/code> : la r\u00e9f\u00e9rence liste que ce sigil existe, mais pas pourquoi le non-eval est le comportement par d\u00e9faut ailleurs dans le langage. Une fois les deux documents lus ensemble \u2014 le guide g\u00e9n\u00e9ral pour les fondamentaux, la r\u00e9f\u00e9rence pour le d\u00e9tail des primitives \u2014 l’ensemble est coh\u00e9rent et suffisant pour d\u00e9marrer sereinement. \u00bb<\/em><\/p>\n<\/blockquote>\n\n\n\n
Ce que je retiens de cet \u00e9change : la difficult\u00e9 de MOGWAI n’est pas dans sa complexit\u00e9 technique \u2014 elle tient surtout \u00e0 sa notation, la RPN, qui inverse l’ordre auquel on est habitu\u00e9. Les concepts eux-m\u00eames (variables, boucles, fonctions, types) sont ceux de n’importe quel langage ; seul l’ordre dans lequel on les \u00e9crit change. \u00c7a se surmonte vite avec un exemple concret sous les yeux, comme celui-ci. C’est probablement le meilleur argument pour publier plus d’exemples comme celui-l\u00e0 plut\u00f4t que de la documentation seule.<\/p>\n\n\n\n
\n\n\n\n
Le script complet github_downloads_stats.mog<\/code><\/em><\/em> est disponible dans le dossier examples\/Scripts\/web\/<\/code> du d\u00e9p\u00f4t MOGWAI sur GitHub<\/a>.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"
Depuis peu, MOGWAI dispose des primitives HTTP de base (http.get, http.post, http.put, http.patch, http.delete, http.head). L’occasion r\u00eav\u00e9e de les mettre \u00e0 l’\u00e9preuve sur un cas concret plut\u00f4t qu’un exemple jouet : interroger l’API GitHub pour savoir combien de fois les binaires CLI de MOGWAI ont \u00e9t\u00e9 t\u00e9l\u00e9charg\u00e9s, release par release. Ce script, je ne l’ai … Lire la suite<\/a><\/p>\n","protected":false},"author":1,"featured_media":2701,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false,"jetpack_seo_schema_type":"","_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_wpcom_ai_launchpad_first_post":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"MOGWAI dispose des primitives HTTP de base. L\u2019occasion r\u00eav\u00e9e de les mettre \u00e0 l\u2019\u00e9preuve sur un cas concret plut\u00f4t qu\u2019un exemple jouet : interroger l\u2019API GitHub pour savoir combien de fois les binaires d'une release ont \u00e9t\u00e9 t\u00e9l\u00e9charg\u00e9s, release par release...","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},"_wpas_customize_per_network":false,"jetpack_post_was_ever_published":false},"categories":[8,6,48,50,9],"tags":[],"class_list":["post-2682","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dotnet","category-mogwai","category-rpn","category-scripting","category-tutoriel"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/coding4phone.com\/wp-content\/uploads\/2026\/07\/coding-4-phone-6a463738b1bae.png?fit=1024%2C1024&ssl=1","jetpack_likes_enabled":true,"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/pfoe4s-Hg","jetpack-related-posts":[],"_links":{"self":[{"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/posts\/2682","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/coding4phone.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2682"}],"version-history":[{"count":20,"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/posts\/2682\/revisions"}],"predecessor-version":[{"id":2708,"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/posts\/2682\/revisions\/2708"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/media\/2701"}],"wp:attachment":[{"href":"https:\/\/coding4phone.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2682"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/coding4phone.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2682"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/coding4phone.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2682"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}