==============
Anem per feina
==============

Preparar la sessió i treballar amb IDLE
---------------------------------------

Recomanem preparar la sessió de treball al laboratori com segueix:

#. Arrenqueu l'ordinador amb la imatge GNU_/Linux_.

#. Inicieu la sessió_ amb el vostre `nom d'usuari i contrasenya`_.

#. Un cop iniciada la sessió obriu una `finestra de terminal`_. En
   aquesta finestra s'executa un `intèrpret d'ordres del sistema
   operatiu`_.

#. Creeu un directori de treball per aquesta sessió.

   Per exemple, per crear un directori de treball per la primera
   sessió (``s1``) de l'assignatura Informàtica (``inf1``) dins de
   directori ``data``, podeu executar l'ordre següent a l'intèrpret
   d'ordres:

   .. code-block:: bash

      mkdir -p data/inf1/s1

#. Feu-lo `directori de treball`_.

   Seguint l'exemple anterior, amb l'ordre:

   .. code-block:: bash

      cd data/inf1/s1

#. Engegueu idle_ des del directori de treball.

   Executeu a l'intèrpret d'ordres:

   .. code-block:: bash

      idle &

   El símbol et (``&``) al final de la línia fa que l'intèrpret
   d'ordres continuï en comptes d'esperar que acabi l'execució
   d'``idle``.

#. Deseu tots els fitxers amb què treballeu en el directori de
   treball, tant si són mòduls de Python (``.py``), com jocs de proves
   (``.txt``) o fitxers de dades (``.txt``, ``.csv``...)

Si tanqueu ``idle`` accidentalment, torneu-lo a obrir des de
l'intèrpret d'ordres com en el punt 6.

Si tanqueu la finestra de terminal accidentalment, torneu a repetir
els passos 3 i 5.


Doctest a la línia de comandes del terminal
--------------------------------------------

Per passar el joc de proves :file:`joc-de-proves.txt` des de
l'intèrpret d'ordres:

#. Assegureu-vos que el fitxer :file:`joc-de-proves.txt` està al
   directori de treball fent:

   .. code-block:: bash

      ls

#. Executeu el mòdul :py:mod:`doctest` com segueix:

   .. code-block:: bash

      python3 -m doctest joc-de-proves.txt -f -v

   L'execució del joc de proves s'aturarà en el primer error que es
   produeixi.

   Alternativament, si voleu veure tots els tests que executa el mòdul doctest,
   feu el següent:

   .. code-block:: bash

      python3 -m doctest joc-de-proves.txt -v | less

   El paginador :command:`less` recull la sortida de :py:mod:`doctest`
   i la presenta pantalla a pantalla. Podeu desplaçar-vos amunt i
   avall amb les tecles de cursor, pàgina amunt i avall, i inici i
   final. Per acabar d'executar :command:`less` cal prémer
   :command:`q`.

   .. warning:: Sempre cal corregir el primer error i tornar a passar
		el joc de proves. L'opció ``-f``, o bé el
		paginador :command:`less` ajuden a localitzar el
		primer error.

.. _GNU: https://ca.wikipedia.org/wiki/GNU
.. _Linux: https://ca.wikipedia.org/wiki/Linux
.. _sessió: https://en.wikipedia.org/wiki/Login_session
.. _nom d'usuari i contrasenya: https://etseib.upc.edu/ca/futurs-estudiants/guia_acollida_2018_2019.pdf
.. _finestra de terminal: https://ca.wikipedia.org/wiki/GNOME_Terminal
.. _intèrpret d'ordres del sistema operatiu: https://ca.wikipedia.org/wiki/L%C3%ADnia_d%27ordres
.. _directori de treball: https://en.wikipedia.org/wiki/Working_directory
.. _idle: https://ca.wikipedia.org/wiki/IDLE_(Python)