DOC/BUG: Enforce that freq is required in Period.now (#49134)

Author: bashtage

pandas/_libs/tslibs/period.pyx

@@ -2288,9 +2288,14 @@ cdef class _Period(PeriodMixin):
         return bool(is_leapyear(self.year))
 
     @classmethod
-    def now(cls, freq=None):
+    def now(cls, freq):
         """
         Return the period of now's date.
+
+        Parameters
+        ----------
+        freq : str, BaseOffset
+            Frequency to use for the returned period.
         """
         return Period(datetime.now(), freq=freq)
 

pandas/tests/scalar/period/test_period.py

@@ -76,6 +76,13 @@ def test_construction(self):
         assert i1 == i2
         assert i1 == i3
 
+        i1 = Period.now("D")
+        i2 = Period(datetime.now(), freq="D")
+        i3 = Period.now(offsets.Day())
+
+        assert i1 == i2
+        assert i1 == i3
+
         i1 = Period("1982", freq="min")
         i2 = Period("1982", freq="MIN")
         assert i1 == i2