pyfetchy 0.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: pyfetchy
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: A fast, open-source download manager with parallel segments and resume support
|
|
5
|
+
Project-URL: Homepage, https://github.com/Uruskus/fetchy
|
|
6
|
+
Project-URL: Issues, https://github.com/Uruskus/fetchy/issues
|
|
7
|
+
Author: fetchy contributors
|
|
8
|
+
License: MIT
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Keywords: cli,download,manager,parallel,resume
|
|
11
|
+
Classifier: Development Status :: 3 - Alpha
|
|
12
|
+
Classifier: Environment :: Console
|
|
13
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
14
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
15
|
+
Classifier: Programming Language :: Python :: 3
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
+
Classifier: Topic :: Internet :: WWW/HTTP
|
|
20
|
+
Classifier: Topic :: Utilities
|
|
21
|
+
Requires-Python: >=3.10
|
|
22
|
+
Requires-Dist: httpx>=0.27.0
|
|
23
|
+
Requires-Dist: rich>=13.0.0
|
|
24
|
+
Requires-Dist: typer>=0.12.0
|
|
25
|
+
Description-Content-Type: text/markdown
|
|
26
|
+
|
|
27
|
+
# fetchy
|
|
28
|
+
|
|
29
|
+
> A fast, open-source CLI download manager — a free alternative to IDM.
|
|
30
|
+
|
|
31
|
+
[](https://python.org)
|
|
32
|
+
[](LICENSE)
|
|
33
|
+
[](https://pypi.org/project/fetchy)
|
|
34
|
+
|
|
35
|
+
fetchy splits files into parallel segments using HTTP Range Requests, giving you faster downloads and the ability to resume interrupted transfers — right from your terminal.
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## Features
|
|
40
|
+
|
|
41
|
+
- **Parallel downloads** — splits files into N segments downloaded simultaneously
|
|
42
|
+
- **Resume support** — interrupted downloads continue from where they left off
|
|
43
|
+
- **Live progress** — per-segment bars with speed and ETA
|
|
44
|
+
- **Retry logic** — transient errors are retried automatically with exponential backoff
|
|
45
|
+
- **Cross-platform** — works on Windows, macOS, and Linux
|
|
46
|
+
- **Zero config** — sensible defaults, fully configurable via flags
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## Installation
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
pip install fetchy
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Or install from source:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
git clone https://github.com/yourusername/fetchy.git
|
|
60
|
+
cd fetchy
|
|
61
|
+
pip install -e .
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Usage
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
# Basic download (4 segments by default)
|
|
70
|
+
fetchy get https://example.com/largefile.zip
|
|
71
|
+
|
|
72
|
+
# Save to a specific directory or filename
|
|
73
|
+
fetchy get https://example.com/largefile.zip -o ~/Downloads/
|
|
74
|
+
fetchy get https://example.com/largefile.zip -o ~/Downloads/myfile.zip
|
|
75
|
+
|
|
76
|
+
# Use 8 parallel segments
|
|
77
|
+
fetchy get https://example.com/largefile.zip -s 8
|
|
78
|
+
|
|
79
|
+
# Disable resume (start fresh even if a state file exists)
|
|
80
|
+
fetchy get https://example.com/largefile.zip --no-resume
|
|
81
|
+
|
|
82
|
+
# Show version
|
|
83
|
+
fetchy --version
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
**Resuming:** if you press `Ctrl+C` during a download, fetchy saves a `.fetchy` state file next to the output file. Run the same command again to resume automatically.
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## How it works
|
|
91
|
+
|
|
92
|
+
1. fetchy sends a `HEAD` request to check the file size and whether the server supports `Range` requests.
|
|
93
|
+
2. If supported, the file is split into N equally-sized byte ranges.
|
|
94
|
+
3. Each segment is downloaded in parallel using async HTTP (httpx).
|
|
95
|
+
4. Segments are written directly to their correct offset in the pre-allocated output file — no temp files to merge.
|
|
96
|
+
5. Progress and speed are tracked per segment and shown in a live Rich display.
|
|
97
|
+
6. On completion the `.fetchy` state file is deleted automatically.
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## Options
|
|
102
|
+
|
|
103
|
+
| Flag | Default | Description |
|
|
104
|
+
|---|---|---|
|
|
105
|
+
| `-o`, `--output` | `.` (current dir) | Output file or directory |
|
|
106
|
+
| `-s`, `--segments` | `4` | Number of parallel segments |
|
|
107
|
+
| `-r`, `--retries` | `5` | Max retries per segment |
|
|
108
|
+
| `--resume / --no-resume` | `--resume` | Resume interrupted downloads |
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## Development
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
# Install with dev dependencies
|
|
116
|
+
pip install -e ".[dev]"
|
|
117
|
+
|
|
118
|
+
# Run tests
|
|
119
|
+
pytest
|
|
120
|
+
|
|
121
|
+
# Run a local download test
|
|
122
|
+
fetchy get https://speed.hetzner.de/100MB.bin -s 8
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
### Project structure
|
|
126
|
+
|
|
127
|
+
```
|
|
128
|
+
fetchy/
|
|
129
|
+
├── src/
|
|
130
|
+
│ └── fetchy/
|
|
131
|
+
│ ├── __init__.py # version
|
|
132
|
+
│ ├── cli.py # Typer CLI entry point
|
|
133
|
+
│ ├── downloader.py # core engine (segments, resume, retry)
|
|
134
|
+
│ └── progress.py # Rich progress display
|
|
135
|
+
├── tests/
|
|
136
|
+
│ └── test_downloader.py
|
|
137
|
+
├── pyproject.toml
|
|
138
|
+
└── README.md
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## Contributing
|
|
144
|
+
|
|
145
|
+
Contributions are welcome! Please open an issue first to discuss what you'd like to change.
|
|
146
|
+
|
|
147
|
+
1. Fork the repo
|
|
148
|
+
2. Create a feature branch (`git checkout -b feature/your-feature`)
|
|
149
|
+
3. Commit your changes
|
|
150
|
+
4. Open a pull request
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## License
|
|
155
|
+
|
|
156
|
+
MIT — see [LICENSE](LICENSE).
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
pyfetchy-0.1.0.dist-info/METADATA,sha256=7Lb9ES9oCmp0vrxdJZKWxZxXVP6zZe5EGOKrFBfP4_g,4563
|
|
2
|
+
pyfetchy-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
|
|
3
|
+
pyfetchy-0.1.0.dist-info/entry_points.txt,sha256=G5mHppBsZWB27W9PSeEO_vHeV9_P9GQ0Zd5DSYrEruw,42
|
|
4
|
+
pyfetchy-0.1.0.dist-info/licenses/LICENSE,sha256=2ljDKNfqvHD_sf0TzFi0IEojn5dfQW-kYQXQwJUdMlQ,1076
|
|
5
|
+
pyfetchy-0.1.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2024 fetchy contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|