Introducción

Instalación

Preguntas frecuentes (faq)

Sintaxis, palabras clave y funciones integradas

Distribución estándar

Implementación del import

Interfaz del navegador

Introducción - DOM API
Creando un documento
Accediendo a los elementos
Atributos, propriedades y métodos

Eventos
Eventos del ratón
Eventos del teclado
Eventos de foco
Eventos de arrastre

Query string

Usando objetos y librerías Javascript

Módulos específicos de Brython

El módulo integrado `browser`
browser.aio
browser.ajax
browser.html
browser.local_storage
browser.markdown
browser.object_storage
browser.session_storage
browser.svg
browser.template
browser.timer
browser.webcomponent
browser.websocket
browser.worker

javascript

Trabajando con Brython

Opciones de la función brython()
Testing y depuración
Desplegando una aplicación

Cookbook

Hola Mundo !
Insertar contenido en un elemento
Marcado HTML (bold,italic...)
Tabla HTML
Añadir (*bind*) y eliminar (*unbind*) eventos
Handle options in a SELECT
Arrastrar y soltar
Obtener el contenido de un elemento
Leer el contenido de un fichero
Almacenar objetos localmente
Ejemplo de onmouseover
 

Sin instalación

Puedes usar Brython sin tener que instalar nada, solo necesitas para incluir scripts de Brython en la página HTML de un CDN.

<script src="https://cdn.jsdelivr.net/npm/brython@3/brython.min.js">
</script>
<script src="https://cdn.jsdelivr.net/npm/brython@3/brython_stdlib.js">
</script>

También podemos especificar la versión menor con brython@3.10 y la versión micro con brython@3.10.0.

Brython también está disponible en cdnjs:

<script src="https://cdnjs.cloudflare.com/ajax/libs/brython/3.10.0/brython.min.js">
</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/brython/3.10.0/brython_stdlib.min.js">
</script>

Instalación local

Para instalar Brython :

  • Si tu PC dispone de CPython y pip, instala el paquete brython mediante

    pip install brython

El paquete instala un sotfware del cliente brython-cli (equivalente a python -m brython).

Una vez hecho lo anterior, en un directorio vacio ejecuta

brython-cli --install

  • Si no puedes instalar Brython de esta forma, ve a la página de releases en Github, selecciona la última versión, descarga y descomprime Brython-x.y.z.zip.

En ambos casos, el directorio tiene los siguientes ficheros :

  • brython.js : el motor (engine) Brython, que hay que incluir en la página HTML
  • brython_stdlib.js : agrupa todos los módulos y paquetes de parte de la librería estándar soportados por Brython
  • demo.html : una página con unos pocos exemplos sobre cómo usar Brython para desarrollo en el cliente

brython.js incluye los módulos de uso frecuente : browser, browser.html, javascript.

Si tu aplicación usa módulos de la distribución estándar necesitarás incluir brython_stdlib.js además de brython.js en tu página HTML:

<script type="text/javascript" src="brython.js"></script>
<script type="text/javascript" src="brython_stdlib.js"></script>

Actualizaciones

Cuando se publica una nueva versión de Brython, la actualización se realiza usando el comando típico:

pip install brython --upgrade

En el directorio de la aplicación puedes actualizar los ficheros Brython (brython.js y brython_stdlib.js) usando:

brython-cli --update

Instalando un paquete CPython

Un paquete CPython instalado mediante pip se puede instalar en una aplicación Brython mediante el comando --add_package <package name>.

Por ejemplo:

pip install attrs
brython-cli --add_package attrs

Todos los ficheros en el paquete deben, por supuesto, ser usables por Brython; esto, por ejemplo, excluye ficheros escritos en C.

Otros comandos

-- modules

crea una distribución específica para la aplicación, para reemplazar brython_stdlib.js por un fichero más pequeño. Ver sección import.

-- make_dist

genera un paquete CPython, apto para ser distribuido mediante PyPI, para instalar una aplicación Brython. Ver sección Desplegando una aplicación Brython

Servidor Web

Los ficheros HTML se pueden abrir en un navegador pero se recomienda iniciar un servidor web en el directorio de la aplicación.

La forma más directa sería usar el módulo http.server en la biblioteca estándar de CPython:

python -m http.server

El puerto pro defecto es el 8000. Para elegir otro puerto puedes usar:

python -m http.server 8001

Podras acceder a la web introduciendo la url http://localhost:8001/demo.html en la barra de direcciones del navegador.