Skip to main content

groster

A tool for fetching and processing a World of Warcraft guild roster via the official Blizzard API. Its primary feature is to identify and group alternate characters (alts) with their main characters based on shared account-wide data.

Problem Statement

The standard guild roster from the Blizzard presents a flat list of characters without indicating which ones belong to the same player. Manually tracking mains and alts is tedious and error-prone, making it difficult to understand the true size and composition of a guild's player base.

This tool automates the process by programmatically analyzing character data to uncover these player-character relationships, providing a clear and accurate overview of the guild roster.

Technology Stack

  • Language: Python 3.12+
  • Data Processing: pandas - Data processing, analysis and manipulation
  • HTTP Requests: httpx - For all interactions with the Blizzard Battle.net REST API
  • Configuration: python-dotenv - For managing API credentials securely
  • Linting: ruff - As an all-in-one tool for code linting and formatting, ensuring high code quality
  • Dependency Management: uv - The project's required tool for Python dependency management.

Documentation

License

This project is licensed under the MIT License. See the LICENSE file for details.

Metadata

Release files for groster 0.4.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 groster 0.4.0
File Size Uploaded
groster-0.4.0.tar.gz 304.8 kB Details

Built distribution (wheel)

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

Total release size: 322.3 kB

Release files / groster-0.4.0.tar.gz

Download URL groster-0.4.0.tar.gz
Size 304.8 kB
Tags Source
SHA-256 checksum
How to use checksums
18042b9487b57d6b11426abafc111f441c42329116a246b993d4399ed5927449
BLAKE2b-256 checksum
How to use checksums
e69482b37476d0434f06c7c1e9c1f8199efe5b9a774182e9750f6819e33d8fc0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.4

Release files / groster-0.4.0-py3-none-any.whl

Download URL groster-0.4.0-py3-none-any.whl
Size 17.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
78c098f0660b7610e1c7ca0ee3f6812c5eb83e274342dac57b18a96eb03520c4
BLAKE2b-256 checksum
How to use checksums
a3685748ec79bbbeb7d6b88182657ff86bbd9dc2f042b97f89dbed3c311b7195
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.4

Release history Release notifications | RSS feed

This release

0.4.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