diff options
| author | David Robillard <d@drobilla.net> | 2023-03-31 17:17:41 -0400 |
|---|---|---|
| committer | David Robillard <d@drobilla.net> | 2023-12-02 18:49:08 -0500 |
| commit | b5956c4dc6b065d664908104d5fc6752a87e3364 (patch) | |
| tree | 6be1fa515891e759092bb9bea082e27c78bfb6de /doc/man/serd-pipe.1 | |
| parent | 439d6ec3d6dfbea74334beace790f500e61c9b7d (diff) | |
| download | serd-b5956c4dc6b065d664908104d5fc6752a87e3364.tar.gz serd-b5956c4dc6b065d664908104d5fc6752a87e3364.tar.bz2 serd-b5956c4dc6b065d664908104d5fc6752a87e3364.zip | |
Add model and serd-sort utility
With all the new functionality, the complexity of the serd-pipe command-line
interface is starting to push the limits of available flags. So, instead of
grafting on further options to control a model, this commit adds a new tool,
serd-sort, which acts somewhat like a stripped-down serd-pipe that stores
statements in a model in memory.
This keeps the complexity (including the user-facing complexity) of any one
tool down, since other more focused tools can be used for streaming tasks in a
pipeline.
In other words, abandon Swissarmyknifeism, take a page from the Unix
philosophy, and try to expose the model functionality to the command-line in a
dedicated focused tool. The model implementation is tested by using this tool
to run a subset of the usual test suites, and a special suite to test statement
sorting.
Diffstat (limited to 'doc/man/serd-pipe.1')
| -rw-r--r-- | doc/man/serd-pipe.1 | 28 |
1 files changed, 25 insertions, 3 deletions
diff --git a/doc/man/serd-pipe.1 b/doc/man/serd-pipe.1 index 2d6534ae..a2ce86eb 100644 --- a/doc/man/serd-pipe.1 +++ b/doc/man/serd-pipe.1 @@ -8,13 +8,14 @@ .Nd read and write RDF data .Sh SYNOPSIS .Nm serd-pipe -.Op Fl CVhq +.Op Fl CVh .Op Fl B Ar base .Op Fl I Ar syntax .Op Fl O Ar syntax .Op Fl R Ar root .Op Fl b Ar bytes .Op Fl k Ar bytes +.Op Fl l Ar level .Op Fl o Ar filename .Op Fl s Ar string .Op Ar input ... @@ -224,12 +225,31 @@ Parsing is performed using a pre-allocated stack for performance and security re By default, the stack is 1 MiB, which should be sufficient for most data. This can be increased to support unusually structured data and huge literals, or decreased to reduce overall memory requirements and reduce startup time. +.It Fl l Ar level +Maximum log level, or (equivalently) minimum log priority. +Only messages with at least the priority of this level will be displayed. +The +.Ar level +is as in +.Xr syslog 2 , +either a number from +.Cm 0 +to +.Cm 7, +or +.Cm emerg , +.Cm alert , +.Cm crit , +.Cm err , +.Cm warn , +.Cm note , +.Cm info , +or +.Cm debug . .It Fl o Ar filename Write output to the given .Ar filename instead of stdout. -.It Fl q -Suppress all output except data. .It Fl s Ar string Parse .Ar string @@ -281,6 +301,8 @@ exits with a status of 0, or non-zero if an error occurred. .It .Xr serd-filter 1 .It +.Xr serd-sort 1 +.It .Lk http://drobilla.net/software/serd/ .It .Lk http://gitlab.com/drobilla/serd/ |