json5kit 0.3.1

A Roundtrip parser and CST for JSON, JSONC and JSON5.

json5kit

A Roundtrip parser and CST for JSON, JSONC and JSON5.

Currently a work in progress

Currently supports parsing all of JSON syntax, and converting it back to source. Also supports single line // comments.

Installation

pip install json5kit

Usage

>>> source = """
... {
...   "items": [1, 2, 4],  // change this to 3
... }
... """
>>> import json5kit
>>> tree = json5kit.parse(source)
>>> print(tree.to_source())

{
  "items": [1, 2, 4],  // change this to 3
}

>>> print(tree.to_json())
{"items":[1,2,4]}
>>> # Let's replace the `4` with `3` now:
>>> class ReplaceFourWithThree(json5kit.Json5Transformer):
...     def visit_Number(self, node):
...         if node.value == 4:
...             return node.replace(value=3)
...         return node
...
>>> ReplaceFourWithThree().visit(tree)
>>> print(tree.to_source())

{
  "items": [1, 2, 3],  // change this to 3
}
>>> print(tree.to_json())
{"items":[1,2,3]}

Development / Testing

• Clone the project:

  git clone https://github.com/tusharsadhwani/json5kit
  cd json5kit
  

• Setup a virtual environment:

  virtualenv venv
  . venv/bin/activate
  

• Do an editable install of the project, that way you don't have to keep reinstalling:

  pip install -r requirements-dev.txt
  

• Run tests:

  pytest
  

• Run type checking:

  mypy .