Hoppa till innehållet
POLARISAI ACADEMY
Fördjupning, frivillig

Den här lektionen är en frivillig fördjupning till kursen F05. Den innehåller räkneexempel och fackord. Börja med F05 om du är ny. Till kursen F05 →

FD05 · Första ljuset

Datorvana: filer, terminal, git och editor

Du kan starta ett Git-repo, läsa JSON i ett kort skript och skriva ut ett fält, ångra en dålig commit med git revert, och hålla en .env-fil utanför Git med .gitignore. Du kan också hitta din egen rad i en stack trace och skilja exitkod 0 från alla andra koder.

Nivå
Första ljuset
Tid
10 h (uppskattning)
Förkunskap
F05
Kurs 5 av 7
Hoppa till

Efter kursen kan du

Eleven kan skapa ett Git-repo, hämta och tolka JSON med ett skript, ångra en felaktig commit på ett rent sätt och stoppa .env-hemligheter med .gitignore.

Sökvägar och mappen du står i

En sökväg är adressen till en fil. En absolut sökväg börjar vid roten och räknar upp varje mapp på vägen, till exempel /home/sam/notes/todo.md på Linux eller macOS. En relativ sökväg utgår från mappen du redan står i. Står du i notes heter samma fil bara todo.md. I Windows skrivs en enhetssökväg som C:\Users\sam\notes\todo.md, och många terminaler där godtar också vanliga snedstreck. Innehåller namnet ett mellanslag sätter du citattecken runt sökvägen. Annars delar skalet upp den i två argument och letar efter en fil som inte finns.

ls skriver ut namnen i mappen du står i. ls -l lägger till storlek, ägare och rättighetsbitar. cd notes går ner i notes, cd .. går upp ett steg, och cd utan argument tar dig till hemkatalogen. pwd skriver den absoluta sökvägen till mappen terminalen använder. Kör det när ett skript inte hittar en fil som du ser i editorn. Editorn och terminalen startar ofta i olika mappar. Spara filen, kör pwd, och se att sökvägen stämmer med fliken du just redigerade.

Sök, pipor, exitkoder och variabler

grep price notes.txt skriver ut varje rad i filen som innehåller price. grep -n lägger till radnumret, alltså siffran du slår upp när en krasch pekar på en fil och en rad. En pipa skickar utdata från ett kommando in i nästa. ls | grep env visar bara synliga namn som innehåller env. Lägg till -a, som i ls -a | grep env, för att också få med dolda namn som .env. curl hämtar innehållet på en adress och skriver ut det. Lägg till -f om du vill att en HTTP-felsida ska räknas som misslyckande. Ett kort skript kan spara svaret och sedan skriva ut ett fält ur JSON.

Varje program lämnar en exitkod när det tar slut. Koden 0 betyder att kommandot gjorde jobbet du bad om. En annan kod betyder att något gick fel, och texten ovanför prompten säger vad. grep använder 1 när sökningen gick rent men ingen rad matchade. Det är ett giltigt svar, och det fäller ändå ett skript som avbryter vid första koden som inte är 0. Läs både texten och koden. I en pipa är koden du ser koden från sista kommandot, om du inte slagit på pipefail i skalet.

ls -l börjar varje rad med ett tecken för filtyp och nio rättighetsbitar, till exempel -rw-r--r--. Strecket betyder vanlig fil och d betyder mapp. Av de nio bitarna gäller de tre första ägaren, de tre nästa gruppen, och de tre sista alla andra. r betyder läsa, w betyder skriva, och x betyder köra. Ett skript utan x för dig startar inte som ./script.sh förrän chmod u+x script.sh lägger till körbiten för ägaren. bash script.sh kör det ändå. Miljövariabler är namn som skalet håller för sessionen. HOME innehåller din hemkatalog. export API_TOKEN=example-value sätter ett namn som ett program kan läsa medan det kör. Texten example-value är bara ett exempel.

Hemligheter och .gitignore

En .env-fil är rader på formen NAMN=värde. Program som använder en inläsare som dotenv läser den vid start, så lösenord, token och värdadresser slipper ligga i koden du visar andra. Git minns en fil från committen där du la till den. Tar du bort filen i en senare commit går den gamla committen fortfarande att läsa. Den som klonar repot kan checka ut den committen och se hemligheten. Har en riktig hemlighet redan pushats ska du räkna den som kopierad och byta ut den hos tjänsten som utfärdade den.

.gitignore ligger i projektroten och listar mönster som Git ska hoppa över. En rad med .env hoppar över en fil med det namnet i vilken mapp som helst. En rad med *.log hoppar över namn som slutar på .log. Mönstret gör inget om Git redan spårar filen. Visar git status fortfarande .env som ändrad kör du git rm --cached .env. Det tar bort filen ur indexet och lämnar kvar din kopia på disk. Committa den ändringen. Läs git status före varje commit. En ignorerad .env syns inte i listan.

Commits, grenar och revert

git init skapar ett repo här och lagrar historiken i .git. git status listar ändringar. git add notes.md lägger filen i indexet. git commit -m "Add price notes" sparar snapshoten med det meddelandet. git diff skriver ostagade rader som borttag och tillägg. git diff --staged skriver vad nästa commit innehåller. En gren är ett namn på en commit. git switch -c wip skapar wip och byter till den. git merge wip tar in arbetet på grenen du står på.

git revert ångrar en vald commit genom att lägga till en ny commit med motsatt diff. HEAD är den nyaste committen på grenen du står på. Om den dåliga committen satte 99 där filen hade 12, lägger revert-committen tillbaka 12. Den dåliga committen ligger kvar i git log, och reverten ligger ovanpå. Välj det här när committen redan är pushad. En merge-commit behöver -m och ett föräldranummer. Träffar patchen en senare ändring stannar Git med en konflikt som du rättar och committar.

En stack trace är listan som skrivs ut när ett program kraschar. Varje frame namnger en funktion, en fil och en rad. Öppna den frame som namnger din fil och läs den raden i editorn. Frames inne i ett bibliotek visar vilket anrop som misslyckades. I JSON ligger objekt i klamrar, listor i hakparenteser, och ett fält ser ut som "price": 12. YAML lagrar data med indentering i stället för klamrar. Markdown är vanlig text för en README. En rad som börjar med # är en rubrik.

Ett exempel

Ångra ett felaktigt pris i ett nytt repo

Skapa mappen shop och kör git init där. Terminalen skriver att den initierade ett tomt Git-repo, och sökvägen slutar med shop/.git. Lägg en rad med .env i .gitignore. Lägg TOKEN=example-secret i .env. Kalla värdet ett exempel. git status listar .gitignore som ospårad. .env syns inte, eftersom mönstret träffar den. Lägg {"qty": 4, "price": 12} i item.json. Committa .gitignore och item.json med meddelandet "Add item".

Ett skript som läser item.json och skriver ut qty gånger price skriver 48. Du kan räkna efter för hand, för 4 gånger 12 är 48. Skriptet ska avslutas med koden 0. Ett kommando är python -c "import json; d = json.load(open('item.json')); print(d['qty'] * d['price'])" och det skriver 48. Samma steg fungerar om första raden hämtar JSON med curl -fsS och skriver kroppen till item.json innan parsern kör.

Ändra priset från 12 till 99 och committa med meddelandet "Set price to 99". För hand är 4 gånger 99 lika med 396, fel summa i det här exemplet. git show --stat på den committen namnger item.json och visar en tillagd och en borttagen rad. git revert HEAD --no-edit lägger sedan till en ny commit. Ämnesraden som skrivs ut börjar med Revert "Set price to 99". git log --oneline listar tre commits, den nyaste först. Committen med 99 ligger kvar i listan. Öppnar du item.json står där 12 igen.

Övning

Gör det själv

Skapa en mapp. Lägg bara .env i .gitignore. Lägg TOKEN=example-secret i .env, och behandla värdet som ett exempel. Lägg {"qty": 4, "price": 12} i item.json. Räkna på papper 4 gånger 12 och sedan 4 gånger 99. Har du en terminal kör du git init och git status, och ett kort skript som läser JSON och skriver ut qty gånger price. Committa .gitignore och item.json. Sätt priset till 99, committa, och kör git revert HEAD --no-edit. Utan terminal klistrar du stegen till en gratis chattbot och frågar vad de skriver ut.

På pappret står 48 och 396. git status före första committen listar .gitignore och item.json, och utelämnar .env. Skriptet skriver 48 och avslutas med 0. Efter reverten visar git log --oneline tre commits. Den nyaste ämnesraden börjar med Revert. item.json har 12 igen, så skriptet skriver 48 en gång till. Committen i mitten nämner fortfarande priset 99. Syns .env i git status saknas ignoreringsraden, eller så är filen redan spårad.

Kontrollfrågor

Svara själv först. Öppna sedan frågan för att se svaret.

Ett kommando avslutas med exitkod 0. Vad betyder den koden?

Kommandot gjorde jobbet det blev ombett att göra. En annan kod betyder att kommandot rapporterade fel. grep använder 1 när sökningen körs och ingen rad matchar.

Vad lägger git revert HEAD --no-edit till i repot?

En ny commit vars diff är motsatsen till den nyaste committen. Den gamla committen ligger kvar i loggen. I shop-exemplet finns tre commits, och priset går från 99 tillbaka till 12.

.env är redan spårad, och .gitignore innehåller raden .env. Hur slutar Git spåra filen medan den ligger kvar på disk?

Kör git rm --cached .env och committa ändringen. Filen blir kvar på disk, och senare commits tar inte med den.

item.json har qty 4 och price 12. Skriptet skriver ut qty gånger price. Vad skrivs ut, och vad är 4 gånger 99?

Det skrivs ut 48, eftersom 4 gånger 12 är 48. Fyra gånger 99 är 396, den felaktiga summan i den dåliga committen.

Ta med dig

Ignorera .env före första committen, räkna JSON-produkten för hand, och låt git revert lägga en ny commit när en delad ändring blev fel.

Slutuppgift

Lämna in ett Git-paket som automatiska tester kontrollerar: ren historik, en ångrad felaktig commit, .gitignore som blockerar .env, inga läckta nycklar i git log -p, samt ett skal- eller Python-skript som tolkar data och klarar 10 fasta in- och utdatatester.

Slutuppgiften rättas av fasta facit och automatiska tester när proven öppnar.

Prov och diplom kommer

Lektionen är öppen att läsa. Prov, diplom och konto kommer senare; väntelistan är till för dem. Till väntelistan