Något man kan vilja veta när man felsöker är vilka värden en funktion får in när den anropas. Ett sätt att ta reda på detta är att använda spårutskrifter och skriva ut innehållet i argumenten t.ex.

def process_data(data, arg1, arg2):
    print(f"Kör process_data: {data=}, {arg1=}, {arg2=}")
    # resten av funktionen nedan

I exemplet ovan används en f-sträng för att smidigt visa vad variablerna data, arg1 och arg2 refererar till. Likhetstecknet, =, efter variabelnamnet kommer lägga till variabelnamn= innan värdet i den “färdiga” strängen. Utan = får vi bara värdet på variabeln.

Man kan även skriva godtyckliga uttryck innanför måsvingarna:

value = 5
f"blabla {value}" -> 'blabla 5'
f"blabla {value=}" -> 'blabla value=5'
f"blabla {5+5}" -> 'blabla 10'
f"blabla {5+5=}" -> 'blabla 5+5=10'
f"blabla {len('hej')}" -> 'blabla 3'
f"blabla {len('hej')=}" -> "blabla len('hej')=3"

Funktionerna som ni får i uppgift att skriva i dessa förberedelseuppgifter kommer ni sedan att använda er av i huvuduppgiften. Vissa av dessa uppgifter, eller varianter av dessa uppgifter har ni gjort på lektionen.

Förberedelse 0

För att kunna testa din kod på ett smidigt sätt kan du använda en kodsnutt likt den nedan (det är en bild med flit). Om du har ditt huvudprogram i en separat funktion kan du snabbt växla mellan att testa funktionen du jobbar med just nu och hela programmet.

Öppna en texteditor, skriv in ovanstående och spara filen under namnet pokedex.py

Förberedelse 1

För att slippa skriva URL:en till API:et om och om igen, kan vi använda oss av en global variabel.

# ha med nedanstående variabel högt upp i koden
API_SERVER = "https://www.ida.liu.se/~TDDE44/pokeapi"

Normalt avråder vi från att använda globala variabler eftersom att det lätt leder till lösningar som är svåra att felsöka eftersom det är svårt att ha kolla på var och när de globala variablerna ändras. I detta fall används variabeln som en konstant, dvs vi ändrar aldrig på den, så den gör det därför inte svårare att felsöka. (Python har inget inbyggt stöd för konstanter - nåja, inte på den här grundläggande nivån - utan istället är det kutym att variabler vars värde aldrig förändras skrivs med VERSALER. Tanken är att man ska hajja till och inse att man nog försöker göra något dumt om man någonsin försöker ändra värdet i en variabel skriven helt i versaler.)

Förberedelse 2

Skriv funktionen get_json_as_dict(url) som får en URL som är tänkt att gå till JSON-data. Om statuskoden vid hämtning av data från URL:en är 200 (dvs OK), returnera det dictionary som ni får från JSON-datat. Om statuskoden inte är 200, returnera None.

Tanken bakom att returnera None är att kunna titta på resultatet och se om det gick bra eller inte. Om returvärdet är None, vet vi att något gick fel och kan hantera det.

För att underlätta felsökning, se också till att funktionen skriver ut vilken URL den är på väg att besöka.

Testa din kod innan du går vidare.

Förberedelse 3

Skriv funktionen get_pokemon_url(pokemon_name) som får in ett namn på en pokemon som sträng och returnerar dess fullständiga URL som en sträng.

Förberedelse 4

Skriv funktionen get_pokemon(pokemon_name) som får in ett namn på en pokemon som sträng och returnerar ett dictionary med pokemoninformation som hämtats från PokeAPI (på IDA).

Du kan använda dig av de två funktionerna som du skrivit innan för att göra det lättare!

Testa din kod innnan du går vidare.

Gör så att du har ett skript som tar emot namnet på en pokemon och skriver ut hur många färdigheter den har. Om det inte går att hitta information om det användaren skrivit in som pokémon-namn, skriv ut ett felmeddelande.

Exempel

$ ./pokedex.py pidgey
pidgey has 3 abilities.
$ ./pokedex.py python
No information about 'python' was found.

Gör så att ditt skript tar emot namnet på en pokemon och skriver ut namnen på dess färdigheter.

Exempel

$ ./pokedex.py pidgey
pidgey has 3 abilities.

big-pecks
tangled-feet
keen-eye

Gör så att ditt skript tar emot namnet på en pokemon och skriver ut vilka färdigheter den har och beskrivningarna av dessa färdigheter (använd texten under "flavor_text_entries", inte "effect_entries"). Det är inte säkert att det första elementet är en text på engelska dock.

Exempel

$ ./pokedex.py pidgey
pidgey has 3 abilities.

Ability 'big-pecks':
Protects the Pokémon from
Defense-lowering effects.

Ability 'tangled-feet':
Raises evasion if the Pokémon is confused.

Ability 'keen-eye':
Keen eyes prevent other Pokémon from lowering this
Pokémon’s accuracy.

Ändra i dina funktioner och gör så att man kan ändra språk som används på namnen på färdigheterna och beskrivningarna av färdigheterna.

Exempel

$ ./pokedex.py pidgey ja
pidgey has 3 abilities.

Ability 'はとむね':
防御を　下げる
効果を　受けない。

Ability 'ちどりあし':
こんらん状態の　ときは
回避率が　アップする。　

Ability 'するどいめ':
鋭い　目の　おかげで
命中率を　下げられない。

$ ./pokedex.py pidgey it
pidgey has 3 abilities.

Ability 'Pettinfuori':
Evita che la Difesa diminuisca.

Ability 'Intricopiedi':
Se il Pokémon è confuso, ne aumenta l’elusione.

Ability 'Sguardofermo':
La vista acuta del Pokémon impedisce che la sua
precisione diminuisca.