Fix deprecation version to 52.0.0 and add upgrading guide entry

- Updated deprecation version from 51.0.0 to 52.0.0 for FilterExec methods
- Added comprehensive entry to upgrading.md explaining the migration path
- All 114 filter tests passing

Author: GaneshPatil7517

datafusion/physical-plan/src/filter.rs

@@ -198,7 +198,7 @@ impl FilterExec {
     ///
     /// # Deprecated
     /// Use [`FilterExecBuilder::with_default_selectivity`] instead
-    #[deprecated(since = "51.0.0", note = "Use FilterExecBuilder::with_default_selectivity instead")]
+    #[deprecated(since = "52.0.0", note = "Use FilterExecBuilder::with_default_selectivity instead")]
     pub fn with_default_selectivity(
         self,
         default_selectivity: u8,
@@ -215,7 +215,7 @@ impl FilterExec {
     ///
     /// # Deprecated
     /// Use [`FilterExecBuilder::with_projection`] instead
-    #[deprecated(since = "51.0.0", note = "Use FilterExecBuilder::with_projection instead")]
+    #[deprecated(since = "52.0.0", note = "Use FilterExecBuilder::with_projection instead")]
     pub fn with_projection(&self, projection: Option<Vec<usize>>) -> Result<Self> {
         //  Check if the projection is valid
         can_project(&self.schema(), projection.as_ref())?;
@@ -240,7 +240,7 @@ impl FilterExec {
     ///
     /// # Deprecated
     /// Use [`FilterExecBuilder::with_batch_size`] instead
-    #[deprecated(since = "51.0.0", note = "Use FilterExecBuilder::with_batch_size instead")]
+    #[deprecated(since = "52.0.0", note = "Use FilterExecBuilder::with_batch_size instead")]
     pub fn with_batch_size(&self, batch_size: usize) -> Result<Self> {
         FilterExecBuilder::new(self.predicate.clone(), self.input.clone())
             .with_projection(self.projection.clone())

docs/source/library-user-guide/upgrading.md

@@ -25,6 +25,41 @@
 
 You can see the current [status of the `52.0.0`release here](https://github.com/apache/datafusion/issues/18566)
 
+### `FilterExec` builder methods deprecated
+
+The following methods on `FilterExec` have been deprecated in favor of using `FilterExecBuilder`:
+
+- `with_projection()`
+- `with_default_selectivity()`
+- `with_batch_size()`
+
+**Who is affected:**
+
+- Users who create `FilterExec` instances and use these methods to configure them
+
+**Migration guide:**
+
+Use `FilterExecBuilder` instead of chaining method calls on `FilterExec`:
+
+**Before:**
+
+```rust,ignore
+let filter = FilterExec::try_new(predicate, input)?
+    .with_projection(Some(vec![0, 2]))?
+    .with_default_selectivity(30)?;
+```
+
+**After:**
+
+```rust,ignore
+let filter = FilterExecBuilder::new(predicate, input)
+    .with_projection(Some(vec![0, 2]))
+    .with_default_selectivity(30)
+    .build()?;
+```
+
+The builder pattern is more efficient as it computes properties once during `build()` rather than recomputing them for each method call.
+
 ### Changes to DFSchema API
 
 To permit more efficient planning, several methods on `DFSchema` have been