Page 348, example script ShaderMethods_01.py illustrates the method that nruddock is referring to.

The whole Shader Tree section is 13 pages long and in addition includes five more Shader Tree example scripts.

The output of the first script looks like the image below.

I'm sorry to hear that you felt that this constituted a massive hole.