Metadata-Version: 2.1
Name: simple-commons-uploader
Version: 0.2.0
Summary: Batch Wikimedia Commons Uploader
Home-page: https://github.com/fastily/simple-commons-uploader
Author: Fastily
Author-email: fastily@users.noreply.github.com
License: UNKNOWN
Description: # Simple Commons Uploader
        [![Python 3.7](https://upload.wikimedia.org/wikipedia/commons/f/fc/Blue_Python_3.7_Shield_Badge.svg)](https://www.python.org)
        [![License: GPL v3](https://upload.wikimedia.org/wikipedia/commons/8/86/GPL_v3_Blue_Badge.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html)
        [![MediaWiki 1.27+](https://upload.wikimedia.org/wikipedia/commons/2/2c/MediaWiki_1.27%2B_Blue_Badge.svg)](https://www.mediawiki.org/wiki/MediaWiki)
        
        The Simple Commons Uploader makes it easy to batch upload your self-made photos and videos to the [Wikimedia Commons](https://commons.wikimedia.org/wiki/Main_Page).
        
        ⚠️ You must have an account on Wikimedia Commons to use this script.  Create an account by [going here](https://commons.wikimedia.org/wiki/Special:CreateAccount).
        
        ## Download
        ```bash
        pip install simple-commons-uploader
        ```
        
        ## Usage
        ```
        usage: scu [-h] [--user USER] [--pw PW] [-i] [--wgen] [folders [folders ...]]
        
        Simple Commons Uploader
        
        positional arguments:
          folders      folders with files to upload
        
        optional arguments:
          -h, --help   show this help message and exit
          --user USER  username to use
          --pw PW      password to use
          -i           force interactive login
          --wgen       run wgen password manager
        ```
        
        ## Authentication/Login
        The Simple Commons Uploader works with your normal password and [BotPasswords](https://commons.wikimedia.org/wiki/Special:BotPasswords).  
        
        There are three ways to authenticate:
        1. Interactively typing your credentials into the terminal, by running the program with the `-i` flag.
        2. Specifying your credentials via the `--user` and `--pw` flags.
        3. Using the Wgen setup utility by initially running the program with the `--wgen` flag.  This method has the advantage of saving your credentials so you won't have to type them in the next time you use the program.
        
        
        ## Behavior Details
        The Simple Commons Uploader only uploads files in [these file formats](https://commons.wikimedia.org/wiki/Commons:File_types).  Any other file types will be skippied.
        
        Uploaded files will be named based on local folder name.  For example, if your folder is called `Fancy pigeons`, contains jpgs of fancy pigeons, and today's date is 2018-01-01, then the resulting files will be named `File:Fancy pigeons 1 2018-01-01.jpg`, `File:Fancy pigeons 2 2018-01-01.jpg`, `File:Fancy pigeons 3 2018-01-01.jpg`, etc.
Platform: UNKNOWN
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
