Metadata-Version: 2.1
Name: maplego
Version: 0.1.0
Summary: MapleStory character statistics CLI
Home-page: https://github.com/secgit/maplego
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# maplego

A beautiful CLI tool for looking up MapleStory character stats from [mapleranks.com](https://mapleranks.com).

## Usage

```
maplego <character-name>
```

**Example:**
```
maplego blzaking
```

Character names are case-insensitive.

---

## Installation

### Via uv / uvx (recommended — no Python or Go required)

```sh
uvx maplego blzaking
```

Or install permanently:
```sh
uv tool install maplego
maplego blzaking
```

### Via pip

```sh
pip install maplego
maplego blzaking
```

Supports macOS (Intel & Apple Silicon), Linux (x86_64 & arm64), and Windows (x86_64 & arm64).

> **Note:** maplego uses headless Chrome to fetch character data. Chrome or Chromium must be installed on your system.

---

## Setup & Installation (from source)

### Prerequisites

Install Go (1.21+): https://go.dev/dl/

### Build & Run

**Run directly:**
```sh
go run . blzaking
```

**Build an executable:**
```sh
go build -o maplego .
./maplego blzaking
```

**Install globally via `go install`:**
```sh
go install .
maplego blzaking
```

---

## Dependencies

- [`github.com/chromedp/chromedp`](https://pkg.go.dev/github.com/chromedp/chromedp) — Headless Chrome automation
- [`golang.org/x/net`](https://pkg.go.dev/golang.org/x/net) — HTML parser

---

## Output

```
╔════════════════════════════════════════════════════════════╗
║                         BlzaKing                          ║
║                   Blaze Wizard in Kronos                  ║
╟────────────────────────────────────────────────────────────╢
║                    Lv. 286  (46.911%)                     ║
║                     51.35T / 109.46T                      ║
║ [████████████████████████████████████████████░░░░░░░░░░░] ║
╠════════════════════════════════════════════════════════════╣
║                        RANKINGS                           ║
╟────────────────────────────────────────────────────────────╢
║ Blaze Wizard Rank in Kronos ·················· #35        ║
║ Kronos Rank ···························· #16,312          ║
║ Blaze Wizard Rank in GMS NA ················· #52         ║
║ GMS NA Rank ···························· #23,701          ║
╠════════════════════════════════════════════════════════════╣
...
```

