Metadata-Version: 2.1
Name: mtc-cli
Version: 0.2.0
Summary: A simple CLI tool for moving enwp files to Commons
Home-page: https://github.com/fastily/mtc-cli
Author: Fastily
Author-email: fastily@users.noreply.github.com
Project-URL: Bug Tracker, https://github.com/fastily/mtc-cli/issues
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: pwiki
Requires-Dist: rich

# mtc-cli
[![Python 3.12+](https://upload.wikimedia.org/wikipedia/commons/5/50/Blue_Python_3.12%2B_Shield_Badge.svg)](https://www.python.org)
[![MediaWiki 1.35+](https://upload.wikimedia.org/wikipedia/commons/b/b3/Blue_MediaWiki_1.35%2B_Shield_Badge.svg)](https://www.mediawiki.org/wiki/MediaWiki)
[![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)

mtc-cli is a command line tool that helps simplify and automate file imports from Wikipedia to Commons.

This is the rewritten, spiritual successor to the original [MTC!](https://github.com/fastily/mtc) tool.

### Install
```bash
pip install mtc-cli
```

### Usage
```
usage: __main__.py [-h] [-u username] [-f] [-d] [-a api_endpoint] [titles ...]

mtc CLI

positional arguments:
  titles           Files, usernames, templates, or categories

options:
  -h, --help       show this help message and exit
  -u username      the username to use
  -f               Force (ignore filter) file transfer(s)
  -d               Activate dry run/debug mode (does not transfer files)
  -a api_endpoint  The default desc generation API endpoint to use. Defaults to public toolforge instance.
```

👉 Password is set via env variable `<USERNAME>_PW`, such that `<USERNAME>` is the username of the bot in all caps.
