atila 0.11.0.2

Atila Framework

Atila

Atila is simple and minimal framework integrated with Skitai App Engine. It is the easiest way to make backend services.

# serve.py
from atila import Atila

app = Atila (__name__)

@app.route ("/")
def index (was):
    return "Hello, World"

if __mame__ == "__main__":
    import skitai
    skitai.mount ("/", app)
    skitai.run (port = 5000)

And run,

python3 serve.py

Important Notice

CAUTION: Atila is base on WSGI but can be run only with Skitai App Engine.

This means if you make your Atila app, you have no choice but Skitai as WSGI app server. And Atila's unique and unconventional style may become very hard work to port to other framework.

Table of Content

• Atila
• Important Notice
• Unconventional?
• Installation
• First App
  • Project Structure
  • Launch Script
  • Create App
  • Templates
  • Cascaded Service Mount
  • Seperate '/sub' as sub module.
  • Add new '/sub2' as sub package
  • Other Hooks
  • More About Preference
  • Conclusion
• App Overview
  • Event Bus
    • App Life Cycle Events
  • Extending and Overriding
    • Extending
    • Overriding
    • Conclusion
  • Interval Base App Maintenancing
  • Working With Multiple Apps
    • Event Subscription
    • Data Exchanging
    • Accesing Other App Directly
  • Very First Argument 'was'
    • Request
    • Responses
    • Coroutines
• Processing Request
  • Request Life Cycle Hooks
  • Request Life Cycle Events
  • App & Request Gloabal
  • Request Object
    • Basic Members
    • Basic Methods
    • Route Options
  • Environment Variables
  • Routing
  • Request Parameters
  • Parameter and Validation
  • File Upload
  • Streaming Request Data
  • Cookie
  • Session
    • Namespaced Session
  • Message Box
  • Piping
  • Making URL
  • Helpers
    • Testing
    • Authorization & Authentification
    • Conditional Prework
    • Run Pre/Postworks Chain
  • CORS (Cross Origin Resource Sharing) and Preflight
• Using Task
  • Resource Aliasing
  • Task
    • HTTP Based Protocols
    • PostgreSQL / SQLite3
    • MongDB
    • Redis
    • Thread / Process / Subrocess
    • Mask
  • Tasks
  • Generator Based Coroutine
  • Map / Load-Balancing
  • Cache Control
  • Adding Custom Database Interface For Atila Coroutine
• Making Response
  • Cache Control
  • HTTP Error
    • Custom Error Handlers
  • Primitive
    • String
    • API Response
    • Rendered Template
    • render_or_API
    • File
    • Static
    • Generator
    • Redirecting
    • RPC Response
    • ProxyPass
    • ThreadPass
    • Threaded Data Streaming
  • Coroutine
    • Task / Tasks
    • Map
    • Mapped
    • Couroutine Streaming
    • Bidirectional Streaming
• Helpers of 'was'
  • Logging and Traceback
  • Cross Site Request Forgery Token (CSRF Token)
  • JWT Token
  • One-Time Password
  • One-Time Token
• Websocket
  • WS_COROUTINE
  • WS_CHANNEL
    • WS_THREAD
    • WS_THREADSAFE
    • WS_NOTHREAD
• Test Client
• Your Life Is So Precious
  • Integrating Django Models and Administrative Views
  • Integrating pytest and API Documentation
• Change Log

Unconventional?

Atila is based on WSGI specification but take some advantage of asynchronous features which are provided from Skitai.

Atila is mostly same as other WSGI containers for functional and API aspect.

Otherwise Atila has asynchronous features but it does not use async/await conventions. it sometime use generator base coroutine with yeild.

Atila treats async jobs like these as a Task.

• HTTP Request
• Database Query
• Thread
• Process
• Subprocess

Task has 3 major common methods: fetch(), one(), commit(). Multiple tasks are bind into Tasks. Tasks also have the same 3 methods.

Tasks are passed over to main event loop of main thread from current request thread. If all tasks finished, Tasks will be returned to request thread. Also by yielding, Tasks can be completely transitted into non blocking manner.

I'm not telling Atila is more better design. I'm just telling Atila is obviously NOT main-stream and I enjoy this project.

Installation

Requirements

Python 3.6+

Installation

Atila and other core base dependent libraries is developing on single milestone, install/upgrade all at once. Otherwise it is highly possible to meet some errors.

With pip

pip3 install -U atila skitai rs4 aquests

With git

pip3 install -U skitai rs4 aquests sqlphile
git clone https://gitlab.com/hansroh/atila.git
cd atila
pip3 install -e .

Optional required as you need,

pip3 install redis
pip3 install pymongo
pip3 install psycopg2-binary
pip3 install protobuf # for GRPC
pip3 install jsonrpclib-pelix
pip3 install jinja2

<< Back To README