In other exciting Pygrister news (ehm), I’m happy to report that, in the end, I decided to add a cli tool on top of the Pygrister library.
To be clear, it’s not that I find anything wrong in @Heloise_Ouvry’s grist-ctl tool, quite the contrary. But I thought that a cli tool would be the ideal complement to Pygrister, and a good exercise in code design. Plus, in Python you already have some very powerful library to create cli tools, so I was easily tempted.
Hence, I present to you – Gry!, the command line tool to query the Grist api, powered by Pygrister.
Basically, Gry is a new gry shell command (3 characters, as per tradition) that you will get installed with Pygrister.
Try gry --help to explore the available Gry subcommands, or just read the docs.
You can use Gry to interact directly with the Grist apis, with no prior Python knowledge needed. But it’s also easy to fire up a “Gry-powered” Python shell (just try gry python or why not, gry python --idle!), with Pygrister/Gry already preloaded and configured for you.
Gry will output nice, humand readable data, but the original json response is always available (just add a -vv option to any command).
Right now, Gry is still rough at the edges (colors, consistency, little missing details) and very little tested, but otherwise usable.
Gry is not yet part of the Pygrister released on PyPI, so you will have to install it directly from the GitHub repo. At some point, I could package it as a standalone executable, but it’s a little premature now.
Have fun, and thanks for reporting bugs/issues!