Skip to main content

A Python implementation of the JSON5 data format.

Project description

pyjson5

A Python implementation of the JSON5 data format.

JSON5 extends the JSON data interchange format to make it slightly more usable as a configuration language:

  • JavaScript-style comments (both single and multi-line) are legal.

  • Object keys may be unquoted if they are legal ECMAScript identifiers

  • Objects and arrays may end with trailing commas.

  • Strings can be single-quoted, and multi-line string literals are allowed.

There are a few other more minor extensions to JSON; see the above page for the full details.

This project implements a reader and writer implementation for Python; where possible, it mirrors the standard Python JSON API package for ease of use.

There is one notable difference from the JSON api: the load() and loads() methods support optionally checking for (and rejecting) duplicate object keys; pass allow_duplicate_keys=False to do so (duplicates are allowed by default).

This is an early release. It has been reasonably well-tested, but it is SLOW. It can be 1000-6000x slower than the C-optimized JSON module, and is 200x slower (or more) than the pure Python JSON module.

Known issues

  • Did I mention that it is SLOW?

  • The implementation follows Python3's json implementation where possible. This means that the encoding method to dump() is ignored, and unicode strings are always returned.

  • The cls keyword argument that json.load()/json.loads() accepts to specify a custom subclass of JSONDecoder is not and will not be supported, because this implementation uses a completely different approach to parsing strings and doesn't have anything like the JSONDecoder class.

  • The cls keyword argument that json.dump()/json.dumps() accepts is also not supported, for consistency with json5.load(). The default keyword is supported, though, and might be able to serve as a workaround.

Version History / Release Notes

  • v0.9.0 (2020-01-30)

    • GitHub issue #29: Fix an issue where objects keys that started with a reserved word were incorrectly quoted.
    • GitHub issue #30: Fix an issue where dumps() incorrectly thought a data structure was cyclic in some cases.
    • GitHub issue #32: Allow for non-string keys in dicts passed to dump()/dumps(). Add an allow_duplicate_keys=False to prevent possible ill-formed JSON that might result.
  • v0.8.5 (2019-07-04)

    • GitHub issue #25: Add LICENSE and README.md to the dist.
    • GitHub issue #26: Fix printing of empty arrays and objects with indentation, fix misreporting of the position on parse failures in some cases.
  • v0.8.4 (2019-06-11)

    • Updated the version history, too.
  • v0.8.3 (2019-06-11)

    • Tweaked the README, bumped the version, forgot to update the version history :).
  • v0.8.2 (2019-06-11)

    • Actually bump the version properly, to 0.8.2.
  • v0.8.1 (2019-06-11)

    • Fix bug in setup.py that messed up the description. Unfortunately, I forgot to bump the version for this, so this also identifies as 0.8.0.
  • v0.8.0 (2019-06-11)

    • Add allow_duplicate_keys=True as a default argument to json5.load()/json5.loads(). If you set the key to False, duplicate keys in a single dict will be rejected. The default is set to True for compatibility with json.load(), earlier versions of json5, and because it's simply not clear if people would want duplicate checking enabled by default.
  • v0.7 (2019-03-31)

    • Changes dump()/dumps() to not quote object keys by default if they are legal identifiers. Passing quote_keys=True will turn that off and always quote object keys.
    • Changes dump()/dumps() to insert trailing commas after the last item in an array or an object if the object is printed across multiple lines (i.e., if indent is not None). Passing trailing_commas=False will turn that off.
    • The json5.tool command line tool now supports the --indent, --[no-]quote-keys, and --[no-]trailing-commas flags to allow for more control over the output, in addition to the existing --as-json flag.
    • The json5.tool command line tool no longer supports reading from multiple files, you can now only read from a single file or from standard input.
    • The implementation no longer relies on the standard json module for anything. The output should still match the json module (except as noted above) and discrepancies should be reported as bugs.
  • v0.6.2 (2019-03-08)

  • v0.6.1 (2018-05-22)

    • Cleaned up a couple minor nits in the package.
  • v0.6.0 (2017-11-28)

    • First implementation that attempted to implement 100% of the spec.
  • v0.5.0 (2017-09-04)

    • First implementation that supported the full set of kwargs that the json module supports.

Project details


Download files

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

Source Distribution

json5-0.9.0.tar.gz (25.0 kB view details)

Uploaded Source

Built Distribution

json5-0.9.0-py2.py3-none-any.whl (27.2 kB view details)

Uploaded Python 2Python 3

File details

Details for the file json5-0.9.0.tar.gz.

File metadata

  • Download URL: json5-0.9.0.tar.gz
  • Upload date:
  • Size: 25.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.2

File hashes

Hashes for json5-0.9.0.tar.gz
Algorithm Hash digest
SHA256 62a7a36f5f9806108d39bfc59d4458e2a083762a2fc15fd3c7828c72502fd702
MD5 063de829a060b3d58d6f96e5bfc7df69
BLAKE2b-256 96fb81f0ea3722a5cc379de7d1091e29a5eb6101c97c5040985634eabbe74ec5

See more details on using hashes here.

File details

Details for the file json5-0.9.0-py2.py3-none-any.whl.

File metadata

  • Download URL: json5-0.9.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 27.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.2

File hashes

Hashes for json5-0.9.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 f2dd81b3de344143144532804171ff8e7da93cd57af6b56d4d4afa859f8c77ff
MD5 52c2906c9d921575ddd29816dde9e7e2
BLAKE2b-256 47affbcf5fa455bafd33bb64ab1b7f65e542f57012b8cc5ab3e3ff2b6128cd9d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page