async-mega-py 2.4.1__tar.gz → 2.5.0__tar.gz

{async_mega_py-2.4.1 → async_mega_py-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: async-mega.py
-Version: 2.4.1
+Version: 2.5.0
 Summary: Python library for the Mega.nz and Transfer.it API
 Keywords: api,downloader,mega,mega.nz,transfer.it
 Author: NTFSvolume
@@ -14,18 +14,18 @@ Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3.15
-Classifier: Programming Language :: Python
-Requires-Dist: aiohttp>=3.11.18
-Requires-Dist: aiolimiter>=1.2.1
-Requires-Dist: pycryptodome>=3.20.0
-Requires-Dist: cyclopts>=4.10.1 ; extra == 'cli'
-Requires-Dist: python-dotenv>=1.2.1 ; extra == 'cli'
+Requires-Dist: aiohttp>=3.14.0
+Requires-Dist: aiolimiter>=1.3.0
+Requires-Dist: pycryptodome>=3.24.0
+Requires-Dist: cyclopts>=5.2.0 ; extra == 'cli'
+Requires-Dist: python-dotenv>=1.2.4 ; extra == 'cli'
 Requires-Python: >=3.11
 Project-URL: Homepage, https://github.com/NTFSvolume/mega.py
 Provides-Extra: cli
@@ -88,7 +88,6 @@ email = "my_email@email.com"
 password = "12345"
 async with MegaNzClient() as mega:
     await mega.login(email, password)
-
 ```
 
 Login should always be the first thing you do. Almost all operations require a valid account. You can call `login` without params to create a temporary account:
@@ -98,9 +97,8 @@ from mega.client import MegaNzClient
 
 # Also works without using it as a context manager, but you have the responsability to close the session at the end
 mega = MegaNzClient()
-await mega.login() # login using a temporary anonymous account
+await mega.login()  # login using a temporary anonymous account
 # await mega.close()
-
 ```
 
 ## Methods
@@ -126,18 +124,20 @@ contact = "test@mega.nz"
 await mega.add_contact(contact)
 await mega.remove_contact(contact)
 
+
 async def view_paths():
     fs = await mega.get_filesystem()
-    print (fs.paths.values())
+    print(fs.paths.values())
+
 
 # Create a folder
-await mega.create_folder('new_folder')
-await mega.create_folder('new_folder/sub_folder/subsub_folder')
+await mega.create_folder("new_folder")
+await mega.create_folder("new_folder/sub_folder/subsub_folder")
 await view_paths()
 
 # Rename a file or a folder
-folder = await mega.find('new_folder/sub_folder/subsub_folder')
-await mega.rename(folder, new_name='my_new_name')
+folder = await mega.find("new_folder/sub_folder/subsub_folder")
+await mega.rename(folder, new_name="my_new_name")
 await view_paths()
 
 # Send this node to the trash bin (still counts towards your quota)
@@ -153,9 +153,9 @@ await view_paths()
 
 ```python
 # Upload a file, and get its public link
-my_real_file = '/home/user/myfile.doc' # Change this to a real file path!
-uploaded_file = await mega.upload(my_real_file) # Upload returns the Node that represents the file you just uploaded
-await mega.export(uploaded_file) # This only works with real accounts. Temp accounts can't create public links
+my_real_file = "/home/user/myfile.doc"  # Change this to a real file path!
+uploaded_file = await mega.upload(my_real_file)  # Upload returns the Node that represents the file you just uploaded
+await mega.export(uploaded_file)  # This only works with real accounts. Temp accounts can't create public links
 
 # Download a file from your account
 output_dir = "my downloads"
@@ -171,7 +171,7 @@ folder_url = "https://mega.nz/folder/CJ8y1SDJ#KX8YfTd526P4o_hDH02jLQ"
 public_handle, public_key, selected_node = mega.parse_folder_url(folder_url)
 results = await mega.download_public_folder(public_handle, public_key, output_dir, selected_node)
 for node_id, result in results.items():
-    print ((node_id, result))
+    print((node_id, result))
 
 # Import a file from URL
 public_handle, public_key = mega.parse_file_url(file_url)
@@ -179,7 +179,7 @@ await mega.import_public_file(public_handle, public_key, dest_node_id=folder.id)
 
 # How do you know if an URL is a file or folder?
 result = mega.parse_url(url)
-print (result.is_folder)
+print(result.is_folder)
 ```
 
 > [!TIP]
@@ -253,8 +253,8 @@ fs = UserFileSystem.from_dump(json.loads(dump))
 # Search for nodes
 query = "tests/script"
 for node_id, path in fs.search(query):
-    print (node_id)
-    print (path)
+    print(node_id)
+    print(path)
 
 # or
 dict(fs.search(query))
@@ -274,12 +274,11 @@ The output will be:
 
 ```python
 # Get the path to a node
-fs.absolute_path("0fPFklV3") # /tests/scripts/notes.txt
+fs.absolute_path("0fPFklV3")  # /tests/scripts/notes.txt
 
 # Find a node by its *exact* path
 result = fs.find("/tests/scripts/notes.txt")
-print (result.id) # "0fPFklV3"
-
+print(result.id)  # "0fPFklV3"
 ```
 
 ```python
@@ -290,7 +289,6 @@ list(fs.deleted)
 folder = fs.find("/tests")
 for node in fs.iterdir(folder.id, recursive=True):
     print(fs.absolute_path(node.id))
-
 ```
 
 Output will be:
@@ -315,7 +313,7 @@ Output will be:
 > If 2 nodes have the same path, `find` will throw an error.
 
 ```python
-fs.find("/tests/logo.png") # This will fail
+fs.find("/tests/logo.png")  # This will fail
 # You will have to call search and choose which one you actually want
 dict(fs.search("/tests/logo.png"))
 ```
@@ -335,7 +333,7 @@ async with TransferItClient() as client:
     fs = await client.get_filesystem(transfer_id)
     output_dir = "My downloads"
     results = await client.download_transfer(transfer_id, output_dir)
-    print (results)
+    print(results)
 ```
 
 ## CLI

{async_mega_py-2.4.1 → async_mega_py-2.5.0}/README.md

@@ -55,7 +55,6 @@ email = "my_email@email.com"
 password = "12345"
 async with MegaNzClient() as mega:
     await mega.login(email, password)
-
 ```
 
 Login should always be the first thing you do. Almost all operations require a valid account. You can call `login` without params to create a temporary account:
@@ -65,9 +64,8 @@ from mega.client import MegaNzClient
 
 # Also works without using it as a context manager, but you have the responsability to close the session at the end
 mega = MegaNzClient()
-await mega.login() # login using a temporary anonymous account
+await mega.login()  # login using a temporary anonymous account
 # await mega.close()
-
 ```
 
 ## Methods
@@ -93,18 +91,20 @@ contact = "test@mega.nz"
 await mega.add_contact(contact)
 await mega.remove_contact(contact)
 
+
 async def view_paths():
     fs = await mega.get_filesystem()
-    print (fs.paths.values())
+    print(fs.paths.values())
+
 
 # Create a folder
-await mega.create_folder('new_folder')
-await mega.create_folder('new_folder/sub_folder/subsub_folder')
+await mega.create_folder("new_folder")
+await mega.create_folder("new_folder/sub_folder/subsub_folder")
 await view_paths()
 
 # Rename a file or a folder
-folder = await mega.find('new_folder/sub_folder/subsub_folder')
-await mega.rename(folder, new_name='my_new_name')
+folder = await mega.find("new_folder/sub_folder/subsub_folder")
+await mega.rename(folder, new_name="my_new_name")
 await view_paths()
 
 # Send this node to the trash bin (still counts towards your quota)
@@ -120,9 +120,9 @@ await view_paths()
 
 ```python
 # Upload a file, and get its public link
-my_real_file = '/home/user/myfile.doc' # Change this to a real file path!
-uploaded_file = await mega.upload(my_real_file) # Upload returns the Node that represents the file you just uploaded
-await mega.export(uploaded_file) # This only works with real accounts. Temp accounts can't create public links
+my_real_file = "/home/user/myfile.doc"  # Change this to a real file path!
+uploaded_file = await mega.upload(my_real_file)  # Upload returns the Node that represents the file you just uploaded
+await mega.export(uploaded_file)  # This only works with real accounts. Temp accounts can't create public links
 
 # Download a file from your account
 output_dir = "my downloads"
@@ -138,7 +138,7 @@ folder_url = "https://mega.nz/folder/CJ8y1SDJ#KX8YfTd526P4o_hDH02jLQ"
 public_handle, public_key, selected_node = mega.parse_folder_url(folder_url)
 results = await mega.download_public_folder(public_handle, public_key, output_dir, selected_node)
 for node_id, result in results.items():
-    print ((node_id, result))
+    print((node_id, result))
 
 # Import a file from URL
 public_handle, public_key = mega.parse_file_url(file_url)
@@ -146,7 +146,7 @@ await mega.import_public_file(public_handle, public_key, dest_node_id=folder.id)
 
 # How do you know if an URL is a file or folder?
 result = mega.parse_url(url)
-print (result.is_folder)
+print(result.is_folder)
 ```
 
 > [!TIP]
@@ -220,8 +220,8 @@ fs = UserFileSystem.from_dump(json.loads(dump))
 # Search for nodes
 query = "tests/script"
 for node_id, path in fs.search(query):
-    print (node_id)
-    print (path)
+    print(node_id)
+    print(path)
 
 # or
 dict(fs.search(query))
@@ -241,12 +241,11 @@ The output will be:
 
 ```python
 # Get the path to a node
-fs.absolute_path("0fPFklV3") # /tests/scripts/notes.txt
+fs.absolute_path("0fPFklV3")  # /tests/scripts/notes.txt
 
 # Find a node by its *exact* path
 result = fs.find("/tests/scripts/notes.txt")
-print (result.id) # "0fPFklV3"
-
+print(result.id)  # "0fPFklV3"
 ```
 
 ```python
@@ -257,7 +256,6 @@ list(fs.deleted)
 folder = fs.find("/tests")
 for node in fs.iterdir(folder.id, recursive=True):
     print(fs.absolute_path(node.id))
-
 ```
 
 Output will be:
@@ -282,7 +280,7 @@ Output will be:
 > If 2 nodes have the same path, `find` will throw an error.
 
 ```python
-fs.find("/tests/logo.png") # This will fail
+fs.find("/tests/logo.png")  # This will fail
 # You will have to call search and choose which one you actually want
 dict(fs.search("/tests/logo.png"))
 ```
@@ -302,7 +300,7 @@ async with TransferItClient() as client:
     fs = await client.get_filesystem(transfer_id)
     output_dir = "My downloads"
     results = await client.download_transfer(transfer_id, output_dir)
-    print (results)
+    print(results)
 ```
 
 ## CLI

async_mega_py-2.5.0/pyproject.toml

@@ -0,0 +1,136 @@
+[project]
+name = "async-mega.py"
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+]
+dependencies = [
+    "aiohttp>=3.14.0",
+    "aiolimiter>=1.3.0",
+    "pycryptodome>=3.24.0",
+]
+description = "Python library for the Mega.nz and Transfer.it API"
+keywords = [
+    "api",
+    "downloader",
+    "mega",
+    "mega.nz",
+    "transfer.it",
+]
+license = "Apache-2.0"
+license-files = ["LICENSE"]
+readme = "README.md"
+requires-python = ">=3.11"
+version = "2.5.0"
+
+[[project.authors]]
+name = "NTFSvolume"
+email = "NTFSvolume@proton.me"
+
+[project.optional-dependencies]
+cli = [
+    "cyclopts>=5.2.0",
+    "python-dotenv>=1.2.4",
+]
+
+[project.scripts]
+async-mega-py = "mega.__main__:app.meta"
+mega-py = "mega.__main__:app.meta"
+
+[project.urls]
+Homepage = "https://github.com/NTFSvolume/mega.py"
+
+[tool.coverage.run]
+omit = ["tests/*"]
+
+[tool.pytest.ini_options]
+addopts = "-s -v"
+asyncio_default_fixture_loop_scope = "function"
+asyncio_mode = "auto"
+minversion = "8.3"
+norecursedirs = [".git"]
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = [
+    "B",
+    "C4",
+    "COM8",
+    "E",
+    "F",
+    "FA102",
+    "FURB188",
+    "I",
+    "N",
+    "PLR1716",
+    "Q",
+    "RUF",
+    "T20",
+    "TC",
+    "TID",
+    "UP",
+    "W",
+]
+extend-safe-fixes = ["TC"]
+ignore = [
+    "COM812",
+    "E501",
+    "N806",
+]
+unfixable = ["ERA"]
+
+[tool.ruff.lint.per-file-ignores]
+"**/{tests,docs}/*" = [
+    "E402",
+    "T20",
+]
+"__init__.py" = ["E402"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.tomlsort]
+all = true
+ignore_case = true
+in_place = true
+sort_first = [
+    "name",
+    "project",
+    "select",
+    "tool",
+]
+spaces_before_inline_comment = 2
+spaces_indent_inline_array = 4
+
+[tool.uv]
+default-groups = "all"
+required-version = ">=0.12.24"
+
+[tool.uv.build-backend]
+module-name = "mega"
+
+[build-system]
+build-backend = "uv_build"
+requires = ["uv_build>=0.12.24,<0.13.0"]
+
+[dependency-groups]
+dev = [
+    "prek>=0.5.5",
+    "pytest-asyncio>=1.4.0",
+    "pytest>=9.1.1",
+    "ruff>=0.16.10,<0.17.0",
+]

async_mega_py-2.4.1/pyproject.toml → async_mega_py-2.5.0/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "async-mega.py"
-authors = [{name = "NTFSvolume", email = "NTFSvolume@proton.me"}]
+authors = [{ name = "NTFSvolume", email = "NTFSvolume@proton.me" }]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Environment :: Console",
@@ -9,18 +9,18 @@ classifiers = [
     "Intended Audience :: End Users/Desktop",
     "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent",
+    "Programming Language :: Python",
     "Programming Language :: Python :: 3 :: Only",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
-    "Programming Language :: Python :: 3.15",
-    "Programming Language :: Python"
+    "Programming Language :: Python :: 3.15"
 ]
 dependencies = [
-    "aiohttp>=3.11.18",
-    "aiolimiter>=1.2.1",
-    "pycryptodome>=3.20.0"
+    "aiohttp>=3.14.0",
+    "aiolimiter>=1.3.0",
+    "pycryptodome>=3.24.0"
 ]
 description = "Python library for the Mega.nz and Transfer.it API"
 keywords = [
@@ -34,12 +34,12 @@ license = "Apache-2.0"
 license-files = ["LICENSE"]
 readme = "README.md"
 requires-python = ">=3.11"
-version = "2.4.1"
+version = "2.5.0"
 
 [project.optional-dependencies]
 cli = [
-    "cyclopts>=4.10.1",
-    "python-dotenv>=1.2.1"
+    "cyclopts>=5.2.0",
+    "python-dotenv>=1.2.4"
 ]
 
 [project.scripts]
@@ -114,17 +114,21 @@ sort_first = ["name", "project", "select", "tool"]
 spaces_before_inline_comment = 2
 spaces_indent_inline_array = 4
 
+[tool.uv]
+default-groups = "all"
+required-version = ">=0.12.24"
+
 [tool.uv.build-backend]
 module-name = "mega"
 
 [build-system]
 build-backend = "uv_build"
-requires = ["uv_build<=0.10.11"]
+requires = ["uv_build>=0.12.24,<0.13.0"]
 
 [dependency-groups]
 dev = [
-    "prek>=0.4.0",
-    "pytest-asyncio>=0.25.0",
-    "pytest>=8.3.5",
-    "ruff==0.15.6"
+    "prek>=0.5.5",
+    "pytest-asyncio>=1.4.0",
+    "pytest>=9.1.1",
+    "ruff>=0.16.10,<0.17.0"
 ]

{async_mega_py-2.4.1 → async_mega_py-2.5.0}/src/mega/__init__.py

@@ -1,4 +1,5 @@
 import importlib.metadata
+import logging
 from contextvars import ContextVar
 
 _package_name_ = "async-mega-py"
@@ -6,3 +7,4 @@ __version__ = importlib.metadata.version(_package_name_)
 
 LOG_FILE_PROGRESS: ContextVar[bool] = ContextVar("LOG_FILE_PROGRESS", default=True)
 LOG_HTTP_TRAFFIC: ContextVar[bool] = ContextVar("LOG_HTTP_TRAFFIC", default=False)
+LOG_HTTP_TRAFFIC_LEVEL: ContextVar[int] = ContextVar("LOG_HTTP_TRAFFIC_LEVEL", default=logging.DEBUG)

{async_mega_py-2.4.1 → async_mega_py-2.5.0}/src/mega/api.py

@@ -14,7 +14,7 @@ import aiohttp
 import yarl
 from aiolimiter import AsyncLimiter
 
-from mega import LOG_HTTP_TRAFFIC, __version__, _package_name_
+from mega import LOG_HTTP_TRAFFIC, LOG_HTTP_TRAFFIC_LEVEL, __version__, _package_name_
 from mega.crypto import generate_hashcash
 from mega.errors import RequestError, RetryRequestError
 from mega.utils import random_id, random_u32int
@@ -161,7 +161,8 @@ class MegaAPI:
         kwargs["headers"] = {"User-Agent": self.user_agent, **(headers or {})}
         request_id = str(uuid.uuid4())
         if LOG_HTTP_TRAFFIC.get():
-            logger.debug(
+            logger.log(
+                LOG_HTTP_TRAFFIC_LEVEL.get(),
                 "Starting %s request [id=%s] to %s \n%s",
                 method,
                 request_id,
@@ -181,7 +182,8 @@ class MegaAPI:
             raise
         finally:
             if resp and LOG_HTTP_TRAFFIC.get():
-                logger.debug(
+                logger.log(
+                    LOG_HTTP_TRAFFIC_LEVEL.get(),
                     "Finished %s request [id=%s]\n%s",
                     method,
                     request_id,