nsepython 2.99__py3-none-any.whl → 2.100__py3-none-any.whl

nsepython/rahu.py

@@ -1773,6 +1773,39 @@ def share_holding(symbol):
     return df
 
 
+def nse_annual_reports(symbol, year_from=None, year_to=None, index="equities"):
+    """Forum feature request (forum.unofficed.com topic 1459): list a listed
+    company's annual reports with direct PDF download links, optionally
+    filtered to a from/to year range. Backed by
+    `/api/annual-reports?index=equities&symbol=X`, confirmed live via
+    curl_cffi -- NOT the Akamai-walled historical/* family, just a plain
+    metadata+link listing, so this is reliable. `index` is almost always
+    "equities" (NSE also recognises "debt", but that returns no rows for a
+    pure-equity symbol like most NSE-listed companies). Each returned row's
+    `fileName` column IS the direct downloadable PDF/zip URL on
+    nsearchives.nseindia.com -- fetch it yourself (e.g. with `requests` or
+    `curl`) if you want the actual file; this function returns the metadata
+    + link, matching how every other *_history-style function in this
+    library works, rather than silently downloading files to disk.
+    `year_from`/`year_to` filter client-side on the report's `fromYr` (NSE's
+    own API has no year-range parameter, it always returns the full
+    available history -- commonly 15-20+ years for large-cap companies)."""
+    symbol = nsesymbolpurify(symbol)
+    payload = nsefetch(f"https://www.nseindia.com/api/annual-reports?index={index}&symbol={symbol}")
+    rows = payload.get("data") or []
+    df = pd.DataFrame.from_records(rows)
+    if df.empty:
+        return df
+    if year_from is not None or year_to is not None:
+        years = pd.to_numeric(df["fromYr"], errors="coerce")
+        if year_from is not None:
+            df = df[years >= int(year_from)]
+            years = years[df.index]
+        if year_to is not None:
+            df = df[years <= int(year_to)]
+    return df.reset_index(drop=True)
+
+
 #Request from subhash
 ## https://unofficed.com/how-to-find-the-beta-of-indian-stocks-using-python/
 def get_beta_df_maker(symbol,days):

{nsepython-2.99.dist-info → nsepython-2.100.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nsepython
-Version: 2.99
+Version: 2.100
 Summary: Python library for NSE India APIs
 Home-page: https://github.com/aeron7/nsepython
 Author: Aeron7

nsepython-2.100.dist-info/RECORD

@@ -0,0 +1,7 @@
+nsepython/__init__.py,sha256=_1YN_O25fj7GRUrOREinuxKiXiF0l4cs-Grzjec8mZg,41
+nsepython/rahu.py,sha256=fn_fApl5uw3sVtiSdzJHzfdC7tubdu9gI8-q1NL_KcQ,125978
+nsepython-2.100.dist-info/licenses/LICENSE,sha256=VXapH-nuSz68DG5ScURElxHkl1lKk4MOK9cgZCSRDXs,34502
+nsepython-2.100.dist-info/METADATA,sha256=qL-CuY5UNJsc6fUJgx7DC-ro314DP84secunyMNEi6E,7534
+nsepython-2.100.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+nsepython-2.100.dist-info/top_level.txt,sha256=-hTS08c-pS4rPpiuzLkamRsgHTq7t6BG0M5wnU-iPy4,10
+nsepython-2.100.dist-info/RECORD,,

nsepython-2.99.dist-info/RECORD

@@ -1,7 +0,0 @@
-nsepython/__init__.py,sha256=_1YN_O25fj7GRUrOREinuxKiXiF0l4cs-Grzjec8mZg,41
-nsepython/rahu.py,sha256=FTz7FfZOb2MilRtt1ENAxoHvFZtUC6J0A84mKQMuzis,124167
-nsepython-2.99.dist-info/licenses/LICENSE,sha256=VXapH-nuSz68DG5ScURElxHkl1lKk4MOK9cgZCSRDXs,34502
-nsepython-2.99.dist-info/METADATA,sha256=Ib_NPqQNPLNxP79vidhr1brGaj3SZbcXRL5mYUm3YZM,7533
-nsepython-2.99.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-nsepython-2.99.dist-info/top_level.txt,sha256=-hTS08c-pS4rPpiuzLkamRsgHTq7t6BG0M5wnU-iPy4,10
-nsepython-2.99.dist-info/RECORD,,