Skip to content
This repository was archived by the owner on Oct 12, 2026. It is now read-only.
BlizirePublic archive

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

fdmv

Deprecated — no longer maintained. The public API endpoints this project relied on no longer exist in their original form. Texas DPS has changed its appointment scheduling system and API since this tool was written.

The latest commits were part of an effort to modernize the Python code and project setup. When that work reached HTTP testing, it became clear that the original API integration no longer worked. Adapting the project to the changed scheduling system is no longer worth maintaining, so development has stopped.

The documentation below describes the intended workflow as if the original API were still available. Setup instructions remain useful for exploring the code, but live appointment searches will no longer work.

About

fdmv is a personal Python tool for finding earlier Texas DPS driver license appointments across a wider area than the scheduling website's limited list of nearby offices.

The tool queries appointment availability for ZIP codes in a bundled dataset, calculates the distance from your home ZIP code, filters results by a chosen radius, removes duplicate records, and sorts appointments by date and distance. It saves the results to a JSON file for inspection. It searches for availability; it does not book appointments.

Requirements

  • Python 3.12 or newer
  • uv for dependency management
  • An internet connection for live appointment searches

The project uses requests for HTTP requests and geopy for distance calculations. Both are installed during setup.

Setup

Clone the repository, open a terminal in its root directory, and install the project and its dependencies:

uv sync

This creates a local .venv and installs the fdmv command.

Alternatively, use an existing Python 3.12+ virtual environment with pip:

python -m pip install -e .

Configuration

Edit src/fdmv/cli.py before running the tool:

data = dmvttp.get_all_appointments(cache=False)
data = zipp.generate_distance_data(data, "75074", miles=50)
  • Replace "75074" with your home ZIP code.
  • Change miles=50 to your desired search radius in miles.
  • Use cache=False to fetch appointment availability and write cache.txt.
  • Use cache=True to reuse an existing cache.txt without fetching availability again. A cached file must already exist in the directory where you run the tool.

These settings are configured in the source code; the command does not accept ZIP code or radius arguments. The distance calculation expects the returned appointment data to contain an entry for your home ZIP code.

Run

From the repository root:

uv run fdmv

If you installed with pip, run fdmv from your activated virtual environment.

During a live search, the tool prints the ZIP code and HTTP status for each request. It then writes these files to the current working directory:

File Contents
cache.txt Raw appointment records from the most recent live search, stored as JSON.
appointments.json Filtered, deduplicated appointment records sorted by date and distance.

Each result includes the location ID, address, appointment date, ZIP code, latitude, longitude, and calculated distance in miles. Output dates use YYYY/MM/DD format.

Reuse cached results when adjusting the ZIP code or radius to avoid repeating requests. Cached availability reflects the time it was fetched.

Project layout

src/fdmv/
├── cli.py          # Entry point and search configuration
├── dmvttp.py       # Appointment API requests and caching
├── zipp.py         # Distance calculation and radius filtering
├── sorter.py       # Deduplication and appointment sorting
└── data/
    └── 2014_Gaz_zcta_national.txt

The ZIP code reference file is bundled with the Python package and loaded using importlib.resources, so it can be found regardless of the current working directory. Despite its .txt extension, the bundled file contains JSON records. No separate data download or manual placement is required.

Maintenance status

This repository is retained for reference and personal experimentation. There are no plans to restore compatibility with the current scheduling system.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages