Formålet med R-pakken bilfar er å lage rapporter i henhold til kontrollavtalene med andre land. Pakken bygger videre på det arbeidet som Trond H og Anna har gjort.
Målet er at rapportleveransen skal bli så enkel som mulig å utføre. Det gjelder både i manuell og automatisert gjennomføring av oppdraget
I gjeldende versjon av pakken er det kun mulig å kjøre rapporteringsprosessen manuelt. Det vil si at R-pakken må installeres og aktuelle funksjoner må kjøres gjennom en terminal. Der er likevel slik at de fleste steg er "knyttet sammen" for å begrense omfanget av manuelt arbeid.
"Full" automatisering er avhengig av et miljø der pakken kan aktiveres av et "system" på definerte tidspunkter, eksempelvis én gang per månded. Et slikt miljø finnes kanskje allerede, men det dette er avklaringer som må gjøres sammen med våre IT-folk.
Det er ikke kjent om direktoratet har en egen "pakkebrønn" der bilfar kan gjøres tilgjengelig for direkte installasjon hos den enkelte. Inntil det er klart må koden klones fra bitbucket, eksempelvis ved bruk av ssh:
git clone ssh://git@stash.fiskeridirektoratet.no:7999/far/bilfar.gitÅpne en R-terminal, gå inn i bilfar-katalogen og installér pakken ved bruk av devtools-pakken:
devtools::install()Funksjonene vil være tilgjengelig så snart pakken knyttes til R-sesjonen:
library("bilfar")Denne må vi komme tilbake til når flere av funksjonen er klare
Utvikling av R-pakken vil følge standard tilnærming:
- Lag en egen git-grein for endringen
- Gjør endringer og sjekk at alt fungerer
- Be en kollega se over ved å lage en "pull request"
- Når alle er enige, gjør en "merge" mot "main"-greina og slett utviklingsgreina
Dokumentasjon inngår som en integrert del av utviklingsprosessen og alle beskrivelser, eksempelvis det du leser nå, triller ut når utviklingen er ferdigstilt. Man slipper da å vedlikeholde egen dokumentasjon på siden, men ivaretar heller behovet som en del av standard utviklingsprosess. I dette tilfellet er dette vist for R, men veldig mange andre "språk" har tilsvarende verktøy for å ivareta behovet for produksjon og tilgjengeliggjøring av dokumentasjon.