feat(apiops): integrate go-apiops

[Tieske]

replaces #912

Implements the following commands;

• deck openapi2kong to convert an OAS 3.0 spec to a decK format
• deck merge to merge multiple decK files into one (non-validating)
• deck patch to update elements in a decK file (non-validating)

[codecov-commenter]

Codecov Report

Patch coverage: 0.51% and project coverage change: -1.58 ⚠️

Comparison is base (5bbd6a8) 35.63% compared to head (c4acd9a) 34.05%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #939      +/-   ##
==========================================
- Coverage   35.63%   34.05%   -1.58%     
==========================================
  Files          92      100       +8     
  Lines       11344    11879     +535     
==========================================
+ Hits         4042     4045       +3     
- Misses       6909     7441     +532     
  Partials      393      393              

Impacted Files	Coverage Δ
cmd/addplugins.go	0.00% <0.00%> (ø)
cmd/addtags.go	0.00% <0.00%> (ø)
cmd/convert.go	0.00% <0.00%> (ø)
cmd/file.go	0.00% <0.00%> (ø)
cmd/listtags.go	0.00% <0.00%> (ø)
cmd/merge.go	0.00% <0.00%> (ø)
cmd/openapi2kong.go	0.00% <0.00%> (ø)
cmd/patch.go	0.00% <0.00%> (ø)
cmd/removetags.go	0.00% <0.00%> (ø)
cmd/root.go	0.91% <16.66%> (+0.91%)	⬆️

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[GGabriele]

Added a few minor comments and suggestions. On top of those, I noticed that new commands' descriptions are not always consistent: most of them use the third person (AddS, ListsS) while this is not done for penapi2kong Convert .... Also existing decK commands don't use the third person either.

For consistency, can we consolidate on not using the third person anywhere?

$ ./deck file
Sub-command to host the decK file manipulation operations.

Usage:
  deck file [command]

Available Commands:
  add-plugins  Adds plugins to objects in a decK file
  add-tags     Adds tags to objects in a decK file
  convert      Convert files from one format into another format
  list-tags    Lists current tags to objects in a decK file
  merge        Merges multiple decK files into one
  openapi2kong Convert OpenAPI files to Kong's decK format
  patch        Applies patches on top of a decK file
  remove-tags  Removes tags from objects in a decK file
  validate     Validate the state file