Lukeminen

Mistä on kyse?

Aloitetaan jo olemassa olevien skriptien lukemisesta. Aiemmissa luvuissa tutustuimme Bash ja PowerShell asennusskripteihin. Python ei ole Shell, joten on hieman harvinaisempaa, että asennusskripti on kirjoitettu Pythonilla. Sen sijaan me pengomme /usr/bin-hakemistossa sijaitsevia Python-skriptejä.

Skriptien louhiminen

Louhinta

Alla on skripti, jolla voit kopioida kaikki Python-skriptit virtuaalikoneesta. Skripti noutaa kaikki virtuaalikoneen skriptit ja kopioi ne hakemistoon $REPO/python/ubuntu_python/. Tämän sinä toki jo tiedät, koska osaat tulkita aiempien lukujen oppien avulla skriptin sisällön. Tämän luvun ensimmäinen tehtävä on luoda ja ajaa tämä skripti. Tarkempi tehtävänanto on alempana otsikon Tehtävät alla.

#!/bin/bash
# Usage: getscripts.sh [language]

language=${1:-python}
dirname="ubuntu_$language" 
vm_name="copycat"

# Create new virtual machine using multipass
multipass launch --name $vm_name lts

# List all scripts in the system
declare -a scripts
IFS=$'\n' read -d '' -r -a scripts < <(
    multipass exec "$vm_name" -- find /usr/bin -type f -exec file {} \+ | awk -F: -v lang="${language}" 'tolower($2) ~ lang {print $1}'
)

# Copy all files
for script in "${scripts[@]}"; do
  multipass transfer --parents ${vm_name}:$script ./$dirname/
  echo "Copied $script"
done

# Kill the virtual machine
multipass delete $vm_name
multipass purge

Katsaus

Kun olet ajanut skriptin, sinulla on hakemisto, jossa on kaikki Python-skriptit. Seuraavaksi valitset kolme skriptiä, joita tulet lukemaan. Valitse skriptit, jotka ovat tarpeeksi pitkiä ja monimutkaisia, jotta niiden lukeminen on mielekästä. Alla on listaus helmikuussa 2025 Ubuntu 24.04:stä löytyneistä skripteistä lyhyine kuvauksineen ja pituuksineen.

Alla taulukossa vain ne, joiden pituus on yli 100. Loput löytyvät admonitionin alta.

cd ubuntu_python
find . -type f -exec wc -l {} \; | sort -k1 -r

Tärpit

Tämän luvun toinen tehtävä on tutustua Python-skripteihin, jotka kopioit virtuaalikoneesta host-koneellesi. Osa skripteistä voi olla hieman vaikea lähestyä, jos et ole Pythonin kanssa ennen työskennellyt. Tämän otsikon alaotsikoissa käsitellään muutamat vinkit, joiden avulla voit paremmin ymmärtää skriptien toimintaa.

Sisennys

Toisin kuin Bash ja PowerShell, Python käyttää sisennystä (engl. indentation) koodin rakenteen määrittämiseen. Aiempien kielten skripteissä olet nähnyt sisennystä käytettävän, mutta syynä on pelkkä luettavuuden parantaminen. Pythonissa sisennys vaikuttaa toiminnallisuuteen. Sivuoireena Pythonissa koodiblokin ympärille ei tarvitse laittaa sulkeita esimerkiksi if-lausekkeissa.

Esimerkiksi:

if True:
    print("<= Huomaa sisennys. Tämä toimii!")

if True:
print("<= Huomaa puuttuva sisennys. Tämä nostaa IndentationError-virheen!")

Vertaa tätä PowerShellin syntaksin kanssa:

if ($true) {
Write-Host "Tämä toimii!"; Write-Host "Tämäkin toimii!";
    Write-Host "Ja tämä!"
}

Toimimattomat importit

Jos parsit Python-skriptiä lokaalilla koneella, joka ei ole Ubuntu, huomannet, että VS Code varoittaa joidenkin importtien olevan toimimattomia.

Kuva 1: VS Code:n Pylance varoittaa keltaisella alleviivauksella, että jsonpatch-moduuli on toimimaton. Kuvakaappaus on otettu macOS-koneelta, jossa ei ole kyseistä moduulia. Parsittava tiedosto on jsonpatch.

Nämä toimimattomat importit liittyvät Debian-pohjaisen Ubuntun tapaan käyttää suurta määrää esiasennettuja moduuleita. Moduulit löytyvät hakekistosta: /usr/lib/python3/dist-packages/. Yllä olevan esimerkin (ks. Kuva 1) epätoimiva import jsonpatch ei suinkaan ole kyseinen tiedosto itse, vaikka kyseinen tiedosto sattuu olemaan nimeltään sama. Kyseessä on jsonpatch-niminen kirjasto. Useimmat kirjastot löytyvät PyPi:stä eli Python Package Indexistä. Näinpä esimerkiksi jsonpatch:n dokumentaatio löytyy osoitteesta: https://pypi.org/project/jsonpatch/.

Multipass

Yllä esitelty skripti luo virtuaalikoneen nimeltään copycat. Voit hyödyntää vastaavia komentoja luomaan sinulle oman koneen, jonka sisällä voit harjoitella interaktiivisia komentoja. Esimerkiksi:

# Luo kone SKR(ipti)OH(jelmointi)
multipass launch --name skroh lts

# Näet koneen tiedot näin (esim. ip-osoite)
multipass info skroh

# Avaa koneen terminaali
multipass shell skroh

# Poista kone
multipass delete skroh

# Poista jäänteet
multipass purge

Skriptin koeajo

Skriptin ajaminen voi hyvin antaa konkretiaa siihen, mitä skripti oikeastaan tekee. Olettaen että olet Multipassilla luodun virtuaalikoneen sisällä, skriptien ajaminen on turvallista. Siispä kannattaa kokeilla, saatko esimerkiksi ChatGTP:n ja dokumentaation avulla skriptin tavalla tai toisella käyttöön!

Esimerkiksi skripti /usr/bin/twist3 muuttuu paljon konkreettisemmaksi, kun kokeilet ajaa sitä. Alla on komennot, joilla Twisted-webbiserveri käynnistetään. Web-palvelimen lisäksi Twisted osaa myös DNS, FPT ja muita protokollia. Web-serveri on kuitenkin nopea testata, koska tarvitsemme vain index.html-tiedoston johonkin hakemistoon. Luodaan se ~/www.

$ cd
$ mkdir www
$ echo 'Hello, world!' > www/index.html
$ /usr/bin/twist3 web --path=www
2025-02-24T10:16:43+0200 [-] Site starting on 8080
2025-02-24T10:16:43+0200 [twisted.web.server.Site#info] Starting factory <twisted.web.server.Site object at 0xea8a0140fad0>
2025-02-24T10:16:43+0200 [twisted.application.runner._runner.Runner#info] Starting reactor...

Tyypillinen kielimalli osaisi tarjota sinulle nämä komennot, jos minä en niitä tarjoaisi. Käytä tekoälyä apuopettajanasi! 🤖

Nyt voit avata selaimen ja mennä osoitteeseen http://<multipass-vm-ip>:8080. Saat ip-osoitteen selville yllä esitellyllä multipass info-komennolla.

Kuva 2: Twisted www-palvelimen tarjoilema index.html-tiedosto näkyy host-koneen selaimessa.

Tehtävät

johnanderton
├── README.md
├── bash
│   └── .gitkeep 
├── pwsh
│   └── .gitkeep 
└── python
    ├── README.md
    ├── getscripts.sh
    └── scripts
        ├── kaikki.py
        ├── skriptit.py
        └── tanne.py