2.27. Citire și scriere#

Fișierele se află pe disc; Python le accesează prin open(), care returnează un obiect fișier ale cărui metode citesc și scriu octeții subiacenți.

2.27.1. open și modurile#

Primul argument este calea; al doilea este modul – un șir scurt care îi spune lui Python cum va fi folosit fișierul:

"r" – citire (implicit). Deschide un fișier existent pentru citire.
"w" – scriere. Creează un fișier nou sau trunchiază unul existent până la zero.
"a" – adăugare. Deschide un fișier pentru scriere la sfârșitul său, fără a-l trunchia.
"b" adăugat la oricare dintre cele de mai sus ("rb", "wb", "ab") – mod binar. Conținutul fișierului este de tip bytes în loc de str.

f = open("notes.txt", "r")
text = f.read()
f.close()

2.27.2. Folosește un gestionar de context#

Tiparul de mai sus pierde descriptorul fișierului dacă orice între open() și close generează o excepție. Soluția este instrucțiunea with (vezi gestionare de context):

with open("notes.txt") as f:
    text = f.read()

# f is closed here, even if read() failed

Aceasta este forma standard – scrie-o așa de fiecare dată.

2.27.3. Citire#

Obiectele fișier suportă mai multe stiluri de citire:

io.IOBase.read() – citește întregul fișier (sau N octeți) și îl returnează ca un singur șir (sau obiect bytes).
io.IOBase.readline() – citește o linie, inclusiv caracterul final "\n".
Iterarea directă a fișierului produce liniile una câte una, cu un consum de memorie mult mai mic decât citirea întregului fișier dintr-o dată.

with open("log.txt") as f:
    for line in f:
        print(line.rstrip())

str.rstrip() elimină caracterul de linie nouă final înainte de afișare, astfel încât rezultatul să nu fie distanțat dublu.

2.27.4. Scriere#

Deschide fișierul în modul "w" și folosește io.IOBase.write():

with open("out.txt", "w") as f:
    f.write("hello\n")
    f.write("world\n")

io.IOBase.write() nu adaugă un caracter de linie nouă – scrie exact octeții (sau caracterele, în modul text) pe care i-i dai.

2.27.5. Text vs. binar#

Modul text (implicit, "r" / "w" fără "b") decodifică octeții primiți în str folosind o codificare implicită și codifică str trimis înapoi în octeți. Folosește-l pentru configurare, jurnale, JSON – orice este text.

Modul binar ("rb" / "wb") sare peste etapa de decodificare și returnează bytes. Folosește-l pentru imagini, înregistrări împachetate cu struct, capturi de rețea – orice unde fiecare octet contează și fișierul nu este lizibil de către om.

2.27.6. Listarea și ștergerea fișierelor#

Modulul os expune operațiile cu sistemul de fișiere care nu se află pe obiectul fișier în sine:

os.listdir() – returnează o listă de nume dintr-un director.
os.remove() – șterge un fișier.
os.rename() – redenumește un fișier.
os.stat() – metadate ale fișierului (dimensiune, oră de modificare, …).
os.mkdir() – creează un director nou.

import os

for name in os.listdir("/"):
    print(name)

Capturează OSError în jurul acestora atunci când fișierul sau directorul ar putea să nu existe – operația este unul dintre locurile frecvente unde apar excepții în scripturile reale.