Skip to content
forked from sparckles/Robyn

Robyn is a fast and extensible async python web server with a rust runtime

License

Notifications You must be signed in to change notification settings

madhavajay/robyn

 
 

Repository files navigation

Robyn Logo

Robyn

Twitter Gitter Downloads Code style: black GitHub tag License Discord

view - Documentation

Robyn is a fast async Python web server with a runtime written in Rust.

Check out the talk at PyCon Sweden 2021 about Robyn: An async python web framework with a Rust runtime

📦 Installation

You can simply use Pip for installation.

pip install robyn

Or, with conda-forge

conda install -c conda-forge robyn

🤔 Usage

from robyn import Robyn

app = Robyn(__file__)

@app.get("/")
async def h(request):
    return "Hello, world!"

app.start(port=8080)

💡 Features

  • Under active development!
  • Written in Rust, btw xD
  • A multithreaded Runtime
  • Extensible
  • A simple API
  • Sync and Async Function Support
  • Dynamic URL Routing
  • Multi Core Scaling
  • WebSockets!
  • Middlewares
  • Hot Reloading
  • Community First and truly FOSS!

🗒️ Contributor Guidelines

Feel free to open an issue for any clarification or for any suggestions.

If you're feeling curious. You can take a look at a more detailed architecture here.

⚙️ To Develop Locally

  1. Install the development dependencies: pip install -r dev-requirements.txt

  2. Install the pre-commit git hooks: pre-commit install

  3. Add more routes in the integration_tests/base_routes.py file (if you like).

  4. Run maturin develop or maturin develop --cargo-extra-args="--features=io-uring" (if you want to run the experimental version).

  5. Run python3 integration_tests/base_routes.py

🏃 To Run

python3 app.py -h

usage: app.py [-h] [--processes PROCESSES] [--workers WORKERS] [--dev DEV]

Robyn, a fast async web framework with a rust runtime.

optional arguments:
  -h, --help            show this help message and exit
  --processes PROCESSES : allows you to choose the number of parallel processes
  --workers WORKERS : allows you to choose the number of workers
  --dev DEV : this flag gives the option to enable hot reloading or not and also sets the default log level to debug
  --log-level LEVEL : this flag allows you to set the log level

✨ Contributors/Supporters

To contribute to Robyn, make sure to first go through the CONTRIBUTING.md.

Thanks to all the contributors of the project. Robyn will not be what it is without all your support ❤️.

Special thanks to the PyO3 community and Andrew from PyO3-asyncio for their amazing libraries and their support for my queries. 💖

✨ Sponsors

These sponsors help us make the magic happen!

DigitalOcean Referral Badge Appwrite Logo

About

Robyn is a fast and extensible async python web server with a rust runtime

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 52.3%
  • Rust 44.4%
  • Shell 2.5%
  • HTML 0.8%