From f2a9a45fd134715c929dc69d5ec25f77152768a3 Mon Sep 17 00:00:00 2001
From: Romain Dorgueil <romain@dorgueil.net>
Date: Sat, 15 Jul 2017 10:14:30 +0200
Subject: [PATCH] [nodes] Adds arg0_to_kwargs and kwargs_to_arg0
 transformations.

---
 bonobo/_api.py         |  6 ++++--
 bonobo/nodes/basics.py | 14 ++++++++++++++
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/bonobo/_api.py b/bonobo/_api.py
index ab890c6..6b2a72d 100644
--- a/bonobo/_api.py
+++ b/bonobo/_api.py
@@ -1,6 +1,6 @@
 from bonobo.structs import Bag, Graph, Token
 from bonobo.nodes import CsvReader, CsvWriter, FileReader, FileWriter, Filter, JsonReader, JsonWriter, Limit, \
-    PrettyPrinter, PickleWriter, PickleReader, RateLimited, Tee, count, identity, noop
+    PrettyPrinter, PickleWriter, PickleReader, RateLimited, Tee, count, identity, noop, arg0_to_kwargs, kwargs_to_arg0
 from bonobo.strategies import create_strategy
 from bonobo.util.objects import get_name
 
@@ -101,13 +101,15 @@ register_api_group(
     JsonReader,
     JsonWriter,
     Limit,
-    PrettyPrinter,
     PickleReader,
     PickleWriter,
+    PrettyPrinter,
     RateLimited,
     Tee,
+    arg0_to_kwargs,
     count,
     identity,
+    kwargs_to_arg0,
     noop,
 )
 
diff --git a/bonobo/nodes/basics.py b/bonobo/nodes/basics.py
index c0434ed..ea05c29 100644
--- a/bonobo/nodes/basics.py
+++ b/bonobo/nodes/basics.py
@@ -91,8 +91,22 @@ def noop(*args, **kwargs):  # pylint: disable=unused-argument
 
 
 def arg0_to_kwargs(row):
+    """
+    Transform items in a stream from "arg0" format (each call only has one positional argument, which is a dict-like
+    object) to "kwargs" format (each call only has keyword arguments that represent a row).
+
+    :param row:
+    :return: bonobo.Bag
+    """
     return Bag(**row)
 
 
 def kwargs_to_arg0(**row):
+    """
+    Transform items in a stream from "kwargs" format (each call only has keyword arguments that represent a row) to
+    "arg0" format (each call only has one positional argument, which is a dict-like object) .
+
+    :param **row:
+    :return: bonobo.Bag
+    """
     return Bag(row)