relaton-cli 1.17.1 → 1.17.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|