ES

DocsPrimeros pasos

¿Qué es Nexi?

Nexy es un marco Python para aplicaciones web fullstack: sus páginas y su API viven en un proyecto y son atendidas por un servidor.

lo que obtienes

  • Páginas en Python. Un archivo .nexy es HTML con unas pocas líneas de Python en la parte superior; un archivo .md también es una página. No se necesita JavaScript para representar una página.
  • Una API en el mismo proyecto. Un archivo .py bajo src/routes/ responde solicitudes HTTP: una función llamada GET responde GET, una función llamada POST responde POST.
  • Una API en el mismo proyecto. Un controlador responde solicitudes HTTP: su método get responde GET, su método post responde POST y un módulo agrupa controladores y sus servicios.
  • Una API en el mismo proyecto. El enrutador FastAPI que ya tienes sigue respondiendo, y las páginas y archivos de ruta de src/routes/ responden junto a él.
  • Documentación API gratuita. Cada ruta API aparece en un esquema OpenAPI y Scalar la muestra como una referencia interactiva en /docs.
  • Formularios que llaman a Python. Un formulario, o una llamada escrita desde el navegador, llega a la misma función Python.
  • Un framework frontend cuando lo desees. React, Vue, Svelte, Solid o Preact, para un componente o para todo el sitio.
  • Un comando para trabajar, otro para enviar. nx dev se recarga a medida que guardas; nx build prepara la producción.

Sobre qué está construido

La versión actual, 2.2, incluye herramientas que quizás ya conozcas:

parte Construido sobre Lo que significa para ti
Servidor y API FastAPI una ruta API es una ruta FastAPI: la validación Pydantic y las dependencias funcionan como de costumbre
Referencia API OpenAPI y Escalar el esquema está en /openapi.json, la referencia en /docs
paginas Jinja2 una página .nexy utiliza etiquetas Jinja2 como {{ title }}
Interfaz (opcional) Vite sólo con un marco de interfaz, que también necesita Node.js

Una primera página y un primer punto final

Una página, en /hello:

src/rutas/hola.nexy
---title: prop[str] = "Hello"---<h1>{{ title }}</h1>

Un punto final, en GET /api/items, listado en /docs sin ningún código adicional:

src/rutas/api/items.py
from nexy.http import Request  async def GET(request: Request):    return {"items": []}

Una vista y los controladores que responden /hello/ y GET /api/items/. El punto final aparece en /docs sin ningún código adicional, y una URL sin su última barra lo redirecciona:

src/apps/hola_view.nexy
---title: prop[str] = "Hello"---<h1>{{ title }}</h1>
src/apps/hola_controller.py
from nexy.decorators import Controllerfrom nexy.hooks import useViews  @Controller("/hello")class HelloController:    async def get(self):        return useViews("src/apps/hello_view.nexy", context={"title": "Hello"})  @Controller("/api/items")class ItemsController:    async def get(self):        return {"items": []}

El módulo raíz los enumera y useRouter = AppModule en nexyconfig.py lo monta:

src/apps/app_module.py
from nexy.decorators import Module from .hello_controller import HelloController, ItemsController  @Module()class AppModule:    controllers = [HelloController, ItemsController]

Lo que te deja Nexy

La base de datos, el inicio de sesión y las reglas sobre quién puede hacer qué pertenecen a tu aplicación, para que tú elijas las bibliotecas. Bases de datos y Middleware y seguridad muestran dónde se conecta cada una.

Próximos pasos

Editar en GitHub

Enter abre el resultado, Esc lo cierra.