bryanwhiting/campsites

Campsite availability via CLI

Small tool to check for campsite availability and notify via text message using Twilio.

▶ find-campsites --help
Usage: find-campsites [OPTIONS]

  Search for campsite availability from recreation.gov or reservecalifornia.

  Note: for `reservecalifornia`, campground argument must refer to the
  facility ID of the campsite. This is tricky to get from the website, so
  try using this tool but enter the park you are interested in as the
  campground. This should return a table of campsites and their associated
  facility ID.

  Examples:
  # Search for Kirby Cove and Hawk Campground for Friday or Saturday availability
  # this month
  find-campsites -c "Kirby Cove" -c "Hawk Campground" -d Friday -d Saturday
  # Search for facility IDs in Millerton Lake SRA
  find-campsites -c "Millerton Lake SRA" --api reservecalifornia
  # Search for specific campsite in Millerton Lake SRA
  find-campsites -c 1120 --api reservecalifornia

Options:
  -c, --campground TEXT           Name of campground to search for
                                  availability (can specify multiple)

  -n, --nights INTEGER            Number of nights to stay  [default: 1]
  -d, --day [Sunday|Monday|Tuesday|Wednesday|Thursday|Friday|Saturday]
                                  Weekday of reservation start (can specify
                                  multiple) [default: all days]

  -m, --months INTEGER            Number of months to search  [default: 1]
  --api [recreation.gov|reservecalifornia]
                                  Reservation API to use  [default:
                                  recreation.gov]

  --check-every INTEGER           Minutes to wait before checking again
                                  [default: 5]

  --require-same-site             Require campsite to be the same over all
                                  nights (no switching campsites)

  --ignore TEXT                   Specific campsite name to ignore (can
                                  specify multiple)

  --notify                        Send text message if campsite is available
  --calendar-date TEXT            Specific date to start reservation
                                  mm/dd/yyyy (can specify multiple)

  --sub-campground TEXT           Some campgrounds have sub-campgrounds that
                                  you can specify with this argument (can
                                  specify multiple)

  --help                          Show this message and exit.

Text message support can be added by creating a Twilio account and adding the following to either a .env file in the project root, or adding to environment variables.

TWILIO_ACCOUNT_SID="YOUR_TWILIO_SID"
TWILIO_AUTH_TOKEN="YOUR_TWILIO_AUTH"
TWILIO_FROM_NUMBER="YOUR_TWILIO_NUMBER"
TWILIO_TO_NUMBER = "YOUR_PHONE_NUMBER"