py-jsonkit

---

🚀 Your toolkit for seamless JSON handling in Python 🐍

Overview • Features • Installation • Usage • License • Contributing

Overview

JSONKit is a Python Library for enhanced JSON file handling with support for datetime and UUID objects. It provides both synchronous and asynchronous file operations.

Features

• Synchronous Operations: Read and write JSON files with custom encoding and decoding for datetime and UUID objects.

• Asynchronous Operations: Handle JSON files asynchronously using aiofiles.

• Custom Serialization: Special handling for datetime and UUID types.

• Pretty Printing: Pretty printing powered by the rich library!

Installation

You can install JSONKit via pip:

pip install py-jsonkit

Usage

👉 Loading JSON from a File

You can load a JSON file into a Python object easily:

from jsonkit import JSONFile

# Initialize the JSONFile object
json_file = JSONFile('example.json')

# Load data from the file
data = json_file.load()

👉 Writing data to a JSON file:

You can also write some data to a JSONFile easily

from jsonkit import JSONFile
from datetime import datetime
import uuid

# Initialize the JSONFile object
json_file = JSONFile('example.json')

# Example data
data_to_write = {
    "name": "Alice",
    "age": 30,
    "created_at": datetime.now(),
    "uid": uuid.uuid4()
}

# Insert to the JSON file
# JSONKit comes with custom encoding/decoding so you don't need to worry about parsing datetime or uuid objects!
# The `write` function returns the new data that is present in the JSON file after writing to it automatically, so you can store it in a variable like this:
new_returned_data = json_file.write(data_to_write, indent=4)

# Or, you can simply do this in the good old way:
json_file.write(data_to_write, indent=4)
new_data = json_file.load()

# NOTE: The method shown above will completely replace the old data with the new data. In case you want to append some data to a JSON file which of course, already contains some data, you can simply load that data first:
data = json_file.load()

# Then add some data to it:
data["......"] = "......"
data["woah this is some new data"] = "I am the value of the new data!"

# Then write this data back to the JSON File
json_file.write(data, indent=4)

👉 Pretty Printing

JSONKit also comes with pretty printing which is handled by the rich library!

from jsonkit import JSONFile

# Intialize the JSONFile object
json_file = JSONFile('example.json')

# Pretty print all of the data in 'example.json' file to the console
# This will print the data with syntax hughlighting!
json_file.print_data()

👉 Asynchronous Support

JSONKit can also be used asynchronously using the AsyncJSONFile class!

from jsonkit import AsyncJSONFile
import asyncio

# Create an instance of AsyncJSONFile
async_json_file = AsyncJSONFile('example.json')

# All of the methods that are available in 'JSONFile' class are also available here!
async def main():
    # Loading data
    data = await async_json_file.load()

    # Writing data
    data_to_insert = {
        "...": "..."
    }
    await async_json_file.write(data_to_insert, indent=4)

    # Pretty printing data
    await async_json_file.print_data()

# Running the main function
asyncio.run(main())

License

JSONKit is licensed under the MIT License. See the LICENSE file for more details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.