fix comment

Author: zhuxiaolong37

alibabacloud_oss_v2/checkpoint.py

@@ -46,7 +46,7 @@
 # }
 
 class DownloadCheckpoint:
-    """_summary_
+    """Download Checkpoint
     """
     def __init__(
         self,
@@ -189,7 +189,7 @@ def _is_valid(self) -> bool:
         return False
 
     def dump(self) -> bool:
-        """_summary_
+        """dump
 
         Returns:
             _type_: _description_
@@ -247,7 +247,7 @@ def remove(self) -> None:
 # }
 
 class UploadCheckpoint:
-    """_summary_
+    """Upload Checkpoint
     """
     def __init__(
         self,
@@ -352,7 +352,7 @@ def _is_valid(self) -> bool:
         return False
 
     def dump(self) -> bool:
-        """_summary_
+        """dump
 
         Returns:
             _type_: _description_
@@ -377,7 +377,7 @@ def dump(self) -> bool:
         return True
 
     def remove(self) -> None:
-        """_summary_
+        """remove
         """
         try:
             os.remove(self.cp_filepath)

alibabacloud_oss_v2/client.py

@@ -1,5 +1,5 @@
 # pylint: disable=line-too-long
-"""_summary_"""
+"""Client used to interact with **Alibaba Cloud Object Storage Service (OSS)**."""
 import copy
 from typing import Optional
 from .config import Config
@@ -29,11 +29,11 @@
 from .filelike import AppendOnlyFile, ReadOnlyFile
 
 class Client:
-    """_summary_
+    """Client
     """
 
     def __init__(self, config: Config, **kwargs) -> None:
-        """_summary_
+        """Initialize Client
 
         Args:
             config (Config): _description_
@@ -45,7 +45,7 @@ def __repr__(self) -> str:
 
     def invoke_operation(self, op_input: OperationInput, **kwargs
                          ) -> OperationOutput:
-        """_summary_
+        """invoke operation
 
         Args:
             op_input (OperationInput): _description_
@@ -679,7 +679,7 @@ def list_multipart_uploads_paginator(self, **kwargs) -> ListMultipartUploadsPagi
 
     # transfer managers
     def downloader(self, **kwargs) -> Downloader:
-        """_summary_
+        """downloader
 
         Args:
 
@@ -689,7 +689,7 @@ def downloader(self, **kwargs) -> Downloader:
         return Downloader(self, **kwargs)
 
     def uploader(self, **kwargs) -> Uploader:
-        """_summary_
+        """uploader
 
         Returns:
             Uploader: _description_
@@ -818,7 +818,7 @@ def is_bucket_exist(self, bucket: str, request_payer: Optional[str] = None, **kw
         return result is not None
 
     def put_object_from_file(self, request: models.PutObjectRequest, filepath: str, **kwargs) -> models.PutObjectResult:
-        """_summary_
+        """put object from file
 
         Args:
             request (models.PutObjectRequest): _description_
@@ -833,7 +833,7 @@ def put_object_from_file(self, request: models.PutObjectRequest, filepath: str,
             return self.put_object(req, **kwargs)
 
     def get_object_to_file(self, request: models.GetObjectRequest, filepath: str, **kwargs) -> models.GetObjectResult:
-        """_summary_
+        """get object to file
 
         Args:
             request (models.GetObjectRequest): _description_

alibabacloud_oss_v2/crc.py

@@ -225,7 +225,7 @@ def write(self, data: bytes):
 
     @staticmethod
     def combine(crc1, crc2, size) -> int:
-        """_summary_
+        """combine
 
         Args:
             crc1 (_type_): _description_

alibabacloud_oss_v2/crypto/aes_ctr.py

@@ -17,7 +17,7 @@ def _iv_to_big_int(iv: bytes) -> int:
     return iv_big_int
 
 class IteratorEncryptor():
-    """_summary_
+    """Iterator Encryptor
     """
 
     def __init__(
@@ -73,7 +73,7 @@ def __next__(self):
             raise err
 
 class IterableEncryptor():
-    """_summary_
+    """Iterable Encryptor
     """
 
     def __init__(
@@ -93,7 +93,7 @@ def __iter__(self):
             counter=self._counter)
 
 class FileLikeEncryptor():
-    """_summary_
+    """File Like Encryptor
     """
     def __init__(
         self,
@@ -109,7 +109,7 @@ def __init__(
         self._offset = offset
 
     def read(self, n: int = -1) -> AnyStr:
-        """_summary_
+        """read
 
         Args:
             n (int, optional): _description_. Defaults to -1.
@@ -131,7 +131,7 @@ def read(self, n: int = -1) -> AnyStr:
         return self._cipher.encrypt(self._reader.read(n))
 
     def seek(self, offset: int, whence: int = 0) -> int:
-        """_summary_
+        """seek
 
         Args:
             offset (int): _description_
@@ -149,13 +149,13 @@ def seek(self, offset: int, whence: int = 0) -> int:
         return offset
 
     def tell(self) -> int:
-        """_summary_
+        """tell
         """
         return self._reader.tell()
 
 
 class StreamBodyDecryptor(StreamBody):
-    """_summary_
+    """Stream Body Decryptor
     """
     def __init__(
         self,
@@ -219,7 +219,7 @@ def __init__(
         self.no_str = False
 
     def encrypt(self, src: Any) -> Any:
-        """_summary_
+        """encrypt data
 
         Args:
             src (Any): _description_
@@ -246,7 +246,7 @@ def encrypt(self, src: Any) -> Any:
         raise TypeError(f'src is not str/bytes/file-like/Iterable type, got {type(src)}')
 
     def decrypt(self, src: Any) -> Any:
-        """_summary_
+        """decrypt data
 
         Args:
             src (Any): _description_
@@ -268,7 +268,7 @@ def _get_cipher(self):
 
     @staticmethod
     def random_key() -> bytes:
-        """_summary_
+        """random key
 
         Returns:
             bytes: _description_
@@ -277,7 +277,7 @@ def random_key() -> bytes:
 
     @staticmethod
     def random_iv() -> bytes:
-        """_summary_
+        """random iv
 
         Returns:
             bytes: _description_

alibabacloud_oss_v2/crypto/aes_ctr_cipher.py

@@ -19,18 +19,18 @@ def __init__(
         self._cipher = _AesCtr(cipher_data, offset)
 
     def encrypt_content(self, data: Any) -> Any:
-        """_summary_
+        """encrypt content
         """
         return self._cipher.encrypt(data)
 
     def decrypt_content(self, data: Any) -> Any:
-        """_summary_
+        """decrypt content
         """
         reader = self._cipher.decrypt(data)
         return reader
 
     def clone(self, **kwargs) -> ContentCipher:
-        """_summary_
+        """clone
         """
         return _AESCtrCipher(
             cipher_data=self._cipher_data,
@@ -50,7 +50,7 @@ def get_align_len(self) -> int:
 
 
 class AESCtrCipherBuilder(ContentCipherBuilder):
-    """_summary_
+    """AES Ctr Cipher Builder
 
     Args:
         ContentCipherBuilder (_type_): _description_

alibabacloud_oss_v2/crypto/cipher.py

@@ -6,7 +6,7 @@ class Encrypter(abc.ABC):
 
     @abc.abstractmethod
     def encrypt(self, reader: Any) -> Any:
-        """_summary_
+        """encrypt
         """
 
 
@@ -15,9 +15,9 @@ class Decrypter(abc.ABC):
 
     @abc.abstractmethod
     def decrypt(self, reader: Any) -> Any:
-        """_summary_
+        """decrypt
         """
 
 class Cipher(Encrypter, Decrypter):
-    """_summary_
+    """Cipher
     """

alibabacloud_oss_v2/crypto/types.py

@@ -9,55 +9,55 @@ class MasterCipher(abc.ABC):
 
     @abc.abstractmethod
     def encrypt(self, data: bytes) -> bytes:
-        """_summary_
+        """encrypt data
         """
 
     @abc.abstractmethod
     def decrypt(self, data: bytes) -> bytes:
-        """_summary_
+        """decrypt data
         """
 
     @abc.abstractmethod
     def get_wrap_algorithm(self) -> str:
-        """_summary_
+        """get wrap algorithm
         """
 
     @abc.abstractmethod
     def get_mat_desc(self) -> str:
-        """_summary_
+        """get mat desc
         """
 
 class ContentCipher(abc.ABC):
     """Base abstract base class to encrypt or decrpt object's data"""
 
     @abc.abstractmethod
     def encrypt_content(self, data: Any) -> Any:
-        """_summary_
+        """encrypt content
         """
 
     @abc.abstractmethod
     def decrypt_content(self, data: Any) -> Any:
-        """_summary_
+        """decrypt content
         """
 
     @abc.abstractmethod
     def clone(self, **kwargs) -> "ContentCipher":
-        """_summary_
+        """clone
         """
 
     @abc.abstractmethod
     def get_encrypted_len(self, plain_text_len: int) -> int:
-        """_summary_
+        """get encrypted len
         """
 
     @abc.abstractmethod
     def get_cipher_data(self) -> "CipherData":
-        """_summary_
+        """get cipher data
         """
 
     @abc.abstractmethod
     def get_align_len(self) -> int:
-        """_summary_
+        """get align len
         """
 
 
@@ -83,7 +83,7 @@ def __init__(
         self.unencrypted_content_length = unencrypted_content_length
 
     def is_valid(self) -> bool:
-        """_summary_
+        """is valid
 
         Returns:
             bool: _description_
@@ -95,7 +95,7 @@ def is_valid(self) -> bool:
 
 
     def random_key_iv(self):
-        """_summary_
+        """random key iv
         """
 
 class CipherData:
@@ -120,15 +120,15 @@ def __init__(
         self.cek_algorithm = cek_algorithm
 
     def clone(self) -> "CipherData":
-        """_summary_
+        """clone
 
         Returns:
             CipherData: _description_
         """
         return copy.deepcopy(self)
 
     def random_key_iv(self):
-        """_summary_
+        """random key iv
         """
 
 
@@ -137,15 +137,15 @@ class ContentCipherBuilder(abc.ABC):
 
     @abc.abstractmethod
     def content_cipher(self) -> ContentCipher:
-        """_summary_
+        """content cipher
         """
 
     @abc.abstractmethod
     def content_cipher_from_env(self, env: Envelope, **kwargs) -> ContentCipher:
-        """_summary_
+        """content cipher from env
         """
 
     @abc.abstractmethod
     def get_mat_desc(self) -> str:
-        """_summary_
+        """get mat desc
         """