Re: CLI libraries

2015-06-11 Thread aj...@virginia.edu
In the PR I submitted a day or two ago, I added a DEPRECATED: Please use riot 
instead message to the help of rdfcat, but I didn't have it emit that message 
to stderr on all runs. That seems like a good move to me. I'll add that, and we 
can then decide whether to go all the way to having that be the _only_ think 
rdfcat does in Jena 3.

---
A. Soroka
The University of Virginia Library

On Jun 10, 2015, at 6:39 AM, Andy Seaborne a...@apache.org wrote:

 On 09/06/15 17:11, aj...@virginia.edu wrote:
 I don't see any actual references in the documentation to rdfcat. Perhaps it 
 can be deprecated?
 
 Interesting question - how to deprecate a command line tool?
 
 Print a This is deprecated message to stderr?
 
 As a Jena3 step we can be faster with migration.
 jena.rdfcat = only a message saying use riot?
 
 
 But first - is riot a good enough replacement?  Does it need more 
 documentation? (probabaly yes as facilities got added incrementally : 
 --formatted=FORMAT needs to be the default output style and streaming 
 require intervention).
 
   Andy
 
 
 ---
 A. Soroka
 The University of Virginia Library
 
 On Jun 8, 2015, at 11:24 AM, Andy Seaborne a...@apache.org wrote:
 
 People use rdfcat :-( but nowadays riot is better IMO (scale, speed, 
 arguments, ..) but I'm not unbiased.
 
 



Re: CLI libraries

2015-06-10 Thread Andy Seaborne

On 09/06/15 17:11, aj...@virginia.edu wrote:

I don't see any actual references in the documentation to rdfcat. Perhaps it 
can be deprecated?


Interesting question - how to deprecate a command line tool?

Print a This is deprecated message to stderr?

As a Jena3 step we can be faster with migration.
jena.rdfcat = only a message saying use riot?


But first - is riot a good enough replacement?  Does it need more 
documentation? (probabaly yes as facilities got added incrementally : 
--formatted=FORMAT needs to be the default output style and streaming 
require intervention).


Andy



---
A. Soroka
The University of Virginia Library

On Jun 8, 2015, at 11:24 AM, Andy Seaborne a...@apache.org wrote:


People use rdfcat :-( but nowadays riot is better IMO (scale, speed, arguments, 
..) but I'm not unbiased.






Re: CLI libraries

2015-06-09 Thread aj...@virginia.edu
I don't see any actual references in the documentation to rdfcat. Perhaps it 
can be deprecated?

---
A. Soroka
The University of Virginia Library

On Jun 8, 2015, at 11:24 AM, Andy Seaborne a...@apache.org wrote:

 People use rdfcat :-( but nowadays riot is better IMO (scale, speed, 
 arguments, ..) but I'm not unbiased.



Re: CLI libraries

2015-06-08 Thread Andy Seaborne

On 08/06/15 15:47, aj...@virginia.edu wrote:

In examining and discussing
https://issues.apache.org/jira/browse/JENA-959, it seems to me (a
Jena newbie!) that Jena's CLI action is built up in jena-core, in
package jena.cmdline.

If that is correct, and Jena has its own CLI code, wouldn't it be
better to replace this with a modern CLI library like that provided
by Apache Commons? Does that sound like a ticket?


arq.cmdline.CmdLineArgs

The whole cmd support does more than Apache Commons CLI.

Around command line processing is support for grouping and reuse across 
commands, and an execution model.


There are a lot of commands -- Apache Commons CLI would also cause 
chnages in syntax.   e.g. arq.cmd does not treat -- and - differently; 
combined POSIX like options aren't supported.


(jena.cmdline looks like some partial copy to get older development 
working).


A useful goal might be to have a module jena-cmd which is after SDB, 
TDB and the rest with the set of command line tools we deed to be the 
public set of commands (some of the old stuff needs retiring or at least 
incompatibly brought into the general style - e.g. rdfcompare).


People use rdfcat :-( but nowadays riot is better IMO (scale, speed, 
arguments, ..) but I'm not unbiased.


A useful but bounded stpe might be to take arq.cmd* to 
jena-base/jena.cmd* and drop jena-core/jena.cmdline (not tried this 
so there maybe a forgotten dependency).



Andy



--- A. Soroka The University of Virginia Library





CLI libraries

2015-06-08 Thread aj...@virginia.edu
In examining and discussing https://issues.apache.org/jira/browse/JENA-959, it 
seems to me (a Jena newbie!) that Jena's CLI action is built up in jena-core, 
in package jena.cmdline.

If that is correct, and Jena has its own CLI code, wouldn't it be better to 
replace this with a modern CLI library like that provided by Apache Commons? 
Does that sound like a ticket?

---
A. Soroka
The University of Virginia Library



Re: CLI libraries

2015-06-08 Thread aj...@virginia.edu
Okay, that makes sense.

Is the larger move (the construction of 'jena-cmd') worth an epic in Jira? With 
the smaller (take arq.cmd* to jena-base/jena.cmd* and drop 
jena-core/jena.cmdline) as a first story therein?

---
A. Soroka
The University of Virginia Library

On Jun 8, 2015, at 11:24 AM, Andy Seaborne a...@apache.org wrote:

 On 08/06/15 15:47, aj...@virginia.edu wrote:
 In examining and discussing
 https://issues.apache.org/jira/browse/JENA-959, it seems to me (a
 Jena newbie!) that Jena's CLI action is built up in jena-core, in
 package jena.cmdline.
 
 If that is correct, and Jena has its own CLI code, wouldn't it be
 better to replace this with a modern CLI library like that provided
 by Apache Commons? Does that sound like a ticket?
 
 arq.cmdline.CmdLineArgs
 
 The whole cmd support does more than Apache Commons CLI.
 
 Around command line processing is support for grouping and reuse across 
 commands, and an execution model.
 
 There are a lot of commands -- Apache Commons CLI would also cause chnages in 
 syntax.   e.g. arq.cmd does not treat -- and - differently; combined POSIX 
 like options aren't supported.
 
 (jena.cmdline looks like some partial copy to get older development working).
 
 A useful goal might be to have a module jena-cmd which is after SDB, TDB 
 and the rest with the set of command line tools we deed to be the public set 
 of commands (some of the old stuff needs retiring or at least incompatibly 
 brought into the general style - e.g. rdfcompare).
 
 People use rdfcat :-( but nowadays riot is better IMO (scale, speed, 
 arguments, ..) but I'm not unbiased.
 
 A useful but bounded stpe might be to take arq.cmd* to jena-base/jena.cmd* 
 and drop jena-core/jena.cmdline (not tried this so there maybe a forgotten 
 dependency).
 
 
   Andy
 
 
 --- A. Soroka The University of Virginia Library