Debian Codegraph @

doc/locale/fr/LC_MESSAGES/features/advanced/webapi.po

raw
1 # SOME DESCRIPTIVE TITLE.
2 # Copyright (C) 2023, DataLab Platform Developers
3 # This file is distributed under the same license as the DataLab package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, 2026.
5 #
6 #, fuzzy
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: DataLab \n"
10 "Report-Msgid-Bugs-To: \n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Language: fr\n"
13 "Language-Team: fr <[email protected]>\n"
14 "Plural-Forms: nplurals=2; plural=(n > 1);\n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=utf-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18 "Generated-By: Babel 2.17.0\n"
19
20 msgid "How to use the DataLab Web API for HTTP/JSON integration"
21 msgstr "Comment utiliser l'API Web DataLab pour l'intégration HTTP/JSON"
22
23 msgid "DataLab, Web API, REST, HTTP, JSON, Jupyter, notebook, integration"
24 msgstr "DataLab, API Web, REST, HTTP, JSON, Jupyter, notebook, intégration"
25
26 msgid "Web API"
27 msgstr "API Web"
28
29 msgid "The DataLab Web API provides a modern **HTTP/JSON interface** for external access to the DataLab workspace. It is the recommended integration path for new projects, especially for Jupyter notebooks and web-based tools."
30 msgstr "L'API Web DataLab fournit une interface moderne **HTTP/JSON** pour un accès externe à l'espace de travail DataLab. C'est la voie d'intégration recommandée pour les nouveaux projets, en particulier pour les notebooks Jupyter et les outils basés sur le web."
31
32 msgid "The Web API is available starting from DataLab 1.1. The required dependencies (FastAPI, Uvicorn, Pydantic) are included in the standard DataLab installation."
33 msgstr "L'API Web est disponible à partir de DataLab 1.1. Les dépendances requises (FastAPI, Uvicorn, Pydantic) sont incluses dans l'installation standard de DataLab."
34
35 msgid "Overview"
36 msgstr "Aperçu"
37
38 msgid "The Web API enables:"
39 msgstr "L'API Web permet :"
40
41 msgid "**Jupyter notebook integration** via `DataLab-Kernel <https://github.com/DataLab-Platform/DataLab-Kernel>`_"
42 msgstr "**Intégration de notebooks Jupyter** via `DataLab-Kernel <https://github.com/DataLab-Platform/DataLab-Kernel>`_"
43
44 msgid "**WASM/Pyodide compatibility** (no XML-RPC dependency)"
45 msgstr "**Compatibilité WASM/Pyodide** (pas de dépendance XML-RPC)"
46
47 msgid "**External tool integration** (any HTTP client)"
48 msgstr "**Intégration d'outils externes** (tout client HTTP)"
49
50 msgid "Unlike the XML-RPC interface, the Web API:"
51 msgstr "Contrairement à l'interface XML-RPC, l'API Web :"
52
53 msgid "Uses **JSON** for metadata and **NPZ** for binary data (efficient large array transfer)"
54 msgstr "Utilise **JSON** pour les métadonnées et **NPZ** pour les données binaires (transfert efficace de grands tableaux)"
55
56 msgid "Provides **bearer token authentication** for security"
57 msgstr "Fournit une **authentification par jeton bearer** pour la sécurité"
58
59 msgid "Follows **REST conventions** with OpenAPI documentation"
60 msgstr "Suit les **conventions REST** avec documentation OpenAPI"
61
62 msgid "Works in **browser environments** (WASM/Pyodide)"
63 msgstr "Fonctionne dans les **environnements navigateur** (WASM/Pyodide)"
64
65 msgid "Comparison with XML-RPC"
66 msgstr "Comparaison avec XML-RPC"
67
68 msgid "Feature"
69 msgstr "Fonctionnalité"
70
71 msgid "XML-RPC"
72 msgstr "XML-RPC"
73
74 msgid "Protocol"
75 msgstr "Protocole"
76
77 msgid "XML"
78 msgstr "XML"
79
80 msgid "JSON + Binary (NPZ)"
81 msgstr "JSON + Binaire (NPZ)"
82
83 msgid "WASM Support"
84 msgstr "Support WASM"
85
86 msgid "❌"
87 msgstr "❌"
88
89 msgid "✅"
90 msgstr "✅"
91
92 msgid "Large Arrays"
93 msgstr "Grands tableaux"
94
95 msgid "Slow (base64)"
96 msgstr "Lent (base64)"
97
98 msgid "Fast (NPZ)"
99 msgstr "Rapide (NPZ)"
100
101 msgid "Authentication"
102 msgstr "Authentification"
103
104 msgid "None"
105 msgstr "Aucune"
106
107 msgid "Bearer Token"
108 msgstr "Jeton Bearer"
109
110 msgid "Standards"
111 msgstr "Standards"
112
113 msgid "REST + OpenAPI"
114 msgstr "REST + OpenAPI"
115
116 msgid "Quick Start"
117 msgstr "Démarrage rapide"
118
119 msgid "Enabling the Web API"
120 msgstr "Activer l'API Web"
121
122 msgid "There are several ways to enable the Web API server:"
123 msgstr "Il existe plusieurs façons d'activer le serveur API Web :"
124
125 msgid "**Via UI**: File → Web API → Start Web API Server"
126 msgstr "**Via l'interface** : Fichier → API Web → Démarrer le serveur API Web"
127
128 msgid "**Via environment variable**: Set ``DATALAB_WEBAPI_ENABLED=1`` before starting DataLab"
129 msgstr "**Via variable d'environnement** : Définir ``DATALAB_WEBAPI_ENABLED=1`` avant de démarrer DataLab"
130
131 msgid "When started, DataLab displays the server URL and authentication token in a dialog. The status bar also shows the Web API port when the server is running."
132 msgstr "Au démarrage, DataLab affiche l'URL du serveur et le jeton d'authentification dans une boîte de dialogue. La barre d'état affiche également le port de l'API Web lorsque le serveur est en cours d'exécution."
133
134 msgid "The default port is **18080** (or the next available port if busy)."
135 msgstr "Le port par défaut est **18080** (ou le prochain port disponible s'il est occupé)."
136
137 msgid "Auto-Discovery"
138 msgstr "Découverte automatique"
139
140 msgid "DataLab-Kernel can automatically discover and connect to a running DataLab instance without any manual configuration. When the Web API starts, DataLab writes connection information to a file that DataLab-Kernel reads automatically."
141 msgstr "DataLab-Kernel peut automatiquement découvrir et se connecter à une instance DataLab en cours d'exécution sans aucune configuration manuelle. Lorsque l'API Web démarre, DataLab écrit les informations de connexion dans un fichier que DataLab-Kernel lit automatiquement."
142
143 msgid "**Just load the extension** — no environment variables or explicit connection needed:"
144 msgstr "**Chargez simplement l'extension** — aucune variable d'environnement ni connexion explicite requise :"
145
146 msgid "The auto-discovery mechanism tries the following methods in order:"
147 msgstr "Le mécanisme de découverte automatique essaie les méthodes suivantes dans l'ordre :"
148
149 msgid "**Environment variables** (``DATALAB_WORKSPACE_URL``, ``DATALAB_WORKSPACE_TOKEN``)"
150 msgstr "**Variables d'environnement** (``DATALAB_WORKSPACE_URL``, ``DATALAB_WORKSPACE_TOKEN``)"
151
152 msgid "**Connection file** written by DataLab (native Python only)"
153 msgstr "**Fichier de connexion** écrit par DataLab (Python natif uniquement)"
154
155 msgid "**URL query parameters** (JupyterLite: ``?datalab_url=...&datalab_token=...``)"
156 msgstr "**Paramètres d'URL** (JupyterLite : ``?datalab_url=...&datalab_token=...``)"
157
158 msgid "**Well-known port probing** (``http://127.0.0.1:18080``)"
159 msgstr "**Sondage du port bien connu** (``http://127.0.0.1:18080``)"
160
161 msgid "If discovery fails, DataLab-Kernel starts in standalone mode and you can connect later using ``workspace.connect()``."
162 msgstr "Si la découverte échoue, DataLab-Kernel démarre en mode autonome et vous pouvez vous connecter plus tard avec ``workspace.connect()``."
163
164 msgid "Manual Connection (Legacy)"
165 msgstr "Connexion manuelle (historique)"
166
167 msgid "If auto-discovery doesn't work (e.g., running on a different machine), you can set environment variables before starting your notebook kernel:"
168 msgstr "Si la découverte automatique ne fonctionne pas (par exemple, en cas d'exécution sur une machine différente), vous pouvez définir des variables d'environnement avant de démarrer le noyau de votre notebook :"
169
170 msgid "Then in your notebook using DataLab-Kernel:"
171 msgstr "Puis dans votre notebook utilisant DataLab-Kernel :"
172
173 msgid "API Reference"
174 msgstr "Référence de l'API"
175
176 msgid "Base URL: ``http://127.0.0.1:<port>/api/v1``"
177 msgstr "URL de base : ``http://127.0.0.1:<port>/api/v1``"
178
179 msgid "Status Endpoint (No Auth Required)"
180 msgstr "Point d'accès Status (sans authentification)"
181
182 msgid "Method"
183 msgstr "Méthode"
184
185 msgid "Endpoint"
186 msgstr "Point d'accès"
187
188 msgid "Description"
189 msgstr "Description"
190
191 msgid "GET"
192 msgstr "GET"
193
194 msgid "``/status``"
195 msgstr "``/status``"
196
197 msgid "Server status and version information"
198 msgstr "État du serveur et informations de version"
199
200 msgid "Object Operations (Auth Required)"
201 msgstr "Opérations sur les objets (authentification requise)"
202
203 msgid "All endpoints below require the ``Authorization: Bearer <token>`` header."
204 msgstr "Tous les points d'accès ci-dessous nécessitent l'en-tête ``Authorization: Bearer <token>``."
205
206 msgid "``/objects``"
207 msgstr "``/objects``"
208
209 msgid "List all objects with metadata (JSON)"
210 msgstr "Lister tous les objets avec métadonnées (JSON)"
211
212 #, python-brace-format
213 msgid "``/objects/{name}``"
214 msgstr "``/objects/{name}``"
215
216 msgid "Get object metadata (JSON)"
217 msgstr "Obtenir les métadonnées d'un objet (JSON)"
218
219 msgid "DELETE"
220 msgstr "DELETE"
221
222 msgid "Delete an object"
223 msgstr "Supprimer un objet"
224
225 msgid "PATCH"
226 msgstr "PATCH"
227
228 #, python-brace-format
229 msgid "``/objects/{name}/metadata``"
230 msgstr "``/objects/{name}/metadata``"
231
232 msgid "Update object metadata"
233 msgstr "Mettre à jour les métadonnées d'un objet"
234
235 msgid "Binary Data Transfer (Auth Required)"
236 msgstr "Transfert de données binaires (authentification requise)"
237
238 #, python-brace-format
239 msgid "``/objects/{name}/data``"
240 msgstr "``/objects/{name}/data``"
241
242 msgid "Download object as NPZ archive"
243 msgstr "Télécharger l'objet sous forme d'archive NPZ"
244
245 msgid "PUT"
246 msgstr "PUT"
247
248 msgid "Upload object from NPZ archive"
249 msgstr "Envoyer un objet depuis une archive NPZ"
250
251 msgid "Data Format"
252 msgstr "Format des données"
253
254 msgid "Objects are transferred using NumPy's NPZ format for efficiency."
255 msgstr "Les objets sont transférés au format NPZ de NumPy pour plus d'efficacité."
256
257 msgid "SignalObj NPZ Structure"
258 msgstr "Structure NPZ de SignalObj"
259
260 msgid "ImageObj NPZ Structure"
261 msgstr "Structure NPZ de ImageObj"
262
263 msgid "All API endpoints except ``/status`` require a bearer token:"
264 msgstr "Tous les points d'accès de l'API sauf ``/status`` nécessitent un jeton bearer :"
265
266 msgid "The token is generated when the server starts and displayed in the connection dialog."
267 msgstr "Le jeton est généré au démarrage du serveur et affiché dans la boîte de dialogue de connexion."
268
269 msgid "Environment Variables"
270 msgstr "Variables d'environnement"
271
272 msgid "Variable"
273 msgstr "Variable"
274
275 msgid "Default"
276 msgstr "Valeur par défaut"
277
278 msgid "``DATALAB_WEBAPI_HOST``"
279 msgstr "``DATALAB_WEBAPI_HOST``"
280
281 msgid "Bind address"
282 msgstr "Adresse de liaison"
283
284 msgid "``127.0.0.1``"
285 msgstr "``127.0.0.1``"
286
287 msgid "``DATALAB_WEBAPI_PORT``"
288 msgstr "``DATALAB_WEBAPI_PORT``"
289
290 msgid "Server port"
291 msgstr "Port du serveur"
292
293 msgid "``18080`` (or next available)"
294 msgstr "``18080`` (ou le suivant disponible)"
295
296 msgid "``DATALAB_WEBAPI_TOKEN``"
297 msgstr "``DATALAB_WEBAPI_TOKEN``"
298
299 msgid "Auth token"
300 msgstr "Jeton d'authentification"
301
302 msgid "Generated"
303 msgstr "Généré"
304
305 msgid "Security Model"
306 msgstr "Modèle de sécurité"
307
308 msgid "The Web API implements the following security measures:"
309 msgstr "L'API Web implémente les mesures de sécurité suivantes :"
310
311 msgid "**Localhost binding**: By default, the server only accepts connections from the local machine (127.0.0.1)."
312 msgstr "**Liaison localhost** : Par défaut, le serveur n'accepte que les connexions provenant de la machine locale (127.0.0.1)."
313
314 msgid "**Token authentication**: Every request (except status) must include a valid bearer token."
315 msgstr "**Authentification par jeton** : Chaque requête (sauf status) doit inclure un jeton bearer valide."
316
317 msgid "**Explicit opt-in**: Remote binding (0.0.0.0) requires explicit configuration."
318 msgstr "**Opt-in explicite** : La liaison distante (0.0.0.0) nécessite une configuration explicite."
319
320 msgid "Localhost Token Bypass"
321 msgstr "Contournement du jeton pour localhost"
322
323 msgid "For simplified local development, you can disable token verification for localhost connections in **Edit → Settings → Web API localhost bypass**."
324 msgstr "Pour simplifier le développement local, vous pouvez désactiver la vérification du jeton pour les connexions localhost dans **Édition → Paramètres → Contournement localhost de l'API Web**."
325
326 msgid "When enabled, clients connecting from ``127.0.0.1`` do not need to provide a token. This makes auto-discovery work seamlessly even when the connection file cannot be read (e.g., in JupyterLite or sandboxed environments)."
327 msgstr "Lorsque cette option est activée, les clients se connectant depuis ``127.0.0.1`` n'ont pas besoin de fournir de jeton. Cela permet à la découverte automatique de fonctionner de manière transparente même lorsque le fichier de connexion ne peut pas être lu (par exemple, dans JupyterLite ou les environnements sandboxés)."
328
329 msgid "Only enable localhost bypass when you control all applications running on your machine. Malicious local software could access your data without a token."
330 msgstr "N'activez le contournement localhost que lorsque vous contrôlez toutes les applications s'exécutant sur votre machine. Un logiciel malveillant local pourrait accéder à vos données sans jeton."
331
332 msgid "Exposing the API to the network allows anyone with the token to access your data. Use with caution on trusted networks only."
333 msgstr "Exposer l'API sur le réseau permet à quiconque possédant le jeton d'accéder à vos données. À utiliser avec précaution uniquement sur des réseaux de confiance."
334
335 msgid "Architecture"
336 msgstr "Architecture"
337
338 msgid "The Web API runs in a separate thread from the Qt GUI. The ``WorkspaceAdapter`` ensures thread-safe access to DataLab objects by marshalling calls to the main thread using Qt's signal/slot mechanism."
339 msgstr "L'API Web s'exécute dans un thread séparé de l'interface Qt. Le ``WorkspaceAdapter`` assure un accès thread-safe aux objets DataLab en acheminant les appels vers le thread principal via le mécanisme signal/slot de Qt."
340
341 msgid "Installation"
342 msgstr "Installation"
343
344 msgid "The Web API dependencies are included in the standard DataLab installation:"
345 msgstr "Les dépendances de l'API Web sont incluses dans l'installation standard de DataLab :"
346
347 msgid "FastAPI (web framework)"
348 msgstr "FastAPI (framework web)"
349
350 msgid "Uvicorn (ASGI server)"
351 msgstr "Uvicorn (serveur ASGI)"
352
353 msgid "Pydantic (data validation)"
354 msgstr "Pydantic (validation de données)"
355
356 msgid "No additional installation steps are required."
357 msgstr "Aucune étape d'installation supplémentaire n'est nécessaire."
358
359 msgid "Programmatic Control"
360 msgstr "Contrôle programmatique"
361
362 msgid "The Web API can also be started and controlled programmatically via the XML-RPC interface, which is useful for automated workflows:"
363 msgstr "L'API Web peut également être démarrée et contrôlée par programmation via l'interface XML-RPC, ce qui est utile pour les flux de travail automatisés :"
364
365 msgid "See Also"
366 msgstr "Voir aussi"
367
368 msgid ":ref:`ref-to-remote-control` for the XML-RPC interface (legacy)"
369 msgstr ":ref:`ref-to-remote-control` pour l'interface XML-RPC (historique)"
370
371 msgid "`DataLab-Kernel documentation <https://github.com/DataLab-Platform/DataLab-Kernel>`_ for Jupyter integration"
372 msgstr "`Documentation DataLab-Kernel <https://github.com/DataLab-Platform/DataLab-Kernel>`_ pour l'intégration Jupyter"