2  Configurer R dans VSCode pour R

Mots clés

configurer R dans VSCode pour R, Environnement R dans VSCode, Configuration de VSCode pour R, installer l’extension vscode-R, R debugging dans VSCode

2.1 Introduction

RStudio : a longtemps été un environnement privilégié pour la programmation R, offrant de riches fonctionnalités pour l’analyse de données et les tâches interactives. D’autre part, VS Code offre un environnement de développement intégré (IDE) plus flexible qui n’est pas limité à un langage de programmation spécifique. Il est possible de le configurer grâce aux paramètres et aux extensions et il prend en charge plusieurs langues.

L’extension vscode-R améliore le codage R dans VS Code, en intégrant de nombreuses fonctionnalités de RStudio. Bien qu’elle ne remplace pas complètement RStudio, elle est idéale pour les utilisateurs qui ont besoin d’un environnement polyvalent prenant en charge plusieurs langages (par exemple, R, Python, C++) et la possibilité de travailler avec des serveurs distants ou des sessions R multiples.

Ce chapitre vous guidera pour configurer votre environnement R dans VSCode afin d’obtenir un flux de travail productif et rationalisé.



2.2 Outils essentiels

Pour créer un environnement de développement R complet dans VSCode, nous allons installer les outils et les packages suivants:

  • VSCode : Un IDE moderne et open-source, hautement personnalisable et prenant en charge un large éventail de langages de programmation.
  • vscode-R : L’extension R essentielle pour Visual Studio Code, permettant la prise en charge du langage R, l’intégration de R Markdown et la communication interactive entre VSCode et le terminal R. Il fournit des fonctionnalités de base telles que:
    • Mise en évidence de la syntaxe : Améliore la lisibilité du code en colorant les mots-clés, les fonctions, les variables, etc.
    • Extraits de code : Inclut des extraits de code intégrés pour R afin d’accélérer le codage.
    • Workspace Viewer : Affiche les variables disponibles dans l’environnement R actuel.
    • Data Viewer : Vous permet de visualiser des data frames et d’autres objets tabulaires.
    • Visualisation de l’aide : Affiche la documentation R.
  • languageserver : Un package R qui implémente le [Language Server Protocol] (https://microsoft.github.io/language-server-protocol/) pour R, offrant des fonctionnalités d’analyse linguistique étendues comme l’auto-complétion, les diagnostics, la documentation, la mise en évidence des symboles, et plus encore.
  • radian : Une console R modernisée, améliorant le terminal R traditionnel avec des fonctionnalités telles que la coloration syntaxique et l’auto-complétion.
  • vscode-R-debugger : Une extension VSCode qui introduit des capacités de débogage R dans VSCode. Les caractéristiques principales incluent:
    • Points d’arrêt : Configurez des points d’arrêt dans vos scripts R pour arrêter l’exécution et inspecter les variables.
    • Débogage progressif : Débogage pas à pas** : parcourez le code ligne par ligne pour mieux comprendre son exécution.
    • Inspection de la pile de commandes : Visualiser la pile d’appels pour comprendre comment les fonctions sont exécutées dans une séquence.
  • httpgd : Un package R fournissant un périphérique graphique qui sert de manière asynchrone des graphiques SVG via HTTP et WebSockets. vscode-R uses httpgd pour fournir une [visionneuse de graphiques] interactive(https://github.com/REditorSupport/vscode-R/wiki/Plot-viewer).
  • [rmarkdown] (https://rmarkdown.rstudio.com) : Ce package R permet de créer des documents d’analyse de données reproductibles, sous forme d’histoires. Avec vscode-R, les utilisateurs peuvent éditer, exécuter et compiler efficacement les fichiers R Markdown.
  • Pandoc (optionnel) : Un utilitaire polyvalent de conversion de documents utilisé par vscode-R pour générer des aperçus de la documentation R lorsqu’elle est survolée dans le code.

2.3 Guide d’installation pour la programmation R dans VSCode

Dans cette section, nous allons parcourir les étapes pour configurer R dans VSCode. Ce guide aborde le processus d’installation et de configuration pour Windows, macOS et Linux.

2.3.1 Étape 1 : Installerer R dans VSCode

  • R : Assurez-vous que R est installé sur votre système. Téléchargez la dernière version à partir du site web CRAN et suivez les instructions d’installation pour votre système d’exploitation.
  • VSCode : Si ce n’est pas déjà fait, installez Visual Studio Code à partir du site officiel. Il est disponible pour différentes plateformes, incluant Windows, macOS et Linux.

2.3.2 Étape 2 : Installerer l’extension vscode-R

  • Ouvrez VSCode et accédez à la vue Extensions en cliquant sur l’icône carrée de la barre latérale ou en appuyant sur la touche Ctrl+Shift+X.
  • Recherchez REditorSupport.r et cliquez sur ‘Installer’ pour l’ajouter à votre environnement VSCode.
Note

Notez que:

  1. Pour les utilisateurs de Linux et macOS:
    • si R est installé à partir du CRAN, les paramètres par défaut devraient fonctionner.
    • Pour les installations personnalisées, mettez à jour les paramètres VSCode r.rterm.linux (Linux) ou r.rterm.mac (macOS) avec le chemin d’accès à votre exécutable R.
  2. Pour Windows:
    • Les paramètres par défaut fonctionnent si R est configuré à partir du CRAN avec l’option ‘Save version number in registry’ activée.
    • Mettez à jour r.rterm.windows avec le chemin de votre exécutable R pour d’autres installations.

2.3.3 Etape 3 : Installerer le package languageserver dans R

Le package languageserver offre des fonctionnalités étendues d’analyse linguistique, telles que l’autocomplétion, les diagnostics et la documentation:

  • Exécutez install.packages('languageserver') dans votre console R pour l’installer.
Note

Notez que, sous Windows, vous pouvez avoir besoin d’installer [Rtools] (https://cran.r-project.org/bin/windows/Rtools/) d’abord.

2.3.4 Étape 4 : Configurer Radian comme console R

radian est recommandé comme terminal R pour une utilisation interactive en raison de ses fonctionnalités modernes, telles que la coloration syntaxique et l’auto-complétion:

  • Installerer radian en utilisant le gestionnaire de packages de Python pip:
    • Linux/macOS: pip install -U radian
    • Windows : Installerez Python à partir du site officiel, puis exécutez pip install -U radian en utilisant Python ou l’Invite de commande.
  • Pour configurer VSCode afin d’utiliser radian comme terminal R par défaut, allez dans File > Preferences > Settings dans VSCode, cherchez r.rterm, et configurez le chemin vers l’exécutable radian.

2.3.5 Étape 5 : Installerer des outils supplémentaires

  • rmarkdown : Installerer rmarkdown for generating reproducible reports: install.packages("rmarkdown").
  • Pandoc : Installerez Pandoc si vous souhaitez générer des aperçus de la documentation R lorsque vous survolez des fonctions ou des variables.

2.3.6 Étape 6 : Configurer VSCode-R-Debugger

L’extension vscode-R-debugger, ainsi que le package R vscDebugger, permet le débogage de R dans VSCode:

  • Installerez l’extension R Debugger depuis la place de marché de VSCode.
  • Installerer les outils vscDebugger package in R using remotes::install_github("ManuelHentschel/vscDebugger").

2.3.7 Étape 7 : Activer httpgd pour un meilleur graphique

httpgd offre une expérience de représentation graphique améliorée pour VSCode:

  • Installer httpgd from CRAN: install.packages("httpgd").
  • Activez r.plot.useHttpgd dans les paramètres de VSCode pour l’utiliser comme visualisateur de graphique par défaut.

2.3.8 Conclusion

Avec les bons outils et les bonnes extensions, VSCode peut devenir un environnement puissant et efficace pour la programmation R. Cette configuration améliorera la productivité et offrira aux utilisateurs de R une expérience de développement transparente.

2.3.8.1 Références