Add upgrate step to migrate terms from VCGE 1 to 2

[hvelarde]

closes #25

[caduvieira]

Podia usar o termo replaces e o SKOS como no 06c89a7#diff-26ba68ca88173fa2bfef120ac72f89efR73

Nunca terminei esse feature mas creio que seja o mais fácil. Faltou, pelo menos, fazer o que o idgserpro comentou #29 (comment)

---

Editei. Estava replacedBy mas fiz confusão.

[hvelarde]

@caduvieira não entendi onde e por que tu quer usar esse replacedBy.

[caduvieira]

O replaces tem a semântica de que um termo foi trocado por outro conforme http://dublincore.org/2012/06/14/dcterms#replaces e o replacedBy é o inverso desse.

[rodfersou]

In this case all terms would be migrated? or are there any example of term that would remain as it is from old to new version?

for example, we have 3 old terms ['term1', 'term2', 'term3'];
'term2' should be replaced by 'term4' and 'term3' by 'term5';

with the code written now, the result would be ['term4', 'term5'] because 'term1' is not into equivalences dict.

Is it fine like this?

[hvelarde]

yes, check the tests.

[rodfersou]

Added one question

[augusto-herrmann]

There is no such thing as VCGE 1. There is VCGE 2011 and there is VCGE 2.

How exactly do you propose replacing VCGE 2011 terms with VCGE 2 terms?

SKOS has neither a replaces nor replacedBy property. Dublin Core has a replaces property, but its semantics require that both resources be semantic equivalent. That will not be possible in most cases, considering that the VCGE 2 vocabulary has a tiny number of terms in comparison to VCGE 2011 and in the vast majority of cases it won't be possible to find and equivalent term in VCGE 2.

Notwithstanding the technical difficulty that in most cases you won't find a term to map to in VCGE 2, you would also lose a lot of information by migrating, considering that VCGE 2 is too generic. Which makes me wonder why would anyone even want to migrate to it in the first place. If the reason for migrating is that VCGE 2011 is no longer maintained, consider instead migrating to a more useful vocabulary, such as Eurovoc.

[hvelarde]

@augusto-herrmann a migração do VCGE 1 para o VCGE 2 está documentada aqui e a maioria dos casos está coberta:

• https://www.governoeletronico.gov.br/documentos-e-arquivos/VCGE_DEPARA_01.pdf
• https://www.governoeletronico.gov.br/documentos-e-arquivos/VCGE_DEPARA_01.csv

eu não estou qualificado para opinar sobre o vocabulário nem seu uso, meu único interesse é prover a migração pois não é mais recomendado usar o branch 1.x deste pacote.

esse é o escopo deste pull request; qualquer outro assunto deve ser tratado em outro lugar.

[augusto-herrmann]

esse é o escopo deste pull request; qualquer outro assunto deve ser tratado em outro lugar.

Entendo. Eu não vejo mais razão de existir para esse pacote. A partir de agora vou parar de segui-lo e não comentarei mais em suas threads e issues.

[hvelarde]

alguém mais pode por favor revisar isso aqui?

@AlexandreChagas este PR soluciona seu problema, se ainda é um problema.