relaton-cli 1.5.0 → 1.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 421e4a675216ae65860c59a257d87c10262528a5236e5658a59de0c22187848d
-  data.tar.gz: ee4355d9c9667991305a7ff65ce5f4f922c229fb07a5de8e9148ca27eade0a47
+  metadata.gz: 9983d2d6b80b1d1ac3a1ad7da07f4de43d8509c44c61c050ab2046c11580c8bc
+  data.tar.gz: '09593a750543ab10dae21731732f7858c5467bd30494613e5b59c00f0967bbb9'
 SHA512:
-  metadata.gz: 9121a5b70e059c108d010a9b5a51355d61d505d0454cfbbff9bbe8142aee0972bf5490f9d85a96c27380feab2b618c911cd113c20b49859daec0f1bcb05a67f2
-  data.tar.gz: 65f2e8638b2802e4d72cbfdfbd7a7f378ed33fafbf9ce4d75ae1fa5863d12883c96f4450100b7e846cd5c865aea15fb28c2d9976ace0671a39abed22aa58ae26
+  metadata.gz: 1419b4f0fdc45ca4dc5f9674eff0a9784ae89d6159a8bf23e4168d3f61776f28ddfd8caf76dc0540bf310e7b730095d94db03e7a5be95340cf668896d5446ed0
+  data.tar.gz: 5e4c6b9d094841f358566238406a6a08b1ad1080e33b48b190807c126c41fa17498f8f1b5707d66ac6f97aea06a04d73b567663fd6328e65db8dfc04b96d2736

data/.github/workflows/rake.yml

@@ -0,0 +1,46 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+name: rake
+
+on:
+  push:
+    branches: [ master, main ]
+    tags: [ v* ]
+  pull_request:
+
+jobs:
+  rake:
+    name: Test on Ruby ${{ matrix.ruby }} ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    continue-on-error: ${{ matrix.experimental }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: [ '2.7', '2.6', '2.5', '2.4' ]
+        os: [ ubuntu-latest, windows-latest, macos-latest ]
+        experimental: [ false ]
+        include:
+          - ruby: '3.0'
+            os: 'ubuntu-latest'
+            experimental: true
+          - ruby: '3.0'
+            os: 'windows-latest'
+            experimental: true
+          - ruby: '3.0'
+            os: 'macos-latest'
+            experimental: true
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          submodules: true
+
+      # https://github.com/ruby-debug/debase/issues/89#issuecomment-686827382
+      - if: matrix.os == 'macos-latest' && matrix.ruby == '2.5'
+        run: echo BUNDLE_BUILD__DEBASE="--with-cflags=\"-Wno-error=implicit-function-declaration\"" >> $GITHUB_ENV
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+
+      - run: bundle exec rake

data/Gemfile

@@ -5,4 +5,3 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in gemspec
 gemspec
-

data/docs/README.adoc

@@ -1,9 +1,7 @@
 = Relaton CLI (relaton-cli): Relaton Command-line Interface
 
 image:https://img.shields.io/gem/v/relaton-cli.svg["Gem Version", link="https://rubygems.org/gems/relaton-cli"]
-image:https://github.com/relaton/relaton-cli/workflows/ubuntu/badge.svg["Build Status", link="https://github.com/relaton/relaton-cli/actions?workflow=ubuntu"]
-image:https://github.com/relaton/relaton-cli/workflows/macos/badge.svg["Build Status", link="https://github.com/relaton/relaton-cli/actions?workflow=macos"]
-image:https://github.com/relaton/relaton-cli/workflows/windows/badge.svg["Build Status", link="https://github.com/relaton/relaton-cli/actions?workflow=windows"]
+image:https://github.com/relaton/relaton-cli/workflows/rake/badge.svg["Build Status", link="https://github.com/relaton/relaton-cli/actions?workflow=rake"]
 image:https://codeclimate.com/github/metanorma/relaton-cli/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/metanorma/relaton-cli"]
 
 Documentation in development.
@@ -50,8 +48,7 @@ Fetch the Relaton XML entry corresponding to the document identifier `CODE`.
 
 * `YEAR` is optional, and specifies the year of publication of the standard.
 * `FORMAT` is optional, and specifies the output format; the recognised values for `FORMAT` are `xml` (default), `bibtex`.
-* `TYPE` specifies the standards class library to be used, that the identifier is part of; the recognised
-values for `TYPE` are `isobib`, `ietfbib`, `iecbib`, `gbbib`.
+* `TYPE` specifies the standards class library to be used, that the identifier is part of. The recognised values for `TYPE` are `BIPM`, `CC`, `CN`, `IEC`, `IEEE`, `IETF`, `IHO`, `ISO`, `ITU`, `NIST`, `OGC`, `OMG`, `UN`, `W3C`.
 
 === relaton extract
 
@@ -217,3 +214,94 @@ $ relaton convert XML -f FORMAT -o OUTPUT-FILE
 ----
 
 Convert a Relaton XML document into YAML, AsciiBib, or BibTex format. Allowed -f or --format options are yaml, asciibib, bibtex. If the option -o or --output is omitted then a new file will be created in the folder where the original file is, with the same name but another appropriated extension.
+
+=== relaton collection
+
+The `relaton collection` is a set of subcommands for collections manipulations.
+
+==== relaton collection create
+
+----
+$ relaton collection create COLLECTION -d DIRECTORY --author AUTHOR --title TITLE --doctype DOCTYPE
+----
+
+Create new empty collection with name `COLLECTION`.
+* `DIRECTORY` is optional, and specifies path to a directory with collections. Default is `$HOME/.relaton/collections`.
+* `AUTHOR`, `TITLE`, and `DOCTYPE` are optional.
+
+==== relaton collection info
+
+----
+$ relaton collection info COLLECTION -d DIRECTORY
+----
+
+Show information about `COLLECTION` (number of items, file size of collection, last updated, name, metadata).
+* `DIRECTORY` is optional, and specifies path to a directory with collections. Default is `$HOME/.relaton/collections`.
+
+==== relaton collection list
+
+----
+$ relaton collection list -d DIRECTORY -e
+----
+
+List all collections.
+* `DIRECTORY` is optional, and specifies path to a directory with collections. Default is `$HOME/.relaton/collections`.
+* When parametr `-e` is defined the id of each entry id will be listed.
+
+==== relaton collection get
+
+----
+$ relaton collection get CODE -c COLLECTION -d DIRECTORY -f FORMAT -o FILE
+----
+
+Get a document matched to `CODE` from `COLLECTION`.
+
+* `COLLECTION` is optional name of collection. If undefined then fetch the first match across all collections in `DIRECTORY`.
+* `DIRECTORY` is optional, and specifies path to a directory with collections. Default is `$HOME/.relaton/collections`.
+* `FORMAT` is optional. If udefined then print documern in a human-readable form. Allowed values are `abb` (AsciiBib) or `xml` (XML).
+* `FILE` is optional. When it's defined then save document with given file name. File's extension defines format of the file. Possible extensions are `abb` (AsciiBib) or `xml` (XML).
+
+==== relaton collection find
+
+----
+$ relaton collection find TEXT -c COLLECTION -d DIRECTORY
+----
+
+Full-text search through a collection or all collections.
+
+* `COLLECTION` is optional name of collection. If udefined then search across all collections.
+* `DIRECTORY` is optional, and specifies path to a directory with collections. Default is `$HOME/.relaton/collections`.
+
+==== relaton collection fetch
+
+----
+$ relaton collection fetch CODE -t TYPE -y YEAR -c COLLECTION -d DIRECTORY
+----
+
+Fetch the Relaton XML entry corresponding to the document identifier `CODE` and save it into `COLLECTION`.
+
+* `TYPE` specifies the standards class library to be used, that the identifier is part of. The recognised values for `TYPE` are `BIPM`, `CC`, `CN`, `IEC`, `IEEE`, `IETF`, `IHO`, `ISO`, `ITU`, `NIST`, `OGC`, `OMG`, `UN`, `W3C`.
+* `YEAR` is optional, and specifies the year of publication of the standard.
+* `COLLECTION` is a name of collection.
+* `DIRECTORY` is optional, and specifies path to a directory with collections. Default is `$HOME/.relaton/collections`.
+
+==== relaton collection export
+
+----
+$ relaton collection export COLLECTION -d DIRECTORY
+----
+
+Export `COLLECTION` into XML file.
+
+* `DIRECTORY` is optional, and specifies path to a directory with collections. Default is `$HOME/.relaton/collections`.
+
+==== relaton collection import
+
+----
+$ relaton collection import FILE -c COLLECTION -d DIRECTORY
+----
+
+Import document or collection from XML `FILE` into `COLLECTION`.
+
+* `COLLECTION` is optional. If collection doesn't exist then it will be created.
+* `DIRECTORY` is optional, and specifies path to a directory with collections. Default is `$HOME/.relaton/collections`.

data/lib/relaton/bibcollection.rb

@@ -8,36 +8,34 @@ module Relaton
 
     attr_accessor *ATTRIBS
 
-    # rubocop:disable Metrics/MethodLength
-
+    # @param options [Hash]
     def initialize(options)
-      self.items = []
       ATTRIBS.each do |k|
         value = options[k] || options[k.to_s]
         send("#{k}=", value)
       end
-      self.items = (items || []).reduce([]) do |acc, item|
-        acc << if item.is_a?(Bibcollection) || item.is_a?(Bibdata)
-                 item
-               else new_bib_item_class(item)
-               end
-      end
+      reduce_items
     end
-    # rubocop:enable Metrics/MethodLength
 
     # arbitrary number, must sort after all bib items
     def doc_number
       9999999
     end
 
+    # Add a dcoument to the collection
+    # @param item [RelatonBib::BibliographicItem]
+    def <<(item)
+      items << new_bib_item_class(item)
+    end
+
     # rubocop:disable Metrics/MethodLength
 
     # @param source [Nokogiri::XML::Element]
     def self.from_xml(source)
       title = find_text("./relaton-collection/title", source)
       author = find_text(
-        "./relaton-collection/contributor[role/@type='author']/organization/name",
-        source,
+        "./relaton-collection/contributor[role/@type='author']/organization/"\
+        "name", source
       )
 
       items = find_xpath("./relaton-collection/relation", source)&.map do |item|
@@ -48,29 +46,8 @@ module Relaton
 
       new(title: title, author: author, items: items)
     end
-    # rubocop:enable Metrics/MethodLength
-
-    def new_bib_item_class(options)
-      if options.is_a?(Hash) && options["items"]
-        ::Relaton::Bibcollection.new(options)
-      else
-        ::Relaton::Bibdata.new(options)
-      end
-    end
-
-    def items_flattened
-      items.sort_by! &:docnumber
-
-      items.reduce([]) do |acc,item|
-        acc << if item.is_a? ::Relaton::Bibcollection
-                 item.items_flattened
-               else
-                 item
-               end
-      end
-    end
 
-    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+    # rubocop:disable Metrics/AbcSize
 
     # @param opts [Hash]
     # @return [String] XML
@@ -98,7 +75,37 @@ module Relaton
       end
       ret += "</relaton-collection>\n"
     end
-    # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
+    # rubocop:enable Metrics/AbcSize
+
+    # @param item [Hash, RelatonBib::BibliographicItem, Relatin::Bibdata,
+    #   Relaton::Bibcollection]
+    # @return [Relaton::Bibdata, Relaton::Bibcollection]
+    def new_bib_item_class(item)
+      if item.is_a?(Hash)
+        if item["items"]
+          ::Relaton::Bibcollection.new(item)
+        else
+          bibitem = ::Relaton::Cli::YAMLConvertor.convert_single_file item
+          ::Relaton::Bibdata.new bibitem
+        end
+      elsif item.is_a?(Relaton::Bibdata) || item.is_a?(Relaton::Bibcollection)
+        item
+      else ::Relaton::Bibdata.new(item)
+      end
+    end
+    # rubocop:enable Metrics/MethodLength
+
+    def items_flattened
+      items.sort_by! &:doc_number
+
+      items.reduce([]) do |acc, item|
+        acc << if item.is_a? ::Relaton::Bibcollection
+                 item.items_flattened
+               else
+                 item
+               end
+      end
+    end
 
     def to_yaml
       to_h.to_yaml
@@ -116,5 +123,16 @@ module Relaton
 
       { "root" => a }
     end
+
+    private
+
+    def reduce_items
+      self.items = (items || []).reduce([]) do |acc, item|
+        acc << if item.is_a?(Bibcollection) || item.is_a?(Bibdata)
+                 item
+               else new_bib_item_class(item)
+               end
+      end
+    end
   end
 end

data/lib/relaton/bibdata.rb

@@ -4,8 +4,10 @@ module Relaton
   class Bibdata
     URL_TYPES = %i[uri xml pdf doc html rxl txt].freeze
 
+    # @return [RelatonBib::BibliographicItem]
     attr_reader :bibitem
 
+    # @param bibitem [RelatonBib::BibliographicItem]
     def initialize(bibitem)
       @bibitem = bibitem
     end

data/lib/relaton/cli.rb

@@ -16,40 +16,58 @@ module Relaton
       end
     end
 
-    def self.start(arguments)
-      Relaton::Cli::Command.start(arguments)
-    end
+    class << self
+      def start(arguments)
+        Relaton::Cli::Command.start(arguments)
+      end
 
-    # Relaton
-    #
-    # Based on current setup, we need to initiate a Db instance to
-    # register all of it's supported processor backends. To make it
-    # easier we have added it as a class method so we can use this
-    # whenever necessary.
-    #
-    def self.relaton
-      RelatonDb.instance.db
-    end
+      # Relaton
+      #
+      # Based on current setup, we need to initiate a Db instance to
+      # register all of it's supported processor backends. To make it
+      # easier we have added it as a class method so we can use this
+      # whenever necessary.
+      #
+      def relaton
+        RelatonDb.instance.db
+      end
 
-    # @param content [Nokogiri::XML::Document]
-    # @return [RelatonBib::BibliographicItem, RelatonIsoBib::IsoBibliongraphicItem]
-    def self.parse_xml(doc)
-      if (proc = Cli.processor(doc))
-        proc.from_xml(doc.to_s)
-      else
-        RelatonBib::XMLParser.from_xml(doc.to_s)
+      # @param content [Nokogiri::XML::Document]
+      # @return [RelatonBib::BibliographicItem,
+      #   RelatonIsoBib::IsoBibliongraphicItem]
+      def parse_xml(doc)
+        if (proc = Cli.processor(doc))
+          proc.from_xml(doc.to_s)
+        else
+          RelatonBib::XMLParser.from_xml(doc.to_s)
+        end
       end
-    end
 
-    # @param doc [Nokogiri::XML::Element]
-    # @return [String] Type prefix
-    def self.processor(doc)
-      docid = doc.at "docidentifier"
-      if docid && docid[:type]
-        proc = Relaton::Registry.instance.by_type(docid[:type])
+      # @param doc [Nokogiri::XML::Element]
+      # @return [RelatonIso::Processor, RelatonIec::Processor,
+      #   RelatonNist::Processor, RelatonIetf::Processot,
+      #   RelatonItu::Processor, RelatonGb::Processor,
+      #   RelatonOgc::Processor, RelatonCalconnect::Processor]
+      def processor(doc)
+        docid = doc.at "docidentifier"
+        proc = get_proc docid
         return proc if proc
+
+        Relaton::Registry.instance.by_type(docid&.text&.match(/^\w+/)&.to_s)
+      end
+
+      private
+
+      # @param doc [Nokogiri::XML::Element]
+      # @return [RelatonIso::Processor, RelatonIec::Processor,
+      #   RelatonNist::Processor, RelatonIetf::Processot,
+      #   RelatonItu::Processor, RelatonGb::Processor,
+      #   RelatonOgc::Processor, RelatonCalconnect::Processor]
+      def get_proc(docid)
+        return unless docid && docid[:type]
+
+        Relaton::Registry.instance.by_type(docid[:type])
       end
-      Relaton::Registry.instance.by_type(docid&.text&.match(/^\w+/)&.to_s)
     end
   end
 end

data/lib/relaton/cli/base_convertor.rb

@@ -52,7 +52,7 @@ module Relaton
         Relaton::Cli::XmlToHtmlRenderer.render(
           xml_content(file),
           stylesheet: options[:style],
-          liquid_dir: options[:template],
+          liquid_dir: options[:template]
         )
       end
 

data/lib/relaton/cli/command.rb

@@ -1,93 +1,128 @@
 require "relaton/cli/relaton_file"
 require "relaton/cli/xml_convertor"
 require "relaton/cli/yaml_convertor"
+require "relaton/cli/subcommand_collection"
 require "fcntl"
 
 module Relaton
   module Cli
     class Command < Thor
       desc "fetch CODE", "Fetch Relaton XML for Standard identifier CODE"
-      option :type, aliases: :t, required: true, desc: "Type of standard to get bibliographic entry for"
-      option :format, aliases: :f, desc: "Output format (xml, bibtex). Default xml."
-      option :year, aliases: :y, type: :numeric, desc: "Year the standard was published"
+      option :type, aliases: :t, required: true, desc: "Type of standard to "\
+        "get bibliographic entry for"
+      option :format, aliases: :f, desc: "Output format (xml, bibtex). "\
+        "Default xml."
+      option :year, aliases: :y, type: :numeric, desc: "Year the standard was "\
+        "published"
 
       def fetch(code)
         Relaton.db
-        io = IO.new(STDOUT.fcntl(::Fcntl::F_DUPFD), mode: 'w:UTF-8')
+        io = IO.new(STDOUT.fcntl(::Fcntl::F_DUPFD), mode: "w:UTF-8")
         io.puts(fetch_document(code, options) || supported_type_message)
       end
 
-      desc "extract Metanorma-XML-File / Directory Relaton-XML-Directory", "Extract Relaton XML from Metanorma XML file / directory"
-      option :extension, aliases: :x, default: "rxl", desc: "File extension of Relaton XML files, defaults to 'rxl'"
+      desc "extract Metanorma-XML-File / Directory Relaton-XML-Directory",
+           "Extract Relaton XML from Metanorma XML file / directory"
+      option :extension, aliases: :x, default: "rxl", desc: "File extension "\
+        "of Relaton XML files, defaults to 'rxl'"
 
       def extract(source_dir, outdir)
         Relaton::Cli::RelatonFile.extract(source_dir, outdir, options)
       end
 
-      desc "concatenate SOURCE-DIR COLLECTION-FILE", "Concatenate entries in DIRECTORY (containing Relaton-XML or YAML) into a Relaton Collection"
+      desc "concatenate SOURCE-DIR COLLECTION-FILE", "Concatenate entries in "\
+        "DIRECTORY (containing Relaton-XML or YAML) into a Relaton Collection"
       option :title, aliases: :t,  desc: "Title of resulting Relaton collection"
-      option :organization, aliases: :g, desc: "Organization owner of Relaton collection"
-      option :new, aliases: :n, type: :boolean, desc: "Use the new Relaton YAML format"
-      option :extension, aliases: :x, desc: "File extension of destination Relaton file, defaults to 'rxl'"
+      option :organization, aliases: :g, desc: "Organization owner of Relaton "\
+        "collection"
+      option :new, aliases: :n, type: :boolean, desc: "Use the new Relaton "\
+        "YAML format"
+      option :extension, aliases: :x, desc: "File extension of destination "\
+        "Relaton file, defaults to 'rxl'"
 
       def concatenate(source_dir, outfile)
         Relaton::Cli::RelatonFile.concatenate(source_dir, outfile, options)
       end
 
-      desc "split Relaton-Collection-File Relaton-XML-Directory", "Split a Relaton Collection into multiple files"
-      option :extension, aliases: :x, default: "rxl", desc: "File extension of Relaton XML files, defaults to 'rxl'"
-      option :new, aliases: :n, type: :boolean, desc: "Use the new Relaton YAML format"
+      desc "split Relaton-Collection-File Relaton-XML-Directory", "Split a "\
+        "Relaton Collection into multiple files"
+      option :extension, aliases: :x, default: "rxl", desc: "File extension "\
+        "of Relaton XML files, defaults to 'rxl'"
+      option :new, aliases: :n, type: :boolean, desc: "Use the new Relaton "\
+        "YAML format"
 
       def split(source, outdir)
         Relaton::Cli::RelatonFile.split(source, outdir, options)
       end
 
-      desc "yaml2xml YAML", "Convert Relaton YAML into Relaton Collection XML or separate files"
-      option :extension, aliases: :x, default: "rxl", desc: "File extension of Relaton XML files, defaults to 'rxl'"
-      option :prefix, aliases: :p, desc: "Filename prefix of individual Relaton XML files, defaults to empty"
-      option :outdir, aliases: :o, desc: "Output to the specified directory with individual Relaton Bibdata XML files"
-      option :require, aliases: :r, type: :array, desc: "Require LIBRARY prior to execution"
-      option :overwrite, aliases: :f, type: :boolean, default: false, desc: "Overwrite the existing file"
+      desc "yaml2xml YAML", "Convert Relaton YAML into Relaton Collection XML "\
+        "or separate files"
+      option :extension, aliases: :x, default: "rxl", desc: "File extension "\
+        "of Relaton XML files, defaults to 'rxl'"
+      option :prefix, aliases: :p, desc: "Filename prefix of individual "\
+        "Relaton XML files, defaults to empty"
+      option :outdir, aliases: :o, desc: "Output to the specified directory "\
+        "with individual Relaton Bibdata XML files"
+      option :require, aliases: :r, type: :array, desc: "Require LIBRARY "\
+        "prior to execution"
+      option :overwrite, aliases: :f, type: :boolean, default: false,
+                         desc: "Overwrite the existing file"
 
       def yaml2xml(filename)
         Relaton::Cli::YAMLConvertor.to_xml(filename, options)
       end
 
-      desc "xml2yaml XML", "Convert Relaton XML into Relaton Bibdata / Bibcollection YAML (and separate files)"
-      option :extension, aliases: :x, default: "yaml", desc: "File extension of Relaton YAML files, defaults to 'yaml'"
-      option :prefix, aliases: :p, desc: "Filename prefix of Relaton XML files, defaults to empty"
-      option :outdir, aliases: :o, desc: "Output to the specified directory with individual Relaton Bibdata YAML files"
-      option :require, aliases: :r, type: :array, desc: "Require LIBRARY prior to execution"
-      option :overwrite, aliases: :f, type: :boolean, default: false, desc: "Overwrite the existing file"
+      desc "xml2yaml XML", "Convert Relaton XML into Relaton Bibdata / "\
+        "Bibcollection YAML (and separate files)"
+      option :extension, aliases: :x, default: "yaml", desc: "File extension "\
+        "of Relaton YAML files, defaults to 'yaml'"
+      option :prefix, aliases: :p, desc: "Filename prefix of Relaton XML "\
+        "files, defaults to empty"
+      option :outdir, aliases: :o, desc: "Output to the specified directory "\
+        "with individual Relaton Bibdata YAML files"
+      option :require, aliases: :r, type: :array, desc: "Require LIBRARY "\
+        "prior to execution"
+      option :overwrite, aliases: :f, type: :boolean, default: false,
+                         desc: "Overwrite the existing file"
 
       def xml2yaml(filename)
         Relaton::Cli::XMLConvertor.to_yaml(filename, options)
       end
 
-      desc "xml2html RELATON-INDEX-XML", "Convert Relaton Collection XML into HTML"
-      option :stylesheet, aliases: :s, desc: "Stylesheet file path for rendering HTML index"
-      option :templatedir, aliases: :t, desc: "Liquid template directory for rendering Relaton items and collection"
-      option :overwrite, aliases: :f, type: :boolean, default: false, desc: "Overwrite the existing file"
+      desc "xml2html RELATON-INDEX-XML", "Convert Relaton Collection XML into "\
+        "HTML"
+      option :stylesheet, aliases: :s, desc: "Stylesheet file path for "\
+        "rendering HTML index"
+      option :templatedir, aliases: :t, desc: "Liquid template directory for "\
+        "rendering Relaton items and collection"
+      option :overwrite, aliases: :f, type: :boolean, default: false,
+                         desc: "Overwrite the existing file"
 
       def xml2html(file, style = nil, template = nil)
         Relaton::Cli::XMLConvertor.to_html(file, style, template)
       end
 
-      desc "yaml2html RELATON-INDEX-YAML", "Concatenate Relaton Collection YAML into HTML"
-      option :stylesheet, aliases: :s, desc: "Stylesheet file path for rendering HTML index"
-      option :templatedir, aliases: :t, desc: "Liquid template directory for rendering Relaton items and collection"
-      option :overwrite, aliases: :f, type: :boolean, default: false, desc: "Overwrite the existing file"
+      desc "yaml2html RELATON-INDEX-YAML", "Concatenate Relaton Collection "\
+        "YAML into HTML"
+      option :stylesheet, aliases: :s, desc: "Stylesheet file path for "\
+        "rendering HTML index"
+      option :templatedir, aliases: :t, desc: "Liquid template directory for "\
+        "rendering Relaton items and collection"
+      option :overwrite, aliases: :f, type: :boolean, default: false,
+                         desc: "Overwrite the existing file"
 
       def yaml2html(file, style = nil, template = nil)
         Relaton::Cli::YAMLConvertor.to_html(file, style, template)
       end
 
       desc "convert XML", "Convert Relaton XML document"
-      option :format, aliases: :f, required: true, desc: "Output format (yaml, bibtex, asciibib)"
+      option :format, aliases: :f, required: true, desc: "Output format "\
+        "(yaml, bibtex, asciibib)"
       option :output, aliases: :o, desc: "Output to the specified file"
 
-      def convert(file)
-        item = Relaton::Cli.parse_xml Nokogiri::XML(File.read(file, encoding: "UTF-8"))
+      def convert(file) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        xml = Nokogiri::XML(File.read(file, encoding: "UTF-8"))
+        item = Relaton::Cli.parse_xml xml
         result = if /yaml|yml/.match?(options[:format])
                    item.to_hash.to_yaml
                  else item.send "to_#{options[:format]}"
@@ -101,6 +136,9 @@ module Relaton
         File.write output, result, encoding: "UTF-8"
       end
 
+      desc "collection SUBCOMMAND", "Collection manipulations"
+      subcommand "collection", SubcommandCollection
+
       private
 
       # @param code [String]