async-mega-py 2.2.2__tar.gz → 2.3.0__tar.gz

{async_mega_py-2.2.2 → async_mega_py-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: async-mega.py
-Version: 2.2.2
+Version: 2.3.0
 Summary: Python library for the Mega.nz and Transfer.it API
 Keywords: api,downloader,mega,mega.nz,transfer.it
 Author: NTFSvolume

{async_mega_py-2.2.2 → async_mega_py-2.3.0}/pyproject.toml

@@ -34,7 +34,7 @@ license = "Apache-2.0"
 license-files = ["LICENSE"]
 readme = "README.md"
 requires-python = ">=3.11"
-version = "2.2.2"
+version = "2.3.0"
 
 [project.optional-dependencies]
 cli = [

{async_mega_py-2.2.2 → async_mega_py-2.3.0}/src/mega/__main__.py

@@ -100,8 +100,8 @@ async def dump(output_dir: Path = CWD) -> None:
         fs = await mega.get_filesystem()
         out = output_dir / "filesystem.json"
         out.parent.mkdir(exist_ok=True)
-        logger.info(f"Creating filesystem dump at '{out!s}'")
         out.write_text(json.dumps(fs.dump(), indent=2, ensure_ascii=False))
+        logger.info(f"Created filesystem dump at '{out!s}'")
 
 
 @app.command()

{async_mega_py-2.2.2 → async_mega_py-2.3.0}/src/mega/client.py

@@ -192,7 +192,7 @@ class MegaNzClient(APIContextManager[MegaAPI]):
         full_key = b64_to_a32(public_key)
         crypto = Crypto.decompose(full_key)
         file_info = await self._core.request_file_info(public_handle, is_public=True)
-        output_name = self._core.decrypt_attrs(file_info._at, crypto.key).name
+        output_name = self._core.decrypt_attrs(file_info._at, crypto.key, public_handle).name
         output_path = Path(output_dir or ".") / output_name
         return await self._core.download_file(file_info, crypto, output_path)
 
@@ -277,7 +277,7 @@ class MegaNzClient(APIContextManager[MegaAPI]):
         full_key = b64_to_a32(public_key)
         key = Crypto.decompose(full_key).key
         file_info = await self._core.request_file_info(public_handle, is_public=True)
-        name = self._core.decrypt_attrs(file_info._at, key).name
+        name = self._core.decrypt_attrs(file_info._at, key, public_handle).name
         return dataclasses.replace(file_info, name=name)
 
     async def import_public_file(

{async_mega_py-2.2.2 → async_mega_py-2.3.0}/src/mega/core.py

@@ -6,7 +6,7 @@ import logging
 import random
 import re
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, NamedTuple
+from typing import TYPE_CHECKING, Any, NamedTuple, final
 
 import yarl
 from Crypto.Cipher import AES
@@ -23,6 +23,7 @@ from mega.crypto import (
     encrypt_key,
 )
 from mega.data_structures import (
+    _EMPTY_ATTRS,
     AccountStatsSerialized,
     Attributes,
     Crypto,
@@ -62,6 +63,7 @@ class PublicURLInfo(NamedTuple):
         return self.selected_folder or self.selected_file
 
 
+@final
 @dataclasses.dataclass(slots=True)
 class MegaCore:
     api: MegaAPI
@@ -226,7 +228,7 @@ class MegaCore:
         if node.type in (NodeType.FILE, NodeType.FOLDER):
             full_key, share_key = self.vault[node]
             crypto = Crypto.decompose(full_key, node.type, share_key)
-            attributes = self.decrypt_attrs(node._a, crypto.key)
+            attributes = self.decrypt_attrs(node._a, crypto.key, node.id)
 
         else:
             name = {
@@ -402,9 +404,16 @@ class MegaCore:
         self.clear_cache()
 
     @staticmethod
-    def decrypt_attrs(attrs: str, key: tuple[int, ...]) -> Attributes:
+    def _decrypt_attrs(attrs: str, key: tuple[int, ...]) -> Attributes:
         return Attributes.parse(decrypt_attr(b64_url_decode(attrs), key))
 
+    @classmethod
+    def decrypt_attrs(cls, attrs: str, key: tuple[int, ...], node_id: NodeID) -> Attributes:
+        attributes = cls._decrypt_attrs(attrs, key)
+        if attributes is _EMPTY_ATTRS:
+            logger.warning("Unable to decrypt attributes of node %s", node_id)
+        return attributes
+
     async def import_file(
         self,
         public_handle: NodeID,
@@ -415,7 +424,7 @@ class MegaCore:
         full_key = b64_to_a32(public_key)
         key = Crypto.decompose(full_key).key
         file_info = await self.request_file_info(public_handle, is_public=True)
-        name = self.decrypt_attrs(file_info._at, key).name
+        name = self.decrypt_attrs(file_info._at, key, public_handle).name
         encrypted_key = a32_to_base64(encrypt_key(full_key, self.vault.master_key))
         attributes = b64_url_encode(encrypt_attr({"n": name}, key))
 

{async_mega_py-2.2.2 → async_mega_py-2.3.0}/src/mega/data_structures.py

@@ -27,6 +27,10 @@ TimeStamp: TypeAlias = int
 
 SharedKeys: TypeAlias = dict[NodeID, tuple[int, ...]]
 
+NodeKey = tuple[int, int, int, int]
+ComposedFileKey = tuple[int, int, int, int, int, int, int, int]
+ComposedFolderKey = tuple[int, int, int, int]
+
 
 class ByteSize(int):
     def human_readable(self) -> str:
@@ -67,7 +71,7 @@ class NodeSerialized(TypedDict):
     h: NodeID  # ID
     p: NodeID  # Parent ID
     u: NotRequired[UserID]  # Owner (user ID), not present in transfer.it nodes
-    t: ReadOnly[Literal[0, 1, 2, 3, 4, 5]]  # Node type
+    t: ReadOnly[Literal[0, 1, 2, 3, 4]]  # Node type
     a: str  # Serialized attributes
     ts: TimeStamp  # creation date
 
@@ -174,23 +178,23 @@ class FileInfo(_DictDumper):
 
 @dataclasses.dataclass(slots=True, frozen=True)
 class Crypto(_DictDumper):
-    key: tuple[int, int, int, int]
+    key: NodeKey
     iv: tuple[int, int]
     meta_mac: tuple[int, int]
 
-    full_key: tuple[int, int, int, int, int, int, int, int]
-    share_key: tuple[int, ...] | None
+    full_key: ComposedFileKey | ComposedFolderKey
+    share_key: NodeKey | None
 
     @classmethod
     def compose(
         cls,
-        key: tuple[int, ...],
-        iv: tuple[int, ...],
-        meta_mac: tuple[int, ...],
+        key: NodeKey,
+        iv: tuple[int, int],
+        meta_mac: tuple[int, int],
         node_type: NodeType = NodeType.FILE,
     ) -> Crypto:
         if node_type is NodeType.FILE:
-            full_key = (
+            composed_key = (
                 key[0] ^ iv[0],
                 key[1] ^ iv[1],
                 key[2] ^ meta_mac[0],
@@ -198,30 +202,47 @@ class Crypto(_DictDumper):
                 *iv,
                 *meta_mac,
             )
+            if len(composed_key) != 8:
+                raise RuntimeError(f"Invalid key, expected key len for files is 8, got {len(composed_key) = }")
+
         else:
-            full_key = *key, *iv, *meta_mac
+            if len(key) != 4:
+                raise RuntimeError(f"Invalid key, expected key len for folders is 4, got {len(key) = }")
+
+            iv = ()
+            meta_mac = ()
+            composed_key = key
 
-        return Crypto(key, iv, meta_mac, full_key, None)  # pyright: ignore[reportArgumentType]
+        return Crypto(key, iv, meta_mac, composed_key, None)  # pyright: ignore[reportArgumentType]
 
     @classmethod
     def decompose(
         cls,
-        full_key: tuple[int, ...],
+        composed_key: ComposedFileKey | ComposedFolderKey,
         node_type: NodeType = NodeType.FILE,
-        share_key: tuple[int, ...] | None = None,
+        share_key: NodeKey | None = None,
     ) -> Crypto:
-        iv = full_key[4:6]
-        meta_mac = full_key[6:8]
-        key = full_key
+
+        key = composed_key[:4]
+        iv = composed_key[4:6]
+        meta_mac = composed_key[6:8]
         if node_type is NodeType.FILE:
+            if len(composed_key) != 8:
+                raise RuntimeError(f"Invalid key, expected key len for files is 8, got {len(composed_key) = }")
+
             key = (
                 key[0] ^ iv[0],
                 key[1] ^ iv[1],
                 key[2] ^ meta_mac[0],
                 key[3] ^ meta_mac[1],
             )
+            assert iv
+            assert meta_mac
+        else:
+            if len(composed_key) != 4:
+                raise RuntimeError(f"Invalid key, expected key len for folders is 4, got {len(composed_key) = }")
 
-        return Crypto(key, iv, meta_mac, full_key, share_key)  # pyright: ignore[reportArgumentType]
+        return Crypto(key, iv, meta_mac, composed_key, share_key)  # pyright: ignore[reportArgumentType]
 
     @classmethod
     def from_dump(cls, dump: dict[str, Any]) -> Self:
@@ -318,6 +339,8 @@ class Attributes(_DictDumper):
 
     @classmethod
     def parse(cls, attrs: AttributesSerialized) -> Self:
+        if not attrs:
+            return _EMPTY_ATTRS
         return cls(
             name=attrs.get("n", ""),
             label=_LABELS[attrs.get("lbl", 0)],
@@ -336,6 +359,9 @@ class Attributes(_DictDumper):
         }
 
 
+_EMPTY_ATTRS = Attributes("")
+
+
 @dataclasses.dataclass(slots=True, frozen=True)
 class AccountBalance(_DictDumper):
     amount: float
@@ -377,6 +403,7 @@ class AccountStatsSerialized(TypedDict):
     mxfer: NotRequired[int]  # maximum transfer allowance
     srvratio: float  # Ratio of PRO transfer quota that is able to be served to others
     suntil: NotRequired[TimeStamp]  # Expiration time of the currently active plan
+    rtt: NotRequired[int]  # ???
 
 
 @dataclasses.dataclass(slots=True, frozen=True)
@@ -395,10 +422,13 @@ class StorageMetrics(_DictDumper):
 class StorageQuota(_DictDumper):
     used: ByteSize
     max: ByteSize
-
-    percent: int
     threshold: int
 
+    percent: int = dataclasses.field(init=False)
+
+    def __post_init__(self) -> None:
+        object.__setattr__(self, "percent", round(self.ratio * 100))
+
     @property
     def ratio(self) -> float:
         return self.used / self.max
@@ -418,7 +448,6 @@ class StorageQuota(_DictDumper):
         return cls(
             used=used,
             max=max,
-            percent=int(used / max * 100),
             threshold=threshold // 100,
         )
 
@@ -451,6 +480,7 @@ class AccountStats(_DictParser, _DictDumper):
     @classmethod
     def parse(cls, data: AccountStatsSerialized) -> Self:  # pyright: ignore[reportIncompatibleMethodOverride]
         transfer = None
+
         if max_transfer := data.get("mxfer"):
             assert "caxfer" in data
             assert "csxfer" in data

{async_mega_py-2.2.2 → async_mega_py-2.3.0}/src/mega/vault.py

@@ -1,12 +1,20 @@
 from __future__ import annotations
 
 import dataclasses
-from typing import TYPE_CHECKING, Final
+from typing import TYPE_CHECKING, Final, cast
 
 from mega.crypto import b64_to_a32, decrypt_key
 
 if TYPE_CHECKING:
-    from mega.data_structures import GetNodesResponse, Node, NodeID, SharedKeys, UserID
+    from mega.data_structures import (
+        ComposedFileKey,
+        ComposedFolderKey,
+        GetNodesResponse,
+        Node,
+        NodeID,
+        SharedKeys,
+        UserID,
+    )
 
 
 _EXPORTED: Final = "EXP"
@@ -35,7 +43,7 @@ class MegaVault:
             if key := new_keys.get(node_id):
                 self._shared_keys.setdefault(owner, {})[node_id] = key
 
-    def __getitem__(self, node: Node) -> tuple[tuple[int, ...], tuple[int, ...] | None]:
+    def __getitem__(self, node: Node) -> tuple[ComposedFileKey | ComposedFolderKey, tuple[int, ...] | None]:
         share_key: tuple[int, ...] | None = None
 
         # my files/folders
@@ -63,7 +71,10 @@ class MegaVault:
         else:
             raise RuntimeError(f"We do not have keys for {node = }")
 
-        return full_key, share_key
+        if len(full_key) not in (4, 8):
+            raise RuntimeError(f"Invalid key len found for node {node.id} ({len(full_key)})")
+
+        return cast("ComposedFileKey | ComposedFolderKey", full_key), share_key
 
     def save_public_key(self, node_id: NodeID, share_key: tuple[int, ...]) -> None:
         self._shared_keys[_EXPORTED][node_id] = share_key