.. module:: metadades

Metadades
---------

Un *fitxer amb metadades* està estructurat en tres parts consecutives:
metadades, capçalera i dades. El fitxer :download:`consum_elect.txt`
n'és un exemple:

.. literalinclude:: consum_elect.txt
   :language: none

En aquest exemple, les tres primeres línies contenen les metadades, la
quarta, la capçalera i la resta, les dades.

En general, les línies que contenen metadades comencen amb el caràcter
dos punts (``:``), seguit del nom de la metadada, uns altres dos punts
i el valor de la metadada. La capçalera és la primera línia que no
comença per dos punts. Les dades són la resta de línies que van després de
la capçalera.

Com veiem a la segona línia de l'exemple anterior, poden haver-hi
espais en blanc en qualsevol posició d'una línia amb metadades i el
valor de la metadada pot contenir dos punts.

Dissenya la funció següent i desa-la al mòdul :mod:`metadades` (fitxer
:file:`metadades.py`).

.. function:: extreu_metadades(nom_fitxer)

   Extreu les metadades del *fitxer amb metadades*

   :param str nom_fitxer: nom del *fitxer amb metadades*
   :rtype: dict
   :return: diccionari en què les claus són els noms de les metadades
            del fitxer `nom_fitxer` i els valors són els valors de les
            metadades.

	    Les claus i els valors del diccionari no han de tenir
	    espais en blanc al començament ni al final.

   Per exemple:

   .. literalinclude:: test-extreu_metadades.txt
      :language: pycon
      :start-after: ---- inici
      :end-before: ---- fi
   
   Disposes de més tests al fitxer :download:`test-extreu_metadades.txt`.