earningscall 0.0.7__py3-none-any.whl → 0.0.9__py3-none-any.whl

earningscall/__init__.py

@@ -1,6 +1,6 @@
 from typing import Optional
 
-from earningscall.symbols import Symbols, load_symbols
 from earningscall.exports import get_company, get_all_companies
+from earningscall.symbols import Symbols, load_symbols
 
 api_key: Optional[str] = None

earningscall/api.py

@@ -2,9 +2,9 @@ import logging
 import os
 from typing import Optional
 
-import earningscall
 import requests
 
+import earningscall
 
 log = logging.getLogger(__file__)
 
@@ -19,6 +19,10 @@ def get_api_key():
     return api_key
 
 
+def api_key_param():
+    return {"apikey": get_api_key()}
+
+
 def is_demo_account():
     return get_api_key() == "demo"
 
@@ -28,7 +32,7 @@ def get_events(exchange: str,
 
     log.debug(f"get_events exchange: {exchange} symbol: {symbol}")
     params = {
-        "apikey": get_api_key(),
+        **api_key_param(),
         "exchange": exchange,
         "symbol": symbol,
     }
@@ -45,7 +49,7 @@ def get_transcript(exchange: str,
 
     log.debug(f"get_transcript year: {year} quarter: {quarter}")
     params = {
-        "apikey": get_api_key(),
+        **api_key_param(),
         "exchange": exchange,
         "symbol": symbol,
         "year": str(year),
@@ -65,10 +69,14 @@ def get_symbols_v1():
 
 
 def get_symbols_v2():
-    params = {
-        "apikey": get_api_key(),
-    }
-    response = requests.get(f"{API_BASE}/symbols-v2.txt", params=params)
+    response = requests.get(f"{API_BASE}/symbols-v2.txt", params=api_key_param())
+    if response.status_code != 200:
+        return None
+    return response.text
+
+
+def get_sp500_companies_txt_file():
+    response = requests.get(f"{API_BASE}/symbols/sp500.txt", params=api_key_param())
     if response.status_code != 200:
         return None
     return response.text

earningscall/errors.py

@@ -23,7 +23,3 @@ class ClientError(BaseError):
 
 class InsufficientApiAccessError(ClientError):
     pass
-
-
-class CompanyNotFound(ClientError):
-    pass

earningscall/event.py

@@ -1,8 +1,8 @@
 import logging
-from dataclasses import dataclass, field
 from datetime import datetime
 from typing import Optional
 
+from dataclasses import dataclass, field
 from dataclasses_json import config
 from dataclasses_json import dataclass_json
 from marshmallow import fields

earningscall/exports.py

@@ -1,8 +1,8 @@
 from typing import Optional
 
-from earningscall.symbols import get_symbols
-
+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) -> Optional[Company]:
@@ -18,6 +18,10 @@ def get_all_companies() -> [Company]:
 
 
 def get_sp500_companies() -> [Company]:
-    ## TODO: Actually only return SP500 companies.
-    for company_info in get_symbols().get_all():
-        yield Company(company_info=company_info)
+    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)

earningscall/symbols.py

@@ -129,8 +129,8 @@ class Symbols:
             except KeyError:
                 pass
         if is_demo_account():
-            raise InsufficientApiAccessError(f"For full access, please get an API Key.  See: "
-                                             f"https://earningscall.biz/api-pricing")
+            raise InsufficientApiAccessError(f"\"{symbol}\" requires an API Key for access.  To get your API Key,"
+                                             f" see: https://earningscall.biz/api-pricing")
         return None
 
     def remove_exchange_symbol(self, exchange_symbol: str):

earningscall/transcript.py

@@ -3,6 +3,7 @@ from typing import Optional
 
 from dataclasses import dataclass, field
 from dataclasses_json import dataclass_json
+
 from earningscall.event import EarningsEvent
 
 log = logging.getLogger(__file__)

earningscall/utils.py

@@ -1,6 +1,7 @@
 import logging
 import os
 import pathlib
+import sys
 
 import earningscall
 
@@ -18,3 +19,15 @@ def data_path(file_name=None):
 
 def enable_debug_logs():
     logging.basicConfig(level=logging.DEBUG)
+
+
+LOG_FORMAT = "[%(asctime)s] [%(levelname)8s] --- %(message)s (%(filename)s:%(lineno)s)"
+
+
+def configure_sane_logging(level=logging.DEBUG):
+    # Manually set the following loggers to "INFO", since they tend to be VERY noisy, and when we are
+    # debugging our own application, we only care about DEBUG logs from OUR application, not these libs.
+    for name in ['urllib3']:
+        logging.getLogger(name).setLevel(logging.INFO)
+    logging.getLogger("filelock").setLevel(logging.WARNING)
+    logging.basicConfig(level=level, stream=sys.stdout, format=LOG_FORMAT)

{earningscall-0.0.7.dist-info → earningscall-0.0.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: earningscall
-Version: 0.0.7
+Version: 0.0.9
 Summary: The EarningsCall Python library.
 Project-URL: Homepage, https://earningscall.biz
 Project-URL: Documentation, https://github.com/EarningsCall/earningscall-python
@@ -44,7 +44,6 @@ pip install --upgrade earningscall
 ```python
 from earningscall import get_company
 
-
 company = get_company("aapl")  # Lookup Apple, Inc by its ticker symbol, "AAPL"
 
 transcript = company.get_transcript(year=2021, quarter=3)
@@ -64,13 +63,12 @@ Apple Inc. Q3 2021 Transcript Text: "Good day, and welcome to the Apple Q3 FY 20
 ```python
 from earningscall import get_company
 
-
 company = get_company("aapl")  # Lookup Apple, Inc by its ticker symbol, "AAPL"
 
 print(f"Getting all transcripts for: {company}..")
 # Retrieve all earnings conference call events for a company, and iterate through each one
 for event in company.events():
-    transcript = company.get_transcript(event)  # Fetch the earnings call transcript for this event
+    transcript = company.get_transcript(event=event)  # Fetch the earnings call transcript for this event
     print(f"* Q{event.quarter} {event.year}")
     if transcript:
         print(f"  Transcript Text: \"{transcript.text[:100]}...\"")
@@ -105,6 +103,15 @@ for company in get_all_companies():
     print(f"{company.company_info} -- {company.company_info.sector} -- {company.company_info.industry}")
 ```
 
+## List S&P 500 Companies
+
+```python
+from earningscall import get_all_companies
+
+for company in get_all_companies():
+    print(f"{company.company_info} -- {company.company_info.sector} -- {company.company_info.industry}")
+```
+
 By default, this library grants you access to only two companies, Apple Inc. and Microsoft, Inc.
 
 To gain access to 5,000+ companies please [signup here](https://earningscall.biz/api-pricing) to get your API key.

earningscall-0.0.9.dist-info/RECORD

@@ -0,0 +1,14 @@
+earningscall/__init__.py,sha256=cIuYT8auBFMdNGCv6maIL8XCdv10LYEJfh590H4bk58,179
+earningscall/api.py,sha256=-nqxFGrTinCFCj8_wA-fkyrqr-WfDS50sMAh2UGdBR0,1958
+earningscall/company.py,sha256=VyiHOajDBAx-G6dgWrPBUwWKjDpBvb0moZIpULPmiKA,1765
+earningscall/errors.py,sha256=_m8CvAcyWQprdyTNzYjdoCX5nUZpEP7rG4c5-eLmxno,441
+earningscall/event.py,sha256=Gdda4829tWlrlFn38r8KOaI-IJzf-ambiNojKyr9XtY,689
+earningscall/exports.py,sha256=wA6d4-AJyT-0Wz8g_j-3rFHHhnXHx5V1GCsaPJMatFc,814
+earningscall/sectors.py,sha256=9aw14krRzdLJSTFC72Nwk3MQaXAIgkTBk5S-KTiki3U,5946
+earningscall/symbols.py,sha256=StqRc_C2hFdlhCMEKpytfUmsruCSHY0WPQQIVIejF9k,7748
+earningscall/transcript.py,sha256=rLH2bGrrgUmS8XZGAPUP7msiIcL7f4ABmbnVJWXI28c,329
+earningscall/utils.py,sha256=Qx8KhlumUdzyBSZRKMS6vpWlb8MGZpLKA4OffJaMdCE,1032
+earningscall-0.0.9.dist-info/METADATA,sha256=n5_NDlAdDDj76qwCTJbZcgPYvQ7qM-XOQ9bLVFZHe6A,4437
+earningscall-0.0.9.dist-info/WHEEL,sha256=zEMcRr9Kr03x1ozGwg5v9NQBKn3kndp6LSoSlVg-jhU,87
+earningscall-0.0.9.dist-info/licenses/LICENSE,sha256=ktEB_UcRMg2cQlX9wiDs544xWncWizwS9mEZuGsCLrM,1069
+earningscall-0.0.9.dist-info/RECORD,,

earningscall-0.0.7.dist-info/RECORD

@@ -1,14 +0,0 @@
-earningscall/__init__.py,sha256=HTwEYkAem1VAYHaNtsqWMC5O_UGZPELVMqzk6txCo3Q,179
-earningscall/api.py,sha256=5_cdygmB-iyZH5ACLDmk5ctYqljKNXSe22FJ7Ws9Lfs,1751
-earningscall/company.py,sha256=VyiHOajDBAx-G6dgWrPBUwWKjDpBvb0moZIpULPmiKA,1765
-earningscall/errors.py,sha256=YTLkbhzWT_AURRL1IMlkkAKUiIW1L4V9Qh99bZnOtd8,488
-earningscall/event.py,sha256=a5mcyfuCqPCopcKQUZ1HJyqHfAf-RNKnux_o68DIUHM,689
-earningscall/exports.py,sha256=5mLO17Sf0XL8VnglIMIQy19riT2AYkZsyiN6nZ3q0Gk,641
-earningscall/sectors.py,sha256=9aw14krRzdLJSTFC72Nwk3MQaXAIgkTBk5S-KTiki3U,5946
-earningscall/symbols.py,sha256=fvqjnCbSAwfZB1dUrBUZFmJQ8C8V9uDzR0_C9RXMfIs,7722
-earningscall/transcript.py,sha256=yMu3Eib_9by0vHZobDGQFqS4OZ3_4NnYgAk0cGDbfQM,328
-earningscall/utils.py,sha256=wfwlSgFPPxr3GsFAsTjDNg_mLLK9V6p_2CwfetN5RR0,454
-earningscall-0.0.7.dist-info/METADATA,sha256=aG7ZjmCuwA2JMnsDfExatqT0jf05zlbYwIw_gEsIEvQ,4206
-earningscall-0.0.7.dist-info/WHEEL,sha256=zEMcRr9Kr03x1ozGwg5v9NQBKn3kndp6LSoSlVg-jhU,87
-earningscall-0.0.7.dist-info/licenses/LICENSE,sha256=ktEB_UcRMg2cQlX9wiDs544xWncWizwS9mEZuGsCLrM,1069
-earningscall-0.0.7.dist-info/RECORD,,