Skip to content

Commit

Permalink
[Rename] kbn-spec-to-console in packages directory to osd-spec-to-con…
Browse files Browse the repository at this point in the history
…sole #37 (#57)

* [Rename] kbn-spec-to-console in packages directory to osd-spec-to-console

Signed-off-by: Mihir Soni <mihirsoni.123@gmail.com>

* [Rename] in-corporate review comments

Signed-off-by: Mihir Soni <mihirsoni.123@gmail.com>
  • Loading branch information
mihirsoni authored and kavilla committed Mar 19, 2021
1 parent 3480004 commit 23af201
Show file tree
Hide file tree
Showing 16 changed files with 38 additions and 38 deletions.
36 changes: 0 additions & 36 deletions packages/kbn-spec-to-console/README.md

This file was deleted.

36 changes: 36 additions & 0 deletions packages/osd-spec-to-console/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
\ mini utility to convert [OpenSearch's REST spec](https://github.com/elastic/elasticsearch/blob/master/rest-api-spec) to Console's (OpenSearch Dashboards) autocomplete format.


It is used to semi-manually update Console's autocompletion rules.

### Retrieving the spec

If you don't have a copy of the OpenSearch repo on your machine, follow these steps to clone only the rest API specs

```
mkdir opensearch-spec && cd opensearch-spec
git init
git remote add origin https://github.com/elastic/elasticsearch
git config core.sparsecheckout true
echo "rest-api-spec/src/main/resources/rest-api-spec/api/*\nx-pack/plugin/src/test/resources/rest-api-spec/api/*" > .git/info/sparse-checkout
git pull --depth=1 origin master
```

### Usage

You need to run the command twice: once for the **OSS** specs and once for the **X-Pack** specs
At the root of the OpenSearch Dashboards repository, run the following commands:

```sh
# OSS
yarn spec_to_console -g "<OPENSEARCH-REPO-FOLDER>/rest-api-spec/src/main/resources/rest-api-spec/api/*" -d "src/plugins/console/server/lib/spec_definitions/json/generated"

# X-pack
yarn spec_to_console -g "<OPENSEARCH-REPO-FOLDER>/x-pack/plugin/src/test/resources/rest-api-spec/api/*" -d "x-pack/plugins/console_extensions/server/lib/spec_definitions/json/generated"
```

### Information used in Console that is not available in the REST spec

* Request bodies
* Data fetched at runtime: indices, fields, snapshots, etc
* Ad hoc additions
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "spec-to-console",
"version": "0.0.0",
"description": "ES REST spec -> Console autocomplete",
"description": "OpenSearch REST spec -> Console autocomplete",
"main": "index.js",
"directories": {
"lib": "lib"
Expand All @@ -12,7 +12,7 @@
},
"author": "",
"license": "Apache-2.0",
"kibana": {
"opensearchDashboards": {
"devOnly": true
},
"bugs": {
Expand Down
File renamed without changes.

0 comments on commit 23af201

Please sign in to comment.