amd-node-scraper 0.0.1__py3-none-any.whl

nodescraper/plugins/inband/amdsmi/analyzer_args.py

@@ -0,0 +1,50 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from datetime import datetime
+from typing import Optional
+
+from nodescraper.models import AnalyzerArgs
+
+
+class AmdSmiAnalyzerArgs(AnalyzerArgs):
+
+    check_static_data: bool = False
+    expected_gpu_processes: Optional[int] = None
+    expected_max_power: Optional[int] = None
+    expected_driver_version: Optional[str] = None
+    expected_memory_partition_mode: Optional[str] = None
+    expected_compute_partition_mode: Optional[str] = None
+    expected_pldm_version: Optional[str] = None
+    l0_to_recovery_count_error_threshold: Optional[int] = 3
+    l0_to_recovery_count_warning_threshold: Optional[int] = 1
+    vendorid_ep: Optional[str] = None
+    vendorid_ep_vf: Optional[str] = None
+    devid_ep: Optional[str] = None
+    devid_ep_vf: Optional[str] = None
+    sku_name: Optional[str] = None
+    expected_xgmi_speed: Optional[list[float]] = None
+    analysis_range_start: Optional[datetime] = None
+    analysis_range_end: Optional[datetime] = None

nodescraper/plugins/inband/amdsmi/cper.py

@@ -0,0 +1,65 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+
+import io
+from datetime import datetime
+from typing import Dict, Optional
+
+from nodescraper.enums import EventCategory, EventPriority
+
+
+class CperAnalysisTaskMixin:
+    def analyzer_cpers(
+        self,
+        cper_data: Dict[str, io.BytesIO],
+        analysis_range_start: Optional[datetime],
+        analysis_range_end: Optional[datetime],
+    ):
+        """Generate Events from CPER data.
+
+        Note: CPER analysis is not currently implemented. This is a stub that logs
+        a warning when CPER data is present.
+
+        Args:
+            cper_data (Dict[str, io.BytesIO]): Dictionary of CPER file names to file contents
+            analysis_range_start (Optional[datetime]): Optional start time for analysis range
+            analysis_range_end (Optional[datetime]): Optional end time for analysis range
+        """
+        # check the self._log_event method is defined
+        if not hasattr(self, "_log_event") or not callable(self._log_event):
+            raise NotImplementedError("The class must implement the _log_event method.")
+
+        if cper_data:
+            self._log_event(
+                category=EventCategory.RAS,
+                priority=EventPriority.WARNING,
+                description="CPER data found but analysis is not implemented",
+                data={
+                    "cper_file_count": len(cper_data),
+                    "cper_files": list(cper_data.keys()),
+                    "note": "CPER analysis requires additional dependencies not currently available",
+                },
+            )

nodescraper/plugins/inband/bios/__init__.py

@@ -0,0 +1,29 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from .analyzer_args import BiosAnalyzerArgs
+from .bios_plugin import BiosPlugin
+
+__all__ = ["BiosPlugin", "BiosAnalyzerArgs"]

nodescraper/plugins/inband/bios/analyzer_args.py

@@ -0,0 +1,64 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from typing import Union
+
+from pydantic import Field, field_validator
+
+from nodescraper.models import AnalyzerArgs
+from nodescraper.plugins.inband.os.osdata import OsDataModel
+
+
+class BiosAnalyzerArgs(AnalyzerArgs):
+    exp_bios_version: list[str] = Field(default_factory=list)
+    regex_match: bool = False
+
+    @field_validator("exp_bios_version", mode="before")
+    @classmethod
+    def validate_exp_bios_version(cls, exp_bios_version: Union[str, list]) -> list:
+        """support str or list input for exp_bios_version
+
+        Args:
+            exp_bios_version (Union[str, list]): expected BIOS version(s) to match against
+
+        Returns:
+            list: a list of expected BIOS versions
+        """
+        if isinstance(exp_bios_version, str):
+            exp_bios_version = [exp_bios_version]
+
+        return exp_bios_version
+
+    @classmethod
+    def build_from_model(cls, datamodel: OsDataModel) -> "BiosAnalyzerArgs":
+        """build analyzer args from data model
+
+        Args:
+            datamodel (BiosDataModel): data model for plugin
+
+        Returns:
+            BiosAnalyzerArgs: instance of analyzer args class
+        """
+        return cls(exp_bios_version=datamodel.bios_version)

nodescraper/plugins/inband/bios/bios_analyzer.py

@@ -0,0 +1,93 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+
+import re
+from typing import Optional
+
+from nodescraper.enums import EventCategory, EventPriority, ExecutionStatus
+from nodescraper.interfaces import DataAnalyzer
+from nodescraper.models import TaskResult
+
+from .analyzer_args import BiosAnalyzerArgs
+from .biosdata import BiosDataModel
+
+
+class BiosAnalyzer(DataAnalyzer[BiosDataModel, BiosAnalyzerArgs]):
+    """Check bios matches expected bios details"""
+
+    DATA_MODEL = BiosDataModel
+
+    def analyze_data(
+        self, data: BiosDataModel, args: Optional[BiosAnalyzerArgs] = None
+    ) -> TaskResult:
+        """Analyze the BIOS data against expected BIOS versions.
+
+        Args:
+            data (BiosDataModel): The BIOS data to analyze.
+            args (Optional[BiosAnalyzerArgs], optional): Expected BIOS data. Defaults to None.
+
+        Returns:
+            TaskResult: The result of the analysis, indicating whether the BIOS data matches
+            the expected versions or not.
+        """
+
+        if not args or not args.exp_bios_version:
+            self.result.message = "Expected bios not provided"
+            self.result.status = ExecutionStatus.NOT_RAN
+            return self.result
+
+        for bios_version in args.exp_bios_version:
+            self.logger.info(bios_version)
+            if args.regex_match:
+                try:
+                    bios_regex = re.compile(bios_version)
+                except re.error:
+                    self._log_event(
+                        category=EventCategory.BIOS,
+                        description=f"Invalid regex pattern: {bios_version}",
+                        priority=EventPriority.ERROR,
+                    )
+                    continue
+                if bios_regex.match(data.bios_version):
+                    self.result.message = "Bios data matches expected"
+                    self.result.status = ExecutionStatus.OK
+                    return self.result
+            elif data.bios_version == bios_version:
+                self.result.message = "Bios data matches expected"
+                self.result.status = ExecutionStatus.OK
+                return self.result
+
+        self.result.message = (
+            f"Bios data mismatch! Expected {args.exp_bios_version}, actual: {data.bios_version}"
+        )
+        self.result.status = ExecutionStatus.ERROR
+        self._log_event(
+            category=EventCategory.BIOS,
+            description=f"{self.result.message}, Actual: {data.bios_version}",
+            priority=EventPriority.ERROR,
+            console_log=True,
+        )
+        return self.result

nodescraper/plugins/inband/bios/bios_collector.py

@@ -0,0 +1,93 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from typing import Optional
+
+from nodescraper.base import InBandDataCollector
+from nodescraper.enums import EventCategory, EventPriority, ExecutionStatus, OSFamily
+from nodescraper.models import TaskResult
+
+from .biosdata import BiosDataModel
+
+
+class BiosCollector(InBandDataCollector[BiosDataModel, None]):
+    """Collect BIOS details"""
+
+    DATA_MODEL = BiosDataModel
+    CMD_WINDOWS = "wmic bios get SMBIOSBIOSVersion /Value"
+    CMD = "sh -c 'cat /sys/devices/virtual/dmi/id/bios_version'"
+
+    def collect_data(
+        self,
+        args=None,
+    ) -> tuple[TaskResult, Optional[BiosDataModel]]:
+        """Collect BIOS version information from the system.
+
+        Returns:
+            tuple[TaskResult, Optional[BiosDataModel]]: tuple containing the task result and an instance of BiosDataModel
+            or None if the BIOS version could not be determined.
+        """
+        bios = None
+
+        if self.system_info.os_family == OSFamily.WINDOWS:
+            res = self._run_sut_cmd(self.CMD_WINDOWS)
+            if res.exit_code == 0:
+                bios = [line for line in res.stdout.splitlines() if "SMBIOSBIOSVersion=" in line][
+                    0
+                ].split("=")[1]
+        else:
+            res = self._run_sut_cmd(self.CMD)
+            if res.exit_code == 0:
+                bios = res.stdout
+
+        if res.exit_code != 0:
+            self._log_event(
+                category=EventCategory.OS,
+                description="Error checking BIOS version",
+                data={"command": res.command, "exit_code": res.exit_code},
+                priority=EventPriority.ERROR,
+                console_log=True,
+            )
+
+        if bios:
+            bios_data = BiosDataModel(bios_version=bios)
+            self._log_event(
+                category="BIOS_READ",
+                description="BIOS version read",
+                data=bios_data.model_dump(),
+                priority=EventPriority.INFO,
+            )
+            self.result.message = f"BIOS: {bios}"
+        else:
+            bios_data = None
+            self._log_event(
+                category=EventCategory.BIOS,
+                description="BIOS version not found",
+                priority=EventPriority.CRITICAL,
+            )
+            self.result.message = "BIOS version not found"
+            self.result.status = ExecutionStatus.ERROR
+
+        return self.result, bios_data

nodescraper/plugins/inband/bios/bios_plugin.py

@@ -0,0 +1,43 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from nodescraper.base import InBandDataPlugin
+
+from .analyzer_args import BiosAnalyzerArgs
+from .bios_analyzer import BiosAnalyzer
+from .bios_collector import BiosCollector
+from .biosdata import BiosDataModel
+
+
+class BiosPlugin(InBandDataPlugin[BiosDataModel, None, BiosAnalyzerArgs]):
+    """Plugin for collection and analysis of BIOS data"""
+
+    DATA_MODEL = BiosDataModel
+
+    COLLECTOR = BiosCollector
+
+    ANALYZER = BiosAnalyzer
+
+    ANALYZER_ARGS = BiosAnalyzerArgs

nodescraper/plugins/inband/bios/biosdata.py

@@ -0,0 +1,30 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from nodescraper.models import DataModel
+
+
+class BiosDataModel(DataModel):
+    bios_version: str

nodescraper/plugins/inband/cmdline/__init__.py

@@ -0,0 +1,25 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################

nodescraper/plugins/inband/cmdline/analyzer_args.py

@@ -0,0 +1,80 @@
+###############################################################################
+#
+# MIT License
+#
+# Copyright (c) 2025 Advanced Micro Devices, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+###############################################################################
+from typing import Union
+
+from pydantic import Field, field_validator
+
+from nodescraper.models import AnalyzerArgs
+from nodescraper.plugins.inband.cmdline.cmdlinedata import CmdlineDataModel
+
+
+class CmdlineAnalyzerArgs(AnalyzerArgs):
+    required_cmdline: Union[str, list] = Field(default_factory=list)
+    banned_cmdline: Union[str, list] = Field(default_factory=list)
+
+    @field_validator("required_cmdline", mode="before")
+    @classmethod
+    def validate_required_cmdline(cls, required_cmdline: Union[str, list]) -> list:
+        """support str or list input for required_cmdline
+
+        Args:
+            required_cmdline (Union[str, list]): required command line arguments
+
+        Returns:
+            list: list of required command line arguments
+        """
+        if isinstance(required_cmdline, str):
+            required_cmdline = [required_cmdline]
+
+        return required_cmdline
+
+    @field_validator("banned_cmdline", mode="before")
+    @classmethod
+    def validate_banned_cmdline(cls, banned_cmdline: Union[str, list]) -> list:
+        """support str or list input for banned_cmdline
+
+        Args:
+            banned_cmdline (Union[str, list]): banned command line arguments
+
+        Returns:
+            list: a list of banned command line arguments
+        """
+        if isinstance(banned_cmdline, str):
+            banned_cmdline = [banned_cmdline]
+
+        return banned_cmdline
+
+    @classmethod
+    def build_from_model(cls, datamodel: CmdlineDataModel) -> "CmdlineAnalyzerArgs":
+        """build analyzer args from data model
+
+        Args:
+            datamodel (CmdlineDataModel): data model for plugin
+
+        Returns:
+            CmdlineAnalyzerArgs: instance of analyzer args class
+        """
+        return cls(required_cmdline=datamodel.cmdline)