fixed openapi specs script

Author: Andrei Neagu

services/notifications/Makefile

@@ -5,14 +5,14 @@ include ../../scripts/common.Makefile
 include ../../scripts/common-service.Makefile
 
 
+.env-ignore:
+	$(APP_CLI_NAME) echo-dotenv > $@
+
 .PHONY: openapi.json
 openapi-specs: openapi.json
-openapi.json: .env
+openapi.json: .env-ignore ## produces openapi.json
 	# generating openapi specs file (need to have the environment set for this)
 	@set -o allexport; \
 	source $<; \
 	set +o allexport; \
 	python3 -c "import json; from $(APP_PACKAGE_NAME).main import *; print( json.dumps(the_app.openapi(), indent=2) )" > $@
-
-	# validates OAS file: $@
-	$(call validate_openapi_specs,$@)

services/notifications/openapi.json

@@ -9,25 +9,13 @@
     {
       "url": "/",
       "description": "Default server: requests directed to serving url"
-    },
-    {
-      "url": "http://{host}:{port}",
-      "description": "Development server: can configure any base url",
-      "variables": {
-        "host": {
-          "default": "127.0.0.1"
-        },
-        "port": {
-          "default": "8000"
-        }
-      }
     }
   ],
   "paths": {
-    "/health": {
+    "/": {
       "get": {
         "summary": "Check Service Health",
-        "operationId": "check_service_health_health_get",
+        "operationId": "check_service_health__get",
         "responses": {
           "200": {
             "description": "Successful Response",

services/notifications/src/simcore_service_notifications/cli.py

@@ -1,14 +1,82 @@
 import logging
+import os
 
 import typer
-from settings_library.utils_cli import create_settings_command, create_version_callback
+from settings_library.postgres import PostgresSettings
+from settings_library.rabbit import RabbitSettings
+from settings_library.utils_cli import (
+    create_settings_command,
+    create_version_callback,
+    print_as_envfile,
+)
 
 from ._meta import APP_NAME, __version__
 from .core.settings import ApplicationSettings
 
 log = logging.getLogger(__name__)
 
-main = typer.Typer(name=APP_NAME)
+main = typer.Typer(
+    name=APP_NAME,
+    pretty_exceptions_enable=False,
+    pretty_exceptions_show_locals=False,
+)
 
 main.command()(create_settings_command(settings_cls=ApplicationSettings, logger=log))
 main.callback()(create_version_callback(__version__))
+
+
+@main.command()
+def echo_dotenv(ctx: typer.Context, *, minimal: bool = True) -> None:
+    """Generates and displays a valid environment variables file (also known as dot-envfile)
+
+    Usage:
+        $ simcore-service echo-dotenv > .env
+        $ cat .env
+        $ set -o allexport; source .env; set +o allexport
+    """
+    assert ctx  # nosec
+
+    # NOTE: we normally DO NOT USE `os.environ` to capture env vars but this is a special case
+    # The idea here is to have a command that can generate a **valid** `.env` file that can be used
+    # to initialized the app. For that reason we fill required fields of the `ApplicationSettings` with
+    # "fake" but valid values (e.g. generating a password or adding tags as `replace-with-api-key).
+    # Nonetheless, if the caller of this CLI has already some **valid** env vars in the environment we want to use them ...
+    # and that is why we use `os.environ`.
+
+    settings = ApplicationSettings.create_from_envs(
+        SC_BOOT_MODE="default",
+        NOTIFICATIONS_POSTGRES=os.environ.get(
+            "NOTIFICATIONS_POSTGRES",
+            PostgresSettings.create_from_envs(
+                POSTGRES_HOST=os.environ.get(
+                    "POSTGRES_HOST", "replace-with-postgres-host"
+                ),
+                POSTGRES_USER=os.environ.get(
+                    "POSTGRES_USER", "replace-with-postgres-user"
+                ),
+                POSTGRES_DB=os.environ.get("POSTGRES_DB", "replace-with-postgres-db"),
+                POSTGRES_PASSWORD=os.environ.get(
+                    "POSTGRES_PASSWORD", "replace-with-postgres-password"
+                ),
+            ),
+        ),
+        NOTIFICATIONS_RABBITMQ=os.environ.get(
+            "NOTIFICATIONS_RABBITMQ",
+            RabbitSettings.create_from_envs(
+                RABBIT_HOST=os.environ.get("RABBIT_HOST", "replace-with-rabbit-host"),
+                RABBIT_SECURE=os.environ.get("RABBIT_SECURE", "True"),
+                RABBIT_USER=os.environ.get("RABBIT_USER", "replace-with-rabbit-user"),
+                RABBIT_PASSWORD=os.environ.get(
+                    "RABBIT_PASSWORD", "replace-with-rabbit-password"
+                ),
+            ),
+        ),
+    )
+
+    print_as_envfile(
+        settings,
+        compact=False,
+        verbose=True,
+        show_secrets=True,
+        exclude_unset=minimal,
+    )