feat: add v1 (#36)

Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:
- [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/python-workflows/issues/new/choose) before writing your code!  That way we can discuss the change, evaluate designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)

Fixes #30  🦕

docs/executions_v1/executions.rst

@@ -0,0 +1,11 @@
+Executions
+----------------------------
+
+.. automodule:: google.cloud.workflows.executions_v1.services.executions
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.workflows.executions_v1.services.executions.pagers
+    :members:
+    :inherited-members:

docs/executions_v1/services.rst

@@ -0,0 +1,6 @@
+Services for Google Cloud Workflows Executions v1 API
+=====================================================
+.. toctree::
+    :maxdepth: 2
+
+    executions

docs/executions_v1/types.rst

@@ -0,0 +1,7 @@
+Types for Google Cloud Workflows Executions v1 API
+==================================================
+
+.. automodule:: google.cloud.workflows.executions_v1.types
+    :members:
+    :undoc-members:
+    :show-inheritance:

docs/index.rst

@@ -2,7 +2,21 @@
 
 .. include:: multiprocessing.rst
 
-API Reference
+This package includes clients for multiple versions of the Workflows API By default, you will get ``v1``, the latest version.
+
+v1
+---
+.. toctree::
+    :maxdepth: 2
+
+    workflows_v1/services
+    executions_v1/services
+    workflows_v1/types
+    executions_v1/types
+
+The previous beta release, spelled ``v1beta`` is provided to continue to support code previously written against it. In order to use it, you will want to import from it e.g., ``google.cloud.workflows_v1`` in lieu of ``google.cloud.workflows`` (or the equivalent ``google.cloud.workflows_v1``).
+
+v1beta
 -------------
 .. toctree::
     :maxdepth: 2

docs/workflows_v1/services.rst

@@ -0,0 +1,6 @@
+Services for Google Cloud Workflows v1 API
+==========================================
+.. toctree::
+    :maxdepth: 2
+
+    workflows

docs/workflows_v1/types.rst

@@ -0,0 +1,7 @@
+Types for Google Cloud Workflows v1 API
+=======================================
+
+.. automodule:: google.cloud.workflows_v1.types
+    :members:
+    :undoc-members:
+    :show-inheritance:

docs/workflows_v1/workflows.rst

@@ -0,0 +1,11 @@
+Workflows
+---------------------------
+
+.. automodule:: google.cloud.workflows_v1.services.workflows
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.workflows_v1.services.workflows.pagers
+    :members:
+    :inherited-members:

google/cloud/workflows/__init__.py

@@ -15,18 +15,18 @@
 # limitations under the License.
 #
 
-from google.cloud.workflows_v1beta.services.workflows.async_client import (
+from google.cloud.workflows_v1.services.workflows.async_client import (
     WorkflowsAsyncClient,
 )
-from google.cloud.workflows_v1beta.services.workflows.client import WorkflowsClient
-from google.cloud.workflows_v1beta.types.workflows import CreateWorkflowRequest
-from google.cloud.workflows_v1beta.types.workflows import DeleteWorkflowRequest
-from google.cloud.workflows_v1beta.types.workflows import GetWorkflowRequest
-from google.cloud.workflows_v1beta.types.workflows import ListWorkflowsRequest
-from google.cloud.workflows_v1beta.types.workflows import ListWorkflowsResponse
-from google.cloud.workflows_v1beta.types.workflows import OperationMetadata
-from google.cloud.workflows_v1beta.types.workflows import UpdateWorkflowRequest
-from google.cloud.workflows_v1beta.types.workflows import Workflow
+from google.cloud.workflows_v1.services.workflows.client import WorkflowsClient
+from google.cloud.workflows_v1.types.workflows import CreateWorkflowRequest
+from google.cloud.workflows_v1.types.workflows import DeleteWorkflowRequest
+from google.cloud.workflows_v1.types.workflows import GetWorkflowRequest
+from google.cloud.workflows_v1.types.workflows import ListWorkflowsRequest
+from google.cloud.workflows_v1.types.workflows import ListWorkflowsResponse
+from google.cloud.workflows_v1.types.workflows import OperationMetadata
+from google.cloud.workflows_v1.types.workflows import UpdateWorkflowRequest
+from google.cloud.workflows_v1.types.workflows import Workflow
 
 __all__ = (
     "CreateWorkflowRequest",

google/cloud/workflows/executions/__init__.py

@@ -15,29 +15,19 @@
 # limitations under the License.
 #
 
-from google.cloud.workflows.executions_v1beta.services.executions.async_client import (
+from google.cloud.workflows.executions_v1.services.executions.async_client import (
     ExecutionsAsyncClient,
 )
-from google.cloud.workflows.executions_v1beta.services.executions.client import (
+from google.cloud.workflows.executions_v1.services.executions.client import (
     ExecutionsClient,
 )
-from google.cloud.workflows.executions_v1beta.types.executions import (
-    CancelExecutionRequest,
-)
-from google.cloud.workflows.executions_v1beta.types.executions import (
-    CreateExecutionRequest,
-)
-from google.cloud.workflows.executions_v1beta.types.executions import Execution
-from google.cloud.workflows.executions_v1beta.types.executions import ExecutionView
-from google.cloud.workflows.executions_v1beta.types.executions import (
-    GetExecutionRequest,
-)
-from google.cloud.workflows.executions_v1beta.types.executions import (
-    ListExecutionsRequest,
-)
-from google.cloud.workflows.executions_v1beta.types.executions import (
-    ListExecutionsResponse,
-)
+from google.cloud.workflows.executions_v1.types.executions import CancelExecutionRequest
+from google.cloud.workflows.executions_v1.types.executions import CreateExecutionRequest
+from google.cloud.workflows.executions_v1.types.executions import Execution
+from google.cloud.workflows.executions_v1.types.executions import ExecutionView
+from google.cloud.workflows.executions_v1.types.executions import GetExecutionRequest
+from google.cloud.workflows.executions_v1.types.executions import ListExecutionsRequest
+from google.cloud.workflows.executions_v1.types.executions import ListExecutionsResponse
 
 __all__ = (
     "CancelExecutionRequest",

google/cloud/workflows/executions_v1/__init__.py

@@ -0,0 +1,37 @@
+# -*- 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.executions import ExecutionsClient
+from .types.executions import CancelExecutionRequest
+from .types.executions import CreateExecutionRequest
+from .types.executions import Execution
+from .types.executions import ExecutionView
+from .types.executions import GetExecutionRequest
+from .types.executions import ListExecutionsRequest
+from .types.executions import ListExecutionsResponse
+
+
+__all__ = (
+    "CancelExecutionRequest",
+    "CreateExecutionRequest",
+    "Execution",
+    "ExecutionView",
+    "GetExecutionRequest",
+    "ListExecutionsRequest",
+    "ListExecutionsResponse",
+    "ExecutionsClient",
+)

google/cloud/workflows/executions_v1/py.typed

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

google/cloud/workflows/executions_v1/services/__init__.py

@@ -0,0 +1,16 @@
+# -*- 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/workflows/executions_v1/services/executions/__init__.py

@@ -0,0 +1,24 @@
+# -*- 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 ExecutionsClient
+from .async_client import ExecutionsAsyncClient
+
+__all__ = (
+    "ExecutionsClient",
+    "ExecutionsAsyncClient",
+)