Metadata-Version: 2.1
Name: tracker-scraper
Version: 1.0.0
Summary: A simple torrent tracker scraper
Home-page: https://github.com/modbender/tracker-scraper
Author: Yashas H R
Author-email: rameshmamathayashas@gmail.com
License: UNKNOWN
Description: # Tracker Scraper
        [![Downloads](https://pepy.tech/badge/tracker-scraper)](https://pepy.tech/project/tracker-scraper)
        
        A simple torrent tracker scraper
        
        **NOTE: Currently not working for http trackers (you can try but all my test cases gave bencode error), works for udp trackers. Working on fixing http tracker scrape, any valid help accepted.**
        
        ## Installation
        `pip install tracker-scraper`
        
        ## Usage
        ```python
        from tracker_scraper import scrape
        scrape(
          tracker='udp://exodus.desync.com:6969',
          hashes=[
            "2d88e693eda7edf3c1fd0c48e8b99b8fd5a820b2",
            "8929b29b83736ae650ee8152789559355275bd5c"
          ]
        )
        ```
        
        `scrape` Returns the list of seeds, peers and downloads a torrent info_hash has, according to the specified tracker
        
        Args:  
        - `tracker` (str): The announce url for a tracker, usually taken directly from the torrent metadata.  
        - `hashes` (list): A list of torrent info_hash's to query the tracker for
        
        Returns:  
        A dict of dicts. The key is the torrent info_hash's from the 'hashes' parameter,
        and the value is a dict containing "seeds", "peers" and "complete".
        
        #### Example:
        ```json
        {
          "2d88e693eda7edf3c1fd0c48e8b99b8fd5a820b2" : { "seeds" : "34", "peers" : "189", "complete" : "10" },
          "8929b29b83736ae650ee8152789559355275bd5c" : { "seeds" : "12", "peers" : "0", "complete" : "290" }
        }
        ```
        
        ## Credits
        Code taken from project [m2t](https://github.com/erindru/m2t/blob/master/m2t/scraper.py) by Erin Drummond ([erindru](https://github.com/erindru)). Originally written in Python 2.7, updated code to Python 3+ and now using requests
        
Platform: any
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.5
Description-Content-Type: text/markdown
