Temas

Ver la guía de temas para la lista de tokens y cómo crear los tuyos.

Theme

Theme

Un tema: un dataclass inmutable con los tokens de color (superficies, bordes, elementos, texto, estado, editor, sintaxis, colores de colaboradores y ANSI) y métricas (radius, radius_sm, ui_font_size, buffer_font_size). La propiedad is_dark indica si es oscuro.

Métodos y propiedades

Theme.is_dark

Theme.is_dark  # property

Si el aspecto del tema es oscuro.

derive

derive(self, **changes)

Devuelve una copia con algunos tokens cambiados. Los diccionarios syntax y ansi se combinan en lugar de reemplazarse.

Parámetro	Descripción
changes	Tokens a cambiar.

oceano = pz.themes.ONE_DARK.derive(name="Océano", accent="#4fb3ff", syntax={"keyword": "#ff79c6"})

color

color(self, name)

Resuelve un token ("accent", "text_muted"…) a su color. Los colores hex y "transparent" pasan tal cual.

Parámetro	Descripción
name	Token o color.

tokens

tokens(self)

Todos los tokens como diccionario.

syntax_scopes

syntax_scopes(self)

Traduce los tokens de sintaxis del tema a scopes de TextMate para el resaltador.

palette

palette(self)

La paleta base que se pasa a Iced para sus estilos internos. De uso interno.

with_accent

with_accent(self, accent)

Una copia con otro color de acento y todo lo que depende de él (foco, selección, enlaces, botones principales, texto sobre acento).

Parámetro	Descripción
accent	El color.

generate

generate(
    name,
    *,
    background,
    text,
    accent,
    appearance=None,
    error=None,
    warning=None,
    success=None,
    syntax=None,
    radius=6.0,
)

Crea un tema completo a partir de unos pocos colores. Superficies, bordes, estados de hover y textos atenuados se mezclan a partir de background y text; la apariencia se deduce del brillo del fondo si no se indica.

Parámetro	Descripción
name	Nombre.
background	Color del editor/fondo.
text	Color del texto.
accent	Color de acento.
appearance	"dark" o "light".
error	Color de error.
warning	Color de aviso.
success	Color de éxito.
syntax	Colores de sintaxis extra.
radius	Radio de las esquinas.

pz.Theme.generate("Propio", background="#1b1d23", text="#e6e6e6", accent="#ff8a65")

from_zed

from_zed(source, name=None)

Lee un tema de un archivo de familia de temas de Zed (.json) o un dict. Una familia suele tener varios (Ayu Dark/Light/Mirage); name elige uno (por defecto, el primero).

Parámetro	Descripción
source	Ruta, texto JSON o dict.
name	Nombre del tema dentro de la familia.

to_dict

to_dict(self)

Un dict apto para JSON; Theme.from_dict lo vuelve a leer.

from_dict

from_dict(data, *, base=None)

Crea un tema a partir de to_dict. Los tokens que falten salen de base (One Dark u One Light según appearance).

Parámetro	Descripción
data	Los tokens.
base	Tema base.

save

save(self, path)

Guarda el tema como JSON (formato propio de Pyzed).

Parámetro	Descripción
path	Ruta del archivo.

load

load(path)

Lee un tema escrito con save (para temas de Zed usa from_zed).

Parámetro	Descripción
path	Ruta del archivo.

Temas incluidos

themes

Espacio de nombres con los temas incluidos (las familias One, Ayu y Gruvbox) y el registro de temas. Los incluidos también están como atributos: themes.ONE_DARK, themes.ONE_LIGHT, themes.AYU_DARK, themes.AYU_LIGHT, themes.AYU_MIRAGE, themes.GRUVBOX_DARK, themes.GRUVBOX_LIGHT…

all

all()

Lista con todos los temas incluidos.

names

names()

Nombres de todos los temas registrados.

get

get(name)

Busca un tema por nombre (sin distinguir mayúsculas). Lanza KeyError si no existe.

Parámetro	Descripción
name	Nombre.

register

register(theme)

Añade (o reemplaza) un tema para poder usarlo por su nombre.

Parámetro	Descripción
theme	El tema.

load_zed

load_zed(source)

Carga y registra todos los temas de un archivo de familia de Zed.

Parámetro	Descripción
source	Ruta, texto JSON o dict.

auto

auto(light='One Light', dark='One Dark')

Un tema que sigue el modo claro/oscuro del sistema.

Parámetro	Descripción
light	Tema (o nombre) para modo claro.
dark	Tema (o nombre) para modo oscuro.

AutoTheme

Lo que devuelve themes.auto: un par (light, dark). pick(dark) devuelve el que toca.

Métodos y propiedades

AutoTheme.pick

AutoTheme.pick(dark)

Devuelve el tema oscuro si dark es verdadero; si no, el claro.

Utilidades (pyzed.theme)

current

current()

El tema que usan los componentes cuando no se pasa theme=.

use

use(theme)

Cambia el tema actual. App lo hace antes de cada view(), así que normalmente no lo necesitas.

Parámetro	Descripción
theme	El tema.

alpha

alpha(color, value)

Devuelve color con su opacidad multiplicada por value.

Parámetro	Descripción
color	Color hex.
value	Factor de 0 a 1.

pz.theme.alpha("#74ade8", 0.2)  # "#74ade833"

mix

mix(a, b, amount=0.5)

Mezcla dos colores: amount=0 es a y amount=1 es b.

Parámetro	Descripción
a	Primer color.
b	Segundo color.
amount	Proporción de b.

resolve

resolve(value, *, dark=True)

Convierte un valor de App.theme (tema, nombre, AutoTheme o None) en un Theme.

Parámetro	Descripción
value	El valor.
dark	Si el sistema está en modo oscuro.

lighten

lighten(color, amount=0.1)

Aclara un color.

Parámetro	Descripción
color	Color hex.
amount	Cantidad de 0 a 1.

darken

darken(color, amount=0.1)

Oscurece un color.

Parámetro	Descripción
color	Color hex.
amount	Cantidad de 0 a 1.

luminance

luminance(color)

Luminancia relativa (WCAG) de un color, de 0 a 1.

Parámetro	Descripción
color	Color hex.

contrast

contrast(a, b)

Relación de contraste WCAG entre dos colores (1 a 21).

Parámetro	Descripción
a	Primer color.
b	Segundo color.

readable_on

readable_on(background, light='#fafafa', dark='#1c2025')

Devuelve light u dark, el que más contraste tenga sobre background.

Parámetro	Descripción
background	Color de fondo.
light	Texto claro.
dark	Texto oscuro.