JSON (JavaScript Object Notation) is a lightweight data interchange format that's easy for humans to read and write and for machines to parse and generate.

Handling JSON data efficiently is crucial for building applications that interact with web services or store configuration data. In today's article, we will cover handling JSON data in Python.

If you're interested in more content covering topics like the one you're reading, subscribe to my newsletter for regular updates on software programming, architecture, and tech-related insights.

Handling JSON Data

JSON is a lightweight data interchange format commonly used around information infrastructure to exchange data. In Python, the json module provides methods for parsing JSON strings and files and converting Python objects to JSON. In the next section, we will see how to convert a string to a dict.

Reading JSON Data from a String

Reading JSON data from a string involves using the json.loads() method. This method parses the JSON string and converts it into a Python dictionary.

import json

json_data = '{"name": "John", "age": 30, "city": "New York"}'
python_dict = json.loads(json_data)
print(python_dict)

In this example, we are importing the json module, defining a JSON string, and using json.loads() to parse it. Now, let's see how to read a json file.

Reading JSON Data from a File

In real-world cases, JSON data is often stored in files. Reading JSON data from a file can be done using the json.load() method. Let's see how it is done.

import json

with open('data.json', 'r') as file:
    python_dict = json.load(file)
print(python_dict)

Here, we are opening a JSON file in read mode (open('data.json', 'r')), using json.load() to parse the file's content, then store it in a Python dictionary. This approach is useful for reading from configuration files, data storage, and much more.

Now, let's see how we can write in JSON file or format.

Writing JSON Data to a String

Some cases of working in JSON might involve writing data into JSON. In this section, we will see how to transform a dict into a JSON string.

To convert a Python dictionary to a JSON string, you use the json.dumps() method.

import json

python_dict = {"name": "John", "age": 30, "city": "New York"}
json_data = json.dumps(python_dict)
print(json_data)

This example shows how to convert a Python dictionary to a JSON string using json.dumps(). Now, let's see how we can write the content into a file.

Writing JSON Data to a File

Another common example of using JSON is writing data into files. Let's see how it can be done using python.

Writing JSON data to a file is straightforward with the json.dump() method.

import json

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

with open('data.json', 'w') as file:
    json.dump(python_dict, file)

In this example, we open a file in write mode and use json.dump() to write the Python dictionary to the file. This is useful for saving configuration settings, user data, and other information in JSON format.

Now, it is important to be cautious as you can easily confuse dump and dumps. The json.dumps() method converts a Python object into a JSON string. The json.dump() method is used for writing/dumping JSON to a file/socket.

Handling Large JSON Files

When working with large JSON files, performance, and memory usage become critical. Here are some tips to efficiently handle large JSON files with json.dumps and json.loads:

Stream Processing

For large files, consider processing JSON data in a streaming manner to avoid loading the entire file into memory.

Reading in Chunks

Using the ijson library allows for iterative parsing of JSON files.

import ijson

with open('large_data.json', 'r') as file:
    for item in ijson.items(file, 'item'):
        # Process each item
        print(item)

Writing in Chunks

If generating large JSON files, write in chunks to manage memory usage.

import json

data = [{"name": "John", "age": 30, "city": "New York"}] * 1000000  # Large data

with open('large_data.json', 'w') as file:
    for chunk in (data[pos:pos + 1000] for pos in range(0, len(data), 1000)):
        json.dump(chunk, file)

Using Generators

Generators can help process data lazily, which is useful for large datasets.

import json

def generate_large_data():
    for i in range(1000000):
        yield {"name": f"John {i}", "age": i, "city": "New York"}

with open('large_data.json', 'w') as file:
    for chunk in generate_large_data():
        json.dump(chunk, file)

Here are other ways to optimize json.dumps, and json.loads function :

Use indent=None and separators=(',', ':') in json.dumps to minimize the output size.
Use object_hook in json.loads to customize the decoding process.

json_data = json.dumps(python_dict, separators=(',', ':'))
python_dict = json.loads(json_data, object_hook=lambda d: MyCustomClass(**d))

Conclusion

In this article, we have learned how to handle files in JSON format. We learned how to read from JSON files or JSON format, but also how to write in JSON files. We have also learned how to deal with bigger files.

If you enjoyed this article and want to stay updated with more content, subscribe to my newsletter. I send out a weekly or bi-weekly digest of articles, tips, and exclusive content that you won't want to miss 🚀

Handling JSON Data in Python