pantalla 0.3.0__py3-none-any.whl

pantalla/__init__.py

@@ -0,0 +1,219 @@
+"""
+pantalla: dibuja en la terminal de forma fácil.
+
+    import pantalla
+
+    pantalla.limpiar()
+    pantalla.rodear("=")
+    pantalla.centrar("¡Hola!", color="amarillo", negrita=True)
+    pantalla.gotoxy(5, 3)
+    print("Esto está en la columna 5, fila 3")
+    pantalla.esperar()
+
+Las posiciones empiezan en 1: (1, 1) es la esquina de arriba a la izquierda,
+x es la columna (hacia la derecha) e y la fila (hacia abajo).
+
+Escribe pantalla.ayuda() para ver todo lo que se puede hacer.
+"""
+
+from .arte import CODIGOS_COLOR, arte
+from .colores import colorear, lista_colores, poner_color, quitar_color
+from .componentes import (barra_progreso, cabecera, calculando, cargando, elegir, mensaje, menu, pie,
+                          tabla)
+from .dibujo import ESTILOS, caja, linea, linea_vertical, punto, rellenar, rodear
+from .disenos import diseno
+from .herramientas import depurar, regla
+from .juego import Sprite, cada, fotograma, jugar, pulsada, sprites
+from .letras import grande, lista_fuentes, texto_grande
+from .raton import (activar_raton, boton, botones, bucle, desactivar_raton, esperar_clic,
+                    leer_raton, posicion_raton, zona)
+from .matrices import matriz, pedir_matriz
+from .spinners import Spinner, lista_spinners, spinner
+from .teclado import (confirmar, esperar, pedir, pedir_contrasena, pedir_numero, tecla,
+                      tecla_pulsada, vaciar_teclado)
+from .terminal import (alto, ancho, centro, gotoxy, guardar_posicion, iniciar, ir_a, limpiar,
+                       limpiar_linea, mostrar_cursor, ocultar_cursor, pausa, pitido, tamano,
+                       terminar, titulo_ventana, volver_a_posicion)
+from .texto import centrar, escribir, escribir_derecha, escribir_lento
+
+__version__ = "0.3.0"
+
+from .terminal import _abrir_en_consola_si_idle as _abrir
+
+if _abrir():
+    raise SystemExit
+del _abrir
+
+_GRUPOS = [
+    ("Pantalla y cursor", ["limpiar", "limpiar_linea", "gotoxy", "ir_a", "ancho", "alto",
+                           "tamano", "centro", "ocultar_cursor", "mostrar_cursor",
+                           "guardar_posicion", "volver_a_posicion", "titulo_ventana",
+                           "pitido", "pausa", "iniciar", "terminar"]),
+    ("Escribir", ["escribir", "centrar", "escribir_derecha", "escribir_lento", "grande",
+                  "texto_grande", "lista_fuentes", "cabecera", "pie"]),
+    ("Colores", ["colorear", "poner_color", "quitar_color", "lista_colores"]),
+    ("Dibujar", ["rodear", "caja", "linea", "linea_vertical", "rellenar", "punto", "arte"]),
+    ("Teclado", ["tecla", "tecla_pulsada", "vaciar_teclado", "esperar", "pedir",
+                 "pedir_numero", "pedir_contrasena", "confirmar"]),
+    ("Cosas ya hechas", ["menu", "elegir", "mensaje", "tabla", "barra_progreso", "cargando",
+                         "calculando", "spinner", "lista_spinners"]),
+    ("Juegos", ["jugar", "Sprite", "sprites", "cada", "fotograma", "pulsada"]),
+    ("Matrices", ["matriz", "pedir_matriz"]),
+    ("Ratón", ["activar_raton", "desactivar_raton", "esperar_clic", "leer_raton",
+               "posicion_raton", "zona", "boton", "botones", "bucle"]),
+    ("Diseñar y ver posiciones", ["diseno", "regla", "depurar"]),
+]
+
+__all__ = [nombre for _, nombres in _GRUPOS for nombre in nombres] + ["ayuda", "Spinner", "ESTILOS", "CODIGOS_COLOR"]
+
+
+_PARECIDAS = {
+    "borrar": "limpiar", "cls": "limpiar", "clear": "limpiar", "borrar_pantalla": "limpiar",
+    "print": "escribir", "imprimir": "escribir", "mostrar": "escribir", "poner": "escribir",
+    "texto": "escribir", "input": "pedir", "leer": "pedir", "preguntar": "pedir",
+    "sleep": "pausa", "dormir": "pausa", "esperar_segundos": "pausa", "wait": "pausa",
+    "color": "poner_color", "colores": "lista_colores", "fuentes": "lista_fuentes",
+    "posicion": "gotoxy", "mover": "gotoxy", "cursor": "gotoxy", "goto": "gotoxy",
+    "rectangulo": "caja", "cuadro": "caja", "recuadro": "caja", "marco": "rodear", "borde": "rodear",
+    "titulo": "cabecera", "letras_grandes": "grande", "teclado": "tecla", "getch": "tecla",
+    "clic": "esperar_clic", "click": "esperar_clic", "raton": "activar_raton",
+    "juego": "jugar", "bucle_juego": "jugar", "progreso": "barra_progreso", "barra": "barra_progreso",
+}
+
+
+def _normalizar(nombre):
+    import unicodedata
+
+    sin_tildes = unicodedata.normalize("NFD", nombre)
+    return "".join(c for c in sin_tildes if unicodedata.category(c) != "Mn").lower()
+
+
+def _buscar(nombre):
+    """El nombre de verdad si lo has escrito con tildes, ñ o mayúsculas (tamaño -> tamano)."""
+    buscado = _normalizar(nombre)
+    for de_verdad in __all__:
+        if _normalizar(de_verdad) == buscado:
+            return de_verdad
+    return None
+
+
+def __getattr__(nombre):
+    if nombre.startswith("_"):
+        raise AttributeError("module 'pantalla' has no attribute %r" % nombre)
+    de_verdad = _buscar(nombre)
+    if de_verdad is not None:
+        return globals()[de_verdad]
+    import difflib
+
+    parecidas = []
+    if _normalizar(nombre) in _PARECIDAS:
+        parecidas.append(_PARECIDAS[_normalizar(nombre)])
+    for p in difflib.get_close_matches(_normalizar(nombre), __all__, n=3, cutoff=0.6):
+        if p not in parecidas:
+            parecidas.append(p)
+    aviso = "pantalla no tiene ninguna función que se llame '%s'." % nombre
+    if parecidas:
+        aviso += " ¿Querías decir " + " o ".join("pantalla.%s" % p for p in parecidas[:3]) + "?"
+    aviso += " Para ver todas: pantalla.ayuda()"
+    raise AttributeError(aviso)
+
+
+def _primera_linea(nombre):
+    return (globals()[nombre].__doc__ or "").strip().split("\n")[0]
+
+
+def _explicacion(funcion):
+    texto = (funcion.__doc__ or "(sin explicación)").strip("\n")
+    lineas = texto.split("\n")
+    sangria = min([len(l) - len(l.lstrip()) for l in lineas[1:] if l.strip()] or [0])
+    return [lineas[0].strip()] + [l[sangria:] for l in lineas[1:]]
+
+
+def _ayuda_interactiva():
+    from .terminal import _estado
+    from .teclado import _modo, _activar_modo_teclas, _desactivar_modo_teclas
+
+    ya_aparte = _estado["pantalla_aparte"]
+    ya_teclas = _modo["original"] is not None
+    if not ya_aparte:
+        iniciar(cursor=True)
+    else:
+        _activar_modo_teclas()
+    titulos = [t for t, _ in _GRUPOS]
+    resumen = {t: ", ".join(n) for t, n in _GRUPOS}
+    seccion = titulos[0]
+    elegida = None
+    try:
+        while True:
+            if elegida is None:
+                limpiar()
+                cabecera("pantalla %s · ayuda" % __version__)
+                pie("Elige un tema · Enter entrar · Esc salir")
+                seccion = menu(titulos, titulo="Temas", ayudas=resumen, inicial=seccion)
+                if seccion is None:
+                    return
+            nombres = dict(_GRUPOS)[seccion]
+            limpiar()
+            cabecera("pantalla %s · ayuda · %s" % (__version__, seccion))
+            pie("Elige una función y pulsa Enter para ver cómo se usa · Esc volver a los temas")
+            elegida = menu(nombres, titulo=seccion, inicial=elegida or 0,
+                           ayudas={n: _primera_linea(n) for n in nombres})
+            if elegida is None:
+                continue
+            limpiar()
+            cabecera("pantalla." + elegida)
+            fila = 3
+            for linea_texto in _explicacion(globals()[elegida]):
+                if fila >= alto() - 1:
+                    break
+                es_codigo = linea_texto.startswith("    ")
+                escribir(linea_texto, 3, fila, color="verde claro" if es_codigo else None,
+                         negrita=fila == 3)
+                fila = fila + 1
+            pie("Pulsa una tecla para volver a la lista")
+            tecla()
+    finally:
+        if not ya_aparte:
+            terminar()
+        elif not ya_teclas:
+            _desactivar_modo_teclas()
+
+
+def ayuda(funcion=None):
+    """Enseña todas las funciones de pantalla, o la explicación de una.
+
+        pantalla.ayuda()            # en una terminal: un menú para ir mirándolas
+        pantalla.ayuda("caja")      # cómo se usa caja
+        pantalla.ayuda(pantalla.caja)
+
+    Fuera de una terminal (por ejemplo en IDLE), escribe la lista entera.
+    """
+    import sys
+
+    from .terminal import _es_terminal
+
+    if funcion is not None:
+        if isinstance(funcion, str):
+            funcion = _buscar(funcion.strip().replace("pantalla.", "").rstrip("()")) or funcion
+            if funcion not in __all__ or funcion in ("ESTILOS", "CODIGOS_COLOR"):
+                print("No hay ninguna función que se llame %r. Mira la lista con pantalla.ayuda()" % funcion)
+                return
+            funcion = globals()[funcion]
+        print("pantalla.%s" % funcion.__name__)
+        print()
+        print("\n".join(_explicacion(funcion)))
+        return
+    if _es_terminal(sys.stdin) and _es_terminal(sys.stdout):
+        _ayuda_interactiva()
+        return
+    print("pantalla %s · todo lo que puedes usar:" % __version__)
+    for titulo, nombres in _GRUPOS:
+        print()
+        print("  " + titulo.upper())
+        for nombre in nombres:
+            print("    pantalla.%-18s %s" % (nombre, _primera_linea(nombre)))
+    print()
+    print("Para ver cómo se usa una: pantalla.ayuda(\"caja\")")
+    print("Colores: " + ", ".join(lista_colores()))
+    print("Estilos de borde: " + ", ".join(ESTILOS) + ", o un carácter como \"=\"")
+    print("Para ver una demostración, escribe en la terminal:  python -m pantalla")

pantalla/__main__.py

@@ -0,0 +1,253 @@
+"""
+Demostración de todo lo que hace pantalla. Se abre con:  python -m pantalla
+Míralo también por dentro: cada parte es un ejemplo de cómo se usa.
+"""
+
+import pantalla
+
+
+def portada():
+    pantalla.limpiar()
+    pantalla.rodear("doble", color="cian", titulo="pantalla " + pantalla.__version__)
+    pantalla.grande("PANTALLA", y=2, color="amarillo")
+    pantalla.centrar("Dibuja en la terminal de forma fácil", y=8, color="blanco", negrita=True)
+
+
+def demo_colores():
+    pantalla.limpiar()
+    pantalla.rodear("simple", color="gris", titulo="Colores")
+    y = 3
+    for nombre in pantalla.lista_colores():
+        pantalla.escribir(nombre.ljust(16), 4, y)
+        pantalla.escribir("  texto  ", 21, y, color=nombre)
+        pantalla.escribir("  fondo  ", 32, y, color="negro", fondo=nombre)
+        y = y + 1
+    pantalla.escribir("negrita", 46, 3, negrita=True)
+    pantalla.escribir("tenue", 46, 4, tenue=True)
+    pantalla.escribir("cursiva", 46, 5, cursiva=True)
+    pantalla.escribir("subrayado", 46, 6, subrayado=True)
+    pantalla.escribir("tachado", 46, 7, tachado=True)
+    pantalla.escribir("invertido", 46, 8, invertido=True)
+    pantalla.escribir("#ff8800 en hexadecimal", 46, 10, color="#ff8800")
+    pantalla.escribir("(0, 200, 120) en RGB", 46, 11, color=(0, 200, 120))
+    pantalla.esperar("Pulsa una tecla para volver", 4, pantalla.alto() - 1, color="gris")
+
+
+def demo_cajas():
+    pantalla.limpiar()
+    x = 3
+    for estilo in ["simple", "doble", "grueso", "redondo", "ascii", "*"]:
+        pantalla.caja(x, 2, 12, 5, estilo=estilo, titulo=estilo)
+        x = x + 13
+    pantalla.caja(3, 8, 30, 7, estilo="redondo", color="verde", titulo="Con color")
+    pantalla.escribir("Las cajas pueden tener\ntítulo, color y relleno.", 5, 10)
+    pantalla.rellenar(36, 8, 20, 7, fondo="azul")
+    pantalla.escribir("rellenar()", 41, 11, color="blanco", fondo="azul", negrita=True)
+    pantalla.linea(16, "=", color="amarillo")
+    pantalla.linea(17, "doble", x=3, largo=40, color="morado")
+    for i in range(10):
+        pantalla.punto(60 + i * 2, 9 + i % 4, "●", color="rojo claro")
+    pantalla.esperar("Pulsa una tecla para volver", 3, pantalla.alto() - 1, color="gris")
+
+
+def demo_teclas():
+    pantalla.limpiar()
+    pantalla.rodear("redondo", color="gris", titulo="Teclado")
+    pantalla.escribir("Pulsa teclas y te digo cuál es. Esc para salir.", 4, 3, color="amarillo")
+    y = 5
+    while True:
+        t = pantalla.tecla()
+        if y > pantalla.alto() - 2:
+            pantalla.rellenar(3, 5, pantalla.ancho() - 4, pantalla.alto() - 6)
+            y = 5
+        pantalla.escribir("pantalla.tecla() devolvió: ", 4, y)
+        pantalla.escribir(repr(t), 31, y, color="verde", negrita=True)
+        y = y + 1
+        if t == "esc":
+            return
+
+
+def demo_mover():
+    pantalla.limpiar()
+    pantalla.rodear("simple", color="azul", titulo="Mueve la @ con las flechas · Esc salir")
+    x, y = pantalla.centro()
+    pantalla.ocultar_cursor()
+    while True:
+        pantalla.punto(x, y, "@", color="amarillo")
+        t = pantalla.tecla()
+        pantalla.punto(x, y, " ")
+        if t == "arriba" and y > 2:
+            y = y - 1
+        elif t == "abajo" and y < pantalla.alto() - 1:
+            y = y + 1
+        elif t == "izquierda" and x > 2:
+            x = x - 1
+        elif t == "derecha" and x < pantalla.ancho() - 1:
+            x = x + 1
+        elif t == "esc":
+            pantalla.mostrar_cursor()
+            return
+
+
+def demo_cosas():
+    pantalla.limpiar()
+    pantalla.escribir("tabla():", 3, 2, color="amarillo")
+    pantalla.tabla([["Ana", 8.5], ["Luis", 6], ["Marta", 9.75]], ["Nombre", "Nota"], x=3, y=3)
+    pantalla.escribir("barra_progreso():", 3, 11, color="amarillo")
+    pantalla.ocultar_cursor()
+    for i in range(101):
+        pantalla.barra_progreso(i, 100, 3, 12, ancho=40)
+        pantalla.pausa(0.015)
+    pantalla.escribir("cargando():", 3, 14, color="amarillo")
+    pantalla.cargando(2, "Pensando", 3, 15)
+    pantalla.escribir_lento("escribir_lento(): como una máquina de escribir...", 3, 17, velocidad=0.03)
+    pantalla.mostrar_cursor()
+    pantalla.mensaje("Y esto es mensaje().\nSirve para avisos.", titulo="¡Hola!")
+
+
+def demo_pedir():
+    pantalla.limpiar()
+    pantalla.rodear("redondo", color="verde", titulo="Pedir datos")
+    nombre = pantalla.pedir("¿Cómo te llamas? ", 4, 3, color="cian")
+    edad = pantalla.pedir_numero("¿Cuántos años tienes? ", 4, 5, minimo=0, maximo=120, color="cian")
+    pantalla.escribir("¿Te gusta Python? (s/n) ", 4, 8, color="cian")
+    gusta = pantalla.confirmar("", 28, 8)
+    texto = "Hola, %s. Tienes %d años" % (nombre or "persona misteriosa", edad)
+    if gusta:
+        texto = texto + "\ny te gusta Python. ¡Bien!"
+    else:
+        texto = texto + "\ny no te gusta Python... todavía."
+    pantalla.mensaje(texto, titulo="Resultado", color_borde="verde")
+
+
+def demo_menus():
+    pantalla.limpiar()
+    pantalla.cabecera("Menús")
+    pantalla.escribir("1) Un menú normal, con ayuda abajo e iconos:", 3, 3, color="amarillo")
+    r = pantalla.menu(["Jugar", "Opciones", "Salir"], titulo="Juego", x=6, y=5,
+                      ayudas={"Jugar": "Empieza una partida nueva", "Opciones": "Sonido y dificultad",
+                              "Salir": "Vuelve a la demo"},
+                      iconos={"Jugar": "►", "Opciones": "*", "Salir": "×"})
+    pantalla.escribir("Has elegido: %r" % r, 6, 12, color="verde")
+    pantalla.escribir("2) elegir(), en una sola línea:", 3, 14, color="amarillo")
+    r = pantalla.elegir("¿Dificultad?", ["Fácil", "Normal", "Difícil"], 6, 16)
+    pantalla.escribir("Has elegido: %r" % r, 6, 17, color="verde")
+    pantalla.esperar("Pulsa una tecla para ver el menú con secciones", 3, 19, color="gris")
+    pantalla.limpiar()
+    pantalla.cabecera("Menú con secciones")
+    r = pantalla.menu({"Operaciones": ["Sumar", "Restar", "Multiplicar"],
+                       "Determinantes": ["Determinante", "Inversa"],
+                       "Otros": ["Historial", "Ajustes", "Volver"]},
+                      ayudas={"Sumar": "Suma dos matrices del mismo tamaño", "Volver": "Vuelve a la demo"},
+                      iconos={"Sumar": "+", "Restar": "-", "Multiplicar": "×", "Determinante": "|A|",
+                              "Inversa": "A⁻¹", "Historial": "≡", "Ajustes": "*", "Volver": "←"},
+                      titulo="Como en el proyecto de matrices", y=3)
+    pantalla.escribir("Has elegido: %r" % r, 3, pantalla.alto() - 2, color="verde")
+    pantalla.esperar("  Pulsa una tecla para volver", color="gris")
+
+
+def demo_fuentes():
+    fuentes = pantalla.lista_fuentes()
+    i = 0
+    texto = "Hola"
+    while True:
+        pantalla.limpiar()
+        pantalla.cabecera("Fuentes ASCII · %d de %d" % (i + 1, len(fuentes)))
+        pantalla.escribir('pantalla.grande("%s", fuente="%s")' % (texto, fuentes[i]), 3, 3, color="verde")
+        pantalla.grande(texto, x=3, y=5, color="amarillo", fuente=fuentes[i])
+        pantalla.pie("← → otra fuente · Enter cambiar el texto · Esc volver")
+        t = pantalla.tecla()
+        if t == "esc":
+            return
+        if t in ("derecha", "abajo", "espacio"):
+            i = (i + 1) % len(fuentes)
+        elif t in ("izquierda", "arriba"):
+            i = (i - 1) % len(fuentes)
+        elif t == "enter":
+            nuevo = pantalla.pedir("Texto: ", 3, pantalla.alto() - 2, color="cian")
+            texto = nuevo or texto
+
+
+def demo_matrices():
+    pantalla.limpiar()
+    pantalla.cabecera("Matrices")
+    A = pantalla.pedir_matriz("A")
+    if A is None:
+        return
+    pantalla.calculando()
+    pantalla.cabecera("Matrices")
+    pantalla.escribir("pantalla.matriz() la dibuja así:", 3, 3, color="amarillo")
+    ancho, alto = pantalla.matriz(A, 3, 5, nombre="A")
+    pantalla.matriz(A, 3 + ancho + 4, 5, nombre="|A|", det=True, color="cian")
+    pantalla.escribir("Y en Python es esta lista: %r" % (A,), 3, 5 + alto + 1, color="verde")
+    pantalla.pie("Pulsa una tecla para volver")
+    pantalla.tecla()
+
+
+def main():
+    import sys
+
+    if len(sys.argv) > 1 and sys.argv[1] in ("depurar", "debug"):
+        pantalla.depurar()
+        return
+    if len(sys.argv) > 1 and sys.argv[1] == "ayuda":
+        pantalla.ayuda()
+        return
+
+    secciones = {
+        "Lo básico": ["Colores", "Cajas y dibujos", "Fuentes ASCII", "Teclado"],
+        "Cosas ya hechas": ["Menús", "Tablas, barras y mensajes", "Pedir datos"],
+        "Más": ["Matrices", "Mover una @", "Ver posiciones", "Salir"],
+    }
+    ayudas = {
+        "Colores": "Todos los colores y estilos de texto",
+        "Cajas y dibujos": "caja, rodear, rellenar, linea, punto",
+        "Fuentes ASCII": "grande() con las 32 fuentes de lista_fuentes()",
+        "Teclado": "Pulsa teclas y mira qué devuelve pantalla.tecla()",
+        "Menús": "menu() con ayudas e iconos, elegir() y el menú con secciones",
+        "Tablas, barras y mensajes": "tabla, barra_progreso, cargando, mensaje",
+        "Pedir datos": "pedir, pedir_numero y confirmar",
+        "Matrices": "pedir_matriz() con las flechas y matriz() para dibujarla",
+        "Mover una @": "Un juego mínimo con las flechas",
+        "Ver posiciones": "pantalla.depurar(): mueve una cruz y mira x e y",
+        "Salir": "Hasta luego",
+    }
+    iconos = {
+        "Colores": "■", "Cajas y dibujos": "┌┐", "Fuentes ASCII": "A", "Teclado": "Aa", "Menús": "≡",
+        "Tablas, barras y mensajes": "▤", "Pedir datos": "?", "Matrices": "[ ]",
+        "Mover una @": "@", "Ver posiciones": "╋", "Salir": "←",
+    }
+    pantalla.iniciar(titulo="pantalla · demo")
+    try:
+        elegida = "Colores"
+        while True:
+            portada()
+            elegida = pantalla.menu(secciones, ayudas=ayudas, iconos=iconos, y=10, inicial=elegida)
+            if elegida is None or elegida == "Salir":
+                break
+            if elegida == "Colores":
+                demo_colores()
+            elif elegida == "Cajas y dibujos":
+                demo_cajas()
+            elif elegida == "Fuentes ASCII":
+                demo_fuentes()
+            elif elegida == "Teclado":
+                demo_teclas()
+            elif elegida == "Menús":
+                demo_menus()
+            elif elegida == "Tablas, barras y mensajes":
+                demo_cosas()
+            elif elegida == "Pedir datos":
+                demo_pedir()
+            elif elegida == "Matrices":
+                demo_matrices()
+            elif elegida == "Mover una @":
+                demo_mover()
+            elif elegida == "Ver posiciones":
+                pantalla.depurar()
+    finally:
+        pantalla.terminar()
+
+
+if __name__ == "__main__":
+    main()