File: turing-complete-code.md

package info (click to toggle)
python-strictyaml 1.7.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,708 kB
  • sloc: python: 12,836; sh: 48; makefile: 3
file content (33 lines) | stat: -rw-r--r-- 2,059 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
---
title: Why shouldn't I just use Python code for configuration?
---

It is relatively common for many applications to avoid the use of a different
markup language for configuration and simply allow configuration to be
done using code. One famous and unapologetic example of this is
[Django](https://docs.djangoproject.com/en/1.10/ref/settings), which
requires all configuration to be in a "settings.py" or similar file.

This seems like a great idea from the outset - Python is more flexible
than any configuration language, so, for instance, if you wanted to
use a list comprehension or read a file or call an API to fill a value,
you can.

However, with this flexibility comes many traps and unsightly
pitfalls. The Django pitfalls in particular are
[cogently summed up by Ned Bachelder on
his blog](http://nedbatchelder.com/blog/201112/duplicitous_django_settings.html) -
pitfalls which have been the cause of countless bugs over the
years.

The language expressiveness trade off applies at every level in code

- [We need less powerful languages](http://lukeplant.me.uk/blog/posts/less-powerful-languages/).
- [Rule of least power (wikipedia)](https://en.wikipedia.org/wiki/Rule_of_least_power).
- [Principle of least power by Tim Berners Lee](https://www.w3.org/DesignIssues/Principles.html#PLP).
- [Principle of least power by Jeff Atwood (coding horror blogger / stack overflow founder)](https://blog.codinghorror.com/the-principle-of-least-power/).

A good way of refactoring, in fact, is to take a large chunk of Turing-complete Python code that *can* be transformed directly into StrictYAML with no loss in expressiveness and and to transform it - for example, a list of translation strings, countries or parameters.

It also makes it easier to have the markup generated by another program or a templating language.
While you technically *can* do this with Turing-complete code, it will often lead to a debugging nightmare - [just ask C++ programmers](https://stackoverflow.com/questions/622659/what-are-the-good-and-bad-points-of-c-templates>)!