Fonction chmod - module os

Signature de la fonction chmod

 def chmod(path: str | bytes | os.PathLike, mode: int, *, dir_fd=None, follow_symlinks=True) -> None

Description

 1 

os.chmod("filename", 0o755)   # -rwxr-xr-x

 1 
 2 

rights = S_IRUSR | S_IWUSR | S_IXUSR | S_IRGRP | S_IXGRP | IROTH | IXOTH
os.chmod("filename", rights)   # -rwxr-xr-x

chmod("./file", 0o755)

fd = os.open("./parentFolder", os.O_RDONLY) 
chmod("file", 0x755, dir_fd=fd)

if os.chmod in os.supports_dir_fd:
    fd = os.open("./parentFolder", os.O_RDONLY) 
    chmod("file", 0x755, dir_fd=fd)

help(os.chmod)

Change the access permissions of a file.

  path
    Path to be modified.  May always be specified as a str, bytes, or a path-like object.
    On some platforms, path may also be specified as an open file descriptor.
    If this functionality is unavailable, using it raises an exception.
  mode
    Operating-system mode bitfield.
  dir_fd
    If not None, it should be a file descriptor open to a directory,
    and path should be relative; path will then be relative to that
    directory.
  follow_symlinks
    If False, and the last element of the path is a symbolic link,
    chmod will modify the symbolic link itself instead of the file
    the link points to.

It is an error to use dir_fd or follow_symlinks when specifying path as
  an open file descriptor.
dir_fd and follow_symlinks may not be implemented on your platform.
  If they are unavailable, using them will raise a NotImplementedError.

Paramètres

 path : str | bytes | os.PathLike 

 mode : int 

 dir_df : int = None 

 follow_symlinks : bool = True 

Valeur de retour

Cette méthode ne renvoie aucune valeur.

Exceptions

•  FileNotFoundError :

  Une exception de ce type sera déclenchée si le chemin spécifié n'existe pas.

•  NotADirectoryError :

  Une exception de ce type sera déclenchée si un des éléments parents du chemin n'est pas un un dossier (ou un lien symbolique, si follow_symlinks est fixé à True).

•  NotImplementedError :

  Une exception de ce type sera déclenchée si vous utiliser une variante non implémentée de la fonction chmod sur votre système d'exploitation (par exemple, si vous utiliser le paramètre dir_df sur un système Windows).

•  PermissionError :

  Une exception de ce type sera déclenchée si vous n'avez pas les droits d'accès au fichier.

Exemple(s) de code

 1 
 2 
 3 
 4 
 5 
 6 
 7 
 8 
 9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 
 18 
 19 
 20 
 21 
 22 
 23 
 24 
 25 
 26 
 27 
 28 
 29 
 30 

import os
import sys

path = "demo.txt"

# On créer un fichier de démonstration.
try:
    with open(path, "w") as the_file:
        print("Ok", file=the_file)
except IOError:
    print("Impossible de créer le fichier de démonstration", file=sys.stderr)
    exit(-1)

# On change à plusieurs reprises les droits d'accès et on les affiche.
try:
    os.chmod(path, 0o600)
    os.system(f"ls -l {path}")

    os.chmod(path, 0o640)
    os.system(f"ls -l {path}")

    os.chmod(path, 0o644)
    os.system(f"ls -l {path}")

    os.chmod(path, 0o755)
    os.system(f"ls -l {path}")
except PermissionError:
    print("Tu n'as pas les autorisations nécessaires", file=sys.stderr)
except OSError:
    print("Ca ne marche pas et je ne t'en dirais pas plus ;-)", file=sys.stderr)

$> python sample.py
-rw-------. 1 dominique dominique 3  5 janv. 10:13 demo.txt
-rw-r-----. 1 dominique dominique 3  5 janv. 10:13 demo.txt
-rw-r--r--. 1 dominique dominique 3  5 janv. 10:13 demo.txt
-rwxr-xr-x. 1 dominique dominique 3  5 janv. 10:13 demo.txt
$> 

Voir aussi

Le tutoriel Python complet (Text+Vidéos)
Le tutoriel Python en vidéos

Evaluez vos compétences en Python