earningscall 1.1.0__tar.gz → 1.2.0__tar.gz

{earningscall-1.1.0 → earningscall-1.2.0}/.gitignore

@@ -36,4 +36,7 @@ tasks.xml
 
 # Root files
 /.coverage*
-/.mypy_cache/
+/.mypy_cache/
+
+# Downloaded Data from Scripts
+/data

earningscall-1.2.0/.python-version

@@ -0,0 +1 @@
+3.12.9

{earningscall-1.1.0 → earningscall-1.2.0}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## Release `1.2.0` - 2025-02-12
+
+* Add `get_calendar` function to get the calendar for a given date.
+
+## Release `1.1.1` - 2025-01-26
+
+* Modify default retry strategy to use 1s base delay and 10 max attempts (necessary for starter plan).
+* Check for HTTP 401 Unauthorized status code from server and raise a helpful error message to the user.
+* Update documentation and example scripts to reflect new retry configuration
+
 ## Release `1.1.0` - 2025-01-26
 
 * Add backoff and retry logic to all API calls.

{earningscall-1.1.0 → earningscall-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: earningscall
-Version: 1.1.0
+Version: 1.2.0
 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
@@ -260,6 +260,20 @@ 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")
 ```
 
+## Get Earnings Event Calendar
+
+```python
+from datetime import date
+
+from earningscall import get_calendar
+
+calendar = get_calendar(date(2025, 1, 10))
+
+for event in calendar:
+    print(f"{event.company_name} - Q{event.quarter} {event.year} on: {event.conference_date.astimezone().isoformat()} Transcript Ready: {event.transcript_ready}")
+```
+
+
 ## List All Companies
 
 ```python
@@ -297,7 +311,6 @@ for company in get_sp500_companies():
     print(f"{company.company_info} -- {company.company_info.sector} -- {company.company_info.industry}")
 ```
 
-
 ## Advanced
 
 ### Disable Caching
@@ -324,8 +337,8 @@ Depending on your specific requirements, you can adjust the retry strategy. For
 To customize the retry behavior, set the `retry_strategy` variable with the desired parameters:
 
 - **strategy**: "exponential" | "linear" — defines the type of retry strategy (default is "exponential").
-- **base_delay**: float (in seconds) — specifies the delay between retries (default is 3 seconds).
-- **max_attempts**: int — sets the maximum number of total request attempts (default is 5).
+- **base_delay**: float (in seconds) — specifies the delay between retries (default is 1 seconds).
+- **max_attempts**: int — sets the maximum number of total request attempts (default is 10).
 
 #### Default Retry Strategy
 
@@ -336,8 +349,8 @@ import earningscall
 
 earningscall.retry_strategy = {
     "strategy": "exponential",
-    "base_delay": 3,
-    "max_attempts": 5,
+    "base_delay": 1,
+    "max_attempts": 10,
 }
 ```
 
@@ -350,7 +363,7 @@ import earningscall
 
 earningscall.retry_strategy = {
     "strategy": "exponential",
-    "base_delay": 3,
+    "base_delay": 1,
     "max_attempts": 1,
 }
 ```

{earningscall-1.1.0 → earningscall-1.2.0}/README.md

@@ -208,6 +208,20 @@ 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")
 ```
 
+## Get Earnings Event Calendar
+
+```python
+from datetime import date
+
+from earningscall import get_calendar
+
+calendar = get_calendar(date(2025, 1, 10))
+
+for event in calendar:
+    print(f"{event.company_name} - Q{event.quarter} {event.year} on: {event.conference_date.astimezone().isoformat()} Transcript Ready: {event.transcript_ready}")
+```
+
+
 ## List All Companies
 
 ```python
@@ -245,7 +259,6 @@ for company in get_sp500_companies():
     print(f"{company.company_info} -- {company.company_info.sector} -- {company.company_info.industry}")
 ```
 
-
 ## Advanced
 
 ### Disable Caching
@@ -272,8 +285,8 @@ Depending on your specific requirements, you can adjust the retry strategy. For
 To customize the retry behavior, set the `retry_strategy` variable with the desired parameters:
 
 - **strategy**: "exponential" | "linear" — defines the type of retry strategy (default is "exponential").
-- **base_delay**: float (in seconds) — specifies the delay between retries (default is 3 seconds).
-- **max_attempts**: int — sets the maximum number of total request attempts (default is 5).
+- **base_delay**: float (in seconds) — specifies the delay between retries (default is 1 seconds).
+- **max_attempts**: int — sets the maximum number of total request attempts (default is 10).
 
 #### Default Retry Strategy
 
@@ -284,8 +297,8 @@ import earningscall
 
 earningscall.retry_strategy = {
     "strategy": "exponential",
-    "base_delay": 3,
-    "max_attempts": 5,
+    "base_delay": 1,
+    "max_attempts": 10,
 }
 ```
 
@@ -298,7 +311,7 @@ import earningscall
 
 earningscall.retry_strategy = {
     "strategy": "exponential",
-    "base_delay": 3,
+    "base_delay": 1,
     "max_attempts": 1,
 }
 ```

earningscall-1.2.0/earningscall/__init__.py

@@ -0,0 +1,17 @@
+from typing import Dict, Optional, Union
+
+from earningscall.exports import get_company, get_all_companies, get_sp500_companies, get_calendar
+from earningscall.symbols import Symbols, load_symbols
+
+api_key: Optional[str] = None
+enable_requests_cache: bool = True
+retry_strategy: Optional[Dict[str, Union[str, int, float]]] = None
+
+__all__ = [
+    "get_company",
+    "get_all_companies",
+    "get_sp500_companies",
+    "Symbols",
+    "load_symbols",
+    "get_calendar",
+]

{earningscall-1.1.0 → earningscall-1.2.0}/earningscall/api.py

@@ -1,21 +1,27 @@
 import importlib
-import platform
-import urllib.parse
 import logging
 import os
+import platform
 import time
+import urllib.parse
 from importlib.metadata import PackageNotFoundError
-from typing import Optional
+from typing import Dict, Optional, Union
 
 import requests
 from requests_cache import CachedSession
 
 import earningscall
+from earningscall.errors import InvalidApiKeyError
 
 log = logging.getLogger(__file__)
 
-DOMAIN = os.environ.get("ECALL_DOMAIN", "earningscall.biz")
+DOMAIN = os.environ.get("EARNINGSCALL_DOMAIN", "earningscall.biz")
 API_BASE = f"https://v2.api.{DOMAIN}"
+DEFAULT_RETRY_STRATEGY: Dict[str, Union[str, int, float]] = {
+    "strategy": "exponential",
+    "base_delay": 1,
+    "max_attempts": 10,
+}
 
 
 def get_api_key():
@@ -121,8 +127,9 @@ def do_get(
         full_url = f"{url}?{urllib.parse.urlencode(params)}"
         log.debug(f"GET: {full_url}")
 
-    delay = earningscall.retry_strategy["base_delay"]
-    max_attempts = int(earningscall.retry_strategy["max_attempts"])
+    retry_strategy = earningscall.retry_strategy or DEFAULT_RETRY_STRATEGY
+    delay = retry_strategy["base_delay"]
+    max_attempts = int(retry_strategy["max_attempts"])
 
     for attempt in range(max_attempts):
         if use_cache and earningscall.enable_requests_cache:
@@ -138,16 +145,22 @@ def do_get(
         if is_success(response):
             return response
 
+        if response.status_code == 401:
+            raise InvalidApiKeyError(
+                "Your API key is invalid. You can get your API key at: https://earningscall.biz/api-key"
+            )
+
         if not can_retry(response):
             return response
 
         if attempt < max_attempts - 1:  # Don't sleep after the last attempt
-            if earningscall.retry_strategy["strategy"] == "exponential":
-                wait_time = delay * (2**attempt)  # Exponential backoff: 3s -> 6s -> 12s -> 24s -> 48s
-            elif earningscall.retry_strategy["strategy"] == "linear":
-                wait_time = delay * (attempt + 1)  # Linear backoff: 3s -> 6s -> 9s -> 12s -> 15s
+            if retry_strategy["strategy"] == "exponential":
+                wait_time = delay * (2**attempt)  # Exponential backoff: 1s -> 2s -> 4s -> 8s -> 16s -> 32s -> 64s
+            elif retry_strategy["strategy"] == "linear":
+                wait_time = delay * (attempt + 1)  # Linear backoff: 1s -> 2s -> 3s -> 4s -> 5s -> 6s -> 7s
             else:
                 raise ValueError("Invalid retry strategy. Must be one of: 'exponential', 'linear'")
+            # TODO: Should we log a warning here?  Does the customer want to see this log?
             log.warning(
                 f"Rate limited (429). Retrying in {wait_time} seconds... (Attempt {attempt + 1}/{max_attempts})"
             )
@@ -156,7 +169,18 @@ def do_get(
     return response  # Return the last response if all retries failed
 
 
-def get_events(exchange: str, symbol: str):
+def get_calendar_api_operation(year: int, month: int, day: int) -> dict:
+    params = {
+        "year": str(year),
+        "month": str(month),
+        "day": str(day),
+    }
+    response = do_get("calendar", params=params)
+    response.raise_for_status()
+    return response.json()
+
+
+def get_events(exchange: str, symbol: str) -> Optional[dict]:
     params = {
         "exchange": exchange,
         "symbol": symbol,

earningscall-1.2.0/earningscall/calendar.py

@@ -0,0 +1,30 @@
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import Optional
+
+from dataclasses_json import config
+from dataclasses_json import dataclass_json
+from marshmallow import fields
+
+
+@dataclass_json
+@dataclass
+class CalendarEvent:
+    """
+    CalendarEvent
+    """
+
+    company_name: str
+    exchange: str
+    symbol: str
+    year: int
+    quarter: int
+    transcript_ready: bool
+    conference_date: Optional[datetime] = field(
+        default=None,
+        metadata=config(
+            encoder=lambda date: date.isoformat() if date else None,
+            decoder=lambda date: datetime.fromisoformat(date) if date else None,
+            mm_field=fields.DateTime(format="iso"),
+        ),
+    )

{earningscall-1.1.0 → earningscall-1.2.0}/earningscall/errors.py

@@ -22,3 +22,7 @@ class ClientError(BaseError):
 
 class InsufficientApiAccessError(ClientError):
     pass
+
+
+class InvalidApiKeyError(ClientError):
+    pass

earningscall-1.2.0/earningscall/exports.py

@@ -0,0 +1,86 @@
+import datetime
+from datetime import date, timedelta
+from typing import List, Optional, Iterator
+
+import requests
+
+from earningscall import api
+from earningscall.api import get_sp500_companies_txt_file, is_demo_account
+from earningscall.calendar import CalendarEvent
+from earningscall.company import Company
+from earningscall.errors import InsufficientApiAccessError
+from earningscall.symbols import get_symbols
+
+
+def get_company(symbol: str, exchange: Optional[str] = None) -> Optional[Company]:
+    """
+    Get a company by symbol and optionally an exchange.
+
+    :param str symbol: The symbol to get the company for.
+    :param Optional[str] exchange: The exchange to get the company for.
+
+    :return: The company for the given symbol and exchange.
+    """
+    company_info = get_symbols().lookup_company(symbol=symbol, exchange=exchange)
+    if company_info:
+        return Company(company_info=company_info)
+    return None
+
+
+def get_all_companies() -> Iterator[Company]:
+    """
+    Get all companies.
+
+    :return: An iterator of all companies that is available to the current API plan.
+    """
+    for company_info in get_symbols().get_all():
+        yield Company(company_info=company_info)
+
+
+def get_sp500_companies() -> Iterator[Company]:
+    """
+    Get all S&P 500 companies.
+
+    :return: An iterator of all S&P 500 companies that is available to the current API plan.
+    """
+    resp = get_sp500_companies_txt_file()
+    if not resp:
+        return
+    for ticker_symbol in resp.split("\n"):
+        company_info = get_symbols().lookup_company(ticker_symbol)
+        if company_info:
+            yield Company(company_info=company_info)
+
+
+def get_calendar(input_date: date) -> List[CalendarEvent]:
+    """
+    Get the earnings event calendar for a given input date.
+
+    :param date input_date: The date to get the calendar for.
+
+    :return: A list of CalendarEvent objects.
+    """
+    if not input_date:
+        raise ValueError("Date is required")
+    if isinstance(input_date, datetime.datetime):
+        input_date = input_date.date()
+    if not isinstance(input_date, date):
+        raise ValueError("Date must be a date object")
+    if input_date < date(2018, 1, 1):
+        raise ValueError("input_date must be greater than or equal to 2018-01-01")
+    # Check if input_date is greater than 30 days from today
+    if input_date > datetime.datetime.now().date() + timedelta(days=30):
+        raise ValueError("input_date must be less than 30 days from today")
+    if is_demo_account() and input_date != date(2025, 1, 10):
+        raise InsufficientApiAccessError(
+            f"\"{input_date}\" requires an API Key for access.  To get your API Key,"
+            f" see: https://earningscall.biz/api-pricing"
+        )
+    try:
+        json_data = api.get_calendar_api_operation(input_date.year, input_date.month, input_date.day)
+        return [CalendarEvent.from_dict(event) for event in json_data]  # type: ignore
+    except requests.exceptions.HTTPError as error:
+        if error.response.status_code == 404:
+            # Calendar Date not found, simply return an empty list
+            return []
+        raise error

{earningscall-1.1.0 → earningscall-1.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "earningscall"
-version = "1.1.0"
+version = "1.2.0"
 description = "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."
 readme = "README.md"
 authors = [{ name = "EarningsCall", email = "dev@earningscall.biz" }]

{earningscall-1.1.0 → earningscall-1.2.0}/scripts/get_all_company_transcripts.py

@@ -1,7 +1,10 @@
+import earningscall  # noqa: F401
 from earningscall import get_company
 
+# earningscall.api_key = "YOUR API KEY HERE"
 
-company = get_company("aapl")  # Lookup Apple, Inc by its ticker symbol, "AAPL"
+
+company = get_company("AAPL")  # Lookup Apple, Inc by its ticker symbol, "AAPL"
 
 print(f"Getting all transcripts for: {company}..")
 

earningscall-1.2.0/scripts/get_all_sp500_transcript_texts.py

@@ -0,0 +1,44 @@
+from datetime import datetime
+import os
+
+import earningscall  # noqa: F401
+from earningscall import get_sp500_companies
+from earningscall.company import Company
+
+# TODO: Set your API key here:
+# earningscall.api_key = "YOUR SECRET API KEY GOES HERE"
+
+directory = "data/transcript_texts"
+os.makedirs(directory, exist_ok=True)
+
+
+def download_transcript_texts(company: Company):
+    print(f"Downloading all transcript texts for: {company}..")
+    for event in company.events():
+        if datetime.now().timestamp() < event.conference_date.timestamp():
+            print(
+                f"* {company.company_info.symbol} Q{event.quarter} {event.year} -- skipping, conference date in the future"
+            )
+            continue
+        file_name = os.path.join(
+            directory,
+            f"{company.company_info.exchange}_{company.company_info.symbol}_{event.year}_Q{event.quarter}.text",
+        )
+        if os.path.exists(file_name):
+            print(f"* {company.company_info.symbol} Q{event.quarter} {event.year} -- already downloaded")
+        else:
+            print(f"* Downloading transcript text for {company.company_info.symbol} Q{event.quarter} {event.year}...")
+            transcript = company.get_transcript(event=event)
+            if transcript:
+                # Save transcript text to file
+                with open(file_name, "w") as fd:
+                    fd.write(transcript.text)
+                print(
+                    f" Downloaded transcript text for {company.company_info.symbol} Q{event.quarter} {event.year} to: {file_name}"
+                )
+            else:
+                print(f" No transcript text found for {company.company_info.symbol} Q{event.quarter} {event.year}")
+
+
+for company in get_sp500_companies():
+    download_transcript_texts(company)

earningscall-1.2.0/scripts/get_calendar.py

@@ -0,0 +1,14 @@
+from datetime import date
+import earningscall  # noqa: F401
+
+from earningscall import get_calendar
+
+# TODO: Set your API key here:
+# earningscall.api_key = "YOUR API KEY HERE"
+
+events = get_calendar(date(2025, 1, 10))
+
+for event in events:
+    print(
+        f"{event.company_name} - Q{event.quarter} {event.year} on: {event.conference_date.astimezone().isoformat()} Transcript Ready: {event.transcript_ready}"
+    )

{earningscall-1.1.0 → earningscall-1.2.0}/scripts/get_single_transcript.py

@@ -4,10 +4,9 @@ from earningscall import get_company
 
 
 # TODO: Set your API key here:
-# earningscall.api_key = "YOUR SECRET API KEY GOES HERE"
+# earningscall.api_key = "YOUR API KEY HERE"
 
-
-company = get_company("aapl")
+company = get_company("AAPL")
 
 transcript = company.get_transcript(year=2021, quarter=3, level=2)
 

earningscall-1.2.0/tests/data/get-calendar-500-error.yaml

@@ -0,0 +1,14 @@
+responses:
+- response:
+    auto_calculate_content_length: false
+    body: ''
+    content_type: text/plain
+    headers:
+      Via: 1.1 1cae0bb0106fc058447f3b32dee7b228.cloudfront.net (CloudFront)
+      X-Amz-Cf-Id: GJG7c5roSXmd3WXEWTNzyrl8VN9fWmIm3OR8oYxEZg8bWpoiZE6XvA==
+      X-Amz-Cf-Pop: IAH50-C4
+      X-Cache: FunctionGeneratedResponse from cloudfront
+      X-Plan-Name: demo
+    method: GET
+    status: 500
+    url: https://v2.api.earningscall.biz/calendar?apikey=XXXXXXXXXXX&year=2020&month=1&day=1

earningscall-1.2.0/tests/data/get-calendar-not-found-response.yaml

@@ -0,0 +1,14 @@
+responses:
+- response:
+    auto_calculate_content_length: false
+    body: ''
+    content_type: text/plain
+    headers:
+      Via: 1.1 1cae0bb0106fc058447f3b32dee7b228.cloudfront.net (CloudFront)
+      X-Amz-Cf-Id: GJG7c5roSXmd3WXEWTNzyrl8VN9fWmIm3OR8oYxEZg8bWpoiZE6XvA==
+      X-Amz-Cf-Pop: IAH50-C4
+      X-Cache: FunctionGeneratedResponse from cloudfront
+      X-Plan-Name: starter
+    method: GET
+    status: 404
+    url: https://v2.api.earningscall.biz/calendar?apikey=XXXXXXXXXXX&year=2018&month=1&day=1

earningscall-1.2.0/tests/data/get-calendar-successful-response.yaml

@@ -0,0 +1,62 @@
+responses:
+- response:
+    auto_calculate_content_length: false
+    body: '[{"exchange": "NASDAQ", "symbol": "MPAA", "year": 2025, "quarter": 3, "conference_date":
+      "2025-02-10T13:00:00.000-05:00", "company_name": "Motorcar Parts of America,
+      Inc.", "transcript_ready": true}, {"exchange": "NASDAQ", "symbol": "SPSC", "year":
+      2024, "quarter": 4, "conference_date": "2025-02-10T16:30:00-05:00", "company_name":
+      "SPS Commerce, Inc.", "transcript_ready": true}, {"exchange": "NASDAQ", "symbol":
+      "RICK", "year": 2025, "quarter": 1, "conference_date": "2025-02-10T16:30:00-05:00",
+      "company_name": "RCI Hospitality Holdings, Inc.", "transcript_ready": true},
+      {"exchange": "NASDAQ", "symbol": "ALAB", "year": 2024, "quarter": 4, "conference_date":
+      "2025-02-10T16:30:00-05:00", "company_name": "Astera Labs, Inc.", "transcript_ready":
+      true}, {"exchange": "NASDAQ", "symbol": "PETS", "year": 2025, "quarter": 3,
+      "conference_date": "2025-02-10T16:30:00-05:00", "company_name": "PetMed Express,
+      Inc.", "transcript_ready": true}, {"exchange": "NASDAQ", "symbol": "XAIR", "year":
+      2025, "quarter": 3, "conference_date": "2025-02-10T16:30:00-05:00", "company_name":
+      "Beyond Air, Inc.", "transcript_ready": true}, {"exchange": "NASDAQ", "symbol":
+      "BLFS", "year": 2024, "quarter": 4, "conference_date": "2025-02-10T16:30:00.000-05:00",
+      "company_name": "BioLife Solutions, Inc.", "transcript_ready": true}, {"exchange":
+      "NASDAQ", "symbol": "VRTX", "year": 2024, "quarter": 4, "conference_date": "2025-02-10T16:30:00.000-05:00",
+      "company_name": "Vertex Pharmaceuticals Incorporated", "transcript_ready": true},
+      {"exchange": "NYSE", "symbol": "TAK", "year": 2025, "quarter": 1, "conference_date":
+      "2025-02-10T16:30:00-05:00", "company_name": "Takeda Pharmaceutical Company
+      Limited", "transcript_ready": true}, {"exchange": "OTC", "symbol": "PRKA", "year":
+      2025, "quarter": 1, "conference_date": "2025-02-10T16:30:00.000-05:00", "company_name":
+      "Parks! America Inc", "transcript_ready": true}, {"exchange": "NASDAQ", "symbol":
+      "AMKR", "year": 2024, "quarter": 4, "conference_date": "2025-02-10T17:00:00.000-05:00",
+      "company_name": "Amkor Technology, Inc.", "transcript_ready": true}, {"exchange":
+      "NASDAQ", "symbol": "MITK", "year": 2025, "quarter": 1, "conference_date": "2025-02-10T17:00:00-05:00",
+      "company_name": "Mitek Systems, Inc.", "transcript_ready": true}, {"exchange":
+      "NYSE", "symbol": "SLQT", "year": 2025, "quarter": 2, "conference_date": "2025-02-10T17:00:00-05:00",
+      "company_name": "SelectQuote, Inc.", "transcript_ready": true}, {"exchange":
+      "NYSE", "symbol": "NGL", "year": 2025, "quarter": 3, "conference_date": "2025-02-10T16:00:00-06:00",
+      "company_name": "NGL Energy Partners LP", "transcript_ready": true}, {"exchange":
+      "NASDAQ", "symbol": "LSCC", "year": 2024, "quarter": 4, "conference_date": "2025-02-10T17:00:00-05:00",
+      "company_name": "Lattice Semiconductor Corporation", "transcript_ready": true},
+      {"exchange": "TSX", "symbol": "CVO", "year": 2025, "quarter": 3, "conference_date":
+      "2025-02-10T17:00:00-05:00", "company_name": "Coveo Solutions Inc.", "transcript_ready":
+      true}, {"exchange": "NYSE", "symbol": "INSP", "year": 2024, "quarter": 4, "conference_date":
+      "2025-02-10T17:00:00-05:00", "company_name": "Inspire Medical Systems, Inc.",
+      "transcript_ready": true}, {"exchange": "NASDAQ", "symbol": "CMCO", "year":
+      2025, "quarter": 3, "conference_date": "2025-02-10T17:00:00-05:00", "company_name":
+      "Columbus McKinnon Corporation", "transcript_ready": true}, {"exchange": "NASDAQ",
+      "symbol": "HLIT", "year": 2024, "quarter": 4, "conference_date": "2025-02-10T14:00:00-08:00",
+      "company_name": "Harmonic Inc.", "transcript_ready": true}, {"exchange": "NYSE",
+      "symbol": "SSD", "year": 2024, "quarter": 4, "conference_date": "2025-02-10T17:00:00-05:00",
+      "company_name": "Simpson Manufacturing Company, Inc.", "transcript_ready": true}]'
+    content_type: text/plain
+    headers:
+      Cache-Control: public, max-age=500
+      ETag: W/"ff349ae06e2284df57d342fd9e3c9d4b"
+      Last-Modified: Wed, 12 Feb 2025 15:44:12 GMT
+      Transfer-Encoding: chunked
+      Vary: accept-encoding
+      Via: 1.1 dab9621fb9e60d4beae799f308450f86.cloudfront.net (CloudFront)
+      X-Amz-Cf-Id: o-89nbe8YAinJi-F0rXkAr8qIUAcTkW6Mmvk4vQeDH-9ob1MZ7QVfg==
+      X-Amz-Cf-Pop: IAH50-C4
+      X-Cache: Miss from cloudfront
+      x-amz-server-side-encryption: AES256
+    method: GET
+    status: 200
+    url: https://v2.api.earningscall.biz/calendar?apikey=XXXXXXXXXXX&year=2025&month=2&day=10

{earningscall-1.1.0 → earningscall-1.2.0}/tests/test_download_audio_files.py

@@ -14,14 +14,6 @@ from earningscall.symbols import CompanyInfo, clear_symbols
 from earningscall.utils import data_path
 
 
-# Uncomment and run following code to generate msft-transcript-response.yaml file
-#
-# from responses import _recorder
-# @_recorder.record(file_path="meta-q3-2024-not-found.yaml")
-# def test_save_symbols_v1():
-#     requests.get("https://v2.api.alpha.earningscall.biz/audio?apikey=brocktest&exchange=NASDAQ&symbol=META&year=2024&quarter=3")
-
-
 @pytest.fixture(autouse=True)
 def run_before_and_after_tests():
     """Fixture to execute asserts before and after a test is run"""

earningscall-1.2.0/tests/test_get_calendar.py

@@ -0,0 +1,106 @@
+from datetime import datetime, date, timedelta
+
+import pytest
+import requests
+import responses
+
+import earningscall
+from earningscall import get_calendar
+from earningscall.api import purge_cache
+from earningscall.errors import InsufficientApiAccessError
+from earningscall.utils import data_path
+
+
+# Uncomment and run following code to generate data/get-calendar-not-found-response.yaml file
+#
+
+# import earningscall
+# @_recorder.record(file_path="data/get-calendar-not-found-response.yaml")
+# def test_save_symbols_v1():
+#     requests.get("https://v2.api.earningscall.biz/calendar?apikey=demo&year=1980&month=1&day=1")
+
+
+@pytest.fixture(autouse=True)
+def run_before_and_after_tests():
+    """Fixture to execute asserts before and after a test is run"""
+    # Setup
+    earningscall.api_key = None
+    earningscall.retry_strategy = {
+        "strategy": "exponential",
+        "base_delay": 0.01,
+        "max_attempts": 3,
+    }
+    purge_cache()
+    yield  # this is where the testing happens
+    # Teardown
+    earningscall.api_key = None
+
+
+@responses.activate
+def test_get_calendar_invalid_inputs():
+    with pytest.raises(ValueError):
+        get_calendar(None)
+    with pytest.raises(ValueError):
+        get_calendar("2025-02-10")
+    with pytest.raises(ValueError):
+        get_calendar(123456)
+    with pytest.raises(ValueError):
+        get_calendar(date(2017, 12, 31))
+    with pytest.raises(ValueError):
+        get_calendar(datetime.now() + timedelta(days=31))
+
+
+@responses.activate
+def test_get_non_demo_date():
+    with pytest.raises(InsufficientApiAccessError):
+        get_calendar(date(2020, 1, 1))
+
+
+@responses.activate
+def test_get_calendar_success():
+    earningscall.api_key = "XXXXXXXXXXX"
+    responses._add_from_file(file_path=data_path("get-calendar-successful-response.yaml"))
+    calendar = get_calendar(date(2025, 2, 10))
+    assert len(calendar) == 20
+    assert calendar[0].exchange == "NASDAQ"
+    assert calendar[0].symbol == "MPAA"
+    assert calendar[0].year == 2025
+    assert calendar[0].quarter == 3
+    assert calendar[0].conference_date.year == 2025
+    assert calendar[0].conference_date.month == 2
+    assert calendar[0].conference_date.day == 10
+    assert calendar[0].transcript_ready
+    assert calendar[0].company_name == "Motorcar Parts of America, Inc."
+
+
+@responses.activate
+def test_get_calendar_success_with_datetime():
+    earningscall.api_key = "XXXXXXXXXXX"
+    responses._add_from_file(file_path=data_path("get-calendar-successful-response.yaml"))
+    calendar = get_calendar(datetime(2025, 2, 10))
+    assert len(calendar) == 20
+    assert calendar[0].exchange == "NASDAQ"
+    assert calendar[0].symbol == "MPAA"
+    assert calendar[0].year == 2025
+    assert calendar[0].quarter == 3
+    assert calendar[0].conference_date.year == 2025
+    assert calendar[0].conference_date.month == 2
+    assert calendar[0].conference_date.day == 10
+    assert calendar[0].transcript_ready
+    assert calendar[0].company_name == "Motorcar Parts of America, Inc."
+
+
+@responses.activate
+def test_get_calendar_server_error():
+    earningscall.api_key = "XXXXXXXXXXX"
+    responses._add_from_file(file_path=data_path("get-calendar-500-error.yaml"))
+    with pytest.raises(requests.exceptions.HTTPError):
+        get_calendar(date(2020, 1, 1))
+
+
+@responses.activate
+def test_get_calendar_not_found():
+    earningscall.api_key = "XXXXXXXXXXX"
+    responses._add_from_file(file_path=data_path("get-calendar-not-found-response.yaml"))
+    calendar = get_calendar(date(2018, 1, 1))
+    assert len(calendar) == 0

{earningscall-1.1.0 → earningscall-1.2.0}/tests/test_get_transcript.py

@@ -8,7 +8,7 @@ import earningscall
 from earningscall import get_company
 from earningscall.api import purge_cache
 from earningscall.company import Company
-from earningscall.errors import InsufficientApiAccessError
+from earningscall.errors import InsufficientApiAccessError, InvalidApiKeyError
 from earningscall.event import EarningsEvent
 from earningscall.symbols import clear_symbols, CompanyInfo
 from earningscall.transcript import Transcript
@@ -372,6 +372,20 @@ def test_get_transcript_fails_all_attempts_invalid_retry_strategy():
         company.get_transcript(year=2023, quarter=1, level=1)
 
 
+@responses.activate
+def test_get_company_fails_not_authorized():
+    # Always throttle the caller
+    responses.add(
+        responses.GET,
+        "https://v2.api.earningscall.biz/symbols-v2.txt",
+        body=json.dumps({"error": "Not authorized"}),
+        status=401,
+    )
+    ##
+    with pytest.raises(InvalidApiKeyError):
+        get_company("aapl")
+
+
 # Uncomment and run following code to generate demo-symbols-v2.yaml file
 #
 # import requests

earningscall-1.1.0/.python-version

@@ -1 +0,0 @@
-3.12.8

earningscall-1.1.0/earningscall/__init__.py

@@ -1,14 +0,0 @@
-from typing import Dict, Optional, Union
-
-from earningscall.exports import get_company, get_all_companies, get_sp500_companies
-from earningscall.symbols import Symbols, load_symbols
-
-api_key: Optional[str] = None
-enable_requests_cache: bool = True
-retry_strategy: Dict[str, Union[str, int, float]] = {
-    "strategy": "exponential",
-    "base_delay": 3,
-    "max_attempts": 5,
-}
-
-__all__ = ["get_company", "get_all_companies", "get_sp500_companies", "Symbols", "load_symbols"]

earningscall-1.1.0/earningscall/exports.py

@@ -1,45 +0,0 @@
-from typing import Optional, Iterator
-
-from earningscall.api import get_sp500_companies_txt_file
-from earningscall.company import Company
-from earningscall.symbols import get_symbols
-
-
-def get_company(symbol: str, exchange: Optional[str] = None) -> Optional[Company]:
-    """
-    Get a company by symbol and optionally an exchange.
-
-    :param str symbol: The symbol to get the company for.
-    :param Optional[str] exchange: The exchange to get the company for.
-
-    :return: The company for the given symbol and exchange.
-    """
-    company_info = get_symbols().lookup_company(symbol=symbol, exchange=exchange)
-    if company_info:
-        return Company(company_info=company_info)
-    return None
-
-
-def get_all_companies() -> Iterator[Company]:
-    """
-    Get all companies.
-
-    :return: An iterator of all companies that is available to the current API plan.
-    """
-    for company_info in get_symbols().get_all():
-        yield Company(company_info=company_info)
-
-
-def get_sp500_companies() -> Iterator[Company]:
-    """
-    Get all S&P 500 companies.
-
-    :return: An iterator of all S&P 500 companies that is available to the current API plan.
-    """
-    resp = get_sp500_companies_txt_file()
-    if not resp:
-        return
-    for ticker_symbol in resp.split("\n"):
-        company_info = get_symbols().lookup_company(ticker_symbol)
-        if company_info:
-            yield Company(company_info=company_info)