Update documentation to include Yandex Translate API support

- Added Yandex Translate API to the list of supported providers in README and overview documentation.
- Expanded provider documentation to detail YandexProvider options, including API key and IAM token authentication.
- Updated example usage for the YandexProvider in the README.

Author: terryyin

README.rst

@@ -7,7 +7,7 @@ Translate Tool in Python
 
 Translate is a simple but powerful translation tool written in python with with support for
 multiple translation providers. By now we offer integration with Microsoft Translation API,
-Translated MyMemory API, LibreTranslate, and DeepL's free and pro APIs
+Translated MyMemory API, LibreTranslate, DeepL's free and pro APIs, and Yandex Translate API
 
 
 Why Should I Use This?
@@ -152,7 +152,16 @@ To use DeepL's pro API, pass an additional parameter named pro to the Translator
 
 .. code-block:: python
 
-    In: translator = Translator(provider='microsoft', to_lang=to_lang, secret_access_key=secret, pro=True)
+    In: translator = Translator(provider='deepl', to_lang=to_lang, secret_access_key=secret, pro=True)
+
+The Yandex Provider
+~~~~~~~~~~~~~~~~~~~
+Yandex Translate API supports both API key and IAM token authentication. To use IAM token authentication, pass the is_iam parameter set to True. You may also need to provide a folder_id for your Yandex Cloud project.
+
+.. code-block:: python
+
+    In: translator = Translator(provider='yandex', to_lang=to_lang, secret_access_key='your_api_key', folder_id='your_folder_id')
+    In: translator = Translator(provider='yandex', to_lang=to_lang, secret_access_key='your_iam_token', folder_id='your_folder_id', is_iam=True)
 
 Documentation
 -------------

docs/source/overview.rst

@@ -1,7 +1,7 @@
 Overview
 ========
 
-Translate is a simple but powerful translation tool written in python with with support for multiple translation providers. By now we offer integration with Microsoft Translation API, Translated MyMemory API, LibreTranslate, and DeepL's free and pro APIs.
+Translate is a simple but powerful translation tool written in python with with support for multiple translation providers. By now we offer integration with Microsoft Translation API, Translated MyMemory API, LibreTranslate, DeepL's free and pro APIs, and Yandex Translate API.
 
 The biggest reason to use translate is to make translations in a simple way without the need of bigger effort and can be used as a translation tool like command line.
 

docs/source/providers.rst

@@ -59,3 +59,24 @@ for further information abount the provider:
 
     https://libretranslate.com
     http://github.com/LibreTranslate/LibreTranslate
+
+YandexProvider
+--------------
+
+Yandex Cloud Translate API provider supporting both API key and IAM token authentication
+
+``YandexProvider`` (located at ``translate.providers``) receives the following options:
+
+to_lang, from_lang='autodetect', secret_access_key=None, folder_id=None, is_iam=False, base_url=None
+
+    * ``to_lang``: language you want to translate
+    * ``from_lang``: Language of the text being translated  (optional): as default ``autodetect``
+    * ``secret_access_key``: Yandex API key or IAM token
+    * ``folder_id``: Yandex Cloud folder ID (optional but may be required)
+    * ``is_iam``: Set to True to use IAM token authentication instead of API key (default: False)
+    * ``base_url``: Custom API endpoint URL (optional)
+
+for further information about the provider:
+
+    https://translate.yandex.com/
+    https://yandex.cloud/en/docs/translate/