sagemaker-core 0.1.3__py3-none-any.whl → 1.0.1__py3-none-any.whl

sagemaker_core/tools/shapes_codegen.py

@@ -17,14 +17,19 @@ export PYTHONPATH=<sagemaker-code-gen repo directory>:$PYTHONPATH
 """
 import os
 
-from sagemaker_core.code_injection.codec import pascal_to_snake
+from sagemaker_core.main.code_injection.codec import pascal_to_snake
 from sagemaker_core.tools.constants import (
     LICENCES_STRING,
     GENERATED_CLASSES_LOCATION,
     SHAPES_CODEGEN_FILE_NAME,
 )
 from sagemaker_core.tools.shapes_extractor import ShapesExtractor
-from sagemaker_core.util.util import add_indent, convert_to_snake_case, remove_html_tags
+from sagemaker_core.main.utils import (
+    add_indent,
+    convert_to_snake_case,
+    remove_html_tags,
+    escape_special_rst_characters,
+)
 from sagemaker_core.tools.templates import SHAPE_CLASS_TEMPLATE, SHAPE_BASE_CLASS_TEMPLATE
 from sagemaker_core.tools.data_extractor import (
     load_combined_shapes_data,
@@ -166,20 +171,21 @@ class ShapesCodeGen:
         """
         shape_dict = self.combined_shapes[shape]
 
-        docstring = f" {shape}"
+        docstring = f"{shape}"
         if "documentation" in shape_dict:
-            docstring += f"\n \t  {shape_dict['documentation']}"
+            docstring += f"\n  {shape_dict['documentation']}"
 
-        docstring += "\n\n \t Attributes"
-        docstring += "\n\t----------------------"
+        docstring += "\n\nAttributes"
+        docstring += "\n----------------------"
 
         if "members" in shape_dict:
             for member, member_attributes in shape_dict["members"].items():
-                docstring += f"\n \t{convert_to_snake_case(member)}"
+                docstring += f"\n{convert_to_snake_case(member)}"
                 if "documentation" in member_attributes:
-                    docstring += f": \t {member_attributes['documentation']}"
+                    docstring += f": {member_attributes['documentation']}"
 
-        return remove_html_tags(docstring)
+        docstring = remove_html_tags(docstring)
+        return escape_special_rst_characters(docstring)
 
     def generate_license(self):
         """
@@ -200,7 +206,7 @@ class ShapesCodeGen:
         imports += "\n"
         imports += "from pydantic import BaseModel, ConfigDict\n"
         imports += "from typing import List, Dict, Optional, Any, Union\n"
-        imports += "from sagemaker_core.generated.utils import Unassigned"
+        imports += "from sagemaker_core.main.utils import Unassigned"
         imports += "\n"
         return imports
 

sagemaker_core/tools/shapes_extractor.py

@@ -17,7 +17,7 @@ from functools import lru_cache
 from typing import Optional, Any
 
 from sagemaker_core.tools.constants import BASIC_JSON_TYPES_TO_PYTHON_TYPES, SHAPE_DAG_FILE_PATH
-from sagemaker_core.util.util import (
+from sagemaker_core.main.utils import (
     reformat_file_with_black,
     convert_to_snake_case,
     snake_to_pascal,

sagemaker_core/tools/templates.py

@@ -35,6 +35,7 @@ Raises:
 CREATE_METHOD_TEMPLATE = """
 @classmethod
 @populate_inputs_decorator
+@Base.add_validate_call
 def create(
     cls,
 {create_args}
@@ -42,7 +43,7 @@ def create(
     region: Optional[str] = None,
 ) -> Optional["{resource_name}"]:
 {docstring}
-    logger.debug("Creating {resource_lower} resource.")
+    logger.info("Creating {resource_lower} resource.")
     client = Base.get_sagemaker_client(session=session, region_name=region, service_name='{service_name}')
 
     operation_input_args = {{
@@ -53,7 +54,7 @@ def create(
         
     logger.debug(f"Input request: {{operation_input_args}}")
     # serialize the input request
-    operation_input_args = cls._serialize_args(operation_input_args)
+    operation_input_args = serialize(operation_input_args)
     logger.debug(f"Serialized input request: {{operation_input_args}}")
 
     # create the resource
@@ -65,6 +66,7 @@ def create(
 
 CREATE_METHOD_TEMPLATE_WITHOUT_DEFAULTS = """
 @classmethod
+@Base.add_validate_call
 def create(
     cls,
 {create_args}
@@ -72,7 +74,7 @@ def create(
     region: Optional[str] = None,
 ) -> Optional["{resource_name}"]:
 {docstring}
-    logger.debug("Creating {resource_lower} resource.")
+    logger.info("Creating {resource_lower} resource.")
     client =Base.get_sagemaker_client(session=session, region_name=region, service_name='{service_name}')
 
     operation_input_args = {{
@@ -83,7 +85,7 @@ def create(
         
     logger.debug(f"Input request: {{operation_input_args}}")
     # serialize the input request
-    operation_input_args = cls._serialize_args(operation_input_args)
+    operation_input_args = serialize(operation_input_args)
     logger.debug(f"Serialized input request: {{operation_input_args}}")
 
     # create the resource
@@ -95,6 +97,7 @@ def create(
 
 IMPORT_METHOD_TEMPLATE = """
 @classmethod
+@Base.add_validate_call
 def load(
     cls,
 {import_args}
@@ -102,7 +105,7 @@ def load(
     region: Optional[str] = None,
 ) -> Optional["{resource_name}"]:
 {docstring}
-    logger.debug(f"Importing {resource_lower} resource.")
+    logger.info(f"Importing {resource_lower} resource.")
     client = SageMakerClient(session=session, region_name=region, service_name='{service_name}').client
 
     operation_input_args = {{
@@ -111,7 +114,7 @@ def load(
 
     logger.debug(f"Input request: {{operation_input_args}}")
     # serialize the input request
-    operation_input_args = cls._serialize_args(operation_input_args)
+    operation_input_args = serialize(operation_input_args)
     logger.debug(f"Serialized input request: {{operation_input_args}}")
 
     # import the resource
@@ -142,12 +145,13 @@ def get_name(self) -> str:
 
 UPDATE_METHOD_TEMPLATE = """
 @populate_inputs_decorator
+@Base.add_validate_call
 def update(
     self,
 {update_args}
 ) -> Optional["{resource_name}"]:
 {docstring}
-    logger.debug("Updating {resource_lower} resource.")
+    logger.info("Updating {resource_lower} resource.")
     client = Base.get_sagemaker_client()
 
     operation_input_args = {{
@@ -155,7 +159,7 @@ def update(
     }}
     logger.debug(f"Input request: {{operation_input_args}}")
     # serialize the input request
-    operation_input_args = {resource_name}._serialize_args(operation_input_args)
+    operation_input_args = serialize(operation_input_args)
     logger.debug(f"Serialized input request: {{operation_input_args}}")
 
     # create the resource
@@ -168,12 +172,13 @@ def update(
 
 
 UPDATE_METHOD_TEMPLATE_WITHOUT_DECORATOR = """
+@Base.add_validate_call
 def update(
     self,
 {update_args}
 ) -> Optional["{resource_name}"]:
 {docstring}
-    logger.debug("Updating {resource_lower} resource.")
+    logger.info("Updating {resource_lower} resource.")
     client = Base.get_sagemaker_client()
 
     operation_input_args = {{
@@ -181,7 +186,7 @@ def update(
     }}
     logger.debug(f"Input request: {{operation_input_args}}")
     # serialize the input request
-    operation_input_args = {resource_name}._serialize_args(operation_input_args)
+    operation_input_args = serialize(operation_input_args)
     logger.debug(f"Serialized input request: {{operation_input_args}}")
 
     # create the resource
@@ -193,18 +198,19 @@ def update(
 """
 
 INVOKE_METHOD_TEMPLATE = """
+@Base.add_validate_call
 def invoke(self, 
 {invoke_args}
 ) -> Optional[object]:
 {docstring}
-    logger.debug(f"Invoking {resource_lower} resource.")
+    logger.info(f"Invoking {resource_lower} resource.")
     client = SageMakerRuntimeClient(service_name="{service_name}").client
     operation_input_args = {{
 {operation_input_args}
     }}
     logger.debug(f"Input request: {{operation_input_args}}")
     # serialize the input request
-    operation_input_args = {resource_name}._serialize_args(operation_input_args)
+    operation_input_args = serialize(operation_input_args)
     logger.debug(f"Serialized input request: {{operation_input_args}}")
 
     # create the resource
@@ -215,11 +221,12 @@ def invoke(self,
 """
 
 INVOKE_ASYNC_METHOD_TEMPLATE = """
+@Base.add_validate_call
 def invoke_async(self, 
 {create_args}
 ) -> Optional[object]:
 {docstring}
-    logger.debug(f"Invoking {resource_lower} resource Async.")
+    logger.info(f"Invoking {resource_lower} resource Async.")
     client = SageMakerRuntimeClient(service_name="{service_name}").client
     
     operation_input_args = {{
@@ -227,7 +234,7 @@ def invoke_async(self,
     }}
     logger.debug(f"Input request: {{operation_input_args}}")
     # serialize the input request
-    operation_input_args = {resource_name}._serialize_args(operation_input_args)
+    operation_input_args = serialize(operation_input_args)
     logger.debug(f"Serialized input request: {{operation_input_args}}")
 
     # create the resource
@@ -238,11 +245,12 @@ def invoke_async(self,
 """
 
 INVOKE_WITH_RESPONSE_STREAM_METHOD_TEMPLATE = """
+@Base.add_validate_call
 def invoke_with_response_stream(self, 
 {create_args}
 ) -> Optional[object]:
 {docstring}
-    logger.debug(f"Invoking {resource_lower} resource with Response Stream.")
+    logger.info(f"Invoking {resource_lower} resource with Response Stream.")
     client = SageMakerRuntimeClient(service_name="{service_name}").client
 
     operation_input_args = {{
@@ -250,7 +258,7 @@ def invoke_with_response_stream(self,
     }}
     logger.debug(f"Input request: {{operation_input_args}}")
     # serialize the input request
-    operation_input_args = {resource_name}._serialize_args(operation_input_args)
+    operation_input_args = serialize(operation_input_args)
     logger.debug(f"Serialized input request: {{operation_input_args}}")
 
     # create the resource
@@ -260,7 +268,6 @@ def invoke_with_response_stream(self,
     return response
 """
 
-
 POPULATE_DEFAULTS_DECORATOR_TEMPLATE = """
 def populate_inputs_decorator(create_func):
     @functools.wraps(create_func)
@@ -273,6 +280,7 @@ def populate_inputs_decorator(create_func):
 
 GET_METHOD_TEMPLATE = """
 @classmethod
+@Base.add_validate_call
 def get(
     cls,
 {describe_args}
@@ -286,7 +294,7 @@ def get(
     client = Base.get_sagemaker_client(session=session, region_name=region, service_name='{service_name}')
     response = client.{operation}(**operation_input_args)
 
-    pprint(response)
+    logger.debug(response)
 
     # deserialize the response
     transformed_response = transform(response, '{describe_operation_output_shape}')
@@ -295,6 +303,7 @@ def get(
 """
 
 REFRESH_METHOD_TEMPLATE = """
+@Base.add_validate_call
 def refresh(
     self,
  {refresh_args}   
@@ -317,6 +326,7 @@ if "failed" in current_status.lower():
 """
 
 WAIT_METHOD_TEMPLATE = '''
+@Base.add_validate_call
 def wait(
     self,
     poll: int = 5,
@@ -338,25 +348,34 @@ def wait(
     terminal_states = {terminal_resource_states}
     start_time = time.time()
 
-    while True:
-        self.refresh()
-        current_status = self{status_key_path}
+    progress = Progress(SpinnerColumn("bouncingBar"),
+        TextColumn("{{task.description}}"),
+        TimeElapsedColumn(),
+    )
+    progress.add_task("Waiting for {resource_name}...")
+    status = Status("Current status:")
+
+    with Live(Panel(Group(progress, status), title="Wait Log Panel", border_style=Style(color=Color.BLUE.value))):
+        while True:
+            self.refresh()
+            current_status = self{status_key_path}
+            status.update(f"Current status: [bold]{{current_status}}")
 
-        if current_status in terminal_states:
-            print(f"\\nFinal Resource Status: {{current_status}}")
+            if current_status in terminal_states:
+                logger.info(f"Final Resource Status: [bold]{{current_status}}")
 {failed_error_block}
-            return
+                return
 
-        if timeout is not None and time.time() - start_time >= timeout:
-            raise TimeoutExceededError(resouce_type="{resource_name}", status=current_status)
-        print("-", end="")
-        time.sleep(poll)
+            if timeout is not None and time.time() - start_time >= timeout:
+                raise TimeoutExceededError(resouce_type="{resource_name}", status=current_status)
+            time.sleep(poll)
 '''
 
 WAIT_FOR_STATUS_METHOD_TEMPLATE = '''
+@Base.add_validate_call
 def wait_for_status(
     self,
-    status: Literal{resource_states},
+    target_status: Literal{resource_states},
     poll: int = 5,
     timeout: Optional[int] = None
 ) -> None:
@@ -364,7 +383,7 @@ def wait_for_status(
     Wait for a {resource_name} resource to reach certain status.
     
     Parameters:
-        status: The status to wait for.
+        target_status: The status to wait for.
         poll: The number of seconds to wait between each poll.
         timeout: The maximum number of seconds to wait before timing out.
     
@@ -375,21 +394,30 @@ def wait_for_status(
     """
     start_time = time.time()
 
-    while True:
-        self.refresh()
-        current_status = self{status_key_path}
+    progress = Progress(SpinnerColumn("bouncingBar"),
+        TextColumn("{{task.description}}"),
+        TimeElapsedColumn(),
+    )
+    progress.add_task(f"Waiting for {resource_name} to reach [bold]{{target_status}} status...")
+    status = Status("Current status:")
+
+    with Live(Panel(Group(progress, status), title="Wait Log Panel", border_style=Style(color=Color.BLUE.value))):
+        while True:
+            self.refresh()
+            current_status = self{status_key_path}
+            status.update(f"Current status: [bold]{{current_status}}")
 
-        if status == current_status:
-            print(f"\\nFinal Resource Status: {{current_status}}")
-            return
+            if target_status == current_status:
+                logger.info(f"Final Resource Status: [bold]{{current_status}}")
+                return
 {failed_error_block}
-        if timeout is not None and time.time() - start_time >= timeout:
-            raise TimeoutExceededError(resouce_type="{resource_name}", status=current_status)
-        print("-", end="")
-        time.sleep(poll)
+            if timeout is not None and time.time() - start_time >= timeout:
+                raise TimeoutExceededError(resouce_type="{resource_name}", status=current_status)
+            time.sleep(poll)
 '''
 
 WAIT_FOR_DELETE_METHOD_TEMPLATE = '''
+@Base.add_validate_call
 def wait_for_delete(
     self,
     poll: int = 5,
@@ -418,25 +446,32 @@ def wait_for_delete(
     """
     start_time = time.time()
 
-    while True:
-        try:
-            self.refresh()
-            current_status = self{status_key_path}
+    progress = Progress(SpinnerColumn("bouncingBar"),
+        TextColumn("{{task.description}}"),
+        TimeElapsedColumn(),
+    )
+    progress.add_task("Waiting for {resource_name} to be deleted...")
+    status = Status("Current status:")
+
+    with Live(Panel(Group(progress, status), title="Wait Log Panel", border_style=Style(color=Color.BLUE.value))):
+        while True:
+            try:
+                self.refresh()
+                current_status = self{status_key_path}
+                status.update(f"Current status: [bold]{{current_status}}")
 {delete_failed_error_block}
 {deleted_status_check}
 
-            if timeout is not None and time.time() - start_time >= timeout:
-                raise TimeoutExceededError(resouce_type="{resource_name}", status=current_status)
-        except botocore.exceptions.ClientError as e:
-            error_code = e.response["Error"]["Code"]
-            
-            if "ResourceNotFound" in error_code or "ValidationException" in error_code:
-                print("Resource was not found. It may have been deleted.")
-                return
-            raise e
-        
-        print("-", end="")
-        time.sleep(poll)
+                if timeout is not None and time.time() - start_time >= timeout:
+                    raise TimeoutExceededError(resouce_type="{resource_name}", status=current_status)
+            except botocore.exceptions.ClientError as e:
+                error_code = e.response["Error"]["Code"]
+                
+                if "ResourceNotFound" in error_code or "ValidationException" in error_code:
+                    logger.info("Resource was not found. It may have been deleted.")
+                    return
+                raise e
+            time.sleep(poll)
 '''
 
 DELETE_FAILED_STATUS_CHECK = """
@@ -451,6 +486,7 @@ if current_status.lower() == "deleted":
 """
 
 DELETE_METHOD_TEMPLATE = """
+@Base.add_validate_call
 def delete(
     self,
 {delete_args}
@@ -467,6 +503,7 @@ def delete(
 """
 
 STOP_METHOD_TEMPLATE = """
+@Base.add_validate_call
 def stop(self) -> None:
 {docstring}
     client = SageMakerClient().client
@@ -475,10 +512,13 @@ def stop(self) -> None:
 {operation_input_args}
     }}
     client.{operation}(**operation_input_args)
+
+    logger.info(f"Stopping {{self.__class__.__name__}} - {{self.get_name()}}")
 """
 
 GET_ALL_METHOD_WITH_ARGS_TEMPLATE = """
 @classmethod
+@Base.add_validate_call
 def get_all(
     cls,
 {get_all_args}
@@ -501,6 +541,7 @@ def get_all(
 
 GET_ALL_METHOD_NO_ARGS_TEMPLATE = '''
 @classmethod
+@Base.add_validate_call
 def get_all(
     cls,
     session: Optional[Session] = None,
@@ -526,6 +567,7 @@ def get_all(
 
 GENERIC_METHOD_TEMPLATE = """
 {decorator}
+@Base.add_validate_call
 def {method_name}(
 {method_args}
 ) -> {return_type}:
@@ -586,44 +628,6 @@ class Base(BaseModel):
     def get_sagemaker_client(cls, session = None, region_name = None, service_name = 'sagemaker'):
         return SageMakerClient(session=session, region_name=region_name, service_name=service_name).client
     
-    @classmethod
-    def _serialize_args(cls, value: dict) -> dict:
-        serialized_dict = {}
-        for k, v in value.items():
-            if serialize_result := cls._serialize(v):
-                serialized_dict.update({k: serialize_result})
-        return serialized_dict
-
-    @classmethod
-    def _serialize(cls, value: any) -> any:
-        if isinstance(value, Unassigned):
-            return None
-        elif isinstance(value, List):
-            return cls._serialize_list(value)
-        elif is_not_primitive(value) and not isinstance(value, dict):
-            return cls._serialize_object(value)
-        elif hasattr(value, "serialize"):
-            return value.serialize()
-        else:
-            return value
-
-    @classmethod
-    def _serialize_list(cls, value: List):
-        serialized_list = []
-        for v in value:
-            if serialize_result := cls._serialize(v):
-                serialized_list.append(serialize_result)
-        return serialized_list
-
-    @classmethod
-    def _serialize_object(cls, value: any):
-        serialized_dict = {}
-        for k, v in vars(value).items():
-            if serialize_result := cls._serialize(v):
-                key = snake_to_pascal(k) if is_snake_case(k) else k
-                serialized_dict.update({key[0].upper() + key[1:]: serialize_result})
-        return serialized_dict
-    
     @staticmethod
     def get_updated_kwargs_with_configured_attributes(
         config_schema_for_resource: dict, resource_name: str, **kwargs
@@ -644,7 +648,7 @@ class Base(BaseModel):
                         class_object = globals()[resource_name]
                         kwargs[configurable_attribute] = class_object(**config_value)
         except BaseException as e:
-            logger.info("Could not load Default Configs. Continuing.", exc_info=True)
+            logger.debug("Could not load Default Configs. Continuing.", exc_info=True)
             # Continue with existing kwargs if no default configs found
         return kwargs 
         
@@ -685,7 +689,7 @@ class Base(BaseModel):
         return updated_args
 
     @staticmethod
-    def _get_chained_attribute(item_value: any):
+    def _get_chained_attribute(item_value: Any):
         resource_name = type(item_value).__name__
         class_object = globals()[resource_name]
         return class_object(**Base.populate_chained_attributes(
@@ -693,42 +697,25 @@ class Base(BaseModel):
             operation_input_args=vars(item_value)
         ))
 
-        
+    @staticmethod
+    def add_validate_call(func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            config = dict(arbitrary_types_allowed=True)
+            return validate_call(config=config)(func)(*args, **kwargs)
+        return wrapper
+
 """
 
 SHAPE_BASE_CLASS_TEMPLATE = """
 class {class_name}:
     model_config = ConfigDict(protected_namespaces=(), validate_assignment=True)
-    
-    def serialize(self):
-        result = {{}}
-        for attr, value in self.__dict__.items():
-            if isinstance(value, Unassigned):
-                continue
-            
-            components = attr.split('_')
-            pascal_attr = ''.join(x.title() for x in components[0:])
-            if isinstance(value, List):
-                result[pascal_attr] = self._serialize_list(value)
-            elif isinstance(value, Dict):
-                result[pascal_attr] = self._serialize_dict(value)
-            elif hasattr(value, 'serialize'):
-                result[pascal_attr] = value.serialize()
-            else:
-                result[pascal_attr] = value
-        return result
-
-    def _serialize_list(self, value: List):
-        return [v.serialize() if hasattr(v, 'serialize') else v for v in value]
-    
-    def _serialize_dict(self, value: Dict):
-        return {{k: v.serialize() if hasattr(v, 'serialize') else v for k, v in value.items()}}
 """
 
 SHAPE_CLASS_TEMPLATE = '''
 class {class_name}:
     """
-    {docstring}
+{docstring}
     """
 {data_class_members}
 

sagemaker_core-1.0.1.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.1
+Name: sagemaker-core
+Version: 1.0.1
+Summary: An python package for sagemaker core functionalities
+Author-email: AWS <sagemaker-interests@amazon.com>
+Project-URL: Repository, https://github.com/aws/sagemaker-core.git
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: boto3 <2.0.0,>=1.34.0
+Requires-Dist: pydantic <3.0.0,>=1.7.0
+Requires-Dist: PyYAML <7.0,>=6.0
+Requires-Dist: jsonschema <5.0.0
+Requires-Dist: platformdirs <5.0.0,>=4.0.0
+Requires-Dist: rich <14.0.0,>=13.0.0
+Requires-Dist: mock <5.0,>4.0
+Requires-Dist: importlib-metadata <7.0,>=1.4.0
+Provides-Extra: codegen
+Requires-Dist: black <25.0.0,>=24.3.0 ; extra == 'codegen'
+Requires-Dist: pandas <3.0.0,>=2.0.0 ; extra == 'codegen'
+Requires-Dist: pytest <9.0.0,>=8.0.0 ; extra == 'codegen'
+Requires-Dist: pylint <4.0.0,>=3.0.0 ; extra == 'codegen'
+
+.. image:: https://github.com/aws/sagemaker-python-sdk/raw/master/branding/icon/sagemaker-banner.png
+    :height: 100px
+    :alt: SageMaker
+
+====================
+SageMaker Core
+====================
+
+.. image:: https://img.shields.io/pypi/v/sagemaker-core.svg
+   :target: https://pypi.python.org/pypi/sagemaker-core
+   :alt: Latest Version
+
+.. image:: https://img.shields.io/pypi/pyversions/sagemaker-core.svg
+   :target: https://pypi.python.org/pypi/sagemaker-core
+   :alt: Supported Python Versions
+
+
+
+Introduction
+------------
+
+Welcome to the sagemaker-core Python SDK, an SDK designed to provide an object-oriented interface for interacting with Amazon SageMaker resources. It offers full parity with SageMaker APIs, allowing developers to leverage all SageMaker capabilities directly through the SDK. sagemaker-core introduces features such as dedicated resource classes, resource chaining, auto code completion, comprehensive documentation and type hints to enhance the developer experience as well as productivity. 
+
+
+Key Features
+------------
+
+* **Object-Oriented Interface**: Provides a structured way to interact with SageMaker resources, making it easier to manage them using familiar object-oriented programming techniques.
+* **Resource Chaining**: Allows seamless connection of SageMaker resources by passing outputs as inputs between them, simplifying workflows and reducing the complexity of parameter management.
+* **Full Parity with SageMaker APIs**: Ensures access to all SageMaker capabilities through the SDK, providing a comprehensive toolset for building and deploying machine learning models.
+* **Abstraction of Low-Level Details**: Automatically handles resource state transitions and polling logic, freeing developers from managing these intricacies and allowing them to focus on higher-level tasks.
+* **Auto Code Completion**: Enhances the developer experience by offering real-time suggestions and completions in popular IDEs, reducing syntax errors and speeding up the coding process.
+* **Comprehensive Documentation and Type Hints**: Provides detailed guidance and type hints to help developers understand functionalities, write code faster, and reduce errors without complex API navigation.
+* **Incorporation of Intelligent Defaults**: Integrates the previous SageMaker SDK feature of intelligent defaults, allowing developers to set default values for parameters like IAM roles and VPC configurations. This streamlines the setup process, enabling developers to focus on customizations specific to their use case.
+
+
+Benefits
+--------
+
+* **Simplified Development**: By abstracting low-level details and providing intelligent defaults, developers can focus on building and deploying machine learning models without getting bogged down by repetitive tasks.
+* **Increased Productivity**: The SDK's features, such as auto code completion and type hints, help developers write code faster and with fewer errors.
+* **Enhanced Readability**: Resource chaining and dedicated resource classes result in more readable and maintainable code.
+
+
+Docs and Examples
+-----------------
+
+For examples and walkthroughs, see the `SageMaker Core Examples <https://github.com/aws/amazon-sagemaker-examples/tree/default/sagemaker-core>`_.
+
+For detailed documentation, including the API reference, see `Read the Docs <https://sagemaker-core.readthedocs.io>`_.