~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/osutils.py

Be more explicit about race conditions and LBYL being discouraged

Show diffs side-by-side

added added

removed removed

Lines of Context:
2361
2361
 
2362
2362
    This will *not* create anything, this only return a 'free' entry.  This
2363
2363
    should be used for checking names in a directory below a locked
2364
 
    tree/branch/repo to avoid race conditions.
 
2364
    tree/branch/repo to avoid race conditions. This is LBYL (Look Before You
 
2365
    Leap) and generally discouraged.
2365
2366
 
2366
2367
    :param base: The base name.
2367
 
    :param exists: A callable returning True if the passed path exists.
 
2368
 
 
2369
    :param exists: A callable returning True if the path parameter exists.
2368
2370
    """
2369
2371
    counter = 1
2370
2372
    name = "%s.~%d~" % (base, counter)