LoA: League of Archives

Description

LoA: League of Archives is a CLI tool to scape analyzed League of Legends champions stats from OP.GG and BLITZ.GG into XLSX, CSV, JSON or TXT files, visualize the gathered data as a PNG plot and stream the data into a localhost html table and json.

Video Demo

Link: https://www.youtube.com/watch?v=KswQcRJMw8A

Requirements

Python 3.10 - https://www.python.org/downloads/release/python-3105/
Packages, run: pip3 install -r ./requirements.txt

Usage

python3 project.py --help

usage: project.py [-h] [-t TYPE] [--plot | --no-plot] [--stream | --no-stream] [-v] provider

LoA: League of Archives - Scrape, export, visualize and stream data from OP.GG and Blitz.GG

Positional arguments:
  provider              Data provider to use, options: {op.gg, blitz.gg}

Optional arguments:
  -h, --help            Show this help message and exit
  -t TYPE, --type TYPE  Data exporting type, options: {xlsx, csv, json, txt}
  --plot, --no-plot     Visualize the data and export it as png
  --stream, --no-stream
                        Stream the data into html table and json response
  -v, --version         Show program's version number and exit

Results will be exported under ./results

Structure

Data gathering preferences:
- Game patch (version): 12.14
- Game mode: Ranked Solo/Duo
- Champion roles: All ( Top, Jungle, Mid, Bot (ADC), Support)
- Players rank: Platinum and above ( Diamond, Master, Grandmaster, Challenger)
- Region: Global
- Data period: Month or more
Data gathering methods:
- OP.GG: API Call
- BLITZ.GG: API Call
Dataframe structuring:
- Unique value for each champion (161 champion as for patch 12.14)
- The most played role for a champion will be selected if multiple roles are listed.
- Champions with "not enough sample size" mark (The provider did not find enough matches to analyze) will automatically have 0 row values.
- Columns are:
  - ChampionId: int - Source: Provider's response.
  - ChampionName: str - Source: Mapping ChampionId to ChampionName from Data Dragon's champions json response.
  - Role: str - Source: Provider's response.
  - TotalGames: int - Source: Provider's response.
  - wins: int - Source: Provider's response.
  - Losses: int - Source: Provider's response.
  - Winrate: str | float - Source: Formula (rounded to 2 decimal places):
    
    $$ Winrate \space percentage = {Wins \over Total \space games} \times 100 $$
  - Provider: str - Source: The data fetch source.

Todo

Add OP.GG
Add Blitz.GG
Add args parser
Add data exporting
Add data visualization
Add U.GG scraping via Selenium
Add more data providers like mobalytics.gg, metasrc.com, lolalytics.com and lolvvv.com etc.

Resources

Data:
- Champions list:
  - Data Dragon 12.14.1 CDN
- Champions winrates:
  - OP.GG - Stats
  - BLITZ.GG - Tier List
Other:
- Latest patch:
  - BLITZ.GG
- Icons:
  - Lanes:
    - All
    - Top
    - Jungle
    - Mid
    - Bot (ADC)
    - Support
  - Ranks:
    - Platinum
    - Diamond
    - Master
    - Grandmaster
    - Challenger

Disclaimer

This project was made for educational purposes (CS50P) and does not encourage any data usage without permission from its owner.

alfawal/LoA