Skip to main content

camply, the campsite finder ๐Ÿ•

Project description

camply, the campsite finder โ›บ๏ธ, is a tool to help you book a campground online. Finding reservations at sold out campgrounds can be tough. That's where camply comes in. It searches the APIs of booking services like https://recreation.gov (which indexes thousands of campgrounds across the USA) to continuously check for cancellations and availabilities to pop up. Once a campsite becomes available, camply sends you a notification to book your spot!



PyPI PyPI - Python Version Docker Image Version Testing Status GitHub License Black Codestyle pre-commit semantic-release Gitmoji Discord Chat

Check Out The Docs

Installing

Install camply via pip or pipx:

pipx install camply

Usage

Search for a specific recreation area (recreation areas contain campgrounds):

camply recreation-areas --search "Glacier National Park"

Search for campgrounds (campgrounds contain campsites):

camply campgrounds --search "Fire Lookout Towers" --state CA

Search for available campsites, get a notification whenever one becomes available, and continue searching after the first one is found. The below command is using silent notifications as an example but camply also supports Email, Slack, Twilio (SMS), Pushover, Pushbullet, and Telegram.

camply campsites \
    --rec-area 2725 \
    --start-date 2023-07-10 \
    --end-date 2023-07-18 \
    --notifications silent \
    --search-forever

Providers

camply works with a number of providers. A "provider" is an online booking service that lists camping and recreation inventory.

Run camply providers to list current providers and visit the Providers section in the docs to learn more.

Documentation

Head over to the camply documentation to see what you can do!

โฏ camply --help

 Usage: camply [OPTIONS] COMMAND [ARGS]...

 Welcome to camply, the campsite finder.
 Finding reservations at sold out campgrounds can be tough. That's where camply comes in.
 It searches the APIs of booking services like https://recreation.gov (which indexes
 thousands of campgrounds across the USA) to continuously check for cancellations and
 availabilities to pop up. Once a campsite becomes available, camply sends you a
 notification to book your spot!


 visit the camply documentation at https://juftin.com/camply

โ•ญโ”€ Options โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚                                                                                        โ”‚
โ”‚  --version                      Show the version and exit.                             โ”‚
โ”‚  --debug/--no-debug             Enable extra debugging output                          โ”‚
โ”‚  --provider              TEXT   Camping Search Provider. Defaults to                   โ”‚
โ”‚                                 'RecreationDotGov'                                     โ”‚
โ”‚  --help                         Show this message and exit.                            โ”‚
โ”‚                                                                                        โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ
โ•ญโ”€ Commands โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚                                                                                        โ”‚
โ”‚  campgrounds        Search for Campgrounds (inside of Recreation Areas) and list them  โ”‚
โ”‚  campsites          Find Available Campsites with Custom Search Criteria               โ”‚
โ”‚  configure          Set up camply configuration file with an interactive console       โ”‚
โ”‚  equipment-types    Get a list of supported equipment                                  โ”‚
โ”‚  providers          List the different camply providers                                โ”‚
โ”‚  recreation-areas   Search for Recreation Areas and list them                          โ”‚
โ”‚                                                                                        โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

Contributing

Camply doesn't support your favorite campsite booking provider yet? Consider contributing ๐Ÿ˜‰.


Recreation data provided by Recreation.gov




juftin logo

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

camply-0.15.0.tar.gz (69.2 kB view hashes)

Uploaded Source

Built Distribution

camply-0.15.0-py3-none-any.whl (92.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page