feat(storage): add support for object context

[shubhangi-google]

This pull request introduces new functionality to the Google::Cloud::Storage::File class, enabling direct manipulation of an object's context. This enhancement provides greater control over file metadata, facilitating more nuanced data management within Google Cloud Storage.

Highlights

• Object Contexts Support: Introduced comprehensive support for Google Cloud Storage Object Contexts, allowing users to attach custom key-value pairs to objects for enhanced metadata management.
• Listing and Filtering: Added the ability to filter object listings based on Object Contexts, supporting queries for presence, absence, existence, and non-existence of specific context keys or key-value pairs.
• Input Validation: Implemented validation to prevent the use of forbidden characters (double quotes) in Object Context keys and values, ensuring compatibility with GCS filter string syntax.
• System and Unit Tests: Expanded test coverage with new system and unit tests to verify the functionality of Object Contexts across various scenarios, including creation, updates, copying, combining, and filtering.

[snippet-bot]

Here is the summary of changes.

You are about to add 3 region tags.

• google-cloud-storage/samples/storage_get_object_contexts.rb:17, tag storage_get_object_contexts
• google-cloud-storage/samples/storage_list_object_contexts.rb:17, tag storage_list_object_contexts
• google-cloud-storage/samples/storage_set_object_contexts.rb:17, tag storage_set_object_contexts

---

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

• Refresh this comment

[aandreassa]

Temporarily adding label. We can remove next week

[cpriti-os]

Please fix this failure

  2) Failure:
Files Snippets::list_object_contexts#test_0001_filters out files on the basis of custom context key [acceptance/files_test.rb:351]:
In stdout.
--- expected
+++ actual
@@ -1,2 +1 @@
-"File: path/file_name_d3ea4590367438be3cfe6f5d5991e3ea.txt has context key: my-custom-key

[shubhangi-google]

fixed

[cpriti-os]

Is this supposed to change in the near future? If not lets not use Currently, just say
Supported for the contexts field or Supported fields: contexts

[shubhangi-google]

done