Panther

Is A Fast & Friendly, Web Framework For Building Async APIs With Python 3.11+

Full Documentation -> https://pantherpy.github.io

PyPI -> https://pypi.org/project/panther/

Features

• Document-oriented Databases ODM (PantherDB, MongoDB)
• Visual API Monitoring (In Terminal)
• Cache APIs (In Memory, In Redis)
• Built-in Authentication Classes (Customizable)
• Built-in Permission Classes (Customizable)
• Handle Custom Middlewares

Benchmark

We implemented most of the Python frameworks and sent 25,000 requests per second for 10 seconds (Total 250,000 requests) in the same environment with https://github.com/nakabonne/ali and here's the result:

you can find the detailed results & source codes here --> benchmarks

Installation

• Create a Virtual Environment

  $ python -m venv .venv

• Active The Environment

  * Linux & Mac

  $ source .venv/bin/activate

  * Windows

  $ .\.venv\Scripts\activate

• Install Panther

  * Normal

  $ pip install panther

  * Include JWT Authentication

  $ pip install panther[full]

Usage

• Create Project

  $ panther create <project_name> <directory>

• Run Project

  Panther Uses Uvicorn as ASGI (Asynchronous Server Gateway Interface)

  $ panther run 

• Monitoring Requests

  $ panther monitor 

• Python Shell

  Panther Uses bpython for shell

  $ panther shell 

Example

• You can create project with

  $ panther create myproject

• or create it yourself:

  core/configs.py:

  URLs = 'core/urls.py'

  core/urls.py:

  from app.urls import urls as app_urls
  
  urls = {
      '/': app_urls,
  }

  app/urls.py:

  from app.apis import hello_world, info
  
  urls = {
      '': hello_world,
      'info/': info,
  }

  app/apis.py:

  from datetime import datetime
  
  from panther.app import API
  from panther.configs import config
  from panther import version, status
  from panther.request import Request
  from panther.response import Response
  
  
  @API()
  async def hello_world():
      return {'detail': 'Hello World'}
  
  
  @API(cache=True)
  async def info(request: Request):
      data = {
          'version': version(),
          'datetime_now': datetime.now().isoformat(),
          'user_agent': request.headers.user_agent,
          'db_engine': config['db_engine'],
      }
      return Response(data=data, status_code=status.HTTP_202_ACCEPTED)

• Then run ($ panther run) the project, now you can see these two urls:

  • http://127.0.0.1:8000/

  • http://127.0.0.1:8000/info/

More examples: https://github.com/AliRn76/panther/tree/master/example.