At læse Azure CLI-kildekoden

"Et billede siger mere end tusind ord." God open source-kode er ofte mere informativ end dokumentation.

Tag Azure CLI som eksempel. Det er en velskrevet Python-applikation, og hvis du undrer dig over, hvordan en bestemt kommando fungerer, kan du kigge i koden.

Hvordan fungerer az-kommandoen som en eksekverbar fil, når det bare er et Python-script? Tjek az filen og de andre filer i samme mappe.

Eller hvad gør acr login under motorhjelmen? Den kalder docker login med de rigtige credentials.

Endnu et eksempel: hvordan fungerer az login? Den henter JWT tokens ved hjælp af et andet open source-bibliotek - Microsoft Authentication Library (MSAL). Skærmbilledet viser et minimalt eksempel, der gør det samme som az login for at hente et nyt access token.

Jeg siger ikke, at dokumentation er ubrugelig. Tværtimod - god dokumentation som denne forklarer teorien og giver best practices og eksempler, som sjældent er tilgængelige i kildekoden. At læse både kode og dokumentation er som at se det fulde billede. Dokumentationen giver dig overblikket og forklarer "hvorfor", mens koden viser dig "hvordan" og implementeringsdetaljerne. Tilsammen giver de en dybere forståelse og hjælper dig med at bygge bro mellem teori og praksis.