Lightweight web framework
Project description
PYMETRICK
Pymetrick version 0.80.2
Mini marco de desarrollo web basado en Python 3.7+ ( TODO EN UNO ), al disponer de todos los módulos necesarios para cualquier desarrollo web (templates, session/cookies, routing de solicitudes, gestión MySQL y SQLite, rst - reStructuredText, identificación de conexiones, tratamiento de imagenes, tratamiento de correos,...etc) permite prescindir de librerias ajenas a las librerías estándar de PYTHON, aunque el uso de librerías externas no se excluye completamente.
No dispone de un servidor de aplicaciones. Es necesario un servidor de aplicaciones WSGI para aplicaciones síncronas ( apache ) o ASGI para aplicaciones asíncronas ( aiohttp) Para evolucionar hacia tecnologías asíncronas, hemos adoptado el servidor de aplicaciones python del que se proporcionan ejemplos para un desarrollo rápido, además de un contendor docker con todas las dependencias necesarias.
Se aceptan contribuciones de codigo que permitan la adaptación a desarrollos empresariales, con igual licencia que PYMETRICK.
INDICE DE MODULOS
- TEMPLATE o cómo interpretar plantillas .tpl y transformarlas en HTML5 (DEPRECATED | DESCONTINUADO en proximas versiones)
- DEVICE o cómo identificar accesos con dispositivos, navegadores, motores e idiomas. (DEPRECATED | DESCONTINUADO en proximas versiones)
- ROUTING o cómo manipular direcciones HTTP a funciones ( controller ) (DEPRECATED | DESCONTINUADO en proximas versiones)
- IMAGE o cómo gestionar imagenes
- SQLDB o cómo gestionar BB.DD. (mariaDB)
- SESSION (JSON WEB TOKENS stateless authentication) o como identificar usuarios y seguridad de acceso (DEPRECATED | DESCONTINUADO en proximas versiones)
- MAIL tratamiento de correo
- EXCHEQUER tratamiento fiscal e identificación (NIF/CIF/NIE/VAT) y Registro de Operadores Intracomunitarios
- HELPERS o gestión de utilidades universales de uso común
- RST o reStructuredText gestiona el formato de textos convirtiendolo en html
- COMMON o dónde identificar valores universales
- FPDF generación de documentos PDF ( versión de pyFPDF con incorporaciones de pymetrick )
- ISSUE formatos comerciales como facturas, tickets (PDF y ESC/POS), etiquetas de almacén,...
- BUCKET gestiona OBJECT STORAGE o servicios compatibles con AWS S3
TEMPLATE
Realiza la gestión de plantillas ( con extensión .tpl ), generando código HTML5. Similar a JINJA2 pero mucho más simple.
A continuación se identifica código para realizar plantillas :
<% ..... %>
Se puede introducir cualquier tipo de información, si los datos se separan con el carácter | se enviará como una lista de elementos o si además, los elementos están separados por clave valor con = se enviará un diccionario. La información enviada entre estas etiquetas, se procesará en función del primer elemento. Si no pudiera ser procesado por el primer elemento, se incluirá igual que si se hubiera incluído entre etiquetas {%literal%} {%endliteral%}.
Por ejemplo, para incluir en el bloque <head>
<%title|Prueba Html5%>
<%author|Fco.Javier Tamarit%>
<%description|Prueba Html5%>
<%script|../../web/js/jquery.min.js||text/javascript%>
<%script|../../web/js/jquery-ui.min.js||text/javascript%>
o para incluir en el bloque <body>
<%type="hidden"|id="sessionID"|value=""%>
<%type="number"|id="numero"|label="Numero"|placeholder="Introduzca numero"|br=""%>
<%type="tel"|id="telefono"|label="Telefono"|placeholder="Introduzca telefono"|br=""%>
<%type="submit"|id="s"|value="Acceso"|size=10%>
<%type="submit"|id="r"|value="Registrarse"%>
{% ..... %}
Separa la información por bloques, el inicio de bloque se nombrará como {%block body%} y el final como {%endblock body%}. Esto creará una etiqueta <body> y al finalizar, otra etiqueta </body>. Los bloques permitidos son html, head, body, footer, article, section, aside, form, header, hgroup, table, nav.
Algunos bloques pueden incluir información en su etiqueta inicial como :
{%block html|lang="es"%}
{%block body|onload="MideScreen()"%}
{%block form|id="Login",method="POST",action="/input"%}
Observe que los parámetros estan separados de la etiqueta mediante |
Los bloques iniciados y no cerrados, se cerrarán de forma automática al finalizar el proceso de la plantilla.
{%literal%} ..... {%endliteral%} La información incluida entre estas dos etiquetas, no tendrá ninguna tranformación, se incluirá exactamente como se haya introducido.
{%literal%}
script type="text/javascript">
document.createElement("nav");
document.createElement("header");
document.createElement("footer");
document.createElement("section");
document.createElement("article");
document.createElement("aside");
document.createElement("hgroup");
</script
{%endliteral%}
<--! ..... -->
La información contenida entre estas dos etiquetas, se entenderá que corresponde a un comentario y no se procesará en el código resultado.
{%extend fichero_template.tpl%} La etiqueta {%extend se empleará para incluir un fichero con formato de plantilla en la plantilla que se está procesando. De forma que no se repita el mismo código en todas las plantillas y pueda unificarse en un solo fichero de plantilla externo. El nombre de fichero no puede contener espacios.
{%merge fichero_externo.txt%} La etiqueta {%merge también importa un fichero externo, pero su contenido no será procesado y se incluirá tal cual se importe. El nombre de fichero no puede contener espacios.
{{ ..... }}
Los datos incluídos entre doble llave, se consideran variables o funciones a procesar, que igualmente deben devolver un valor.
DEVICE
A partir del 'user-agent' proporcionado por el cliente, es posible identificar : S.O., navegador, motor, idiomas admitidos, dispositivo origen y adaptar la respuesta.
ROUTING
Con su ayuda, se construyen las reglas de actuación ante las posibles solicitudes de los clientes, permitiendo respuestas flexibles en función de parámetros dinámicos.
Importar routing:
from pymetrick.routing import *
Primero debe crear una ruta al subdominio de la siguiente forma :
rules_web = Map(default_subdomain='www',redirect_defaults='/')
Las rutas a páginas se crean de la siguiente forma :
rules_web.add(rule='/login',controller='login')
rules_web.add(rule='/login/nada',controller='login')
rules_web.add(rule='/login/nada/todo',controller='login')
rules_web.add(rule='/registro',controller='registro')
rules_web.add(rule='/prueba',controller='prueba')
Ahora, cuando busque una ruta debe indicarlo como :
rules_web.match('login')
rules_web.match('/login/nada/todo')
rules_web.match('/varios')
esto ejecutara el controlador parametrizado.
Si la ruta obtenida del cliente, contiene datos del tipo
'/auth?user=javier&passw=tonto'
se eliminaran para evaluar correctamente la ruta
Y si no existe la ruta, devolvera 404 y podremos redirigirlo
if rules_web.match('/no_existe')=="404":
rules_web.match('/')
''')
IMAGE
Este módulo permite la adaptación o manipulación de las imágenes a cualquier necesidad, desde el peso de las imágenes hasta su formato.
Importar Image:
from pymetrick.image import *
Utilidades con imagenes : image_size(path) Comprueba las dimensiones de la imagen.
image_resize(__path__,__factor__=1,__resized_path__='') Convierte fichero de imagen a un tamaño diferente, ademas es posible cambiar el tipo de imagen de png, jpeg o gif a otro cuando se renombra el fichero de imagen resultante.
strip_metadata(image_path,newImage=None) Elimina los metadatos EXIF de una imagen, guardando en el mismo nombre de imagen o bien en otra imagen nueva.
image2html('logo.png') Devuelve una imagen en base64 como un string de forma que se pueda utilizar como imagen embebida en css o html.
image2base64('logo.png') Devuelve una imagen en base64 extendido ( file_name$string_base64).
image_download('http://nadadenada.com/coche.png', '/img/coche_2.png') Descarga una imagen desde una url con <urllib> y permite renombrar el fichero.
image_checksums('logo.png') Devuelve un hash como un string que identifica la imagen para ser comparada con otras imagenes.
image_compare(file1,file2) Devuelve 0 si las imagenes comparadas son iguales, en caso contrario devolvera un valor distinto de 0.
image_qrcode('/home/content.png'logo.png') Devuelve datos/informacion en formato qrcode como imagen png
SQLDB
Gestión de la conexión con BB.DD. como MySQL (MYSQL.CONNECTOR), PostgreSQL (PSYCOPG2) y SQLite.
Incluye funciones dirigidas a conexión, reconexión, así como la creación, modificación, eliminación y utilidades de BB.DD.,tablas, indices,...
SESSION
Identifica las conexiones de clientes mediante JSON WEB TOKENS stateless authentication, que se intercambian entre el servidor WEB y el cliente a través de : HTTP_COOKIE HTTP_X_AUTHORIZATION or X_REQUEST_WITH HTTP_HOST HTTP_CLIENT_IP o HTTP_X_FORWARDED_FOR o REMOTE_ADDR
Incorpora también funciones de encriptación y generación de passwords
Con el módulo MAIL se gestiona el correo electrónico. Condición necesaria es disponer de un servidor SMTP y POP3 o IMAP
Parámetros necesarios :
sendMail() Enviar mail e incorporar ficheros adjuntos si fuera necesario
_sender - str - enviado desde
_to - list - enviar a
_cc - list - enviar copias
_bcc - list - enviar copias ocultas
_subject - str - asunto
_text - str - text/plain del mensaje
_html - str - text/html del mensaje
_user - str - usuario
_password - str - password
_smtpserver - str - servidor smtp
_smtp_port - str - puerto
_imapserver - str - servidor imap ( crea correo en carpeta SENT )
_imap_port - str - puerto
_files - list - ficheros adjuntos
_output - str - el contenido del mensaje se grabara como un fichero
getMail() Recepción de mail desde POP3|IMAP
_user - str - usuario
_password - str - password
_imapserver - str - servidor IMAP
_pop3server - str - servidor POP3
_port - str - puerto
_criteria - str -
ALL - devuelve todos los mensajes que coinciden con el resto del criterio
ANSWERED - coincide con los mensajes con la bandera \\ANSWERED establecida
BCC "cadena" - coincide con los mensajes con "cadena" en el campo Bcc:
BEFORE "fecha" - coincide con los mensajes con Date: antes de "fecha"
BODY "cadena" - coincide con los mensajes con "cadena" en el cuerpo del mensaje
CC "cadena" - coincide con los mensajes con "cadena" en el campo Cc:
DELETED - coincide con los mensajes borrados
FLAGGED - coincide con los mensajes con la bandera \\FLAGGED establecida (algunas veces referidos como Importante o Urgente)
FROM "cadena" - coincide con los mensajes con "cadena" en el campo From:
KEYWORD "cadena" - coincide con los mensajes con "cadena" como palabra clave
NEW - coincide con los mensajes nuevos
OLD - coincide con los mensajes antiguos
ON "fecha" - coincide con los mensajes con Date: coincidiendo con "fecha"
RECENT - coincide con los mensajes con la bandera \\RECENT establecida
SEEN - coincide con los mensajes que han sido leídos (la bandera \\SEEN esta estabecido)
SINCE "fecha" - coincide con los mensajes con Date: despues de "fecha"
SUBJECT "cadena" - coincide con los mensajes con "cadena" en Subject:
TEXT "cadena" - coincide con los mensajes con el texto "cadena"
TO "cadena" - coincide con los mensajes con "cadena" en To:
UNANSWERED - coincide con los mensajes que no han sido respondidos
UNDELETED - coincide con los mensajes que no están eliminados
UNFLAGGED - coincide con los mensajes que no tienen bandera
UNKEYWORD "cadena" - coincide con los mensajes que no tienen la palabra clave "cadena"
UNSEEN - coincide con los mensajes que aun no han sido leidos
_outputdir - str -
deleteIMAP() Eliminar mail de servidor IMAP
_user - str - usuario
_password - str - password
_imapserver - str - servidor IMAP
_port - str - puerto
_folder - str - carpeta a tratar
timeZone(zona)
EXCHEQUER
Con el módulo EXCHEQUER pueden introducirse datos identificativos fiscales en las transacciones comerciales, así como validar las identificaciones aportadas según reglas de cada país.
HELPERS
Se admiten todas las clases o funciones que por su funcionalidad, puedan compartirse entre los restantes módulos o no tengan un fín funcional asociado a los restantes módulos.
RST o reStructuredText
A partir de ficheros con extension .rst y codificados como un reStructuredText se obtienen ficheros HTML5 completos o HTML5 parciales que completarán otros ficheros HTML5 principales.
COMMON
Proporciona listas de valores universales para todos los módulos.
FPDF
Producción de documentos en formato PDF. Este módulo es una actualización del original FPDF versión 1.7.1 en el que se han incluído EAN13, UPC_A y funciones auxiliares para producir códigos de barras no incluídos en la versión previa.
VERSIONES
Las versiones estables se indicarán con número de versión par. Las versiones en desarrollo y que incorporen características experimentales se numerarán con versión impar.
Ver 0.01 21/09/2012 Licencia GPLv3 - en desarrollo - Las pruebas de desarrollo se realizan sobre un ordenador RASPBERRY PI 512Mb RAM, 1 GHz CPU y tarjeta SD de 64Gb con una evolución satisfactoria. El objetivo es desarrollar una librería simple y funcional. El entorno hardware de desarrollo se complementa con un servidor MySQL 5 y servidor web APACHE 2 con mod_wsgi.
Ver 0.02 20/08/2015 Licencia GPLv3 - versión estable -
Ver 0.48.4 15/12/2018 Licencia GPLv3 - versión estable -
Ver 0.50.0 31/10/2019 Licencia GPLv3 - versión estable -
Ver 0.52.0 09/05/2020 Licencia GPLv3 - versión estable -
Ver 0.54.0 02/08/2020 Licencia GPLv3 - versión estable -
Ver 0.56.0 10/01/2021 Licencia GPLv3 - versión estable -
Ver 0.58.0 29/03/2021 Licencia GPLv3 - versión estable -
Ver 0.60.0 05/04/2021 Licencia GPLv3 - versión estable -
Ver 0.62.0 09/04/2021 Licencia GPLv3 - versión estable -
Ver 0.64.0 27/05/2021 Licencia GPLv3 - versión estable -
Ver 0.66.0 01/06/2021 Licencia GPLv3 - versión estable -
Ver 0.68.0 28/09/2021 Licencia GPLv3 - versión estable -
Ver 0.70.0 14/03/2022 Licencia GPLv3 - versión estable -
Ver 0.72.0 06/04/2022 Licencia GPLv3 - versión estable -
Ver 0.74.0 05/10/2022 Licencia GPLv3 - versión estable -
Ver 0.76.0 20/10/2022 Licencia GPLv3 - versión estable -
Ver 0.78.0 07/03/2023 Licencia GPLv3 - versión estable -
Ver 0.80.1 27/03/2023 Licencia GPLv3 - versión estable -
Ver 0.80.2 20/09/2023 Licencia GPLv3 - versión estable -
CREDITOS O COLABORACIONES
Cualquier desarrollo que se incorpore a un módulo o la introducción de nuevos desarrollos deben ser aprobados antes de formar parte de la libreria, debiendo respetar la licencia GPLv3. El reconocimiento de los desarrolladores que colaboren a mejorar la librería se incorporará en la cabecera 'CREDITS' de los módulos afectados por sus desarrollos.
Project details
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 pymetrick-0.80.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a86ae2335972b0a7cf69ffcbee66bdc8276da745c23b5f3e2a4317b8344760f1 |
|
MD5 | 5f226bf9efdc5a48644545a57deca232 |
|
BLAKE2b-256 | 85aba8170515a21ce93383554eac6f96aa4a16dec2306921e9177f8db6dcd19f |