"""
Carbonic - A modern Python datetime library inspired by PHP Carbon.

A fluent, immutable datetime library built with dataclasses and stdlib zoneinfo.
"""

from carbonic.core.datetime import DateTime
from carbonic.core.date import Date
from carbonic.core.duration import Duration

__version__ = "0.1.0"

__all__ = [
    "DateTime",
    "Date",
    "Duration",
    "now",
    "today",
]

# Convenience functions for common operations
def now(tz: str | None = "UTC") -> DateTime:
    """Create a DateTime instance for the current moment."""
    return DateTime.now(tz)

def today(tz: str | None = None) -> Date:
    """Create a Date instance for today."""
    return Date.today(tz)