Add get_metadata() method and make query_metadata() raise KeyError consistently

Introduces a Pythonic get_metadata() method to BinaryView, Function, Project,
TypeArchive, and TypeLibrary classes. This method behaves like dict.get(),
returning a default value (None by default) when a key doesn't exist, instead
of raising a KeyError.

Additionally, updates query_metadata() in TypeArchive and TypeLibrary to raise
KeyError when a key is not found, making them consistent with BinaryView,
Function, and Project. Previously these two classes returned None on missing
keys. This breaking change is documented in the method docstrings.

This provides a more consistent and Pythonic API for querying metadata across
all metadata-supporting classes.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

1 files changed, 28 insertions, 1 deletions

diff --git a/python/function.py b/python/function.py
index 29527f4d..66a8c0dc 100644
--- a/python/function.py
+++ b/python/function.py
@@ -3644,7 +3644,7 @@ class Function:
 
 	def query_metadata(self, key: str) -> 'metadata.MetadataValueType':
 		"""
-		`query_metadata` retrieves metadata associated with the given key stored in the current function.
+		`query_metadata` retrieves metadata associated with the given key stored in the current Function.
 
 		:param str key: key to query
 		:rtype: metadata associated with the key
@@ -3654,6 +3654,33 @@ class Function:
 			raise KeyError(key)
 		return metadata.Metadata(handle=md_handle).value
 
+	def get_metadata(self, key: str, default: Any = None) -> 'metadata.MetadataValueType | Any':
+		"""
+		`get_metadata` retrieves a metadata value associated with the given key stored in the current Function.
+
+		This method behaves like `dict.get()`:
+		- If the key exists, its metadata value is returned.
+		- If the key does not exist and `default` is not provided, `None` is returned.
+		- If the key does not exist and `default` is provided, `default` is returned.
+
+		:param str key: key to query
+		:param default: value to return if the key does not exist (defaults to None)
+		:rtype: metadata associated with the key or the default value
+		:Example:
+
+			>>> current_function.store_metadata("integer", 1337)
+			>>> current_function.get_metadata("integer")
+			1337L
+			>>> current_function.get_metadata("missing")
+			None
+			>>> current_function.get_metadata("missing", 42)
+			42
+		"""
+		md_handle = core.BNFunctionQueryMetadata(self.handle, key)
+		if md_handle is None:
+			return default
+		return metadata.Metadata(handle=md_handle).value
+
 	def remove_metadata(self, key: str) -> None:
 		"""
 		`remove_metadata` removes the metadata associated with key from the current function.