Skip to main content

Intelligent asynchronous HTTP client

Project description

https://travis-ci.org/Yelp/fido.svg?branch=master https://coveralls.io/repos/Yelp/fido/badge.svg PyPi version

Introduction

Fido is a simple, asynchronous HTTP client built on top of Crochet, Twisted and concurrent.futures. It is intended to be used in environments where there is no event loop, and where you cannot afford to spin up lots of threads (otherwise you could just use a ThreadPoolExecutor).

Here is an example of using Fido:

future = fido.fetch('http://www.foo.bar')
# Work happens in a background thread...
response = future.result(timeout=2)
print response.body

Frequently Asked Questions

Do you support SSL?

Yes, although this has not been vetted by security professionals. One should use this functionality at their own risk. In more detail: Fido uses the Twisted defaults, which delegate to pyOpenSSL and service_identity for the actual SSL work.

Is the API stable?

Probably not. However, it is currently very simple, so it shouldn’t be hard to upgrade code if there’s a non backwards-compatible change.

Do I need to initialize Crochet?

No, crochet.setup is automatically invoked by fido.fetch.

How do I use an http_proxy?

Just set the http_proxy (all lowercase) environment variable to the URL of the http proxy before starting your python process.

Example:

$ export http_proxy="http://localhost:8000"
$ python -c "import fido; print fido.fetch("http://www.yelp.com").result().body

Installation

Fido can be installed using pip install, like so:

$ pip install --upgrade fido

License

Copyright (c) 2015, Yelp, Inc. All rights reserved. Apache v2

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fido-1.1.1.tar.gz (4.3 kB view details)

Uploaded Source

Built Distribution

fido-1.1.1-py2-none-any.whl (4.5 kB view details)

Uploaded Python 2

File details

Details for the file fido-1.1.1.tar.gz.

File metadata

  • Download URL: fido-1.1.1.tar.gz
  • Upload date:
  • Size: 4.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for fido-1.1.1.tar.gz
Algorithm Hash digest
SHA256 55418412b57e15c05ba2c3fd6a1e42eefb482a927f141450e062e749c5be2229
MD5 5a287b17f60078c679c4c1e8c22c11ea
BLAKE2b-256 368eab8427b1c6ef2bf92aad9285d5385268579941ffc92893ab57029e0aa2a4

See more details on using hashes here.

File details

Details for the file fido-1.1.1-py2-none-any.whl.

File metadata

File hashes

Hashes for fido-1.1.1-py2-none-any.whl
Algorithm Hash digest
SHA256 b7e7037f7540e966ecba708409a8db5e9d8d81fc48f3085630ff62ae6aba3c5f
MD5 d744fdebe4997e270a24e3d7aec24a1d
BLAKE2b-256 3f14235a655a828f60bdd665cc5a250ebf53e3313c9205317ed30c91e38a97a9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page