EarningsCall / earningscall-python

98%

push

github

feat: add get_live_events() for the /live endpoint (#50)

* feat: add get_live_events() for the /live endpoint

The API advertises /live (the earnings calls that are live right now),
but the SDK had no way to call it.

Add get_live_events(), which returns LiveEvent objects with an HLS
streaming_url and a parsed event_date. Demo keys receive the API's fixed
example event, and the list is empty when nothing is live.

Each event's live_transcript links (poll URL, WebSocket URL, token) are
marked experimental by the API ("It may change. Do not rely on it."),
so LiveTranscriptLinks makes every field optional and ignores unknown
fields: a server-side change can't break parsing.

Bump version to 3.2.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix: keep live events parsing when live_transcript changes shape

live_transcript is experimental and exempt from the v4 schema freeze,
so the API may change it without notice. Field-level changes (added,
removed, renamed, or null fields) already parsed, but replacing the
object with a list, string, or boolean raised AttributeError and failed
the whole get_live_events() call. Decode it only when it is an object
and drop it otherwise, so the live events still load.

Also guard the README example against a missing event_date
(CodeRabbit review on #50).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

170 of 180 branches covered (94.44%)

Branch coverage included in aggregate %.

657 of 666 relevant lines covered (98.65%)

0.99 hits per line