crossplane-function-sdk-python 0.12.0__py3-none-any.whl → 0.14.0__py3-none-any.whl

crossplane/function/__version__.py

@@ -15,4 +15,4 @@
 """The version of function-sdk-python."""
 
 # This is set at build time, using "hatch version"
-__version__ = "0.12.0"
+__version__ = "0.14.0"

crossplane/function/resource.py

@@ -40,12 +40,21 @@ def update(r: fnv1.Resource, source: dict | structpb.Struct | pydantic.BaseModel
     """
     match source:
         case pydantic.BaseModel():
-            data = source.model_dump(exclude_defaults=True, warnings=False)
-            # In Pydantic, exclude_defaults=True in model_dump excludes fields
-            # that have their value equal to the default. If a field like
-            # apiVersion is set to its default value 's3.aws.upbound.io/v1beta2'
-            # (and not explicitly provided during initialization), it will be
-            # excluded from the serialized output.
+            # exclude_unset emits only the fields the caller explicitly set.
+            # Crossplane treats desired resources as server-side apply intent,
+            # so a function should own exactly the fields it has an opinion
+            # about and leave the rest to the API server.
+            #
+            # by_alias emits each field under its alias, which is its real
+            # wire name. datamodel-code-generator aliases fields whose KRM
+            # name collides with a Python keyword or builtin (e.g. it emits a
+            # bool_ attribute aliased to bool, continue_ aliased to continue).
+            # Without by_alias those fields serialize under the Python name and
+            # don't match the resource's schema. It's a no-op for ordinary
+            # fields, which have no alias.
+            data = source.model_dump(exclude_unset=True, by_alias=True, warnings=False)
+            # apiVersion and kind identify the resource but are rarely passed
+            # as kwargs, so they're usually unset. Add them back explicitly.
             data["apiVersion"] = source.apiVersion
             data["kind"] = source.kind
             r.resource.update(data)
@@ -71,11 +80,12 @@ def update_status(
         status: The status to set, as a dictionary or Pydantic model.
 
     Sets ``r.resource.status`` from the supplied status. When the status
-    is a Pydantic model, fields set to their default value are excluded,
+    is a Pydantic model, fields the caller didn't explicitly set are
+    excluded and aliased fields are emitted under their wire names,
     matching the behavior of :func:`update`.
     """
     if isinstance(status, pydantic.BaseModel):
-        status = status.model_dump(exclude_defaults=True, warnings=False)
+        status = status.model_dump(exclude_unset=True, by_alias=True, warnings=False)
     update(r, {"status": status})
 
 

crossplane/function/response.py

@@ -163,13 +163,16 @@ def require_resources(  # noqa: PLR0913
         namespace: The namespace to search in (optional).
 
     Raises:
-        ValueError: If both match_name and match_labels are provided, or neither.
+        ValueError: If both match_name and match_labels are provided.
 
     This tells Crossplane to fetch the specified resources and include them
     in the next call to the function in req.required_resources[name].
+
+    If neither match_name nor match_labels is provided, all resources of the
+    given api_version and kind are matched.
     """
-    if (match_name is None) == (match_labels is None):
-        msg = "Exactly one of match_name or match_labels must be provided"
+    if match_name is not None and match_labels is not None:
+        msg = "match_name and match_labels are mutually exclusive"
         raise ValueError(msg)
 
     selector = fnv1.ResourceSelector(

crossplane/function/runtime.py

@@ -70,7 +70,7 @@ def load_credentials(tls_certs_dir: str) -> grpc.ServerCredentials:
 
 
 def serve(
-    function: grpcv1.FunctionRunnerService,
+    function: grpcv1.FunctionRunnerServiceServicer,
     address: str,
     *,
     creds: grpc.ServerCredentials,
@@ -134,20 +134,20 @@ def serve(
         loop.close()
 
 
-class BetaFunctionRunner(grpcv1beta1.FunctionRunnerService):
+class BetaFunctionRunner(grpcv1beta1.FunctionRunnerServiceServicer):
     """A BetaFunctionRunner handles beta gRPC RunFunctionRequests.
 
-    It handles requests by passing them to a wrapped v1.FunctionRunnerService.
+    It handles requests by passing them to a wrapped v1.FunctionRunnerServiceServicer.
     Incoming v1beta1 requests are converted to v1 by round-tripping them through
     serialization. Outgoing requests are converted from v1 to v1beta1 the same
     way.
     """
 
-    def __init__(self, wrapped: grpcv1.FunctionRunnerService):
+    def __init__(self, wrapped: grpcv1.FunctionRunnerServiceServicer):
         """Create a new BetaFunctionRunner."""
         self.wrapped = wrapped
 
-    async def RunFunction(  # noqa: N802  # gRPC requires this name.
+    async def RunFunction(  # noqa: N802  # gRPC requires this name. # pyright: ignore[reportIncompatibleMethodOverride]
         self, req: fnv1beta1.RunFunctionRequest, context: grpc.aio.ServicerContext
     ) -> fnv1beta1.RunFunctionResponse:
         """Run the underlying function."""

{crossplane_function_sdk_python-0.12.0.dist-info → crossplane_function_sdk_python-0.14.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crossplane-function-sdk-python
-Version: 0.12.0
+Version: 0.14.0
 Summary: The Python SDK for Crossplane composition functions
 Project-URL: Documentation, https://github.com/crossplane/function-sdk-python#readme
 Project-URL: Issues, https://github.com/crossplane/function-sdk-python/issues
@@ -14,10 +14,10 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Requires-Dist: grpcio-reflection==1.*
-Requires-Dist: grpcio==1.80.0
+Requires-Dist: grpcio==1.81.0
 Requires-Dist: protobuf==7.35.0
 Requires-Dist: pydantic==2.*
-Requires-Dist: structlog==25.*
+Requires-Dist: structlog==26.*
 Description-Content-Type: text/markdown
 
 # function-sdk-python

{crossplane_function_sdk_python-0.12.0.dist-info → crossplane_function_sdk_python-0.14.0.dist-info}/RECORD

@@ -1,10 +1,10 @@
-crossplane/function/__version__.py,sha256=gtv076U2x6TC6KinwdT_-8jd1AkxueHUDZc5tRyideE,705
+crossplane/function/__version__.py,sha256=oKtus0bQUO42aKqWWxuhQxgBpNDRCrC6BLgLMdh_1Vk,705
 crossplane/function/logging.py,sha256=Zawqq36FBzjkVg4bJ3VGK12-so7N8yAMoSPrhdwpBSA,2503
 crossplane/function/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 crossplane/function/request.py,sha256=ncgGTyAvBOdZ8M7KPy_H9pL08_cYzKJ3D9q_rnSjPXo,8199
-crossplane/function/resource.py,sha256=9tNOsxOzT2mpIbw-tUXfLxH8zs2mGkrkU2JRkFSUN_E,7697
-crossplane/function/response.py,sha256=7LR5CFaMOpBU2Fv-TMFe_CFx0mgZXX9WDm7vV8FtwtY,6965
-crossplane/function/runtime.py,sha256=2S-AheR2o0pJxJRhDZDoWpJxCleIv_aHTnzRGgrZv_8,5415
+crossplane/function/resource.py,sha256=D9OWyzfQNZhPQFDDFDBqva9bPiKV2nRuivG_L1mBjv4,8386
+crossplane/function/response.py,sha256=H5LnyBBTs6ZGmRfMOXew3o_3DkMEfhi77xG6xGZ8NLo,7072
+crossplane/function/runtime.py,sha256=2Is5E2XuJibWH0CLULhJ_cmMcRYDeBApypZca97l8Xw,5499
 crossplane/function/proto/v1/run_function.proto,sha256=GbJ0wVUEjfpMsn2DsnhiPvtmL09z3oyMbWwf6viQtiw,16676
 crossplane/function/proto/v1/run_function_pb2.py,sha256=eeQajHePjvswGCEH2FRxyr8P-K0Go55U5L4rAa32JA8,14440
 crossplane/function/proto/v1/run_function_pb2.pyi,sha256=MvjcY39d1xJ4ZZmRibhehCKF1mHVGb6qfpoCQO8XYqE,14374
@@ -13,7 +13,7 @@ crossplane/function/proto/v1beta1/run_function.proto,sha256=EVYIEQCiPu1eOdGJQ3tu
 crossplane/function/proto/v1beta1/run_function_pb2.py,sha256=G4TTK_cYTOQlRN5byADcEFPjTILYYWj3b4m19iiPO4g,14664
 crossplane/function/proto/v1beta1/run_function_pb2.pyi,sha256=MvjcY39d1xJ4ZZmRibhehCKF1mHVGb6qfpoCQO8XYqE,14374
 crossplane/function/proto/v1beta1/run_function_pb2_grpc.py,sha256=Hj5KCSTyT_vIpTXWwc5MwiKxwxaOhjbfY5Iedidx9AQ,4033
-crossplane_function_sdk_python-0.12.0.dist-info/METADATA,sha256=2l-XG9JHoD_zywEhVUkZQ97iLT05wO4qFEpdeB8Gs3Y,3244
-crossplane_function_sdk_python-0.12.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-crossplane_function_sdk_python-0.12.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-crossplane_function_sdk_python-0.12.0.dist-info/RECORD,,
+crossplane_function_sdk_python-0.14.0.dist-info/METADATA,sha256=I3UMTU0jZB9yFSy_w0zy65iIcNgkccljVz2dxGClTUU,3244
+crossplane_function_sdk_python-0.14.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+crossplane_function_sdk_python-0.14.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+crossplane_function_sdk_python-0.14.0.dist-info/RECORD,,

{crossplane_function_sdk_python-0.12.0.dist-info → crossplane_function_sdk_python-0.14.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.29.0
+Generator: hatchling 1.30.1
 Root-Is-Purelib: true
 Tag: py3-none-any