Python bindings for Jsonnet - The data templating language

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for jpab from gravatar.com jpab Avatar for sbarzowski from gravatar.com sbarzowski Avatar for sparkprime from gravatar.com sparkprime

Unverified details

These details have not been verified by PyPI
Project links
Meta
Report project as malware

Project description

Jsonnet - The data templating language

For an introduction to Jsonnet and documentation, visit our website.

This is the Python module for the original C++ implementation of Jsonnet.

Security notes: The C++ implementation is not suitable for processing untrusted inputs without significant external effort to sandbox it. It is not hardened and may have unknown exploitable bugs. It is intended for use to evaluate Jsonnet code that you trust not to be malicious (e.g., code written by you/your organisation). Even ignoring the risk of exploitable bugs in the implementation, the import, importstr, and importbin language constructs can potentially be used to exfiltrate sensitive data unless you take extra steps to restrict these or sandbox the jsonnet interpreter. By default, these constructs can import from any path accessible to the interpreter process.

Using the Jsonnet Python module

You can install from PyPI with uv add jsonnet or with your preferred Python package management tool.

The two main functions in the _jsonnet package are evaluate_file and evaluate_snippet:

  • evaluate_file(filename, ...) reads and evalutes the file at the given path, returning an output as a JSON string.
  • evaluate_snippet(filename, src, ...) evaluates the given source code (src), returning an output as a JSON string. The provided filename is used in error messages.

The functions support keyword arguments:

  • jpathdir: A string (path to a directory) or list of strings (list of directories) to be added to the import search path.
  • ext_vars, ext_codes: Dictionaries of variables to set; these can be used from within the evaluated code through the std.extVar Jsonnet function. ext_codes values are Jsonnet expressions, ext_vars values are provided to Jsonnet as plain strings.
  • tla_vars, tla_codes: Dictionaries of Top-Level arguments. If the provided Jsonnet code to evaluate represents a function, that function is called with these values as (named) arguments.
  • import_callback: A function which will be called when import (or importstr, importbin) expressions are evaluated. See below.
  • native_callbacks: A dictionary of functions which can be called from Jsonnet using the Jsonnet std.native function. See below.

And some configuration for internal implementation details:

  • max_stack
  • max_trace
  • gc_min_objects
  • gc_growth_trigger

import_callback

Usage example:

import _jsonnet

FILES = {
    "the_message.txt": b"hello, world",
}

def import_callback_memfile(dir, rel):
    """Custom import function which only returns files from some in-memory storage.
    
    Args:
      dir: The directory part of the file in which the `import` occurred.
      rel: The path string passed to the `import` expression.
    """
    if rel in FILES:
        # Note that the returned file _content_ should be a bytes value, not a string.
        return rel, FILES[rel]
    raise RuntimeError('File not found')

result = _jsonnet.evaluate_snippet(
    'example',
    'local the_message = importstr "the_message.txt"; ' +
    '{ msg: the_message }',
    import_callback=import_callback_memfile)

assert result == '{\n   "msg": "hello, world"\n}\n';

native_callbacks

Usage example:

import _jsonnet

def concat(a, b):
    return a + b
    
native_callbacks = {
    'concat': (('a', 'b'), concat),
}

result = _jsonnet.evaluate_snippet(
    'example',
    'local concat = std.native("concat"); ' +
    'concat("hello, ", "world")',
    native_callbacks=native_callbacks)

assert result == '"hello, world"\n';

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for jpab from gravatar.com jpab Avatar for sbarzowski from gravatar.com sbarzowski Avatar for sparkprime from gravatar.com sparkprime

Unverified details

These details have not been verified by PyPI
Project links
Meta

Release history Release notifications | RSS feed

This version

0.22.0

0.22.0rc1 pre-release

0.21.0

0.21.0rc2 pre-release

0.21.0rc1 pre-release

0.20.0

0.20.0rc1 pre-release

0.19.1

0.19.0

0.19.0rc1 pre-release

0.18.0

0.18.0rc4 pre-release

0.18.0rc3 pre-release

0.18.0rc2 pre-release

0.18.0rc1 pre-release

0.17.0

0.17.0rc1 pre-release

0.16.0

0.16.0rc1 pre-release

0.15.0

0.15.0rc1 pre-release

0.14.0

0.14.0rc1 pre-release

0.13.0

0.13.0rc1 pre-release

0.12.2rc1 pre-release

0.12.1

0.12.1rc1 pre-release

0.12.0

0.12.0rc1 pre-release

0.11.2

0.11.0

0.11.0rc1 pre-release

0.10.0

0.10.0rc1 pre-release

0.9.5

0.9.5-pre1 pre-release

0.9.4

0.9.4-pre1 pre-release

0.9.3

0.9.3rc1 pre-release

0.9.2

0.9.1

0.9.0

0.8.9

v0.8.7

v0.8.7-pre6 pre-release

v0.8.7-pre5 pre-release

v0.8.7-pre4 pre-release

v0.8.7-pre3 pre-release

v0.8.7-pre2 pre-release

v0.8.7-pre1 pre-release

v0.8.6

v0.8.6-pre1 pre-release

v0.8.6-pre0 pre-release

v0.8.5-pre0 pre-release

v0.8.4

v0.8.4-rc1 pre-release

v0.8.3

v0.8.2

v0.8.1

v0.8.0

v0.7.9

v0.7.8

v0.7.7

v0.7.7-dev0 pre-release

v0.7.6

v0.7.5

Download files

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

Source Distribution

jsonnet-0.22.0.tar.gz (529.7 kB view details)

Uploaded Source

Built Distributions

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

jsonnet-0.22.0-cp314-cp314t-win_amd64.whl (315.1 kB view details)

Uploaded CPython 3.14tWindows x86-64

jsonnet-0.22.0-cp314-cp314t-musllinux_1_2_x86_64.whl (7.5 MB view details)

Uploaded CPython 3.14tmusllinux: musl 1.2+ x86-64

jsonnet-0.22.0-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (6.8 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

jsonnet-0.22.0-cp314-cp314t-macosx_11_0_arm64.whl (444.4 kB view details)

Uploaded CPython 3.14tmacOS 11.0+ ARM64

jsonnet-0.22.0-cp38-abi3-win_amd64.whl (305.5 kB view details)

Uploaded CPython 3.8+Windows x86-64

jsonnet-0.22.0-cp38-abi3-musllinux_1_2_x86_64.whl (7.5 MB view details)

Uploaded CPython 3.8+musllinux: musl 1.2+ x86-64

jsonnet-0.22.0-cp38-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (6.7 MB view details)

Uploaded CPython 3.8+manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

jsonnet-0.22.0-cp38-abi3-macosx_11_0_arm64.whl (443.4 kB view details)

Uploaded CPython 3.8+macOS 11.0+ ARM64

File details

Details for the file jsonnet-0.22.0.tar.gz.

File metadata

  • Download URL: jsonnet-0.22.0.tar.gz
  • Upload date:
  • Size: 529.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for jsonnet-0.22.0.tar.gz
Algorithm Hash digest
SHA256 eae5d9bf23c778baad39390f88c13c03b2090dfb5dfa148d6e217df8c1448258
MD5 75ed8ce173084833f1dab373d000b2e7
BLAKE2b-256 bd90b35ecd8d60c910874a645d153d4084e07950bc746b4e77dbbe54e199d1cf

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonnet-0.22.0.tar.gz:

Publisher: publish-python.yml on google/jsonnet

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

File details

Details for the file jsonnet-0.22.0-cp314-cp314t-win_amd64.whl.

File metadata

  • Download URL: jsonnet-0.22.0-cp314-cp314t-win_amd64.whl
  • Upload date:
  • Size: 315.1 kB
  • Tags: CPython 3.14t, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for jsonnet-0.22.0-cp314-cp314t-win_amd64.whl
Algorithm Hash digest
SHA256 76086435dcfd973252cb3d56b22848009061a44413fa197e15b39decf5400b65
MD5 cbf4823850d8bf9b1e5fa0676f13b24a
BLAKE2b-256 c69129d5e9394766e123b42cd23d351b2945117706534a89060241238888d1b6

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonnet-0.22.0-cp314-cp314t-win_amd64.whl:

Publisher: publish-python.yml on google/jsonnet

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

File details

Details for the file jsonnet-0.22.0-cp314-cp314t-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for jsonnet-0.22.0-cp314-cp314t-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 f13c60dc93d682bdcd63f4db368ea6e7e6e9ef9d2efb5bcd1b8dd78818d4fa7d
MD5 d7f51073b8698055255da5646586b44d
BLAKE2b-256 b4ee071311a7a9cdc20e817a1419c02db509a829282fe6001dddca33ce7a5e97

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonnet-0.22.0-cp314-cp314t-musllinux_1_2_x86_64.whl:

Publisher: publish-python.yml on google/jsonnet

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

File details

Details for the file jsonnet-0.22.0-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for jsonnet-0.22.0-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 f52e8aebcedace2ecc0eeebbd10a18fd3fb2d66ada892acec571a8119eff5087
MD5 f2adf05bd13dc849418a73191087a740
BLAKE2b-256 3e08ff983e8161759cfdd393699cc18d80b0391ecd4b21cb839a705a34644516

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonnet-0.22.0-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish-python.yml on google/jsonnet

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

File details

Details for the file jsonnet-0.22.0-cp314-cp314t-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for jsonnet-0.22.0-cp314-cp314t-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 772d6d9e85b7c296d5197b4b48d7fd1b36043c90b80b670e8a769bd21e2b1f25
MD5 03033b344d1c659e8ec902a11b4b7178
BLAKE2b-256 348da8534c36284a9c58a60d7be3fc499e9ff226a62631c5b63fb0e0a728a4f3

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonnet-0.22.0-cp314-cp314t-macosx_11_0_arm64.whl:

Publisher: publish-python.yml on google/jsonnet

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

File details

Details for the file jsonnet-0.22.0-cp38-abi3-win_amd64.whl.

File metadata

  • Download URL: jsonnet-0.22.0-cp38-abi3-win_amd64.whl
  • Upload date:
  • Size: 305.5 kB
  • Tags: CPython 3.8+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for jsonnet-0.22.0-cp38-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 46df8787b30b001b39d9d551b3d85892d99a699cf3311a63f7bcef080d8a18ff
MD5 f40ebe6553300df4d6bb10701c5dff70
BLAKE2b-256 90b191bd98399359b255b906cfce28d898d96d52348e37502859ccb469c083fa

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonnet-0.22.0-cp38-abi3-win_amd64.whl:

Publisher: publish-python.yml on google/jsonnet

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

File details

Details for the file jsonnet-0.22.0-cp38-abi3-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for jsonnet-0.22.0-cp38-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 aefd2c07038eb9412ae6c46e49b7cfec74f10c53007755b176f7e075e70646f4
MD5 e1aeb2ff58c218a9bb74db3a9d1d1087
BLAKE2b-256 bab73270203be535725bf4b1ded5574f07c5cf530a954e2e1b4760efb5bb1e55

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonnet-0.22.0-cp38-abi3-musllinux_1_2_x86_64.whl:

Publisher: publish-python.yml on google/jsonnet

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

File details

Details for the file jsonnet-0.22.0-cp38-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for jsonnet-0.22.0-cp38-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a1136eefea98f01d654984e868f10faac2749d062464881491ec79ae5c38dc0e
MD5 ac7c89056fc89be2e89a2fb381541b81
BLAKE2b-256 689ab1bb5a0ce21a0fc1ace044d28e69003e63f88b15bc22fcb14ca7e74cf63b

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonnet-0.22.0-cp38-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish-python.yml on google/jsonnet

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

File details

Details for the file jsonnet-0.22.0-cp38-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for jsonnet-0.22.0-cp38-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 42d86e5b2740e31a5e970997d470f517d9073c8a743ddb09ae69069e37529aa6
MD5 b1493f2674811b7f175a529eea64b77f
BLAKE2b-256 48b9d0ead4a4a5fbcee2807127aed41063d7482aa969a41d6d6a7c0194cc2686

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonnet-0.22.0-cp38-abi3-macosx_11_0_arm64.whl:

Publisher: publish-python.yml on google/jsonnet

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 Pingdom Monitoring Sentry Error logging StatusPage Status page