Allow local date for inline exclude newer

crates/uv-resolver/src/exclude_newer.rs

@@ -3,7 +3,7 @@ use std::str::FromStr;
 use jiff::{tz::TimeZone, Timestamp, ToSpan};
 
 /// A timestamp that excludes files newer than it.
-#[derive(Debug, Copy, Clone, PartialEq, Eq, serde::Deserialize, serde::Serialize)]
+#[derive(Debug, Copy, Clone, PartialEq, Eq, serde::Serialize)]
 pub struct ExcludeNewer(Timestamp);
 
 impl ExcludeNewer {
@@ -59,6 +59,16 @@ impl FromStr for ExcludeNewer {
     }
 }
 
+impl<'de> serde::Deserialize<'de> for ExcludeNewer {
+    fn deserialize<D>(deserializer: D) -> Result<ExcludeNewer, D::Error>
+    where
+        D: serde::Deserializer<'de>,
+    {
+        let s = String::deserialize(deserializer)?;
+        FromStr::from_str(&s).map_err(serde::de::Error::custom)
+    }
+}
+
 impl std::fmt::Display for ExcludeNewer {
     fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
         self.0.fmt(f)

docs/guides/scripts.md

@@ -195,6 +195,30 @@ print(Point)
 is not installed — see the documentation on [Python versions](../concepts/python-versions.md) for
 more details.
 
+## Improving reproducibility
+
+uv supports an `exclude-newer` field in the `tool.uv` section of inline script metadata to limit uv
+to only considering distributions released before a specific date. This is useful for improving the
+reproducibility of your script when run at a later point in time.
+
+The date may be specified as an [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339.html) timestamp
+(e.g., `2006-12-02T02:07:43Z`) or a local date in the same format (e.g., `2006-12-02`) in your
+system's configured time zone.
+
+```python title="example.py"
+# /// script
+# dependencies = [
+#   "requests",
+# ]
+# [tool.uv]
+# exclude-newer = "2020-01-23"
+# ///
+
+import requests
+
+print(requests.__version__)
+```
+
 ## Using different Python versions
 
 uv allows arbitrary Python versions to be requested on each script invocation, for example: