Metadata-Version: 1.1
Name: python-nnmclub
Version: 1.0
Summary: Python library to search torrents on popular russian torrent tracker.
Home-page: https://github.com/sashgorokhov/python-nnmclub
Author: sashgorokhov
Author-email: sashgorokhov@gmail.com
License: MIT License
Download-URL: https://github.com/sashgorokhov/python-nnmclub/archive/master.zip
Description: python-nnmclub
        **************
        
        .. image:: https://badge.fury.io/py/python-nnmclub.svg
            :target: https://badge.fury.io/py/python-nnmclub
        
        Python library to search torrents on popular russian torrent tracker.
        
        Installation
        ============
        
        Via pip:
        
        .. code-block:: shell
        
            pip install python-nnmclub
        
        Usage
        =====
        
        .. code-block:: python
        
            import pynnmclub
            nnmclub = pynnmclub.NNMClub()
            results = nnmclub.search("Iron Man")
        
        Return an iterable with dicts of all torrents found.
        
        Torrent dict is:
        
        .. code-block:: python
        
            {
                'topic',
                'detail_url',
                'download_url',
                'size',  # in bytes
                'seeders',
                'leechers',
                'added',  # type: datetime.datetime
                'views',
                'messages',
                'rating_number',  # how many people rated this,
                'rating',  # rating. float from 0 to 5
                'thanks',  # how many people thanked this torrent
            }
        
        NOTE: With unathorized client you will be able to fetch only first 50 results of search.
        
        Create an authorized client:
        
        .. code-block:: python
        
            nnmclub = pynnmclub.NNMClub(username, password)
        
        Or using previously created nnmclub client:
        
        .. code-block:: python
        
            nnmclub.login(username, password)
        
        If username or password are invalid, whis will raise an ``pynnmclub.InvalidCredentials`` error
        (which is child to ``pynnmclub.NNMClubError``)
        
        There is also a logger ``pynnmclub`` enabled that logs exceptions and warnings of parsing errors.
        It also includes a full HTML of errored context as a DEBUG message.
        
        .. :changelog:
        
        History
        -------
        
        1.0.0 (2016-05-13)
        ++++++++++++++++++
        
        * Fixed setup.py requires option (changed to install_requires)
        * Version bump
        
        0.1.0 (2016-04-11)
        ++++++++++++++++++
        
        * Initial PyPI release
Keywords: nnm-club,nnmclub,torrent
Platform: UNKNOWN
