natizon

natizon (short for "native-ZON") is a pure Python parser for ZON (Zig Object Notation). Built on top of Lark, it provides a familiar, json-like interface for decoding ZON strings directly into Python data structures: like dictionaries, lists, strings, booleans, and numbers. It relies strictly on standard Python types, without AST wrappers and so on.

[!NOTE] natizon is slightly more lenient than the official std.zon parser. This flexibility is intentional, making it easier to consume and work with data in Python environments.

Installation

pip install natizon

or:

uv add natizon

Usage

natizon exposes a loads() function that works similarly to the standard library's json.loads().

[!TIP] Looking to parse build.zig.zon?

Check out this Python script for Parsing and validating build.zig.zon to see how to:

  • load Zig 0.16 package metadata using natizon,
  • validate fields with Pydantic,
  • and print a pretty JSON dump using Rich.
from natizon import loads

zon_data = r"""
.{
    .package_name = "network_tools",
    .version = "2.1.0",
    .supported_platforms = .{ .linux, .macos, .windows },
    .dependencies = .{
        .lib_a = .{ .url = "https://server.com/a.tar" },
        .lib_b = .{ .path = "../local_b" }
    }
}
"""

# Parses directly into standard Python dicts and lists
parsed_data = loads(zon_data)

print(parsed_data["package_name"])  # "network_tools"
print(parsed_data["supported_platforms"])  # ["linux", "macos", "windows"]

ZON to Python Type Mapping

When you pass a ZON string to natizon.loads(), the parser automatically converts ZON primitives and structures into their closest Python types.

Here's breakdown:

Primitives and Literals

ZON Type ZON Example Python Type Python Value Notes
Null null NoneType None
Boolean true, false bool True, False
Integer 42, 0x2A int 42
Float 3.14, inf, nan float 3.14 Supports ZON-specific keywords: nan and inf.
Char Literal 'a' int 97 Evaluates to the integer Unicode code point.
String "Hello" str "Hello" Handles standard escapes and Unicode \u{...}.
Multiline String \\Line 1 str "Line 1" Strips the \\ prefix and joins multiple lines with newlines.
Enum Literal .linux str "linux" Parsed simply as strings.
Quoted Identifier .@"complex-key!" str "complex-key!" Slices off the @ prefix and evaluates the string.

Structures and Containers

ZON Type ZON Example Python Type Python Value Notes
Array .{ 1, 2, 3 } list [1, 2, 3] Parses as a tuple if use_tuples=True is set.
Struct .{ .x = 1 } dict {"x": 1} Raises ValueError if duplicate field names are encountered.
Empty Container .{} dict {} Parses using Array rules if empty_mode is set to SEQUENCE.

Configuration

You can customize how natizon handles specific ZON structures:

  • use_tuples (bool, default False): If True, parses ZON arrays (e.g., .{ 1, 2, 3 }) as Python tuples instead of lists.
  • empty_mode (EmptyContainerMode, default EmptyContainerMode.DICT): Controls whether an empty container .{} becomes an empty dictionary ({}) or an empty sequence ([] / ()).
from natizon import loads, EmptyContainerMode

data = loads(".{}", use_tuples=True, empty_mode=EmptyContainerMode.SEQUENCE)
print(data)  # Output: ()

License

This project is licensed under the Apache License 2.0. See the LICENSES directory for the full license text.

Project links

Data verified by PyPI on Jun 21, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.4.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for BratishkaErik from gravatar.com BratishkaErik

Credits

Author: Eric Joldasov

GitHub Statistics

Data verified by PyPI on Jun 21, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.12

Tags

zig ZON Zig Object Notation parser

Classifiers

Report project as malware

Download files

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

Source Distribution

natizon-0.2.1.tar.gz (15.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

natizon-0.2.1-py3-none-any.whl (17.0 kB view details)

Uploaded Python 3

File details

Details for the file natizon-0.2.1.tar.gz.

File metadata

  • Download URL: natizon-0.2.1.tar.gz
  • Upload date:
  • Size: 15.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.23 {"installer":{"name":"uv","version":"0.11.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for natizon-0.2.1.tar.gz
Algorithm Hash digest
SHA256 488b39275bf1258ec947412aa52d4d9129c4ebe38a8331979428e7ad2cbd3577
MD5 e1baf8e77a116bb16b93ff4f9b9c1d42
BLAKE2b-256 6125e22263a0202d813bdf325284b343eed1fff0813522c357533817e7db65ca

See more details on using hashes here.

Provenance

The following attestation bundles were made for natizon-0.2.1.tar.gz:

Publisher: release.yml on BratishkaErik/natizon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file natizon-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: natizon-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 17.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.23 {"installer":{"name":"uv","version":"0.11.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for natizon-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c792a465b6dbb8639927be014f9d0234d2cec4b8e105ce50b26c8d960dde8cf7
MD5 a32d40a4413b572a386dc0a802d002dc
BLAKE2b-256 7c9d11c5cef90046013585edb9811c55fd0a5e5cceb46e3d648da7280ad037f9

See more details on using hashes here.

Provenance

The following attestation bundles were made for natizon-0.2.1-py3-none-any.whl:

Publisher: release.yml on BratishkaErik/natizon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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