relaton-cli 1.17.1 → 1.17.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/docs/README.adoc +62 -58
- data/lib/relaton/cli/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 445fd87d8d97ab7a1f44c2115c40a08d5cad417630b90e2f8ea52d9795b6334a
|
4
|
+
data.tar.gz: 213a439433f9074b1f04af53ed2ead9f063cdd8712920255e339a9377e48d9c8
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: dd47e551bccc5491afd37d5e42ed318f466ee1339b2e6168b845b0e2967707f80c5c827149ce83c23fc273d0196096a4a220c1ddf9af0468abf127f5b679aa46
|
7
|
+
data.tar.gz: 2c61f70713c27f724792df2f9a52341e3ba0dae544c4e854aecac0084fe852ce5382f6dfd956fc3c4cca3daa6fe954ce3c3960a3db86fff99cee0c768ba3c227
|
data/docs/README.adoc
CHANGED
@@ -49,7 +49,7 @@ Fetch the Relaton XML entry corresponding to the document identifier `CODE`.
|
|
49
49
|
|
50
50
|
* `YEAR` is optional and specifies the year of publication of the standard.
|
51
51
|
* `FORMAT` is optional, and specifies the output format; the recognized values for `FORMAT` are `xml` (default), yaml, `bibtex`.
|
52
|
-
* `TYPE` is optional and specifies the standards class library to be used, that the identifier is part of. The recognized values for `TYPE` are `3GPP
|
52
|
+
* `TYPE` is optional and specifies the standards class library to be used, that the identifier is part of. The recognized values for `TYPE` are: `3GPP`, `BIPM`, `CCTF`, `CCDS`, `CGPM`, `CIPM`, `JCRB`, `JCGM`, `BSI`, `BS`, `PD`, `CC`, `CCSDS`, `CEN`, `EN`, `ENV`, `CWA`, `HD`, `CR`, `CIE`, `DOI`, `ECMA`, `ETSI`, `CN`, `GB`, `GB/T`, `GB/Z`, `IANA`, `IEC`, `CISPR`, `IEV`, `IEEE`, `ANSI`, `NACE`, `AIEE`, `ASA`, `IRE`, `IETF`, `RFC`, `BCP`, `FYI`, `STD`, `I-D`, `IHO`, `ISBN`, `ISO`, `ISO/IEC`, `ITU`, `JIS`, `TR`, `NIST`, `NBS`, `NISTGCR`, `ITL Bulletin`, `JPCRD`, `NISTIR`, `CSRC`, `FIPS`, `OASIS`, `OGC`, `OMG`, `UN`, `W3C`, `XEP`.
|
53
53
|
* `RETRIES` is optional, number of network retries (default 1).
|
54
54
|
* `--all-parts` fetch all parts.
|
55
55
|
* `--keep-year` undated reference should return an actual reference with year.
|
@@ -89,8 +89,8 @@ The following datasets are available:
|
|
89
89
|
|
90
90
|
Options:
|
91
91
|
|
92
|
-
* `DIR` -
|
93
|
-
* `FORMAT` - format in which the documents are saved.
|
92
|
+
* `DIR` - folder name to store documents (default `./data`).
|
93
|
+
* `FORMAT` - format in which the documents are saved. Possible formats are: `yaml`, `xml`, `bibxml` (default `yaml`).
|
94
94
|
|
95
95
|
=== relaton extract
|
96
96
|
|
@@ -262,38 +262,42 @@ Convert a Relaton XML document into YAML, AsciiBib, or BibTex format. Allowed -f
|
|
262
262
|
=== relaton version
|
263
263
|
----
|
264
264
|
$ relaton version
|
265
|
-
CLI => 1.
|
266
|
-
relaton => 1.
|
267
|
-
relaton-bib => 1.
|
268
|
-
relaton-iso-bib => 1.
|
269
|
-
relaton-gb => 1.
|
270
|
-
relaton-iec => 1.
|
271
|
-
relaton-ietf => 1.
|
272
|
-
relaton-iso => 1.
|
273
|
-
relaton-itu => 1.
|
274
|
-
relaton-nist => 1.
|
275
|
-
relaton-ogc => 1.
|
276
|
-
relaton-calconnect => 1.
|
277
|
-
relaton-omg => 1.
|
278
|
-
relaton-un => 1.
|
279
|
-
relaton-w3c => 1.
|
280
|
-
relaton-ieee => 1.
|
281
|
-
relaton-iho => 1.
|
282
|
-
relaton-bipm => 1.
|
283
|
-
relaton-ecma => 1.
|
284
|
-
relaton-cie => 1.
|
285
|
-
relaton-bsi => 1.
|
286
|
-
relaton-cen => 1.
|
287
|
-
relaton-iana => 1.
|
288
|
-
relaton-3gpp => 1.
|
289
|
-
relaton-oasis => 1.
|
290
|
-
relaton-doi => 1.
|
291
|
-
relaton-jis => 1.
|
265
|
+
CLI => 1.17.2
|
266
|
+
relaton => 1.17.2
|
267
|
+
relaton-bib => 1.17.2
|
268
|
+
relaton-iso-bib => 1.17.0
|
269
|
+
relaton-gb => 1.17.0
|
270
|
+
relaton-iec => 1.17.0
|
271
|
+
relaton-ietf => 1.17.0
|
272
|
+
relaton-iso => 1.17.0
|
273
|
+
relaton-itu => 1.17.0
|
274
|
+
relaton-nist => 1.17.0
|
275
|
+
relaton-ogc => 1.17.1
|
276
|
+
relaton-calconnect => 1.17.0
|
277
|
+
relaton-omg => 1.17.0
|
278
|
+
relaton-un => 1.17.0
|
279
|
+
relaton-w3c => 1.17.2
|
280
|
+
relaton-ieee => 1.17.0
|
281
|
+
relaton-iho => 1.17.0
|
282
|
+
relaton-bipm => 1.17.0
|
283
|
+
relaton-ecma => 1.17.0
|
284
|
+
relaton-cie => 1.17.0
|
285
|
+
relaton-bsi => 1.17.0
|
286
|
+
relaton-cen => 1.17.0
|
287
|
+
relaton-iana => 1.17.0
|
288
|
+
relaton-3gpp => 1.17.0
|
289
|
+
relaton-oasis => 1.17.0
|
290
|
+
relaton-doi => 1.17.0
|
291
|
+
relaton-jis => 1.17.0
|
292
|
+
relaton-xsf => 1.17.0
|
293
|
+
relaton-ccsds => 1.17.0
|
294
|
+
relaton-etsi => 1.17.0
|
295
|
+
relaton-isbn => 1.17.0
|
292
296
|
----
|
293
297
|
|
294
298
|
=== relaton collection
|
295
299
|
|
296
|
-
The `relaton collection` is a set of subcommands for
|
300
|
+
The `relaton collection` is a set of subcommands for collection manipulations.
|
297
301
|
|
298
302
|
==== relaton collection create
|
299
303
|
|
@@ -301,8 +305,8 @@ The `relaton collection` is a set of subcommands for collections manipulations.
|
|
301
305
|
$ relaton collection create COLLECTION -d DIRECTORY --author AUTHOR --title TITLE --doctype DOCTYPE
|
302
306
|
----
|
303
307
|
|
304
|
-
Create new empty collection with name `COLLECTION`.
|
305
|
-
* `DIRECTORY`
|
308
|
+
Create a new empty collection with the name `COLLECTION`.
|
309
|
+
* `DIRECTORY` - optional, and specifies a path to a directory with collections. The default value is `$HOME/.relaton/collections`.
|
306
310
|
* `AUTHOR`, `TITLE`, and `DOCTYPE` are optional.
|
307
311
|
|
308
312
|
==== relaton collection info
|
@@ -312,7 +316,7 @@ $ relaton collection info COLLECTION -d DIRECTORY
|
|
312
316
|
----
|
313
317
|
|
314
318
|
Show information about `COLLECTION` (number of items, file size of collection, last updated, name, metadata).
|
315
|
-
* `DIRECTORY` is optional, and specifies path to a directory with collections.
|
319
|
+
* `DIRECTORY` is optional, and specifies the path to a directory with collections. The default value is `$HOME/.relaton/collections`.
|
316
320
|
|
317
321
|
==== relaton collection list
|
318
322
|
|
@@ -321,8 +325,8 @@ $ relaton collection list -d DIRECTORY -e
|
|
321
325
|
----
|
322
326
|
|
323
327
|
List all collections.
|
324
|
-
* `DIRECTORY`
|
325
|
-
* When
|
328
|
+
* `DIRECTORY` - optional, and specifies the path to a directory with collections. The default value is `$HOME/.relaton/collections`.
|
329
|
+
* When parameter `-e` is defined the id of each entry id will be listed.
|
326
330
|
|
327
331
|
==== relaton collection get
|
328
332
|
|
@@ -332,10 +336,10 @@ $ relaton collection get CODE -c COLLECTION -d DIRECTORY -f FORMAT -o FILE
|
|
332
336
|
|
333
337
|
Get a document matched to `CODE` from `COLLECTION`.
|
334
338
|
|
335
|
-
* `COLLECTION`
|
336
|
-
* `DIRECTORY`
|
337
|
-
* `FORMAT`
|
338
|
-
* `FILE` is optional. When it's defined then save document with given file name.
|
339
|
+
* `COLLECTION` - optional name of a collection. If undefined then fetch the first match across all collections in `DIRECTORY`.
|
340
|
+
* `DIRECTORY` - optional, and specifies a path to a directory with collections. The default value is `$HOME/.relaton/collections`.
|
341
|
+
* `FORMAT` - optional. If undefined then print a document in a human-readable form. Allowed values are `abb` (AsciiBib) or `xml` (XML).
|
342
|
+
* `FILE` is optional. When it's defined then save a document with the given file name. The file's extension defines the format of the file. Possible extensions are `abb` (AsciiBib) or `xml` (XML).
|
339
343
|
|
340
344
|
==== relaton collection find
|
341
345
|
|
@@ -345,8 +349,8 @@ $ relaton collection find TEXT -c COLLECTION -d DIRECTORY
|
|
345
349
|
|
346
350
|
Full-text search through a collection or all collections.
|
347
351
|
|
348
|
-
* `COLLECTION`
|
349
|
-
* `DIRECTORY`
|
352
|
+
* `COLLECTION` - optional name of a collection. If undefined then search across all collections.
|
353
|
+
* `DIRECTORY` - optional, and specifies a path to a directory with collections. The default value is `$HOME/.relaton/collections`.
|
350
354
|
|
351
355
|
==== relaton collection fetch
|
352
356
|
|
@@ -356,10 +360,10 @@ $ relaton collection fetch CODE -t TYPE -y YEAR -c COLLECTION -d DIRECTORY
|
|
356
360
|
|
357
361
|
Fetch the Relaton XML entry corresponding to the document identifier `CODE` and save it into `COLLECTION`.
|
358
362
|
|
359
|
-
* `TYPE` specifies the standards class library to be used, that the identifier is part of. The
|
363
|
+
* `TYPE` specifies the standards class library to be used, that the identifier is part of. The recognized values for `TYPE` are: `3GPP`, `BIPM`, `CCTF`, `CCDS`, `CGPM`, `CIPM`, `JCRB`, `JCGM`, `BSI`, `BS`, `PD`, `CC`, `CCSDS`, `CEN`, `EN`, `ENV`, `CWA`, `HD`, `CR`, `CIE`, `DOI`, `ECMA`, `ETSI`, `CN`, `GB`, `GB/T`, `GB/Z`, `IANA`, `IEC`, `CISPR`, `IEV`, `IEEE`, `ANSI`, `NACE`, `AIEE`, `ASA`, `IRE`, `IETF`, `RFC`, `BCP`, `FYI`, `STD`, `I-D`, `IHO`, `ISBN`, `ISO`, `ISO/IEC`, `ITU`, `JIS`, `TR`, `NIST`, `NBS`, `NISTGCR`, `ITL Bulletin`, `JPCRD`, `NISTIR`, `CSRC`, `FIPS`, `OASIS`, `OGC`, `OMG`, `UN`, `W3C`, `XEP`.
|
360
364
|
* `YEAR` is optional, and specifies the year of publication of the standard.
|
361
|
-
* `COLLECTION`
|
362
|
-
* `DIRECTORY`
|
365
|
+
* `COLLECTION` - a name of a collection.
|
366
|
+
* `DIRECTORY` - optional, and specifies a path to a directory with collections. The default value is `$HOME/.relaton/collections`.
|
363
367
|
|
364
368
|
==== relaton collection export
|
365
369
|
|
@@ -367,9 +371,9 @@ Fetch the Relaton XML entry corresponding to the document identifier `CODE` and
|
|
367
371
|
$ relaton collection export COLLECTION -d DIRECTORY
|
368
372
|
----
|
369
373
|
|
370
|
-
Export `COLLECTION` into XML file.
|
374
|
+
Export `COLLECTION` into an XML file.
|
371
375
|
|
372
|
-
* `DIRECTORY`
|
376
|
+
* `DIRECTORY` - optional, and specifies a path to a directory with collections. The default value is `$HOME/.relaton/collections`.
|
373
377
|
|
374
378
|
==== relaton collection import
|
375
379
|
|
@@ -379,8 +383,8 @@ $ relaton collection import FILE -c COLLECTION -d DIRECTORY
|
|
379
383
|
|
380
384
|
Import document or collection from XML `FILE` into `COLLECTION`.
|
381
385
|
|
382
|
-
* `COLLECTION`
|
383
|
-
* `DIRECTORY`
|
386
|
+
* `COLLECTION` - optional. If a collection doesn't exist then it will be created.
|
387
|
+
* `DIRECTORY` - optional, and specifies a path to a directory with collections. The default value is `$HOME/.relaton/collections`.
|
384
388
|
|
385
389
|
=== Dadabase manipulation
|
386
390
|
|
@@ -390,7 +394,7 @@ Import document or collection from XML `FILE` into `COLLECTION`.
|
|
390
394
|
$ relaton db create DIR
|
391
395
|
----
|
392
396
|
|
393
|
-
Creates a new database in a directory `DIR` (optional,
|
397
|
+
Creates a new database in a directory `DIR` (optional, the default value is `/home/USER/.relaton/dbpath`). In case the target directory exists it will be used as a database.
|
394
398
|
|
395
399
|
----
|
396
400
|
$ relaton db create
|
@@ -406,7 +410,7 @@ $ relaton db create cachedb
|
|
406
410
|
$ relaton db mv DIR
|
407
411
|
----
|
408
412
|
|
409
|
-
Move database to another place `DIR`.
|
413
|
+
Move a database to another place `DIR`.
|
410
414
|
|
411
415
|
----
|
412
416
|
$ relaton db mv cache_dir
|
@@ -415,7 +419,7 @@ $ relaton db mv cache_dir
|
|
415
419
|
|
416
420
|
==== Clear database
|
417
421
|
|
418
|
-
Delete all entries from a
|
422
|
+
Delete all entries from a cache DB.
|
419
423
|
|
420
424
|
----
|
421
425
|
$ relaton db clear
|
@@ -427,20 +431,20 @@ $ relaton db clear
|
|
427
431
|
$ relaton db fetch -t TYPE -f FORMAT -y YEAR
|
428
432
|
----
|
429
433
|
|
430
|
-
Fetch an entry from a database. See [relaton fetch](#relaton-fetch) for the arguments
|
434
|
+
Fetch an entry from a database. See [relaton fetch](#relaton-fetch) for the explanation of the arguments.
|
431
435
|
|
432
436
|
==== Fetch all
|
433
437
|
|
434
|
-
Fetch all entries from a
|
438
|
+
Fetch all entries from a cache DB.
|
435
439
|
|
436
440
|
----
|
437
441
|
$ relaton db fetch_all TEXT -e EDITION -y YEAR -f FORMAT
|
438
442
|
----
|
439
443
|
|
440
|
-
* `TEXT` (optional) search for a
|
441
|
-
* `EDITION` (optional) filter
|
444
|
+
* `TEXT` (optional) search for a certain string
|
445
|
+
* `EDITION` (optional) filter documents with a certain edition
|
442
446
|
* `YEAR` (optional) filter documents by a year
|
443
|
-
* `FORMAT` (optional)
|
447
|
+
* `FORMAT` (optional) specifies the output format. Recognized values are `xml` (default), yaml, `bibtex`.
|
444
448
|
|
445
449
|
----
|
446
450
|
$ relaton db fetch_all
|
@@ -478,7 +482,7 @@ $ relaton db fetch_all -e 8 -y 2018
|
|
478
482
|
$ relaton db doctype REF
|
479
483
|
----
|
480
484
|
|
481
|
-
Takes a reference `REF` and
|
485
|
+
Takes a reference `REF` and returns a document type.
|
482
486
|
|
483
487
|
----
|
484
488
|
$ relaton db doctype 'CN(GB/T 1.1)'
|
data/lib/relaton/cli/version.rb
CHANGED
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: relaton-cli
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.17.
|
4
|
+
version: 1.17.2
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Ribose Inc.
|
8
8
|
autorequire:
|
9
9
|
bindir: exe
|
10
10
|
cert_chain: []
|
11
|
-
date: 2023-12-
|
11
|
+
date: 2023-12-16 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: liquid
|