python-dateutil-rs 0.1.0__tar.gz → 0.1.2__tar.gz

{python_dateutil_rs-0.1.0 → python_dateutil_rs-0.1.2}/Cargo.lock

@@ -219,24 +219,25 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "460fbee9c2c2f33933d720630a6a0bac33ba7053db5344fac858d4b8952d77d5"
 
 [[package]]
-name = "dateutil-core"
-version = "0.1.0"
+name = "dateutil"
+version = "0.1.2"
 dependencies = [
  "bitflags",
  "chrono",
  "criterion",
  "iana-time-zone",
  "phf",
+ "rustc-hash",
  "smallvec",
  "thiserror",
 ]
 
 [[package]]
 name = "dateutil-py"
-version = "0.1.0"
+version = "0.1.2"
 dependencies = [
  "chrono",
- "dateutil-core",
+ "dateutil",
  "pyo3",
 ]
 
@@ -576,6 +577,12 @@ version = "0.8.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "dc897dd8d9e8bd1ed8cdad82b5966c3e0ecae09fb1907d58efaa013543185d0a"
 
+[[package]]
+name = "rustc-hash"
+version = "2.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94300abf3f1ae2e2b8ffb7b58043de3d399c73fa6f4b73826402a5c457614dbe"
+
 [[package]]
 name = "rustversion"
 version = "1.0.22"

{python_dateutil_rs-0.1.0 → python_dateutil_rs-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-dateutil-rs
-Version: 0.1.0
+Version: 0.1.2
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -142,7 +142,7 @@ Benchmarks compare the original `python-dateutil` (PyPI) and the Rust extension
 | Parser (parse) | **19.5x-36.0x** |
 | Parser (isoparse) | **13.0x-38.4x** |
 | RRule | **5.9x-63.7x** |
-| Timezone | **1.0x-896.7x** ¹ |
+| Timezone | **1.0x-896.7x** |
 | RelativeDelta | **2.0x-28.1x** |
 | Easter | **5.0x-7.3x** |
 

{python_dateutil_rs-0.1.0 → python_dateutil_rs-0.1.2}/README.md

@@ -120,7 +120,7 @@ Benchmarks compare the original `python-dateutil` (PyPI) and the Rust extension
 | Parser (parse) | **19.5x-36.0x** |
 | Parser (isoparse) | **13.0x-38.4x** |
 | RRule | **5.9x-63.7x** |
-| Timezone | **1.0x-896.7x** ¹ |
+| Timezone | **1.0x-896.7x** |
 | RelativeDelta | **2.0x-28.1x** |
 | Easter | **5.0x-7.3x** |
 

python_dateutil_rs-0.1.2/crates/dateutil-core/Cargo.toml

@@ -0,0 +1,30 @@
+[package]
+name = "dateutil"
+version = "0.1.2"
+edition = "2021"
+license = "MIT"
+description = "Fast date utility library — parser, relativedelta, rrule, timezone (Rust reimplementation of python-dateutil)"
+repository = "https://github.com/wakita181009/dateutil-rs"
+keywords = ["date", "datetime", "parser", "rrule", "timezone"]
+categories = ["date-and-time", "parser-implementations"]
+readme = "README.md"
+
+[lib]
+name = "dateutil"
+crate-type = ["rlib"]
+
+[dependencies]
+bitflags = "2"
+chrono = "0.4"
+phf = { version = "0.13", features = ["macros"] }
+rustc-hash = "2"
+smallvec = "1.15"
+thiserror = "2"
+iana-time-zone = "0.1"
+
+[dev-dependencies]
+criterion = { version = "0.8", features = ["html_reports"] }
+
+[[bench]]
+name = "benchmarks"
+harness = false

python_dateutil_rs-0.1.2/crates/dateutil-core/README.md

@@ -0,0 +1,209 @@
+# python-dateutil-rs
+
+[![PyPI](https://img.shields.io/pypi/v/python-dateutil-rs.svg?style=flat-square)](https://pypi.org/project/python-dateutil-rs/)
+[![Python](https://img.shields.io/pypi/pyversions/python-dateutil-rs.svg?style=flat-square)](https://pypi.org/project/python-dateutil-rs/)
+[![License](https://img.shields.io/pypi/l/python-dateutil-rs.svg?style=flat-square)](https://pypi.org/project/python-dateutil-rs/)
+[![CI](https://github.com/wakita181009/dateutil-rs/actions/workflows/ci.yml/badge.svg)](https://github.com/wakita181009/dateutil-rs/actions/workflows/ci.yml)
+[![Coverage](https://codecov.io/gh/wakita181009/dateutil-rs/branch/main/graph/badge.svg)](https://codecov.io/gh/wakita181009/dateutil-rs)
+
+A high-performance Rust-backed port of [python-dateutil](https://github.com/dateutil/dateutil) (v2.9.0).
+
+> **Status:** All core modules (easter, relativedelta, parser, rrule, tz) are rewritten in Rust via PyO3/maturin. The optimized `dateutil-core` + `dateutil-py` architecture delivers **2x-897x** speedups over python-dateutil.
+
+## Features
+
+- **Drop-in replacement** for `python-dateutil` — same API, same behavior
+- **Rust-accelerated:** easter, relativedelta, parser (`parse` / `isoparse`), rrule, tz, weekday
+- **Optimized core:** zero-copy parser, PHF lookup tables, bitflag filters, buffer-reusing rrule
+- **Comprehensive test suite** inherited from the original project
+- **Benchmark infrastructure** for side-by-side performance comparison
+- **Python 3.10-3.14** supported on Linux and macOS
+
+## Installation
+
+```bash
+pip install python-dateutil-rs
+```
+
+## Usage
+
+```python
+from dateutil_rs import (
+    parse, isoparse, relativedelta, rrule, rruleset, rrulestr,
+    easter, gettz, tzutc, tzoffset,
+    MONTHLY, MO, TU, WE, TH, FR, SA, SU,
+)
+
+# Parse date strings (zero-copy tokenizer)
+dt = parse("2026-01-15T10:30:00+09:00")
+
+# ISO-8601 strict parsing
+dt = isoparse("2026-01-15T10:30:00")
+
+# Relative deltas
+next_month = dt + relativedelta(months=+1)
+
+# Recurrence rules (buffer-reusing iterator)
+monthly = rrule(MONTHLY, count=5, dtstart=parse("2026-01-01"))
+dates = monthly.all()
+dates = list(monthly)           # also iterable
+first = monthly[0]              # indexing
+subset = monthly[1:3]           # slicing
+n = monthly.count()             # total occurrences
+dt in monthly                   # membership test
+
+# Timezones
+tokyo = gettz("Asia/Tokyo")
+utc = tzutc()
+
+# Easter
+easter_date = easter(2026)
+```
+
+## Development
+
+### Prerequisites
+
+- Python 3.10+
+- Rust toolchain
+- [uv](https://github.com/astral-sh/uv) (recommended) or pip
+
+### Setup
+
+```bash
+git clone https://github.com/wakita181009/dateutil-rs.git
+cd dateutil-rs
+uv sync --extra dev
+```
+
+### Building
+
+```bash
+# Build the native extension
+maturin develop --release
+
+# Development build (faster compilation)
+maturin develop -F python
+```
+
+### Running Tests
+
+```bash
+# Run the test suite
+uv run pytest tests/ -x -q
+
+# Run with coverage
+uv run pytest tests/ --cov=dateutil_rs
+
+# Run Rust tests
+cargo test -p dateutil-core
+cargo test --workspace
+```
+
+### Linting
+
+```bash
+uv run ruff check tests/ python/
+uv run ruff format --check tests/ python/
+uv run mypy python/
+cargo clippy --workspace
+```
+
+### Benchmarks
+
+Benchmarks compare the original `python-dateutil` (PyPI) and the Rust extension (`dateutil_rs`) using pytest-benchmark.
+
+#### Summary (vs python-dateutil)
+
+| Module | Speedup |
+|--------|---------|
+| Parser (parse) | **19.5x-36.0x** |
+| Parser (isoparse) | **13.0x-38.4x** |
+| RRule | **5.9x-63.7x** |
+| Timezone | **1.0x-896.7x** |
+| RelativeDelta | **2.0x-28.1x** |
+| Easter | **5.0x-7.3x** |
+
+> Measured on Apple Silicon (M-series), Python 3.13, release build. Full results: [benchmarks/RESULTS.md](benchmarks/RESULTS.md)
+
+```bash
+# Install the original python-dateutil for comparison
+uv pip install python-dateutil
+
+# Run benchmarks
+make bench
+
+# Run and save results as JSON
+make bench-save
+```
+
+## Project Structure
+
+```
+dateutil-rs/
+├── Cargo.toml                 # Workspace root
+├── pyproject.toml             # Python project config (maturin)
+├── crates/
+│   ├── dateutil-core/         # Pure Rust optimized core (crates.io)
+│   │   └── src/
+│   │       ├── lib.rs         # Crate root, public API
+│   │       ├── common.rs      # Weekday (MO-SU with N-th occurrence)
+│   │       ├── easter.rs      # Easter date calculations
+│   │       ├── error.rs       # Shared error types
+│   │       ├── relativedelta.rs
+│   │       ├── parser.rs      # parse() entry point
+│   │       ├── parser/        # tokenizer, parserinfo, isoparser
+│   │       ├── rrule.rs       # RRule entry point
+│   │       ├── rrule/         # iter, parse (rrulestr), set
+│   │       └── tz/            # tzutc, tzoffset, tzfile, tzlocal
+│   └── dateutil-py/           # PyO3 binding layer → PyPI package
+│       └── src/
+│           ├── lib.rs         # Module registration
+│           ├── py.rs          # Binding root + #[pymodule]
+│           └── py/            # Per-module bindings (common, conv, easter, parser, relativedelta, rrule, tz)
+├── python/dateutil_rs/        # Python package (maturin mixed layout)
+│   ├── __init__.py            # Re-exports from Rust native module
+│   ├── _native.pyi            # Type stubs for native module
+│   ├── py.typed               # PEP 561 marker
+│   └── parser.py              # parserinfo (Python subclass support)
+├── tests/                     # Python test suite
+├── benchmarks/                # pytest-benchmark comparisons
+├── .github/workflows/         # CI (ci.yml, publish.yml)
+├── Makefile
+└── LICENSE
+```
+
+### Crate Roles
+
+| Crate | Purpose | PyO3 | Publish To |
+|-------|---------|------|------------|
+| `dateutil-core` | Pure Rust optimized core | No | crates.io |
+| `dateutil-py` | PyO3 binding layer | Yes | PyPI (`python-dateutil-rs`) |
+
+## Implementation Status
+
+| Module | Status | Notes |
+|--------|:------:|-------|
+| common (Weekday) | ✅ | MO-SU constants with N-th occurrence |
+| easter | ✅ | 5.0x-7.3x faster, 3 calendar methods |
+| relativedelta | ✅ | 2.0x-28.1x faster |
+| parser (parse) | ✅ | 19.5x-36.0x faster, zero-copy tokenizer, PHF lookups |
+| parser (isoparse) | ✅ | 13.0x-38.4x faster |
+| parser (parserinfo) | ✅ | Customizable via Python subclass |
+| rrule / rruleset | ✅ | 5.9x-63.7x faster, bitflag filters, buffer reuse |
+| rrulestr | ✅ | RFC 5545 string parsing |
+| tz (tzutc, tzoffset, tzfile, tzlocal) | ✅ | 1.0x-896.7x faster |
+| tz utilities (gettz, datetime_exists, etc.) | ✅ | gettz with caching |
+
+## Roadmap
+
+1. ~~Python-only phase — Pure Python port with full test coverage~~ ✅
+2. ~~Rust core + PyO3 bindings — easter, relativedelta, parser, weekday~~ ✅
+3. ~~Rust rrule — Rewrite recurrence rules in Rust~~ ✅
+4. ~~Rust tz — Rewrite timezone support in Rust~~ ✅
+5. ~~Optimized core — zero-copy parser, buffer-reusing rrule, consolidated architecture~~ ✅
+6. **Release** — Publish dateutil-core to crates.io and python-dateutil-rs 1.0 to PyPI
+
+## License
+
+[MIT](LICENSE)

{python_dateutil_rs-0.1.0 → python_dateutil_rs-0.1.2}/crates/dateutil-core/benches/benchmarks.rs

@@ -1,14 +1,14 @@
 use criterion::{criterion_group, criterion_main, Criterion};
 use std::hint::black_box;
 use chrono::NaiveDate;
-use dateutil_core::common::Weekday;
-use dateutil_core::easter::{easter, EasterMethod};
-use dateutil_core::parser;
-use dateutil_core::parser::tokenizer;
-use dateutil_core::relativedelta::RelativeDelta;
-use dateutil_core::rrule::{Frequency, Recurrence, RRuleBuilder};
-use dateutil_core::rrule::parse::rrulestr;
-use dateutil_core::rrule::set::RRuleSet;
+use dateutil::common::Weekday;
+use dateutil::easter::{easter, EasterMethod};
+use dateutil::parser;
+use dateutil::parser::tokenizer;
+use dateutil::relativedelta::RelativeDelta;
+use dateutil::rrule::{Frequency, Recurrence, RRuleBuilder};
+use dateutil::rrule::parse::rrulestr;
+use dateutil::rrule::set::RRuleSet;
 
 fn bench_tokenizer(c: &mut Criterion) {
     c.bench_function("tokenize_simple_date", |b| {

{python_dateutil_rs-0.1.0 → python_dateutil_rs-0.1.2}/crates/dateutil-core/src/common.rs

@@ -189,30 +189,6 @@ mod tests {
         assert_eq!(wd_neg.to_string(), "SU(-100)");
     }
 
-    #[test]
-    fn test_weekday_negative_one_n() {
-        // Last occurrence (e.g., last Friday of month)
-        let wd = FR.with_n(Some(-1));
-        assert_eq!(wd.n(), Some(-1));
-        assert_eq!(wd.to_string(), "FR(-1)");
-    }
-
-    #[test]
-    fn test_weekday_clone_copy() {
-        let wd = MO.with_n(Some(2));
-        let cloned = wd;
-        assert_eq!(wd, cloned); // Copy semantics — both usable
-    }
-
-    #[test]
-    fn test_weekday_boundary_values() {
-        // Weekday 0 (Monday) and 6 (Sunday) are boundaries
-        let mon = Weekday::new(0, Some(1)).unwrap();
-        let sun = Weekday::new(6, Some(-1)).unwrap();
-        assert_eq!(mon.weekday(), 0);
-        assert_eq!(sun.weekday(), 6);
-    }
-
     #[test]
     fn test_weekday_all_invalid() {
         for i in 7..=255 {
@@ -227,14 +203,6 @@ mod tests {
         assert_ne!(a, b);
     }
 
-    #[test]
-    fn test_weekday_eq_none_vs_zero() {
-        // n=0 is now rejected at construction time (Weekday::new).
-        // with_n() bypasses validation for internal use, so test display.
-        let a = MO.with_n(None);
-        assert_eq!(a.to_string(), "MO");
-    }
-
     #[test]
     fn test_weekday_hash_with_n() {
         use std::collections::HashSet;
@@ -281,14 +249,6 @@ mod tests {
         }
     }
 
-    #[test]
-    fn test_weekday_equality_ignores_n_for_same_display() {
-        let a = MO.with_n(Some(1));
-        let b = MO.with_n(Some(-1));
-        assert_ne!(a, b);
-        assert_eq!(a.weekday(), b.weekday());
-    }
-
     #[test]
     fn test_weekday_hash_set_none() {
         use std::collections::HashSet;
@@ -297,4 +257,17 @@ mod tests {
         set.insert(MO.with_n(Some(1)));
         assert_eq!(set.len(), 2);
     }
+
+    #[test]
+    fn test_weekday_try_from_valid() {
+        let wd: Weekday = 3u8.try_into().unwrap();
+        assert_eq!(wd.weekday(), 3);
+        assert_eq!(wd.n(), None);
+    }
+
+    #[test]
+    fn test_weekday_try_from_invalid() {
+        let result: Result<Weekday, _> = 7u8.try_into();
+        assert!(result.is_err());
+    }
 }

{python_dateutil_rs-0.1.0 → python_dateutil_rs-0.1.2}/crates/dateutil-core/src/easter.rs

@@ -71,30 +71,6 @@ mod tests {
     use super::*;
     use chrono::Datelike;
 
-    #[test]
-    fn test_western_2024() {
-        assert_eq!(
-            easter(2024, EasterMethod::Western).unwrap(),
-            NaiveDate::from_ymd_opt(2024, 3, 31).unwrap()
-        );
-    }
-
-    #[test]
-    fn test_orthodox_2024() {
-        assert_eq!(
-            easter(2024, EasterMethod::Orthodox).unwrap(),
-            NaiveDate::from_ymd_opt(2024, 5, 5).unwrap()
-        );
-    }
-
-    #[test]
-    fn test_julian_326() {
-        assert_eq!(
-            easter(326, EasterMethod::Julian).unwrap(),
-            NaiveDate::from_ymd_opt(326, 4, 3).unwrap()
-        );
-    }
-
     #[test]
     fn test_invalid_method_from_i32() {
         assert!(matches!(
@@ -107,18 +83,6 @@ mod tests {
         ));
     }
 
-    #[test]
-    fn test_invalid_year() {
-        assert!(matches!(
-            easter(0, EasterMethod::Western),
-            Err(EasterError::InvalidYear(0))
-        ));
-        assert!(matches!(
-            easter(-1, EasterMethod::Western),
-            Err(EasterError::InvalidYear(-1))
-        ));
-    }
-
     #[test]
     fn test_western_range_1990_2050() {
         let expected: Vec<(i32, u32, u32)> = vec![
@@ -347,14 +311,6 @@ mod tests {
         );
     }
 
-    #[test]
-    fn test_orthodox_boundary_exact_1600() {
-        let d1600 = easter(1600, EasterMethod::Orthodox).unwrap();
-        let d1601 = easter(1601, EasterMethod::Orthodox).unwrap();
-        assert!((3..=5).contains(&d1600.month()));
-        assert!((3..=5).contains(&d1601.month()));
-    }
-
     #[test]
     fn test_easter_always_sunday_western_wide_range() {
         // Western (Gregorian) Easter is always Sunday across a wide year range

{python_dateutil_rs-0.1.0 → python_dateutil_rs-0.1.2}/crates/dateutil-core/src/parser/isoparser.rs

@@ -591,4 +591,25 @@ mod tests {
     fn test_iso_leap_second_rejected() {
         assert!(isoparse("2024-01-15T23:59:60").is_err());
     }
+
+    #[test]
+    fn test_iso_hhmm_colon_format() {
+        let dt = isoparse("2024-01-15T10:30").unwrap();
+        assert_eq!(dt.hour(), 10);
+        assert_eq!(dt.minute(), 30);
+        assert_eq!(dt.second(), 0);
+    }
+
+    #[test]
+    fn test_iso_unrecognized_time_format() {
+        let result = isoparse("2024-01-15TX");
+        assert!(result.is_err());
+    }
+
+    #[test]
+    fn test_iso_fractional_dot_only() {
+        let dt = isoparse("2024-01-15T10:30:45.").unwrap();
+        assert_eq!(dt.second(), 45);
+        assert_eq!(dt.nanosecond(), 0);
+    }
 }

{python_dateutil_rs-0.1.0 → python_dateutil_rs-0.1.2}/crates/dateutil-core/src/parser/parserinfo.rs

@@ -315,4 +315,44 @@ mod tests {
         assert_eq!(do_tzoffset("est", Some(&info)), Some(-18000));
         assert_eq!(do_month("January", Some(&info)), Some(1));
     }
+
+    #[test]
+    fn test_parserinfo_hms() {
+        let info = ParserInfo::default();
+        assert_eq!(info.hms("hour"), Some(0));
+        assert_eq!(info.hms("HOURS"), Some(0));
+        assert_eq!(info.hms("minute"), Some(1));
+        assert_eq!(info.hms("s"), Some(2));
+        assert_eq!(info.hms("xyz"), None);
+    }
+
+    #[test]
+    fn test_parserinfo_ampm() {
+        let info = ParserInfo::default();
+        assert_eq!(info.ampm("am"), Some(0));
+        assert_eq!(info.ampm("AM"), Some(0));
+        assert_eq!(info.ampm("p"), Some(1));
+        assert_eq!(info.ampm("PM"), Some(1));
+        assert_eq!(info.ampm("xyz"), None);
+    }
+
+    #[test]
+    fn test_parserinfo_pertain() {
+        let info = ParserInfo::default();
+        assert!(info.pertain("of"));
+        assert!(info.pertain("OF"));
+        assert!(!info.pertain("xyz"));
+    }
+
+    #[test]
+    fn test_dispatch_with_some_info() {
+        let info = ParserInfo::default();
+        assert!(do_jump(",", Some(&info)));
+        assert_eq!(do_weekday("Monday", Some(&info)), Some(0));
+        assert_eq!(do_month("January", Some(&info)), Some(1));
+        assert_eq!(do_hms("hour", Some(&info)), Some(0));
+        assert_eq!(do_ampm("AM", Some(&info)), Some(0));
+        assert!(do_pertain("of", Some(&info)));
+        assert!(do_utczone("UTC", Some(&info)));
+    }
 }