feat(docs): generate docs from docstrings

.gitignore

@@ -301,7 +301,7 @@ TMP_CHANGELOG.md
 docs/.cache/
 docs/public
 node_modules
-api/
+# api/
 site/
 !404.html
 !docs/overrides/*.html

.markdownlintignore

@@ -1,2 +1,3 @@
 docs/core/metrics/index.md
 includes/abbreviations.md
+docs/api/**

docs/api/event_handler.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler

docs/api/event_handler/api_gateway.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler.api_gateway

docs/api/event_handler/appsync.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler.appsync

docs/api/event_handler/bedrock_agent.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler.bedrock_agent

docs/api/event_handler/content_types.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler.content_types

docs/api/event_handler/exceptions.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler.exceptions

docs/api/event_handler/lambda_function_url.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler.lambda_function_url

docs/api/event_handler/router.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler.router

docs/api/event_handler/types.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler.types

docs/api/event_handler/util.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler.util

docs/api/event_handler/vpc_lattice.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.event_handler.vpc_lattice

docs/api/exceptions.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.exceptions

docs/api/logging.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.logging

docs/api/logging/constants.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.logging.constants

docs/api/logging/correlation_paths.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.logging.correlation_paths

docs/api/logging/exceptions.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.logging.exceptions

docs/api/logging/filters.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.logging.filters

docs/api/logging/formatter.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.logging.formatter

docs/api/logging/lambda_context.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.logging.lambda_context

docs/api/logging/logger.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.logging.logger

docs/api/logging/types.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.logging.types

docs/api/logging/utils.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.logging.utils

docs/api/metrics.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.metrics

docs/api/metrics/base.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.metrics.base

docs/api/metrics/exceptions.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.metrics.exceptions

docs/api/metrics/functions.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.metrics.functions

docs/api/metrics/metric.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.metrics.metric

docs/api/metrics/metrics.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.metrics.metrics

docs/api/metrics/types.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.metrics.types

docs/api/middleware_factory.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.middleware_factory

docs/api/middleware_factory/exceptions.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.middleware_factory.exceptions

docs/api/middleware_factory/factory.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.middleware_factory.factory

docs/api/shared.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared

docs/api/shared/cache_dict.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared.cache_dict

docs/api/shared/constants.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared.constants

docs/api/shared/cookies.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared.cookies

docs/api/shared/functions.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared.functions

docs/api/shared/headers_serializer.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared.headers_serializer

docs/api/shared/json_encoder.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared.json_encoder

docs/api/shared/lazy_import.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared.lazy_import

docs/api/shared/types.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared.types

docs/api/shared/user_agent.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared.user_agent

docs/api/shared/version.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.shared.version

docs/api/tracing.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.tracing

docs/api/tracing/base.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.tracing.base

docs/api/tracing/extensions.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.tracing.extensions

docs/api/tracing/tracer.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.tracing.tracer

docs/api/utilities.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.utilities

docs/api/utilities/serialization.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.utilities.serialization

docs/api/warnings.md

@@ -0,0 +1 @@
+::: aws_lambda_powertools.warnings

mkdocs.yml

@@ -62,6 +62,64 @@ nav:
           #     - Overview: contributing/tracks/overview.md
           #     - Casual to regular contributor: contributing/tracks/casual_regular_contributor.md
           #     - Customer to advocate: contributing/tracks/customer_advocate.md
+  - API:
+    - Event Handler:
+      - api/event_handler.md
+      - api/event_handler/api_gateway.md
+      - api/event_handler/appsync.md
+      - api/event_handler/bedrock_agent.md
+      - api/event_handler/content_types.md
+      - api/event_handler/exceptions.md
+      - api/event_handler/lambda_function_url.md
+      - api/event_handler/router.md
+      - api/event_handler/types.md
+      - api/event_handler/util.md
+      - api/event_handler/vpc_lattice.md
+    - Exceptions: api/exceptions.md
+    - Logging:
+      - api/logging.md
+      - api/logging/constants.md
+      - api/logging/correlation_paths.md
+      - api/logging/exceptions.md
+      - api/logging/filters.md
+      - api/logging/formatter.md
+      - api/logging/lambda_context.md
+      - api/logging/logger.md
+      - api/logging/types.md
+      - api/logging/utils.md
+    - Metrics:
+      - api/metrics.md
+      - api/metrics/base.md
+      - api/metrics/exceptions.md
+      - api/metrics/functions.md
+      - api/metrics/metric.md
+      - api/metrics/metrics.md
+      - api/metrics/types.md
+    - Middleware Factory:
+      - api/middleware_factory.md
+      - api/middleware_factory/exceptions.md
+      - api/middleware_factory/factory.md
+    - Shared:
+      - api/shared.md
+      - api/shared/cache_dict.md
+      - api/shared/constants.md
+      - api/shared/cookies.md
+      - api/shared/functions.md
+      - api/shared/headers_serializer.md
+      - api/shared/json_encoder.md
+      - api/shared/lazy_import.md
+      - api/shared/types.md
+      - api/shared/user_agent.md
+      - api/shared/version.md
+    - Tracing:
+      - api/tracing.md
+      - api/tracing/base.md
+      - api/tracing/extensions.md
+      - api/tracing/tracer.md
+    - Utilities:
+      - api/utilities.md
+      - api/utilities/serialization.md
+    - Warnings: api/warnings.md
 
 theme:
   name: material
@@ -136,6 +194,43 @@ copyright: Copyright © 2023 Amazon Web Services
 plugins:
   - git-revision-date
   - search
+  - mkdocstrings:
+      default_handler: python
+      enable_inventory: true
+      handlers:
+        python:
+          import:
+            - https://docs.python.org/3/objects.inv
+          options:
+            # General
+            allow_inspection: true
+            show_source: true
+            show_bases: true
+            # Headings
+            heading_level: 2
+            show_root_heading: false
+            show_root_toc_entry: true
+            show_root_full_path: true
+            show_root_members_full_path: false
+            show_object_full_path: false
+            show_category_heading: true
+            # Members
+            filters: ["!^_[^_]"]
+            group_by_category: true
+            show_submodules: false
+            # Docstrings
+            docstring_style: numpy
+            docstring_options:
+              ignore_init_summary: true
+            docstring_section_style: spacy
+            merge_init_into_class: true
+            show_if_no_docstring: true
+            # Signature
+            annotations_path: brief
+            show_signature: true
+            show_signature_annotations: true
+            separate_signature: true
+
 
 extra_css:
   - stylesheets/extra.css