Skip to main content

A proxy and aggregator for querying multiple instances of an API spread across globally distributed data centers.

Project description

A fast and performant proxy and aggregator for querying multiple instances of an API spread across globally distributed data centers.

https://travis-ci.org/rackerlabs/curryproxy.png

Capabilities

  • CurryProxy can handle multiple routes for use against different revisions of an API or for use against completely unrelated APIs. See etc/routes.sample.yaml for an example configuration.

  • Simple request forwarding (useful for preserving backwards compatability with pre-CurryProxy versions of an API hosted in a single datacenter)

    • Example: GET https://api.example.com/v1.0/foo/bar forwarded to GET https://1.api.example.com/v1.0/foo/bar

  • Advanced request forwarding to multiple endpoints

    • Example: GET https://api.example.com/1,2/v1.0/foo/bar forwarded to the following:

      • GET https://1.api.example.com/v1.0/foo/bar

      • GET https://2.api.example.com/v1.0/foo/bar

    • Requests are made in parallel

    • JSON responses received from multiple endpoints are aggregated and returned to the client

      • Example: {"foo": 1} received from 1 and {"bar": 2} received from 2 are aggregated to [{"foo": 1}, {"bar": 2}] and returned to the client

    • Rich, meaningful errors logged and returned to the client when a proxied request fails

Installation

pip install curryproxy will do what you expect.

There are a couple of extra options:

  • pip install curryproxy[tests]. This will install any packages required to run the tests.

  • pip install curryproxy[frozen]. This will install curryproxy with explicitly pinned dependencies, as generated by pip freeze. This is intended as a convenience for those who want the package to provide a reproducible environment. The versions used will be the latest working ones at the time the given Curry version was released.

You will need to provide configuration files before starting Curry.

NOTE: The configuration files have changed in v2.x. routes.json and logging.conf have become routes.yaml and logging.yaml respectively. See the sample files for examples.

Limitations

Testing

Tests are set up to run with tox.

The default tox setup creates environments for each known-usable version of each of our dependencies, and runs the tests in each of them. That amounts to around a dozen environments at the moment, so you’ll probably want to run them in parallel with tox -p auto.

If you don’t want to be that thorough (perhaps you’re smoke testing a work in progress), you can run against only the most recent supported versions of dependencies with tox -e py36.

You can test against specific dependency versions like this:

tox -e py36-requests2.{2,3,4,5,6,7} -p auto
tox -e py36-webob1.{2,3,4,5} -p auto
tox -e py36-grequests0.{2,3} -p auto
tox -e py36-requests.latest

tox -e lint is also available, and will run various linting checks.

Roadmap

  • OData support for server-side ordering and paging

  • Response caching for a specified time

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

curryproxy-2.1.1.tar.gz (38.3 kB view details)

Uploaded Source

Built Distribution

curryproxy-2.1.1-py3-none-any.whl (28.8 kB view details)

Uploaded Python 3

File details

Details for the file curryproxy-2.1.1.tar.gz.

File metadata

  • Download URL: curryproxy-2.1.1.tar.gz
  • Upload date:
  • Size: 38.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.10

File hashes

Hashes for curryproxy-2.1.1.tar.gz
Algorithm Hash digest
SHA256 f9b18607f5496dc004f80d5b4a1a538ed81202029d63a489c5b07c6926d65ef2
MD5 79a66a06b1b615248d64db991fbf25e5
BLAKE2b-256 3e0404568f6ba991023c919302b95afdaaa2729c04a822486b3c8c87c0ed9438

See more details on using hashes here.

File details

Details for the file curryproxy-2.1.1-py3-none-any.whl.

File metadata

  • Download URL: curryproxy-2.1.1-py3-none-any.whl
  • Upload date:
  • Size: 28.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.10

File hashes

Hashes for curryproxy-2.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f4d8e6a560b7c601c19c3de4d36bab6143962e39921487e0cee2cd45b3e60ff0
MD5 e84c1bf317982530655e230a0fa5ddaf
BLAKE2b-256 0d59d76c3d0b68a1a3754aa46054c9adc689068d4de3b82eb062001735919488

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