Metadata-Version: 2.4
Name: earningspy
Version: 0.1.7
Summary: Python toolkit for PEAD research and earnings calendar analysis.
Author-email: Alberto Rincones <alberto.rincones@code4road.com>
License: MIT
Project-URL: Homepage, https://github.com/c4road/earningspy
Keywords: earnings,finance,AI,scraper,PEAD,quant
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: <3.12,>=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohappyeyeballs==2.4.4
Requires-Dist: aiohttp==3.10.11
Requires-Dist: aiosignal==1.3.1
Requires-Dist: attrs==25.3.0
Requires-Dist: beautifulsoup4==4.13.4
Requires-Dist: certifi==2025.7.14
Requires-Dist: charset-normalizer==3.4.2
Requires-Dist: contourpy==1.3.2; python_version >= "3.10"
Requires-Dist: cssselect==1.2.0
Requires-Dist: frozenlist==1.5.0
Requires-Dist: idna==3.10
Requires-Dist: kiwisolver==1.4.8; python_version >= "3.10"
Requires-Dist: lxml==6.0.0
Requires-Dist: multidict==6.1.0
Requires-Dist: numpy==1.24.4
Requires-Dist: pandas==2.0.3
Requires-Dist: propcache==0.2.0
Requires-Dist: python-dateutil==2.9.0.post0
Requires-Dist: pytz==2025.2
Requires-Dist: requests==2.32.4
Requires-Dist: six==1.17.0
Requires-Dist: soupsieve==2.7
Requires-Dist: tenacity==9.0.0
Requires-Dist: tqdm==4.67.1
Requires-Dist: typing-extensions==4.13.2
Requires-Dist: tzdata==2025.2
Requires-Dist: urllib3==2.2.3
Requires-Dist: user-agent==0.1.10
Requires-Dist: yarl==1.15.2
Dynamic: license-file


| [![Run Tests](https://github.com/c4road/earningspy/actions/workflows/run-tests.yml/badge.svg)](https://github.com/c4road/earningspy/actions/workflows/run-tests.yml) | [![Bump Version on Merge](https://github.com/c4road/earningspy/actions/workflows/bump-version.yml/badge.svg)](https://github.com/c4road/earningspy/actions/workflows/bump-version.yml) | [![Publish Wheel to PyPi](https://github.com/c4road/earningspy/actions/workflows/publish-wheel.yml/badge.svg)](https://github.com/c4road/earningspy/actions/workflows/publish-wheel.yml) |
|----------|----------|----------|







# EarningsPy 📈

EarningsPy is the elegant Python alternative for studying Post Earnings Announcement Drift (PEAD) in financial markets. Designed for quant researchers, data scientists, and finance professionals, this package provides robust tools to analyze earnings calendars, automate data collection, and perform advanced event studies with ease.

## Features

- 🗓️ **Earnings Calendar Access**: Effortlessly retrieve earnings dates by sector, industry, index, or market capitalization.
- 🚀 **PEAD Analysis**: Built-in utilities to compute post-earnings drift and related statistics.
- 🏦 **Data Integration**: Seamless integration with Finviz for comprehensive earnings and 20 min delayed market data.
- 🔍 **Flexible Filtering**: Filter earnings events by week, month, or custom criteria.
- 🛠️ **Quant-Friendly API**: Pandas-based workflows for easy integration into quant research pipelines.
- 📊 **Excel-Ready Data**: Generate profiled, ready-to-use datasets for calculations and modeling directly in Excel.

## Requirements

- Tested in Python 3.10 only


## Installation

```bash
pip install earningspy
```
