python3-wget 0.0.2-beta1

# python3-wget

Installation
============

With pip
========

sudo pip3 install python3-wget

From source
===========

python3 setup.py install

Usage
=====

python -m wget [options] <URL>

options:
-o --output FILE|DIR output filename or directory

Use within a project/package
============================

See my download repo on github that utilses this module
https://github.com/jamiejackherer/download

API Usage
=========

>>> import wget
>>> url = 'http://www.futurecrew.com/skaven/song_files/mp3/razorback.mp3'
>>> filename = wget.download(url)
70% [################################### ] 75M / 107M

>> filename
'razorback.mp3'

Alternative progress bar:

>>> wget.download(url, bar=bar_thermometer)

TODO - I will do these by version 0.1.0
====
* Implement a way to resume downloads.
* Add options to be more like the *nix wget utility.
* Implement download speed.


ChangeLog - (For this current version - now maintained by JamieJackHerer)
=========
0.0.2-beta1
* Now uses human readable sizes r.e. it displays size in K/M/G/P (kilobytes/megabytes/gigabytes/petabytes)
* Progress bar uses '[#### ]' format instead of '[.... ]'
* Reformatted for Python 3.x
* Included 'hurry.filesize' as a dependency in setup.py


Jamie Lindsey AKA JamieJackHerer <jackherer026@gmail.com>

+========================================================================+
|********* Anything below this message has nothing to do with me ********|
|********* but it is still implemented in the new versions **************|
|********* any changes made will now be noted above *********************|
+========================================================================+
ChangeLog - (For original package which seems to no longer be in development)
=========
2.2 (2014-07-19)
* it again can download without -o option

2.1 (2014-07-10)
* it shows command line help
* -o option allows to select output file/directory

* download(url, out, bar) contains out parameter

2.0 (2013-04-26)
* it shows percentage
* it has usage examples
* it changes if being used as a library

* download shows progress bar by default
* bar_adaptive gets improved algorithm
* download(url, bar) contains bar parameter
* bar(current, total)
* progress_callback is named callback_progress

1.0 (2012-11-13)
* it runs with Python 3

0.9 (2012-11-13)
* it renames file if it already exists
* it can be used as a library

* download(url) returns filename
* bar_adaptive() draws progress bar
* bar_thermometer() simplified bar

0.8 (2011-05-03)
* it detects filename from HTTP headers

0.7 (2011-03-01)
* compatibility fix for Python 2.5
* limit width of progress bar to 100 chars

0.6 (2010-04-24)
* it detects console width on POSIX

0.5 (2010-04-23)
* it detects console width on Windows

0.4 (2010-04-15)
* it shows cute progress bar

0.3 (2010-04-05)
* it creates temp file in current dir

0.2 (2010-02-16)
* it tries to detect filename from URL

0.1 (2010-02-04)
* it can download file


Release Checklist
=================

| [ ] update version in wget.py
| [x] update description in setup.py
| [ ] python setup.py check -mrs
| [ ] python setup.py sdist upload
| [ ] tag hg version

--
anatoly techtonik <techtonik@gmail.com>