Pythonin asennus: pip ja virtuaaliympäristö

01Mikä Python on ja mihin se asennetaan?

Python on helppolukuisesta syntaksistaan tunnettu yleiskäyttöinen ohjelmointikieli. Sitä käytetään hyvin eri aloilla, kuten data-analyysissä, automaatioskripteissä, verkkosovelluksissa, tekoälytyössä ja järjestelmänhallinnassa.

Yrityksille käytännöllisin käyttöalue on automaatio: Excel-tiedostojen yhdistäminen, sivuston tuotehintojen raportointi tai joka aamu toistuvan työn tekeminen minuuttien sijaan sekunneissa onnistuu muutamalla Python-koodirivillä.

Python-asennuksessa on kaksi kriittistä kohtaa: Windowsissa PATH-asetus ja jokaiselle projektille oma virtuaaliympäristö. Kun nämä kaksi tekee alusta asti oikein, suurin osa myöhemmin vastaan tulevista virheistä ei koskaan ilmaannu.

02Python-lataus: mikä versio kannattaa valita?

Lataa Python aina viralliselta sivustolta python.org. Sivun yläosassa näkyy suositeltu ajantasainen vakaa versio; jos aloitat vasta, valitse se.

Python 2:n tuki päättyi vuosia sitten; asenna ehdottomasti Python 3. Jos projekti vaatii tietyn alaversion (esimerkiksi jokin kirjasto ei vielä tue uusinta versiota), tarkista projektin dokumentaatio.

• Vakaa versio: oikea valinta päivittäiseen käyttöön ja yritysprojekteihin.
• Esiversiot (alpha, beta, rc): vain testaukseen, älä käytä yritysprojekteissa.
• Arkkitehtuuri: useimmat nykyiset tietokoneet ovat 64-bittisiä; ARM-pohjaisilla laitteilla valitse ARM64-asennusohjelma.

03Python-asennus Windowsissa

Kun käynnistät lataamasi asennusohjelman, ensimmäisen näytön alareunassa on Add python.exe to PATH -valinta. Jos painat Install Now -painiketta rastittamatta tätä ruutua, päätteessä python-komentoa ei tunnisteta; tämä on yleisin asennusvirhe.

Asennusohjelma asentaa Pythonin mukana myös py-käynnistimen. py-komento löytää oikean version, vaikka koneella olisi useita Python-versioita, eikä PATH-ongelmat vaikuta siihen; se on turvallinen vaihtoehto Windowsissa.

python.org tarjoaa Windowsille myös uuden Python-asennuksenhallinnan; tämä työkalu helpottaa versioiden asentamista ja hallintaa komentoriviltä. Tarkista latauksen sivulta, mitä tapaa suositellaan; alla olevat varmistuskomennot ovat samat kummassakin tavassa.

python --version
py --version

# Mitä python.exe on käytössä?
Get-Command python

# pipin kutsuminen Pythonin kautta (suositeltu)
py -m pip --version

04Python-asennus macOS:ssä ja Linuxissa

macOS:ssä voit käyttää python.org-sivuston .pkg-asennusohjelmaa tai Homebrewta. Näissä järjestelmissä komennon nimi on yleensä python3 ja paketinhallinta pip3. Älä yritä päivittää tai poistaa järjestelmän mukana tullutta Pythonia; käyttöjärjestelmän työkalut voivat olla siitä riippuvaisia.

Useimmissa Linux-jakeluissa Python 3 on valmiina; puuttuvia ovat yleensä pip- ja venv-paketit.

brew install python
python3 --version

sudo apt update
sudo apt install python3 python3-pip python3-venv
python3 --version

sudo dnf install python3 python3-pip
python3 --version

05Pakettien asennus pipillä

pip on Pythonin paketinhallinta, ja se tulee Pythonin mukana. Se lataa ja asentaa kirjastoja PyPI-nimisestä keskusvarastosta. Kun kutsut pipiä muodossa python -m pip kirjoittamatta suoraan pip, paketti asentuu varmasti oikeaan Python-versioon.

Kun kirjoitat projektissa käyttämäsi paketit requirements.txt-tiedostoon, voit pystyttää saman ympäristön toisella koneella yhdellä komennolla.

• Jos pipiä ei löydy, komento python -m ensurepip --upgrade asentaa pipin uudelleen.
• Linuxissa “externally-managed-environment”-virhe tarkoittaa, että pakettien asennus järjestelmän Pythoniin on estetty. Ratkaisu on käyttää virtuaaliympäristöä; älä käytä sudo pip -komentoa.

# Päivitä pip
python -m pip install --upgrade pip

# Asenna / poista paketti
python -m pip install requests
python -m pip uninstall requests

# Asennetut paketit ja tiedot
python -m pip list
python -m pip show requests

# Tallenna riippuvuudet ja palauta ne
python -m pip freeze > requirements.txt
python -m pip install -r requirements.txt

06Mikä venv on ja miten se luodaan?

venv on sisäänrakennettu työkalu, joka antaa jokaiselle projektille oman Python- ja pakettikansion. Jos yksi projekti tarvitsee kirjastosta vanhan version ja toinen uuden, virtuaaliympäristöt estävät niitä rikkomasta toisiaan.

Virtuaaliympäristön luominen projektikansioon nimellä .venv on yleinen tapa; VS Code tunnistaa tämän kansion automaattisesti. Kun otat ympäristön käyttöön, päätteen rivin alussa näkyy (.venv) ja python sekä pip käyttävät tästä lähtien kyseistä ympäristöä.

• Älä lisää .venv-kansiota Gitiin; kirjoita se .gitignore-tiedostoon ja jaa vain requirements.txt-tiedosto.
• Jos PowerShell estää aktivointiskriptin, salli se vain omalle käyttäjällesi komennolla Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
• Jos käytät komentokehotetta (cmd), aktivointikomento on .venv\Scripts\activate.bat.

cd proje-klasoru
python3 -m venv .venv
source .venv/bin/activate

python -m pip install requests

# Poistu ympäristöstä
deactivate

cd proje-klasoru
py -m venv .venv
.venv\Scripts\Activate.ps1

python -m pip install requests

deactivate

Ensimmäisen skriptin ajaminen

Kun ympäristö on valmis, varmista pienellä skriptillä, että kaikki toimii. Alla oleva esimerkki lähettää virtuaaliympäristöön asentamallasi requests-kirjastolla pyynnön verkkosivulle ja tulostaa vastauskoodin ja keston. Jos tulosteessa näkyy 200, Python, pip ja venv toimivat yhdessä oikein.

Tallenna skripti projektikansioon nimellä kontrol.py ja aja se komennolla python kontrol.py virtuaaliympäristön ollessa aktiivinen. Kehittämällä samaa lähestymistapaa voit kirjoittaa yksinkertaisen valvontaskriptin, joka tarkistaa oman sivustosi sivut säännöllisesti.

import requests

yanit = requests.get('https://www.python.org/', timeout=10)
print('Durum kodu:', yanit.status_code)
print('Kesto (s):', round(yanit.elapsed.total_seconds(), 2))

07Python PATH -asetus ja yleiset virheet

PATH on lista, joka määrää, mistä kansioista käyttöjärjestelmä etsii komentoa. Suurin osa Python-asennuksen ongelmista liittyy tähän listaan.

python-komentoa ei tunnisteta

Käynnistä asennusohjelma uudelleen, valitse Modify ja rastita “Add Python to environment variables” tai aja asennusohjelma alusta PATH-valinnalla. Sulje sen jälkeen kaikki päätteet ja avaa ne uudelleen. Väliaikaisena ratkaisuna voit käyttää py-komentoa.

Väärä Python-versio käynnistyy

Jos koneella on useita Python-versioita, käytetään PATH-muuttujassa ensimmäisenä olevaa. Näet, mikä tiedosto ajetaan, Windowsissa komennolla Get-Command python ja macOS:ssä ja Linuxissa komennolla which python3. Windowsissa komento py -0 listaa kaikki asennetut versiot.

Paketti asennettu, mutta import-virhe

Asennat paketin yhteen ympäristöön ja ajat koodia toisessa. Varmista, että virtuaaliympäristö on aktiivinen, ja valitse VS Codessa oikean alakulman tulkiksi .venv.

08Pythonin seuraavat askeleet

Kun asennus on valmis, Pythonin yhdistäminen tietokantaan on useimmissa projekteissa seuraava askel; PostgreSQL-asennusopas on tässä vaiheessa hyödyksi. PHP-puolella työskenteleville vastaavasta riippuvuuslogiikasta kerroimme artikkelissa Composer-asennus ja paikallisesta palvelinympäristöstä oppaassa XAMPP-asennus.

Koodia kirjoittaessa Python-laajennuksella varustettu editori helpottaa paljon: se näyttää virheelliset rivit heti, valitsee virtuaaliympäristön automaattisesti ja ajaa skriptin yhdellä näppäimellä. Editorin valmisteluun katso VS Code -asennusopas; Python-laajennuksen tunniste ja suositellut asetukset löytyvät sieltä.

Python-skriptejä käytetään myös verkkosivuston teknisen terveyden seurantaan: rikkinäisten linkkien löytämiseen, sivujen vasteaikojen mittaamiseen tai hakudatan raportointiin. Tällaiset mittaukset ovat SEO- ja analytiikkatyön sekä nopeus- ja suorituskykyoptimoinnin perusta.

Automaatiot, jotka siirtävät varasto-, tilaus- tai kirjanpitotietoja järjestelmien välillä, vaativat usein enemmän kuin yhden skriptin; käsittelemme nämä tarpeet verkkokauppaintegraatioiden yhteydessä.