Metadata-Version: 1.1
Name: guessit
Version: 2.0rc4
Summary: GuessIt - a library for guessing information from video filenames.
Home-page: http://guessit.readthedocs.org/
Author: Rémi Alvergnat
Author-email: toilal.dev@gmail.com
License: LGPLv3
Download-URL: https://pypi.python.org/packages/source/g/guessit/guessit-2.0rc4.tar.gz
Description: GuessIt
        =======
        
        .. image:: http://img.shields.io/pypi/v/guessit.svg
            :target: https://pypi.python.org/pypi/guessit
            :alt: Latest Version
        
        .. image:: http://img.shields.io/badge/license-LGPLv3-blue.svg
            :target: https://pypi.python.org/pypi/guessit
            :alt: LGPLv3 License
        
        .. image:: http://img.shields.io/travis/wackou/guessit.svg
            :target: https://travis-ci.org/wackou/guessit
            :alt: Build Status
        
        .. image:: http://img.shields.io/coveralls/wackou/guessit.svg
            :target: https://coveralls.io/github/wackou/guessit
            :alt: Coveralls
        
        `HuBoard <https://huboard.com/wackou/guessit>`_
        
        
        GuessIt is a python library that extracts as much information as possible from a video filename.
        
        It has a very powerful matcher that allows to guess properties from a video using its filename only.
        This matcher works with both movies and tv shows episodes.
        
        For example, GuessIt can do the following::
        
            $ guessit "Treme.1x03.Right.Place,.Wrong.Time.HDTV.XviD-NoTV.avi"
            For: Treme.1x03.Right.Place,.Wrong.Time.HDTV.XviD-NoTV.avi
            GuessIt found: {
                "title": "Treme",
                "season": 1,
                "episode": 3,
                "episode_title": "Right Place, Wrong Time",
                "format": "HDTV",
                "video_codec": "XviD",
                "release_group": "NoTV",
                "container": "avi",
                "mimetype": "video/x-msvideo",
                "type": "episode"
            }
        
        More information are available at `ReadTheDocs <http://guessit.readthedocs.org/>`_.
        
        Migration note
        --------------
        GuessIt 2 has been rewriten from scratch. GuessIt is now a release name parser only, and support for additional
        features like hashes computations has been dropped.
        
        To migrate from guessit ``0.x`` or ``1.x``, please read
        `migration.rst <https://github.com/wackou/guessit/blob/master/docs/migration.rst>`_.
        
        Install
        -------
        
        Installing GuessIt is simple with `pip <http://www.pip-installer.org/>`_::
        
            $ pip install guessit
        
        You can also `install GuessIt from sources <https://github.com/wackou/guessit/blob/master/docs/sources.rst>`_
        
        Usage
        -----
        
        GuessIt can be used from command line::
        
            $ guessit
            usage: guessit [-h] [-t TYPE] [-n] [-Y] [-D] [-L ALLOWED_LANGUAGES]
                           [-C ALLOWED_COUNTRIES] [-E] [-T EXPECTED_TITLE]
                           [-G EXPECTED_GROUP] [-f INPUT_FILE] [-v] [-P SHOW_PROPERTY]
                           [-a] [-j] [-y] [-p] [-V] [--version]
                           [filename [filename ...]]
        
            positional arguments:
              filename              Filename or release name to guess
        
            optional arguments:
              -h, --help            show this help message and exit
        
            Naming:
              -t TYPE, --type TYPE  The suggested file type: movie, episode. If undefined,
                                    type will be guessed.
              -n, --name-only       Parse files as name only, considering "/" and "\" like
                                    other separators.
              -Y, --date-year-first
                                    If short date is found, consider the first digits as
                                    the year.
              -D, --date-day-first  If short date is found, consider the second digits as
                                    the day.
              -L ALLOWED_LANGUAGES, --allowed-languages ALLOWED_LANGUAGES
                                    Allowed language (can be used multiple times)
              -C ALLOWED_COUNTRIES, --allowed-countries ALLOWED_COUNTRIES
                                    Allowed country (can be used multiple times)
              -E, --episode-prefer-number
                                    Guess "serie.213.avi" as the episode 213. Without this
                                    option, it will be guessed as season 2, episode 13
              -T EXPECTED_TITLE, --expected-title EXPECTED_TITLE
                                    Expected title to parse (can be used multiple times)
              -G EXPECTED_GROUP, --expected-group EXPECTED_GROUP
                                    Expected release group (can be used multiple times)
        
            Input:
              -f INPUT_FILE, --input-file INPUT_FILE
                                    Read filenames from an input text file. File should
                                    use UTF-8 charset.
        
            Output:
              -v, --verbose         Display debug output
              -P SHOW_PROPERTY, --show-property SHOW_PROPERTY
                                    Display the value of a single property (title, series,
                                    video_codec, year, ...)
              -a, --advanced        Display advanced information for filename guesses, as
                                    json output
              -j, --json            Display information for filename guesses as json
                                    output
              -y, --yaml            Display information for filename guesses as yaml
                                    output
        
            Information:
              -p, --properties      Display properties that can be guessed.
              -V, --values          Display property values that can be guessed.
              --version             Display the guessit version.
        
        
        It can also be used as a python module::
        
            >>> from guessit import guessit
            >>> guessit(u'Treme.1x03.Right.Place,.Wrong.Time.HDTV.XviD-NoTV.avi')  # doctest: +ALLOW_UNICODE
            MatchesDict([('title', 'Treme'), ('season', 1), ('episode', 3), ('episode_title', 'Right Place, Wrong Time'), ('format', 'HDTV'), ('video_codec', 'XviD'), ('release_group', 'NoTV'), ('container', 'avi'), ('mimetype', 'video/x-msvideo'), ('type', 'episode')])
        
        ``MatchesDict`` is a dict that keeps matches ordering.
        
        Command line options can be given as dict or string to the second argument.
        
        GuessIt only accept unicode string, so you need to use ``u`` prefix for input string on python 2.
        
        Support
        -------
        
        This project is hosted on `GitHub <https://github.com/wackou/guessit>`_. Feel free to open an issue if you think you
        have found a bug or something is missing in guessit.
        
        GuessIt relies on `Rebulk <https://github.com/Toilal/rebulk>`_ project for pattern and rules registration.
        
        License
        -------
        
        GuessIt is licensed under the `LGPLv3 license <http://www.gnu.org/licenses/lgpl.html>`_.
        
        
        History
        =======
        
        2.0rc4 (2015-12-03)
        -------------------
        
        - Add docs.
        - Add exotic `screen_size` patterns support like `720hd` and `720p50`.
        - Rename `audio_codec` value `true-HD` to `trueHD`.
        
        
        2.0rc3 (2015-11-29)
        -------------------
        
        - Add ``__version__`` to main module.
        
        
        2.0rc2 (2015-11-28)
        -------------------
        
        - Single digit episodes are now guessed for ``--type episode`` instead of ``--episode-prefer-number``.
        - Fix separators that could cause some titles to be splited with & and ;.
        - Avoid possible ``NoneType`` error.
        
        
        2.0rc1 (2015-11-27)
        -------------------
        
        - Fallback to default title guessing when ``expected-title`` is not found.
        
        
        2.0b4 (2015-11-24)
        ------------------
        
        - Add ``expected-group`` option.
        - Add validation rule for single digit ``episode`` to avoid false positives.
        - Add ``verbose`` option.
        - Fix ``expected-title`` option.
        - Better unicode support in ``expected-group``/``expected-title`` option.
        
        
        2.0b3 (2015-11-15)
        ------------------
        
        - Add support for ``part`` with no space before number.
        - Avoid ``uuid`` and ``crc32`` collision with ``season``/``episode`` properties.
        - Add better space support for ``season``/``episode`` properties.
        - Ensure ``date`` property is found when conflicting with ``season``/``episode`` properties.
        - Fix ``IndexError`` when input has a closing group character with no opening one before.
        - Add ``--type`` option.
        - Add rebulk implicit option support.
        
        2.0b2 (2015-11-14)
        ------------------
        
        - Add python 2.6 support.
        
        
        2.0b1 (2015-11-11)
        ------------------
        
        - Enhance title guessing.
        - Upgrade rebulk to ``0.6.1``.
        - Rename ``properCount`` to ``proper_count``
        - Avoid crash when using ``-p``/``-V`` option with ``--yaml`` and ``yaml`` module is not available.
        
        2.0a4 (2015-11-09)
        ------------------
        
        - Add ``-p``/``-V`` options to display properties and values that can be guessed.
        
        
        2.0a3 (2015-11-08)
        ------------------
        
        - Allow rebulk customization in API module.
        
        2.0a2 (2015-11-07)
        ------------------
        
        - Raise TypeError instead of AssertionError when non text is given to guessit API.
        - Fix packaging issues with previous release blocking installation.
        
        2.0a1 (2015-11-07)
        ------------------
        
        - Rewrite from scratch using `Rebulk <https://www.github.com/Toilal/rebulk>`_
        - Read `MIGRATION.rst <https://github.com/wackou/guessit/blob/master/MIGRATION.rst>`_ for migration guidelines.
        
Keywords: python library release parser name filename movies series episodes animes
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Multimedia
Classifier: Topic :: Software Development :: Libraries :: Python Modules
