Add period of report to filing

Author: dgunning

edgar/_filings.py

@@ -1307,6 +1307,13 @@ def primary_documents(self):
         """
         return self.homepage.primary_documents
 
+    @property
+    def period_of_report(self):
+        """
+        Get the period of report for the filing
+        """
+        return self.homepage.period_of_report
+
     @property
     def attachments(self):
         # Return all the attachments on the filing

edgar/attachments.py

@@ -627,6 +627,12 @@ def get_filers(self):
 
         return filer_infos
 
+    @property
+    def period_of_report(self)-> Optional[str]:
+        "Get the period of report"
+        _,_, period = self.get_filing_dates()
+        return period
+
     @lru_cache(maxsize=None)
     def get_filing_dates(self)-> Optional[Tuple[str,str, Optional[str]]]:
         # Find the form grouping divs

tests/test_filing_metadata.py

@@ -5,3 +5,5 @@ def test_get_filing_period_from_homepage():
     home = f.homepage
     filing_date, acceptance, period = home.get_filing_dates()
     assert (filing_date, acceptance, period) == ('2025-01-03', '2025-01-03 16:28:38', '2025-01-02')
+    assert home.period_of_report == '2025-01-02'
+    assert f.period_of_report == '2025-01-02'