nav-faker
nav-faker er et lite bibliotek som lar deg generere opp norske testdata. Biblioteket er under utvikling.
Planen er å implementere støtte for generering av tilfeldige:
- Fødselsnummere / d-nummere
- Adresser
- Navn
- Tall og datoer
Install
npm install --save nav-faker
Usage
React / Javascript
import navfaker from 'nav-faker/dist/index';
navfaker.personIdentifikator.fødselsnummer(); // => 10108000398
Test det ut
https://repl.it/@Quist/nav-faker-demo
API
Summary
nav-faker har følgende moduler:
- dato
- personIdentifikator
- random
- person
- telefon
Dato
mellom(fra: Date, til: Date): Date;
forÅrSiden(årSiden: number): Date;
PersonIdentifikator
fødselsnummer(fødselsdato?: Date, kjønn?: number): string;
dnummer(fødselsdato?: Date, kjønn?: number): string;
myndigFødselsnummer(kjønn?: number): string;
getFødselsdato(fødselsnummer: string): Date;
Person
kjønn(): number;
antallBarn(fødselsdato: Date): number;
Random
number(max?: number, min?: number): number;
vektetSjanse(vekt: number): boolean;
Telefon
mobil(): string;
jobb(): string;
Bidra?
Kom gjerne med innspill, ønsker og pull-requester!
nav-faker er skrevet i typescript og kompileres ned til javascript. Dette kan da dras inn som en avhengighet av andre applikasjoner. nav-faker er satt opp med et CI bygg vha github actions.
Oppsett
Installer dependencies: yarn
Bygg og linting med: yarn build
Test
yarn test
Committe
Vi bruker verktøyet semantic-release for å bestemme når og hvilken versjon som skal publiseres til NPM. Verktøyet analysere commit-meldinger for å bestemme om patch, minor eller major versjon skal publiseres.
Du må derfor følgende gjeldene commit-message convention.
Man kan enten kjøre yarn commit
, eller innstallere commitizen globalt via yarn global add commitizen
og deretter kjøre git cz
Når du ønsker å commite: yarn commit
Publisering til NPM
Når kode merges inn i master, analyseres semantic-release commit-meldingene siden forrige publish til NPM. Basert på innholdet i meldingene, bestemmes om og isåfall hvordan versjon som skal publiseres.
Filosofi
nav-faker baserer seg på marak/faker. Mockingen deles inn i moduler, .f.eks fødselsnummer, dato og person. I utgangspunktet er planen å kun støtte å generere mock-data, ikke et util bibliotek.
Henvendelser
Spørsmål knyttet til koden eller prosjektet kan stilles via issues, evt via intern slack på #personoversikt-intern