mfget 0.1.1__tar.gz

mfget-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mediafire-DL contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mfget-0.1.1/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: mfget
+Version: 0.1.1
+Summary: A clean MediaFire file and folder downloader with a Rich-powered CLI.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/worstgirlinamerica/mediafire-dl
+Project-URL: Repository, https://github.com/worstgirlinamerica/mediafire-dl
+Project-URL: Issues, https://github.com/worstgirlinamerica/mediafire-dl/issues
+Keywords: mediafire,downloader,cli,rich
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.7.0
+Dynamic: license-file
+
+# Mediafire-DL
+
+Mediafire-DL is a small command-line downloader for MediaFire links.
+
+It handles single files and folders, keeps nested folder structure intact, and shows a clean progress display while it downloads. Public links work without any login details. Links that require an account can be tried with an optional local cookies file.
+
+## What It Does
+
+- Downloads public MediaFire file links
+- Downloads public MediaFire folder links
+- Walks nested folders automatically
+- Saves folders using the same folder layout MediaFire reports
+- Shows a file preview before downloading
+- Supports a dry-run mode so you can check what would be saved first
+- Defaults to your system `Downloads` folder
+- Can read a local `cookies.txt` file for links your own browser account can access
+
+## Install
+
+You need Python 3.9 or newer.
+
+### From GitHub
+
+This works without cloning the repo first:
+
+```bash
+python3 -m pip install --user git+https://github.com/worstgirlinamerica/mediafire-dl.git
+```
+
+Then run:
+
+```bash
+mediafire-dl
+```
+
+On Windows, use `py` instead of `python3`:
+
+```powershell
+py -m pip install --user git+https://github.com/worstgirlinamerica/mediafire-dl.git
+```
+
+### From PyPI
+
+Once Mediafire-DL is published to PyPI as `mfget`, it can be installed like this:
+
+```bash
+python3 -m pip install --user mfget
+```
+
+On Windows:
+
+```powershell
+py -m pip install --user mfget
+```
+
+### macOS
+
+If you installed with Python 3:
+
+```bash
+mediafire-dl
+```
+
+If your terminal says `mediafire-dl` was not found, use the module form:
+
+```bash
+python3 -m mediafire_dl
+```
+
+If the command is installed but your shell cannot find it, add Python's user script folder to your PATH. The version number may be different on your machine:
+
+```bash
+echo 'export PATH="$HOME/Library/Python/3.12/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+### Windows
+
+Run:
+
+```powershell
+mediafire-dl
+```
+
+If PowerShell says `mediafire-dl` was not found, use:
+
+```powershell
+py -m mediafire_dl
+```
+
+If you want the `mediafire-dl` command to work directly, add Python's user Scripts folder to PATH. It usually looks like this, with the Python version adjusted for your install:
+
+```text
+%APPDATA%\Python\Python312\Scripts
+```
+
+### Linux
+
+Run:
+
+```bash
+mediafire-dl
+```
+
+If your shell says `mediafire-dl` was not found, use:
+
+```bash
+python3 -m mediafire_dl
+```
+
+Or add Python's user script folder to your PATH:
+
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### Local Development
+
+If you cloned the repo and want to install from the project folder:
+
+```bash
+python3 -m pip install --user .
+```
+
+## Usage
+
+Run the command and paste a MediaFire link when it asks:
+
+```bash
+mediafire-dl
+```
+
+Or pass the link directly:
+
+```bash
+mediafire-dl "https://www.mediafire.com/file/example/file.zip/file"
+```
+
+Choose a save folder:
+
+```bash
+mediafire-dl "https://www.mediafire.com/folder/example/My+Folder" --output ~/Downloads/MediaFire
+```
+
+Preview a folder without downloading anything:
+
+```bash
+mediafire-dl --dry-run "https://www.mediafire.com/folder/example/My+Folder"
+```
+
+Show more technical error details:
+
+```bash
+mediafire-dl --verbose "https://www.mediafire.com/file/example/file.zip/file"
+```
+
+Use a local cookies file for a link that your browser account can already access:
+
+```bash
+mediafire-dl --cookies ~/Downloads/cookies.txt "https://www.mediafire.com/file/example/file.zip/file"
+```
+
+The cookies file must be in Netscape/Mozilla `cookies.txt` format. Mediafire-DL only reads the file from your computer for that run.
+
+## Supported Links
+
+Supported:
+
+- Public MediaFire file links
+- Public MediaFire folder links
+- Public folders with nested subfolders
+- MediaFire file or folder links that work with a user-provided `cookies.txt` file
+
+Not supported:
+
+- Asking for or storing MediaFire usernames and passwords
+- Automatically reading cookies from your browser
+- Password-protected downloads that require an extra password prompt
+- Captcha-gated or blocked downloads
+
+## Privacy And Safety
+
+Mediafire-DL does not ask for MediaFire login details and does not read browser cookies automatically. If you use `--cookies`, the cookie file stays on your machine and is only read by the current command.
+
+This repo already ignores common private and generated files in `.gitignore`, including `.env`, cookies, logs, caches, virtual environments, `.DS_Store`, partial downloads, and local media/download folders.
+
+## Development
+
+For an editable install while working on the code:
+
+```bash
+python3 -m pip install --user -e .
+```
+
+Run the CLI from source:
+
+```bash
+python3 -m mediafire_dl
+```
+
+The package entry point is:
+
+```bash
+mediafire-dl
+```
+
+## License
+
+MIT License. See [LICENSE](LICENSE).

mfget-0.1.1/README.md

@@ -0,0 +1,210 @@
+# Mediafire-DL
+
+Mediafire-DL is a small command-line downloader for MediaFire links.
+
+It handles single files and folders, keeps nested folder structure intact, and shows a clean progress display while it downloads. Public links work without any login details. Links that require an account can be tried with an optional local cookies file.
+
+## What It Does
+
+- Downloads public MediaFire file links
+- Downloads public MediaFire folder links
+- Walks nested folders automatically
+- Saves folders using the same folder layout MediaFire reports
+- Shows a file preview before downloading
+- Supports a dry-run mode so you can check what would be saved first
+- Defaults to your system `Downloads` folder
+- Can read a local `cookies.txt` file for links your own browser account can access
+
+## Install
+
+You need Python 3.9 or newer.
+
+### From GitHub
+
+This works without cloning the repo first:
+
+```bash
+python3 -m pip install --user git+https://github.com/worstgirlinamerica/mediafire-dl.git
+```
+
+Then run:
+
+```bash
+mediafire-dl
+```
+
+On Windows, use `py` instead of `python3`:
+
+```powershell
+py -m pip install --user git+https://github.com/worstgirlinamerica/mediafire-dl.git
+```
+
+### From PyPI
+
+Once Mediafire-DL is published to PyPI as `mfget`, it can be installed like this:
+
+```bash
+python3 -m pip install --user mfget
+```
+
+On Windows:
+
+```powershell
+py -m pip install --user mfget
+```
+
+### macOS
+
+If you installed with Python 3:
+
+```bash
+mediafire-dl
+```
+
+If your terminal says `mediafire-dl` was not found, use the module form:
+
+```bash
+python3 -m mediafire_dl
+```
+
+If the command is installed but your shell cannot find it, add Python's user script folder to your PATH. The version number may be different on your machine:
+
+```bash
+echo 'export PATH="$HOME/Library/Python/3.12/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+### Windows
+
+Run:
+
+```powershell
+mediafire-dl
+```
+
+If PowerShell says `mediafire-dl` was not found, use:
+
+```powershell
+py -m mediafire_dl
+```
+
+If you want the `mediafire-dl` command to work directly, add Python's user Scripts folder to PATH. It usually looks like this, with the Python version adjusted for your install:
+
+```text
+%APPDATA%\Python\Python312\Scripts
+```
+
+### Linux
+
+Run:
+
+```bash
+mediafire-dl
+```
+
+If your shell says `mediafire-dl` was not found, use:
+
+```bash
+python3 -m mediafire_dl
+```
+
+Or add Python's user script folder to your PATH:
+
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### Local Development
+
+If you cloned the repo and want to install from the project folder:
+
+```bash
+python3 -m pip install --user .
+```
+
+## Usage
+
+Run the command and paste a MediaFire link when it asks:
+
+```bash
+mediafire-dl
+```
+
+Or pass the link directly:
+
+```bash
+mediafire-dl "https://www.mediafire.com/file/example/file.zip/file"
+```
+
+Choose a save folder:
+
+```bash
+mediafire-dl "https://www.mediafire.com/folder/example/My+Folder" --output ~/Downloads/MediaFire
+```
+
+Preview a folder without downloading anything:
+
+```bash
+mediafire-dl --dry-run "https://www.mediafire.com/folder/example/My+Folder"
+```
+
+Show more technical error details:
+
+```bash
+mediafire-dl --verbose "https://www.mediafire.com/file/example/file.zip/file"
+```
+
+Use a local cookies file for a link that your browser account can already access:
+
+```bash
+mediafire-dl --cookies ~/Downloads/cookies.txt "https://www.mediafire.com/file/example/file.zip/file"
+```
+
+The cookies file must be in Netscape/Mozilla `cookies.txt` format. Mediafire-DL only reads the file from your computer for that run.
+
+## Supported Links
+
+Supported:
+
+- Public MediaFire file links
+- Public MediaFire folder links
+- Public folders with nested subfolders
+- MediaFire file or folder links that work with a user-provided `cookies.txt` file
+
+Not supported:
+
+- Asking for or storing MediaFire usernames and passwords
+- Automatically reading cookies from your browser
+- Password-protected downloads that require an extra password prompt
+- Captcha-gated or blocked downloads
+
+## Privacy And Safety
+
+Mediafire-DL does not ask for MediaFire login details and does not read browser cookies automatically. If you use `--cookies`, the cookie file stays on your machine and is only read by the current command.
+
+This repo already ignores common private and generated files in `.gitignore`, including `.env`, cookies, logs, caches, virtual environments, `.DS_Store`, partial downloads, and local media/download folders.
+
+## Development
+
+For an editable install while working on the code:
+
+```bash
+python3 -m pip install --user -e .
+```
+
+Run the CLI from source:
+
+```bash
+python3 -m mediafire_dl
+```
+
+The package entry point is:
+
+```bash
+mediafire-dl
+```
+
+## License
+
+MIT License. See [LICENSE](LICENSE).

mfget-0.1.1/mediafire_dl/__init__.py

@@ -0,0 +1,3 @@
+"""Mediafire-DL package."""
+
+__version__ = "0.1.0"

mfget-0.1.1/mediafire_dl/__main__.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+import sys
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    sys.exit(main())

mfget-0.1.1/mediafire_dl/cli.py

@@ -0,0 +1,112 @@
+from __future__ import annotations
+
+import argparse
+import logging
+import sys
+from pathlib import Path
+
+from rich.console import Console
+
+from .downloader import Downloader
+from .errors import MediafireDLError
+from .http import HttpClient
+from .mediafire import MediafireClient
+from .output import RichUI
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = parse_args(argv)
+    configure_logging(args.verbose)
+
+    ui = RichUI(Console())
+    link = args.link or ui.ask_link()
+    if not link.strip():
+        ui.error("Please paste a MediaFire file or folder link.")
+        return 1
+    destination = Path(args.output or ui.ask_save_dir(str(default_downloads_dir()))).expanduser()
+
+    try:
+        cookie_file = Path(args.cookies).expanduser() if args.cookies else None
+        http = HttpClient(cookie_file=cookie_file)
+        client = MediafireClient(http)
+        downloader = Downloader(http)
+
+        ui.status("Finding files...")
+        plan = client.build_plan(link)
+        if not plan.files:
+            ui.warning("No downloadable files were found.")
+            return 1
+
+        ui.show_plan(plan)
+        ui.status("Preparing downloads...")
+
+        if args.dry_run:
+            ui.warning("Dry run: nothing was downloaded.")
+            return 0
+
+        ui.status("Downloading...")
+        saved_to = downloader.download_plan(plan, destination, ui)
+        ui.finished(str(saved_to))
+        return 0
+    except KeyboardInterrupt:
+        ui.error("Download cancelled.")
+        return 130
+    except MediafireDLError as exc:
+        if args.verbose:
+            logging.getLogger(__name__).exception("Mediafire-DL failed")
+        ui.error(str(exc))
+        return 1
+    except Exception as exc:
+        if args.verbose:
+            logging.getLogger(__name__).exception("Unexpected failure")
+            ui.error(str(exc))
+        else:
+            ui.error("Something went wrong. Run again with --verbose for details.")
+        return 1
+
+
+def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        prog="mediafire-dl",
+        description="Download MediaFire files and folders with a clean progress UI.",
+    )
+    parser.add_argument("link", nargs="?", help="MediaFire file or folder link")
+    parser.add_argument(
+        "-o",
+        "--output",
+        help="Folder to save downloads into. Defaults to your Downloads folder.",
+    )
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="List files without downloading them.",
+    )
+    parser.add_argument(
+        "--cookies",
+        help=(
+            "Path to a Netscape/Mozilla cookies.txt file to use for links your browser can access. "
+            "Cookies are read locally and are not saved by Mediafire-DL."
+        ),
+    )
+    parser.add_argument(
+        "--verbose",
+        action="store_true",
+        help="Show technical logs and tracebacks for troubleshooting.",
+    )
+    return parser.parse_args(argv)
+
+
+def configure_logging(verbose: bool) -> None:
+    logging.basicConfig(
+        level=logging.DEBUG if verbose else logging.CRITICAL,
+        format="%(levelname)s: %(name)s: %(message)s",
+    )
+
+
+def default_downloads_dir() -> Path:
+    downloads = Path.home() / "Downloads"
+    return downloads if downloads.exists() else Path.home()
+
+
+if __name__ == "__main__":
+    sys.exit(main())

mfget-0.1.1/mediafire_dl/downloader.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+from .errors import DownloadLinkError, MediafireDLError
+from .http import HttpClient
+from .mediafire import safe_name
+from .models import DownloadPlan, MediafireItem
+from .output import UserInterface
+
+LOGGER = logging.getLogger(__name__)
+
+
+class Downloader:
+    def __init__(self, http: HttpClient | None = None, chunk_size: int = 1024 * 128) -> None:
+        self.http = http or HttpClient()
+        self.chunk_size = chunk_size
+
+    def download_plan(self, plan: DownloadPlan, destination: Path, ui: UserInterface) -> Path:
+        root = destination / safe_name(plan.display_name) if plan.is_folder else destination
+        root.mkdir(parents=True, exist_ok=True)
+
+        total = len(plan.files)
+        for index, item in enumerate(plan.files, start=1):
+            self._download_item(item, root, ui, index, total)
+        return root
+
+    def _download_item(
+        self,
+        item: MediafireItem,
+        root: Path,
+        ui: UserInterface,
+        index: int,
+        total: int,
+    ) -> None:
+        target = root / Path(*item.relative_folder.parts) / safe_name(item.name)
+        target.parent.mkdir(parents=True, exist_ok=True)
+        partial = target.with_name(f"{target.name}.part")
+
+        try:
+            direct_url = self.http.find_public_download_url(item.page_url)
+        except MediafireDLError:
+            raise
+        except Exception as exc:
+            LOGGER.debug("Unexpected error while finding download URL", exc_info=exc)
+            raise DownloadLinkError(f"Could not prepare {item.name} for download.") from exc
+
+        with self.http.open_download(direct_url) as response:
+            length = response.headers.get("Content-Length")
+            total_size = int(length) if length and length.isdigit() else item.size
+            progress = ui.start_file(index, total, item, total_size)
+            with partial.open("wb") as file:
+                while True:
+                    chunk = response.read(self.chunk_size)
+                    if not chunk:
+                        break
+                    file.write(chunk)
+                    progress.update(len(chunk))
+            progress.finish()
+        partial.replace(target)

mfget-0.1.1/mediafire_dl/errors.py

@@ -0,0 +1,18 @@
+class MediafireDLError(Exception):
+    """Base exception for user-facing downloader errors."""
+
+
+class UnsupportedLinkError(MediafireDLError):
+    """Raised when a link is not a supported MediaFire file or folder URL."""
+
+
+class MediafireAPIError(MediafireDLError):
+    """Raised when MediaFire's public API returns an error."""
+
+
+class DownloadLinkError(MediafireDLError):
+    """Raised when a public download URL cannot be extracted."""
+
+
+class CookieFileError(MediafireDLError):
+    """Raised when a user-provided cookie file cannot be loaded."""