Skip to main content

JackSON

Have you ever used JSON as your config? Have you keep secrets in config as plain text, that you dont want to? Then this is the right tool for you.
JackSON is the simple and flexible file extension of JSON file types written in python (in less than 50 lines of code), this extension allows the users to keep their secrets in environment variables and pass the reference to those environment variables into the JSON file(jackson). The secrets in the environment variables will be read securely in to the in memory dict.

The problem that it solves:

  • Retrive secrest from env variables.
  • Retrive secrets from remote/servers(HSMs).

How to JackSON

JackSON is exported as python package. You can install it via pip.
pip install --user jackson

export foo=10
export bar=100

Example JackSON config file.

{
    "_comment1": "Value from foo env variable",
    "key1": "env.foo",
    "_comment2": "Value from bar env variable",
    "key2": "env.bar",
    "_comment3": "Value from python module",
    "key3": "!a.b",
    "_comment4": "key/value pair similar to json",
    "key4": "value4"
}

Inside the code.

import jackson
import json    # For converting JackSON --> JSON
d = json.load(jackson.File.open("./config.jackson"))
print(d)

And this is how it looks.

{   
    "key4": "value4",
    "key3": "reached",
    "key2": "100",
    "key1": "10",
    "_comment4": "key/value pair similar to json",
    "_comment3": "Value from python module",
    "_comment2": "Value from bar env variable",
    "_comment1": "Value from foo env variable"
}

Release files for JackSON 0.1.4

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

Source distribution (sdist)

Source distribution for JackSON 0.1.4
File Size Uploaded
JackSON-0.1.4.tar.gz 3.5 kB Details

Release files / JackSON-0.1.4.tar.gz

Download URL JackSON-0.1.4.tar.gz
Size 3.5 kB
Tags Source
SHA-256 checksum
How to use checksums
69e01d2946e58a917d7d9ebbcc1941eab128d75a776d5086dd880c40e1da9fdd
BLAKE2b-256 checksum
How to use checksums
a8e0271c236fd9a8157ccdbf1aa0e628e36041e7ca17bb319e19b010723749e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.4 This release

1 release file

0.1.3

1 release file

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page