Metadata-Version: 2.4
Name: shahmat
Version: 0.0.7
Summary: Analyze your Chess.com X Lichess.org 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)  
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Contact-purple.svg)](https://www.linkedin.com/in/anthony-gocmen/)  
[![YouTube FR](https://img.shields.io/badge/YouTube-French-red.svg)](https://www.youtube.com/@ag_algolab_fr)  
[![YouTube EN](https://img.shields.io/badge/YouTube-English-red.svg)](https://www.youtube.com/@ag_algolab)  


**ShahMat** is a Python package that leverages the official [Chess.com](https://www.chess.com) API to **fetch, analyze, and visualize your games**.  
It is part of the [AG Algo Lab](https://ag-algolab.github.io/) 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
  - Number of games per 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 & Use ShahMat:
```bash
pip install ShahMat

chesscom('your_username', start_year=2024)
