JSane is a JSON "parser" that makes attribute accesses easier.
>>> import jsane >>> j = jsane.loads('{"foo": {"bar": {"baz": ["well", "hello", "there"]}}}') >>> j.foo.bar.baz[1].r() u'hello'
Picture the scene. You're a jet-setting developer who is obsessed with going to the gym. One day, a world-class jewel thief kidnaps you and asks you to hack into the super-secure bank server in thirty seconds, while an ultramodel is performing oral sex on you. You hurriedly trace the protocol on the wire, only to discover, to your dismay, that it uses JSON. Nested JSON, with levels and levels of keys.
It's hopeless! You'll never type all those brackets and quotation marks in time! Suddenly, a flash of a memory races through your mind, like some cliche from a badly-written README. You launch the shell and type two words:
import jsane
The day is saved.
Are you frustrated with having to traverse your nested JSON key by key?
root = my_json.get("root") if root is None: return None key1 = root.get("key1") if key1 is None: return None key2 = key1.get("key2") if key2 is None: return None <five more times>
Is your code ruined by pesky all-catching except
blocks?
try: my_json["root"]["key1"]["key2"]["key3"] except: return None
Are you tired of typing all the braces and quotes all the time?
my_json["root"]["key1"[""]][]"]']'"}}""]
Now there's JSane!
Okay seriously, this["thing"]["is"]["no"]["fun"]
. JSane lets you
traverse.json.like.this.r()
. That's it.
Using JSane is simple, at least. It's pretty much a copy of the builtin
json
module.
First of all, install it with pip
or easy_install
:
pip install jsane
Here's an example of its usage:
>>> import jsane >>> j = jsane.loads('{"some": {"json": [1, 2, 3]}}') >>> j.some.json[2].r() 3
Due to Python being a non-insane language, there's a limit to the amount of
crap you can pull with it, so JSane actually returns a Traversable
object on
accesses:
>>> j = jsane.loads('{"foo": {"bar": {"baz": "yes!"}}}') >>> type(j.foo) Traversable
If you want your real object back at the end of the wild attribute ride, call
.r()
:
>>> j.foo.bar.r() {"baz": "yes!"}
If an attribute, item or index along the way does not exist, you'll get an exception. You can get rid of that by specifying a default:
>>> import jsane >>> j = jsane.loads('{"some": "json"}') >>> j.haha_sucka_this_doesnt_exist.r(default="๐ฉ") "๐ฉ"
"But how do I access a key called r
?!", I hear you ask. Worry not, I got you
covered:
>>> j.key["r"].more_key.r()
Confused? Don't name your keys r
, then.
That's about it. I'm not loving the r()
API, so if anyone has any good
recommendations on how I may better fulfil my unholy purpose, I'm changing it on
the spot. No guarantees of stability before version 1, as always. Semver giveth,
and semver taketh away.
Help needed/welcome/etc, mostly with designing the API. Also, if you find this library useless, let me know.
BSD. Or MIT. Whatever's in the LICENSE file. I forget. It's permissive, though, so relax.
It's me, Stavros.
Do you find it ironic that the README for JSane is insane?
No.
Is this library awesome?
Yes.
I hate the .r() thing, is there any way to avoid it?
Did you even read this README?