chore(batch): deprecate sqs_batch_processor (#1463)

Author: rubenfonseca

aws_lambda_powertools/utilities/batch/sqs.py

@@ -6,6 +6,7 @@
 import logging
 import math
 import sys
+import warnings
 from concurrent.futures import ThreadPoolExecutor, as_completed
 from typing import Any, Callable, Dict, List, Optional, Tuple, cast
 
@@ -77,6 +78,14 @@ def __init__(
         self.suppress_exception = suppress_exception
         self.max_message_batch = 10
 
+        warnings.warn(
+            "The sqs_batch_processor decorator and PartialSQSProcessor class are now deprecated, "
+            "and will be removed in the next major version. "
+            "Please follow the upgrade guide at "
+            "https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/batch/#legacy "
+            "to use the native batch_processor decorator or BatchProcessor class."
+        )
+
         super().__init__()
 
     def _get_queue_url(self) -> Optional[str]:

docs/overrides/main.html

@@ -1,5 +1,10 @@
 {% extends "base.html" %}
 
+{% block announce %}
+  👋 Powertools for Python v2 is coming soon!
+  We encourage you to add your feedback and follow the progress on <a href="https://github.com/awslabs/aws-lambda-powertools-python/issues/1459">the RFC</a>.
+{% endblock %}
+
 {% block outdated %}
   You're not viewing the latest version.
   <a href="{{ '../' ~ base_url }}">

docs/utilities/batch.md

@@ -5,6 +5,11 @@ description: Utility
 
 The batch processing utility handles partial failures when processing batches from Amazon SQS, Amazon Kinesis Data Streams, and Amazon DynamoDB Streams.
 
+???+ warning
+    The legacy `sqs_batch_processor` decorator and `PartialSQSProcessor` class are deprecated and are going to be removed soon.
+
+    Please check the [migration guide](#migration-guide) for more information.
+
 ## Key Features
 
 * Reports batch item failures to reduce number of retries for a record upon errors

mkdocs.yml

@@ -47,6 +47,7 @@ theme:
         icon: material/toggle-switch
         name: Switch to light mode
   features:
+    - header.autohide
     - navigation.sections
     - navigation.expand
     - navigation.top