By the end of this tutorial, you’ll have learned:
the basics of JSON,how to parse and create JSON strings in Python, andhow to read from and write to JSON files in Python.
Let’s start!⏳
What is JSON?
JSON stands for JavaScript Object Notation, and it’s a text-based format for data interchange. Though JSON is initially inspired by JavaScript objects, almost all programming languages support working with JSON. If you’ve ever worked with APIs or read through configuration files—you’d likely have run into JSON. 📑 You send and receive data in JSON when querying APIs. And JSON is also widely used in client-server communication in software applications. In addition, you can use JSON for general-purpose data storage as well. The format of JSON is very similar to that of a Python dictionary. Dictionaries are powerful built-in data structures in Python that store data in key-value pairs. Before we go any further, here are a few points worth noting:
In Python, a JSON object is stored as a dictionary. An array in JSON is stored as a Python list. In JSON, the Boolean values are denoted as true and false. In Python, these are converted to the Booleans True and False.
For more details on the data types that are translated from JSON to Python, read the docs here. As the json module is part of the Python standard library, you don’t have to install it. You can import into your current directory, like this:
How to Load a JSON String in Python
The general syntax to load a JSON string in Python is: Here,
<dict_obj> is the Python dictionary to which you’d like to load the JSON string,<json_str> is any valid JSON string.
This loads the <json_str> into the Python dictionary <dict_obj>. Let’s code an example. Here json_str is a JSON string.
And the code snippet below shows how you can load the JSON string json_str into a Python dictionary using the loads() method. You can use the built-in type() function to verify that py_dict is a Python dictionary.
As shown in the above code, all fields in the JSON string are key-value pairs in py_dict.
How to Create JSON Strings in Python
Let’s suppose you have a Python dictionary. So how do you create a JSON string from it? You can do it using the dumps() method with this syntax: Here,
<dict_obj> is the Python dictionary from which you’d like to create the JSON string,<json_str> is the resultant JSON string.
So the dumps() method dumps <dict_obj> into a JSON string <json_str>. To our existing Python dictionary py_dict. let’s add a new key “movies”. You can do it as shown in the following code snippet: Now, let’s dump the modified dictionary to a new JSON string json_str2 using the dumps() method. As you can see in the above example, the output JSON string is difficult to read through without proper formatting. You can use the optional parameter indent to add indentation. And you can do this by setting indent to an integer like 2, as shown below: Observe how the output has been formatted with indentation, and it’s easy to follow through. As you can see in the code snippet below, the keys have now been sorted in alphabetical order.
And the keys now appear in alphabetical order: “author”, “title” and “year”. So far, you’ve learned how to work with JSON strings in Python. In the next section, you’ll learn how to work with JSON files.
How to Read a JSON File in Python
To read a JSON file in Python, use the following syntax:
You should consider using context managers when working with files in Python. You can also try to read files as follows, without using context manager:
If you don’t close the file, there can be a potential wastage of resources. However, when working with context managers, the files are automatically closed once the file operations are complete. And you can use context manager to read files, as shown below:
As you’re reading from a file, specify the mode as read—indicated by ‘r’ in the above code. In the next section, you’ll learn how to write to a JSON file.✍
How to Write to a JSON File in Python
To write to an existing JSON file or to create a new JSON file, use the dump() method as shown:
So the above syntax dumps the dictionary <dict_obj> into the JSON file <json_file>. In the previous section, we had the dictionary py_dict. Now let’s dump that into a new JSON file. And let’s name it new_file.json. And the following code cell shows how you can use the dump() function:
After executing the above code cell, you’ll see that a new JSON file has been created in the current working directory. And you can go ahead and examine the contents of the JSON file. When writing to files, the key goal is data storage. And if you’d like to preserve formatting, you can also use the indent and sort_keys parameters.
Conclusion
⏲ It’s time for a quick summary. In this tutorial, you have learned:
the basics of using JSON,how to use the loads() and load() methods to read JSON string and JSON files respectively,how to use the dumps() and dump() methods to dump Python dictionaries into JSON strings and JSON files respectively.
I hope you found this tutorial helpful. Happy learning! You may also look at JSON Tools to parse, format, and validate.
