chore: run librarian generate

Author: parthea

packages/google-cloud-firestore/.coveragerc

@@ -1,39 +1,13 @@
-# -*- coding: utf-8 -*-
-#
-# Copyright 2024 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
-#
-#     https://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.
-
-# Generated by synthtool. DO NOT EDIT!
 [run]
 branch = True
-omit =
-  google/__init__.py
-  google/cloud/__init__.py
 
 [report]
-fail_under = 100
 show_missing = True
+omit =
+    google/cloud/firestore_admin/__init__.py
+    google/cloud/firestore_admin/gapic_version.py
 exclude_lines =
     # Re-enable the standard pragma
     pragma: NO COVER
     # Ignore debug-only repr
     def __repr__
-    # Ignore abstract methods
-    raise NotImplementedError
-omit =
-  */gapic/*.py
-  */proto/*.py
-  */core/*.py
-  */site-packages/*.py
-  google/cloud/__init__.py

packages/google-cloud-firestore/.flake8

@@ -1,28 +1,29 @@
 # -*- coding: utf-8 -*-
-#
-# Copyright 2024 Google LLC
+# Copyright 2025 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
 #
-#     https://www.apache.org/licenses/LICENSE-2.0
+#     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.
-
-# Generated by synthtool. DO NOT EDIT!
+#
 [flake8]
+# TODO(https://github.com/googleapis/gapic-generator-python/issues/2333):
+# Resolve flake8 lint issues
 ignore = E203, E231, E266, E501, W503
 exclude =
-  # Exclude generated code.
-  **/proto/**
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333):
+  # Ensure that generated code passes flake8 lint
   **/gapic/**
   **/services/**
   **/types/**
+  # Exclude Protobuf gencode
   *_pb2.py
 
   # Standard linting exemptions.

packages/google-cloud-firestore/.repo-metadata.json

@@ -1,6 +1,6 @@
 {
     "name": "firestore",
-    "name_pretty": "Cloud Firestore",
+    "name_pretty": "Cloud Firestore API",
     "product_documentation": "https://cloud.google.com/firestore",
     "client_documentation": "https://cloud.google.com/python/docs/reference/firestore/latest",
     "issue_tracker": "https://issuetracker.google.com/savedsearches/5337669",

packages/google-cloud-firestore/MANIFEST.in

@@ -1,25 +1,20 @@
 # -*- coding: utf-8 -*-
-#
-# Copyright 2024 Google LLC
+# Copyright 2025 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
 #
-#     https://www.apache.org/licenses/LICENSE-2.0
+#     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.
-
-# Generated by synthtool. DO NOT EDIT!
+#
 include README.rst LICENSE
-recursive-include google *.json *.proto py.typed
+recursive-include google *.py *.pyi *.json *.proto py.typed
 recursive-include tests *
 global-exclude *.py[co]
 global-exclude __pycache__
-
-# Exclude scripts for samples readmegen
-prune scripts/readme-gen

packages/google-cloud-firestore/docs/README.rst

@@ -53,7 +53,7 @@ Code samples and snippets
 
 Code samples and snippets live in the `samples/`_ folder.
 
-.. _samples/: https://github.com/googleapis/google-cloud-python/packages/google-cloud-firestore/samples
+.. _samples/: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-firestore/samples
 
 
 Supported Python Versions

packages/google-cloud-firestore/docs/_templates/layout.html

@@ -20,8 +20,8 @@
           {% endblock %}
 
           <div class="body" role="main">
-          	<div class="admonition" id="python2-eol"> 
-          	 As of January 1, 2020 this library no longer supports Python 2 on the latest released version. 
+          	<div class="admonition" id="python2-eol">
+          	 As of January 1, 2020 this library no longer supports Python 2 on the latest released version.
           	 Library versions released prior to that date will continue to be available. For more information please
           	 visit <a href="https://cloud.google.com/python/docs/python2-sunset/">Python 2 support on Google Cloud</a>.
           	</div>

packages/google-cloud-firestore/docs/conf.py

@@ -1,19 +1,19 @@
 # -*- coding: utf-8 -*-
-# Copyright 2024 Google LLC
+# Copyright 2025 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
+#     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-firestore documentation build configuration file
+##
+# google-cloud-firestore-admin documentation build configuration file
 #
 # This file is execfile()d with the current directory set to its
 # containing dir.
@@ -24,9 +24,11 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
+import logging
 import os
 import shlex
 import sys
+from typing import Any
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
@@ -42,7 +44,7 @@
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-needs_sphinx = "1.5.5"
+needs_sphinx = "4.5.0"
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
@@ -80,8 +82,8 @@
 root_doc = "index"
 
 # General information about the project.
-project = "google-cloud-firestore"
-copyright = "2019, Google"
+project = "google-cloud-firestore-admin"
+copyright = "2025, Google, LLC"
 author = "Google APIs"
 
 # The version info for the project you're documenting, acts as replacement for
@@ -109,6 +111,10 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 exclude_patterns = [
+    "**/firestore.rst",
+    "**/firestore_admin.rst",
+    "**/services_.rst",
+    "**/types_.rst",
     "_build",
     "**/.nox/**/*",
     "samples/AUTHORING_GUIDE.md",
@@ -154,7 +160,7 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = {
-    "description": "Google Cloud Client Libraries for google-cloud-firestore",
+    "description": "Google Cloud Client Libraries for google-cloud-firestore-admin",
     "github_user": "googleapis",
     "github_repo": "google-cloud-python",
     "github_banner": True,
@@ -248,7 +254,7 @@
 # html_search_scorer = 'scorer.js'
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = "google-cloud-firestore-doc"
+htmlhelp_basename = "google-cloud-firestore-admin-doc"
 
 # -- Options for warnings ------------------------------------------------------
 
@@ -266,13 +272,13 @@
 
 latex_elements = {
     # The paper size ('letterpaper' or 'a4paper').
-    #'papersize': 'letterpaper',
+    # 'papersize': 'letterpaper',
     # The font size ('10pt', '11pt' or '12pt').
-    #'pointsize': '10pt',
+    # 'pointsize': '10pt',
     # Additional stuff for the LaTeX preamble.
-    #'preamble': '',
+    # 'preamble': '',
     # Latex figure (float) alignment
-    #'figure_align': 'htbp',
+    # 'figure_align': 'htbp',
 }
 
 # Grouping the document tree into LaTeX files. List of tuples
@@ -281,8 +287,8 @@
 latex_documents = [
     (
         root_doc,
-        "google-cloud-firestore.tex",
-        "google-cloud-firestore Documentation",
+        "google-cloud-firestore-admin.tex",
+        "google-cloud-firestore-admin Documentation",
         author,
         "manual",
     )
@@ -316,8 +322,8 @@
 man_pages = [
     (
         root_doc,
-        "google-cloud-firestore",
-        "google-cloud-firestore Documentation",
+        "google-cloud-firestore-admin",
+        "google-cloud-firestore-admin Documentation",
         [author],
         1,
     )
@@ -335,11 +341,11 @@
 texinfo_documents = [
     (
         root_doc,
-        "google-cloud-firestore",
-        "google-cloud-firestore Documentation",
+        "google-cloud-firestore-admin",
+        "google-cloud-firestore-admin Documentation",
         author,
-        "google-cloud-firestore",
-        "google-cloud-firestore Library",
+        "google-cloud-firestore-admin",
+        "google-cloud-firestore-admin Library",
         "APIs",
     )
 ]
@@ -382,3 +388,34 @@
 napoleon_use_ivar = False
 napoleon_use_param = True
 napoleon_use_rtype = True
+
+
+# Setup for sphinx behaviors such as warning filters.
+class UnexpectedUnindentFilter(logging.Filter):
+    """Filter out warnings about unexpected unindentation following bullet lists."""
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        """Filter the log record.
+
+        Args:
+            record (logging.LogRecord): The log record.
+
+        Returns:
+            bool: False to suppress the warning, True to allow it.
+        """
+        msg = record.getMessage()
+        if "Bullet list ends without a blank line" in msg:
+            return False
+        return True
+
+
+def setup(app: Any) -> None:
+    """Setup the Sphinx application.
+
+    Args:
+        app (Any): The Sphinx application.
+    """
+    # Sphinx's logger is hierarchical. Adding a filter to the
+    # root 'sphinx' logger will catch warnings from all sub-loggers.
+    logger = logging.getLogger("sphinx")
+    logger.addFilter(UnexpectedUnindentFilter())

packages/google-cloud-firestore/docs/firestore_admin_v1/firestore_admin.rst

@@ -0,0 +1,10 @@
+FirestoreAdmin
+--------------------------------
+
+.. automodule:: google.cloud.firestore_admin_v1.services.firestore_admin
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.firestore_admin_v1.services.firestore_admin.pagers
+    :members:
+    :inherited-members:

packages/google-cloud-firestore/docs/firestore_admin_v1/services_.rst

@@ -0,0 +1,6 @@
+Services for Google Cloud Firestore Admin v1 API
+================================================
+.. toctree::
+    :maxdepth: 2
+
+    firestore_admin

packages/google-cloud-firestore/docs/firestore_admin_v1/types_.rst

@@ -0,0 +1,6 @@
+Types for Google Cloud Firestore Admin v1 API
+=============================================
+
+.. automodule:: google.cloud.firestore_admin_v1.types
+    :members:
+    :show-inheritance: