🈷️
JSONx
Easy JSON wrapper packed with features.
This was made for small discord bots, for big bots you should not use this JSON wrapper.
📥
Usage
Clone this file into your project folder.
Add from db import JSONx to the top of your project.
📄
Docs
db.set(key: str, value, *, pathmagic="")
Sets the key to the value in the JSON.
if the pathmagic kwarg is given, it will spit it by the +'s and make dicts(or use existing ones) until it finishes, then it will set the value to the key in the last dict.
Note that the pathmagic kwarg will override its path if it isnt a dict.
db.get(key: str, *, default=None, pathmagic="")
Returns the value of the key in the json, if the key isn't set in the json, it returns the default kwarg.
if the pathmagic kwarg is given, it will spit it by the +'s and follow the path in it in the JSON data, it will return the default kwarg if the path is empty or has a value that isnt a dict.
db.all()
Returns all the JSON data.
db.rem(key: str, *, pathmagic="")
Removes the key and value pair from the JSON.
Note that this will not do anything if the key isn't set in the JSON or the path is invalid.
if the pathmagic kwarg is given, it will spit it by the +'s and follow the path in it in the JSON data, then it will remove the key and value pair.
db.nuke()
Deletes everything in the JSON.
Use with caution.
📘
Examples
Assume that the
db.jsonfile is empty
db.set()
Normal usage
Code
from db import JSONx
db = JSONx("db.json")
db.set("test", 123)
data = db.all()
print(data)
Output
{'test': 123}
Using with pathmagic kwarg
Code
from db import JSONx
db = JSONx("db.json")
db.set("test", 123, pathmagic="a+b+c")
data = db.all()
print(data)
Output
{'a': {'b': {'c': {'test': 123}}}}
db.get()
Normal usage
Code
from db import JSONx
db = JSONx("db.json")
db.set("test", 123)
data = db.get("test")
print(data)
Output
123
Using without default kwarg
Code
from db import JSONx
db = JSONx("db.json")
data = db.get("test")
print(data)
Output
None
Using with default kwarg
Code
from db import JSONx
db = JSONx("db.json")
data = db.get("test", default=123)
print(data)
Output
123
Using with pathmagic kwarg
Code
from db import JSONx
db = JSONx("db.json")
db.set("test", 123, pathmagic="a+b+c")
data = db.get("test", pathmagic="a+b+c")
print(data)
Output
123
db.rem()
Normal usage
Code
from db import JSONx
db = JSONx("db.json")
db.set("test", 123)
data = db.all()
print(data)
db.rem("test")
data = db.all()
print(data)
Output
{'test': 123}
{}
Using with pathmagic kwarg
Code
from db import JSONx
db = JSONx("db.json")
db.set("test", 123, pathmagic="a+b+c")
data = db.all()
print(data)
db.rem("test", pathmagic="a+b+c")
data = db.all()
print(data)
Output
{'a': {'b': {'c': {'test': 123}}}}
{'a': {'b': {'c': {}}}}
12.6k Dec 30, 2022
16.3k Dec 29, 2022
51 Dec 1, 2021
4 Mar 22, 2022
44 Dec 29, 2022
12 Mar 9, 2022
4 Sep 19, 2022
3 Jan 9, 2022
2 Oct 19, 2022
4 Apr 24, 2022
86 Jan 03, 2023
45 Nov 25, 2022
3 Dec 03, 2022
6 Dec 07, 2021
2 Feb 02, 2022
2 Feb 10, 2022
1.5k Jan 05, 2023
3 Aug 08, 2022
4 Jan 01, 2022
4 Aug 22, 2022
72 Dec 14, 2022
62 Sep 20, 2022
1 Jan 07, 2022
68 Dec 07, 2022
14 Dec 22, 2022