---
id: jsonc-parser
version: "1.1.5"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# jsonc-parser — A lightweight, native tool for parsing .jsonc files

License: permissive · Maintenance: abandoned · Downloads: 283.3K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 283.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

parse json with comments, jsonc parser, json comments support, convert jsonc to json, strip json comments, jsonc file parsing, json comment removal, json-parsing, config-files, comment-stripping

[View on SkillFed](https://skillfed.io/packages/jsonc-parser) · [View on PyPI](https://pypi.org/project/jsonc-parser/)