[SchemaRegistry] avro update docstring (Azure#24364)

Author: swathipil

sdk/schemaregistry/azure-schemaregistry-avroencoder/azure/schemaregistry/encoder/avroencoder/_exceptions.py

@@ -27,6 +27,7 @@
 
 class InvalidSchemaError(ValueError):
     """Error during schema validation.
+
     :param str message: The message object stringified as 'message' attribute
     :keyword error: The original exception, if any.
 
@@ -43,6 +44,7 @@ def __init__(self, message, *args, **kwargs):
 
 class InvalidContentError(ValueError):
     """Error during encoding or decoding content with a schema.
+
     :param str message: The message object stringified as 'message' attribute
     :keyword error: The original exception, if any.
 

sdk/schemaregistry/azure-schemaregistry-avroencoder/azure/schemaregistry/encoder/avroencoder/_message_protocol.py

@@ -24,8 +24,7 @@ class MessageType(Protocol):
     def from_message_content(
         cls, content: bytes, content_type: str, **kwargs: Any
     ) -> "MessageType":
-        """
-        Creates an object that is a subtype of MessageType, given content type and
+        """Creates an object that is a subtype of MessageType, given content type and
          a content value to be set on the object.
 
         :param bytes content: The content value to be set as the body of the message.
@@ -35,8 +34,7 @@ def from_message_content(
         ...
 
     def __message_content__(self) -> MessageContent:
-        """
-        A MessageContent object, with `content` and `content_type` set to
+        """A MessageContent object, with `content` and `content_type` set to
          the values of their respective properties on the MessageType object.
 
         :rtype: ~azure.schemaregistry.encoder.avroencoder.MessageContent

sdk/schemaregistry/azure-schemaregistry-avroencoder/azure/schemaregistry/encoder/avroencoder/_schema_registry_avro_encoder.py

@@ -59,14 +59,14 @@
 class AvroEncoder(object):
     """
     AvroEncoder provides the ability to encode and decode content according
-    to the given avro schema. It would automatically register, get and cache the schema.
+    to the given Avro schema. It would automatically register, get, and cache the schema.
 
     :keyword client: Required. The schema registry client which is used to register schema
      and retrieve schema from the service.
     :paramtype client: ~azure.schemaregistry.SchemaRegistryClient
-    :keyword Optional[str] group_name: Required for encoding. Not used for decoding.
+    :keyword Optional[str] group_name: Required for encoding. Not used when decoding.
      Schema group under which schema should be registered.
-    :keyword bool auto_register: When true, register new schemas passed to encode.
+    :keyword bool auto_register: When true, registers new schemas passed to encode.
      Otherwise, and by default, encode will fail if the schema has not been pre-registered in the registry.
 
     """
@@ -171,8 +171,7 @@ def encode(
         request_options: Optional[Dict[str, Any]] = None,
         **kwargs: Any,
     ) -> Union[MessageType, MessageContent]:
-        """
-        Encode content with the given schema. Create content type value, which consists of the Avro Mime Type string
+        """Encode content with the given schema. Create content type value, which consists of the Avro Mime Type string
          and the schema ID corresponding to given schema. If provided with a MessageType subtype, encoded content
          and content type will be passed to create message object. If not provided, the following dict will be returned:
          {"content": Avro encoded value, "content_type": Avro mime type string + schema ID}.
@@ -240,8 +239,7 @@ def decode(
         request_options: Dict[str, Any] = None,
         **kwargs: Any,
     ) -> Dict[str, Any]:
-        """
-        Decode bytes content using schema ID in the content type field. `message` must be one of the following:
+        """Decode bytes content using schema ID in the content type field. `message` must be one of the following:
             1) An object of subtype of the MessageType protocol.
             2) A dict {"content": ..., "content_type": ...}, where "content" is bytes and "content_type" is string.
         Content must follow format of associated Avro RecordSchema:

sdk/schemaregistry/azure-schemaregistry-avroencoder/azure/schemaregistry/encoder/avroencoder/aio/_schema_registry_avro_encoder_async.py

@@ -49,14 +49,14 @@
 class AvroEncoder(object):
     """
     AvroEncoder provides the ability to encode and decode content according
-    to the given avro schema. It would automatically register, get and cache the schema.
+    to the given avro schema. It would automatically register, get, and cache the schema.
 
     :keyword client: Required. The schema registry client which is used to register schema
      and retrieve schema from the service.
     :paramtype client: ~azure.schemaregistry.aio.SchemaRegistryClient
-    :keyword Optional[str] group_name: Required for encoding. Not used for decoding.
+    :keyword Optional[str] group_name: Required for encoding. Not used when decoding.
      Schema group under which schema should be registered.
-    :keyword bool auto_register: When true, register new schemas passed to encode.
+    :keyword bool auto_register: When true, registers new schemas passed to encode.
      Otherwise, and by default, encode will fail if the schema has not been pre-registered in the registry.
 
     """
@@ -159,8 +159,7 @@ async def encode(
         **kwargs: Any,
     ) -> Union[MessageType, MessageContent]:
 
-        """
-        Encode content with the given schema. Create content type value, which consists of the Avro Mime Type string
+        """Encode content with the given schema. Create content type value, which consists of the Avro Mime Type string
          and the schema ID corresponding to given schema. If provided with a MessageType subtype, encoded content
          and content type will be passed to create message object. If not provided, the following dict will be returned:
          {"content": Avro encoded value, "content_type": Avro mime type string + schema ID}.
@@ -227,8 +226,7 @@ async def decode(
         request_options: Dict[str, Any] = None,
         **kwargs: Any,
     ) -> Dict[str, Any]:
-        """
-        Decode bytes content using schema ID in the content type field. `message` must be one of the following:
+        """Decode bytes content using schema ID in the content type field. `message` must be one of the following:
             1) A object of subtype of the MessageType protocol.
             2) A dict {"content": ..., "content_type": ...}, where "content" is bytes and "content_type" is string.
         Content must follow format of associated Avro RecordSchema: