ptrack


Logs | Files | README | LICENSE | GitLab


1
commit e0d1ee0b683c7bd608368300cec58c219458d667
2
Author: Connor Etherington <[email protected]>
3
Date:   Sun Jan 7 23:57:17 2024 +0200
4
5
    Auto-Commit Update - 20240107
6
---
7
 PKGBUILD                                           |   2 +-
8
 README.md                                          | 100 ++++++++++++++++++++-
9
 dist/ptrack-2.0.2-py311_0.tar.bz2                  | Bin 30314 -> 0 bytes
10
 dist/ptrack-2.0.2.tar.gz                           | Bin 8174 -> 0 bytes
11
 ...-none-any.whl => ptrack-2.0.3-py3-none-any.whl} | Bin 10150 -> 10167 bytes
12
 dist/ptrack-2.0.3-py311_0.tar.bz2                  | Bin 0 -> 30966 bytes
13
 dist/ptrack-2.0.3.tar.gz                           | Bin 0 -> 9556 bytes
14
 ptrack.1.gz                                        | Bin 846 -> 846 bytes
15
 ptrack/__init__.py                                 |   2 +-
16
 recipe/meta.yaml                                   |   2 +-
17
 requirements.txt                                   |   2 +
18
 setup.py                                           |   4 +-
19
 12 files changed, 107 insertions(+), 5 deletions(-)
20
21
diff --git a/PKGBUILD b/PKGBUILD
22
index d17f128..cb80ba9 100644
23
--- a/PKGBUILD
24
+++ b/PKGBUILD
25
@@ -1,7 +1,7 @@
26
 # Maintainer: Connor Etherington <[email protected]>
27
 # ---
28
 pkgname=ptrack
29
-pkgver=2.0.2
30
+pkgver=2.0.3
31
 pkgrel=1
32
 pkgdesc="A simple CLI utility for asthetically tracking progress when copying, moving or downloading files."
33
 arch=(x86_64)
34
diff --git a/README.md b/README.md
35
index 6740b51..adbbbe8 100644
36
--- a/README.md
37
+++ b/README.md
38
@@ -1 +1,99 @@
39
-*Version: 2.0.2*
40
+# P-Track - Progress Tracker
41
+
42
+### Welcome to ptrack, a powerful and user-friendly CLI utility for tracking the progress of your file operations.
43
+### Designed to be concise, efficient and performance-optimized, ptrack works swiftly and accurately, while providing in-depth insight into the progress of the task at hand.
44
+
45
+*Version: 2.0.3*
46
+
47
+***
48
+
49
+![Welcome to P-Track](./.gitlab/media/main.gif)
50
+
51
+## Key Features
52
+
53
++ Progress Bar: ptrack comes equipped with an aesthetically pleasing progress bar that updates in real-time, giving you a visual representation of your ongoing file operation.
54
++ Verbose Mode: If you prefer a more in-depth perspective, ptrack has a verbose mode which displays detailed information about each file being processed.
55
++ Copying and Moving Files: ptrack supports both copying and moving files on any unix-like opperating system, including Linux, macOS, and BSD.
56
++ Downloading Files: ptrack can be used to download files from specified URLs. It will display the progress of the download in real-time, and will also display the download speed.
57
++ Interruption Handling: ptrack is built to respect your system's interruption signals. It will promptly stop operations when such signals are received, reducing the risk of data corruption.
58
++ High Performance: Above all, ptrack stands out for its speed and accuracy. It ensures your file operations are executed swiftly and with a high degree of precision.
59
+
60
+***
61
+
62
+## Introducing ptrack's new file downloader
63
+
64
+**In the latest release, ptrack has made all around changes increasing the visible stats/details of file opperaitions.**<br>
65
+**This is easily noticable in features such as ptracks new file/URL downloader (`ptd`) or (`ptrack -d`):**
66
+
67
+![New Downloads Update](./.gitlab/media/new-download.gif)
68
+
69
+
70
+## Installation:
71
+
72
+### **P-Track** can be acquired from various platforms:
73
+
74
+### **PyPI**:
75
+    pip install ptrack
76
+
77
+### **Conda**:
78
+    conda install -c concise ptrack
79
+
80
+### **Arch User Repository (AUR)**:
81
+#### For Arch Linux users, ptrack is available from on the AUR for all Arch or Arch based distro with the help of your favorite AUR helper, eg:
82
+    yay -Sy ptrack
83
+
84
+### **From Source**:
85
+#### If you prefer to install from source, clone this repo, cd into it and run:
86
+    pip install -e .
87
+
88
+    # or python3 ./setup.py install
89
+
90
+
91
+
92
+# Usage
93
+
94
+The basic usage of ptrack isvery simple:
95
+
96
+`ptrack [-h] [-v] [-c] [-m] [-d] [-V] [SOURCE...] [DESTINATION]`
97
+
98
+```bash
99
+### Downloading Files
100
+  ptd [OPTIONS] URL(S)                 ( or ptrack -d URL(S) )
101
+
102
+### Copying Files:
103
+  ptc [OPTIONS] SOURCE... DESTINATION  ( or ptrack -c SOURCE... DESTINATION )
104
+
105
+### Moving Files:
106
+  ptm [OPTIONS] SOURCE... DESTINATION  ( or ptrack -m SOURCE... DESTINATION )
107
+```
108
+
109
+Refer to the User Guide for more detailed instructions and use-cases.
110
+
111
+
112
+## Options:
113
+
114
+* -h, --help      show this help message and exit
115
+* -v, --verbose   verbose output
116
+* -c, --copy      copy files (You can use `ptc` instead of `ptrack -c`)
117
+* -m, --move      move files (You can use `ptm` instead of `ptrack -m`)
118
+* -d, --download  download files (You can use `ptd` instead of `ptrack -d`)
119
+* -V, --version   show program's version number and exit
120
+
121
+
122
+***
123
+
124
+
125
+### Regular Copy:
126
+![Regular Copy](./.gitlab/media/copy.gif)
127
+
128
+### Verbose Copy:
129
+![Verbose Copy](./.gitlab/media/vcopy.gif)
130
+
131
+
132
+## License
133
+ptrack is open source and licenced under the MIT/X Consortium license
134
+
135
+## Support
136
+If you encounter any problems or have suggestions for ptrack, please open an issue on GitLab. We value your feedback and will respond as quickly as possible.
137
+
138
+
139
diff --git a/dist/ptrack-2.0.2-py311_0.tar.bz2 b/dist/ptrack-2.0.2-py311_0.tar.bz2
140
deleted file mode 100644
141
index f095fbc..0000000
142
Binary files a/dist/ptrack-2.0.2-py311_0.tar.bz2 and /dev/null differ
143
diff --git a/dist/ptrack-2.0.2.tar.gz b/dist/ptrack-2.0.2.tar.gz
144
deleted file mode 100644
145
index 886e6af..0000000
146
Binary files a/dist/ptrack-2.0.2.tar.gz and /dev/null differ
147
diff --git a/dist/ptrack-2.0.2-py3-none-any.whl b/dist/ptrack-2.0.3-py3-none-any.whl
148
similarity index 73%
149
rename from dist/ptrack-2.0.2-py3-none-any.whl
150
rename to dist/ptrack-2.0.3-py3-none-any.whl
151
index ff704f9..e9c0fdf 100644
152
Binary files a/dist/ptrack-2.0.2-py3-none-any.whl and b/dist/ptrack-2.0.3-py3-none-any.whl differ
153
diff --git a/dist/ptrack-2.0.3-py311_0.tar.bz2 b/dist/ptrack-2.0.3-py311_0.tar.bz2
154
new file mode 100644
155
index 0000000..5c60c11
156
Binary files /dev/null and b/dist/ptrack-2.0.3-py311_0.tar.bz2 differ
157
diff --git a/dist/ptrack-2.0.3.tar.gz b/dist/ptrack-2.0.3.tar.gz
158
new file mode 100644
159
index 0000000..deff9ce
160
Binary files /dev/null and b/dist/ptrack-2.0.3.tar.gz differ
161
diff --git a/ptrack.1.gz b/ptrack.1.gz
162
index 73fe49d..0d15102 100644
163
Binary files a/ptrack.1.gz and b/ptrack.1.gz differ
164
diff --git a/ptrack/__init__.py b/ptrack/__init__.py
165
index 3bed49c..c135866 100644
166
--- a/ptrack/__init__.py
167
+++ b/ptrack/__init__.py
168
@@ -1,5 +1,5 @@
169
 import argparse
170
-version="2.0.2"
171
+version="2.0.3"
172
 
173
 parser = argparse.ArgumentParser(description='A simple CLI utility for asthetically tracking progress when copying or moving files.')
174
 parser.add_argument('-v', '--verbose', action='store_true', help='verbose output')
175
diff --git a/recipe/meta.yaml b/recipe/meta.yaml
176
index c94f8d5..8c6aabd 100644
177
--- a/recipe/meta.yaml
178
+++ b/recipe/meta.yaml
179
@@ -1,6 +1,6 @@
180
 package:
181
   name: ptrack
182
-  version: 2.0.2
183
+  version: 2.0.3
184
 
185
 source:
186
   path: ..
187
diff --git a/requirements.txt b/requirements.txt
188
index d9be989..7515f9c 100644
189
--- a/requirements.txt
190
+++ b/requirements.txt
191
@@ -4,3 +4,5 @@ Pillow==10.1.0
192
 Requests==2.31.0
193
 rich==13.7.0
194
 yt_dlp==2023.10.13
195
+humanize==4.9.0
196
+validators==0.22.0
197
diff --git a/setup.py b/setup.py
198
index 00f942b..e89b93c 100644
199
--- a/setup.py
200
+++ b/setup.py
201
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
202
 
203
 setup(
204
     name='ptrack',
205
-    version="2.0.2",
206
+    version="2.0.3",
207
     description='A simple CLI utility for asthetically tracking progress when copying, moving or downloading files.',
208
     author='Connor Etherington',
209
     author_email='[email protected]',
210
@@ -14,6 +14,8 @@ setup(
211
         "Requests",
212
         "rich",
213
         "yt_dlp",
214
+        "humanize",
215
+        "validators",
216
     ],
217
     entry_points={
218
         'console_scripts': [