🔖 Bump version to 3.4.4

* docs: document padding behavior

* Improve numeric fields note formatting in templating.md

Updated note formatting for numeric fields in templating documentation.

---------

Co-authored-by: xoconoch <xoconoch@cordovault.com>
Co-authored-by: Oskar Dudziński <56404247+oskvr37@users.noreply.github.com>

docs/templating.md

@@ -47,6 +47,10 @@ Each object type exposes fields you can use inside templates.
 | `item.explicit`              | Explicit content                       | `E`                             | str  |
 | `item.dolby:(Dolby Atmos)`   | Dolby Atmos (track only, `UserFormat`) | `(Dolby Atmos)`                 | str  |
 
+> [!NOTE]
+> Numeric fields `item.number` and `item.volume` can be padded with leading zeros
+> using `:0<width>d` (e.g. `item.number:02d` → `03`, `item.volume:03d` → `001`).
+
 ---
 
 ### `album`

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tiddl"
-version = "3.4.1"
+version = "3.4.4"
 description = "Download Tidal tracks with CLI downloader."
 readme = "README.md"
 requires-python = ">=3.13"

tiddl/cli/app.py

@@ -13,7 +13,7 @@ log = logging.getLogger("tiddl")
 app = typer.Typer(name="tiddl", no_args_is_help=True, rich_markup_mode="rich")
 register_commands(app)
 
-VERSION = "v3.4.1"
+VERSION = "v3.4.4"
 
 
 @app.callback()

tiddl/core/auth/models.py

@@ -23,9 +23,9 @@ class AuthResponse(BaseModel):
         acceptedEULA: bool
         created: int | str
         updated: int | str
-        facebookUid: int
-        appleUid: Optional[str]
-        googleUid: Optional[str]
+        facebookUid: Optional[int] = None
+        appleUid: Optional[str] = None
+        googleUid: Optional[str] = None
         accountLinkCreated: bool
         emailVerified: bool
         newUser: bool

tiddl/core/utils/parse.py

@@ -6,6 +6,8 @@ from xml.etree.ElementTree import fromstring
 
 from tiddl.core.api.models import TrackStream, VideoStream
 
+DOLBY_CODECS = ["eac3", "ac4"]
+
 
 def parse_manifest_XML(xml_content: str):
     """
@@ -80,7 +82,7 @@ def parse_track_stream(track_stream: TrackStream) -> tuple[list[str], str]:
         file_extension = ".flac"
         if track_stream.audioQuality == "HI_RES_LOSSLESS":
             file_extension = ".m4a"
-    elif codecs.startswith("mp4") or codecs == "eac3":
+    elif codecs.startswith("mp4") or codecs in DOLBY_CODECS:
         file_extension = ".m4a"
     else:
         raise ValueError(f"Unknown codecs `{codecs}` (trackId {track_stream.trackId}")