earningscall 0.0.4__tar.gz → 0.0.5__tar.gz

{earningscall-0.0.4 → earningscall-0.0.5}/.github/workflows/release.yml

@@ -1,5 +1,5 @@
 # https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/
-name: Publish Python 🐍 distribution 📦 to PyPI and TestPyPI
+name: Build and Release
 
 on: push
 

{earningscall-0.0.4 → earningscall-0.0.5}/PKG-INFO

@@ -1,10 +1,13 @@
 Metadata-Version: 2.3
 Name: earningscall
-Version: 0.0.4
+Version: 0.0.5
 Summary: The EarningsCall Python library.
+Project-URL: Homepage, https://earningscall.biz
 Project-URL: Documentation, https://github.com/EarningsCall/earningscall-python
+Project-URL: Repository, https://github.com/EarningsCall/earningscall-python
 Project-URL: Issues, https://github.com/EarningsCall/earningscall-python/issues
 Project-URL: Source, https://github.com/EarningsCall/earningscall-python
+Project-URL: Changelog, https://github.com/EarningsCall/earningscall-python/blob/master/CHANGELOG.md
 Author-email: EarningsCall <dev@earningscall.biz>
 License-File: LICENSE
 Requires-Python: >=3.8
@@ -16,7 +19,11 @@ Description-Content-Type: text/markdown
 
 # EarningsCall Python Library
 
-The EarningsCall Python library provides convenient access to the EarningsCall API from
+[![pypi](https://img.shields.io/pypi/v/earningscall.svg)](https://pypi.python.org/pypi/earningscall)
+[![Build Status](https://github.com/EarningsCall/earningscall-python/actions/workflows/release.yml/badge.svg?branch=master)](https://github.com/EarningsCall/earningscall-python/actions?query=branch%3Amaster)
+[![Coverage Status](https://coveralls.io/repos/github/EarningsCall/earningscall-python/badge.svg?branch=master)](https://coveralls.io/github/EarningsCall/earningscall-python?branch=master)
+
+The EarningsCall Python library provides convenient access to the [EarningsCall API](https://earningscall.biz/api-guide) from
 applications written in the Python language. It includes a pre-defined set of
 classes for API resources that initialize themselves dynamically from API
 responses.
@@ -33,7 +40,6 @@ pip install --upgrade earningscall
 
 * Python 3.8+ (PyPI supported)
 
-
 ## Get Transcript for a Single Quarter
 
 ```python
@@ -99,3 +105,24 @@ 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 5,000+ companies please [signup here](https://earningscall.biz/api-pricing) to get your API key.
+
+Once you have access to your API key, you can set the API Key like this:
+
+```python
+
+import earningscall
+
+
+earningscall.api_key = "YOUR SECRET API KEY GOES HERE"
+```
+
+Alternatively, you can pass in your API key as an environment variable:
+
+```sh
+export ECALL_API_KEY="YOUR SECRET API KEY GOES HERE"
+python your-python-script.py
+```

{earningscall-0.0.4 → earningscall-0.0.5}/README.md

@@ -1,6 +1,10 @@
 # EarningsCall Python Library
 
-The EarningsCall Python library provides convenient access to the EarningsCall API from
+[![pypi](https://img.shields.io/pypi/v/earningscall.svg)](https://pypi.python.org/pypi/earningscall)
+[![Build Status](https://github.com/EarningsCall/earningscall-python/actions/workflows/release.yml/badge.svg?branch=master)](https://github.com/EarningsCall/earningscall-python/actions?query=branch%3Amaster)
+[![Coverage Status](https://coveralls.io/repos/github/EarningsCall/earningscall-python/badge.svg?branch=master)](https://coveralls.io/github/EarningsCall/earningscall-python?branch=master)
+
+The EarningsCall Python library provides convenient access to the [EarningsCall API](https://earningscall.biz/api-guide) from
 applications written in the Python language. It includes a pre-defined set of
 classes for API resources that initialize themselves dynamically from API
 responses.
@@ -17,7 +21,6 @@ pip install --upgrade earningscall
 
 * Python 3.8+ (PyPI supported)
 
-
 ## Get Transcript for a Single Quarter
 
 ```python
@@ -83,3 +86,24 @@ 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 5,000+ companies please [signup here](https://earningscall.biz/api-pricing) to get your API key.
+
+Once you have access to your API key, you can set the API Key like this:
+
+```python
+
+import earningscall
+
+
+earningscall.api_key = "YOUR SECRET API KEY GOES HERE"
+```
+
+Alternatively, you can pass in your API key as an environment variable:
+
+```sh
+export ECALL_API_KEY="YOUR SECRET API KEY GOES HERE"
+python your-python-script.py
+```

{earningscall-0.0.4 → earningscall-0.0.5}/earningscall/api.py

@@ -19,6 +19,10 @@ def get_api_key():
     return api_key
 
 
+def is_demo_account():
+    return get_api_key() == "demo"
+
+
 def get_events(exchange: str,
                symbol: str):
 
@@ -41,7 +45,7 @@ def get_transcript(exchange: str,
 
     log.debug(f"get_transcript year: {year} quarter: {quarter}")
     params = {
-        "apikey": "demo",
+        "apikey": get_api_key(),
         "exchange": exchange,
         "symbol": symbol,
         "year": str(year),
@@ -61,7 +65,10 @@ def get_symbols_v1():
 
 
 def get_symbols_v2():
-    response = requests.get(f"{API_BASE}/symbols-v2.txt")
+    params = {
+        "apikey": get_api_key(),
+    }
+    response = requests.get(f"{API_BASE}/symbols-v2.txt", params=params)
     if response.status_code != 200:
         return None
     return response.text

{earningscall-0.0.4 → earningscall-0.0.5}/earningscall/company.py

@@ -15,7 +15,9 @@ class Company:
     name: str
     _events: [EarningsEvent]
 
-    def __init__(self, company_info):
+    def __init__(self, company_info: CompanyInfo):
+        if not company_info:
+            raise ValueError("company_info must be present.")
         self.company_info = company_info
         self.name = company_info.name
         self._events = None

{earningscall-0.0.4 → earningscall-0.0.5}/earningscall/errors.py

@@ -21,5 +21,9 @@ class ClientError(BaseError):
     status: int = 400  # https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400
 
 
-class MissingApiKeyError(ClientError):
+class InsufficientApiAccessError(ClientError):
+    pass
+
+
+class CompanyNotFound(ClientError):
     pass

{earningscall-0.0.4 → earningscall-0.0.5}/earningscall/exports.py

@@ -1,10 +1,15 @@
+from typing import Optional
+
 from earningscall.symbols import get_symbols
 
 from earningscall.company import Company
 
 
-def get_company(symbol: str) -> Company:
-    return Company(company_info=get_symbols().lookup_company(symbol))
+def get_company(symbol: str) -> Optional[Company]:
+    company_info = get_symbols().lookup_company(symbol)
+    if company_info:
+        return Company(company_info=company_info)
+    return None
 
 
 def get_all_companies() -> [Company]:

{earningscall-0.0.4 → earningscall-0.0.5}/earningscall/symbols.py

@@ -4,7 +4,8 @@ import re
 from collections import defaultdict
 from typing import Optional
 
-from earningscall.api import get_symbols_v2
+from earningscall.api import get_symbols_v2, is_demo_account
+from earningscall.errors import InsufficientApiAccessError
 from earningscall.sectors import sector_to_index, industry_to_index, index_to_sector, index_to_industry
 
 # WARNING: Add new indexes to the *END* of this list
@@ -127,6 +128,9 @@ class Symbols:
                     return _symbol
             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")
         return None
 
     def remove_exchange_symbol(self, exchange_symbol: str):
@@ -224,3 +228,8 @@ def get_symbols() -> Symbols:
     if not _symbols:
         _symbols = load_symbols()
     return _symbols
+
+
+def clear_symbols():
+    global _symbols
+    _symbols = None

{earningscall-0.0.4 → earningscall-0.0.5}/earningscall/utils.py

@@ -1,3 +1,4 @@
+import logging
 import os
 import pathlib
 
@@ -13,3 +14,7 @@ def project_file_path(base_dir, file_name):
 
 def data_path(file_name=None):
     return project_file_path("tests/data", file_name)
+
+
+def enable_debug_logs():
+    logging.basicConfig(level=logging.DEBUG)

{earningscall-0.0.4 → earningscall-0.0.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "earningscall"
-version = "0.0.4"
+version = "0.0.5"
 description = "The EarningsCall Python library."
 readme = "README.md"
 authors = [
@@ -15,9 +15,12 @@ dependencies = [
 ]
 
 [project.urls]
+Homepage = "https://earningscall.biz"
 Documentation = "https://github.com/EarningsCall/earningscall-python"
+Repository = "https://github.com/EarningsCall/earningscall-python"
 Issues = "https://github.com/EarningsCall/earningscall-python/issues"
 Source = "https://github.com/EarningsCall/earningscall-python"
+Changelog = "https://github.com/EarningsCall/earningscall-python/blob/master/CHANGELOG.md"
 
 [build-system]
 requires = ["hatchling"]

{earningscall-0.0.4 → earningscall-0.0.5}/scripts/list_all_companies.py

@@ -1,4 +1,8 @@
 from earningscall import get_all_companies
+from earningscall.utils import enable_debug_logs
+
+
+enable_debug_logs()
 
 for company in get_all_companies():
     print(f"{company.company_info} -- {company.company_info.sector} -- {company.company_info.industry}")

earningscall-0.0.5/tests/data/demo-symbols-v2.yaml

@@ -0,0 +1,8 @@
+responses:
+- response:
+    auto_calculate_content_length: false
+    body: "1\tAAPL\tApple Inc.\t9\t30\n1\tMSFT\tMicrosoft Corporation\t-1\t-1"
+    content_type: text/plain
+    method: GET
+    status: 200
+    url: https://v2.api.earningscall.biz/symbols-v2.txt?apikey=demo

{earningscall-0.0.4 → earningscall-0.0.5}/tests/test_get_transcript.py

@@ -1,10 +1,13 @@
+import pytest
 import responses
 
 from earningscall import get_company
+from earningscall.errors import InsufficientApiAccessError
+from earningscall.symbols import clear_symbols
 from earningscall.utils import data_path
 
 
-# Uncomment following code to generate msft-transcript-response.yaml file
+# Uncomment and run following code to generate msft-transcript-response.yaml file
 #
 # from responses import _recorder
 # @_recorder.record(file_path="msft-transcript-response.yaml")
@@ -15,6 +18,7 @@ from earningscall.utils import data_path
 @responses.activate
 def test_get_demo_company():
     ##
+    clear_symbols()
     responses._add_from_file(file_path=data_path("symbols-v2.yaml"))
     responses._add_from_file(file_path=data_path("msft-transcript-response.yaml"))
     ##
@@ -25,14 +29,23 @@ def test_get_demo_company():
                                      'Conference Call. At ')
 
 
-# @responses.activate
-# def test_get_non_demo_company():
-#     ##
-#     responses._add_from_file(file_path=data_path("symbols-v2.yaml"))
-#     # responses._add_from_file(file_path=data_path("msft-transcript-response.yaml"))
-#     ##
-#     company = get_company("nvda")
-#     ##
-#     transcript = company.get_transcript(year=2023, quarter=1)
-#     assert transcript.text[:100] == ('Greetings, and welcome to the Microsoft Fiscal Year 2023 First Quarter Earnings '
-#                                      'Conference Call. At ')
+# Uncomment and run following code to generate demo-symbols-v2.yaml file
+#
+# import requests
+#
+# from responses import _recorder
+#
+#
+# @_recorder.record(file_path="demo-symbols-v2.yaml")
+# def test_save_symbols_v1():
+#     requests.get("https://v2.api.earningscall.biz/symbols-v2.txt?apikey=demo")
+
+
+@responses.activate
+def test_get_non_demo_company():
+    ##
+    clear_symbols()
+    responses._add_from_file(file_path=data_path("demo-symbols-v2.yaml"))
+    ##
+    with pytest.raises(InsufficientApiAccessError):
+        get_company("nvda")

{earningscall-0.0.4 → earningscall-0.0.5}/tests/test_symbols.py

@@ -9,8 +9,6 @@ from earningscall.utils import data_path
 def test_load_symbols_txt_v2():
     ##
     responses.patch(API_BASE)
-    print("symbols path")
-    print(data_path("symbols-v2.yaml"))
     responses._add_from_file(file_path=data_path("symbols-v2.yaml"))
     ##
     symbols = Symbols.load_txt_v2()
@@ -22,7 +20,7 @@ def test_load_symbols_txt_v2():
     assert _symbol.sector == "Technology"
     assert _symbol.industry == "Consumer Electronics"
     assert len(responses.calls) == 1
-    assert responses.calls[0].request.url == "https://v2.api.earningscall.biz/symbols-v2.txt"
+    assert responses.calls[0].request.url == "https://v2.api.earningscall.biz/symbols-v2.txt?apikey=demo"
 
 
 def test_symbols_serialization_to_text_v2():