Add support for multiple examples per client repo

In Lettuce we have multiple APIs (async, reactive, etc) and should provide examples for each API variant. To achieve it multiple changes were introduced:
- Add "label" attribute in clients configs and refer to the client example by label instead of language
- Remove hardcoded mapping Label -> Lang from the config.toml
- Prefix copied examples with client name to allow identical naming
- Add configs for Lettuce Async and Reactive APIs

Author: uglide

build/components/component.py

@@ -1,6 +1,8 @@
 import logging
 import glob
 import os
+import shutil
+
 import semver
 import uuid
 from typing import Tuple
@@ -514,13 +516,20 @@ def _copy_examples(self):
                 if not example_id:
                     continue
 
-                example_metadata = {'source': f}
+                example_metadata = {
+                    'source': f,
+                    'language': self.get('language').lower()
+                }
+
+                base_path = os.path.join(dst, example_id)
+                mkdir_p(base_path)
+                rsync(example_metadata['source'], base_path)
 
-                mkdir_p(f'{dst}/{example_id}')
-                rsync(example_metadata['source'], f'{dst}/{example_id}/')
+                target_path = os.path.join(base_path, f'{self.get("id")}_{os.path.basename(f)}')
+                shutil.move(os.path.join(base_path, os.path.basename(f)), target_path)
 
-                example_metadata['target'] = f'{dst}/{example_id}/{os.path.basename(f)}'
-                e = Example(self.get('language'), example_metadata['target'])
+                example_metadata['target'] = target_path
+                e = Example(self.get('language'), target_path)
                 example_metadata['highlight'] = e.highlight
                 example_metadata['hidden'] = e.hidden
                 example_metadata['named_steps'] = e.named_steps
@@ -532,7 +541,7 @@ def _copy_examples(self):
                     examples[example_id] = {}
 
                 logging.info(f'Example {example_id} processed successfully.')
-                examples[example_id][self.get('language')] = example_metadata
+                examples[example_id][self.get('label')] = example_metadata
 
     def apply(self) -> None:
         logging.info(f'Applying client {self._id}')

config.toml

@@ -45,7 +45,7 @@ tagManagerId = "GTM-TKZ6J9R"
 gitHubRepo = "https://github.com/redis/docs"
 
 # Display and sort order for client examples
-clientsExamples = ["Python", "Node.js", "Java", "Go", "C#", "RedisVL"]
+clientsExamples = ["Python", "Node.js", "Java Sync", "Java Async", "Java Reactive", "Go", "C#", "RedisVL"]
 searchService = "/convai/api/search-service"
 ratingsService = "/docusight/api/rate"
 
@@ -57,12 +57,14 @@ rdi_db_types = "cassandra|mysql|oracle|postgresql|sqlserver"
 rdi_cli_latest = "latest"
 
 [params.clientsConfig]
-"Python"={lang="python", quickstartSlug="python/redis-py"}
-"Node.js"={lang="javascript", quickstartSlug="nodejs"}
-"Java"={lang="java", quickstartSlug="java/jedis"}
-"Go"={lang="go", quickstartSlug="go"}
-"C#"={lang="C#", quickstartSlug="dotnet"}
-"RedisVL"={lang="python", quickstartSlug="python/redis-vl"}
+"Python"={quickstartSlug="python/redis-py"}
+"Node.js"={quickstartSlug="nodejs"}
+"Java sync"={quickstartSlug="java/jedis"}
+"Java async"={quickstartSlug="java/lettuce"}
+"Java reactive"={quickstartSlug="java/lettuce"}
+"Go"={quickstartSlug="go"}
+"C#"={quickstartSlug="dotnet"}
+"RedisVL"={quickstartSlug="python/redis-vl"}
 
 # Markup
 [markup]

data/components/go_redis.json

@@ -3,6 +3,7 @@
   "type": "client",
   "name": "go-redis",
   "language": "Go",
+  "label": "Go",
   "repository": {
       "git_uri": "https://github.com/redis/go-redis"
   },

data/components/index.json

@@ -12,6 +12,8 @@
         "node_redis",
         "redis_py",
         "jedis",
+        "lettuce_async",
+        "lettuce_reactive",
         "redis_vl"
     ],
     "assets": [],

data/components/jedis.json

@@ -3,6 +3,7 @@
   "type": "client",
   "name": "jedis",
   "language": "Java",
+  "label": "Java Sync",
   "repository": {
       "git_uri": "https://github.com/redis/jedis"
   },

data/components/lettuce_async.json

@@ -0,0 +1,16 @@
+{
+  "id": "lettuce_async",
+  "type": "client",
+  "name": "lettuce_async",
+  "language": "Java",
+  "label": "Java Async",
+  "repository": {
+      "git_uri": "https://github.com/redis/lettuce"
+  },
+  "examples": {
+      "git_uri": "/home/imalinovskyi/playground/lettuce-src",
+      "dev_branch": "doctests",
+      "path": "src/test/java/io/redis/examples/async",
+      "pattern": "*.java"
+  }
+}

data/components/lettuce_reactive.json

@@ -0,0 +1,16 @@
+{
+  "id": "lettuce_reactive",
+  "type": "client",
+  "name": "lettuce_reactive",
+  "language": "Java",
+  "label": "Java Reactive",
+  "repository": {
+      "git_uri": "https://github.com/redis/lettuce"
+  },
+  "examples": {
+      "git_uri": "/home/imalinovskyi/playground/lettuce-src",
+      "dev_branch": "doctests",
+      "path": "src/test/java/io/redis/examples/reactive",
+      "pattern": "*.java"
+  }
+}

data/components/node_redis.json

@@ -3,6 +3,7 @@
     "type": "client",
     "name": "node-redis",
     "language": "Node.js",
+    "label": "Node.js",
     "repository": {
         "git_uri": "https://github.com/redis/node-redis"
     },

data/components/nredisstack.json

@@ -3,6 +3,7 @@
   "type": "client",
   "name": "NRedisStack",
   "language": "C#",
+  "label": "C#",
   "repository": {
       "git_uri": "https://github.com/redis/NRedisStack"
   },

data/components/redis_py.json

@@ -3,6 +3,7 @@
     "type": "client",
     "name": "redis-py",
     "language": "Python",
+    "label": "Python",
     "repository": {
         "git_uri": "https://github.com/redis/redis-py"
     },