aboutsummaryrefslogtreecommitdiffstats
path: root/tpblite/tpblite.py
diff options
context:
space:
mode:
Diffstat (limited to 'tpblite/tpblite.py')
-rw-r--r--tpblite/tpblite.py69
1 files changed, 47 insertions, 22 deletions
diff --git a/tpblite/tpblite.py b/tpblite/tpblite.py
index a2a927d..3c68d62 100644
--- a/tpblite/tpblite.py
+++ b/tpblite/tpblite.py
@@ -1,34 +1,59 @@
+from typing import Optional
+
from .models.torrents import Torrents, Torrent
from .models.utils import QueryParser
-class TPB(object):
-
- def __init__(self, base_url='https://tpb.party'):
- '''ThePirateBay Object
+
+class TPB:
+
+ def __init__(self, base_url: str = "https://tpb.party"):
+ """ThePirateBay Object
Args:
base_url (str): PirateBay URL to use for queries
- Attributes:
- search_url (str): This is the compiled search string used
- to query the PirateBay URL, modified when calling search
- method
- '''
+ """
+ # PirateBay URL to use for queries
self.base_url = base_url
- self.search_url = None
-
- def __str__(self):
- return 'TPB Object, base URL: {}'.format(self.base_url)
-
- def search(self, query, page=0, order=99, category=0):
- '''Search ThePirateBay and retturn list of Torrents
+
+ # Compiled search string used to query the PirateBay URL
+ self._search_url: Optional[str] = None
+
+ def __str__(self) -> str:
+ return "TPB Object, base URL: {}".format(self.base_url)
+
+ def search(
+ self, query: str, page: int = 0, order: int = 99, category: int = 0
+ ) -> Torrents:
+ """Search ThePirateBay and return list of Torrents
Args:
- query (str): Search string to query ThePirateBay
- page (int): page number to grab results from
+ query: Search string to query ThePirateBay
+ page: page number to grab results from
order TODO
category TODO
- '''
- q = QueryParser(query, self.base_url, page, order, category)
- self.search_url = q.url
- return Torrents(query, q.html_source) \ No newline at end of file
+
+ Return:
+ Torrents
+
+ """
+ q = QueryParser.search(query, self.base_url, page, order, category)
+ self._search_url = q.url
+ return Torrents(q.html_source)
+
+ def browse(self, category: int = 0, page: int = 0, order: int = 99) -> Torrents:
+ """Browse ThePirateBay and return list of Torrents
+
+ Args:
+ query: Search string to query ThePirateBay
+ page: page number to grab results from
+ order TODO
+ category TODO
+
+ Return:
+ Torrent
+
+ """
+ q = QueryParser.browse(self.base_url, category, page, order)
+ self._search_url = q.url
+ return Torrents(q.html_source)