earningscall 1.2.1__py3-none-any.whl → 1.3.1__py3-none-any.whl

earningscall/api.py

@@ -1,10 +1,9 @@
-import importlib
+import importlib.metadata
 import logging
 import os
 import platform
 import time
 import urllib.parse
-from importlib.metadata import PackageNotFoundError
 from typing import Dict, Optional, Union
 
 import requests
@@ -65,7 +64,7 @@ def purge_cache():
 def get_earnings_call_version():
     try:
         return importlib.metadata.version("earningscall")
-    except PackageNotFoundError:
+    except importlib.metadata.PackageNotFoundError:
         return None
 
 
@@ -164,7 +163,7 @@ def do_get(
             log.warning(
                 f"Rate limited (429). Retrying in {wait_time} seconds... (Attempt {attempt + 1}/{max_attempts})"
             )
-            time.sleep(wait_time)
+            time.sleep(float(wait_time))
 
     return response  # Return the last response if all retries failed
 
@@ -266,3 +265,36 @@ def download_audio_file(
             for chunk in response.iter_content(chunk_size=8192):
                 f.write(chunk)
     return local_filename
+
+
+def download_slide_deck(
+    exchange: str,
+    symbol: str,
+    year: int,
+    quarter: int,
+    file_name: Optional[str] = None,
+) -> Optional[str]:
+    """
+    Get the slide deck for a given exchange, symbol, year, and quarter.
+
+    :param str exchange: The exchange to get the slide deck for.
+    :param str symbol: The symbol to get the slide deck for.
+    :param int year: The 4-digit year to get the slide deck for.
+    :param int quarter: The quarter to get the slide deck for (1, 2, 3, or 4).
+    :param file_name: Optionally specify the filename to save the slide deck to.
+    :return: The filename of the downloaded slide deck file.
+    :rtype Optional[str]: The filename of the downloaded slide deck file.
+    """
+    params = {
+        "exchange": exchange,
+        "symbol": symbol,
+        "year": str(year),
+        "quarter": str(quarter),
+    }
+    local_filename = file_name or f"{exchange}_{symbol}_{year}_{quarter}_slides.pdf"
+    with do_get("slides", params=params, stream=True) as response:
+        response.raise_for_status()
+        with open(local_filename, "wb") as f:
+            for chunk in response.iter_content(chunk_size=8192):
+                f.write(chunk)
+    return local_filename

earningscall/company.py

@@ -164,3 +164,51 @@ class Company:
                 log.error(error_message)
                 raise InsufficientApiAccessError(error_message)
             raise error
+
+    def download_slide_deck(
+        self,
+        year: Optional[int] = None,
+        quarter: Optional[int] = None,
+        event: Optional[EarningsEvent] = None,
+        file_name: Optional[str] = None,
+    ) -> Optional[str]:
+        """
+        Download the slide deck for a given year and quarter.
+
+        :param Optional[int] year: The year to get the slide deck for.
+        :param Optional[int] quarter: The quarter to get the slide deck for.
+        :param Optional[EarningsEvent] event: The event to get the slide deck for.
+        :param Optional[str] file_name: The file name to save the slide deck to.
+
+        :return: The filename of the downloaded slide deck file.
+        """
+        if not self.company_info.exchange or not self.company_info.symbol:
+            return None
+        if (not year or not quarter) and event:
+            year = event.year
+            quarter = event.quarter
+        if not year or not quarter:
+            raise ValueError("Must specify either event or year and quarter")
+        if quarter < 1 or quarter > 4:
+            raise ValueError("Invalid quarter. Must be one of: {1,2,3,4}")
+        try:
+            resp = api.download_slide_deck(
+                exchange=self.company_info.exchange,
+                symbol=self.company_info.symbol,
+                year=year,
+                quarter=quarter,
+                file_name=file_name,
+            )
+            return resp
+        except requests.exceptions.HTTPError as error:
+            if error.response.status_code == 404:
+                return None
+            if error.response.status_code == 403:
+                plan_name = error.response.headers["X-Plan-Name"]
+                error_message = (
+                    f"Your plan ({plan_name}) does not include Slide Decks. "
+                    "Upgrade your plan here: https://earningscall.biz/api-pricing"
+                )
+                log.error(error_message)
+                raise InsufficientApiAccessError(error_message)
+            raise error

{earningscall-1.2.1.dist-info → earningscall-1.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: earningscall
-Version: 1.2.1
+Version: 1.3.1
 Summary: The EarningsCall Python library provides convenient access to the EarningsCall API.  It includes a pre-defined set of classes for API resources that initialize themselves dynamically from API responses.
 Project-URL: Homepage, https://earningscall.biz
 Project-URL: Documentation, https://github.com/EarningsCall/earningscall-python
@@ -257,7 +257,19 @@ from earningscall import get_company
 company = get_company("aapl")  # Lookup Apple, Inc by its ticker symbol, "AAPL"
 
 print("Downloading audio file for Apple Inc. Q3 2021...")
-audio_file = company.download_audio_file(year=2021, quarter=3, file_name="Apple Q3 2021.mp3")
+audio_file = company.download_audio_file(year=2021, quarter=3, file_name="Apple-Q3-2021.mp3")
+print(f"Downloaded audio file to: {audio_file}")
+```
+
+## Download Slide Deck
+
+```python
+from earningscall import get_company
+
+company = get_company("MSFT")  # Lookup Microsoft by its ticker symbol, "MSFT"
+
+slide_deck_filename = company.download_slide_deck(year=2025, quarter=1, file_name="Microsoft-Q1-2025-Slides.pdf")
+print(f"Downloaded slide deck to: {slide_deck_filename}")
 ```
 
 ## Get Earnings Event Calendar

{earningscall-1.2.1.dist-info → earningscall-1.3.1.dist-info}/RECORD

@@ -1,7 +1,7 @@
 earningscall/__init__.py,sha256=J1cBpSRDBivNtYDB-LIMNBZu6rQ3-_1eCY6ACFHlHhE,470
-earningscall/api.py,sha256=zI7XrxC73pJXZX9Qe1te-EKVS3G-0VVz5FBiuFbi-W8,7936
+earningscall/api.py,sha256=iFdgQG15ieAMdUDBiPQXgLetdvee0fLq2WoBiF8vP-c,9140
 earningscall/calendar.py,sha256=nQcb0UsVwCDhvvcr7dqdY0PCqdVGohB7JDON7jtbRyM,725
-earningscall/company.py,sha256=7ISobyp3gSj9f1bj53FvmzCCOBLzfqk_uVO_5maDTac,6754
+earningscall/company.py,sha256=Bp2tVNzuH91AW4vOut_7th-w9tUxu9LeAUgRH35ypEc,8776
 earningscall/errors.py,sha256=aLgwrrpMmYThYEZjCGOhqS57a-GoC0xj2BdbtJ20sy8,490
 earningscall/event.py,sha256=Jf7KPvpeaF9KkeHe46LbL_HIYLXkyHrs3psq-ZY-bkI,692
 earningscall/exports.py,sha256=G9eZqX_QydfS5O039Wa0rl4Si3KrC_pGyBZ_cxfUrtI,3147
@@ -9,7 +9,7 @@ earningscall/sectors.py,sha256=Xd6DLkAQ_fQkC2s-N9pReC8b_M3iy77OoFftoZj9FWY,5114
 earningscall/symbols.py,sha256=NxabgKfZZI1YwDLUwh_MlNgyfkR9VZdcU-LqkGWwi28,6521
 earningscall/transcript.py,sha256=P-CeTYhE5T78SXDHFEJ0AlVUFz2XPxDMtkeiorziBiw,1007
 earningscall/utils.py,sha256=Qx8KhlumUdzyBSZRKMS6vpWlb8MGZpLKA4OffJaMdCE,1032
-earningscall-1.2.1.dist-info/METADATA,sha256=83qqm2w9Npv1Pkj5g0B72ht2kiLIy8kpPCKVIA3hAAg,16667
-earningscall-1.2.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-earningscall-1.2.1.dist-info/licenses/LICENSE,sha256=ktEB_UcRMg2cQlX9wiDs544xWncWizwS9mEZuGsCLrM,1069
-earningscall-1.2.1.dist-info/RECORD,,
+earningscall-1.3.1.dist-info/METADATA,sha256=RPZqQd2U_5UCovfMylo2FacWwv597qwuwCHmFrgO5ck,17045
+earningscall-1.3.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+earningscall-1.3.1.dist-info/licenses/LICENSE,sha256=ktEB_UcRMg2cQlX9wiDs544xWncWizwS9mEZuGsCLrM,1069
+earningscall-1.3.1.dist-info/RECORD,,