[Checkins] SVN: martian/branches/philikon-moduleinfo-kwarg/src/martian/README.txt Grokkers need to accept **kw, per interface IGrokker

[Philipp von Weitershausen]

Log message for revision 80782:
  Grokkers need to accept **kw, per interface IGrokker
  

Changed:
  U   martian/branches/philikon-moduleinfo-kwarg/src/martian/README.txt

-=-
Modified: martian/branches/philikon-moduleinfo-kwarg/src/martian/README.txt
===================================================================
--- martian/branches/philikon-moduleinfo-kwarg/src/martian/README.txt	2007-10-10 09:41:14 UTC (rev 80781)
+++ martian/branches/philikon-moduleinfo-kwarg/src/martian/README.txt	2007-10-10 10:13:13 UTC (rev 80782)
@@ -291,7 +291,7 @@
 
   >>> class ColorGrokker(InstanceGrokker):
   ...   component_class = color.Color
-  ...   def grok(self, name, obj):
+  ...   def grok(self, name, obj, **kw):
   ...     color.all_colors[name] = obj
   ...     return True
 
@@ -359,7 +359,7 @@
 
   >>> class SoundGrokker(InstanceGrokker):
   ...   component_class = sound.Sound
-  ...   def grok(self, name, obj):
+  ...   def grok(self, name, obj, **kw):
   ...     sound.all_sounds[name] = obj
   ...     return True
   >>> sound_grokker = SoundGrokker()
@@ -677,7 +677,7 @@
   >>> read_amount = {}
   >>> from martian import GlobalGrokker
   >>> class AmountGrokker(GlobalGrokker):
-  ...   def grok(self, name, module):
+  ...   def grok(self, name, module, **kw):
   ...     read_amount[None] = module.amount
   ...     return True
 
@@ -711,7 +711,7 @@
 
   >>> class MachineGrokker(ClassGrokker):
   ...   component_class = oldstyle.Machine
-  ...   def grok(self, name, obj):
+  ...   def grok(self, name, obj, **kw):
   ...     oldstyle.all_machines[name] = obj
   ...     return True
 
@@ -719,7 +719,7 @@
 
   >>> class MachineInstanceGrokker(InstanceGrokker):
   ...   component_class = oldstyle.Machine
-  ...   def grok(self, name, obj):
+  ...   def grok(self, name, obj, **kw):
   ...     oldstyle.all_machine_instances[name] = obj
   ...     return True
 
@@ -787,7 +787,7 @@
   >>> all_numbers = {}
   >>> class NumberGrokker(InstanceGrokker):
   ...  component_class = Number
-  ...  def grok(self, name, obj, multiplier):
+  ...  def grok(self, name, obj, multiplier, **kw):
   ...    all_numbers[obj.nr] = obj.nr * multiplier
   ...    return True
   >>> def prepare(name, module, kw):
@@ -834,7 +834,7 @@
 
   >>> class BrokenGrokker(InstanceGrokker):
   ...  component_class = Number
-  ...  def grok(self, name, obj):
+  ...  def grok(self, name, obj, **kw):
   ...    pass
 
   >>> module_grokker = ModuleGrokker()
@@ -848,7 +848,7 @@
 Let's also try this with a GlobalGrokker::
 
   >>> class MyGrokker(GlobalGrokker):
-  ...   def grok(self, name, module):
+  ...   def grok(self, name, module, **kw):
   ...     return "Foo"
   >>> module_grokker = ModuleGrokker()
   >>> module_grokker.register(MyGrokker())
@@ -949,7 +949,7 @@
   >>> class somemodule(FakeModule):
   ...   class TestGrokker(ClassGrokker):
   ...     component_class = TestOnce
-  ...     def grok(self, name, obj):
+  ...     def grok(self, name, obj, **kw):
   ...        executed.append(name)
   ...        return True
   >>> somemodule = fake_import(somemodule)
@@ -985,7 +985,7 @@
   >>> class somemodule(FakeModule):
   ...   class TestGrokker(InstanceGrokker):
   ...     component_class = TestInstanceOnce
-  ...     def grok(self, name, obj):
+  ...     def grok(self, name, obj, **kw):
   ...        executed.append(name)
   ...        return True
   >>> somemodule = fake_import(somemodule)
@@ -1007,7 +1007,7 @@
   >>> executed = []
   >>> class somemodule(FakeModule):
   ...   class TestGrokker(GlobalGrokker):
-  ...     def grok(self, name, obj):
+  ...     def grok(self, name, obj, **kw):
   ...       executed.append(name)
   ...       return True
   >>> somemodule = fake_import(somemodule)
@@ -1051,7 +1051,7 @@
 
   >>> order = []
   >>> class OrderGrokker(ClassGrokker):
-  ...   def grok(self, name, obj):
+  ...   def grok(self, name, obj, **kw):
   ...     order.append(name)
   ...     return True
 
@@ -1098,7 +1098,7 @@
 
   >>> class MyGlobalGrokker(GlobalGrokker):
   ...   priority = 5
-  ...   def grok(self, name, obj):
+  ...   def grok(self, name, obj, **kw):
   ...     order.append(name)
   ...     return True
   >>> multi_grokker.grok('MyGlobalGrokker', MyGlobalGrokker)