May 6, 2025 · May 6, 2025
diff --git a/src/runtime/MethodBinder.cs b/src/runtime/MethodBinder.cs
 namespace Python.Runtime
 {
    using MaybeMethodBase = MaybeMethodBase<MethodBase>;

    /// <summary>
    /// Delegate for custom coercion logic during Python method binding.
    /// </summary>
    /// <param name="arguments">A dictionary containing the Python arguments passed to the method.</param>
    /// <param name="methods">An array of method overloads being considered for binding.</param>
    /// <param name="foundBinding">
    /// A reference to the method that was successfully bound. This can be modified by the delegate
    /// to override the default binding logic. The delegate can set this to null to disable the method call
    /// and report an error.
    /// </param>
    public delegate void MethodBinderCoerceBindDelegate(
        Dictionary<string, PyObject> arguments,
        MethodBase[] methods,
        ref MethodBase? foundBinding);

    /// <summary>
    /// A MethodBinder encapsulates information about a (possibly overloaded)
    /// managed method, and is responsible for selecting the right method given
                    }
                }

                return new Binding(mi, target, margs, outs);
                returnCoerceResult(new Binding(mi, target, margs, outs));
            }
            else if (matchGenerics && isGeneric)
            {
                MethodInfo[] overloads = MatchParameters(methods, types);
                if (overloads.Length != 0)
                {
                    return Bind(inst, args, kwargDict, overloads, matchGenerics: false);
                    returnCoerceResult(Bind(inst, args, kwargDict, overloads, matchGenerics: false));
                }
            }
            if (mismatchedMethods.Count > 0)
                Exceptions.SetError(aggregateException);
            }
            return null;

            Binding? CoerceResult(Binding? binding)
            {
                if (binding is not null)
                {
                    var foundMethod = binding.info;
                    MethodBinderEvents.CoerceBind?.Invoke(kwargDict, methods, ref foundMethod);
                    if (foundMethod is null)
                        return null;
                }

                return binding;
            }
        }

        static AggregateException GetAggregateException(IEnumerable<MismatchedMethod> mismatchedMethods)
            }
        }
    }

    /// <summary>
    /// Provides events related to method binding in the MethodBinder class.
    /// </summary>
    public static class MethodBinderEvents
    {
        /// <summary>
        /// Event triggered to allow custom coercion logic during method binding.
        /// </summary>
        public static MethodBinderCoerceBindDelegate? CoerceBind;
    }
 }
Original file line number	Diff line number	Diff line change
Expand Up		@@ -9,6 +9,22 @@
		namespace Python.Runtime
		{
		using MaybeMethodBase = MaybeMethodBase<MethodBase>;

		/// <summary>
		/// Delegate for custom coercion logic during Python method binding.
		/// </summary>
		/// <param name="arguments">A dictionary containing the Python arguments passed to the method.</param>
		/// <param name="methods">An array of method overloads being considered for binding.</param>
		/// <param name="foundBinding">
		/// A reference to the method that was successfully bound. This can be modified by the delegate
		/// to override the default binding logic. The delegate can set this to null to disable the method call
		/// and report an error.
		/// </param>
		public delegate void MethodBinderCoerceBindDelegate(
		Dictionary<string, PyObject> arguments,
		MethodBase[] methods,
		ref MethodBase? foundBinding);

		/// <summary>
		/// A MethodBinder encapsulates information about a (possibly overloaded)
		/// managed method, and is responsible for selecting the right method given
Expand DownExpand Up		@@ -516,7 +532,7 @@ public MismatchedMethod(Exception exception, MethodBase mb)
		}
		}

		return new Binding(mi, target, margs, outs);
		returnCoerceResult(new Binding(mi, target, margs, outs));
		}
		else if (matchGenerics && isGeneric)
		{
Expand All		@@ -528,7 +544,7 @@ public MismatchedMethod(Exception exception, MethodBase mb)
		MethodInfo[] overloads = MatchParameters(methods, types);
		if (overloads.Length != 0)
		{
		return Bind(inst, args, kwargDict, overloads, matchGenerics: false);
		returnCoerceResult(Bind(inst, args, kwargDict, overloads, matchGenerics: false));
		}
		}
		if (mismatchedMethods.Count > 0)
Expand All		@@ -537,6 +553,19 @@ public MismatchedMethod(Exception exception, MethodBase mb)
		Exceptions.SetError(aggregateException);
		}
		return null;

		Binding? CoerceResult(Binding? binding)
		{
		if (binding is not null)
		{
		var foundMethod = binding.info;
		MethodBinderEvents.CoerceBind?.Invoke(kwargDict, methods, ref foundMethod);
		if (foundMethod is null)
		return null;
		}

		return binding;
		}
		}

		static AggregateException GetAggregateException(IEnumerable<MismatchedMethod> mismatchedMethods)
Expand DownExpand Up		@@ -1068,4 +1097,15 @@ static internal class ParameterInfoExtensions
		}
		}
		}

		/// <summary>
		/// Provides events related to method binding in the MethodBinder class.
		/// </summary>
		public static class MethodBinderEvents
		{
		/// <summary>
		/// Event triggered to allow custom coercion logic during method binding.
		/// </summary>
		public static MethodBinderCoerceBindDelegate? CoerceBind;
		}
		}