poet-api 3.0.0

Requests for all

poet-api

Requests with Limiter.

Uses pyrate_limiter.SQLiteBucket with use_file_lock=True.

It can handle many connections concurrently and respect the chosen limits per_second, per_minute, per_day.

class Communicate

init

• session: requests.Session (Required)
• caller_name: str (limiter id) (Required)
• per_second: int = 1
• per_minute: int = 56
• per_day: Optional[int] = None
• stream: bool = False
• timeout: Union[float, tuple] = 5
• allow_redirects: bool = True

send

• method: str (Required)
• url: str (Required)
• headers: Optional[dict] = None (default headers are sent if None)
• **kwargs (accepted by requests.Request)

Examples

• Simplest (by default: 56 requests per minute, 1 request per second):

  from api import Communicate
  from requests import Session
  
  session = Session()
  
  response = Communicate(session=session, caller_name="simple_john").send(
      method="GET", url="https://john-site.com"
  )
  

• With custom limits and custom headers:

  from api import Communicate
  from requests import Session
  
  session = Session()
  headers = {"User-Agent": ("My Dear Agent v.1")}
  
  response = Communicate(session=session, caller_name="John", per_minute=6).send(
      method="GET", url="https://mysite.com", headers=headers
  )