Requests Wrapper¶
The darc.requests
module wraps around the requests
module, and provides some simple interface for the darc
project.
-
darc.requests.
default_user_agent
(name='python-darc', proxy=None)[source]¶ Generates the default user agent.
-
darc.requests.
i2p_session
(futures=False)[source]¶ I2P (.i2p) session.
- Parameters
futures (bool) – If returns a requests_futures.FuturesSession.
- Returns
The session object with I2P proxy settings.
- Return type
Union[requests.Session, requests_futures.FuturesSession]
See also
darc.proxy.i2p.I2P_REQUESTS_PROXY
-
darc.requests.
null_session
(futures=False)[source]¶ No proxy session.
- Parameters
futures (bool) – If returns a requests_futures.FuturesSession.
- Returns
The session object with no proxy settings.
- Return type
Union[requests.Session, requests_futures.FuturesSession]
-
darc.requests.
request_session
(link, futures=False)[source]¶ Get requests session.
- Parameters
link (darc.link.Link) – Link requesting for requests.Session.
futures (bool) – If returns a requests_futures.FuturesSession.
- Returns
The session object with corresponding proxy settings.
- Return type
Union[requests.Session, requests_futures.FuturesSession]
- Raises
UnsupportedLink – If the proxy type of
link
if not specified in theLINK_MAP
.
See also
darc.proxy.LINK_MAP
-
darc.requests.
tor_session
(futures=False)[source]¶ Tor (.onion) session.
- Parameters
futures (bool) – If returns a requests_futures.FuturesSession.
- Returns
The session object with Tor proxy settings.
- Return type
Union[requests.Session, requests_futures.FuturesSession]
See also
darc.proxy.tor.TOR_REQUESTS_PROXY