feat: add v1alpha (#80)

Googlers see b/186567237

.coveragerc

@@ -2,7 +2,6 @@
 branch = True
 
 [report]
-fail_under = 100
 show_missing = True
 omit =
     google/cloud/osconfig/__init__.py

.github/.OwlBot.yaml

@@ -19,7 +19,6 @@ deep-remove-regex:
   - /owl-bot-staging
 
 deep-preserve-regex:
-  - /owl-bot-staging/v1alpha
   - /owl-bot-staging/v1beta
 
 deep-copy-regex:

docs/index.rst

@@ -1,15 +1,30 @@
 .. include:: README.rst
 
-.. include:: multiprocessing.rst 
+.. include:: multiprocessing.rst
+
+This package includes clients for multiple versions of the osconfig
+API. By default, you will get ``v1``, the latest GA version.
+
+osconfig_v1 API Reference
+-------------------------
 
-API Reference
--------------
 .. toctree::
     :maxdepth: 2
 
     osconfig_v1/services
     osconfig_v1/types
 
+
+osconfig_v1alpha API Reference
+------------------------------
+
+.. toctree::
+    :maxdepth: 2
+
+    osconfig_v1alpha/services
+    osconfig_v1alpha/types
+
+
 Changelog
 ---------
 

docs/osconfig_v1alpha/os_config_zonal_service.rst

@@ -0,0 +1,10 @@
+OsConfigZonalService
+--------------------------------------
+
+.. automodule:: google.cloud.osconfig_v1alpha.services.os_config_zonal_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.osconfig_v1alpha.services.os_config_zonal_service.pagers
+    :members:
+    :inherited-members:

docs/osconfig_v1alpha/services.rst

@@ -0,0 +1,6 @@
+Services for Google Cloud Osconfig v1alpha API
+==============================================
+.. toctree::
+    :maxdepth: 2
+
+    os_config_zonal_service

docs/osconfig_v1alpha/types.rst

@@ -0,0 +1,7 @@
+Types for Google Cloud Osconfig v1alpha API
+===========================================
+
+.. automodule:: google.cloud.osconfig_v1alpha.types
+    :members:
+    :undoc-members:
+    :show-inheritance:

google/cloud/osconfig_v1alpha/__init__.py

@@ -0,0 +1,88 @@
+# -*- coding: utf-8 -*-
+# Copyright 2020 Google LLC
+#
+# 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.
+#
+
+from .services.os_config_zonal_service import OsConfigZonalServiceClient
+from .services.os_config_zonal_service import OsConfigZonalServiceAsyncClient
+
+from .types.config_common import OSPolicyResourceCompliance
+from .types.config_common import OSPolicyResourceConfigStep
+from .types.config_common import OSPolicyComplianceState
+from .types.instance_os_policies_compliance import (
+    GetInstanceOSPoliciesComplianceRequest,
+)
+from .types.instance_os_policies_compliance import InstanceOSPoliciesCompliance
+from .types.instance_os_policies_compliance import (
+    ListInstanceOSPoliciesCompliancesRequest,
+)
+from .types.instance_os_policies_compliance import (
+    ListInstanceOSPoliciesCompliancesResponse,
+)
+from .types.inventory import GetInventoryRequest
+from .types.inventory import Inventory
+from .types.inventory import ListInventoriesRequest
+from .types.inventory import ListInventoriesResponse
+from .types.inventory import InventoryView
+from .types.os_policy import OSPolicy
+from .types.os_policy_assignments import CreateOSPolicyAssignmentRequest
+from .types.os_policy_assignments import DeleteOSPolicyAssignmentRequest
+from .types.os_policy_assignments import GetOSPolicyAssignmentRequest
+from .types.os_policy_assignments import ListOSPolicyAssignmentRevisionsRequest
+from .types.os_policy_assignments import ListOSPolicyAssignmentRevisionsResponse
+from .types.os_policy_assignments import ListOSPolicyAssignmentsRequest
+from .types.os_policy_assignments import ListOSPolicyAssignmentsResponse
+from .types.os_policy_assignments import OSPolicyAssignment
+from .types.os_policy_assignments import OSPolicyAssignmentOperationMetadata
+from .types.os_policy_assignments import UpdateOSPolicyAssignmentRequest
+from .types.osconfig_common import FixedOrPercent
+from .types.vulnerability import CVSSv3
+from .types.vulnerability import GetVulnerabilityReportRequest
+from .types.vulnerability import ListVulnerabilityReportsRequest
+from .types.vulnerability import ListVulnerabilityReportsResponse
+from .types.vulnerability import VulnerabilityReport
+
+__all__ = (
+    "OsConfigZonalServiceAsyncClient",
+    "CVSSv3",
+    "CreateOSPolicyAssignmentRequest",
+    "DeleteOSPolicyAssignmentRequest",
+    "FixedOrPercent",
+    "GetInstanceOSPoliciesComplianceRequest",
+    "GetInventoryRequest",
+    "GetOSPolicyAssignmentRequest",
+    "GetVulnerabilityReportRequest",
+    "InstanceOSPoliciesCompliance",
+    "Inventory",
+    "InventoryView",
+    "ListInstanceOSPoliciesCompliancesRequest",
+    "ListInstanceOSPoliciesCompliancesResponse",
+    "ListInventoriesRequest",
+    "ListInventoriesResponse",
+    "ListOSPolicyAssignmentRevisionsRequest",
+    "ListOSPolicyAssignmentRevisionsResponse",
+    "ListOSPolicyAssignmentsRequest",
+    "ListOSPolicyAssignmentsResponse",
+    "ListVulnerabilityReportsRequest",
+    "ListVulnerabilityReportsResponse",
+    "OSPolicy",
+    "OSPolicyAssignment",
+    "OSPolicyAssignmentOperationMetadata",
+    "OSPolicyComplianceState",
+    "OSPolicyResourceCompliance",
+    "OSPolicyResourceConfigStep",
+    "OsConfigZonalServiceClient",
+    "UpdateOSPolicyAssignmentRequest",
+    "VulnerabilityReport",
+)

google/cloud/osconfig_v1alpha/gapic_metadata.json

@@ -0,0 +1,143 @@
+ {
+  "comment": "This file maps proto services/RPCs to the corresponding library clients/methods",
+  "language": "python",
+  "libraryPackage": "google.cloud.osconfig_v1alpha",
+  "protoPackage": "google.cloud.osconfig.v1alpha",
+  "schema": "1.0",
+  "services": {
+    "OsConfigZonalService": {
+      "clients": {
+        "grpc": {
+          "libraryClient": "OsConfigZonalServiceClient",
+          "rpcs": {
+            "CreateOSPolicyAssignment": {
+              "methods": [
+                "create_os_policy_assignment"
+              ]
+            },
+            "DeleteOSPolicyAssignment": {
+              "methods": [
+                "delete_os_policy_assignment"
+              ]
+            },
+            "GetInstanceOSPoliciesCompliance": {
+              "methods": [
+                "get_instance_os_policies_compliance"
+              ]
+            },
+            "GetInventory": {
+              "methods": [
+                "get_inventory"
+              ]
+            },
+            "GetOSPolicyAssignment": {
+              "methods": [
+                "get_os_policy_assignment"
+              ]
+            },
+            "GetVulnerabilityReport": {
+              "methods": [
+                "get_vulnerability_report"
+              ]
+            },
+            "ListInstanceOSPoliciesCompliances": {
+              "methods": [
+                "list_instance_os_policies_compliances"
+              ]
+            },
+            "ListInventories": {
+              "methods": [
+                "list_inventories"
+              ]
+            },
+            "ListOSPolicyAssignmentRevisions": {
+              "methods": [
+                "list_os_policy_assignment_revisions"
+              ]
+            },
+            "ListOSPolicyAssignments": {
+              "methods": [
+                "list_os_policy_assignments"
+              ]
+            },
+            "ListVulnerabilityReports": {
+              "methods": [
+                "list_vulnerability_reports"
+              ]
+            },
+            "UpdateOSPolicyAssignment": {
+              "methods": [
+                "update_os_policy_assignment"
+              ]
+            }
+          }
+        },
+        "grpc-async": {
+          "libraryClient": "OsConfigZonalServiceAsyncClient",
+          "rpcs": {
+            "CreateOSPolicyAssignment": {
+              "methods": [
+                "create_os_policy_assignment"
+              ]
+            },
+            "DeleteOSPolicyAssignment": {
+              "methods": [
+                "delete_os_policy_assignment"
+              ]
+            },
+            "GetInstanceOSPoliciesCompliance": {
+              "methods": [
+                "get_instance_os_policies_compliance"
+              ]
+            },
+            "GetInventory": {
+              "methods": [
+                "get_inventory"
+              ]
+            },
+            "GetOSPolicyAssignment": {
+              "methods": [
+                "get_os_policy_assignment"
+              ]
+            },
+            "GetVulnerabilityReport": {
+              "methods": [
+                "get_vulnerability_report"
+              ]
+            },
+            "ListInstanceOSPoliciesCompliances": {
+              "methods": [
+                "list_instance_os_policies_compliances"
+              ]
+            },
+            "ListInventories": {
+              "methods": [
+                "list_inventories"
+              ]
+            },
+            "ListOSPolicyAssignmentRevisions": {
+              "methods": [
+                "list_os_policy_assignment_revisions"
+              ]
+            },
+            "ListOSPolicyAssignments": {
+              "methods": [
+                "list_os_policy_assignments"
+              ]
+            },
+            "ListVulnerabilityReports": {
+              "methods": [
+                "list_vulnerability_reports"
+              ]
+            },
+            "UpdateOSPolicyAssignment": {
+              "methods": [
+                "update_os_policy_assignment"
+              ]
+            }
+          }
+        }
+      }
+    }
+  }
+}

google/cloud/osconfig_v1alpha/py.typed

@@ -0,0 +1,2 @@
+# Marker file for PEP 561.
+# The google-cloud-osconfig package uses inline types.

google/cloud/osconfig_v1alpha/services/__init__.py

@@ -0,0 +1,15 @@
+# -*- coding: utf-8 -*-
+# Copyright 2020 Google LLC
+#
+# 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.
+#

google/cloud/osconfig_v1alpha/services/os_config_zonal_service/__init__.py

@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+# Copyright 2020 Google LLC
+#
+# 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.
+#
+from .client import OsConfigZonalServiceClient
+from .async_client import OsConfigZonalServiceAsyncClient
+
+__all__ = (
+    "OsConfigZonalServiceClient",
+    "OsConfigZonalServiceAsyncClient",
+)