<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents** *generated with [DocToc](https://github.com/ktechhub/doctoc)*
<!---toc start-->
- [pywgett](#pywgett)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Usage](#usage)
- [Example usage:](#example-usage)
- [Features](#features)
- [GitHub](#github)
- [License](#license)
- [Contribution](#contribution)
<!---toc end-->
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
# pywgett
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ktechhub/pywgett/blob/main/LICENSE)
[![PyPI version](https://badge.fury.io/py/pywgett.svg)](https://badge.fury.io/py/pywgett)
pywgett is a command-line utility built with Python for downloading files from the internet. It provides an easy-to-use interface to fetch files using URLs, with support for custom headers, resume downloads, and more.
## Prerequisites
Before using pywgett, ensure you have the following:
- Python 3.6+
- pip (Python package installer)
## Installation
You can install pywgett using pip:
```sh
pip install pywgett
```
Alternatively, install it from the source on GitHub:
```sh
git clone https://github.com/ktechhub/pywgett.git
cd pywgett
python setup.py install
```
## Usage
Download a file from a URL:
```sh
pywget --help
Usage: pywget [OPTIONS] [URLS]...
Download utility to fetch a file from the internet.
Args: urls (tuple): The URLs of the files to download.
If multiple URLs are provided, they will be downloaded in parallel.
If a single URL is provided, it will be downloaded serially. output
(str): The name of the file or directory to save the downloaded file(s) as.
header (list): Optional HTTP headers to include in the request. parallel
(int): Number of parallel downloads. verbose (bool): Enable verbose
mode.
Returns: None
Options:
-o, --output TEXT Optional output file name or directory
--header TEXT Custom headers to include in the request, e.g.
--header 'Authorization: Bearer token', --header
'Content-Type: application/json', --header 'User-
Agent: Mozilla/5.0', etc.
-p, --parallel INTEGER Number of parallel downloads [default: 4]
--verbose Enable verbose mode to output detailed information
about the download process.
--version Show the version and exit.
--help Show this message and exit.
```
### Example usage:
Single URL Download;
```sh
pywget https://www.example.com/file.zip
#or
pywget https://example.com/file.zip -o output_file.zip
```
```sh
pywget https://example.com/file.zip -o output_file.zip --header "Authorization: Bearer token" --header "User-Agent: CustomUserAgent/1.0" --verbose
```
Multiple URLS download
```sh
pywget https://example.com/file1.zip https://example.com/file2.zip -o /path/to/save -p 6
pywget https://www.ktechhub.com/assets/logo.13616b6b.png https://www.ktechhub.com/assets/logo.13616b6b.png
pywget https://example.com/file1.zip https://example.com/file2.zip -p 6
```
## Features
- Download files from URLs with ease.
- Supports custom HTTP headers for authentication and content type.
- Resume interrupted downloads automatically.
- Displays progress bar during file downloads.
- Verbose mode for detailed download process information.
## GitHub
For more details, visit the [GitHub repository](https://github.com/ktechhub/pywgett).
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
### Contribution
If you want to contribute, kindly see this **[contribution guide](contribution.md)**.
Raw data
{
"_id": null,
"home_page": "https://github.com/ktechhub/pywgett",
"name": "pywgett",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "download utility wget pywgett pywget pywgett.py pywget.py",
"author": "Ktechhub",
"author_email": "mm@ktechhub.com",
"download_url": "https://files.pythonhosted.org/packages/fd/5e/227aa0dbdfc3235efe955d3a6d68de04050c8cd960ff0be37e2e7501b65a/pywgett-1.0.2.tar.gz",
"platform": null,
"description": "\n<!-- START doctoc generated TOC please keep comment here to allow auto update -->\n<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->\n**Table of Contents** *generated with [DocToc](https://github.com/ktechhub/doctoc)*\n\n<!---toc start-->\n\n- [pywgett](#pywgett)\n - [Prerequisites](#prerequisites)\n - [Installation](#installation)\n - [Usage](#usage)\n - [Example usage:](#example-usage)\n - [Features](#features)\n - [GitHub](#github)\n - [License](#license)\n - [Contribution](#contribution)\n\n<!---toc end-->\n\n<!-- END doctoc generated TOC please keep comment here to allow auto update -->\n# pywgett\n\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ktechhub/pywgett/blob/main/LICENSE)\n[![PyPI version](https://badge.fury.io/py/pywgett.svg)](https://badge.fury.io/py/pywgett)\n\npywgett is a command-line utility built with Python for downloading files from the internet. It provides an easy-to-use interface to fetch files using URLs, with support for custom headers, resume downloads, and more.\n\n## Prerequisites\nBefore using pywgett, ensure you have the following:\n- Python 3.6+\n- pip (Python package installer)\n\n## Installation\nYou can install pywgett using pip:\n\n```sh\npip install pywgett\n```\n\nAlternatively, install it from the source on GitHub:\n\n```sh\ngit clone https://github.com/ktechhub/pywgett.git\ncd pywgett\npython setup.py install\n```\n\n## Usage\nDownload a file from a URL:\n\n```sh\npywget --help\nUsage: pywget [OPTIONS] [URLS]...\n\n Download utility to fetch a file from the internet.\n\n Args: urls (tuple): The URLs of the files to download.\n If multiple URLs are provided, they will be downloaded in parallel.\n If a single URL is provided, it will be downloaded serially. output\n (str): The name of the file or directory to save the downloaded file(s) as.\n header (list): Optional HTTP headers to include in the request. parallel\n (int): Number of parallel downloads. verbose (bool): Enable verbose\n mode.\n\n Returns: None\n\nOptions:\n -o, --output TEXT Optional output file name or directory\n --header TEXT Custom headers to include in the request, e.g.\n --header 'Authorization: Bearer token', --header\n 'Content-Type: application/json', --header 'User-\n Agent: Mozilla/5.0', etc.\n -p, --parallel INTEGER Number of parallel downloads [default: 4]\n --verbose Enable verbose mode to output detailed information\n about the download process.\n --version Show the version and exit.\n --help Show this message and exit.\n```\n\n### Example usage:\nSingle URL Download;\n```sh\npywget https://www.example.com/file.zip\n#or\npywget https://example.com/file.zip -o output_file.zip\n```\n```sh\npywget https://example.com/file.zip -o output_file.zip --header \"Authorization: Bearer token\" --header \"User-Agent: CustomUserAgent/1.0\" --verbose\n```\n\nMultiple URLS download\n```sh\npywget https://example.com/file1.zip https://example.com/file2.zip -o /path/to/save -p 6\npywget https://www.ktechhub.com/assets/logo.13616b6b.png https://www.ktechhub.com/assets/logo.13616b6b.png\npywget https://example.com/file1.zip https://example.com/file2.zip -p 6\n```\n## Features\n- Download files from URLs with ease.\n- Supports custom HTTP headers for authentication and content type.\n- Resume interrupted downloads automatically.\n- Displays progress bar during file downloads.\n- Verbose mode for detailed download process information.\n\n## GitHub\nFor more details, visit the [GitHub repository](https://github.com/ktechhub/pywgett).\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n### Contribution\nIf you want to contribute, kindly see this **[contribution guide](contribution.md)**.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Download utility as an easy way to get files from the net",
"version": "1.0.2",
"project_urls": {
"Homepage": "https://github.com/ktechhub/pywgett"
},
"split_keywords": [
"download",
"utility",
"wget",
"pywgett",
"pywget",
"pywgett.py",
"pywget.py"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dfbaf64b20cd89adaeb710d0e2a9bf0b734ead90720d86d2d4ce99bf680d52b7",
"md5": "2d3f712ca3381441d2659752aa274245",
"sha256": "11f8c32161a38d52c18bebaafdfbdb85dc55a54a37c572004b6109b1519b9fba"
},
"downloads": -1,
"filename": "pywgett-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2d3f712ca3381441d2659752aa274245",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 7154,
"upload_time": "2024-06-24T22:12:45",
"upload_time_iso_8601": "2024-06-24T22:12:45.885604Z",
"url": "https://files.pythonhosted.org/packages/df/ba/f64b20cd89adaeb710d0e2a9bf0b734ead90720d86d2d4ce99bf680d52b7/pywgett-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fd5e227aa0dbdfc3235efe955d3a6d68de04050c8cd960ff0be37e2e7501b65a",
"md5": "8a0d93894d4d633d4be31d904bc4ca95",
"sha256": "66d50d9e0d5636f3c7169c049db7f2814dc7e251919653a4ea8ddc859b4b4e50"
},
"downloads": -1,
"filename": "pywgett-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "8a0d93894d4d633d4be31d904bc4ca95",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 6022,
"upload_time": "2024-06-24T22:12:47",
"upload_time_iso_8601": "2024-06-24T22:12:47.441008Z",
"url": "https://files.pythonhosted.org/packages/fd/5e/227aa0dbdfc3235efe955d3a6d68de04050c8cd960ff0be37e2e7501b65a/pywgett-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-24 22:12:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ktechhub",
"github_project": "pywgett",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "click",
"specs": [
[
"==",
"8.1.7"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"24.1"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.32.3"
]
]
},
{
"name": "black",
"specs": []
},
{
"name": "pytest",
"specs": []
}
],
"lcname": "pywgett"
}