Python JSON

Python JSON

Welcome to codeswithpankaj.com! In this tutorial, we will explore how to work with JSON in Python using the json module. We'll cover how to encode and decode JSON, and provide detailed examples to illustrate their application.

Table of Contents

1. Introduction to JSON

2. Why Use JSON?

3. The json Module

4. Encoding JSON

5. Decoding JSON

6. Working with JSON Files

7. Customizing JSON Encoding and Decoding

8. Practical Examples

9. Summary

1. Introduction to JSON

What is JSON?

JSON (JavaScript Object Notation) is a lightweight data-interchange format that is easy for humans to read and write and easy for machines to parse and generate. JSON is built on two structures:

• A collection of name/value pairs (often referred to as an object, dictionary, hash table, etc.).

• An ordered list of values (often referred to as an array, list, vector, etc.).

Key Points

• JSON is language-independent but uses conventions familiar to programmers of the C-family of languages.

• JSON is often used to transmit data between a server and web application as text.

2. Why Use JSON?

• Interoperability: JSON is a widely accepted format for data exchange between different systems and programming languages.

• Simplicity: JSON is easy to read and write for both humans and machines.

• Flexibility: JSON supports complex data structures like nested objects and arrays.

3. The json Module

The json module in Python provides functions to encode (serialize) and decode (deserialize) JSON data.

4. Encoding JSON

Example: Encoding a Python Dictionary to JSON

import json

# Python dictionary
data = {
    "name": "Pankaj",
    "age": 30,
    "city": "New York"
}

# Convert Python dictionary to JSON
json_data = json.dumps(data, indent=4)
print(json_data)

Example: Encoding a Python List to JSON

import json

# Python list
data = ["apple", "banana", "cherry"]

# Convert Python list to JSON
json_data = json.dumps(data, indent=4)
print(json_data)

5. Decoding JSON

Example: Decoding JSON to a Python Dictionary

import json

# JSON data
json_data = '''
{
    "name": "Pankaj",
    "age": 30,
    "city": "New York"
}
'''

# Convert JSON to Python dictionary
data = json.loads(json_data)
print(data)

Example: Decoding JSON to a Python List

import json

# JSON data
json_data = '''
[
    "apple",
    "banana",
    "cherry"
]
'''

# Convert JSON to Python list
data = json.loads(json_data)
print(data)

6. Working with JSON Files

Example: Writing JSON to a File

import json

# Python dictionary
data = {
    "name": "Pankaj",
    "age": 30,
    "city": "New York"
}

# Write JSON to a file
with open('data.json', 'w') as file:
    json.dump(data, file, indent=4)

Example: Reading JSON from a File

import json

# Read JSON from a file
with open('data.json', 'r') as file:
    data = json.load(file)

print(data)

7. Customizing JSON Encoding and Decoding

Example: Customizing Encoding with cls Parameter

import json

class User:
    def __init__(self, name, age, city):
        self.name = name
        self.age = age
        self.city = city

def encode_user(obj):
    if isinstance(obj, User):
        return {"name": obj.name, "age": obj.age, "city": obj.city}
    raise TypeError(f"Object of type {obj.__class__.__name__} is not JSON serializable")

user = User("Pankaj", 30, "New York")

# Encode User object to JSON
json_data = json.dumps(user, default=encode_user, indent=4)
print(json_data)

Example: Customizing Decoding with object_hook Parameter

import json

class User:
    def __init__(self, name, age, city):
        self.name = name
        self.age = age
        self.city = city

def decode_user(dct):
    return User(dct['name'], dct['age'], dct['city'])

json_data = '''
{
    "name": "Pankaj",
    "age": 30,
    "city": "New York"
}
'''

# Decode JSON to User object
user = json.loads(json_data, object_hook=decode_user)
print(user.name, user.age, user.city)

8. Practical Examples

Example 1: Handling Nested JSON

import json

# Nested Python dictionary
data = {
    "name": "Pankaj",
    "address": {
        "street": "123 Main St",
        "city": "New York",
        "state": "NY"
    },
    "phone_numbers": [
        {"type": "home", "number": "212-555-1234"},
        {"type": "work", "number": "646-555-4567"}
    ]
}

# Convert Python dictionary to JSON
json_data = json.dumps(data, indent=4)
print(json_data)

Example 2: Parsing JSON from a Web API

import json
import requests

# Fetch JSON data from a web API
response = requests.get('https://jsonplaceholder.typicode.com/todos/1')
data = response.json()

# Pretty print the JSON data
print(json.dumps(data, indent=4))

Example 3: Encoding and Decoding DateTime Objects

import json
from datetime import datetime

class DateTimeEncoder(json.JSONEncoder):
    def default(self, obj):
        if isinstance(obj, datetime):
            return obj.isoformat()
        return super().default(obj)

data = {
    "name": "Pankaj",
    "timestamp": datetime.now()
}

# Encode datetime object to JSON
json_data = json.dumps(data, cls=DateTimeEncoder, indent=4)
print(json_data)

# Decode datetime object from JSON
def decode_datetime(dct):
    for key, value in dct.items():
        try:
            dct[key] = datetime.fromisoformat(value)
        except:
            pass
    return dct

decoded_data = json.loads(json_data, object_hook=decode_datetime)
print(decoded_data)

9. Summary

In this tutorial, we explored how to work with JSON in Python using the json module. We covered encoding and decoding JSON, working with JSON files, customizing JSON encoding and decoding, and provided practical examples to illustrate the application of JSON in Python. The json module is a powerful tool for handling JSON data in Python.

For more tutorials and in-depth explanations, visit codeswithpankaj.com!

---

This tutorial provides a comprehensive overview of working with JSON in Python, detailing each topic and subtopic with examples and explanations. For more such tutorials, keep following codeswithpankaj.com!