Add AsyncAPI schema serving with cli command

Makefile

@@ -25,7 +25,7 @@ format: .pdm
 
 .PHONY: lint  ## Lint python source files
 lint: .pdm
-	pdm run ruff $(sources)
+	pdm run ruff check $(sources)
 	pdm run ruff format --check $(sources)
 
 .PHONY: codespell  ## Use Codespell to do spellchecking

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "message-flow"
-version = "0.3.3"
+version = "0.3.4"
 description = "Asynchronous Communication Framework"
 authors = [
     {name = "Valentin Vorobyev", email = "[email protected]"},

src/message_flow/cli/cli_app.py

@@ -24,7 +24,7 @@ class CLIApp:
         },
     )
 
-    def __init__(self, app_path: str, log_level: LoggingLevel) -> None:
+    def __init__(self, app_path: str, log_level: LoggingLevel = LoggingLevel.INFO) -> None:
         self.app_path = app_path
 
         self.instance.set_logging_level(self.LOGGING_LEVELS[log_level])
@@ -77,6 +77,9 @@ def instance(self) -> MessageFlow:
     def dispatch(self) -> None:
         self.instance.dispatch()
 
+    def make_async_api_schema(self) -> str:
+        return self.instance.make_async_api_schema()
+
     def _import(self) -> MessageFlow:
         spec = spec_from_file_location(
             "mode",

src/message_flow/cli/main.py

@@ -1,5 +1,6 @@
 import typer
 
+from .async_api_schema import serve_schema
 from .cli_app import CLIApp
 from .logging_level import LoggingLevel
 
@@ -29,8 +30,31 @@ def dispatch(
     ),
 ):
     """
-    Shoot the portal gun
+    Starts message dispatching
     """
     cli_app = CLIApp(app, log_level)
 
     cli_app.dispatch()
+
+
+@cli.command()
+def docs(
+    app: str = typer.Argument(
+        ...,
+        help="[python_module:MessageFlow] - path to your application",
+    ),
+    host: str = typer.Option(
+        "localhost",
+        help="documentation hosting address",
+    ),
+    port: int = typer.Option(
+        8000,
+        help="documentation hosting port",
+    ),
+):
+    """
+    Starts Async API schema serving
+    """
+    cli_app = CLIApp(app)
+
+    serve_schema(schema=cli_app.make_async_api_schema(), host=host, port=port)