pawnfetch
A command-line tool to fetch and compare chess.com player profiles and stats, built on chess.com's public PubAPI.
Installation
Install the latest release from PyPI with pipx or uv to use the CLI in an isolated environment:
pipx install pawnfetch
# or
uv tool install pawnfetch
To install into an existing Python environment instead:
pip install pawnfetch
Usage
Look up a profile
pawnfetch profile hikaru
Check ratings and win/loss record
pawnfetch stats hikaru
Compare two players
pawnfetch compare hikaru magnuscarlsen
The pftch command is also available as a shorter alias. For example:
pftch profile hikaru
Development
This project uses uv for dependency management.
git clone https://github.com/thegreekgoat98/pawnfetch.git
cd pawnfetch
uv sync
uv run pawnfetch profile hikaru
Chess.com PubAPI data may be cached for up to 12 hours and may not reflect recent changes immediately. Avoid parallel requests; Chess.com may rate-limit them with HTTP 429.
Run tests:
uv run pytest
Lint:
uv run ruff check .
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for pawnfetch 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pawnfetch-0.1.1.tar.gz | 21.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pawnfetch-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 30.8 kB
Release files / pawnfetch-0.1.1.tar.gz
| Download URL | pawnfetch-0.1.1.tar.gz |
|---|---|
| Size | 21.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ca73d9bef6be0ce684f69fa7357575488b259339b423223746ec56ada6ac49be
|
|
BLAKE2b-256 checksum How to use checksums |
596a1f3adafa611ae98176948aa2b79b811695276115c9c4e606a3dc0ca92a40
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / pawnfetch-0.1.1-py3-none-any.whl
| Download URL | pawnfetch-0.1.1-py3-none-any.whl |
|---|---|
| Size | 9.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
13858596e871a67da30aff916c3acc2e3e33d2ac8b51f933301b00fa23167ad9
|
|
BLAKE2b-256 checksum How to use checksums |
3644257c400e47f5c5a6bc6549e91a1571358b01124373913819d892056259bc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
