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

Uploaded Source

Built Distribution

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

Uploaded Python 2

File details

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

File metadata

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

File hashes

Hashes for fido-1.1.2.tar.gz
Algorithm Hash digest
SHA256 df8a3eec8327383115f0ea82e5d51d827175a31b79a28c28d88d9f3997298ce2
MD5 b2f3a3263d50f588879aed008be2c174
BLAKE2b-256 a1df796963d84d22ec6ae57d2a3896bad3debf3547410728176747c1da1438c7

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fido-1.1.2-py2-none-any.whl
Algorithm Hash digest
SHA256 a949b0264f701a1f8a595bc4b4195321ccad45256cd5e1fff3e619f79f75af7d
MD5 cca5789eeb778c72b896b450a9c4e2b6
BLAKE2b-256 b618466bd9504bde6cabaf9197f4e7560bba1b1ae26601648ccaa8337325ce15

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