[Bugs] #1160 UNSP: no way to wait for index to finish updating/(re)building

[SugarLabs Bugs]

#1160: no way to wait for index to finish updating/(re)building
------------------------------------------+---------------------------------
    Reporter:  sascha_silbe               |          Owner:  tomeu            
        Type:  defect                     |         Status:  reopened         
    Priority:  Unspecified by Maintainer  |      Milestone:  0.86             
   Component:  sugar-datastore            |        Version:  Git as of bugdate
    Severity:  Unspecified                |     Resolution:                   
    Keywords:  r?                         |   Distribution:  Unspecified      
Status_field:  New                        |  
------------------------------------------+---------------------------------
Changes (by sascha_silbe):

  * keywords:  => r?
  * status:  closed => reopened
  * resolution:  obsolete =>


Comment:

 Still relevant because if the index gets corrupted (e.g. due to unclean
 shutdown on a non-dat journalling filesystem) it will be rebuilt in the
 background and return different results than during normal operation.

 The old data store apparently had a similar method called
 complete_indexing() (though "indexing" meant full-text extraction there).
 My data store rewrite proposal contains the same API as proposed here with
 slightly different semantics as well ("regular" API calls are disallowed
 until the data store has finished recovering, instead of returning bogus
 results).

 Even though there are slight semantic differences their usage by a caller
 is the same (wait for data store to be ready to server reliable results).
 As it's currently not used by any caller (complete_indexing() is still in
 sugar.datastore.datastore, but not in carquinyol.datastore) it's a low-
 risk change and would ease transition to the version-enabled data store.

-- 
Ticket URL: <http://dev.sugarlabs.org/ticket/1160#comment:7>
Sugar Labs <http://sugarlabs.org/>
Sugar Labs bug tracking system