Version: 0.11

Config composition

The product manager had an idea: She wants my_app to support creating arbitrary database schemas, on all supported databases! She also wants to have two kinds of UI - a full UI to create and view databases and a view only UI. You are the fall guy. Before you even start, she tells you there are already 3 database schema you need to support, and more are coming soon. You are already sweating because it all sounds pretty complex. You also got a feeling that this is only the beginning - who knows what idea she will have next?

To solve it with Hydra, we need more config groups. Add a schema and a ui config group:

├── conf
│   ├── config.yaml
│   ├── db
│   │   ├── mysql.yaml
│   │   └── postgresql.yaml
│   ├── schema
│   │   ├── school.yaml
│   │   ├── support.yaml
│   │   └── warehouse.yaml
│   └── ui
│   ├── full.yaml
│   └── view.yaml

At this point, we already have 2 supported databases, 3 schemas, and 2 ui modes. This is a total of 12 combinations. adding another supported database will bring this to 18 combinations. Creating 18 files is not a good idea, if you wanted to make a change such as renaming db.user to db.username you would have to do it 18 times!

Composition can come to the rescue.

Configuration file: config.yaml

- db: mysql
- ui: full
- schema: school

The defaults are ordered:

  • If there are two configurations that defines the same value, the second one would win.
  • If two configurations are contributing to the same dictionary the result would be the combined dictionary.

When running this, we will compose a configuration with mysql, full ui and the school database schema (which we are seeing for the first time here):

$ python
driver: mysql
pass: secret
user: omry
database: school
- fields:
- name: string
- class: int
name: students
- fields:
- profession: string
- time: data
- class: int
name: exams
create_db: true
view: true

In much the same way you can compose any of the other 11 configurations by adding appropriate overrides such as db=postgresql.

Last updated on by Omry Yadan