Skip to main content

Converting Python objects to JSON and vice versa

In today's digital age, data is the new oil, and JSON (JavaScript Object Notation) has become the de facto standard for data exchange on the web. In this tutorial, we'll learn how to convert Python objects to JSON and vice versa using the json module in Python.

What is JSON?​

JSON is a lightweight data-interchange format that is easy for humans to read and write and easy for machines to parse and generate. It is based on a subset of the JavaScript Programming Language, Standard ECMA-262 3rd Edition - December 1999.

A JSON object looks like this:

{
  "name": "John",
  "age": 30,
  "city": "New York"
}

The json Module in Python​

Python, in its vast library, has a built-in module called json for encoding and decoding JSON data. You don't need to install it separately.

Converting Python Objects to JSON (Serialization)​

The process of converting Python objects into JSON strings is known as serialization. The json module provides a method called dump() for writing data to JSON. Let's see how it works.

import json

person = {
  "name": "John",
  "age": 30,
  "city": "New York"
}

# convert into JSON:
person_json = json.dumps(person)

print(person_json)

When you run the program, you will get the following output:

{"name": "John", "age": 30, "city": "New York"}

Converting JSON to Python Objects (Deserialization)​

The process of converting JSON data into Python objects is known as deserialization. The json module provides a method called loads() for this purpose. Let's see how it works.

import json

# some JSON:
person_json = '{"name": "John", "age": 30, "city": "New York"}'

# parse json:
person = json.loads(person_json)

print(person)

When you execute the code, you will get the following output:

{'name': 'John', 'age': 30, 'city': 'New York'}

Working with Python and JSON​

The json module can handle more than just simple strings, numbers, and dictionaries. It can also handle nested dictionaries, lists, and even complex objects like dates and custom classes.

There are certain points to remember while working with JSON in Python:

  • The JSON format only permits text. Binary data like byte objects or binary file data can't be written into JSON directly.
  • JSON cannot store every kind of Python value. It can contain values of only the following data types: strings, integers, floats, Booleans, lists, dictionaries, and NoneType.

That's it! You now know how to convert Python objects to JSON and vice versa. Remember, understanding how to work with JSON is crucial when dealing with APIs and web data. Practice these concepts, and you'll be a pro in no time!