Skip to main content

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:

pipx install pawnfetch
# or
uv tool install pawnfetch

To install directly from GitHub instead:

uv tool install git+https://github.com/thegreekgoat98/pawnfetch.git

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

Metadata

Release files for pawnfetch 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pawnfetch 0.1.0
File Size Uploaded
pawnfetch-0.1.0.tar.gz 21.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pawnfetch 0.1.0
File Interpreter ABI Platform
pawnfetch-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 30.0 kB

Release files / pawnfetch-0.1.0.tar.gz

Download URL pawnfetch-0.1.0.tar.gz
Size 21.0 kB
Tags Source
SHA-256 checksum
How to use checksums
a7de1001aad0e9dba55d8add3aff612cd9a15e5963c63ba59c94120c4c79b029
BLAKE2b-256 checksum
How to use checksums
8f594aae14be7457679bd7aeb1a8e66bbe8d46eb80b6f898389f82b46dfb4e06
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / pawnfetch-0.1.0-py3-none-any.whl

Download URL pawnfetch-0.1.0-py3-none-any.whl
Size 9.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
94fbeb062c94898e3397bce8b40d40b15a866412646d86c04486e85432d52e74
BLAKE2b-256 checksum
How to use checksums
3d5fa0b8f81950aeaa849c3b6bd409dc741bc7fdb312164b60517ce2e5f4e955
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page