Passage de Make à just (#244)

* Add rust-just as a dev dependency

* Move the commands from the makefile to the justfile

* Fix the way coverage is called

* Update messages and search

* Update json export script to include a newline

* Update CI

* Update publish-package script

Author: Ash-Crow

.github/workflows/deploy-doc.yml

@@ -13,12 +13,14 @@ jobs:
     strategy:
       max-parallel: 4
       matrix:
-        python-version: ["3.11"]
+        python-version: ["3.13"]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
+    - name: 📔 Install just
+      uses: extractions/setup-just@v2
     - name: 🐍 Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: ${{ matrix.python-version }}
     - name: 👷 Install Dependencies
@@ -28,7 +30,7 @@ jobs:
         poetry install
     - name: 📄 Build docs
       run: |
-        make export_static
+        just export_static
         touch docs/django-dsfr/.nojekyll
     - name: 🚀 Deploy Github Pages
       uses: JamesIves/github-pages-deploy-action@3.7.1

.github/workflows/publish-package.yml

@@ -9,13 +9,17 @@ jobs:
   publish:
     name: Publish
     runs-on: ubuntu-latest
+    strategy:
+      max-parallel: 4
+      matrix:
+        python-version: ["3.10"]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
     - name: 🐍 Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
-        python-version: "3.10"
+        python-version: ${{ matrix.python-version }}
     - name: 👷 Install Dependencies
       run: |
         python -m pip install --upgrade pip

CONTRIBUTING.md

@@ -7,15 +7,15 @@ L’installation a été testée sur Ubuntu 22.04 avec Python 3.10 et poetry ins
 
 - Installer l’environnement virtuel, les dépendances, les *pre-commit hooks* et initialiser le site d’exemple :
 ```{ .bash }
-make init
+just init
 ```
 
 ## Tests
 
 Pour faire tourner les tests :
 
 ```{ .bash }
-make test
+just test
 ```
 
 ## Gestion des dépendances avec Poetry
@@ -60,10 +60,10 @@ Concernant les langues :
 Pour vérifier son code, on peut intégrer le linter adapté à son IDE et aussi faire ceci :
 
 ```{ .bash }
-make quality
+just quality
 ```
 
-Une vérification automatique est faite via des *pre-commit hooks*, qui ont normalement été installés via le `make init`.
+Une vérification automatique est faite via des *pre-commit hooks*, qui ont normalement été installés via le `just init`.
 
 Il est possible de les mettre à jour avec la commande :
 
@@ -76,14 +76,14 @@ pre-commit update
 Quand une nouvelle version du système de design de l’État est publiée, il est possible de le mettre à jour automatiquement via la commande :
 
 ```{ .bash }
-make update_dsfr
+just update_dsfr
 ```
 
 La commande télécharge la dernière version depuis le dépôt Github, la met dans le répertoire `dsfr/static/dsfr/dist/`, retire des fichiers pour réduire la taille du paquet Python et met à jour les sommes de contrôle d’intégrité dans le fichier `dsfr/checksums`.
 
 Une fois la mise à jour faite, il reste à :
 
-- lancer les tests unitaires avec `make test` ;
+- lancer les tests unitaires avec `just test` ;
 - ouvrir le site de test et vérifier que tous les composants s’affichent toujours bien ;
 - mettre à jour la liste des composants en vérifiant depuis le site du système de design de l’État ;
 - mettre à jour le fichier README.md pour indiquer la nouvelle version du DSFR ;

Makefile

@@ -11,11 +11,28 @@ else
 	local_port := 8000
 endif
 
+# Warnings
+MAKEFLAGS += --no-print-directory
+NO_FORMAT=\033[0m
+C_ORANGERED1=\033[38;5;202m
+
+.PHONY: deprecation-warning
+deprecation-warning:
+	@echo "${C_ORANGERED1}WARNING: this project now uses just instead of make. \
+	This recipe is obsolete and will be removed in a future major version. \
+	Please use the equivalent recipe through just.${NO_FORMAT}"
+
+.PHONY: deletion-warning
+deletion-warning:
+	@echo "${C_ORANGERED1}WARNING: this recipe is obsolete \
+	and will be removed in a future major version.${NO_FORMAT}"
+
 # Commands
 
 .PHONY: collectstatic
 collectstatic:
 	poetry run python manage.py collectstatic --noinput
+	@make deprecation-warning
 
 .PHONY: init
 init:
@@ -24,27 +41,32 @@ init:
 	poetry run python manage.py migrate
 	make collectstatic
 	poetry run python manage.py import_sample_data
-	poetry shell
+	@make deprecation-warning
 
 .PHONY: messages
 messages:
 	poetry run django-admin makemessages -l fr --ignore=manage.py,docs/*
+	@make deprecation-warning
 
 .PHONY: compilemessages
 compilemessages:
 	poetry run django-admin compilemessages
+	@make deprecation-warning
 
 .PHONY: quality
 quality:
 	poetry run pre-commit run --all-files
+	@make deprecation-warning
 
 .PHONY: runserver
 runserver:
 	poetry run python manage.py runserver $(local_port)
+	@make deprecation-warning
 
 .PHONY: test
 test:
 	poetry run python manage.py test
+	@make deprecation-warning
 
 .PHONY: update_dsfr
 update_dsfr:
@@ -53,19 +75,23 @@ update_dsfr:
 	poetry run python manage.py integrity_checksums
 	poetry run python manage.py make_icon_picker_files
 	make collectstatic
+	@make deprecation-warning
 
 .PHONY: upgrade
 upgrade:
 	poetry update
 	poetry run pre-commit autoupdate
+	@make deprecation-warning
 
 .PHONY: static_server
 static_server:
 	python -m http.server 1$(local_port) -d docs/
+	@make deprecation-warning
 
 .PHONY: export_static
 export_static:
 	poetry run python manage.py migrate
 	poetry run python manage.py import_sample_data
 	poetry run python manage.py distill-local docs --force --collectstatic
 	poetry run python manage.py export_json
+	@make deprecation-warning

dsfr/locale/fr/LC_MESSAGES/django.mo

@@ -7,8 +7,8 @@ msgid ""
 msgstr ""
 "Project-Id-Version: \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-04-22 18:50+0200\n"
-"PO-Revision-Date: 2025-04-22 18:51+0200\n"
+"POT-Creation-Date: 2025-07-03 19:15+0200\n"
+"PO-Revision-Date: 2025-07-03 19:15+0200\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: fr\n"
@@ -326,7 +326,7 @@ msgstr "vous êtes ici :"
 msgid "See breadcrumb"
 msgstr "Voir le fil d’Ariane"
 
-#: dsfr/templates/dsfr/breadcrumb.html:15 dsfr/templates/dsfr/header.html:10
+#: dsfr/templates/dsfr/breadcrumb.html:15
 msgid "Home page"
 msgstr "Accueil"
 
@@ -436,16 +436,16 @@ msgstr "Qu’est-ce que FranceConnect+ ?"
 msgid "What is FranceConnect?"
 msgstr "Qu’est-ce que FranceConnect ?"
 
-#: dsfr/templates/dsfr/header.html:29
+#: dsfr/templates/dsfr/header.html:26
 msgid "Menu"
 msgstr "Menu"
 
-#: dsfr/templates/dsfr/header.html:91 dsfr/templates/dsfr/theme_modale.html:13
+#: dsfr/templates/dsfr/header.html:88 dsfr/templates/dsfr/theme_modale.html:13
 #: dsfr/templates/dsfr/transcription.html:30
 msgid "Close"
 msgstr "Fermer"
 
-#: dsfr/templates/dsfr/header.html:95
+#: dsfr/templates/dsfr/header.html:92
 msgid "Main menu"
 msgstr "Menu principal"
 
@@ -523,11 +523,11 @@ msgstr "Thème clair"
 msgid "Dark theme"
 msgstr "Thème sombre"
 
-#: dsfr/templates/dsfr/theme_modale.html:59
+#: dsfr/templates/dsfr/theme_modale.html:60
 msgid "System"
 msgstr "Système"
 
-#: dsfr/templates/dsfr/theme_modale.html:60
+#: dsfr/templates/dsfr/theme_modale.html:61
 msgid "Uses system settings."
 msgstr "Utilise les paramètres système."
 
@@ -539,7 +539,7 @@ msgstr "Activé"
 msgid "Unchecked"
 msgstr "Désactivé"
 
-#: dsfr/templates/dsfr/tooltip.html:6
+#: dsfr/templates/dsfr/tooltip.html:7
 msgid "Contextual information"
 msgstr "Information contextuelle"
 

dsfr/locale/fr/LC_MESSAGES/django.po

@@ -7,8 +7,8 @@ msgid ""
 msgstr ""
 "Project-Id-Version: \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-03-03 16:55+0100\n"
-"PO-Revision-Date: 2025-03-03 16:55+0100\n"
+"POT-Creation-Date: 2025-07-03 19:15+0200\n"
+"PO-Revision-Date: 2025-07-03 19:16+0200\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: fr\n"
@@ -79,29 +79,24 @@ msgid "Book"
 msgstr "Livre"
 
 #: example_app/templates/example_app/blocks/footer.html:12
-#: example_app/templates/example_app/blocks/header.html:31
+#: example_app/templates/example_app/blocks/header.html:27
 msgid "Display settings"
 msgstr "Paramètres d’affichage"
 
 #: example_app/templates/example_app/blocks/footer.html:18
 msgid "Back to home page"
 msgstr "Retour à l’accueil du site"
 
-#: example_app/templates/example_app/blocks/header.html:6
-#: example_app/views.py:91
-msgid "Home page"
-msgstr "Accueil"
-
-#: example_app/templates/example_app/blocks/header.html:43
-#: example_app/templates/example_app/blocks/header.html:68
+#: example_app/templates/example_app/blocks/header.html:39
+#: example_app/templates/example_app/blocks/header.html:64
 msgid "Search"
 msgstr "Rechercher"
 
-#: example_app/templates/example_app/blocks/header.html:52
+#: example_app/templates/example_app/blocks/header.html:48
 msgid "Menu"
 msgstr "Menu"
 
-#: example_app/templates/example_app/blocks/header.html:73
+#: example_app/templates/example_app/blocks/header.html:67
 msgid "Close"
 msgstr "Fermer"
 
@@ -112,3 +107,11 @@ msgstr "Sélectionner une langue"
 #: example_app/templates/example_app/blocks/main_menu.html:13
 msgid "Main menu"
 msgstr "Menu principal"
+
+#: example_app/templates/example_app/page_templatetags.html:70
+msgid "First page"
+msgstr "Première page"
+
+#: example_app/views.py:91
+msgid "Home page"
+msgstr "Accueil"

example_app/locale/fr/LC_MESSAGES/django.mo

@@ -20,16 +20,18 @@ def handle(self, *args, **options):
             )
 
         for file in self.STATIC_ROOT.rglob("*.html"):
-            result = self.get_page_content(file)
+            result = self.get_page_content(file)  # type: ignore
             if result:
                 output.append(result)
 
         # Export to both the static dump and the regular app
         with open(self.STATIC_ROOT / "static/json/search_data.json", "w") as data_file:
             json.dump(output, data_file, indent=4, sort_keys=True)
+            data_file.write("\n")
 
         with open("example_app/static/json/search_data.json", "w") as data_file:
             json.dump(output, data_file, indent=4, sort_keys=True)
+            data_file.write("\n")
 
     def get_page_content(self, file: str):
         filename = str(file).split("/")[-2]