Source code for extra_platforms.architecture

# Copyright Kevin Deldycke <kevin@deldycke.com> and contributors.
#
# This program is Free Software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
"""CPU architectures."""

from __future__ import annotations

import platform
from dataclasses import dataclass, field

from .trait import Trait




@dataclass(frozen=True)
class Architecture(Trait):
    """A CPU architecture identifies a `processor instruction set
    <https://en.wikipedia.org/wiki/Instruction_set_architecture>`_.

    It has a unique ID, a human-readable name, and boolean to flag current architecture.
    """

    icon: str = field(repr=False, default="▣")
    """Icon of the architecture."""

    def __post_init__(self) -> None:
        """Validate and normalize architecture fields."""
        super().__post_init__()
        # Customize the docstring for architectures.
        object.__setattr__(self, "__doc__", f"Identify {self.name} architecture.")



    def info(self) -> dict[str, str | bool | None]:
        """Returns all architecture attributes we can gather."""
        info: dict[str, str | bool | None] = {
            **self._base_info(),
            "machine": None,
            "processor": None,
        }
        if self.current:
            info["machine"] = platform.machine() or None
            info["processor"] = platform.processor() or None

        return info