from dataclasses import dataclass from logging import getLogger from os import PathLike from typing import List, Optional from semver import Version logger = getLogger(__name__) class StellarisVersion(Version): """This class represents a Stellaris version. Attributes: major (int): The major version number. minor (int): The minor version number. patch (int): The patch version number. codename (str): The codename of the version. """ def __init__(self, **kwargs) -> None: # Build a dictionary of the arguments except prerelease and build super().__init__(**kwargs) @property def codename(self) -> str: return self.CODENAME_LIST.get(f"{self.major}.{self.minor}", "Unknown") CODENAME_LIST = { "1.0": "Release", "1.1": "Clarke", "1.2": "Asimov", "1.3": "Heinlein", "1.4": "Kennedy", "1.5": "Banks", "1.6": "Adams", "1.7": "Bradbury", "1.8": "Čapek", "1.9": "Boulle", "2.0": "Cherryh", "2.1": "Niven", "2.2": "Le Guin", "2.3": "Wolfe", "2.4": "Lee", "2.5": "Shelley", "2.6": "Verne", "2.7": "Wells", "2.8": "Butler", "3.0": "Dick", # lol "3.1": "Lem", "3.2": "Herbert", "3.3": "Libra", "3.4": "Cepheus", "3.5": "Fornax", "3.6": "Orion", "3.7": "Canis Minor", "3.8": "Gemini", "3.9": "Caelum", "3.10": "Pyxis", "3.11": "Eridanus", "3.12": "Andromeda", "3.13": "Vela", "3.14": "Circinus", } def __str__(self) -> str: version = self.codename version += f" {self.major}.{self.minor}.{self.patch}" if self.prerelease: version += f"-{self.prerelease}" if self.build: version += f"+{self.build}" return version def to_tuple(self) -> tuple: return (self.codename, self.major, self.minor, self.patch, self.prerelease, self.build) def to_dict(self) -> dict: return { "codename": self.codename, "major": self.major, "minor": self.minor, "patch": self.patch, "prerelease": self.prerelease, "build": self.build } @dataclass class Mod: """This class represents a Stellaris mod's descriptor file. Attributes: name (str): The name of the mod. path (PathLike): The path to the mod's directory. dependencies (List[str]): A list of the mod's dependencies. picture (PathLike): The path to the mod's thumbnail picture. tags (List[str]): A list of the mod's tags. version (str): The mod's version. supported_version (StellarisVersion): The version of Stellaris the mod supports. remote_file_id (int): The mod's remote file ID. """ name: str path: Optional[PathLike] = None dependencies: Optional[List[str]] = None picture: Optional[PathLike] = None tags: Optional[List[str]] = None version: Optional[str] = None supported_version: Optional[StellarisVersion] = None remote_file_id: Optional[int] = None def __post_init__(self) -> None: if self.tags and len(self.tags) > 10: logger.warning("Mod %s has more than 10 tags. This will prevent the mod from being uploaded to the Steam Workshop and Paradox Mods.", self.name) if self.supported_version and isinstance(self.supported_version, str): if self.supported_version.startswith("v"): self.supported_version = self.supported_version[1:] self.supported_version = StellarisVersion.parse(version=self.supported_version) def __str__(self) -> str: return self.name @classmethod def from_dict(cls, mod_dict: dict) -> "Mod": return cls(**mod_dict) def to_dict(self) -> dict: return { "name": self.name, "path": self.path, "dependencies": self.dependencies, "picture": self.picture, "tags": self.tags, "version": self.version, "supported_version": self.supported_version.to_dict() if self.supported_version else None, "remote_file_id": self.remote_file_id, } def parse(path: PathLike) -> Mod: """Parse a Stellaris mod descriptor file into a Mod object.""" config = {} current_key = None in_multiline_value = False multiline_value = [] with open(path, 'r', encoding='UTF-8') as file: lines = file.readlines() for line in lines: line = line.strip() if in_multiline_value: if line == '}': in_multiline_value = False config[current_key] = multiline_value else: multiline_value.append(line.strip('"')) elif '=' in line: key, value = line.split('=', 1) key = key.strip() value = value.strip().strip('"') if value == '{': in_multiline_value = True current_key = key multiline_value = [] else: config[key] = value return Mod.from_dict(config)