Metadata-Version: 2.1
Name: metron-tagger
Version: 1.2.8
Summary: A program to write metadata from metron.cloud to a comic archive
License: GPL-3.0-or-later
Keywords: comics,comic,metadata,tagging,tagger
Author: Brian Pepple
Author-email: bdpepple@gmail.com
Maintainer: Brian Pepple
Maintainer-email: bdpepple@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Other/Nonlisted Topic
Classifier: Topic :: Utilities
Requires-Dist: darkseid (>=1.2.0,<2.0.0)
Requires-Dist: mokkari (>=2.1.1,<3.0.0)
Requires-Dist: questionary (>=1.10.0,<2.0.0)
Project-URL: Bug Tracker, https://github.com/bpepple/metron-tagger/issues
Project-URL: Homepage, https://github.com/bpepple/metron-tagger
Description-Content-Type: text/x-rst

=============
Metron-Tagger
=============

.. image:: https://img.shields.io/pypi/v/metron-tagger.svg
    :target: https://pypi.org/project/metron-tagger/

.. image:: https://img.shields.io/pypi/pyversions/metron-tagger.svg
    :target: https://pypi.org/project/metron-tagger/

.. image:: https://img.shields.io/github/license/bpepple/metron-tagger
    :target: https://opensource.org/licenses/GPL-3.0

.. image:: https://codecov.io/gh/bpepple/metron-tagger/branch/master/graph/badge.svg?token=d8TyzWM2Uz
    :target: https://codecov.io/gh/bpepple/metron-tagger

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black

Quick Description
-----------------

A command-line tool to tag comic archives with metadata from metron.cloud_.

.. _metron.cloud: https://metron.cloud

Installation
------------

PyPi
~~~~

Or install it yourself:

.. code:: bash

  $ pip install --user metron-tagger

GitHub
~~~~~~

Installing the latest version from Github:

.. code:: bash

  $ git clone https://github.com/bpepple/metron-tagger.git
  $ cd metron-tagger
  $ python3 setup.py install

FAQ
---

**Why no .cbr (rar) support?**

- I'm not aware of any provider (Comixology, Humble Bundle, DriveThru Comics, etc.) of legally downloadable DRM-free comics that use the rar format.
- It's a non-free software file format.
- It is trivial to convert to cbz (zip) format.

Help
----

::

    usage: metron-tagger [-h] [-r] [-o] [--id ID] [-d] [--ignore-existing]
                         [--missing] [-u USER] [-p PASSWORD] [--set-metron-user]
                         [-s] [--sort-dir SORT_DIR] [--set-sort-dir] [--version]
                         path [path ...]

    Read in a file or set of files, and return the result.

    positional arguments:
        path                  Path of a file or a folder of files.

    optional arguments:
        -h, --help            show this help message and exit
        -r, --rename          Rename comic archive from the files metadata. (default: False)
        -o, --online          Search online and attempt to identify comic archive. (default: False)
        --id ID               Identify file for tagging with the Metron Issue Id. (default: None)
        -d, --delete          Delete the metadata tags from the file. (default: False)
        --ignore-existing     Ignore files that have existing metadata tag. (default: False)
        --missing             List files without metadata. (default: False)
        -u USER, --user USER  Metron user identity (default: None)
        -p PASSWORD, --password PASSWORD
                              Metron user password (default: None)
        --set-metron-user     Save the Metron user settings (default: False)
        -s, --sort            Sort files that contain metadata tags. (default: False)
        --sort-dir SORT_DIR   Directory wher files should be sorted to. This should
                              not have a trailing path serparator. (default: None)
        --set-sort-dir        Set the directory where files should be sorted. (default: False)
        --version             Show the version number and exit

Bugs/Requests
-------------

Please use the `GitHub issue tracker <https://github.com/bpepple/metron-tagger/issues>`_ to submit bugs or request features.

License
-------

This project is licensed under the `GPLv3 License <LICENSE>`_.


