PyLibMS 3.2.4__tar.gz → 3.2.6__tar.gz

{pylibms-3.2.4 → pylibms-3.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyLibMS
-Version: 3.2.4
+Version: 3.2.6
 Summary: Python library built for the libMessageStudio (LMS) proprietary file formats from Nintendo. Supports MSBT, MSBP, and MSBF.
 Author: AbdyyEee
 License: Copyright 2025 AbdyyEee
@@ -25,8 +25,8 @@ PylibMS is a library built in Python 3.10+ for the libMessageStudio (LMS) propri
 * Full reading and writing of MSBT files.
 * Full reading of MSBP files.
 * Supports encoded/decoded attributes
-* Supporting encoded/decoded tags 1:1 with Nintendos offical tool and BB code Syntax.
-* Additonal tag manipulation.
+* Supporting encoded/decoded tags 1:1 with Nintendo's official tool and BB code Syntax.
+* Additional tag manipulation.
 
 This library is designed to support LMS revision 3.0 and above, with the associated file formats used across the following Nintendo platforms:
 * Wii (Specific titles only)
@@ -35,6 +35,8 @@ This library is designed to support LMS revision 3.0 and above, with the associa
 * Mobile (Specific titles only)
 * Nintendo Switch
 
+MSBF is in current in the works.
+
 # Features and Usage
 Simple preview of the library is below. See [the wiki](https://github.com/AbdyyEee/PylibMS/wiki) for more explanations and examples.
 ## Reading 
@@ -57,7 +59,7 @@ To add or edit Preset, you may create an issue with the relevant `yaml` file and
 ```
 pip install PylibMS
 ```
-[Pip Page](https://pypi.org/project/PyLibMS/0.6/)
+[Pip Page](https://pypi.org/project/PyLibMS/)
 
 # Build Instructions
 Python version must be `>=3.12.`

{pylibms-3.2.4 → pylibms-3.2.6}/PyLibMS.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyLibMS
-Version: 3.2.4
+Version: 3.2.6
 Summary: Python library built for the libMessageStudio (LMS) proprietary file formats from Nintendo. Supports MSBT, MSBP, and MSBF.
 Author: AbdyyEee
 License: Copyright 2025 AbdyyEee
@@ -25,8 +25,8 @@ PylibMS is a library built in Python 3.10+ for the libMessageStudio (LMS) propri
 * Full reading and writing of MSBT files.
 * Full reading of MSBP files.
 * Supports encoded/decoded attributes
-* Supporting encoded/decoded tags 1:1 with Nintendos offical tool and BB code Syntax.
-* Additonal tag manipulation.
+* Supporting encoded/decoded tags 1:1 with Nintendo's official tool and BB code Syntax.
+* Additional tag manipulation.
 
 This library is designed to support LMS revision 3.0 and above, with the associated file formats used across the following Nintendo platforms:
 * Wii (Specific titles only)
@@ -35,6 +35,8 @@ This library is designed to support LMS revision 3.0 and above, with the associa
 * Mobile (Specific titles only)
 * Nintendo Switch
 
+MSBF is in current in the works.
+
 # Features and Usage
 Simple preview of the library is below. See [the wiki](https://github.com/AbdyyEee/PylibMS/wiki) for more explanations and examples.
 ## Reading 
@@ -57,7 +59,7 @@ To add or edit Preset, you may create an issue with the relevant `yaml` file and
 ```
 pip install PylibMS
 ```
-[Pip Page](https://pypi.org/project/PyLibMS/0.6/)
+[Pip Page](https://pypi.org/project/PyLibMS/)
 
 # Build Instructions
 Python version must be `>=3.12.`

{pylibms-3.2.4 → pylibms-3.2.6}/README.md

@@ -4,8 +4,8 @@ PylibMS is a library built in Python 3.10+ for the libMessageStudio (LMS) propri
 * Full reading and writing of MSBT files.
 * Full reading of MSBP files.
 * Supports encoded/decoded attributes
-* Supporting encoded/decoded tags 1:1 with Nintendos offical tool and BB code Syntax.
-* Additonal tag manipulation.
+* Supporting encoded/decoded tags 1:1 with Nintendo's official tool and BB code Syntax.
+* Additional tag manipulation.
 
 This library is designed to support LMS revision 3.0 and above, with the associated file formats used across the following Nintendo platforms:
 * Wii (Specific titles only)
@@ -14,6 +14,8 @@ This library is designed to support LMS revision 3.0 and above, with the associa
 * Mobile (Specific titles only)
 * Nintendo Switch
 
+MSBF is in current in the works.
+
 # Features and Usage
 Simple preview of the library is below. See [the wiki](https://github.com/AbdyyEee/PylibMS/wiki) for more explanations and examples.
 ## Reading 
@@ -36,7 +38,7 @@ To add or edit Preset, you may create an issue with the relevant `yaml` file and
 ```
 pip install PylibMS
 ```
-[Pip Page](https://pypi.org/project/PyLibMS/0.6/)
+[Pip Page](https://pypi.org/project/PyLibMS/)
 
 # Build Instructions
 Python version must be `>=3.12.`

{pylibms-3.2.4 → pylibms-3.2.6}/lms/message/msbt.py

@@ -1,9 +1,8 @@
-from typing import Any
-
 from lms.common.lms_fileinfo import LMS_FileInfo
 from lms.message.msbtentry import MSBTEntry
 from lms.titleconfig.definitions.attribute import AttributeConfig
 from lms.titleconfig.definitions.tags import TagConfig
+from lms.fileio.encoding import FileEncoding
 
 
 class MSBT:
@@ -47,6 +46,26 @@ class MSBT:
         self._attribute_config = attribute_config
         self._tag_config = tag_config
 
+    @classmethod
+    def new(cls,
+            attribute_config: AttributeConfig | None = None,
+            tag_config: TagConfig | None = None,
+            is_big_endian: bool = False,
+            encoding: FileEncoding = FileEncoding.UTF16,
+            version: int = 3,
+            section_count: int = 2):
+        """Creates a new MSBT instance.
+
+        :param attribute_config: The attribute config object
+        :param tag_config: The tag config object
+        :param is_big_endian: if the file is big endian.
+        :param encoding: the file encoding.
+        :param version: the file version.
+        :param section_count: the number of sections.
+        """
+        return MSBT(info=LMS_FileInfo(is_big_endian, encoding, version, section_count),
+                    attribute_config=attribute_config, tag_config=tag_config)
+
     def __len__(self) -> int:
         return len(self._entries)
 

{pylibms-3.2.4 → pylibms-3.2.6}/lms/message/section/atr1.py

@@ -39,6 +39,11 @@ def read_encoded_atr1(reader: FileReader, section_size: int) -> ATR1Data:
 
 
 def read_decoded_atr1(reader: FileReader, config: AttributeConfig) -> ATR1Data:
+    # String table as a list is not necessary for decoded attributes
+    # It is easier to save all changes from the user by when writing
+    # to recreate the table from all the string parameters in every attribute
+    string_table = None
+
     section_start = reader.tell()
 
     attr_count = reader.read_uint32()
@@ -63,7 +68,7 @@ def read_decoded_atr1(reader: FileReader, config: AttributeConfig) -> ATR1Data:
 
         attributes.append(LMS_FieldMap(attribute))
 
-    return ATR1Data(attributes, size_per_attribute, None)
+    return ATR1Data(attributes, size_per_attribute, string_table)
 
 
 def write_encoded_atr1(

{pylibms-3.2.4 → pylibms-3.2.6}/lms/message/tag/io/param_io.py

@@ -13,10 +13,11 @@ TAG_PADDING_BYTE = b"\xcd"
 
 def read_encoded_parameters(
     reader: FileReader, parameter_size: int
-) -> list[str] | None:
+) -> list[int] | None:
+
     hex_parameters = reader.read_bytes(parameter_size).hex().upper()
     encoded_parameters = [
-        f"{hex_parameters[i : i + 2]}" for i in range(0, len(hex_parameters), 2)
+        int(f"{hex_parameters[i : i + 2]}", 16) for i in range(0, len(hex_parameters), 2)
     ]
     return encoded_parameters
 
@@ -42,10 +43,10 @@ def read_decoded_parameters(
     return LMS_FieldMap(parameters)
 
 
-def write_encoded_parameters(writer: FileWriter, parameters: list[str]) -> None:
+def write_encoded_parameters(writer: FileWriter, parameters: list[int]) -> None:
     writer.write_uint16(len(parameters))
     for param in parameters:
-        writer.write_bytes(bytes.fromhex(param))
+        writer.write_bytes(int.to_bytes(param, 1))
 
 
 def write_decoded_parameters(

{pylibms-3.2.4 → pylibms-3.2.6}/lms/message/tag/io/tag_io.py

@@ -92,7 +92,7 @@ def _read_decoded_tag(
     return LMS_DecodedTag(definition, parameters)
 
 
-def write_tag(writer: FileWriter, tag: LMS_EncodedTag | LMS_DecodedTag) -> None:
+def write_tag(writer: FileWriter, tag: LMS_ControlTag) -> None:
     start_indicator, close_indicator = get_tag_indicator(
         writer.encoding, writer.is_big_endian
     )

{pylibms-3.2.4 → pylibms-3.2.6}/lms/message/tag/lms_tag.py

@@ -5,7 +5,7 @@ from lms.message.definitions.field.lms_field import LMS_FieldMap
 from lms.message.tag.lms_tagexceptions import LMS_InvalidTagFormatError
 from lms.titleconfig.definitions.tags import TagConfig, TagDefinition
 
-TAG_PADDING_CHAR = "CD"
+TAG_PADDING_CHAR = 0xCD
 
 
 class LMS_EncodedTag:
@@ -25,7 +25,7 @@ class LMS_EncodedTag:
         self,
         group_id: int,
         tag_index: int,
-        parameters: list[str] | None = None,
+        parameters: list[int] | None = None,
         is_fallback: bool = False,
         is_closing: bool = False,
     ):
@@ -50,13 +50,13 @@ class LMS_EncodedTag:
         return self._tag_index
 
     @property
-    def parameters(self) -> list[str] | None:
-        """The list of hex string parameters."""
+    def parameters(self) -> list[int] | None:
+        """The list of parameters."""
         return self._parameters
 
     @property
     def is_fallback(self) -> bool:
-        """Determines if the tag is a fallback tag."""
+        """Determines if the tag is a fallback tag. Fallback tags have a '!' prefix before the group index."""
         return self._is_fallback
 
     @property
@@ -73,7 +73,8 @@ class LMS_EncodedTag:
         if self._parameters is None:
             return f"[{self.group_id}:{self.tag_index}]"
 
-        parameters = "-".join(self._parameters)
+        # 02x format to convert any int to hexadecimal uppercase
+        parameters = "-".join(format(param, "02x").upper() for param in self._parameters)
         return f"[{fallback_prefix}{self.group_id}:{self.tag_index} {parameters}]"
 
     @classmethod
@@ -103,10 +104,13 @@ class LMS_EncodedTag:
 
         if not cls.PARAMETER_FORMAT.match(param_str):
             raise LMS_InvalidTagFormatError(
-                f"Malformed parameters located in tag: '{tag}'"
+                f"Parameters located in the tag '{tag}'. Ensure all parameters are separated by dashes."
             )
 
-        parameters = [param.strip().upper() for param in param_str.split("-")]
+        try:
+            parameters = [int(param.strip().upper()) for param in param_str.split("-")]
+        except ValueError:
+            raise LMS_InvalidTagFormatError(f"Malformed parameters in tag '{tag}'. Ensure all the parameters are integers.")
 
         # Ensure 0xCD padding is added
         if len(parameters) % 2 == 1:

{pylibms-3.2.4 → pylibms-3.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "PyLibMS"
-version = "3.2.4"
+version = "3.2.6"
 requires-python = ">=3.12"
 description = "Python library built for the libMessageStudio (LMS) proprietary file formats from Nintendo. Supports MSBT, MSBP, and MSBF."
 readme = "README.md"