mojangson 0.2.1

Python Mojangson parser

mojangson

A small Python library for parsing, stringifying, simplifying, and normalizing Mojangson - mojang's variant of json.

Installation

pip install mojangson

API

parse - Parse Mojangson text into a typed dict representation.

stringify - Convert a typed Mojangson dict back to a Mojangson string.

simplify - Simplify a typed Mojangson dict into a regular Python dict/list/primitive values, stripping Minecraft-specific type suffixes.

normalize - Normalize Mojangson text by parsing and then stringifying it - ensures consistent formatting and ordering.

Usage

from mojangson import parse, stringify, simplify, normalize

mojangson_string = '{key:value}'

mojangson_parsed = parse(mojangson_string)
print(mojangson_parsed)
# {'type': 'compound', 'value': {'key': {'type': 'string', 'value': 'value'}}}

print(simplify(mojangson_parsed))
# {'key': 'value'}

mojangson_stringified = stringify(mojangson_parsed)
print(mojangson_stringified)
# {key:value}

print(normalize(mojangson_string) == mojangson_stringified)
# True

CLI

Syntax:

mojangson <command> [input] [-f FILE] [-o FILE]

Arguments:

Argument	Description
input	Mojangson string, if not using -f/--file
-f, --file	Path to an input file containing a Mojangson string
-o, --output	Path to an output file. If not provided, output is printed to stdout

Examples:

mojangson parse "{a:b}"
# {'type': 'compound', 'value': {'a': {'type': 'string', 'value': 'b'}}}

mojangson simplify "{'type': 'compound', 'value': {'a': {'type': 'string', 'value': 'b'}}}" -o output.txt
# writes {'a': 'b'} to output.txt

mojangson stringify -f input.json
# reads from input.json