5  Maîtriser le Service de Langage R dans VSCode

Mots clés

Service de langue R, R dans VSCode, complétion de code dans R, VSCode pour la programmation R, R debugging dans VSCode

5.1 Introduction

Le service de langage R dans Visual Studio Code (VSCode) offre une gamme de fonctionnalités qui rendent l’écriture et la maintenance du code R plus efficaces. Il offre des fonctionnalités avancées telles que la complétion de code, la documentation en ligne et la coloration syntaxique.

Dans ce chapitre, nous allons explorer les principales caractéristiques et fonctionnalités du service de langage R et la manière dont vous pouvez les exploiter pour créer une expérience de développement R transparente.



5.2 Prérequis

Installer les outils essentiels pour la programmation R dans VSCode comme indiqué dans les chapitres précédents (Chapitre 2 et Chapitre 3). Assurez-vous d’avoir le package languageserver installé dans R et l’extension vscode-R dans VSCode.

5.3 Caractéristiques principales

5.3.1 Complétion du code

La complétion de code est l’une des fonctionnalités essentielles fournies par le R Language Service. Au fur et à mesure que vous tapez, des suggestions apparaissent, ce qui peut aider à accélérer le codage et à réduire les erreurs. Cette fonctionnalité est particulièrement utile pour les noms de fonctions longs ou lorsque vous avez affaire à des bibliothèques peu familières.

Autocomplétion globale: Autocomplétion globale

Autocomplétion basée sur l’étendue: Autocomplétion basée sur l’espace de travail

5.3.2 Aperçu de la signature de fonction

Affichage des signatures et des descriptions de fonctions pendant la saisie.

Signature de fonction de package: Signature de la fonction du package

Signature de la fonction par l’utilisateur: Signature de la fonction utilisateur

5.3.3 Documentation au survol

Le R Language Service fournit également une documentation en ligne. Lorsque vous survolez une fonction ou une variable, VSCode affiche une infobulle contenant des informations pertinentes, telles que la description des arguments et des liens vers une documentation détaillée. Cette fonctionnalité vous permet de comprendre les fonctions sans avoir besoin de quitter l’éditeur.

Documentation au survol

5.3.4 Diagnostic du code

Le R Language Service inclut des fonctionnalités de diagnostic qui permettent d’identifier et de résoudre les problèmes dans votre code. Les diagnostics sont affichés sous forme d’avertissements ou d’erreurs en ligne, ce qui vous permet de résoudre les problèmes dès qu’ils se présentent. Cette fonctionnalité, associée au package lintr, permet de s’assurer que votre code respecte les meilleures pratiques.

Diagnostic du code

5.3.5 Formatage du code

Le R Language Service s’intègre au package styler pour le formatage automatique. Voir ici

Sélection de formatage:

Sélection de formatage

Formatage en cours de frappe:

Formatage en cours de frappe

5.3.6 Renommer un symbole

Refondre le code efficacement en renommant les symboles dans l’ensemble du projet. Le service de langage R permet de changer facilement les noms de fonctions ou de variables de manière cohérente.

Renommer un symbole

5.4 Organisation du document

5.4.1 Mise en évidence des symboles

Mettez en évidence toutes les occurrences d’un symbole dans votre script afin d’identifier facilement l’endroit où il est utilisé dans le document.

Mise en évidence des symboles

5.4.2 Sélection de documents

Développer les sélections de manière incrémentale en utilisant Shift+Alt+RightArrow. Cela permet de sélectionner des expressions R entières ou des blocs de code imbriqués.

Sélection de documents

5.4.3 Sections de code

Le serveur de langage R identifie des blocs de code distincts, connus sous le nom de sections de code, dans VSCode. Ces sections, qui comprennent des expressions R cohérentes, sont accessibles pour la navigation via l’en-tête du plan ou du panneau. Les sections de code peuvent être repliées pour une vue plus ordonnée et mieux organisée.

Sections de code

Replier les sections de code:

Repliage des sections de code

5.4.4 Hiérarchie des appels

Visualisez les séquences d’appels dans les expressions pour comprendre comment les différentes parties de votre code interagissent.

Hiérarchie des appels

5.6 Sélecteur de couleurs

Les chaînes de texte identifiées comme des couleurs R sont affichées à l’aide d’un marqueur de couleur. Le survol de ce marqueur fait apparaître une fenêtre contextuelle de sélection des couleurs, qui vous permet de modifier la couleur spécifiée.

Sélecteur de couleurs

5.7 Conseils pour une utilisation efficace

  • Integration du Terminal R : L’extension vscode-R s’intègre directement au terminal R, ce qui rend facile l’exécution de lignes de code ou de scripts entiers. Utilisez Ctrl + Enter pour envoyer du code au terminal R tout en gardant votre flux de travail ininterrompu.
  • Utiliser la Palette de Commandes : La Palette de Commandes (Ctrl + Shift + P) offre un moyen rapide d’accéder à diverses commandes apparentées à R. Par exemple, vous pouvez utiliser R : Create Terminal pour ouvrir rapidement une nouvelle session de terminal R.
  • Débogage avec des points d’arrêt : Vous pouvez configurer des points d’arrêt dans votre code R en utilisant l’extension vscode-R-debugger, qui s’intègre avec le package vscDebugger pour fournir des capacités de débogage dans VSCode.

Pour en savoir plus sur la programmation R dans VSCode, consultez le chapitre Chapitre 2 et explorez les extensions recommandées dans le chapitre Chapitre 3.

5.8 Conclusion

La maîtrise du R Language Service dans VSCode peut significativement augmenter votre productivité lorsque vous travaillez avec des scripts R. En tirant parti de fonctionnalités telles que la complétion de code, la documentation en ligne et les extraits de code, vous pouvez rationaliser votre processus de codage et vous concentrer davantage sur vos tâches d’analyse de données.

5.9 Références