Skip to content

Conversation

@chandra-siri
Copy link
Collaborator

init code for exposing metadata ops into grpcCient

@product-auto-label product-auto-label bot added size: m Pull request size is medium. api: storage Issues related to the googleapis/python-storage API. labels Jan 26, 2026
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @chandra-siri, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces the foundational code for exposing metadata operations within the AsyncGrpcClient for Google Cloud Storage. The primary addition is an asynchronous delete_object method, which enables direct gRPC-based object deletion, supporting conditional operations based on object generation and metageneration. This change enhances the client's capability to interact with Google Cloud Storage at a lower level, providing more granular control over object lifecycle management.

Highlights

  • New delete_object method: Implemented an asynchronous delete_object method in AsyncGrpcClient to support object deletion with various conditional parameters like generation, if_generation_match, and if_metageneration_match.
  • System Test for Deletion: Added a system test (test_delete_object_using_grpc_client) to validate the functionality of the new delete_object method, including verification of object removal and handling of NotFound exceptions.
  • Unit Test for Request Construction: Introduced a dedicated unit test (TestDeleteObject.test_delete_object) to ensure the correct construction of DeleteObjectRequest and proper invocation of the underlying gRPC client.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

The pull request introduces an async_grpc_client with a delete_object method and includes corresponding unit and system tests. The delete_object method correctly constructs the gRPC request. However, there are some inconsistencies and potential issues in the system test's usage of the new method and a minor documentation detail in the async_grpc_client's docstring. The example usage in async_grpc_client.py also has a minor issue with error re-raising.

await writer.append(b'some_bytes')
await writer.close()

await grpc_client.delete_object(bucket=f"projects/_/buckets/{_ZONAL_BUCKET}", object_=object_name)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

critical

The delete_object method of AsyncGrpcClient expects bucket_name and object_name as arguments, not bucket and object_. The method itself handles the formatting of the bucket path. Please adjust the parameter names accordingly.

Suggested change
await grpc_client.delete_object(bucket=f"projects/_/buckets/{_ZONAL_BUCKET}", object_=object_name)
await grpc_client.delete_object(bucket_name=_ZONAL_BUCKET, object_name=object_name)

Comment on lines +577 to +578
"""
Test that a new writer when specifies `None` overrides the existing object.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

The docstring for test_delete_object_using_grpc_client is incorrect. It describes a test for overriding an existing object, not for deleting an object. Please update it to accurately reflect the purpose of this test.

Suggested change
"""
Test that a new writer when specifies `None` overrides the existing object.
"""
Test that `delete_object` using the gRPC client successfully deletes an object.
"""

Comment on lines +596 to +597
with pytest.raises(NotFound):
await grpc_client.get_object(bucket=f"projects/_/buckets/{_ZONAL_BUCKET}", object_=object_name)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

The grpc_client fixture returns an instance of _storage_v2.StorageAsyncClient, which has a get_object method that expects bucket and object_ as keyword arguments, with bucket being the full resource path. However, AsyncGrpcClient does not expose a get_object method directly. If the intention is to use the underlying GAPIC client, the parameters are correct. If AsyncGrpcClient is intended to be the primary interface, then a get_object method should be added to AsyncGrpcClient for consistency, or this test should explicitly call grpc_client._grpc_client.get_object if grpc_client refers to the AsyncGrpcClient wrapper.

Given the delete_object call above is using the AsyncGrpcClient's wrapper method, it would be more consistent to either:

  1. Add a get_object wrapper method to AsyncGrpcClient.
  2. Call grpc_client.grpc_client.get_object directly if grpc_client refers to the AsyncGrpcClient instance (which it doesn't in this fixture, it refers to the underlying GAPIC client).

For now, assuming grpc_client is the GAPIC client, the parameters are correct, but the inconsistency with delete_object is notable.

(Optional) If present, permanently deletes a specific generation
of an object.
:type if_generation_match: long
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The docstring specifies :type if_generation_match: long. In Python, long is not a distinct type from int since Python 3. It should be int for consistency and accuracy.

:param if_generation_match:
(Optional) See :ref:`using-if-generation-match`
:type if_generation_not_match: long
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The docstring specifies :type if_generation_not_match: long. In Python, long is not a distinct type from int since Python 3. It should be int for consistency and accuracy.

:param if_generation_not_match:
(Optional) See :ref:`using-if-generation-not-match`
:type if_metageneration_match: long
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The docstring specifies :type if_metageneration_match: long. In Python, long is not a distinct type from int since Python 3. It should be int for consistency and accuracy.

:param if_metageneration_match:
(Optional) See :ref:`using-if-metageneration-match`
:type if_metageneration_not_match: long
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The docstring specifies :type if_metageneration_not_match: long. In Python, long is not a distinct type from int since Python 3. It should be int for consistency and accuracy.

print("Object deleted successfully.")
except Exception as e:
print(f"An error occurred: {e}")
raise
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

When re-raising an exception caught in an except block, it's generally clearer to explicitly re-raise the caught exception e to preserve the original traceback. While raise alone re-raises the last exception, raise e is more explicit.

Suggested change
raise
raise e

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

api: storage Issues related to the googleapis/python-storage API. size: m Pull request size is medium.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant