python-rockbox 0.1.0__tar.gz → 0.2.0__tar.gz

{python_rockbox-0.1.0 → python_rockbox-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: python-rockbox
-Version: 0.1.0
+Version: 0.2.0
 Summary: Create and manipulate WPS tags from Python
 Author: Stormy
 Author-email: Stormy <oohstormy@gmail.com>
@@ -14,9 +14,11 @@ Create and manipulate WPS tags from Python
 ### Currently supported:
 * All tags from Rockbox 4.0 (via `Tags` class)
 * Tags (`Tag` class)
+* Rockbox formatted hex color (`Color` class)
 * Conditionals (`Match` class)
+* If statements (`If` class)
 
-## Example
+## Examples
 
 This conditional that displays an appropriate battery bitmap:
 ```py
@@ -43,6 +45,19 @@ Would `__repr__` to:
 %?bp<%xd(A)|%?bl<%xd(B)|%xd(C)|%xd(D)|%xd(E)|%xd(F)>>
 ```
 
+This if statement:
+```py
+wps = If(Tags.VOLUME, ">=", 0, [
+    "Clipping possible",
+    "Volume OK"
+])
+```
+
+Would `__repr__` to:
+```c
+%?if(%pv, >=, 0)<Clipping possible|Volume OK>
+```
+
 ## Install
 
 To install locally, make sure you have the following installed:

{python_rockbox-0.1.0 → python_rockbox-0.2.0}/README.md

@@ -5,9 +5,11 @@ Create and manipulate WPS tags from Python
 ### Currently supported:
 * All tags from Rockbox 4.0 (via `Tags` class)
 * Tags (`Tag` class)
+* Rockbox formatted hex color (`Color` class)
 * Conditionals (`Match` class)
+* If statements (`If` class)
 
-## Example
+## Examples
 
 This conditional that displays an appropriate battery bitmap:
 ```py
@@ -34,6 +36,19 @@ Would `__repr__` to:
 %?bp<%xd(A)|%?bl<%xd(B)|%xd(C)|%xd(D)|%xd(E)|%xd(F)>>
 ```
 
+This if statement:
+```py
+wps = If(Tags.VOLUME, ">=", 0, [
+    "Clipping possible",
+    "Volume OK"
+])
+```
+
+Would `__repr__` to:
+```c
+%?if(%pv, >=, 0)<Clipping possible|Volume OK>
+```
+
 ## Install
 
 To install locally, make sure you have the following installed:

{python_rockbox-0.1.0 → python_rockbox-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-rockbox"
-version = "0.1.0"
+version = "0.2.0"
 description = "Create and manipulate WPS tags from Python"
 readme = "README.md"
 authors = [

python_rockbox-0.2.0/src/python_rockbox/__init__.py

@@ -0,0 +1,4 @@
+from .wps import Tag, Match, Color, If
+from .tags import Tags
+
+__all__: list[str] = ["Tag", "Tags", "Match", "Color", "If"]

{python_rockbox-0.1.0 → python_rockbox-0.2.0}/src/python_rockbox/wps.py

@@ -1,5 +1,7 @@
 from .tags import Tags
 
+VALID_OPERATORS: list[str] = ["=", "!=", ">", ">=", "<", "<="]
+
 
 class Color:
     def __init__(self, color: str) -> None:
@@ -40,13 +42,36 @@ class Tag:
                 self.tag: str = tag
             self.arguments: tuple = args
 
+    @classmethod
+    def parse(cls, tag: str) -> None:
+        """
+        Parses WPS tag string to class representation.
+
+        Ex: `%xd(X)` -> `Tag(Tags.DISPLAY_IMAGE, "X")`
+        """
+        tag_name = tag.removeprefix("%").split("(")[0]
+        try:
+            arguments = tag.split("(")[1].removesuffix(")").split(",")
+            for index, arg in enumerate(arguments):
+                arguments[index] = arguments[index].strip()
+                if arg.isdigit():
+                    arguments[index] = int(arg)
+                if arg == "-":
+                    arguments[index] = None
+            arguments_tuple = tuple(arguments)
+            return cls(tag_name, *arguments_tuple)
+        except IndexError:
+            return cls(tag_name)
+
     def render_simple_tag(self) -> str:
         """Renders a tag with no arguments"""
         return f"%{self.tag}"
 
     def render_argument_tag(self) -> str:
         """Renders a tag that has arguments"""
-        rendered_args = ", ".join(map(str, self.arguments))
+        rendered_args = ", ".join(
+            "-" if arg is None else str(arg) for arg in self.arguments
+        )
         return f"%{self.tag}({rendered_args})"
 
     def __repr__(self) -> str:
@@ -58,7 +83,7 @@ class Tag:
 
 class Match:
     def __init__(
-        self, tag: Tag | Tags | str, cases: list[Tag | Match]
+        self, tag: Tag | Tags | str, cases: list[Tag | Match | tuple[Tag]]
     ) -> None:
         """Class representation of Rockbox WPS conditional"""
         if isinstance(tag, Tags):
@@ -75,3 +100,26 @@ class Match:
 
     def __repr__(self) -> str:
         return self._render_match()
+
+
+class If:
+    def __init__(
+        self, tag: Tag | str, operator: str, operand: str | int, cases: list[str | int]
+    ):
+        self.tag = Tag(tag)
+        self.operator: str = self._verify_operator(operator)
+        self.operand: str = operand
+        self.cases: list[str | int] = cases
+
+    @staticmethod
+    def _verify_operator(operator: str) -> str:
+        if operator not in VALID_OPERATORS:
+            raise ValueError(f"Invalid operator: {operator}")
+        return operator
+
+    def _render_if(self) -> str:
+        statement: list = [self.tag, self.operator, self.operand]
+        return f"%?if({", ".join(map(str, statement))})<{"|".join(self.cases)}>"
+
+    def __repr__(self) -> str:
+        return self._render_if()

python_rockbox-0.1.0/src/python_rockbox/__init__.py

@@ -1,4 +0,0 @@
-from .wps import Tag, Match, Color
-from .tags import Tags
-
-__all__ = ["Tag", "Tags", "Match", "Color"]