Performance improvements, better readme and complete python bindings

examples/02_named_ports/main.cpp

@@ -54,17 +54,18 @@ static void report(int count, std::vector<std::string> words) {
 int main() {
     using namespace kpn;
 
+    // [snippet: named_port_creation]
     // tokenise: no inputs, one named output "words"
     auto tok = make_node<tokenise>(out<"words">{}, 4);
 
     // count_words: named input "words", named outputs "count" and "words"
     auto cnt = make_node<count_words>(in<"words">{}, out<"count", "words">{}, 4);
 
-    // report: two named inputs — note the function takes (int, vector<string>)
-    // so we need two separate input ports wired independently
-    // For a two-input sink we wire each output of cnt to a different input of report
+    // report: two named inputs
     auto snk = make_node<report>(in<"count", "words">{}, 4);
+    // [/snippet: named_port_creation]
 
+    // [snippet: named_port_network]
     Network net;
     net.add("tok", tok)
        .add("cnt", cnt)
@@ -77,4 +78,5 @@ int main() {
     net.start();
     std::this_thread::sleep_for(std::chrono::milliseconds(500));
     net.stop();
+    // [/snippet: named_port_network]
 }