teamsykmelding-cli

En liten verktøykasse for #team-sykmelding

Kom i gang

Oppsett

• Du må ha Node.js installert, husk å bruk verktøy som nvm, mise eller asdf for å håndtere versjoner.
• Du må ha bun.sh installert, dette kan installeres med curl (curl -fsSL https://bun.sh/install | bash)

Node med mise

Om du installerte node med mise må du køyre desse kommandoane i kommandolinja for å aktivere det.

echo 'eval "$(mise activate zsh --shims)"' >> ~/.zprofile # this sets up non-interactive sessions
echo 'eval "$(mise activate zsh)"' >> ~/.zshrc    # this sets up interactive sessionseval "$(mise activate zsh)"

Konfigurasjon

Du må ha en .npmrc fil på root i home-mappen din med følgende innhold:

@navikt:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NPM_AUTH_TOKEN}

Tilgang

Du må ha en PAT (Personal Access Token) for å kunne laste ned pakker fra Github Package Registry. Denne kan du lage her. Du må gi den read:packages scope, bruk PAT typen "classic"

Legg til denne i din ~/.bashrc eller ~/.zshrc fil:

export NPM_AUTH_TOKEN=<din token>
export ORG_GRADLE_PROJECT_githubPassword=<din token>
export ORG_GRADLE_PROJECT_githubUser=x-access-token

Installer CLI

npm i -g @navikt/teamsykmelding-cli

Nå er du klar til å bruke tsm!

Automatisk generert dokumentasjon

• doctor - check that all tooling and such looks OK
• auth - login to gcloud
• commits - get the last commits for every repo in the team
• prs - get all open pull requests
• repos - get all repos
• vulns - get all vulnerabilities for the team (Github)
• builds - checks all repos for failing builds (on main)
• git - keep our repos in sync, ex: tsm git sync
• work - see what has happened the last week (or more)
• mock - do stuff with the mock
• team - get all team members
• sync-file - sync a file across specified repos
• sync-cmd - execute a command across multiple repos and stage and commit the changes
• primary-branch - get misc repo metadata
• mob - make a mob commit
• config - set config for tsm
• upgrade - update the cli
• changelog - get the latest changes in tsm cli
• analytics - get your own usage stats for tsm cli
• open - open command that opens a project in IntelliJ IDEA
• web - open web page
• gh - open github repo in browser
• search - search github repos for a given regex
• secret - get secret
• kafka - kafka cli for kafka stuff
• azure - azure cli for azure stuff
• docker - docker stuff

Du kan også bruke tsmx for å interaktivt bytte mellom team, dersom du har satt opp flere team med tsm config --team=<team>.

Eksempler på bruk:

Sjekk at du har satt opp alle verktøy riktig

tsm doctor

Alle åpne pull requester i våre repos, inkludert drafts

tsm prs --drafts

Se alle statuser på bygg i alle repos

tsm builds

Hent alle nyeste commits i alle repos

tsm commits

Hent de 10 reposene som er lengst siden oppdatert

tsm commits --order=asc --limit=10

Finn alle repos som bruker yarn

tsm repos --query='cat .yarnrc.yml'

Utvikling

Dette kommandolinje-verktøyet er skrevet i TypeScript og bruker bun.sh. For å kjøre det må du først bygge det:

bun install

Deretter kan du kjøre det med:

bun run src/index.ts