DateOffset.offset vs DateOffset._offset

tseries.offsets.DateOffset has a _offset attribute. Many subclasses do not have this attribute, but do have a offset attribute. The main difference in the two appears to be that _offset is ignored by __eq__ (see #17137).

The question: why two separate attributes? Is this intentional or coincidence?

[jbrockmendel]

There are some inconsistencies in how offsets handles kwds that need to be cleaned up if we want offsets to be immutable. I have not found a way to clean them up that maintains backward compatibility in extremely weird corner cases. Take BusinessDay as an example:

class BusinessDay(SingleConstructorOffset):
    def __init__(self, n=1, normalize=False, **kwds):
        self.n = int(n)
        self.normalize = normalize
        self.kwds = kwds
        self.offset = kwds.get('offset', timedelta(0))

I’d like to get a green-light to change this behavior:

In [1]: from datetime import timedelta
In [2]: from pandas.tseries.offsets import *
In [3]: bd = BusinessDay()
In [4]: bd2 = BusinessDay(offset=timedelta(0))

In [5]: bd
Out[5]: <BusinessDay>

In [6]: bd == bd2
Out[6]: True

In [7]: bd.kwds
Out[7]: {}

In [8]: bd2.kwds
Out[8]: {'offset': datetime.timedelta(0)}

In [9]: bd - bd2
Out[9]: <0 * BusinessDays>

In [10]: bd2 - bd
Out[10]: <0 * BusinessDays>

In [11]: (bd - bd2).kwds
Out[11]: {}

In [12]: (bd2 - bd).kwds
Out[12]: {'offset': datetime.timedelta(0)}

Similar behavior shows up in the other BusinessFooOffsets, Week, and QuarterOffset. Many of the others will display unwanted behavior if users pass unsupported keyword args:

In [33]: sms = SemiMonthBegin(clark='kent')
In [34]: sms
Out[34]: <SemiMonthBegin: day_of_month=15, kwds={'clark': 'kent'}>

Best case I’d like to get rid of DateOffset.kwds altogether and explicitly specify the args/kwargs in the various __init__ methods (this will require patching a few other methods that check self.kwds, but that isn’t a big deal). That will break backward compat for any users who-- for some reason-- explicitly use that attribute.

If that is too big a break, the next-best option would be to

1. add validation in __init__ that only supported kwargs have been passed (this is done in a few existing code paths). This will take care of the SemiMonthBegin(clark='kent') cases.

2. ensure that default values for kwds are handled consistently. e.g. in the BusinessDay.__init__ example above, kwds.get('offset', timedelta(0)) would be changed to kwds.setdefault('offset', timedelta(0)).

[jreback]

yep those look wrong

why don’t do a PR just to fix those