DESCRIPTION.

Modifie ou définit les options à appliquer à un fichier ou à un répertoire.

SYNTAXE.

os.chflags ( chemin , options , symbolique )

os.chflags ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

chemin ⇨ emplacement de l'entité [ OBLIGATOIRE ]

options ⇨ options à associer [ OBLIGATOIRE ]

symbolique ⇨ liens symboliques [ optionnel ]

REMARQUES.

chemin doit être un str ( ) identifiant de façon absolue ou relative un chemin d'un répertoire ou d'un fichier.

options doit être l'une des valeurs suivantes, provenant du module de la bibliothèque standard stat, ou une combinaison d'eux séparés par l'opérateur or, ou le symbole | : 

- stat.SF_APPEND,  le fichier ne peut être qu'annexer ;

- stat.SF_ARCHIVED, le fichier peut être archivé ; 

- stat.SF_IMMUTABLE, les fichier ne pourra pas être modifier ; 

- stat.SF_NOUNLINK, le fichier ne pourra pas être détruit ou renommé ;

- stat.SF_SNAPSHOT, il s'agit d'un fichier instantané ;

- stat.UF_APPEND, le fichier ne peut être qu'annexer ;

- stat.UF_COMPRESSED, le fichier sera comprssé pour être stocké, sur MacOs uniquement ;

- stat.UF_HIDDEN, le fichier ne pourra pas être affiché dans une interface graphique, sur MacOs uniquement ;

- stat.UF_IMMUTABLE, le fichier ne pourra pas être modifié ;

- stat.UF_NODUMP, ne pas vider le fichier ;

- stat.UF_NOUNLINK, le fichier ne pourra pas être détruit ou renommé ;

- stat.UF_OPAQUE, le répertoire est opaque lorsqu'il est visualisé à travers une pile d'union.

symbolique est un attribut nommé par follow_symlinks = valeur, où valeur doit être un bool ( ) symbolique n'est disponible que pour UNIX et la plupart des Linux. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. Si valeur vaut :

- True, valeur par défaut, os.chflags ( ) opère sur le fichier pointé par chemin ; 

- False, et que le dernier élément du chemin est un lien symbolique, os.chflags ( ) teste le lien symbolique et non le fichier.

La méthode os.chflags ( ) n'est disponible que pour UNIX et la plupart des Linux. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. 

EXEMPLE.

import os

import stat

kfichier = "/home/login/Documents/votre fichier.txt" # indiquez un fichier valide pour votre machine

os.chflags ( kfichier , stat.SF_IMMUTABLE or stat.SF_NOUNLINK )