Stvad / pyconie_dsl

Materials/examples for the PyconIE 2018 talk: Domain specific languages in Python. Why and How

Domain specific languages in Python. The Why and How.

🙂                  🙂          🙂🙂🙂😛🙂🙂
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🦄🦄🦄🦄🦄🦄🦄🦄🦄🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂                😛
🙂                  🙂           🙂🙂🙂🙂🙂🙂

created via Character Canvas DSL

---

This repo contains materials and examples for the PyconIE 2018 talk: Domain specific languages in Python. The Why and How

You can find the presentation here (pdf version).

Video from the conference was lost to history, but you can listen to pre-conference recording & read it's transcript

Examples

1. State Machine/Home automation DSL. The example is inspired by the "Gothic security system" from DSL book by Martin Fowler
   • State Machine Model
   • Various ways of initializing the state machine:
     • Imperative Initialization
     • YAML DSL
     • External DSL
     • Fluent interface init
     • Internal DSL
   • DSL code:
     • Fluid interface definition
     • DSL from the introduction - combines a variety of techniques.
2. Character Canvas/Drawing Board/Turtle DSL 🦄. An example DSL to demonstrate the utility of operators/magic method overloading.
3. Fabric-inspired contexts + dynamic field generation
4. HTML
   • Simple context manager-based HTML builder
   • HTML builder that uses dynamic class property generation
   • A more extensive HTML builder DSL example, that combines a variety of techniques
5. Defining global executing context: runner, dsl-file
6. Defining local execution context: Implicit 'self' emulation
7. Elixir-style pipes usage example. Demonstrates one of the applications of import time AST manipulation.

References

1. Domain-Specific Languages by Martin Fowler

2. The library that implements Elixir style pipes

3. Macropy A framework to help you with import time AST manipulation.

4. SSM Document Generator (the accidental DSL)

5. DSLs mentioned in the talk:

   • Attrs
   • ANTLR
   • Scons
   • Rake
   • GraphViz
   • RegEx
   • CSS

6. Various other resources I found useful while doing research for the talk:

   • https://orbifold.xyz/python-dsl.html
   • https://nvbn.github.io/2015/04/04/python-html-dsl/
   • https://rszalski.github.io/magicmethods
   • https://play.kotlinlang.org/byExample/09_Kotlin_JS/06_HtmlBuilder

---