Change to accept uppercase strings for extrude method (#7874)

* Change to accept uppercase strings for extrude method

* Add example test that uses method NEW

* Update docs

Author: jtran

docs/kcl-std/functions/std-sketch-extrude.md

@@ -128,6 +128,7 @@ pub const TEST_NAMES: &[&str] = &[
     "std-sketch-extrude-2",
     "std-sketch-extrude-3",
     "std-sketch-extrude-4",
+    "std-sketch-extrude-5",
     "std-sketch-polygon-0",
     "std-sketch-polygon-1",
     "std-sketch-sweep-0",

rust/kcl-derive-docs/src/example_tests.rs

@@ -84,12 +84,12 @@ async fn inner_extrude(
     let tolerance = LengthUnit(tolerance.as_ref().map(|t| t.to_mm()).unwrap_or(DEFAULT_TOLERANCE_MM));
 
     let extrude_method = match method.as_deref() {
-        Some("new") => ExtrudeMethod::New,
-        Some("merge") => ExtrudeMethod::Merge,
+        Some("new" | "NEW") => ExtrudeMethod::New,
+        Some("merge" | "MERGE") => ExtrudeMethod::Merge,
         None => ExtrudeMethod::default(),
         Some(other) => {
             return Err(KclError::new_semantic(KclErrorDetails::new(
-                format!("Unknown merge method {other}, try using MERGE or NEW"),
+                format!("Unknown merge method {other}, try using `MERGE` or `NEW`"),
                 vec![args.source_range],
             )));
         }

rust/kcl-lib/src/std/extrude.rs

@@ -443,6 +443,27 @@ export fn ellipse(
 ///   |> polygon(radius = 10, numSides = 3, center = [0, 0])
 ///   |> extrude(length = 10, twistAngle = 120deg)
 /// ```
+///
+/// ```kcl
+/// sketch001 = startSketchOn(XY)
+/// profile001 = startProfile(sketch001, at = [0, 0])
+///   |> yLine(length = 1)
+///   |> xLine(length = 1)
+///   |> yLine(length = -1)
+///   |> line(endAbsolute = [profileStartX(%), profileStartY(%)])
+///   |> close()
+/// cube = extrude(profile001, length = 1)
+///
+/// sketch002 = startSketchOn(cube, face = END)
+/// profile002 = circle(sketch002, center = [0.38, 0.64], radius = 0.13)
+/// // When sketching on a face, we can make a new solid instead of merging with
+/// // it by using the method parameter.
+/// cylinder = extrude(profile002, length = 2, method = NEW)
+///
+/// // The cylinder is a separate solid that can be translated separately from
+/// // the cube.
+/// translate(cylinder, x = 1)
+/// ```
 @(impl = std_rust)
 export fn extrude(
   /// Which sketch or sketches should be extruded.