Tina4 Python - Quick Reference#

pip install tina4-pythontina4 init my-projectcd my-projecttina4 start

<!-- src/templates/index.twig --><h1>Hello Static World</h1>

from tina4_python.Router import get, post​@get("/")async def get_home(request, response):    return response("<h1>Hello Tina4 Python</h1>")​# post requires a formToken in body or Bearer auth@post("/api")async def post_api(request, response):    return response({"data": request.params})​# redirect after post@post("/register")async def post_register(request, response):    return response.redirect("/welcome")

class RunSomething:​    @staticmethod    def before_something(request, response):        response.content += "Before"        return request, response​    @staticmethod    def after_something(request, response):        response.content += "After"        return request, response​    @staticmethod    def before_and_after_something(request, response):        response.content += "[Before / After Something]"        return request, response​@middleware(RunSomething)@get("/middleware")async def get_middleware(request, response):    return response("Route") # Before[Before / After Something]Route[Before / After Something]After

<!-- src/templates/index.twig --><h1>Hello {{name}}</h1>

from tina4_python.Router import get​@get("/")async def get_home(request, response):    return response.render("index.twig", {"name": "World!"})

TINA4_SESSION_HANDLER=SessionMongoHandlerTINA4_SESSION_MONGO_HOST=localhostTINA4_SESSION_MONGO_PORT=27017TINA4_SESSION_MONGO_URI=TINA4_SESSION_MONGO_USERNAME=TINA4_SESSION_MONGO_PASSWORD=TINA4_SESSION_MONGO_DB=tina4_sessionsTINA4_SESSION_MONGO_COLLECTION=sessions

@get("/session/set")async def get_session_set(request, response):    request.session.set("name", "Joe")    request.session.set("info", {"info": ["one", "two", "three"]})    return response("Session Set!")​​@get("/session/get")async def get_session_set(request, response):    name = request.session.get("name")    info = request.session.get("info")​    return response({"name": name, "info": info})​

// src/scss/main.scss$primary: #2c3e50;body {  background: $primary;  color: white;}

PROJECT_NAME="My Project"VERSION=1.0.0TINA4_LOCALE=enTINA4_DEBUG_LEVEL=ALLTINA4_API_KEY=ABC1234TINA4_TOKEN_LIMIT=1DATABASE_NAME=sqlite3:test.db

import os​api_key = os.getenv("TINA4_API_KEY", "ABC1234")

from tina4_python.Router import get, post, noauth, secured​@post("/login")@noauth()async def login(request, response):    return response("Logged in")​@get("/protected")@secured()async def secret(request, response):    return response("Welcome!")

<form method="POST" action="/register">    {{ ("Register" ~ RANDOM()) | form_token }}    <input name="email">    <button>Save</button></form>

from tina4_python.Router import getfrom tina4_python import description​@get("/users")@description("Get all users")async def users(request, response):    return response(User().select("*"))

from tina4_python.Database import Database​# dba = Database("<driver>:<hostname>/<port>:database_name", username, password)dba = Database("sqlite3:data.db") 

result = dba.fetch("select * from test_record order by id", limit=3, skip=1)​array = result.to_array()paginated = result.to_paginate()csv_data = result.to_csv()json_data = result.to_json()

tina4 migrate:create create_users_table

-- migrations/00001_create_users_table.sqlCREATE TABLE users(    id   INTEGER PRIMARY KEY AUTOINCREMENT,    name TEXT);

tina4 migrate

from tina4_python.ORM import ORM, IntegerField, StringField​class User(ORM):    id   = IntegerField(primary_key=True, auto_increment=True)    name = StringField()​User({"name": "Alice"}).save()​user = User()user.load("id = ?", [1])

@get("/users/dashboard")async def dashboard(request, response):    users = User().select("id, name, email")    return response.render("users/dashboard.twig", {"crud": users.to_crud(request)})

{{ crud }}

from tina4_python import Api​api = Api("https://api.example.com", auth_header="Bearer xyz")result = api.get("/users/42")print(result["body"])

from tina4_python import tests​​@tests(    assert_equal((7, 7), 1),    assert_equal((-1, 1), -1),    assert_raises(ZeroDivisionError, (5, 0)),)def divide(a: int, b: int) -> float:    if b == 0:        raise ZeroDivisionError("division by zero")    return a / b

from tina4_python.Websocket import Websocket​@get("/ws/chat")async def chat_ws(request, response):    ws = await Websocket(request).connection()    try:        while True:            data = await ws.receive()            await ws.send(f"Echo: {data}")    finally:        await ws.close()    return response("")

from tina4_python.Queue import Queue, Producer, Consumer​# Produce a messagequeue = Queue(topic="emails")Producer(queue).produce({"to": "alice@example.com", "subject": "Welcome"})​# Consume messagesconsumer = Consumer(queue)for msg in consumer.messages():    print(msg.data)

from tina4_python.WSDL import WSDL, wsdl_operationfrom typing import List​​class Calculator(WSDL):    SERVICE_URL = "http://localhost:7145/calculator"​    def Add(self, a: int, b: int):        return {"Result": a + b}​    def SumList(self, Numbers: List[int]):        return {            "Numbers": Numbers,            "Total": sum(Numbers),            "Error": None        }​​@wsdl("/calculator")async def wsdl_cis(request, response):    return response.wsdl(Calculator(request))​

from tina4_python.Localization import localize​_ = localize()print(_("Server stopped."))  # "Bediener gestop." (af)

from tina4_python.Localization import AVAILABLE_LANGUAGES# ['en', 'fr', 'af']