fixed some OPENAPI tag bugs

Author: eadwinCode

ellar/core/routing/operation_definitions.py

@@ -281,7 +281,7 @@ def _decorator(endpoint_handler: TCallable) -> TCallable:
 
     def ws_route(
         self,
-        path: str,
+        path: str = "/",
         *,
         name: str = None,
         encoding: str = "json",

ellar/core/routing/router/module.py

@@ -66,7 +66,7 @@ def __init__(
         app: ASGIApp = None,
         routes: t.Sequence[BaseRoute] = None,
         name: str = None,
-        tag: str = NOT_SET,
+        tag: t.Optional[str] = NOT_SET,
         description: str = None,
         external_doc_description: str = None,
         external_doc_url: str = None,

ellar/openapi/builder.py

@@ -210,7 +210,8 @@ def build_document(self, app: App) -> OpenAPI:
         for route_model in openapi_route_models:
             if isinstance(route_model, OpenAPIMountDocumentation):
                 data = route_model.get_tag()
-                self._build.setdefault("tags", []).append(data)
+                if data:
+                    self._build.setdefault("tags", []).append(data)
         if components:
             self._build.setdefault("components", {}).update(components)
         return OpenAPI(**self._build)

ellar/openapi/route_doc_models.py

@@ -75,7 +75,7 @@ def __init__(
 
         self._routes: t.List["OpenAPIRouteDocumentation"] = self._build_routes()
 
-    def get_tag(self) -> t.Dict:
+    def get_tag(self) -> t.Optional[t.Dict]:
         external_doc = None
         if self.external_doc_url:
             external_doc = dict(
@@ -86,7 +86,7 @@ def get_tag(self) -> t.Dict:
             return dict(
                 name=self.tag, description=self.description, externalDocs=external_doc
             )
-        return dict()
+        return None
 
     def _build_routes(self) -> t.List["OpenAPIRouteDocumentation"]:
         reflector: Reflector = Reflector()
@@ -96,13 +96,12 @@ def _build_routes(self) -> t.List["OpenAPIRouteDocumentation"]:
             if isinstance(route, RouteOperation) and route.include_in_schema:
                 openapi = reflector.get(OPENAPI_KEY, route.endpoint) or dict()
                 guards = reflector.get(GUARDS_KEY, route.endpoint)
-
+                openapi.setdefault("tags", [self.tag] if self.tag else ["default"])
                 _routes.append(
                     OpenAPIRouteDocumentation(
                         route=route,
                         global_route_parameters=self.global_route_parameters,
                         guards=guards or self.global_guards,
-                        tags=[self.tag],
                         **openapi,
                     )
                 )