Command Line Tool to Work with Transit Format
- Free software: ISC license
- Documentation: https://transito.readthedocs.org.
- convert to and form json, edn, transit
- read content from stdin or files
$ transito -h
usage: transito [-h] {t2j,j2t,e2t,t2e,http} ...
Transit CLI
positional arguments:
{t2j,j2t,e2t,t2e,http}
t2j convert transit to json
j2t convert json to transit
e2t convert edn to transit
t2e convert transit to edn
http make http requests with transit data
optional arguments:
-h, --help show this help message and exit
Convert Transit to JSON from a file:
$ transito t2j examples/ex1.transit
[":keyword", "~lala", 1, 1.2, true, null, [], ["hi", "a"]]
Convert Transit to JSON from stdin:
$ transito t2j -
["~#list",["~:keyword","~$lala",1,1.2,true,null,[],["hi",["~#char","a"]]]]
[":keyword", "~lala", 1, 1.2, true, null, [], ["hi", "a"]]
Note
The first line is the input, then I pressed Enter and Ctrl+D
Piping from another command:
$ echo '["~#list",["~:keyword","~$lala",1,1.2,true,null,[],["hi",["~#char","a"]]]]' | transito t2j -
[":keyword", "~lala", 1, 1.2, true, null, [], ["hi", "a"]]
Same for Edn:
$ transito t2e examples/ex1.transit
(keyword lala 1 1.2 true nil [] ["hi" \a])
$ echo '["~#list",["~:keyword","~$lala",1,1.2,true,null,[],["hi",["~#char","a"]]]]' | transito t2e -
(keyword lala 1 1.2 true nil [] ["hi" \a])
$ transito t2e -
["~#list",["~:keyword","~$lala",1,1.2,true,null,[],["hi",["~#char","a"]]]]
(keyword lala 1 1.2 true nil [] ["hi" \a])
you should get the idea, some with transit as output just in case:
$ transito e2t -
(keyword lala 1 1.2 true nil [] ["hi" \a])
["~#list",["~$keyword","~$lala",1,1.2,true,null,[],["hi",["~#char","a"]]]]
$ transito t2j -
["~#list",["~$keyword","~$lala",1,1.2,true,null,[],["hi",["~#char","a"]]]]
["~keyword", "~lala", 1, 1.2, true, null, [], ["hi", "a"]]
Note
to json conversions are lossy, this means that in order to not crash when serializing keywords, symbols and chars we do a lossy serialization, chars are strings, keywords are strings starting with : and symbols are strings starting with ~.
The idea of this translation is to provide a way to view the edn or transit as json and shouldn't be used to send this data to a production system.
You an make an http request that supports transit, json or edn but writting and reading the request and response in a more readable way, for example, make a request writing edn that will be transformed to transit before being sent, the response will be transformed to edn if possible to make it more readable:
$ echo '(increment {:value 20})' | transito http post http://localhost:8080/action e2t -
Status: 200
Content-Type: application/transit+json
Content-Length: 28
{:value [:count]}
You may ask, isn't it complected? yes, yes it is.
Tools used in rendering this package: