begs 0.1.4

A partial rewrite of the famous requests library with a better defaults and certificate handling

begs

A partial rewrite of the famous requests library with a better defaults and certificate handling

begs is a from-scratch rewrite of the python request library. It is API-compatible with requests, but has some improvements.

Why you should consider using begs over requests:

• It is much lighter. While requests (314 KB) depends on urllib3 (660 KB), certifi (257 KB), idna (467 KB) and charset-normalizer (220 KB), begs has no dependencies and is less than 20 KB, making it a great choice for use in packages where size matters.
• The requests library does not support using the built-in system certificate store - relying instead on the hard-coded ssl certificates in the certifi library. This makes distribution to systems located behind SSL-proxy firewalls with self-signed certificates a nightmare. begs supports the system certificate store by default, and makes appending additional certificates to the trusted CA list a breeze.
• The requests library has a long-standing issue of allowing users to shoot themselves in the foot by not providing a default timeout. begs has a very reasonable 30 second timeout which can be adjusted as-needed.
• begs also supports various retry options, and will even automatically retry in situations where it can be determined that a retry would be safe and idempotent (such as a 503 response to a POST, or a 504 response to a GET)

Getting Started:

import begs

begs.get('http://microsoft.com')

It's that easy!

More Examples:

import begs

# auto-decode json
req = begs.post('https://httpbin.org/post', data={'foo': 'bar'}, params={'me': 'you'})
print(req.json())

# get the response body as text
req = begs.get('https://httpbin.org/ip')
print(req.text)

# get the resonse headers as a dict
req = begs.get('https://google.com')
print(req.headers)

Adding a trusted Certificate Authority:

import begs

# this will set a ssl context for all future begs requests
begs.default_ssl_context.load_verify_locations('badssl-ca.cer')

# would normally raise an ssl exception, but won't now.
result = begs.get('https://untrusted-root.badssl.com/')

#################################################################################################

import ssl
custom_context = ssl.create_default_context() # you can also specify your own ssl context per-request
result = begs.get('https://untrusted-root.badssl.com/', ssl_context=custom_context)

Retries:

import begs

# this request will fail after 4 attempts (0 seconds, 1 second, 2 seconds, 4 seconds)
# getaddrinfo failed exception
begs.get('http://something-that-doesnt-exist.internal', retries=3, retry_delay=1, retry_backoff=2, force_retry=True)