Instrucciones
Un lenguaje específico de dominio (DSL) es un lenguaje pequeño optimizado para un dominio concreto.
Como un DSL está enfocado a un dominio, puede mejorar enormemente la productividad y la comprensión, ya que permite a quien lo escribe declarar qué quiere en lugar de cómo.
Un área problemática donde se aplican son las personalizaciones y configuraciones complejas.
Por ejemplo, el lenguaje DOT te permite escribir una descripción textual de un grafo que después se transforma en una imagen con alguna de las herramientas de Graphviz (como dot).
Un grafo sencillo tiene este aspecto:
graph {
graph [bgcolor="yellow"]
a [color="red"]
b [color="blue"]
a -- b [color="green"]
}
Si guardas esto en un fichero example.dot y ejecutas dot example.dot -T png -o example.png, se crea una imagen example.png con un círculo rojo y otro azul unidos por una línea verde sobre un fondo amarillo.
Escribe un lenguaje específico de dominio similar al lenguaje dot de Graphviz.
Nuestro DSL se parece al lenguaje dot de Graphviz en que se usará para crear estructuras de datos de tipo grafo.
Sin embargo, a diferencia del lenguaje DOT, nuestro DSL será un DSL interno que solo se podrá usar en nuestro lenguaje.
Aprende más sobre la diferencia entre los DSL internos y externos.
Descripción del DSL
Un grafo, en este DSL, es un objeto de tipo Graph. Esto recibe una list de una
o más tuplas que describen:
Las implementaciones de Node y Edge se proporcionan en dot_dsl.py.
Para obtener más detalles sobre el diseño esperado del DSL y sobre los tipos de error y los mensajes de error esperados, echa un vistazo a los casos de prueba de dot_dsl_test.py
Mensajes de excepción
A veces es necesario lanzar una excepción. Cuando lo hagas, siempre debes incluir un mensaje de error significativo que indique cuál es el origen del error. Esto hace que tu código sea más legible y ayuda mucho a la hora de depurar. En situaciones en las que sabes que el origen del error será de un tipo concreto, puedes optar por lanzar uno de los tipos de error integrados, pero aun así debes incluir un mensaje significativo.
Este ejercicio en concreto requiere que uses la instrucción raise para «lanzar» un TypeError cuando un Graph esté mal formado, y un ValueError cuando un Edge, un Node o un attribute esté mal formado. Las pruebas solo pasarán si lanzas (raise) la exception y además incluyes un mensaje con ella.
Para lanzar un error con un mensaje, escribe el mensaje como argumento del tipo exception:
# Graph is malformed
raise TypeError("Graph data malformed")
# Edge has incorrect values
raise ValueError("EDGE malformed")
