Lorsque vous débutez avec Python, vous allez passer beaucoup de temps avec le Shell Python. Tout au long de ce livre, vous verrez des exemples sous cette forme :

1. importez un des modules Python;
2. appelez une fonction de ce module ;
3. expliquez les résultats.

Si vous n'avez pas connaissance du répertoire courant, l'étape 1 échouera probablement avec un code d'erreur « ImportError ». Pourquoi ? Parce que Python va chercher le module exemple dans le dossier de recherche de modules , mais il ne le trouvera pas car le dossier `exemples` ne fait pas partie des répertoires du dossier de recherche. Pour surmonter ce problème, vous pouvez faire l'une des deux choses suivantes :

1. ajouter le répertoire « exemples » au dossier de recherche de modules ;
2. changer le répertoire courant pour celui du dossier « exemples ».

Le répertoire courant est une propriété invisible que Python garde en mémoire à tout instant. Il y a toujours un répertoire courant, que vous soyez dans le Shell Python, que vous fassiez tourner votre propre script Python en ligne de commande ou que vous fassiez tourner un script Python CGI (Common Gateway Interface) sur un serveur web quelque part.

Le module os dispose de deux fonctions pour travailler avec le répertoire courant.

python
>>> import os                                            
>>> print(os.getcwd())                                   
C:\Python31
>>> os.chdir('/Users/pilgrim/diveintopython3/exemples')  
>>> print(os.getcwd())                                   
C:\Users\pilgrim\diveintopython3\exemples
```

• ligne 2 : le module os de la bibliothèque standard de Python ; vous pouvez l'importer à n'importe quel moment, n'importe où ;
• ligne 3 : utilise la fonction os.getcwd() afin d'obtenir le répertoire courant. Lorsque vous lancez le Shell Python, le répertoire courant débute par le répertoire où se situe l'exécutable du Shell. Sur Windows, cela dépend de l'emplacement où vous avez installé Python ; le répertoire par défaut est ici `C:\Python31`. Si vous lancez le Shell Python en ligne de commande, le répertoire courant débute par le répertoire où vous étiez lorsque vous aviez lancé `python3` ;

• ligne 5 : utilise la fonction os.chdir() pour modifier le répertoire courant. Lorsque j'ai appelé la fonction os.chdir(), j'ai utilisé un chemin de type Linux (des slashs (/) et non des backslashs (\) et pas de lettre pour le disque) même si je suis sur Windows. C'est l’un des cas où Python essaie de masquer les écarts entre les différents systèmes d'exploitation.

Tant qu'à traiter du sujet des répertoires, je voudrais évoquer le module os.path. os.path contient des fonctions pour manipuler les noms de fichiers et de dossiers.

python
>>> import os
>>> print(os.path.join('/Users/pilgrim/diveintopython3/exemples/', 'humansize.py'))              
/Users/pilgrim/diveintopython3/exemples/humansize.py
>>> print(os.path.join('/Users/pilgrim/diveintopython3/exemples', 'humansize.py'))               
/Users/pilgrim/diveintopython3/exemples\humansize.py
>>> print(os.path.expanduser('~'))                                                              
c:\Users\pilgrim
>>> print(os.path.join(os.path.expanduser('~'), 'diveintopython3', 'exemples', 'humansize.py'))  
c:\Users\pilgrim\diveintopython3\exeples\humansize.py

• ligne 3 : la fonction os.path.join() construit un nom de chemin à partir d'un ou plusieurs chemins partiels. Dans le cas présent, il concatène simplement des chaînes de caractères ;
• ligne 5 : dans ce cas légèrement moins trivial, appeler la fonction os.path.join() ajoutera un slash supplémentaire au nom du chemin avant d'ajouter le nom du fichier. C'est un backslash (`\`) au lieu d'un slash (`/`), car j'ai construit cet exemple sur Windows. Si vous reproduisez cet exemple sur Linux ou Max OS X, vous obtiendrez un slash à la place. Ne vous embêtez pas avec les slashes, préférez l'utilisation de os.path.join() et laissez Python faire ce qu'il faut pour vous ;
• ligne 7 : la fonction os.path.expanduser() va étendre un nom du répertoire qui utilise « ~ » pour représenter le répertoire par défaut de l'utilisateur courant (NDT : répertoire home). Cela fonctionne sur n'importe quelle plate-forme où l'utilisateur possède un répertoire par défaut, incluant Linux, Mac OS X et Windows. Le chemin retourné ne possède pas de slash à la fin, mais cela n'a aucune importance pour os.path.join() ;
• ligne 9 : en combinant ces techniques, vous pouvez aisément construire des noms de chemin pour dossiers et fichiers dans le répertoire par défaut de l'utilisateur. La fonction os.path.join() peut prendre un nombre indéfini d'arguments. J'étais plus que ravi lorsque j'ai découvert cela, addSlashIfNecessary() est l’une de ces petites fonctions stupides que j'ai toujours besoin d'écrire quand je développe ma boite à outils dans un nouveau langage. *N'écrivez pas* cette fonction stupide en Python ; des gens intelligents ont déjà pris soin de le faire pour vous.

os.path contient également des fonctions pour diviser un chemin entier, des noms de dossiers et de fichiers, en leur constituants élémentaires.

```python
>>> pathname = '/Users/pilgrim/diveintopython3/exemples/humansize.py'
>>> os.path.split(pathname)                                        
('/Users/pilgrim/diveintopython3/exemples', 'humansize.py')
>>> (dirname, filename) = os.path.split(pathname)                  
>>> dirname                                                        
'/Users/pilgrim/diveintopython3/exemples'
>>> filename                                                       
'humansize.py'
>>> (shortname, extension) = os.path.splitext(filename)            
>>> shortname
'humansize'
>>> extension
'.py'

• ligne 1 : la fonction split() divise un nom de chemin entier et retourne un tuple contenant le chemin et le nom de fichier ;
• vous vous rappelez quand je disais que vous pouviez assigner plusieurs variables à la fois à la sortie d'une fonction ? La fonction os.path.split() fait exactement cela. Vous assignez la valeur de retour de la fonction split() dans un tuple de deux variables. Chaque variable reçoit la valeur correspondant à l'élément du tuple renvoyé ;
• ligne 5 : la première variable, dirname, reçoit la valeur du premier élément du tuple retourné par os.path.split(), le chemin du fichier ;
• la seconde variable, filename, reçoit la valeur du second élément du tuple retourné par os.path.split(), le nom du fichier ;
• ligne 10 : os.path comprend la fonction os.path.splitext(), qui découpe un nom de fichier et retourne un tuple contenant le nom du fichier et son extension. Vous pouvez utiliser la même technique pour les assigner à des variables séparées.

Le module glob est un autre outil de la bibliothèque standard de Python. C'est un moyen facile de récupérer le contenu d'un répertoire d'un point de vue programmation et il utilise le type de caractères de remplacement dont vous êtes peut-être déjà familier si vous travaillez en ligne de commande.

python
>>> os.chdir('/Users/pilgrim/diveintopython3/')
>>> import glob
>>> glob.glob('exemples/*.xml')                  
['exemples\\feed-broken.xml',
 'exemples\\feed-ns0.xml',
 'exemples\\feed.xml']
>>> os.chdir('exemples/')                        
>>> glob.glob('*test*.py')                       
['alphameticstest.py',
 'pluraltest1.py',
 'pluraltest2.py',
 'pluraltest3.py',
 'pluraltest4.py',
 'pluraltest5.py',
 'pluraltest6.py',
 'romantest1.py',
 'romantest10.py',
 'romantest2.py',
 'romantest3.py',
 'romantest4.py',
 'romantest5.py',
 'romantest6.py',
 'romantest7.py',
 'romantest8.py',
 'romantest9.py']

• ligne 4 : le module glob prend un caractère de remplacement et retourne le chemin de tous les fichiers et répertoires correspondants. Dans cet exemple, le caractère de remplacement est le chemin d'un répertoire plus « '*.xml », ce qui correspondra à tous les fichiers ayant l'extension « .xml » dans le sous-répertoire « exemples » ;
• ligne 8 : remplace maintenant le répertoire courant par le répertoire « exemples ». La fonction os.chdir() peut prendre des noms de chemins relatifs ;
• ligne 9 : vous pouvez inclure plusieurs caractères de remplacement pour votre motif de recherche (NDT: « search pattern » en anglais). Cet exemple trouve tous les fichiers dans le répertoire courant qui finissent par l'extension « .py » et qui contiennent le mot `test` n'importe où dans leur nom.

Tous les systèmes de fichiers modernes gardent en mémoire les métadonnées de chaque fichier : date de création, date de dernière modification, taille, etc. Python fourni une API unique pour accéder à ces données. Vous n'avez pas besoin d'ouvrir le fichier ; tout ce dont vous avez besoin est son nom.

```python
>>> import os
>>> print(os.getcwd())                 
c:\Users\pilgrim\diveintopython3\exemples
>>> metadata = os.stat('feed.xml')     
>>> metadata.st_mtime                  
1247520344.9537716
>>> import time                        
>>> time.localtime(metadata.st_mtime)  
time.struct_time(tm_year=2009, tm_mon=7, tm_mday=13, tm_hour=17,
  tm_min=25, tm_sec=44, tm_wday=0, tm_yday=194, tm_isdst=1)

• ligne 3 : le répertoire courant est le dossier « exemples » ;
• ligne 5 : « `feed.xml » est un fichier du dossier « exemples ». Appeler la fonction os.stat() renvoie un objet qui contient plusieurs types différents de métadonnées à propos du fichier ;
• ligne 6 : st_mtime est la date de modification, mais dans un format qui n'est pas très utile. (Techniquement, c'est le nombre de secondes depuis « l'époque » (NDT: « Epoch time »), qui est définie comme la première seconde du 1er Janvier 1970. ) ;
• ligne 8 : le module time fait partie de la bibliothèque standard. Il contient des fonctions pour convertir différentes représentations temporelles, pour formater des valeurs temporelles en chaînes de caractères et gérer les fuseaux horaires ;
• ligne 9 : la fonction time.localtime() convertit la valeur temporelle des secondes depuis « l'époque » (à partir de l'attribut st_mtime retourné par la fonction os.stat()) dans une forme plus utile en années, mois, jours, heures, minutes, secondes, etc. Ce fichier a été modifié la dernière fois le 13 Juillet 2009, aux environs de 17h25 ;

```python
# suite de l'exemple précédent
>>> metadata.st_size                              
3070
>>> import humansize
>>> humansize.approximate_size(metadata.st_size)  
'3.0 KiB'
```

• ligne 3 : la fonction os.stat() retourne également la taille du fichier, grâce à l'attribut st_size. Le fichier « feed.xml » fait 3070 octets ;
• ligne 6: vous pouvez passer l'attribut st_size à la fonction approximate_size().

Dans les précédentes sectionsRécupérer les métadonnées d'un fichier, la fonction glob.glob() retournait une liste de chemins relatifs. Le premier exemple avait un chemin similaire à exemples\feed.xml et le second exemple avait un chemin relatif encore plus court comme romantest.py. Aussi longtemps que vous resterez dans le même répertoire courant, ces chemins relatifs fonctionneront pour ouvrir des fichiers et récupérer leurs métadonnées. Mais si vous souhaitez construire un chemin absolu, c'est-à-dire un chemin qui inclut tout le chemin du répertoire jusqu'à sa racine ou le nom du disque, alors vous aurez besoin de la fonction os.path.realpath().

python
>>> import os
>>> print(os.getcwd())
c:\Users\pilgrim\diveintopython3\exemples
>>> print(os.path.realpath('feed.xml'))
c:\Users\pilgrim\diveintopython3\exemples\feed.xml

Voici une astuce avec les compréhensions de dictionnaires pouvant s'avérer utile : interchanger les clefs et valeurs d'un dictionnaire.

python
>>> a_dict = {'a': 1, 'b': 2, 'c': 3}
>>> {value:key for key, value in a_dict.items()}
{1: 'a', 2: 'b', 3: 'c'}

Bien entendu, cela ne fonctionne que si les valeurs du dictionnaire sont non mutables, comme les chaînes de caractères ou les tuples. Si vous souhaitez essayer ceci avec un dictionnaire qui contient des listes, cela échouera superbement :

python
>>> a_dict = {'a': [1, 2, 3], 'b': 4, 'c': 5}
>>> {value:key for key, value in a_dict.items()}
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 1, in <dictcomp>
TypeError: unhashable type: 'list'