Add client SSL context support

The client now support setting SSL context. Also, root certificates from universally trusted CAs are provided built-in.

Author: devmiek

README.md

@@ -13,12 +13,9 @@ It is important to note that you cannot use `asyncio.run` to call asynchronous e
 
 ## Navigation
 - [Homepage](https://github.com/nobody-night/tencent-cloud-sdk-python)
-- Documentation
-  - [English (Writing...)](https://smallso.gitbook.io/tencent-cloud-sdk/v/english/)
-  - [简体中文](https://smallso.gitbook.io/tencent-cloud-sdk/)
+- [Documentation](https://smallso.gitbook.io/tencent-cloud-sdk/)
 - [Release Notes](https://github.com/nobody-night/tencent-cloud-sdk-python/releases)
 - [License](LICENSE)
-- [Author Homepage](https://cloud.tencent.com/)
 
 ## Installation
 With the Python package manager, you can quickly install the Tencent Cloud SDK for Python.
@@ -132,7 +129,7 @@ Since the Tencent Cloud product we need to use does not provide a product client
 Below we take Cloud Virtual Machine (CVM) products as an example:
 
 ```python
-virtual_machine_client: client.UniversalClient = client.UniversalClient(
+cvm_client = client.UniversalClient(
     product_id = 'cvm',     # Unique identifier of the product
     access_credentials = access_credentials    # Access credentials
 )
@@ -142,9 +139,10 @@ virtual_machine_client: client.UniversalClient = client.UniversalClient(
 Finally, we try to retrieve Zone information operated by a given data center campus, which will use the Tencent Cloud API called [DescribeZones](https://cloud.tencent.com/document/api/213/15707):
 
 ```python
-action_result: dict = virtual_machine_client.action(
+action_result: dict = cvm_client.action(
     region_id = 'ap-shanghai',      # Unique identifier of the data center
     action_id = 'DescribeZones',    # Unique identifier of the Tencent Cloud API
+    action_parameters = None,
     action_version = '2017-03-12'   # Version name of the Tencent Cloud API
 )
 ```
@@ -160,12 +158,6 @@ for zone_info in action_result['ZoneSet']:
 
 For more ways to use Tencent Cloud SDK for Python, see our online documentation. Thank you!
 
-## To Do
-The next things we need to accomplish are:
-
-- [ ] Write and publish component package coding conventions.
-- [ ] Add more component packs to support active Tencent Cloud products.
-
 ## License
 The Tencent Cloud SDK for Python is open source using the MIT license, which means that your use is subject to the license, please [view](LICENSE) license details.
 

build.sh

@@ -1,6 +1,6 @@
 #!/bin/sh
 
-pip install build
+pip3 install build
 rm -rf ./dist
 
 build_package() {

packages/tencent-cloud-sdk-common/README.md

@@ -31,6 +31,7 @@ To facilitate the deployment and migration of the Tencent Cloud SDK for Python,
 - https://pypi.org/project/idna/
 - https://pypi.org/project/idna_ssl/
 - https://pypi.org/project/typing-extensions/
+- https://pypi.org/project/certifi/
 
 It is worth noting that our use of these dependent packages is subject to their open source licenses.
 

packages/tencent-cloud-sdk-common/setup.py

@@ -35,7 +35,7 @@ def read_readme_content() -> str:
 
 setuptools.setup(
     name = 'tencent-cloud-sdk-common',
-    version = '0.1.3',
+    version = '0.1.4',
     packages = [
         'tencent.cloud.common',
         'tencent.cloud.common.aiohttp',
@@ -48,6 +48,7 @@ def read_readme_content() -> str:
         'tencent.cloud.common.idna',
         'tencent.cloud.common.multidict',
         'tencent.cloud.common.yarl',
+        'tencent.cloud.common.certifi',
     ],
     keywords = 'tencent-cloud sdk-python',
     license = 'MIT License',

packages/tencent-cloud-sdk-common/tencent/cloud/common/certifi/__init__.py

@@ -0,0 +1,4 @@
+from .core import contents, where
+
+__all__ = ["contents", "where"]
+__version__ = "2022.05.18.1"

packages/tencent-cloud-sdk-common/tencent/cloud/common/certifi/__main__.py

@@ -0,0 +1,12 @@
+import argparse
+
+from certifi import contents, where
+
+parser = argparse.ArgumentParser()
+parser.add_argument("-c", "--contents", action="store_true")
+args = parser.parse_args()
+
+if args.contents:
+    print(contents())
+else:
+    print(where())

packages/tencent-cloud-sdk-common/tencent/cloud/common/certifi/cacert.pem

@@ -0,0 +1,68 @@
+"""
+certifi.py
+~~~~~~~~~~
+
+This module returns the installation location of cacert.pem or its contents.
+"""
+import os
+import types
+from typing import Union
+
+try:
+    from importlib.resources import path as get_path, read_text
+
+    _CACERT_CTX = None
+    _CACERT_PATH = None
+
+    def where() -> str:
+        # This is slightly terrible, but we want to delay extracting the file
+        # in cases where we're inside of a zipimport situation until someone
+        # actually calls where(), but we don't want to re-extract the file
+        # on every call of where(), so we'll do it once then store it in a
+        # global variable.
+        global _CACERT_CTX
+        global _CACERT_PATH
+        if _CACERT_PATH is None:
+            # This is slightly janky, the importlib.resources API wants you to
+            # manage the cleanup of this file, so it doesn't actually return a
+            # path, it returns a context manager that will give you the path
+            # when you enter it and will do any cleanup when you leave it. In
+            # the common case of not needing a temporary file, it will just
+            # return the file system location and the __exit__() is a no-op.
+            #
+            # We also have to hold onto the actual context manager, because
+            # it will do the cleanup whenever it gets garbage collected, so
+            # we will also store that at the global level as well.
+            _CACERT_CTX = get_path("certifi", "cacert.pem")
+            _CACERT_PATH = str(_CACERT_CTX.__enter__())
+
+        return _CACERT_PATH
+
+
+except ImportError:
+    Package = Union[types.ModuleType, str]
+    Resource = Union[str, "os.PathLike"]
+
+    # This fallback will work for Python versions prior to 3.7 that lack the
+    # importlib.resources module but relies on the existing `where` function
+    # so won't address issues with environments like PyOxidizer that don't set
+    # __file__ on modules.
+    def read_text(
+        package: Package,
+        resource: Resource,
+        encoding: str = 'utf-8',
+        errors: str = 'strict'
+    ) -> str:
+        with open(where(), encoding=encoding) as data:
+            return data.read()
+
+    # If we don't have importlib.resources, then we will just do the old logic
+    # of assuming we're on the filesystem and munge the path directly.
+    def where() -> str:
+        f = os.path.dirname(__file__)
+
+        return os.path.join(f, "cacert.pem")
+
+
+def contents() -> str:
+    return read_text("certifi", "cacert.pem", encoding="ascii")

packages/tencent-cloud-sdk-common/tencent/cloud/common/certifi/core.py

@@ -35,7 +35,7 @@ def read_readme_content() -> str:
 
 setuptools.setup(
     name = 'tencent-cloud-sdk-core',
-    version = '0.2.3',
+    version = '0.2.4',
     packages = [
         'tencent.cloud.core'
     ],
@@ -63,6 +63,6 @@ def read_readme_content() -> str:
     ],
     install_requires = [
         'tencent-cloud-sdk-auth>=0.2.2',
-        'tencent-cloud-sdk-common>=0.1.3'
+        'tencent-cloud-sdk-common>=0.1.4'
     ]
 )