Add function design interactive notebook

Signed-off-by: Srihari Thyagarajan <[email protected]>

Python/phase_4/function_design.py

@@ -0,0 +1,240 @@
+# /// script
+# requires-python = ">=3.10"
+# dependencies = [
+#     "marimo",
+# ]
+# ///
+
+import marimo
+
+__generated_with = "0.10.16"
+app = marimo.App()
+
+
+@app.cell
+def _():
+    import marimo as mo
+    return (mo,)
+
+
+@app.cell(hide_code=True)
+def _(mo):
+    mo.md(
+        """
+        # 🧩 Function Design in Python
+
+        Dive into the world of Python functions — where code becomes modular and powerful!
+
+        ## Function Basics
+        Functions help you:
+
+        - Break down complex problems
+
+        - Create reusable code blocks
+
+        - Improve code readability (good practice)
+
+        ```python
+        def function_name(parameters):
+            '''Docstring explaining the function'''
+            # Function body
+            return result
+        ```
+        """
+    )
+    return
+
+
+@app.cell
+def _():
+    # Example function with parameter
+    def greet(name):
+        return f"Hello, {name}!"
+
+    name = "Python Learner"
+    return greet, name
+
+
+@app.cell
+def _(greet, name):
+    greet(name)
+    return
+
+
+@app.cell(hide_code=True)
+def _(mo):
+    mo.md(
+        """
+        ## Default Parameters
+        Make your functions more flexible by providing default values.
+        """
+    )
+    return
+
+
+@app.cell
+def _(default_age):
+    default_age
+    return
+
+
+@app.cell
+def _(mo):
+    # Interactive function (default parameter demo)
+    default_age = mo.ui.number(value=18, start=0, stop=120, label="Default Age")
+    return (default_age,)
+
+
+@app.cell
+def _(default_age):
+    def create_profile(name, age=default_age.value):
+        return f"{name} is {age} years old"
+
+    example_name = "Alex"
+    return create_profile, example_name
+
+
+@app.cell
+def _(create_profile, example_name):
+    create_profile(example_name)
+    return
+
+
+@app.cell
+def _(first_param, mo, second_param):
+    mo.hstack([first_param, second_param])
+    return
+
+
+@app.cell
+def _(mo):
+    # Multiple parameters interactive function demo
+    first_param = mo.ui.number(value=10, start=0, stop=100, label="First Number")
+    second_param = mo.ui.number(value=5, start=0, stop=100, label="Second Number")
+    return first_param, second_param
+
+
+@app.cell
+def _(first_param, second_param):
+    def calculate(a, b):
+        """
+        Perform multiple calculations on two numbers.
+
+        Args:
+            a (int): First number
+            b (int): Second number
+
+        Returns:
+            dict: Results of various calculations
+        """
+        return {
+            "sum": a + b,
+            "product": a * b,
+            "difference": a - b,
+            "max": max(a, b)
+        }
+
+    result = calculate(first_param.value, second_param.value)
+    return calculate, result
+
+
+@app.cell(hide_code=True)
+def _(mo, result):
+    mo.md(f"""
+    ## Function Results
+
+    Calculation Results:
+    {result}
+    """)
+    return
+
+
+@app.cell(hide_code=True)
+def _(mo):
+    mo.md(
+        """
+        ## Multiple Return Values
+        Python allows returning multiple values easily:
+
+        ```python
+        def multiple_returns():
+            return value1, value2, value3
+
+        # Unpacking returns
+        x, y, z = multiple_returns()
+        ```
+        """
+    )
+    return
+
+
+@app.cell
+def _(temperature):
+    temperature
+    return
+
+
+@app.cell
+def _(mo):
+    # Multiple return values and how they are captured
+    temperature = mo.ui.number(value=25, start=-50, stop=50, label="Temperature")
+    return (temperature,)
+
+
+@app.cell
+def _(temperature):
+    def weather_analysis(temp):
+        """
+        Analyze weather based on temperature.
+
+        Args:
+            temp (float): Temperature in Celsius (superior unit of measurement)
+
+        Returns:
+            tuple: Weather status, recommendation, warning level
+        """
+        if temp <= 0:
+            return "Freezing", "Wear heavy coat", "High"
+        elif 0 < temp <= 15:
+            return "Cold", "Layer up", "Medium"
+        elif 15 < temp <= 25:
+            return "Mild", "Comfortable clothing", "Low"
+        else:
+            return "Hot", "Stay hydrated", "High"
+
+    analysis = weather_analysis(temperature.value)
+    return analysis, weather_analysis
+
+
+@app.cell(hide_code=True)
+def _(mo, weather_analysis):
+    mo.md(f"""
+    ## Multiple Return Demonstration
+
+    Current Temperature Analysis:
+    {weather_analysis(25)}
+    """)
+    return
+
+
+@app.cell(hide_code=True)
+def _(mo):
+    callout_text = mo.md("""
+    ## Your Function Design Journey!
+
+    Next Steps:
+
+    - Practice creating functions
+
+    - Experiment with default parameters
+
+    - Explore multiple return values
+
+    """)
+
+    mo.callout(callout_text, kind="success")
+    return (callout_text,)
+
+
+if __name__ == "__main__":
+    app.run()