Skip to content

Commit 9bc2931

Browse files
committed
address PR feedback
1 parent 87a92ab commit 9bc2931

File tree

6 files changed

+22
-22
lines changed

6 files changed

+22
-22
lines changed

gapic/templates/README.rst.j2

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ Examples
8585

8686
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
8787

88-
- Enabling the default handler for a specific Google module (for a client library called :code:`Library`):
88+
- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
8989

9090
.. code-block:: console
9191

@@ -134,7 +134,7 @@ Logging details
134134
:code:`logging.getLogger("google").propagate = True` in your code.
135135
#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
136136
one library, but decide you need to also set up environment-based logging configuration for another library.
137-
1. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
137+
#. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
138138
if the code -based configuration gets applied first.
139139
#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
140140
executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.

tests/integration/goldens/asset/README.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ LOGGING
5555
This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
5656
Note the following:
5757

58-
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or Google Cloud Logging.
58+
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
5959
#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
6060
#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
6161

@@ -85,7 +85,7 @@ Examples
8585
8686
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
8787
88-
- Enabling the default handler for a specific Google module (In the case of a client library called :code:`Library`):
88+
- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
8989

9090
.. code-block:: console
9191
@@ -113,7 +113,7 @@ Examples
113113
base_logger.addHandler(logging.StreamHandler())
114114
base_logger.setLevel(logging.DEBUG)
115115
116-
- Configuring a handler for a specific Google module (In the case of a client library called :code:`library_v1`):
116+
- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
117117

118118
.. code-block:: python
119119
@@ -134,7 +134,7 @@ Logging details
134134
:code:`logging.getLogger("google").propagate = True` in your code.
135135
#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
136136
one library, but decide you need to also set up environment-based logging configuration for another library.
137-
1. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
137+
#. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
138138
if the code -based configuration gets applied first.
139139
#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
140140
executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.

tests/integration/goldens/credentials/README.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ LOGGING
5555
This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
5656
Note the following:
5757

58-
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or Google Cloud Logging.
58+
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
5959
#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
6060
#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
6161

@@ -85,7 +85,7 @@ Examples
8585
8686
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
8787
88-
- Enabling the default handler for a specific Google module (In the case of a client library called :code:`Library`):
88+
- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
8989

9090
.. code-block:: console
9191
@@ -113,7 +113,7 @@ Examples
113113
base_logger.addHandler(logging.StreamHandler())
114114
base_logger.setLevel(logging.DEBUG)
115115
116-
- Configuring a handler for a specific Google module (In the case of a client library called :code:`library_v1`):
116+
- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
117117

118118
.. code-block:: python
119119
@@ -134,7 +134,7 @@ Logging details
134134
:code:`logging.getLogger("google").propagate = True` in your code.
135135
#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
136136
one library, but decide you need to also set up environment-based logging configuration for another library.
137-
1. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
137+
#. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
138138
if the code -based configuration gets applied first.
139139
#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
140140
executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.

tests/integration/goldens/eventarc/README.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ LOGGING
5555
This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
5656
Note the following:
5757

58-
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or Google Cloud Logging.
58+
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
5959
#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
6060
#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
6161

@@ -85,7 +85,7 @@ Examples
8585
8686
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
8787
88-
- Enabling the default handler for a specific Google module (In the case of a client library called :code:`Library`):
88+
- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
8989

9090
.. code-block:: console
9191
@@ -113,7 +113,7 @@ Examples
113113
base_logger.addHandler(logging.StreamHandler())
114114
base_logger.setLevel(logging.DEBUG)
115115
116-
- Configuring a handler for a specific Google module (In the case of a client library called :code:`library_v1`):
116+
- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
117117

118118
.. code-block:: python
119119
@@ -134,7 +134,7 @@ Logging details
134134
:code:`logging.getLogger("google").propagate = True` in your code.
135135
#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
136136
one library, but decide you need to also set up environment-based logging configuration for another library.
137-
1. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
137+
#. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
138138
if the code -based configuration gets applied first.
139139
#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
140140
executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.

tests/integration/goldens/logging/README.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ LOGGING
5555
This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
5656
Note the following:
5757

58-
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or Google Cloud Logging.
58+
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
5959
#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
6060
#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
6161

@@ -85,7 +85,7 @@ Examples
8585
8686
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
8787
88-
- Enabling the default handler for a specific Google module (In the case of a client library called :code:`Library`):
88+
- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
8989

9090
.. code-block:: console
9191
@@ -113,7 +113,7 @@ Examples
113113
base_logger.addHandler(logging.StreamHandler())
114114
base_logger.setLevel(logging.DEBUG)
115115
116-
- Configuring a handler for a specific Google module (In the case of a client library called :code:`library_v1`):
116+
- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
117117

118118
.. code-block:: python
119119
@@ -134,7 +134,7 @@ Logging details
134134
:code:`logging.getLogger("google").propagate = True` in your code.
135135
#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
136136
one library, but decide you need to also set up environment-based logging configuration for another library.
137-
1. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
137+
#. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
138138
if the code -based configuration gets applied first.
139139
#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
140140
executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.

tests/integration/goldens/redis/README.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ LOGGING
5555
This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
5656
Note the following:
5757

58-
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or Google Cloud Logging.
58+
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
5959
#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
6060
#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
6161

@@ -85,7 +85,7 @@ Examples
8585
8686
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
8787
88-
- Enabling the default handler for a specific Google module (In the case of a client library called :code:`Library`):
88+
- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
8989

9090
.. code-block:: console
9191
@@ -113,7 +113,7 @@ Examples
113113
base_logger.addHandler(logging.StreamHandler())
114114
base_logger.setLevel(logging.DEBUG)
115115
116-
- Configuring a handler for a specific Google module (In the case of a client library called :code:`library_v1`):
116+
- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
117117

118118
.. code-block:: python
119119
@@ -134,7 +134,7 @@ Logging details
134134
:code:`logging.getLogger("google").propagate = True` in your code.
135135
#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
136136
one library, but decide you need to also set up environment-based logging configuration for another library.
137-
1. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
137+
#. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
138138
if the code -based configuration gets applied first.
139139
#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
140140
executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.

0 commit comments

Comments
 (0)