dev(narugo): add limit and page for tag_list API

Author: narugo1992

pybooru/api_danbooru.py

@@ -11,6 +11,8 @@
 # __future__ imports
 from __future__ import absolute_import
 
+import warnings
+
 # pybooru imports
 from .exceptions import PybooruAPIError
 
@@ -988,7 +990,7 @@ def pool_versions(self, updater_id=None, updater_name=None, pool_id=None):
         return self._get('pool_versions.json', params)
 
     def tag_list(self, name_matches=None, name=None, category=None,
-                 hide_empty=None, has_wiki=None, has_artist=None, order=None):
+                 hide_empty=None, has_wiki=None, has_artist=None, order=None, limit=1000, page=1):
         """Get a list of tags.
 
         Parameters:
@@ -1004,15 +1006,21 @@ def tag_list(self, name_matches=None, name=None, category=None,
             has_wiki (str): Can be: yes, no.
             has_artist (str): Can be: yes, no.
             order (str): Can be: name, date, count.
+            limit (int): Limit of one page, no more than 1000.
+            page (int): Page.
         """
+        if limit > 1000:
+            warnings.warn(UserWarning(f'Limit over 1000 is not supported by API, but {limit!r} found.'), stacklevel=2)
         params = {
             'search[name_matches]': name_matches,
             'search[name]': name,
             'search[category]': category,
             'search[hide_empty]': hide_empty,
             'search[has_wiki]': has_wiki,
             'search[has_artist]': has_artist,
-            'search[order]': order
+            'search[order]': order,
+            'limit': str(limit),
+            'page': str(page),
             }
         return self._get('tags.json', params)