Skip to main content

Ellar - Python ASGI web framework for building fast, efficient, and scalable RESTful APIs and server-side applications.

Project description

Ellar Logo

logo by: Azad

Ellar - Python ASGI web framework for building fast, efficient, and scalable RESTful APIs and server-side applications.

Test Coverage PyPI version PyPI version PyPI version

Introduction

Ellar is a lightweight ASGI framework designed to simplify the development of efficient and scalable server-side Python applications. Whether you're building web services, APIs, or full-fledged web applications, Ellar offers a high level of abstraction and powerful features to streamline your development process.

Ellar allows developers to embrace both Object-Oriented Programming (OOP) and Functional Programming (FP) paradigms. It is built on top of Starlette, a renowned ASGI toolkit, ensuring robust asynchronous request-handling capabilities.

Key Features

  • Easy to Use: With an intuitive API, Ellar makes it easy for developers to get started with building fast and scalable Python web applications.
  • Dependency Injection (DI): Ellar includes a built-in DI system, enabling easy management of dependencies and reducing coupling between components.
  • Pydantic Integration: Integrated with Pydantic for seamless data validation, ensuring that input data is always valid.
  • Templating with Jinja2: Built-in support for Jinja2 templates simplifies the creation of dynamic web pages.
  • OpenAPI Documentation: Ellar has built-in support for generating OpenAPI documentation and facilitating API documentation generation with Swagger or ReDoc.
  • Controller (MVC) Architecture: Ellar follows the Model-View-Controller (MVC) pattern, aiding in organizing code and separating concerns.
  • Guards for Authentication and Authorization: Offers built-in support for guards, making it easy to implement authentication and authorization in applications.
  • Modularity: Inspired by NestJS, Ellar follows a modular architecture, allowing developers to organize code into reusable modules.
  • Asynchronous Programming: Leveraging Python's async/await feature, Ellar enables the development of efficient and high-performance applications capable of handling concurrent requests.

Installation

You can install Ellar using pip:

$(venv) pip install ellar

Getting Started

# Example code showcasing Ellar usage
# (Please ensure you have properly installed Ellar first)

import uvicorn
from ellar.common import Body, Controller, ControllerBase, delete, get, post, put, Serializer, Inject
from ellar.app import AppFactory
from ellar.di import injectable, request_scope
from ellar.openapi import OpenAPIDocumentModule, OpenAPIDocumentBuilder, SwaggerUI
from pydantic import Field
from pathlib import Path

# Define a serializer for creating a car
class CreateCarSerializer(Serializer):
    name: str
    year: int = Field(..., gt=0)
    model: str

# Define a service class for car operations
@injectable(scope=request_scope)
class CarService:
    def __init__(self):
        self.detail = 'a service'

# Define a controller for car operations
@Controller
class MotoController(ControllerBase):
    def __init__(self, service: CarService):
        self._service = service
    
    @post()
    async def create(self, payload: Body[CreateCarSerializer]):
        assert self._service.detail == 'a service'
        result = payload.dict()
        result.update(message='This action adds a new car')
        return result

    @put('/{car_id:str}')
    async def update(self, car_id: str, payload: Body[CreateCarSerializer]):
        result = payload.dict()
        result.update(message=f'This action updated #{car_id} car resource')
        return result

    @get('/{car_id:str}')
    async def get_one(self, car_id: str, service: Inject[CarService]):
        assert self._service == service
        return f"This action returns a #{car_id} car"

    @delete('/{car_id:str}')
    async def delete(self, car_id: str):
        return f"This action removes a #{car_id} car"

# Create the Ellar application
app = AppFactory.create_app(
    controllers=[MotoController],
    providers=[CarService],
    base_directory=str(Path(__file__).parent),
    config_module=dict(REDIRECT_SLASHES=True),
    template_folder='templates'
)

# Build OpenAPI documentation
document_builder = OpenAPIDocumentBuilder()
document_builder.set_title('Ellar API') \
    .set_version('1.0.2') \
    .set_contact(name='Author', url='https://www.yahoo.com', email='author@gmail.com') \
    .set_license('MIT Licence', url='https://www.google.com')
document = document_builder.build_document(app)

# Setup OpenAPI documentation module
OpenAPIDocumentModule.setup(
    app=app,
    docs_ui=SwaggerUI(),
    document=document,
    guards=[]
)

# Run the application
if __name__ == "__main__":
    uvicorn.run("main:app", port=5000, reload=True)

Now we can test our API at http://127.0.0.1:5000/docs

You can also try the quick-project setup to get a good idea of the library.

Project Documentation Status

  • Authorization: In progress

Dependency Summary

Ellar has the following dependencies:

  • Python >= 3.8
  • Starlette
  • Pydantic
  • Injector

Contributing

Contributions are Welcome! You can contribute in the following ways.

  • Create an Issue - Propose a new feature. Report a bug.
  • Pull Request - Fix a bug and typo. Refactor the code.
  • Create third-party module - Just like ellar-throttling, ellar-jwt, ellar-sql that can solve common problem in web application development.
  • Share - Share your thoughts on the a Blog, Twitter, and others.
  • Build your application - Please try to use Ellar. For more details, see docs/CONTRIBUTING.md.

Contributors

Thanks to all contributors!

Author

Ezeudoh Tochukwu https://github.com/eadwinCode

License

Ellar is MIT License.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ellar-0.8.6.tar.gz (271.5 kB view details)

Uploaded Source

Built Distribution

ellar-0.8.6-py3-none-any.whl (377.7 kB view details)

Uploaded Python 3

File details

Details for the file ellar-0.8.6.tar.gz.

File metadata

  • Download URL: ellar-0.8.6.tar.gz
  • Upload date:
  • Size: 271.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for ellar-0.8.6.tar.gz
Algorithm Hash digest
SHA256 96bf6b1099d90ecfb7e2310c3318aa4b9026ae93d8c8fb180357b383fd79937b
MD5 9db97bc7deda4d71081e0946ceb057d3
BLAKE2b-256 712a89ae27f3fc6b4cd1ad6533eecbaf2803a32458a00b34c1e612a59993b762

See more details on using hashes here.

File details

Details for the file ellar-0.8.6-py3-none-any.whl.

File metadata

  • Download URL: ellar-0.8.6-py3-none-any.whl
  • Upload date:
  • Size: 377.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for ellar-0.8.6-py3-none-any.whl
Algorithm Hash digest
SHA256 4fda096bd4d81d29e480ec3194ce98d46f06ce60650b1b7b96d3df26b0568c5f
MD5 e4b9eed607c36c2b8c78b27f154e1b22
BLAKE2b-256 20ca2f9dffa03f330c7ff07001b28b76854d87ff271dbb9f0b72b343e6282b99

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