clarifies purpose and asert for two tests regarding old verbose arg

Author: chalmerlowe

pandas_gbq/gbq.py

@@ -1461,7 +1461,7 @@ def create_user_agent(
     Returns (str):
         Customized user agent string.
 
-    Deprecation Warning:
+    Deprecation Warning: 
         In a future major release, the default delimiter will be changed to
         a `/` in accordance with RFC9110.
     """
@@ -1472,8 +1472,9 @@ def create_user_agent(
     else:
         warnings.warn(
             "In a future major release, the default delimiter will be "
-            "changed to a `/` in accordance with RFC9110",
+            "changed to a `/` in accordance with RFC9110.",
             PendingDeprecationWarning,
+            stacklevel=2,
         )
         delimiter = "-"
 

tests/unit/test_gbq.py

@@ -635,7 +635,14 @@ def test_read_gbq_wo_verbose_w_new_pandas_no_warnings(monkeypatch, recwarn):
         mock.PropertyMock(return_value=False),
     )
     gbq.read_gbq("SELECT 1", project_id="my-project", dialect="standard")
-    assert len(recwarn) == 0
+    # This test was intended to check for warnings about the deprecation of
+    # the argument `verbose` (which was removed from gbq (~v0.4.0) and
+    # pandas (~v0.23.0). This test should not fail upon seeing a
+    # warning in regards to a pending deprecation related to rfc9110 delimiters.
+    # TODO this and related tests have likely outlived their usefulness,
+    # consider removing.
+    for warning in recwarn.list:
+        assert "delimiter" in str(warning.message)
 
 
 def test_read_gbq_with_old_bq_raises_importerror(monkeypatch):
@@ -660,7 +667,14 @@ def test_read_gbq_with_verbose_old_pandas_no_warnings(monkeypatch, recwarn):
         dialect="standard",
         verbose=True,
     )
-    assert len(recwarn) == 0
+    # This test was intended to check for warnings about the deprecation of
+    # the argument `verbose` (which was removed from gbq (~v0.4.0) and
+    # pandas (~v0.23.0). This test should not fail upon seeing a
+    # warning in regards to a pending deprecation related to rfc9110 delimiters.
+    # TODO this and related tests have likely outlived their usefulness,
+    # consider removing.
+    for warning in recwarn.list:
+        assert "delimiter" in str(warning.message)
 
 
 def test_read_gbq_with_private_raises_notimplmentederror():