Componenti di un pacchetto R

Sviluppare pacchetti R

Jasmin Ludolf

Content Developer

La potenza dei pacchetti R

 

  • Condividi e riusa codice tra progetti, azienda e community

 

Questo corso:

  • Crea pacchetti R da zero
  • Inclusa documentazione e testing

Illustrazione community dei pacchetti R

Sviluppare pacchetti R

Componenti del pacchetto R

Struttura esempio del pacchetto

1 Albero generato con https://tree.nathanfriend.io/
Sviluppare pacchetti R

Componenti del pacchetto R

 

  • Funzioni
  • Dati

Struttura esempio del pacchetto

Sviluppare pacchetti R

Componenti del pacchetto R

 

  • File di supporto:
    • DESCRIPTION
    • NAMESPACE

Struttura esempio del pacchetto

Sviluppare pacchetti R

Componenti del pacchetto R

 

  • Template R Markdown:
    • Come usare il pacchetto
  • R Markdown serve per creare report dinamici

Struttura esempio del pacchetto

Sviluppare pacchetti R

Componenti del pacchetto R

 

  • Documentazione
    • Esempi d’uso delle funzioni

Struttura esempio del pacchetto

Sviluppare pacchetti R

Componenti del pacchetto R

 

  • Test unitari
    • Test automatici
    • Verificano che funzioni e codice siano corretti

Struttura esempio del pacchetto

Sviluppare pacchetti R

Componenti del pacchetto R

 

  • Vignette
    • Tutorial estesi del pacchetto

Struttura esempio del pacchetto

Sviluppare pacchetti R

Funzionalità di base del pacchetto

Al minimo, i pacchetti R devono includere:

  • directory R
  • directory man
  • file NAMESPACE
  • file DESCRIPTION
Sviluppare pacchetti R

Directory R

 

  • Dove risiedono le funzioni del pacchetto
  • File separati per ogni componente del pacchetto
  • Includi un file con nome e dettagli del pacchetto

 

Struttura directory R

Sviluppare pacchetti R

Directory man

 

  • Directory del manuale
  • Documentazione di funzioni e oggetti del pacchetto

 

Struttura directory man

Sviluppare pacchetti R

NAMESPACE

  • Mostra le funzioni importate da altri pacchetti
  • Elenca le funzioni disponibili per l’utente
# Generated by roxygen2: do not edit by hand
export(distance_converter)
export(temp_converter)

importFrom(tibble,tibble)
Sviluppare pacchetti R

DESCRIPTION

  • Include i metadati del pacchetto
Package: ourPackage
Title: What the Package Does (One Line, Title Case)
Version: 0.0.0.9000
Authors@R: 
    person("First", "Last", , "[email protected]", role = c("aut", "cre"),
           comment = c(ORCID = "YOUR-ORCID-ID"))
Description: What the package does (one paragraph).
License: `use_mit_license()`, `use_gpl3_license()` or friends to pick a
    license
Encoding: UTF-8
Roxygen: list(markdown = TRUE)
RoxygenNote: 7.2.3
Depends: 
    R (>= 2.10)
LazyData: true
Sviluppare pacchetti R

Passons à la pratique !

Sviluppare pacchetti R

Preparing Video For Download...