libJSONHandle

A library that makes a query or an edit in a JSON text.

The library is originally designed for satisfying the needs to handle the replies from AI models. The future development goal is to make it able to handle the operations to an embeded database with the format of JSON Lines.

The library is released under GNU Lesser General Public License version 3.0, while the executable program is released under Apache License version 2.0.

Version 1.2.1 - Release Notes

Download source: libJSONHandle-1.2.1.tar.xz

Download binary for Linux (amd64): libJSONHandle-1.2.1-linux-amd64.tar.xz (Built using GCC 14.2, cmake and make; tested on Debian 13 for amd64)

Download binary for Linux (arm64): libJSONHandle-1.2.1-linux-arm64.tar.xz (Built using GCC 15.2, cmake and make; tested on 64-bit Raspberry Pi OS on Raspberry Pi 5)

Download binary for Windows 11 (amd64): libJSONHandle-1.2.1-win11-amd64.tar.xz (Built using MSYS2 MinGW-w64 GCC 15.2, cmake and ninja; tested on Windows 11 25H2)

Third-Party Libraries

The binary for Windows is distributed with GCC runtime libraries and MinGW-w64 winpthreads library. GCC runtime libraries are distributed under GCC Runtime Library Exception. MinGW-w64 winpthreads library is distributed under MIT License and BSD 3-Clause Clear License (Copyright (c) 2011 mingw-w64 project. (C) 2010 Lockless Inc. All rights reserved.).

How to Use the Executable Program

jsonHandle [options]

For example:

1. Make a query

jsonHandle example.json -q candidates.content.parts.text -c candidates.content.role=model

2. Make an edit

jsonHandle example.json -e "hardware.gpu model=NVIDIA GeForce RTX 4060" -c hardware.id=12345

Options:

<file>

The path of a JSON file.

The file path should be enclosed in double quotation marks if it contains a space.

When the option is lacking, or the path is invalid, the program will ask for providing a JSON text.

-q

The query.

The hierarchy keys are separated by a dot.

If there is a space in the query, the query should be enclosed in double quotation marks.

For example:

-q candidates.content.parts.text

-q "hardware.gpu brand"

-e

The assignment expression for an edit.

The hierarchy keys are separated by a dot.

There is an equals sign between the keys and the value.

If there is any space, the string with a space or the entire string should be enclosed in double quotation marks.

For example:

-e "hardware.cpu model"="Intel Core i9 14900"

-e "hardware.gpu model=NVIDIA GeForce RTX 4060"

-c

The conditions for the query.

The hierarchy keys are separated by a dot.

There is an equals sign between the keys and the value.

Multiple conditions are separated by a comma.

If there is any space, the string with a space or the entire string should be enclosed in double quotation marks.

For example:

-c candidates.content.role=model

-c "device type"="Raspberry Pi"

-c "device type=Personal Computer,hardware.cpu brand=AMD"

TCM i Kultura Prosta Spółka Akcyjna

Article category: