Add documentation and fix lint errors

Author: shhovhan

doc/source/cli/index.rst

@@ -42,6 +42,8 @@ documentation of these services:
    load_balancer
    modelarts
    nat
+   privatenat
+   natv3
    obs
    rds_v3
    sdrs

doc/source/cli/privatenat.rst

@@ -0,0 +1,19 @@
+Private Network Address Translation (Private NAT)
+=================================================
+
+The Private NAT client is the command-line interface (CLI) for
+the Private NAT API.
+
+For help on a specific `natv3` command, enter:
+
+.. code-block:: console
+
+   $ openstack natv3 help SUBCOMMAND
+
+.. _private_gateway:
+
+Private NAT Gateway Operations
+------------------------------
+
+.. autoprogram-cliff:: openstack.nat.v3
+   :command: natv3 private gateway *

doc/source/sdk/proxies/index.rst

@@ -29,6 +29,7 @@ Service Proxies
    MapReduce Service (MRS) <mrs>
    Modelarts Service (ModelArts) <modelarts>
    Network Address Translation (NAT) <nat>
+   Private Network Address Translation (Private NAT) <privatenat>
    Object Block Storage (OBS) <obs>
    Relational Database Service RDS V1 (RDSv1) <rds_v1>
    Relational Database Service RDS V3 (RDS) <rds_v3>

doc/source/sdk/proxies/privatenat.rst

@@ -0,0 +1,19 @@
+Private NAT API
+===============
+
+.. automodule:: otcextensions.sdk.natv3.v3._proxy
+
+The Private NAT high-level interface
+------------------------------------
+
+The private NAT high-level interface is available through the ``natv3``
+member of a :class:`~openstack.connection.Connection` object. The
+``natv3`` member will only be added if the
+``otcextensions.sdk.register_otc_extensions(conn)`` method is called.
+
+Private NAT Gateway Operations
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: otcextensions.sdk.natv3.v3._proxy.Proxy
+  :noindex:
+  :members: private_nat_gateways

doc/source/sdk/resources/index.rst

@@ -30,6 +30,7 @@ Open Telekom Cloud Resources
    MapReduce Service (MRS) <mrs/index>
    ModelArts Service (MA) <modelarts/index>
    Network Address Translation (NAT) <nat/index>
+   Private Network Address Translation (Private NAT) <privatenat/index>
    Object Block Storage (OBS) <obs/index>
    Relational Database Service (RDS) <rds/index>
    Shared File System Turbo (SFS Turbo) <sfsturbo/index>

doc/source/sdk/resources/privatenat/index.rst

@@ -0,0 +1,7 @@
+Private NAT Resources
+=====================
+
+.. toctree::
+   :maxdepth: 1
+
+   v3/private_gateway

doc/source/sdk/resources/privatenat/v3/private_gateway.rst

@@ -0,0 +1,13 @@
+otcextensions.sdk.natv3.v3.gateway
+===============================
+
+.. automodule:: otcextensions.sdk.natv3.v3.gateway
+
+The Private NAT Gateway Class
+-----------------------------
+
+The ``PrivateNatGateway`` class inherits from
+:class:`~openstack.resource.Resource`.
+
+.. autoclass:: otcextensions.sdk.natv3.v3.gateway.PrivateNatGateway
+   :members:

examples/natv3/list_private_gateways.py

@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+"""
+List all Private NAT Gateways
+"""
+import openstack
+
+
+openstack.enable_logging(True)
+conn = openstack.connect(cloud='otc')
+
+for gateway in conn.natv3.private_nat_gateways():
+    print(gateway)

otcextensions/sdk/natv3/v3/gateway.py

@@ -24,7 +24,6 @@ class DownlinkVpc(resource.Resource):
     ngport_ip_address = resource.Body('ngport_ip_address')
 
 
-
 class Tag(resource.Resource):
     #: Specifies the tag key. Up to 128 Unicode characters. Cannot be blank.
     key = resource.Body('key')
@@ -68,7 +67,8 @@ class PrivateNatGateway(resource.Resource):
     #: * vpc_id: Specifies the ID of the VPC.
     #: * virsubnet_id: Specifies the ID of the subnet.
     #: * ngport_ip_address: Specifies the private IP address of the gateway.
-    downlink_vpcs = resource.Body('downlink_vpcs', type=list, list_type=DownlinkVpc)
+    downlink_vpcs = resource.Body('downlink_vpcs', type=list,
+                                  list_type=DownlinkVpc)
     #: Specifies the ID of the enterprise project that is associated
     #: with the private NAT gateway when the private NAT gateway is created.
     enterprise_project_id = resource.Body('enterprise_project_id')
@@ -108,7 +108,6 @@ class PrivateNatGateway(resource.Resource):
     updated_at = resource.Body('updated_at')
 
 
-
 class PageInfo(resource.Resource):
     next_marker = resource.Body('next_marker')
     previous_marker = resource.Body('previous_marker')