Metadata-Version: 2.1
Name: uscis-case-status
Version: 0.1.2
Summary: USCIS Status Checker
Home-page: https://github.com/pkhanpara/uscis-case-status
Author: Poojan Khanpara
Author-email: Poojan Khanpara <poojankhanpara@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/pkhanpara/uscis-case-status
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: selenium
Requires-Dist: undetected-chromedriver

# USCIS Status Checker

A Python package that scrapes the USCIS website and returns the latest status for a case.

## Prerequisites

- Python 3.8+
- Chromium or Google Chrome installed
- Xvfb (`sudo apt install xvfb` on Debian/Ubuntu)

## Installation

```bash
pip install uscis-case-status
```

Or install from source:

```bash
pip install .
```

## Usage

### CLI

```bash
# Using the console script
uscis-case-status EAC1234567890

# Or using the Python module
python -m uscis_case_status EAC1234567890
```

Output:

```
Case:    EAC1234567890
Date:    01/15/2026
Status:  On January 15, 2026, your Form I-765 ...
```

Use `--help` for usage info:

```bash
uscis-case-status --help
```

### Python API

```python
from uscis_case_status import get_case_status

result = get_case_status("EAC1234567890")
print(result["date"])    # e.g. "01/15/2026"
print(result["status"])  # Full status message text
```

`get_case_status()` returns a dict with:

- `date` — the date the status was last updated (MM/DD/YYYY)
- `status` — the full status message text

Raises `ValueError` if the case ID is invalid or the status cannot be parsed.

## Building a Wheel

```bash
pip install build
python -m build --wheel
```

The `.whl` file will be in the `dist/` directory.
