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-2.0.1.tar.gz (4.5 kB view details)

Uploaded Source

Built Distribution

fido-2.0.1-py2-none-any.whl (5.0 kB view details)

Uploaded Python 2

File details

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

File metadata

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

File hashes

Hashes for fido-2.0.1.tar.gz
Algorithm Hash digest
SHA256 16e0426c90ec54d84e13a8252248c30e88dafe90042c786dfff69c79bf0ac93a
MD5 adea681c26334287d20653316c2aee06
BLAKE2b-256 61c69eb8e43cdbf3f64e6cb6ee85c57b517cb058e98baa3486de4fcab980f802

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fido-2.0.1-py2-none-any.whl
Algorithm Hash digest
SHA256 22c62c22005f3c52bdf9c68e9fe9ed1cc99f8be7f22f0cf8c413bee876bbb97e
MD5 e4583dba25266231530239656c6fd8d8
BLAKE2b-256 a266370f8f6bb2156c23eec4c309472317465f345720c0dba0cacc23522d8298

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