from typing import Any, Dict
import pandas as pd


class PandasHead:
    """
    PandasHead:
        A class for retrieving the first few rows of a pandas DataFrame.
    """
    
    @classmethod
    def INPUT_TYPES(cls) -> Dict[str, Any]:
        """
        Defines the input types for the `head` function.

        Returns:
            Dict[str, Any]: A dictionary specifying required input types.
        """
        return {
            "required": {
                "dataframe_json": ("STRING", {"multiline": True}),
                "rows": ("INT", {"default": 10, "min": 0, "max": 50})
            }
        }

    RETURN_TYPES: tuple = ("STRING",)
    FUNCTION: str = "head"
    CATEGORY: str = "Data Analysis"

    def head(self, dataframe_json: str, rows: int) -> tuple:
        """
        Returns the first `rows` rows of a pandas DataFrame.

        Args:
            dataframe_json (str): A JSON string representation of the DataFrame.
            rows (int): The number of rows to retrieve.

        Returns:
            tuple: A tuple containing a JSON string of the resulting DataFrame.
        """
        # Deserialize JSON string to DataFrame
        df = pd.read_json(dataframe_json)
        df2 = df.head(rows)
        return (df2.to_json(),)