Difference between revisions of "CSC111 Lab 9 2014"

From dftwiki3
Jump to: navigation, search
(Writing Numbers to File and Reading them Back)
 
(18 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
</bluebox>
 
</bluebox>
 
<br />
 
<br />
=Reminder=
 
 
<br />
 
<br />
<font color="magenta">Remember to use the [https://docs.python.org/3.3/contents.html docs.python.org] pages for reference!</font>
 
 
<br />
 
<br />
 +
 +
 +
<br />
 +
<br />
 +
 
=Reading and Writing Text Files=
 
=Reading and Writing Text Files=
 
<br />
 
<br />
Line 50: Line 53:
 
oneString = "" . join( allLines )
 
oneString = "" . join( allLines )
 
print( repr( oneString ) )  # repr() function makes special characters visible
 
print( repr( oneString ) )  # repr() function makes special characters visible
 +
print( oneString )      # print it normally
 
</source>
 
</source>
 
<br />
 
<br />
Line 55: Line 59:
 
   
 
   
 
  'Smith College\n1 Elm st., Northampton, MA 01063\n'
 
  'Smith College\n1 Elm st., Northampton, MA 01063\n'
 +
Smith College
 +
1 Elm st., Northampton, MA 01063
 +
 +
 +
<br />
 +
<br />
 +
<br />
 +
<br />
 +
<!-- ----------------------------------------------------------------------------------------------- -->
 +
{| style="width:100%; background:silver"
 +
|-
 +
|
 +
 +
==Exercise==
 +
|}
 +
[[Image:QuestionMark9.jpg|right|120px]]
 +
<br />
 +
* Try each of these examples above.
 +
 +
<br /><br />
 +
<br />
 +
<br /><br />
 +
<br />
 +
<br /><br />
 +
<br />
  
 
=Writing Text to File and Reading it Back=
 
=Writing Text to File and Reading it Back=
Line 117: Line 146:
  
 
  [ 1, 2, 3, 5, 10 ]
 
  [ 1, 2, 3, 5, 10 ]
    ||
+
&nbsp;&nbsp;&nbsp;&nbsp;|
    ||
+
&nbsp;&nbsp;&nbsp;&nbsp;|
    V
+
&nbsp;&nbsp;&nbsp;&nbsp;V
 
  [ '1', '2', '3', '5', '10' ]
 
  [ '1', '2', '3', '5', '10' ]
    ||
+
&nbsp;&nbsp;&nbsp;&nbsp;|
    ||
+
&nbsp;&nbsp;&nbsp;&nbsp;|
    V
+
&nbsp;&nbsp;&nbsp;&nbsp;V
   '1\n2\n3\n5\n10\n'      == write ==>  text-file
+
   '1\n2\n3\n5\n10\n'      ==(write)==>  text-file
  
 
The concept of reading a list of numbers from a text file is simple as well, and illustrated in the diagram below:
 
The concept of reading a list of numbers from a text file is simple as well, and illustrated in the diagram below:
  
   text-file        == read ==>    '1\n2\n3\n5\n10\n'
+
   '1\n2\n3\n5\n10\n' &nbsp;&nbsp;&nbsp;<==(read)== &nbsp;&nbsp;&nbsp;text-file
                                                      ||
+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|
                                                      ||
+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|
                                                      V
+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;V
                                              [ '1', '2', '3', '5', '10' ]
+
[ '1', '2', '3', '5', '10' ]
                                                      ||
+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|
                                                      ||
+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|
                                                      V
+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;V
                                              [ 1, 2, 3, 5, 10 ]
+
[ 1, 2, 3, 5, 10 ]
  
  
Line 168: Line 197:
 
:2) When reading the file of integers, just read the file and display the lines in it as text.  Then little by little transform each line into an int.  Then when that works, figure out how to add the ints to a list, one at a time.
 
:2) When reading the file of integers, just read the file and display the lines in it as text.  Then little by little transform each line into an int.  Then when that works, figure out how to add the ints to a list, one at a time.
  
 +
<br />
 +
<br />
 
=Creating a Log =
 
=Creating a Log =
 
<br />
 
<br />
Line 368: Line 399:
 
       L.append( (name, cash, age, fans ) )
 
       L.append( (name, cash, age, fans ) )
  
 +
    file.close()
 
     print( "L = ", L )
 
     print( "L = ", L )
 
</source>
 
</source>

Latest revision as of 09:11, 4 April 2014

--D. Thiebaut (talk) 23:40, 1 April 2014 (EDT)



This lab deals with text files in Python, also referred to as File Input/Output or File I/O. You will write text, read text, write numbers, read numbers, and append to logs, all this with text files.







Reading and Writing Text Files


Write Example


# write some variables to file
name = "Smith College"
address = "1 Elm st., Northampton, MA 01063"
file = open( "college.txt", "w" )
file.write( "%s\n" % name )
file.write( "%s\n" % address )
file.close()


Read Examples


Print all the lines inside a File


file = open( "college.txt", "r" )
for line in file:
    print( line.strip() )
file.close()


Output
Smith College
1 Elm st., Northampton, MA 01063


Read the file as one whole string


# read the same file back and print all the lines
file = open( "college.txt", "r" )
allLines = file.readlines()  # allLines is a list of strings, each line a separate string
file.close()

oneString = "" . join( allLines )
print( repr( oneString ) )  # repr() function makes special characters visible
print( oneString )       # print it normally


Output
'Smith College\n1 Elm st., Northampton, MA 01063\n'
Smith College
1 Elm st., Northampton, MA 01063






Exercise

QuestionMark9.jpg


  • Try each of these examples above.










Writing Text to File and Reading it Back


Challenge 1

QuestionMark1.jpg


  • Use the example above and write a program that writes the string text defined below to a file named poem.txt in the same folder (directory) where your program is located.


text = """An Evening by Gwendolyn Brooks

A sunset's mounded cloud; 
A diamond evening-star; 
Sad blue hills afar; 
Love in his shroud. 

Scarcely a tear to shed; 
Hardly a word to say; 
The end of a summer day; 
Sweet Love dead."""


  • Once the program terminates, open the file with TextEdit if working on a Mac, or with Notepad if working on Windows (you can double-click it in Windows Explorer). Verify that the file exists and that it contains the poem. If you are ambitious, you may want to use the Console or the Terminal to locate the file the way we did in class, and display its contents on the screen using type (Windows) or cat (Mac).


  • Put the code that writes the poem to file in a function called writeTextFile( fileName, text ), where fileName is a parameter that will receive the name of the file, and text the name of a variable that will get the string to write to file. The function should 1) open the file for writing, 2) write text to the file, and 3) close the file.
Verify that your function works by deleting poem.txt and then running your new program. If you function is written correctly, it will have recreated the poem.txt file with the same contents as before.







Challenge 2

QuestionMark2.jpg
  • Get some inspiration from the "Read Examples" section above, and add some code to your program that will read the file just created and print its contents (all the lines) on the screen. (Basically, add a file.open() statement, a loop to read and print the lines, and a file.close(), and you're done.)
  • When this works, replace your code by a call to a function called readTextFile() that will open the file, get its contents as a long string (once again, go back to the "Read Examples" section above to see how to do that). The function at the end will use a return statement to return a long string that is equal to the full contents of the file.

Here is an example of how your program will use your new function to read the file and display the string:


        text = readTextFile(  "poem.txt" )
        for line in text.split( "\n" ):
            print( line )


Writing Numbers to File and Reading them Back


The concept of writing a list of numbers to a text file is simple, and illustrated in the diagram below:

[ 1, 2, 3, 5, 10 ]
    |
    |
    V
[ '1', '2', '3', '5', '10' ]
    |
    |
    V
 '1\n2\n3\n5\n10\n'       ==(write)==>   text-file

The concept of reading a list of numbers from a text file is simple as well, and illustrated in the diagram below:

 '1\n2\n3\n5\n10\n'    <==(read)==    text-file 
         |
         |
         V
[ '1', '2', '3', '5', '10' ]
         |
         |
         V
[ 1, 2, 3, 5, 10 ]




Same idea: you write a function that takes a list of numbers and writes them to file, one per line. Then you write a function that reads the numbers back, prints them, and computes their sum. This last part is very important, because to text files contain text, or strings, and when you read that back into variables that are supposed to contain numbers, you must transform the strings into numbers.

Here is the list of numbers to use, and an example of how to organize your main program:


numbers = [ 1, 2, 10, 100, 50, 7 ]

# write the list to file, one number per line
writeIntFile( "numbers.txt", numbers )

# read the file of ints, and return it as a list of ints.
newNumbers = readIntFile( "numbers.txt" )

# print the list of ints and their sum (should be 170)
for x in newNumbers:
    print( x )

print( "Sum = ", sum( newNumbers ) )


Hints
1) Text files contain only strings of characters. To store numbers in a file you have to write the number as a string. A good way to transform an integer into a one-line string is with "%d\n" % x , where x is the integer in question.
2) When reading the file of integers, just read the file and display the lines in it as text. Then little by little transform each line into an int. Then when that works, figure out how to add the ints to a list, one at a time.



Creating a Log


Add the function below to your program. Then call it from your main program and "play" with it for a little while. Figure out how to make it stop (read the code!)

from random import choice
def discussion():
     canned = [ "Please go on...", "Is that so?", "Please tell me more.", "Really?" ]
     print( "Hello!" )
     while True:
           answer = input( "> " ).strip()
           if answer.lower() in [ "bye", "ciao", "later" ]:
                 break
           print( choice( canned ) )
     print( "Good bye!" )



Challenge 3

QuestionMark3.jpg
  • Add some new statements to your function so that it will record the conversation that is taking place on the screen in a log file. A log is simply a text file that contains a list of lines representing actions that have taken place at some point under some circumstances. You may want to call the log log.txt
  • Verify that when your function has terminated, a new file exists in your working directory, and that it contains a log of your conversation.
  • Run your function again. Finish it with "bye" and check the log file again. Notice that the old conversation has been erased by the new one.
If we had wanted to add the new conversation at the end of the old one (logs have a tendency to keep everything and never erase prior information), then should have opened the file differently. When we open a file like this:
   file = open ( "someFileName.ext", "w" )

the "w" indicates create the file if it does not exist, or erase it if it already exists, and start writing to it." To write to a file without erasing it, we simply replace the "w" by an "a" which means "append" to the end of the file, or create it if it doesn't exist.

   file = open( "someFileName.ext", "a" )


Challenge 4

QuestionMark4.jpg


  • Modify your program so that it appends to the log and never erases it.









Challenge 5

QuestionMark5.jpg


  • Create a new function called log( line ) that adds a new line to the log file. This function will assume the log file name is log.txt, open the log, append the line to it, and close it. Using it will make our original discussion function much simpler:


from random import choice
def discussion():
     canned = [ "Please go on...", "Is that so?", "Please tell me more.", "Really?" ]
     print( "Hello!" )
     log( "Hello!" )
     while True:
           answer = input( "> " ).strip()
           log( answer )
           if answer.lower() in [ "bye", "ciao", "later" ]:
                 break
           response = choice( canned )
           print( response )
           log( response )
     print( "Good bye!" )
     log( "Good bye!" )



Challenge 6

QuestionMark6.jpg


  • Instead of having canned answers defined in the program, let's put them in a text file. This may seem strange to put strings in a file, except if you think of the Eliza program for the previous homework where the program may add more canned answers to its list as the conversation with the human progresses. If the program were to save the list of canned answers to a file, and restore them from file when it restarts, the program would have "memory" and fool the user in thinking that the program "remembers" parts of a previous conversation.
  • Your challenge is to make your conversation function read the canned answers from a different text file where you will have saved canned sentences, one per line.






Submission


Submit the program (which you should name lab9.py) to this URL: http://cs.smith.edu/~thiebaut/111b/submitL9.php




...