jsonc-parser

What it is and what it does

jsonc-parser is a lightweight, zero-dependency Python module for reading and converting JSON files that contain comments (.jsonc format). It provides a static JsoncParser class with methods to parse .jsonc files or strings into Python dictionaries, stripping comments in the process, and to convert between .jsonc and .json file formats.

The package is designed for simple, straightforward use: import the class, call one of its parsing or conversion methods with a file path or string, and get back clean JSON data. It raises custom exceptions (FileError, FunctionParameterError, ParserError) to signal problems with file format, invalid parameters, or unparseable content. Because it has no runtime dependencies and a pure-Python implementation, installation is frictionless.

Use it for:

• Load configuration files that use JSONC format (with comments for documentation) into Python dicts for application startup.
• Convert legacy .jsonc config files to standard .json format for compatibility with JSON-only tools.
• Parse VSCode settings or other editor config files that use JSONC syntax natively.
• Strip comments from JSONC data during a build or preprocessing step before passing to downstream JSON consumers.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Parses JSON files with comments (.jsonc) and converts between .jsonc and .json formats, stripping comments in the process.

Yes, if you need to parse JSONC files and are comfortable with an abandoned package. The code is simple, has no dependencies, and works reliably for its stated purpose on Python 3.5–3.9. However, do not expect bug fixes or updates for newer Python versions. If you require ongoing maintenance, consider an actively maintained alternative.

Install

jsonc-parser on PyPI

pip install jsonc-parser

uv add jsonc-parser

poetry add jsonc-parser

Installing jsonc-parser

Before you install

Installation is straightforward with no runtime dependencies. However, the package is abandoned—last commit was 2022-01-11 and no releases since 2021-05-23. It remains marked Production/Stable and supports Python 3.5 through 3.9, but expect no maintenance for bugs or compatibility issues with newer Python versions.

License in practice

Licensed under MIT (permissive), so you can use, modify, and distribute this package freely with minimal restrictions. No license-based barriers to adoption.

Quickstart

pip install jsonc-parser

from jsonc_parser.parser import JsoncParser

data = JsoncParser.parse_file("config.jsonc")
print(data)

Verify before relying

• Whether the parser correctly handles all valid JSONC syntax (trailing commas, single-line and block comments) in practice.
• Whether the package works reliably with Python versions beyond 3.9 despite being abandoned.

Package facts

Evidence: jsonc_parser-1.1.5-py3-none-any.whl

Tags

More Text Processing packages