Bug#902267: ITP: jiq -- jid on jq
June 24, 2018 11:34 PM, "Guus Sliepen" <guus@debian.org> wrote:
> On Sun, Jun 24, 2018 at 07:46:06PM +0000, Zenon Mousmoulas wrote:
>
>> I posted an updated ITP (should it be a new submission?) but let me try again, also correcting the
>> license (s/MIT/Expat/). As for digger, I am afraid that is part of the acronym chosen by (the
>> forked) upstream.
>>
>> Package: wnpp
>> Severity: wishlist
>> Owner: Zenon Mousmoulas <zmousm@noc.grnet.gr>
>>
>> * Package name : jiq
>> Version : 0.6.0+git20180621.a79e8b2-1
>> Upstream Author : Giovanni T. Parra
>> * URL : https://github.com/fiatjaf/jiq
>> * License : Expat
>> Programming Lang: Go
>> Description : json incremental digger (jid) with jq
>
> Even though the name jid stands for json incremental digger, you don't
> need to include that in the description. I'd certainly not use it in the
> short description, but mention it in the long description so one can
> still search for "incremental digger" and find this package. Also, the
> acronym JSON should be spelled with all caps.
>
>> jiq is a fork of jid (https://github.com/simeji/jid) using
>> jq (https://stedolan.github.io/jq) under the hood.
>
> I would not mention these facts as the first thing in the description.
>
>> It is a command line tool that can be used to interactively drill
>> down on json input using jq filtering queries.
>
> That's useful information. I'd still try to reword "drill down".
>
>> jiq calls jq and requires that it can be found in PATH.
>
> This is useless information. Your package should have a Depends: jq, so
> this will be taken care of automatically when you install your package.
Right. It was just another piece of upstream readme I didn't consider stripping out.
> Just like you won't see "foo uses the GNU standard C library and
> requires that it be found in the standard system library paths or in
> LD_LIBRARY_PATH".
>
> Ok, it's easy to criticize, so let me try to make a description myself,
> and then you can decide if you want to pick some things from it:
Fine, thanks.
> Description: interactive JSON query tool using jq expressions
> jiq is a command line tool that parses a JSON document and allows you
> to interactively query and filter it using jq expressions. jiq also
> provides suggestions and tab completion.
I will just exclude this last statement about tab completion, because I am afraid it is not true.
> .
> jiq is a fork of jid, but fully supports the jq language (see
> https://stedolan.github.io/jq).
So, per your suggestions, here is the ITP:
Package: wnpp
Severity: wishlist
Owner: Zenon Mousmoulas <zmousm@noc.grnet.gr>
* Package name : jiq
Version : 0.6.0+git20180621.a79e8b2-1
Upstream Author : Giovanni T. Parra
* URL : https://github.com/fiatjaf/jiq
* License : Expat
Programming Lang: Go
Description : interactive JSON query tool using jq expressions
jiq is a command line tool that parses a JSON document and allows you
to interactively query and filter it using jq expressions.
.
jiq is a fork of jid, which rather supports the jq language (see
https://stedolan.github.io/jq).
Reply to: