Tina4Python - This is not another framework for Python
Project description
Tina4Python - This is not a framework for Python
Tina4Python is a light-weight routing and twig based templating system based on the Tina4 stack which allows you to write websites and API applications very quickly. .
System Requirements
- Install Poetry:
curl -sSL https://install.python-poetry.org | python3 -
- Install Jurigged (Enables Hot Reloading):
pip install jurigged
Quick Start
After installing poetry you can do the following:
poetry new project-name
cd project-name
poetry add tina4_python
poetry add jurigged
Create an entry point for Tina4 called app.py and add the following to the file
from tina4_python import *
Overview
The basic tina4 project uses an autoloader methodology from the src folder All the source folders you should need are created there and they are run from init.py
If you are developing on Tina4, make sure you copy the public folder from tina4_python into src
Installation
Windows
1.) Install Poetry:
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
2.) Add the following path to the system PATH:
%APPDATA%\pypoetry\venv\Scripts
3.) Install Tina4Python and Jurigged:
poetry add tina4_python
poetry add jurigged
or
pip install tina4_python
pip install jurigged
Usage
After defining templates and routes, run the Tina4Python server:
- Normal Server:
poetry run python app.py
- Server with Hot Reloading:
poetry run jurigged app.py
- Server on a Specific Port:
poetry run python app.py 7777
- **Server to not autostart **:
poetry run python app.py manual
- Server with alternate language (for example fr = French):
poetry run python app.py fr
Add more translations by going here
Templating
Tina4 uses Jinja2 (Twig) templating to provide a simple and efficient way to create web pages.
1.) Twig Files: Add your Twig files within the src/templates folder. For instance, you might create files like index.twig, base.twig, etc., containing your HTML structure with Twig templating syntax for dynamic content.
2.) Using Twig: In these Twig files, you can use Twig syntax to embed dynamic content, control structures, variables, and more. For example:
<!-- index.twig -->
<!DOCTYPE html>
<html>
<head>
<title>Welcome</title>
</head>
<body>
<h1>Hello, {{ name }}!</h1>
</body>
</html>
Defining Routes
The routing in Tina4Python can be defined in the __init__.py file or any file used as an entry point to your application. Tina4Python provides decorators to define routes easily.
1.) Creating Routes: Define routes using decorators from Tina4Python to handle HTTP requests.
Example:
from tina4_python.Router import get
from tina4_python.Response import Response
@get("/hello")
async def hello(request, response):
return response("Hello, World!")
This code creates a route for a GET request to /hello, responding with "Hello, World!".
2.) Route Parameters: You can define route parameters by enclosing variables with curly braces { }. The parameters are passed to the function as arguments.
Example:
from tina4_python.Router import get
from tina4_python.Response import Response
@get("/hello/{name}")
async def greet(**params): #(request, response)
name = params['request'].params['name']
return params['response'](f"Hello, {name}!") # return response()
This code creates a route for a GET request to /hello/{name}, where name is a parameter in the URL. The function greet accepts this parameter and responds with a personalized greeting.
Example:
- Visiting
/hello/Johnwill respond with "Hello, John!" - Visiting
/hello/Alicewill respond with "Hello, Alice!"
3.) POST routes now require jwt token or API key to validate requests with an Authorization header
Authorization: Bearer <token>
You can generate tokens using tina4_python.tina4_auth which takes in a payload parameter which is a dictionary:
Example of a post with a form, assume the route is /capture
You need the following twig file in the src/templates folder called something.twig
<form method="post">
<input name="email" type="text" placeholder="Email">
<button type="submit">Send</button>
<input type="hidden" name="formToken" value="{{ token }}" >
</form>
You can add the following code to src/routes/example.py
# get router which renders the twig form html
@get("/capture")
async def capture_get(request, response):
# get a token to add to the form
token = tina4_python.tina4_auth.get_token({"data": {"formName": "capture"}})
html = Template.render_twig_template("somefile.twig", {"token": token})
return response(html)
# returns back to the user the form data that has been posted
@post("/capture")
async def capture_post(request, response):
return response(request.body)
In your src/__init__.py add the following code
from .routes.example import *
Generate tokens with the following code as per the example above, tokens carry a payload and we add an additional expires value to the token based on the env variable TINA4_TOKEN_LIMIT
import tina4_python
tina4_python.tina4_auth.get_token({"data": {"something":"more"}})
OR
For ease of use you can supply an API_KEY param to your .env with a secret of your choice to use:
API_KEY=somehash
Features
| Completed | To Do |
|---|---|
| Python pip package | |
| Basic environment handling | |
| Basic routing | OpenAPI (Swagger) |
| Enhanced routing | |
| CSS Support | |
| Image Support | |
| Localization | |
| Error Pages | |
| Template handling | |
| Form posting | |
| JWT tokens & security |
Building and Deployment
Using Python
Building the package:
python3 -m pip install --upgrade build
python3 -m build
python3 -m pip install --upgrade twine
python3 -m twine upload dist/*
Using Poetry
Building the package:
poetry build
Publishing the package:
poetry publish
Running tests & checks
PyTests
poetry run pytest ./tests
Flake8 Code tests
poetry run flake8 ./tina4_python
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tina4_python-0.1.58-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 567cddb0b5f0cd2d87bbdd72fa08afc3712f481c2d0f948140366c0aeb804a95 |
|
| MD5 | 18cd09daab04d00d41582205ac6f8ad1 |
|
| BLAKE2b-256 | dfa84ca3ed45a3de5ec44d6ada7b87db455fbd800032c68d3f8a16d1c5a81ccf |
