turbodl


Nameturbodl JSON
Version 0.3.5 PyPI version JSON
download
home_pageNone
SummaryTurboDL is an extremely smart, fast, and efficient download manager with several automations.
upload_time2025-02-06 00:12:25
maintainerhenrique-coder
docs_urlNone
authorhenrique-coder
requires_python<4.0,>=3.10
licenseMIT
keywords dl downloader manager python smart turbodl
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ## TurboDL

![PyPI - Version](https://img.shields.io/pypi/v/turbodl?style=flat&logo=pypi&logoColor=blue&color=blue&link=https://pypi.org/project/turbodl)
![PyPI - Downloads](https://img.shields.io/pypi/dm/turbodl?style=flat&logo=pypi&logoColor=blue&color=blue&link=https://pypi.org/project/turbodl)
![PyPI - Code Style](https://img.shields.io/badge/code%20style-ruff-blue?style=flat&logo=ruff&logoColor=blue&color=blue&link=https://github.com/astral-sh/ruff)
![PyPI - Format](https://img.shields.io/pypi/format/turbodl?style=flat&logo=pypi&logoColor=blue&color=blue&link=https://pypi.org/project/turbodl)
![PyPI - Python Compatible Versions](https://img.shields.io/pypi/pyversions/turbodl?style=flat&logo=python&logoColor=blue&color=blue&link=https://pypi.org/project/turbodl)

TurboDL is an extremely smart, fast, and efficient download manager with several automations.

- Built-in sophisticated download acceleration technique.
- Uses a sophisticated algorithm to calculate the optimal number of connections based on file size and connection speed.
- Retry failed requests efficiently.
- Automatically detects file information before download.
- Automatically handles redirects.
- Automatically uses RAM buffer to speed up downloads and reduce disk I/O overhead.
- Supports post-download hash verification.
- Accurately displays a beautiful progress bar.

<br>

#### Installation (from [PyPI](https://pypi.org/project/turbodl))

```bash
pip install --upgrade turbodl  # Install the latest version of TurboDL
```

### Example Usage

#### Inside a Python script (Basic Usage)

```python
from turbodl import TurboDL


turbodl = TurboDL()
turbodl.download(
    url="https://example.com/file.txt",  # Your download URL
    output_path="path/to/file"  # The file/path to save the downloaded file to or leave it empty to save it to the current working directory
)

turbodl.output_path  # The absolute path to the downloaded file

```

#### Inside a Python script (Advanced Usage)

```python
from turbodl import TurboDL


turbodl = TurboDL(
    max_connections="auto",
    connection_speed_mbps=80,
    show_progress_bar=True,
    save_log_file=False,
)
turbodl.download(
    url="https://example.com/file.txt",
    output_path="path/to/file",
    pre_allocate_space=False,
    use_ram_buffer="auto",
    overwrite=True,
    headers=None,
    timeout=None
    expected_hash=None,
    hash_type="md5",
)

turbodl.output_path  # The absolute path to the downloaded file

```

#### From the command line

```bash
turbodl --help  # Show help for all commands
turbodl download --help  # Show help for the download command

turbodl download [...] https://example.com/file.txt path/to/file  # Download the file
```

##### CLI Demo

[![TurboDL CLI Demo](assets/demo.gif)](https://asciinema.org/a/4qO7o9RFMnGJuJmg46gldBFik)

### Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

If you have a suggestion that would make this better, fork the repository and create a pull request. You can also simply open an issue and describe your ideas or report bugs. **Don't forget to give the project a star if you like it!**

<br>

<a href="https://github.com/henrique-coder/turbodl/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=henrique-coder/turbodl" />
</a>


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "turbodl",
    "maintainer": "henrique-coder",
    "docs_url": null,
    "requires_python": "<4.0,>=3.10",
    "maintainer_email": "hjyz6rqyb@mozmail.com",
    "keywords": "dl, downloader, manager, python, smart, turbodl",
    "author": "henrique-coder",
    "author_email": "hjyz6rqyb@mozmail.com",
    "download_url": "https://files.pythonhosted.org/packages/25/52/32cd01603a83f3a971cf013c509c1beb0bfc94325fc3421e4da65102dc66/turbodl-0.3.5.tar.gz",
    "platform": null,
    "description": "## TurboDL\n\n![PyPI - Version](https://img.shields.io/pypi/v/turbodl?style=flat&logo=pypi&logoColor=blue&color=blue&link=https://pypi.org/project/turbodl)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/turbodl?style=flat&logo=pypi&logoColor=blue&color=blue&link=https://pypi.org/project/turbodl)\n![PyPI - Code Style](https://img.shields.io/badge/code%20style-ruff-blue?style=flat&logo=ruff&logoColor=blue&color=blue&link=https://github.com/astral-sh/ruff)\n![PyPI - Format](https://img.shields.io/pypi/format/turbodl?style=flat&logo=pypi&logoColor=blue&color=blue&link=https://pypi.org/project/turbodl)\n![PyPI - Python Compatible Versions](https://img.shields.io/pypi/pyversions/turbodl?style=flat&logo=python&logoColor=blue&color=blue&link=https://pypi.org/project/turbodl)\n\nTurboDL is an extremely smart, fast, and efficient download manager with several automations.\n\n- Built-in sophisticated download acceleration technique.\n- Uses a sophisticated algorithm to calculate the optimal number of connections based on file size and connection speed.\n- Retry failed requests efficiently.\n- Automatically detects file information before download.\n- Automatically handles redirects.\n- Automatically uses RAM buffer to speed up downloads and reduce disk I/O overhead.\n- Supports post-download hash verification.\n- Accurately displays a beautiful progress bar.\n\n<br>\n\n#### Installation (from [PyPI](https://pypi.org/project/turbodl))\n\n```bash\npip install --upgrade turbodl  # Install the latest version of TurboDL\n```\n\n### Example Usage\n\n#### Inside a Python script (Basic Usage)\n\n```python\nfrom turbodl import TurboDL\n\n\nturbodl = TurboDL()\nturbodl.download(\n    url=\"https://example.com/file.txt\",  # Your download URL\n    output_path=\"path/to/file\"  # The file/path to save the downloaded file to or leave it empty to save it to the current working directory\n)\n\nturbodl.output_path  # The absolute path to the downloaded file\n\n```\n\n#### Inside a Python script (Advanced Usage)\n\n```python\nfrom turbodl import TurboDL\n\n\nturbodl = TurboDL(\n    max_connections=\"auto\",\n    connection_speed_mbps=80,\n    show_progress_bar=True,\n    save_log_file=False,\n)\nturbodl.download(\n    url=\"https://example.com/file.txt\",\n    output_path=\"path/to/file\",\n    pre_allocate_space=False,\n    use_ram_buffer=\"auto\",\n    overwrite=True,\n    headers=None,\n    timeout=None\n    expected_hash=None,\n    hash_type=\"md5\",\n)\n\nturbodl.output_path  # The absolute path to the downloaded file\n\n```\n\n#### From the command line\n\n```bash\nturbodl --help  # Show help for all commands\nturbodl download --help  # Show help for the download command\n\nturbodl download [...] https://example.com/file.txt path/to/file  # Download the file\n```\n\n##### CLI Demo\n\n[![TurboDL CLI Demo](assets/demo.gif)](https://asciinema.org/a/4qO7o9RFMnGJuJmg46gldBFik)\n\n### Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, fork the repository and create a pull request. You can also simply open an issue and describe your ideas or report bugs. **Don't forget to give the project a star if you like it!**\n\n<br>\n\n<a href=\"https://github.com/henrique-coder/turbodl/graphs/contributors\">\n  <img src=\"https://contrib.rocks/image?repo=henrique-coder/turbodl\" />\n</a>\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "TurboDL is an extremely smart, fast, and efficient download manager with several automations.",
    "version": "0.3.5",
    "project_urls": {
        "Bug Tracker": "https://github.com/henrique-coder/turbodl/issues",
        "Changelog": "https://github.com/henrique-coder/turbodl/releases/latest",
        "documentation": "https://github.com/henrique-coder/turbodl/blob/main/README.md",
        "homepage": "https://github.com/henrique-coder/turbodl",
        "repository": "https://github.com/henrique-coder/turbodl"
    },
    "split_keywords": [
        "dl",
        " downloader",
        " manager",
        " python",
        " smart",
        " turbodl"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "e2f0be02cb03f42266a93410654a885d9122da31a9c10233a67b87e4412bfeb9",
                "md5": "2e9a080780ab386ff86169a37f71cf09",
                "sha256": "0af15784961d0021e5fda124fc897778fe006e368f103d285ad79a29f03f5458"
            },
            "downloads": -1,
            "filename": "turbodl-0.3.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2e9a080780ab386ff86169a37f71cf09",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.10",
            "size": 16403,
            "upload_time": "2025-02-06T00:12:23",
            "upload_time_iso_8601": "2025-02-06T00:12:23.023573Z",
            "url": "https://files.pythonhosted.org/packages/e2/f0/be02cb03f42266a93410654a885d9122da31a9c10233a67b87e4412bfeb9/turbodl-0.3.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "255232cd01603a83f3a971cf013c509c1beb0bfc94325fc3421e4da65102dc66",
                "md5": "9d11b42b023ee98a22b98b859e1d50ea",
                "sha256": "61b7c6c9c65328d50310d5fd7b3104c510918aaf0d646cc665af018b330bcc7e"
            },
            "downloads": -1,
            "filename": "turbodl-0.3.5.tar.gz",
            "has_sig": false,
            "md5_digest": "9d11b42b023ee98a22b98b859e1d50ea",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.10",
            "size": 14024,
            "upload_time": "2025-02-06T00:12:25",
            "upload_time_iso_8601": "2025-02-06T00:12:25.196805Z",
            "url": "https://files.pythonhosted.org/packages/25/52/32cd01603a83f3a971cf013c509c1beb0bfc94325fc3421e4da65102dc66/turbodl-0.3.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-06 00:12:25",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "henrique-coder",
    "github_project": "turbodl",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "turbodl"
}
        
Elapsed time: 0.52214s