Does invalidate() return the new cached result?

[mbi]

Your README seems to imply that the invalidate() call doesn't return the new value:

>>> expensive_function(100, 200)
121
>>> exensive_function.invalidate(1, 200)
>>> expensive_function(1, 100)
89

… however a call with _refresh=True does:

>>> expensive_function(100, 200)
121
>>> expensive_function(100, 200, _refresh=True)
177
>>> expensive_function(100, 200)
177

Is this correct?

[peterbe]

Correct understanding. The invalidate function doesn't actually run the function you're decoratoring.

Clearly this wasn't clear from the documentation (hence you filing this issue).
Can you suggest a docs update to make it more clear?

[mbi]

Nah, it's fine: I think it's clear enough as it is in the current README.