diff options
| -rw-r--r-- | README.md | 12 | ||||
| -rw-r--r-- | test/test_wikiget.py | 2 | ||||
| -rw-r--r-- | wikiget/version.py | 2 | ||||
| -rw-r--r-- | wikiget/wikiget.py | 4 |
4 files changed, 16 insertions, 4 deletions
@@ -17,6 +17,9 @@ If `FILE` is in the form `File:Example.jpg` or `Example.jpg`, it will be fetched from the default site, which is "en.wikipedia.org". If it's the fully-qualified URL of a file description page, like `https://commons.wikimedia.org/wiki/File:Example.jpg`, the file is fetched from the specified site, in this case "commons.wikimedia.org". +Full URLs may contain characters your shell interprets differently, so you can +either escape those characters with a backslash `\` or surround the entire URL +with single `'` or double `"` quotes. The site can also be specified with the `--site` flag, though this will not have any effect if the full URL is given. @@ -29,8 +32,17 @@ By default, the program won't overwrite existing files with the same name as the target, but this can be forced with `-f` or `--force`. Additionally, the file can be downloaded to a different name with `-o`. +### Examples + +```bash +wikiget File:Example.jpg +wikiget --site commons.wikimedia.org File:Example.jpg +wikiget https://en.wikipedia.org/wiki/File:Example.jpg -o test.jpg +``` + ## Future plans +- compare downloaded file hash with server - batch download categories and user uploads - download from any MediaWiki-powered site, not just Wikimedia projects - download Wikipedia articles, in plain text, wikitext, or other formats diff --git a/test/test_wikiget.py b/test/test_wikiget.py index 330ecdf..71c9006 100644 --- a/test/test_wikiget.py +++ b/test/test_wikiget.py @@ -61,7 +61,7 @@ def test_valid_file_input(): """ valid_input = ["Image:example.jpg", "file:example.jpg", "File:example.file-01.jpg", - "File:ß handwritten sample.gif"] + "File:ß handwritten sample.gif", "File:A (1).jpeg"] for i in valid_input: file_match = wikiget.valid_file(i) assert file_match is not None diff --git a/wikiget/version.py b/wikiget/version.py index ae3551e..efd9297 100644 --- a/wikiget/version.py +++ b/wikiget/version.py @@ -4,4 +4,4 @@ Copyright (C) 2018-2019 Cody Logan; licensed GPLv3+ SPDX-License-Identifier: GPL-3.0-or-later """ -__version__ = "0.1.1" +__version__ = "0.1.2" diff --git a/wikiget/wikiget.py b/wikiget/wikiget.py index 7122f3a..30a7d17 100644 --- a/wikiget/wikiget.py +++ b/wikiget/wikiget.py @@ -42,8 +42,8 @@ def main(): epilog=""" Copyright (C) 2018-2019 Cody Logan. License GPLv3+: GNU GPL version 3 or later <http://www.gnu.org/licenses/gpl.html>. - This is free software; you are free to change and redistribute it. - There is NO WARRANTY, to the extent permitted by law. + This is free software; you are free to change and redistribute + it. There is NO WARRANTY, to the extent permitted by law. """) parser.add_argument("FILE", help=""" name of the file to download with the File: or Image: prefix, |