Add "magic" explanation

Author: Scandie

openprocurement/auction/chronograph.py

@@ -117,6 +117,11 @@ def sigusr1():
             # ADD FILTER BY VALUE
             # {start: '2016-09-10T14:36:40.378777+03:00', test: false}
             if datestamp < auction_item['value']['start']:
+                # running __call__ method of core.ChronographManager, which
+                # returns instance of core.RunDispatcher, initialized with
+                # current instance of AuctionsChronograph and auction_item if
+                # value of procurementMethodType field in feed object was
+                # registered during entry_points loading, else returns None
                 worker_cmd_provider = \
                     self.mapper(FeedItem(auction_item['value']))
                 if not worker_cmd_provider:

openprocurement/auction/databridge.py

@@ -75,19 +75,34 @@ def run(self):
             self.run_re_planning()
             return
 
+        # getting auction items from api by
+        # openprocurement_client.sync.ResourceFeeder
         for item in self.feeder.get_resource_items():
             # magic goes here
+            # munch auction item fields specified in API_EXTRA['opt_fields']
             feed = FeedItem(item)
+            # running __call__ method of core.DatabridgeManager, which returns
+            # instance of core.Planning, initialized with current instance of
+            # AuctionsDataBridge and feed object if value of
+            # procurementMethodType field in feed object was registered during
+            # entry_points loading, else returns None
             planning = self.mapper(feed)
-            if not planning:
+            if not planning:  # if procurementMethodType is not registered
                 continue
+            # calling __iter__ method of core.Planning's instance
+            # got from previous step
             for cmd, item_id, lot_id in planning:
                 if lot_id:
                     LOGGER.info('Lot {} of tender {} selected for {}'.format(
                         lot_id, item_id, cmd))
                 else:
                     LOGGER.info('Tender {} selected for {}'.format(item_id,
                                                                    cmd))
+                # calling __call__ method of core.Planning's instance which
+                # prepares all needed arguments and returns result of
+                # gevent.subprocess.check_call function, which runs certain
+                # auction worker, depending on value of procurementMethodType of
+                # feed object
                 planning(cmd, item_id, lot_id=lot_id)
 
     def run_re_planning(self):