Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A fast, simple parser for terribly broken JSON

Project description

JSOM - not quite JSON, but close enough

jsom is a simple and quick Python 3.7+ parser for terribly broken JSON.

Installation

$ pip install jsom

Usage

jsom works like this:

>>> import jsom
>>> broken_json = "{\"foo\": {bar: 1, 'baz':,}, bar: 1, baz: [1,2,3,],}")
>>> jsom.JsomParser(ignore_warnings=jsom.ALL_WARNINGS).loads(broken_json)
{'foo': {'bar': 1, 'baz': None}, 'bar': 1, 'baz': [1, 2, 3]}

jsom happily gobbles up the following:

  • unquoted keys and values
  • single-quoted strings
  • trailing commas
  • empty values in objects

By default, it will warn you whenever it sees one of those, but still parse it.

It also doesn't give a shit about:

  • Newlines in strings
  • Stray backslashes

You will never get warned about those. ¯\_(ツ)_/¯

Warnings are annoying, though, and to make matters worse, they slow the parser down - so just pass in the list of warnings you want jsom to be quiet about in the ignore_warnings parameter:

parser = JsomParser(
    ignore_warnings=[jsom.SINGLE_QUOTED_STRING, jsom.EMPTY_OBJECT_VALUE]
)

Or, if you prefer, just tell it to shut up completely, by passing in jsom.ALL_WARNINGS.

LICENSE

jsom is distributed under the terms of the Do What The Fuck You Want To Public License (WTFPL):

        DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE 
                    Version 2, December 2004 

 Copyright (C) 2004 Sam Hocevar <sam@hocevar.net> 

 Everyone is permitted to copy and distribute verbatim or modified 
 copies of this license document, and changing it is allowed as long 
 as the name is changed. 

            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE 
   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 

  0. You just DO WHAT THE FUCK YOU WANT TO.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for jsom, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size jsom-0.0.5-py3-none-any.whl (8.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size jsom-0.0.5.tar.gz (7.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page