fix(backcompat): remove DeprecationWarning from AsyncPinecone delegates

Drop the `import warnings` + `warnings.warn(...)` block from all 18
backcompat delegate methods on AsyncPinecone. Rewrite each docstring
to follow the shim template (no `:meta private:`, no deprecated language,
clear new-API guidance). Update unit tests to remove `pytest.warns`
wrappers and rename functions to drop `_emits_deprecation_and_*` suffixes.

Closes BC-0085.

Author: jhamon

pinecone/async_client/pinecone.py

@@ -445,17 +445,12 @@ async def create_index(
         vector_type: VectorType | str = "dense",
         tags: dict[str, str] | None = None,
     ) -> IndexModel:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.indexes.create`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.indexes.create`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.indexes.create(...)`` instead of
+        ``await pc.create_index(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.create_index() is deprecated; use pc.indexes.create() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         resolved_dp = deletion_protection if deletion_protection is not None else "disabled"
         return await self.indexes.create(
             name=name,
@@ -480,20 +475,13 @@ async def create_index_for_model(
         schema: dict[str, Any] | None = None,
         timeout: int | None = None,
     ) -> IndexModel:
-        """Backwards-compatibility delegate for integrated index creation.
-
-        See :meth:`AsyncPinecone.indexes.create` with ``IntegratedSpec``.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.indexes.create`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.indexes.create(...)`` with
+        ``IntegratedSpec(cloud=..., region=..., embed=EmbedConfig(...))`` instead of
+        ``await pc.create_index_for_model(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.create_index_for_model() is deprecated;"
-            " use pc.indexes.create() with IntegratedSpec instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         from pinecone.inference.models.index_embed import IndexEmbed as _IndexEmbed
         from pinecone.models.indexes.specs import EmbedConfig as _EmbedConfig
         from pinecone.models.indexes.specs import IntegratedSpec as _IntegratedSpec
@@ -525,45 +513,30 @@ async def create_index_for_model(
         )
 
     async def describe_index(self, name: str) -> IndexModel:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.indexes.describe`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.indexes.describe`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.indexes.describe(...)`` instead of
+        ``await pc.describe_index(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.describe_index() is deprecated; use pc.indexes.describe() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.indexes.describe(name)
 
     async def list_indexes(self) -> IndexList:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.indexes.list`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.indexes.list`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.indexes.list()`` instead of
+        ``await pc.list_indexes()``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.list_indexes() is deprecated; use pc.indexes.list() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.indexes.list()
 
     async def has_index(self, name: str) -> bool:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.indexes.exists`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.indexes.exists`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.indexes.exists(...)`` instead of
+        ``await pc.has_index(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.has_index() is deprecated; use pc.indexes.exists() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.indexes.exists(name)
 
     async def configure_index(
@@ -576,17 +549,12 @@ async def configure_index(
         embed: dict[str, Any] | None = None,
         read_capacity: dict[str, Any] | None = None,
     ) -> None:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.indexes.configure`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.indexes.configure`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.indexes.configure(...)`` instead of
+        ``await pc.configure_index(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.configure_index() is deprecated; use pc.indexes.configure() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         await self.indexes.configure(
             name=name,
             replicas=replicas,
@@ -598,74 +566,48 @@ async def configure_index(
         )
 
     async def delete_index(self, name: str, timeout: int | None = None) -> None:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.indexes.delete`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.indexes.delete`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.indexes.delete(...)`` instead of
+        ``await pc.delete_index(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.delete_index() is deprecated; use pc.indexes.delete() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         await self.indexes.delete(name, timeout=timeout)
 
     async def create_collection(self, name: str, source: str) -> CollectionModel:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.collections.create`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.collections.create`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.collections.create(...)`` instead of
+        ``await pc.create_collection(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.create_collection() is deprecated; use pc.collections.create() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.collections.create(name=name, source=source)
 
     async def list_collections(self) -> CollectionList:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.collections.list`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.collections.list`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.collections.list()`` instead of
+        ``await pc.list_collections()``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.list_collections() is deprecated; use pc.collections.list() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.collections.list()
 
     async def describe_collection(self, name: str) -> CollectionModel:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.collections.describe`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.collections.describe`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.collections.describe(...)`` instead of
+        ``await pc.describe_collection(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.describe_collection() is deprecated;"
-            " use pc.collections.describe() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.collections.describe(name)
 
     async def delete_collection(self, name: str) -> None:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.collections.delete`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.collections.delete`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.collections.delete(...)`` instead of
+        ``await pc.delete_collection(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.delete_collection() is deprecated; use pc.collections.delete() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         await self.collections.delete(name)
 
     async def create_backup(
@@ -675,17 +617,12 @@ async def create_backup(
         backup_name: str | None = None,
         description: str = "",
     ) -> BackupModel:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.backups.create`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.backups.create`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.backups.create(...)`` instead of
+        ``await pc.create_backup(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.create_backup() is deprecated; use pc.backups.create() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.backups.create(
             index_name=index_name,
             name=backup_name,
@@ -699,49 +636,34 @@ async def list_backups(
         limit: int | None = 10,
         pagination_token: str | None = None,
     ) -> BackupList:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.backups.list`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.backups.list`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.backups.list(...)`` instead of
+        ``await pc.list_backups(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.list_backups() is deprecated; use pc.backups.list() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.backups.list(
             index_name=index_name,
             limit=limit if limit is not None else 10,
             pagination_token=pagination_token,
         )
 
     async def describe_backup(self, *, backup_id: str) -> BackupModel:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.backups.describe`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.backups.describe`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.backups.describe(...)`` instead of
+        ``await pc.describe_backup(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.describe_backup() is deprecated; use pc.backups.describe() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.backups.describe(backup_id=backup_id)
 
     async def delete_backup(self, *, backup_id: str) -> None:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.backups.delete`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.backups.delete`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.backups.delete(...)`` instead of
+        ``await pc.delete_backup(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.delete_backup() is deprecated; use pc.backups.delete() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         await self.backups.delete(backup_id=backup_id)
 
     async def list_restore_jobs(
@@ -750,49 +672,33 @@ async def list_restore_jobs(
         limit: int | None = 10,
         pagination_token: str | None = None,
     ) -> RestoreJobList:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.restore_jobs.list`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.restore_jobs.list`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.restore_jobs.list(...)`` instead of
+        ``await pc.list_restore_jobs(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.list_restore_jobs() is deprecated; use pc.restore_jobs.list() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.restore_jobs.list(
             limit=limit if limit is not None else 10,
             pagination_token=pagination_token,
         )
 
     async def describe_restore_job(self, *, job_id: str) -> RestoreJobModel:
-        """Backwards-compatibility delegate. See :meth:`AsyncPinecone.restore_jobs.describe`.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.restore_jobs.describe`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New code
+        should use ``await pc.restore_jobs.describe(...)`` instead of
+        ``await pc.describe_restore_job(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.describe_restore_job() is deprecated;"
-            " use pc.restore_jobs.describe() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         return await self.restore_jobs.describe(job_id=job_id)
 
     def IndexAsyncio(self, host: str, **kwargs: Any) -> AsyncIndex:  # noqa: N802
-        """Backwards-compatibility async index factory. See ``AsyncIndex``.
+        """Backwards-compatibility shim for :meth:`AsyncPinecone.index`.
 
-        :meta private:
+        Preserved to ease migration from the legacy Pinecone Python SDK. New
+        code should use ``pc.index(host=...)`` (where ``pc`` is an
+        :class:`AsyncPinecone` instance) instead of ``pc.IndexAsyncio(...)``.
         """
-        import warnings
-
-        warnings.warn(
-            "AsyncPinecone.IndexAsyncio() is deprecated; use AsyncIndex directly instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         from pinecone.async_client.async_index import AsyncIndex as _AsyncIndex
 
         return _AsyncIndex(