Skip to main content

HTTP/WebSocket proxy for starlette/FastAPI.

Project description

FastAPI Proxy Lib

HTTP/WebSocket proxy for starlette/FastAPI

CI/CD CI: lint-test pre-commit.ci status
CI: docs CI: publish
Code codecov Code style: black Ruff Checked with pyright
Package PyPI - Version PyPI - Downloads PyPI - Python Version
Meta Hatch project GitHub License

Documentation: https://wsh032.github.io/fastapi-proxy-lib/

Source Code: https://github.com/WSH032/fastapi-proxy-lib/


Features

  • Out of the box ! Helper functions to get FastAPI app/router for proxy conveniently.
  • Only Starlette is required for it to work (FastAPI is optional).
  • Support both HTTP and WebSocket proxy.
    • Supports all HTTP methods (GET, POST, etc.)
  • Support both reverse proxy and forward proxy.
  • Transparently and losslessly handle all proxy requests, Including HTTP headers, cookies, query parameters, body, etc.
  • Asynchronous streaming transfer, support file proxy.

other features

  • Strict linting and strict-mode Pyright type checking.
  • 100% Type Completeness, Code coverage of over 95%.
  • Forced keep-alive connections, minimizing proxy latency.
  • Handle errors as gracefully as possible.
    • fastapi-proxy-lib has a well-designed mechanism behind the scenes to handle exceptional websocket disconnections for you.
    • fastapi-proxy-lib will exit as gracefully as possible.

FastAPI Proxy Lib stands on the shoulders of giants

So, it perfectly supports all features of httpx.AsyncClient, you can even use your custom AsyncClient, Transport.

except cookies and base_url arguments, which are taken over by fastapi-proxy-lib

Installation

!!! note

We follow semantic versioning.<br>
This is a young project, and before 1.0.0, there may be changes in the API (we try to avoid that).<br>
We will release security updates at any time, please try to keep the version updated, instead of pinning to the old version.<br>
pin to `major version` is recommended.<br>
visit our `CHANGELOG.md` for more info.
pip install fastapi-proxy-lib

Perhaps you've noticed that we're installing fastapi-proxy-lib[standard] instead of fastapi-proxy-lib. The difference is:

  • The former will install FastAPI at the same time.
  • The latter installs only the basic dependencies for fastapi-proxy-lib.

If you only need to use this library with Starlette, you only need to install the latter.

Quick start

With the helper functions, get the FastAPI proxy server app is very convenient and out of the box:

from fastapi_proxy_lib.fastapi.app import reverse_http_app

app = reverse_http_app(base_url="http://www.example.com/foo/")

That's all! Now, you can launch the proxy server with uvicorn:

uvicorn main:app  --host 127.0.0.1 --port 8000

Then, visit http://127.0.0.1:8000/bar?baz=1, you will get the response from http://www.example.com/foo/bar?baz=1.

Continue, please visit to our documentation 📚 for more details:

  • support for FastAPI router
  • only Starlette dependency
  • WebSocket proxy

development

English is not the native language of the author (me), so if you find any areas for improvement in the documentation, your feedback is welcome.

If you think this project helpful, consider giving it a star GitHub Repo stars, which makes me happy. :smile:

License

This project is licensed under the terms of the Apache License 2.0.

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

fastapi_proxy_lib-0.1.0.tar.gz (60.5 kB view hashes)

Uploaded Source

Built Distribution

fastapi_proxy_lib-0.1.0-py3-none-any.whl (40.9 kB view hashes)

Uploaded Python 3

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