literalizer

literalizer converts JSON, JSON5, YAML, and TOML data structures to native language literal syntax.

Supported languages

Ada, Bash, C, C#, C++, Clojure, COBOL, Common Lisp, Crystal, D, Dart, Dhall, Elixir, Elm, Erlang, F#, Forth, Fortran, Gleam, Go, Groovy, Haskell, Haxe, HCL, Java, JavaScript, JSON5, Jsonnet, Julia, Kotlin, Lua, MATLAB, Mojo, Nim, Nix, Norg, Objective-C, OCaml, Occam-pi, Odin, Perl, PHP, PowerShell, PureScript, Python, R, Racket, Raku, Roc, Ruby, Rust, Scala, Scheme, SML, Swift, SystemVerilog, Tcl, TOML, TypeScript, V, Visual Basic, Wren, YAML, Zig.

Installation

Requires Python 3.12+.

pip install literalizer

Usage

Pass your data, its format, and a target language:

"""Minimal example of using literalizer."""

from literalizer import InputFormat, literalize
from literalizer.languages import Python

result = literalize(
    source='{"x": 1}',
    input_format=InputFormat.JSON,
    language=Python(),
)
# result.code:
# {
#     "x": 1,
# }

Configure the language to control how individual data types are rendered. Comments in the source are preserved using the target language’s comment syntax:

"""Layering format options on top of the minimal call."""

from literalizer import InputFormat, literalize
from literalizer.languages import Go

yaml_config = """\
# Server configuration
host: localhost  # default host
port: 8080
released: 2026-06-02
"""
result = literalize(
    source=yaml_config,
    input_format=InputFormat.YAML,
    language=Go(date_format=Go.date_formats.ISO),
)
# result.code (backslash-t denotes a tab):
# map[string]any{
# \t// Server configuration
# \t"host": "localhost",  // default host
# \t"port": 8080,
# \t"released": "2026-06-02",
# }

Use cases

Generate test fixtures from JSON, JSON5, YAML, or TOML samples.
Generate multi-language request/response examples for API docs (see guide).
Generate multi-language function call examples from data (see guide).
Create type-safe literal data from JSON, JSON5, YAML, or TOML config files.

CLI

A command-line interface is available at literalizer-cli.

Sphinx extension

A Sphinx extension is available at sphinx-literalizer.

Full documentation

See the full documentation for more information including how to contribute.

Metadata

Release files for literalizer 2026.8.29.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for literalizer 2026.8.29.1
File	Size	Uploaded
literalizer-2026.8.29.1.tar.gz	4.5 MB	Aug 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for literalizer 2026.8.29.1
File	Interpreter	ABI	Platform	Reset
literalizer-2026.8.29.1-py3-none-any.whl 1.0 MB Aug 29, 2026	Python 3	none	any	Details

Total release size: 5.5 MB

Release files / literalizer-2026.8.29.1.tar.gz

Download URL	literalizer-2026.8.29.1.tar.gz
Size	4.5 MB
Tags	Source
SHA-256 checksum How to use checksums	`e9da80dc2b24d23f4e643125d6e20e713277caa204077e6b5dfe89449d54ea9a`
BLAKE2b-256 checksum How to use checksums	`5cb5b1b88e74ad1a52d8be0d69264ab615525bd5714c3a958bd47efe0ea19f91`
Upload date	Aug 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/adamtheturtle/literalizer
Publishing commit: github.com/adamtheturtle/literalizer/tree/b254ec79b21cb5b76a8889e647c7388f11c2474f

Workflow

Publishing configuration: github.com/adamtheturtle/literalizer/blob/b254ec79b21cb5b76a8889e647c7388f11c2474f/.github/workflows/release.yml
Publishing logs: github.com/adamtheturtle/literalizer/actions/runs/33242204232/attempts/1

Artifact

Subject: literalizer-2026.8.29.1.tar.gz
SHA-256 checksum: e9da80dc2b24d23f4e643125d6e20e713277caa204077e6b5dfe89449d54ea9a Verifying attestations

Release files / literalizer-2026.8.29.1-py3-none-any.whl

Download URL	literalizer-2026.8.29.1-py3-none-any.whl
Size	1.0 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`cf76da3c7efaabec0d350c39ed334a50110f59f41e89687cacd126f5bf268fc8`
BLAKE2b-256 checksum How to use checksums	`2f32aa3079b226dc78716ad54fc7f96089ed75e4428579c706faa9d8db7bf518`
Upload date	Aug 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/adamtheturtle/literalizer
Publishing commit: github.com/adamtheturtle/literalizer/tree/b254ec79b21cb5b76a8889e647c7388f11c2474f

Workflow

Publishing configuration: github.com/adamtheturtle/literalizer/blob/b254ec79b21cb5b76a8889e647c7388f11c2474f/.github/workflows/release.yml
Publishing logs: github.com/adamtheturtle/literalizer/actions/runs/33242204232/attempts/1

Artifact

Subject: literalizer-2026.8.29.1-py3-none-any.whl
SHA-256 checksum: cf76da3c7efaabec0d350c39ed334a50110f59f41e89687cacd126f5bf268fc8 Verifying attestations