qpws-camper v1.0.1

qpws-camper is a tool to quickly check availabilities at campgrounds listed on the Queensland National Parks Booking Service. Hopefully it saves you a few minutes and gets you out camping!

So far the functionality is incomplete and lacks support for a few types of listings in the booking service. If you see a "Check Availabilities" button for the facility you're looking at, hopefully it should work. If not, feel free to open an issue.

Installation

npm install -g qpws-camper

Usage

qpws-camper --date YYYY-MM-DD --facility "<facility name>"

The CLI is limited and only takes a couple arguments. --date specifies the start date for the search. --facility specifies the facility name exactly as you see it on the booking site. That's it.

Example

Heading to the beach? Let's see.

$ qpws-camper --date 2021-05-01 --facility "MV Sarawak"
┌─────────┬──────────────────┬─────────────────┐
│ (index) │       date       │ sites_available │
├─────────┼──────────────────┼─────────────────┤
│    0    │ 'Sat, 1/5/2021'  │       218       │
│    1    │ 'Sun, 2/5/2021'  │       229       │
│    2    │ 'Mon, 3/5/2021'  │        0        │
│    3    │ 'Tue, 4/5/2021'  │        0        │
│    4    │ 'Wed, 5/5/2021'  │        0        │
│    5    │ 'Thu, 6/5/2021'  │        0        │
│    6    │ 'Fri, 7/5/2021'  │        0        │
│    7    │ 'Sat, 8/5/2021'  │       248       │
│    8    │ 'Sun, 9/5/2021'  │       242       │
│    9    │ 'Mon, 10/5/2021' │       242       │
│   10    │ 'Tue, 11/5/2021' │       242       │
│   11    │ 'Wed, 12/5/2021' │       242       │
│   12    │ 'Thu, 13/5/2021' │       242       │
│   13    │ 'Fri, 14/5/2021' │       240       │
└─────────┴──────────────────┴─────────────────┘

Bugs?

qpws-camper interacts directly with the booking service UI, clicking buttons and such as if it were a real human getting ready for a really nice camping trip! This means it has a few limitations and can be a bit brittle. If it fails for you, please open an issue. I can't promise I'll fix it, but it's better to keep track of these things.

There are two important flags. --verbose logs which steps have been taken so far. --debug-browser opens the browser in "headed" mode so that you can watch it do its thing (it's fast)! Both flags might yield useful information for when opening an issue.