Metadata-Version: 2.4
Name: shahmat
Version: 0.0.2
Summary: Analyze your Chess.com games: fetch, stats (hour, Elo diff), and clean visualizations.
Home-page: https://ag-algolab.github.io/
Author: Anthony Gocmen
Author-email: anthony.gocmen@gmail.com
License: MIT
Project-URL: Source, https://github.com/ag-algolab/ShahMat
Keywords: chess,chess.com,analytics,elo,visualization,data-science
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Games/Entertainment :: Board Games
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: pandas>=1.3
Requires-Dist: numpy>=1.21
Requires-Dist: matplotlib>=3.5
Requires-Dist: tqdm>=4.64
Requires-Dist: requests>=2.28
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# ShahMat

[![Python](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://www.python.org/)  
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

**ShahMat** is a Python package that leverages the official [Chess.com API](https://www.chess.com/news/view/published-data-api) to **fetch, analyze, and visualize your games**.  
It is part of the **AG Algo Lab** initiative: making finance & tech accessible to everyone — and yes, sometimes we have fun applying data science to chess too!

The name *ShahMat* comes from the ancient expression that later gave birth to the word **“checkmate”** :)  

---

## Features

- **Fetch games** directly from Chess.com using a single function
- **Analyze performance (through Visualizations)** by:
  - Hour of the day
  - Elo difference vs opponents
  - Color (White / Black)
  - Result type breakdown (wins, losses, draws)
- **Download**: export your data in a csv file

---

## Quick Start

Install ShahMat (when available on PyPI):
```bash
pip install shahmat

chesscom('your_username', start_year=2024)
