*VALMIS*: Harjoitus 1: Ensimmäinen ohjelmasi
********************************************

Käytitähän reilusti aikaa harjoituksessa 0: Opit asentamaan tekstieditorin ja
käyttämään sitä, käynnistämään päätteen ja käyttämään molempia yhtäaikaa. Jos
ohjelmien käyttö ei vielä suju, älä jatka vielä eteenpäin. Harjoittele jokainen
askel huolella. Tämän jälkeen en aloita harjoituksia varoitellen mutta muista:
etene askel kerrallaan äläkä ohita mitään.

.. literalinclude:: ex/ex1.py
    :linenos:

Kirjoita yllä näkyvä tiedostoon ``ex1.py``. Tämä on tärkeää sillä python toimii
parhaiten sellaisten tiedostojen kanssa joiden päätteenä on ``.py``.

.. warning::

    Älä kirjoita rivien vasemmassa laidassa näkyviä numeroita. Niitä kutsutaan
    rivinumeroiksi. Ohjelmoijat käyttävät niitä kun keskustellaan siitä että
    mikä kohta ohjelmassa on virheellinen. Python kertoo sinulle virheistä
    hyödyntäen rivinumeroita mutta *sinun* ei tule kirjoittaa niitä itse.

Seuraavaksi siirry päätteeseen ja *suorita* tiedosto kirjoittamalla:

.. code-block:: console

    python ex1.py

Jos kaikki meni oikein, sinun pitäisi nähdä alla oleva tuloste. Muussa tapauksessa
olet tehnyt virheen jossakin. Ei, tietokone ei ole väärässä.

Tältä sen tulisi näyttää
========================

.. literalinclude:: ex/ex1.txt
    :language: console

Sinulla voi näkyä hakemistosi nimi ennen ``$``-merkkiä.  Se ei haittaa.
Jos tulosteesi on muutoin erilainen, selvitä miksi näin on ja korjaa se.

Jos koodissasi on virhe, se näyttää tältä:

.. literalinclude:: ex/ex1.err
    :language: console
    :linenos:

On tärkeää, että kykenet lukemaan virheilmoituksia, sillä tulet tekemään
paljon virheitä. Jopa minä teen näitä samoja virheitä. Tutkitaan ilmoitusta
rivi riviltä:

1. Tässä suoritimme päätteessä ``ex1.py`` -skriptin.
2. Python kertoo meille että tiedostossa ``ex1.py`` on virhe rivillä 3.
3. Virheellinen rivi tulostetaan.
4. Virheen kohdalle asetetaan ``^``-merkki *(caret)*.
   Huomaatko puuttuvan ``"``-merkin *(lainausmerkin)*?
5. Lopulta tulostuu "SyntaxError" eli syntaksivirhe, joka kertoo virheen
   luonteesta.  Yleensä nämä ovat hyvin arvoituksellisia. Kopioimalla tekstin
   hakukoneeseen löydät yleensä jonkun toisen jolla on ollut sama
   virhe. Tämä auttaa usein virheen selvittämisessä.


Lisätehtävä
===========

Harjoitusten ohessa on myös ``Lisätehtäviä``. Sinun olisi hyvä *yrittää* tehdä
myös lisätehtävät. Jos et onnistu, hyppää seuraavaan tehtävään ja palaa
myöhemmin niihin takaisin.

Kokeile lisätehtävänä seuraavia asioita:

1. Tulosta skriptilläsi yksi uusi rivi/lause.
2. Tulosta skriptilläsi vain yksi riveistä.
3. Lisää jonkin rivin alkuun '#'-merkki ('ristikkomerkki'). Mitä tapahtui? Selvitä mikä on
    merkin tarkoitus.

Jatkossa en selitä enempää harjoituksen luonteesta ellei se poikkea aiemmin nähdystä.


.. note::

    'Ristikkomerkkiä' kutsutaan myös 'risuaidaksi', 'ruuduksi' ja 'numeromerkiksi'.
    (Englanniksi 'pound', 'hash', 'number sign'). Valitse mieleisesi.