פיתון כתוב לקובץ - הסבירו פונקציות לפתיחה, קריאה, הוספה וטיפול אחר בקבצים

ברוך הבא

היי! אם אתה רוצה ללמוד כיצד לעבוד עם קבצים ב- Python, מאמר זה הוא בשבילך. עבודה עם קבצים היא מיומנות חשובה שכל מפתח פיתון צריך ללמוד, אז בואו נתחיל.

במאמר זה תוכלו ללמוד:

• כיצד לפתוח קובץ.
• כיצד לקרוא קובץ.
• כיצד ליצור קובץ.
• כיצד לשנות קובץ.
• כיצד לסגור קובץ.
• כיצד לפתוח קבצים למספר פעולות.
• כיצד לעבוד עם שיטות אובייקט קובץ.
• כיצד למחוק קבצים.
• כיצד לעבוד עם מנהלי הקשר ולמה הם שימושיים.
• כיצד לטפל בחריגים שעלולים להעלות כאשר אתה עובד עם קבצים.
• ועוד!

בואו נתחיל! ✨

? עבודה עם קבצים: תחביר בסיסי

אחד התפקידים החשובים ביותר שאתה תצטרך להשתמש תוך כדי עבודה עם קבצים ב Python הוא open(), מובנה פונקציה כי יפתח קובץ ומאפשר התוכנית שלך כדי להשתמש בו ולעבוד איתו.

זהו התחביר הבסיסי :

טיפ: אלה שני הארגומנטים הנפוצים ביותר לכינוי פונקציה זו. ישנם שישה טיעונים אופציונליים נוספים. למידע נוסף עליהם, קרא מאמר זה בתיעוד.

פרמטר ראשון: קובץ

הפרמטר הראשון של open()הפונקציה הוא fileהנתיב המוחלט או היחסי לקובץ שאתה מנסה לעבוד איתו.

בדרך כלל אנו משתמשים בנתיב יחסי, המציין היכן נמצא הקובץ ביחס למיקום הסקריפט (קובץ פייתון) הקורא open()לפונקציה.

לדוגמה, הנתיב בפונקציה זו קורא:

open("names.txt") # The relative path is "names.txt"

מכיל רק את שם הקובץ. ניתן להשתמש בזה כאשר הקובץ שאתה מנסה לפתוח נמצא באותה ספריה או תיקיה כמו סקריפט Python, כך:

אבל אם הקובץ נמצא בתיקיה מקוננת, כך:

אז אנחנו צריכים להשתמש בנתיב ספציפי כדי לספר לפונקציה שהקובץ נמצא בתוך תיקיה אחרת.

בדוגמה זו זה יהיה הדרך:

open("data/names.txt")

שימו לב שאנחנו כותבים data/תחילה (שם התיקיה ואחריו a /) ואז names.txt(שם הקובץ עם הסיומת).

? טיפ: שלוש האותיות .txtהעוקבות אחר הנקודה פנימה names.txtהיא "סיומת" הקובץ, או סוגו. במקרה זה, .txtמציין שמדובר בקובץ טקסט.

פרמטר שני: מצב

הפרמטר השני של open()הפונקציה הוא mode, מחרוזת עם תו אחד. התו היחיד הזה בעצם אומר לפייתון מה אתה מתכנן לעשות עם הקובץ בתוכנית שלך.

המצבים הזמינים הם:

• קרא ( "r").
• הוסף ( "a")
• כתוב ( "w")
• צור ( "x")

אתה יכול גם לבחור לפתוח את הקובץ ב:

• מצב טקסט ( "t")
• מצב בינארי ( "b")

כדי להשתמש בטקסט או במצב בינארי, יהיה עליך להוסיף תווים אלה למצב הראשי. לדוגמא: "wb"פירושו לכתוב במצב בינארי.

? טיפ: מצבי מחדל נקראים ( "r") וטקסט ( "t"), שפירושו "פתוח לקריאה בטקסט" ( "rt"), אז אתה לא צריך לציין אותם open()אם אתה רוצה להשתמש בהם כי הם מוקצים כברירת מחדל. אתה יכול פשוט לכתוב open().

מדוע מצבים?

זה באמת הגיוני ש- Python יעניק רק הרשאות מסוימות על סמך מה שאתה מתכנן לעשות עם הקובץ, נכון? מדוע Python צריך לאפשר לתוכנית שלך לעשות יותר ממה שצריך? זו בעצם הסיבה שקיימים מצבים.

חשוב על זה - לאפשר לתוכנית לעשות יותר ממה שצריך יכול להיות בעייתי. לדוגמה, אם אתה רק צריך לקרוא את תוכן הקובץ, זה יכול להיות מסוכן לאפשר לתוכנית שלך לשנות אותו באופן בלתי צפוי, מה שעלול להכניס באגים.

To כיצד לקרוא קובץ

עכשיו שאתה יודע יותר על הטיעונים open()שהפונקציה לוקחת, בוא נראה איך אתה יכול לפתוח קובץ ולאחסן אותו במשתנה כדי להשתמש בו בתוכנית שלך.

זהו התחביר הבסיסי:

אנו פשוט מקצים את הערך המוחזר למשתנה. לדוגמה:

names_file = open("data/names.txt", "r")

אני יודע שאולי אתה שואל: איזה סוג ערך מחזיר open()?

ובכן, אובייקט קובץ .

בואו נדבר עליהם קצת.

חפצי קובץ

על פי תיעוד הפייתון, אובייקט קובץ הוא:

אובייקט החושף ממשק API מונחה קבצים (בשיטות כגון read () או כתיבה ()) למשאב בסיסי.

זה בעצם אומר לנו שאובייקט קובץ הוא אובייקט שמאפשר לנו לעבוד ולקיים אינטראקציה עם קבצים קיימים בתוכנית Python שלנו.

לאובייקטים של קבצים יש מאפיינים, כגון:

• name: the name of the file.
• closed: True if the file is closed. False otherwise.
• mode: the mode used to open the file.

For example:

f = open("data/names.txt", "a") print(f.mode) # Output: "a"

Now let's see how you can access the content of a file through a file object.

Methods to Read a File

For us to be able to work file objects, we need to have a way to "interact" with them in our program and that is exactly what methods do. Let's see some of them.

Read()

The first method that you need to learn about is read(),which returns the entire content of the file as a string.

Here we have an example:

f = open("data/names.txt") print(f.read())

The output is:

Nora Gino Timmy William

You can use the type() function to confirm that the value returned by f.read() is a string:

print(type(f.read())) # Output 

Yes, it's a string!

In this case, the entire file was printed because we did not specify a maximum number of bytes, but we can do this as well.

Here we have an example:

f = open("data/names.txt") print(f.read(3))

The value returned is limited to this number of bytes:

Nor

❗️Important: You need to close a file after the task has been completed to free the resources associated to the file. To do this, you need to call the close() method, like this:

Readline() vs. Readlines()

You can read a file line by line with these two methods. They are slightly different, so let's see them in detail.

readline() reads one line of the file until it reaches the end of that line. A trailing newline character (\n) is kept in the string.

? Tip: Optionally, you can pass the size, the maximum number of characters that you want to include in the resulting string.

For example:

f = open("data/names.txt") print(f.readline()) f.close()

The output is:

Nora 

This is the first line of the file.

In contrast, readlines() returns a list with all the lines of the file as individual elements (strings). This is the syntax:

For example:

f = open("data/names.txt") print(f.readlines()) f.close()

The output is:

['Nora\n', 'Gino\n', 'Timmy\n', 'William']

Notice that there is a \n (newline character) at the end of each string, except the last one.

? Tip: You can get the same list with list(f).

You can work with this list in your program by assigning it to a variable or using it in a loop:

f = open("data/names.txt") for line in f.readlines(): # Do something with each line f.close()

We can also iterate over f directly (the file object) in a loop:

f = open("data/names.txt", "r") for line in f: # Do something with each line f.close()

Those are the main methods used to read file objects. Now let's see how you can create files.

? כיצד ליצור קובץ

אם אתה צריך ליצור קובץ "באופן דינמי" באמצעות Python, אתה יכול לעשות את זה עם "x"המצב.

בואו נראה איך. זהו התחביר הבסיסי:

הנה דוגמה. זוהי ספריית העבודה הנוכחית שלי:

אם אני מריץ את שורת הקוד הזו:

f = open("new_file.txt", "x")

נוצר קובץ חדש בשם זה:

במצב זה תוכלו ליצור קובץ ואז לכתוב אליו באופן דינמי באמצעות שיטות שתלמדו תוך כמה רגעים בלבד.

? טיפ: הקובץ יהיה בתחילה ריק עד שתשנה אותו.

דבר מוזר הוא שאם תנסה להריץ את השורה הזו וקובץ בשם זה כבר קיים, תראה את השגיאה הזו:

Traceback (most recent call last): File "", line 8, in  f = open("new_file.txt", "x") FileExistsError: [Errno 17] File exists: 'new_file.txt'

על פי תיעוד Python, חריג זה (שגיאת זמן ריצה) הוא:

הועלה בעת ניסיון ליצור קובץ או ספריה שכבר קיימים.

Now that you know how to create a file, let's see how you can modify it.

? How to Modify a File

To modify (write to) a file, you need to use the write() method. You have two ways to do it (append or write) based on the mode that you choose to open it with. Let's see them in detail.

Append

"Appending" means adding something to the end of another thing. The "a" mode allows you to open a file to append some content to it.

For example, if we have this file:

And we want to add a new line to it, we can open it using the "a" mode (append) and then, call the write() method, passing the content that we want to append as argument.

This is the basic syntax to call the write()method:

Here's an example:

f = open("data/names.txt", "a") f.write("\nNew Line") f.close()

? Tip: Notice that I'm adding \n before the line to indicate that I want the new line to appear as a separate line, not as a continuation of the existing line.

This is the file now, after running the script:

? Tip: The new line might not be displayed in the file untilf.close() runs.

Write

Sometimes, you may want to delete the content of a file and replace it entirely with new content. You can do this with the write() method if you open the file with the "w" mode.

Here we have this text file:

If I run this script:

f = open("data/names.txt", "w") f.write("New Content") f.close() 

This is the result:

As you can see, opening a file with the "w" mode and then writing to it replaces the existing content.

? Tip: The write() method returns the number of characters written.

If you want to write several lines at once, you can use the writelines() method, which takes a list of strings. Each string represents a line to be added to the file.

Here's an example. This is the initial file:

If we run this script:

f = open("data/names.txt", "a") f.writelines(["\nline1", "\nline2", "\nline3"]) f.close()

The lines are added to the end of the file:

Open File For Multiple Operations

Now you know how to create, read, and write to a file, but what if you want to do more than one thing in the same program? Let's see what happens if we try to do this with the modes that you have learned so far:

If you open a file in "r" mode (read), and then try to write to it:

f = open("data/names.txt") f.write("New Content") # Trying to write f.close()

You will get this error:

Traceback (most recent call last): File "", line 9, in  f.write("New Content") io.UnsupportedOperation: not writable

Similarly, if you open a file in "w" mode (write), and then try to read it:

f = open("data/names.txt", "w") print(f.readlines()) # Trying to read f.write("New Content") f.close()

You will see this error:

Traceback (most recent call last): File "", line 14, in  print(f.readlines()) io.UnsupportedOperation: not readable

The same will occur with the "a" (append) mode.

How can we solve this? To be able to read a file and perform another operation in the same program, you need to add the "+" symbol to the mode, like this:

f = open("data/names.txt", "w+") # Read + Write

f = open("data/names.txt", "a+") # Read + Append

f = open("data/names.txt", "r+") # Read + Write

Very useful, right? This is probably what you will use in your programs, but be sure to include only the modes that you need to avoid potential bugs.

Sometimes files are no longer needed. Let's see how you can delete files using Python.

? How to Delete Files

To remove a file using Python, you need to import a module called os which contains functions that interact with your operating system.

? Tip: A module is a Python file with related variables, functions, and classes.

Particularly, you need the remove()function. This function takes the path to the file as argument and deletes the file automatically.

Let's see an example. We want to remove the file called sample_file.txt.

To do it, we write this code:

import os os.remove("sample_file.txt")

• The first line: import os is called an "import statement". This statement is written at the top of your file and it gives you access to the functions defined in the os module.
• The second line: os.remove("sample_file.txt") removes the file specified.

? Tip: you can use an absolute or a relative path.

Now that you know how to delete files, let's see an interesting tool... Context Managers!

? Meet Context Managers

Context Managers are Python constructs that will make your life much easier. By using them, you don't need to remember to close a file at the end of your program and you have access to the file in the particular part of the program that you choose.

Syntax

This is an example of a context manager used to work with files:

? Tip: The body of the context manager has to be indented, just like we indent loops, functions, and classes. If the code is not indented, it will not be considered part of the context manager.

When the body of the context manager has been completed, the file closes automatically.

with open("", "") as : # Working with the file... # The file is closed here!

Example

Here's an example:

with open("data/names.txt", "r+") as f: print(f.readlines()) 

This context manager opens the names.txt file for read/write operations and assigns that file object to the variable f. This variable is used in the body of the context manager to refer to the file object.

Trying to Read it Again

After the body has been completed, the file is automatically closed, so it can't be read without opening it again. But wait! We have a line that tries to read it again, right here below:

with open("data/names.txt", "r+") as f: print(f.readlines()) print(f.readlines()) # Trying to read the file again, outside of the context manager

בוא נראה מה קורה:

Traceback (most recent call last): File "", line 21, in  print(f.readlines()) ValueError: I/O operation on closed file.

שגיאה זו נזרקת מכיוון שאנו מנסים לקרוא קובץ סגור. מדהים, נכון? מנהל ההקשר עושה את כל העבודה הכבדה עבורנו, הוא קריא ותמציתי.

? כיצד לטפל בחריגים בעבודה עם קבצים

כשאתה עובד עם קבצים, עלולות להתרחש שגיאות. לפעמים ייתכן שלא תהיה לך ההרשאות הדרושות לשינוי או גישה לקובץ, או שקובץ אפילו לא קיים.

כמתכנת, עליכם לחזות בנסיבות אלה ולטפל בהן בתכנית שלכם כדי למנוע קריסות פתאומיות שבהחלט יכולות להשפיע על חווית המשתמש.

בואו נראה כמה מן החריגים הנפוצים ביותר (שגיאות זמן ריצה) שעשויים למצוא כשאתם עובדים עם קבצים:

FileNotFoundError

על פי תיעוד הפייתון, חריג זה הוא:

הועלה כאשר מתבקש קובץ או ספריה אך אינם קיימים.

For example, if the file that you're trying to open doesn't exist in your current working directory:

f = open("names.txt")

You will see this error:

Traceback (most recent call last): File "", line 8, in  f = open("names.txt") FileNotFoundError: [Errno 2] No such file or directory: 'names.txt'

Let's break this error down this line by line:

• File "", line 8, in . This line tells you that the error was raised when the code on the file located in was running. Specifically, when line 8 was executed in .
• f = open("names.txt"). This is the line that caused the error.
• FileNotFoundError: [Errno 2] No such file or directory: 'names.txt' . This line says that a FileNotFoundError exception was raised because the file or directory names.txt doesn't exist.

? Tip: Python is very descriptive with the error messages, right? This is a huge advantage during the process of debugging.

PermissionError

This is another common exception when working with files. According to the Python Documentation, this exception is:

הועלה כאשר מנסים להפעיל פעולה ללא זכויות גישה נאותות - למשל הרשאות מערכת קבצים.

חריג זה מוגדר כאשר אתה מנסה לקרוא או לשנות קובץ שאין לו הרשאת גישה. אם תנסה לעשות זאת, תראה שגיאה זו:

Traceback (most recent call last): File "", line 8, in  f = open("") PermissionError: [Errno 13] Permission denied: 'data'

IsADirectoryError

על פי תיעוד הפייתון, חריג זה הוא:

הועלה כאשר מבקשים פעולת קבצים בספריה.

חריג מסוים זה עולה כאשר אתה מנסה לפתוח או לעבוד על ספריה במקום על קובץ, אז היזהר באמת עם הנתיב שאתה עובר כוויכוח.

כיצד לטפל בחריגים

כדי להתמודד עם חריגים אלה, אתה יכול להשתמש במשפט try / except . עם הצהרה זו תוכלו "לספר" לתוכנית שלכם מה לעשות במקרה שקורה משהו לא צפוי.

זהו התחביר הבסיסי:

try: # Try to run this code except : # If an exception of this type is raised, stop the process and jump to this block 

Here you can see an example with FileNotFoundError:

try: f = open("names.txt") except FileNotFoundError: print("The file doesn't exist")

This basically says:

• Try to open the file names.txt.
• If a FileNotFoundError is thrown, don't crash! Simply print a descriptive statement for the user.

? Tip: You can choose how to handle the situation by writing the appropriate code in the except block. Perhaps you could create a new file if it doesn't exist already.

To close the file automatically after the task (regardless of whether an exception was raised or not in the try block) you can add the finally block.

try: # Try to run this code except : # If this exception is raised, stop the process immediately and jump to this block finally: # Do this after running the code, even if an exception was raised

This is an example:

try: f = open("names.txt") except FileNotFoundError: print("The file doesn't exist") finally: f.close()

There are many ways to customize the try/except/finally statement and you can even add an else block to run a block of code only if no exceptions were raised in the try block.

? Tip: To learn more about exception handling in Python, you may like to read my article: "How to Handle Exceptions in Python: A Detailed Visual Introduction".

? In Summary

• You can create, read, write, and delete files using Python.
• File objects have their own set of methods that you can use to work with them in your program.
• Context Managers help you work with files and manage them by closing them automatically when a task has been completed.
• Exception handling is key in Python. Common exceptions when you are working with files include FileNotFoundError, PermissionError and IsADirectoryError. They can be handled using try/except/else/finally.

I really hope you liked my article and found it helpful. Now you can work with files in your Python projects. Check out my online courses. Follow me on Twitter. ⭐️