Metadata-Version: 2.4
Name: costco-tire-appointments
Version: 0.1.0
Summary: Fetch and display Costco tire center appointment availability
Author: Rachit Trivedi
License: MIT
Project-URL: Homepage, https://github.com/yourusername/costco-tire-appointments
Project-URL: Bug Tracker, https://github.com/yourusername/costco-tire-appointments/issues
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: beautifulsoup4
Requires-Dist: requests
Requires-Dist: lxml

# 🚗 Costco Tire Appointment Finder

[![PyPI version](https://img.shields.io/badge/pypi-costco--tire--appointments-blue)]()
[![Python](https://img.shields.io/badge/python-3.9%2B-blue)]()
[![License](https://img.shields.io/badge/license-MIT-green)]()

A lightweight Python library to find and display **real-time Costco tire center appointment availability** based on a Canadian postal code.

It automatically searches nearby warehouses and returns available booking slots for tire services.

---

## ✨ Features

- 📍 Find nearby Costco tire centers using postal code  
- ⏱ Fetch earliest available appointment slots  
- 📅 View availability grouped by date  
- ⚡ Simple one-line usage  
- 🎯 Optional search radius control  
- 🛞 Optional seasonal tire service inclusion  

---

## 🚀 Installation

```bash
pip install costco-tire-appointments
```

---

## 🚀 Usage

Print appointments (simplest)

```python
from costco_tire_appointments import print_appointments

print_appointments("K2M0L1")
```

---

## Get Structured Data


```python
from costco_tire_appointments import get_appointments

results = get_appointments(
    postal_code="K2M0L1",
    radius_km=50,
    include_seasonal=True
)

print(results)
```
