fixes #850

Author: jph00

README.md

@@ -3,9 +3,11 @@
 
 <!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
 
-## fastcore v2
-
-In July 2026 we released fastcore v2, which removes or relocates a number of APIs that had accumulated better alternatives. If you use `from fastcore.utils import *` (or `fastcore.all`), most of these changes won’t affect you. The breaking changes: `Param` is gone from `fastcore.script`; use plain type annotations with docments, or `typing.Annotated[type, "help"]`, optionally with a `dict` of argparse arguments for advanced features. [`L`](https://fastcore.fast.ai/foundation.html#l)’s `starmap`, `starfilter`, and the other `star*`/`rstar*` methods are replaced by the [`star`](https://fastcore.fast.ai/foundation.html#star) and [`rstar`](https://fastcore.fast.ai/foundation.html#rstar) function adapters, which compose with every [`L`](https://fastcore.fast.ai/foundation.html#l) method (e.g. `t.map(star(f))`); relatedly, `spread` is replaced by [`star`](https://fastcore.fast.ai/foundation.html#star), and `dspread` is renamed to [`dstar`](https://fastcore.fast.ai/basics.html#dstar). Async helpers now live in the new `fastcore.aio` module: [`run_sync`](https://fastcore.fast.ai/aio.html#run_sync), [`iter_sync`](https://fastcore.fast.ai/aio.html#iter_sync), and [`ctx_sync`](https://fastcore.fast.ai/aio.html#ctx_sync) moved there from `net`, and [`maybe_await`](https://fastcore.fast.ai/aio.html#maybe_await), [`then`](https://fastcore.fast.ai/aio.html#then), [`mapa`](https://fastcore.fast.ai/aio.html#mapa), [`acache`](https://fastcore.fast.ai/aio.html#acache), [`reawaitable`](https://fastcore.fast.ai/aio.html#reawaitable), [`is_async_callable`](https://fastcore.fast.ai/aio.html#is_async_callable), and the other async utilities moved there from `xtras`. [`Config`](https://fastcore.fast.ai/xtras.html#config) and the config file functions moved from `foundation` to `xtras`. `fastcore.net` lost its request builders (`urlrequest`, `urlsend`, `do_request`, `urlcheck`) and `clean_type_str` is gone. `parallel_gen` is removed; the stdlib [`ProcessPoolExecutor`](https://fastcore.fast.ai/parallel.html#processpoolexecutor) `initializer` pattern replaces it (fastai’s `parallel_tokenize` shows the recipe). Python 3.11 or later is now required. If you need the old APIs, pin `fastcore<2`.
+> [!NOTE]
+>
+> ### fastcore v2
+>
+> In July 2026 we released fastcore v2, which removes or relocates a number of APIs that had accumulated better alternatives. If you use `from fastcore.utils import *` (or `fastcore.all`), most of these changes won’t affect you. The breaking changes: `Param` is gone from `fastcore.script`; use plain type annotations with docments, or `typing.Annotated[type, "help"]`, optionally with a `dict` of argparse arguments for advanced features. [`L`](https://fastcore.fast.ai/foundation.html#l)’s `starmap`, `starfilter`, and the other `star*`/`rstar*` methods are replaced by the [`star`](https://fastcore.fast.ai/foundation.html#star) and [`rstar`](https://fastcore.fast.ai/foundation.html#rstar) function adapters, which compose with every [`L`](https://fastcore.fast.ai/foundation.html#l) method (e.g. `t.map(star(f))`); relatedly, `spread` is replaced by [`star`](https://fastcore.fast.ai/foundation.html#star), and `dspread` is renamed to [`dstar`](https://fastcore.fast.ai/basics.html#dstar). Async helpers now live in the new `fastcore.aio` module: [`run_sync`](https://fastcore.fast.ai/aio.html#run_sync), [`iter_sync`](https://fastcore.fast.ai/aio.html#iter_sync), and [`ctx_sync`](https://fastcore.fast.ai/aio.html#ctx_sync) moved there from `net`, and [`maybe_await`](https://fastcore.fast.ai/aio.html#maybe_await), [`then`](https://fastcore.fast.ai/aio.html#then), [`mapa`](https://fastcore.fast.ai/aio.html#mapa), [`acache`](https://fastcore.fast.ai/aio.html#acache), [`reawaitable`](https://fastcore.fast.ai/aio.html#reawaitable), [`is_async_callable`](https://fastcore.fast.ai/aio.html#is_async_callable), and the other async utilities moved there from `xtras`. [`Config`](https://fastcore.fast.ai/xtras.html#config) and the config file functions moved from `foundation` to `xtras`. `fastcore.net` lost its request builders (`urlrequest`, `urlsend`, `do_request`, `urlcheck`) and `clean_type_str` is gone. `parallel_gen` is removed; the stdlib [`ProcessPoolExecutor`](https://fastcore.fast.ai/parallel.html#processpoolexecutor) `initializer` pattern replaces it (fastai’s `parallel_tokenize` shows the recipe). Python 3.11 or later is now required. If you need the old APIs, pin `fastcore<2`.
 
 Python is a powerful, dynamic language. Rather than bake everything into the language, it lets the programmer customize it to make it work for them. `fastcore` uses this flexibility to add to Python features inspired by other languages we’ve loved, mixins from Ruby, and currying, binding, and more from Haskell. It also adds some “missing features” and clean up some rough edges in the Python standard library, such as simplifying parallel processing, and bringing ideas from NumPy over to Python’s `list` type.
 

fastcore/xtras.py

@@ -1153,7 +1153,7 @@ def mtime_policy(
     if (filepath is None)==(arg is None): raise TypeError('Pass exactly one of `filepath` or `arg`')
     def _expired(mtime, fp):
         current_mtime = getmtime(fp)
-        return current_mtime if mtime is None or current_mtime>mtime else None
+        return current_mtime if mtime is None or current_mtime!=mtime else None
     if arg is None: return lambda mtime: _expired(mtime, filepath)
     def policy(mtime, args, kwargs): return _expired(mtime, kwargs[arg] if isinstance(arg,str) else args[arg])
     policy.needs_args = True

nbs/03_xtras.ipynb

@@ -5291,7 +5291,7 @@
     "    if (filepath is None)==(arg is None): raise TypeError('Pass exactly one of `filepath` or `arg`')\n",
     "    def _expired(mtime, fp):\n",
     "        current_mtime = getmtime(fp)\n",
-    "        return current_mtime if mtime is None or current_mtime>mtime else None\n",
+    "        return current_mtime if mtime is None or current_mtime!=mtime else None\n",
     "    if arg is None: return lambda mtime: _expired(mtime, filepath)\n",
     "    def policy(mtime, args, kwargs): return _expired(mtime, kwargs[arg] if isinstance(arg,str) else args[arg])\n",
     "    policy.needs_args = True\n",
@@ -5370,11 +5370,14 @@
     "fp.write_text('b')\n",
     "os.utime(fp, (time()+1,)*2)\n",
     "test_eq(slurp(fp), 'b')\n",
+    "fp.write_text('c')\n",
+    "os.utime(fp, (time()-1,)*2)\n",
+    "test_eq(slurp(fp), 'c')\n",
     "\n",
     "@flexicache(mtime_policy(arg='p'))\n",
     "def slurp2(p=None): return p.read_text()\n",
     "\n",
-    "test_eq(slurp2(p=fp), 'b')\n",
+    "test_eq(slurp2(p=fp), 'c')\n",
     "fp.unlink()"
    ]
   },

nbs/index.ipynb

@@ -28,9 +28,11 @@
    "id": "4987bac8",
    "metadata": {},
    "source": [
+    "::: {.callout-note}\n",
     "## fastcore v2\n",
     "\n",
-    "In July 2026 we released fastcore v2, which removes or relocates a number of APIs that had accumulated better alternatives. If you use `from fastcore.utils import *` (or `fastcore.all`), most of these changes won't affect you. The breaking changes: `Param` is gone from `fastcore.script`; use plain type annotations with docments, or `typing.Annotated[type, \"help\"]`, optionally with a `dict` of argparse arguments for advanced features. `L`'s `starmap`, `starfilter`, and the other `star*`/`rstar*` methods are replaced by the `star` and `rstar` function adapters, which compose with every `L` method (e.g. `t.map(star(f))`); relatedly, `spread` is replaced by `star`, and `dspread` is renamed to `dstar`. Async helpers now live in the new `fastcore.aio` module: `run_sync`, `iter_sync`, and `ctx_sync` moved there from `net`, and `maybe_await`, `then`, `mapa`, `acache`, `reawaitable`, `is_async_callable`, and the other async utilities moved there from `xtras`. `Config` and the config file functions moved from `foundation` to `xtras`. `fastcore.net` lost its request builders (`urlrequest`, `urlsend`, `do_request`, `urlcheck`) and `clean_type_str` is gone. `parallel_gen` is removed; the stdlib `ProcessPoolExecutor` `initializer` pattern replaces it (fastai's `parallel_tokenize` shows the recipe). Python 3.11 or later is now required. If you need the old APIs, pin `fastcore<2`."
+    "In July 2026 we released fastcore v2, which removes or relocates a number of APIs that had accumulated better alternatives. If you use `from fastcore.utils import *` (or `fastcore.all`), most of these changes won't affect you. The breaking changes: `Param` is gone from `fastcore.script`; use plain type annotations with docments, or `typing.Annotated[type, \"help\"]`, optionally with a `dict` of argparse arguments for advanced features. `L`'s `starmap`, `starfilter`, and the other `star*`/`rstar*` methods are replaced by the `star` and `rstar` function adapters, which compose with every `L` method (e.g. `t.map(star(f))`); relatedly, `spread` is replaced by `star`, and `dspread` is renamed to `dstar`. Async helpers now live in the new `fastcore.aio` module: `run_sync`, `iter_sync`, and `ctx_sync` moved there from `net`, and `maybe_await`, `then`, `mapa`, `acache`, `reawaitable`, `is_async_callable`, and the other async utilities moved there from `xtras`. `Config` and the config file functions moved from `foundation` to `xtras`. `fastcore.net` lost its request builders (`urlrequest`, `urlsend`, `do_request`, `urlcheck`) and `clean_type_str` is gone. `parallel_gen` is removed; the stdlib `ProcessPoolExecutor` `initializer` pattern replaces it (fastai's `parallel_tokenize` shows the recipe). Python 3.11 or later is now required. If you need the old APIs, pin `fastcore<2`.\n",
+    ":::"
    ]
   },
   {