Implement load-vocab and list-vocab commands

[osma]

This PR adds two new CLI commands, annif load-vocab and annif list-vocabs. It also deprecates the old annif loadvoc command. The main difference between load-vocab and loadvoc is that load-vocab operates directly on the vocabulary and takes a vocabulary ID as argument, while loadvoc takes a project ID as argument. See #602 for more details on these.

Here are examples of running the new commands:

$ annif load-vocab dummy tests/corpora/dummy-subjects.csv 
Loading vocabulary from CSV file tests/corpora/dummy-subjects.csv...
updating existing subject index
saving vocabulary into SKOS file data/vocabs/dummy/subjects.ttl

As is apparent, the load-vocab command is more verbose than loadvoc which produced little or no output.

The new list-vocabs command shows some basic information about the vocabularies:

$ annif list-vocabs
Vocabulary ID       Languages                 Size  Loaded
----------------------------------------------------------
yso                 en,fi,sv                 37869  True  
stw                 de,en                     6243  True  
gnd                 -                            -  False 
yletest             -                            -  False 
arch                fi                         125  True  
ykl                 -                            -  False 
dummy               en,fi                        2  True  

The loadvoc command now shows a deprecation message (in red color when possible) and has also become slightly more verbose:

$ annif loadvoc dummy-fi tests/corpora/dummy-subjects.csv 
DeprecationWarning: The command 'loadvoc' is deprecated.
updating existing subject index
saving vocabulary into SKOS file data/vocabs/dummy/subjects.ttl

There are also changes to the CLI commands documentation that is nowadays published on ReadTheDocs (see #611). The section on loadvoc command has been deleted, since we don't want to encourage its use. I will file a separate issue on removing the loadvoc command in a future release, probably 0.60.

Fixes #602

[codecov]

Codecov Report

Merging #614 (bd21582) into master (f632673) will increase coverage by 0.02%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##           master     #614      +/-   ##
==========================================
+ Coverage   99.58%   99.61%   +0.02%     
==========================================
  Files          87       87              
  Lines        5848     6034     +186     
==========================================
+ Hits         5824     6011     +187     
+ Misses         24       23       -1     

Impacted Files	Coverage Δ
annif/rest.py	100.00% <ø> (ø)
tests/test_vocab_skos.py	100.00% <ø> (ø)
annif/cli.py	99.69% <100.00%> (+0.05%)	⬆️
annif/corpus/subject.py	100.00% <100.00%> (ø)
annif/project.py	99.41% <100.00%> (+0.02%)	⬆️
annif/registry.py	100.00% <100.00%> (ø)
annif/vocab.py	97.50% <100.00%> (+1.60%)	⬆️
tests/conftest.py	100.00% <100.00%> (ø)
tests/test_cli.py	100.00% <100.00%> (ø)
tests/test_project.py	100.00% <100.00%> (ø)
... and 2 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

[sonarqubecloud]

SonarCloud Quality Gate failed.   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
4 Code Smells

No Coverage information
15.1% Duplication

[juhoinkinen]

LGTM

Wiki pages need update to align to these chages too.

[osma]

Wiki pages need update to align to these chages too.

Right, many wiki pages (e.g. all the backend pages) show use of the loadvoc command. Also vocabulary id's in example configurations and commands should be edited to remove the language suffixes that are no longer useful. I think it's best to do all the wiki edits synchronized with the 0.59 release.