BUG: Correct errors in period and interval

Author: bashtage

pandas-stubs/_libs/interval.pyi

@@ -63,10 +63,8 @@ class Interval(IntervalMixin, Generic[_OrderableT]):
     def right(self: Interval[_OrderableT]) -> _OrderableT: ...
     @property
     def closed(self) -> IntervalClosedType: ...
-    @property
-    def mid(self) -> _MidDescriptor: ...
-    @property
-    def length(self) -> _LengthDescriptor: ...
+    mid: _MidDescriptor
+    length: _LengthDescriptor
     def __init__(
         self,
         left: _OrderableT,

pandas-stubs/_libs/tslibs/period.pyi

@@ -1,8 +1,19 @@
+from datetime import tzinfo
 from typing import Any
 
+from .timestamps import Timestamp
+
 class IncompatibleFrequency(ValueError): ...
 
-class Period:
+from pandas._libs.tslibs.offsets import BaseOffset
+
+class PeriodMixin:
+    @property
+    def end_time(self) -> Timestamp: ...
+    @property
+    def start_time(self) -> Timestamp: ...
+
+class Period(PeriodMixin):
     def __init__(
         self,
         value: Any = ...,
@@ -16,14 +27,27 @@ class Period:
         minute: int = ...,
         second: int = ...,
     ) -> None: ...
+    def __new__(
+        cls,
+        value: Period | str = ...,
+        freq: int | str | BaseOffset | None = ...,
+        ordinal: int | None = ...,
+        year: int | None = ...,
+        month: int | None = ...,
+        quarter: int | None = ...,
+        day: int | None = ...,
+        hour: int | None = ...,
+        minute: int | None = ...,
+        second: int | None = ...,
+    ) -> Period: ...
+    def __sub__(self, other) -> Period | BaseOffset: ...
     def __add__(self, other) -> Period: ...
     def __eq__(self, other) -> bool: ...
     def __ge__(self, other) -> bool: ...
     def __gt__(self, other) -> bool: ...
     def __hash__(self) -> int: ...
     def __le__(self, other) -> bool: ...
     def __lt__(self, other) -> bool: ...
-    def __new__(cls, *args, **kwargs) -> Period: ...
     def __ne__(self, other) -> bool: ...
     def __radd__(self, other) -> Period: ...
     def __reduce__(self, *args, **kwargs) -> Any: ...  # what should this be?
@@ -71,12 +95,18 @@ class Period:
     def weekofyear(self) -> int: ...
     @property
     def year(self) -> int: ...
-    # Static methods
+    @property
+    def day_of_year(self) -> int: ...
+    @property
+    def day_of_week(self) -> int: ...
+    def asfreq(self, freq: str | BaseOffset, how: str = ...) -> Period: ...
     @classmethod
-    def now(cls) -> Period: ...
-    # Methods
-    def asfreq(self, freq: str, how: str = ...) -> Period: ...
+    def now(cls, freq: BaseOffset = ...) -> Period: ...
     def strftime(self, fmt: str) -> str: ...
-    def to_timestamp(self, freq: str, how: str = ...) -> Timestamp: ...
-
-from .timestamps import Timestamp
+    def to_timestamp(
+        self,
+        freq: str | BaseOffset | None = ...,
+        how: str = ...,
+        tz: str | tzinfo | None = ...,
+    ) -> Timestamp: ...
+    def astype(self, dtype, copy: bool = ...): ...

pandas-stubs/core/arrays/period.pyi

@@ -1,80 +1,51 @@
-from datetime import tzinfo
+from typing import Sequence
 
 import numpy as np
+from pandas.core.arrays.datetimelike import (
+    DatelikeOps,
+    DatetimeLikeArrayMixin,
+)
 
-from pandas._libs.tslibs.nattype import NaTType
-from pandas._libs.tslibs.offsets import BaseOffset
+from pandas._libs.tslibs import Period
 from pandas._libs.tslibs.timestamps import Timestamp
 from pandas._typing import npt as npt
 
-class PeriodMixin:
-    @property
-    def end_time(self) -> Timestamp: ...
-    @property
-    def start_time(self) -> Timestamp: ...
+from pandas.tseries.offsets import Tick
 
-class Period(PeriodMixin):
-    ordinal: int
-    freq: BaseOffset
-    def __new__(
-        cls,
-        value: Period | str = ...,
-        freq: int | str | BaseOffset | None = ...,
-        ordinal: int | None = ...,
-        year: int | None = ...,
-        month: int | None = ...,
-        quarter: int | None = ...,
-        day: int | None = ...,
-        hour: int | None = ...,
-        minute: int | None = ...,
-        second: int | None = ...,
-    ) -> Period | NaTType: ...
-    @classmethod
-    def now(cls, freq: BaseOffset = ...) -> Period: ...
-    def strftime(self, fmt: str) -> str: ...
-    def to_timestamp(
-        self,
-        freq: str | BaseOffset | None = ...,
-        how: str = ...,
-        tz: str | tzinfo | None = ...,
-    ) -> Timestamp: ...
-    def asfreq(self, freq: str | BaseOffset, how: str = ...) -> Period: ...
-    @property
-    def freqstr(self) -> str: ...
+class PeriodArray(DatetimeLikeArrayMixin, DatelikeOps):
+    __array_priority__: int = ...
+    def __init__(self, values, freq=..., dtype=..., copy: bool = ...) -> None: ...
+    def dtype(self): ...
+    def __array__(self, dtype=...) -> np.ndarray: ...
+    def __arrow_array__(self, type=...): ...
+    year: int = ...
+    month: int = ...
+    day: int = ...
+    hour: int = ...
+    minute: int = ...
+    second: int = ...
+    weekofyear: int = ...
+    week: int = ...
+    dayofweek: int = ...
+    weekday: int = ...
+    dayofyear: int = ...
+    day_of_year = ...
+    quarter: int = ...
+    qyear: int = ...
+    days_in_month: int = ...
+    daysinmonth: int = ...
     @property
     def is_leap_year(self) -> bool: ...
     @property
-    def daysinmonth(self) -> int: ...
-    @property
-    def days_in_month(self) -> int: ...
-    @property
-    def qyear(self) -> int: ...
-    @property
-    def quarter(self) -> int: ...
-    @property
-    def day_of_year(self) -> int: ...
-    @property
-    def weekday(self) -> int: ...
-    @property
-    def day_of_week(self) -> int: ...
-    @property
-    def week(self) -> int: ...
-    @property
-    def weekofyear(self) -> int: ...
-    @property
-    def second(self) -> int: ...
-    @property
-    def minute(self) -> int: ...
-    @property
-    def hour(self) -> int: ...
-    @property
-    def day(self) -> int: ...
-    @property
-    def month(self) -> int: ...
+    def start_time(self) -> Timestamp: ...
     @property
-    def year(self) -> int: ...
-    def __sub__(self, other) -> Period | BaseOffset: ...
-    def __add__(self, other) -> Period: ...
+    def end_time(self) -> Timestamp: ...
     def to_timestamp(self, freq: str | None = ..., how: str = ...) -> Timestamp: ...
     def asfreq(self, freq: str | None = ..., how: str = ...) -> Period: ...
     def astype(self, dtype, copy: bool = ...): ...
+
+def period_array(
+    data: Sequence[Period | None],
+    freq: str | Tick | None = ...,
+    copy: bool = ...,
+) -> PeriodArray: ...