In this tutorial we will be discussing about Python Pickle Example. In our previous tutorial, we discussed about Python Multiprocessing.
Python Pickle is used to
deserialize a python object structure. Any object on python can be pickled so that it can be saved on disk.
At first Python pickle serialize the object and then converts the object into a character stream so that this character stream contains all the information necessary to reconstruct the object in another python script.
Note that the pickle module is not secure against erroneous or maliciously constructed data according to the documentation. So, never unpickle data received from an untrusted or unauthenticated source.
Python Pickle dump
In this section, we are going to learn, how to store data using Python pickle. To do so, we have to import the pickle module first.
pickle.dump() function to store the object data to the file.
pickle.dump() function takes 3 arguments. The first argument is the object that you want to store. The second argument is the file object you get by opening the desired file in
write-binary (wb) mode. And the third argument is the key-value argument. This argument defines the protocol. There are two type of protocol – pickle.HIGHEST_PROTOCOL and pickle.DEFAULT_PROTOCOL. See the sample code to know how to dump data using pickle.
import pickle # take user input to take the amount of data number_of_data = int(input('Enter the number of data : ')) data =  # take input of the data for i in range(number_of_data): raw = input('Enter data '+str(i)+' : ') data.append(raw) # open a file, where you ant to store the data file = open('important', 'wb') # dump information to that file pickle.dump(data, file) # close the file file.close()
The following program will prompt you to enter some input. In my case, it was like this.
Python Pickle load
To retrieve pickled data, the steps are quite simple. You have to use
pickle.load() function to do that. The primary argument of pickle load function is the file object that you get by opening the file in read-binary (rb) mode.
Simple! Isn’t it. Let’s write the code to retrieve data we pickled using the pickle dump code. See the following code for understanding.
import pickle # open a file, where you stored the pickled data file = open('important', 'rb') # dump information to that file data = pickle.load(file) # close the file file.close() print('Showing the pickled data:') cnt = 0 for item in data: print('The data ', cnt, ' is : ', item) cnt += 1
The output will be the following:
Showing the pickled data: The data 0 is : 123 The data 1 is : abc The data 2 is : !@#$
Python Pickle Example
I made a short video showing execution of python pickle example programs – first to store data into file and then to load and print it.
As you can see that the file created by python pickle dump is a binary file and shows garbage characters in the text editor.
Important Notes on Python Pickle
Few important points about python pickle module are:
- The pickle protocol is specific to Python – it’s not guaranteed to be cross-language compatible. This means you most likely can’t transfer the information to make it useful in other programming languages.
- There is also no guarantee of compatibility between different versions of Python because not every Python data structure can be serialized by the module.
- The latest version of the pickle protocol is used by default unless you manually change it.
- Last but not least, the pickle module is not secure against erroneous or maliciously constructed data according to the documentation.
So, that’s all about python pickle example. Hope that you understand well. For any further query please use the comment section. 🙂
Reference: Official Documentation