Data

Tools

Indexes

Applications

Experiments

Open Source Science

fido

Asynchronous HTTP client built on top of Crochet and Twisted

https://github.com/yelp/fido

Science Score: 20.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ○
    codemeta.json file
  • ○
    .zenodo.json file
  • ○
    DOI references
  • ✓
    Academic publication links
    Links to: acm.org
  • ✓
    Committers with academic emails
    2 of 19 committers (10.5%) from academic institutions
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (13.7%) to scientific vocabulary
Last synced: 11 months ago · JSON representation

Repository

Asynchronous HTTP client built on top of Crochet and Twisted

Basic Info
  • Host: GitHub
  • Owner: Yelp
  • License: other
  • Language: Python
  • Default Branch: master
  • Homepage:
  • Size: 109 KB
Statistics
  • Stars: 20
  • Watchers: 19
  • Forks: 18
  • Open Issues: 8
  • Releases: 0
Created over 11 years ago · Last pushed over 5 years ago
Metadata Files
Readme Changelog License

README.rst 

Fido
********
.. image:: https://travis-ci.org/Yelp/fido.svg?branch=master
    :target: https://travis-ci.org/Yelp/fido

.. image:: https://coveralls.io/repos/Yelp/fido/badge.svg
  :target: https://coveralls.io/r/Yelp/fido

.. image:: https://img.shields.io/pypi/v/fido.svg
  :target: https://pypi.python.org/pypi/fido/
  :alt: PyPI version

.. image:: https://img.shields.io/pypi/pyversions/fido.svg
  :target: https://pypi.python.org/pypi/fido/
  :alt: Supported Python versions
  
Fido is now RETIRED, meaning that it will no longer be updated. Please consider using other libraries such as aiohttp.

Introduction
============

Fido is a simple, asynchronous HTTP client built on top of Crochet_ and Twisted_ with an implementation inspired by the book_ "Twisted Network Programming Essentials".  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.example.com')
    # Work happens in a background thread...
    response = future.wait(timeout=2)
    print(response.body)

Frequently Asked Questions
==========================

Do you support TLS?
-------------------

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 TLS work.

Note that to get this you need to install the `tls` extra::

    $ pip install --upgrade fido[tls]

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.example.com").wait().body)'



Installation
=============

Fido can be installed using `pip install`, like so::

    $ pip install --upgrade fido

If you want TLS capabilities::

    $ pip install --upgrade fido[tls]

License
========

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


.. _Crochet: https://github.com/itamarst/crochet
.. _crochet.setup: https://crochet.readthedocs.org/en/latest/api.html#setup
.. _Twisted: https://twistedmatrix.com/trac/
.. _concurrent.futures: http://pythonhosted.org/futures/
.. _ThreadPoolExecutor: http://pythonhosted.org/futures/#threadpoolexecutor-objects
.. _pyOpenSSL: https://github.com/pyca/pyopenssl
.. _service_identity: https://github.com/pyca/service_identity
.. _book: http://dl.acm.org/citation.cfm?id=1205685

Owner

  • Name: Yelp.com
  • Login: Yelp
  • Kind: organization
  • Location: San Francisco

GitHub Events

Total
Last Year

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 92
  • Total Committers: 19
  • Avg Commits per committer: 4.842
  • Development Distribution Score (DDS): 0.696
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Luca Giovagnoli l****a@y****m 28
Semir Patel s****l@y****m 17
Prateek Agarwal a****l@y****m 10
Stephan Jaensch s****h@y****m 8
Samuele Maci m****e@g****m 6
Anthony Sottile a****e@u****u 5
Ben Bariteau f****1@g****m 2
Benjamin Picolo b****p@y****m 2
John Billings b****s@y****m 2
Daniel Frei f****i@y****m 2
Mayank Sindwani m****n@y****m 2
Joseph Lynch j****h@m****u 1
Ben Plotnick b****k@g****m 1
Jeffrey Ying j****6@l****m 1
ClareCat c****l@h****m 1
Joseph Lynch j****h@y****m 1
Luca Giovagnoli l****0@g****m 1
Francesco Agosti f****a@y****m 1
Semir Patel a****e@y****m 1
Committer Domains (Top 20 + Academic)
yelp.com: 10 mit.edu: 1 umich.edu: 1

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 22
  • Total pull requests: 43
  • Average time to close issues: about 2 months
  • Average time to close pull requests: 15 days
  • Total issue authors: 11
  • Total pull request authors: 15
  • Average comments per issue: 0.64
  • Average comments per pull request: 3.35
  • Merged pull requests: 39
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • prat0318 (6)
  • lucagiovagnoli (3)
  • analogue (3)
  • evenitz (2)
  • jolynch (2)
  • Jefftree (1)
  • bxm156 (1)
  • asottile (1)
  • jangsutsr (1)
  • fragosti (1)
  • benbariteau (1)
Pull Request Authors
  • analogue (9)
  • lucagiovagnoli (8)
  • asottile (5)
  • prat0318 (4)
  • sjaensch (3)
  • macisamuele (3)
  • benbariteau (2)
  • msindwan (2)
  • bplotnick (1)
  • fragosti (1)
  • jolynch (1)
  • frei0 (1)
  • bpicolo (1)
  • Jefftree (1)
  • XOyarz (1)
Top Labels
Issue Labels
enhancement (4) wontfix (1) bug (1)
Pull Request Labels
enhancement (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 19,346 last-month
  • Total dependent packages: 2
  • Total dependent repositories: 8
  • Total versions: 17
  • Total maintainers: 1
pypi.org: fido

Intelligent asynchronous HTTP client

  • Versions: 17
  • Dependent Packages: 2
  • Dependent Repositories: 8
  • Downloads: 19,346 Last month
Rankings
Downloads: 3.0%
Dependent packages count: 3.1%
Dependent repos count: 5.2%
Average: 6.7%
Forks count: 8.9%
Stargazers count: 13.3%
Maintainers (1)
yelplabs
Last synced: 11 months ago

Dependencies

requirements-dev.txt pypi
  • coverage * development
  • flake8 * development
  • mock * development
  • pytest * development
setup.py pypi
  • crochet *
  • six *
  • yelp_bytes *