We currently have no plans to keep the bot up to date, and it is probably not functional. All proposed diffs and patches from the community will still be actively reviewed however.
Resolved is a combination of the following:
- A go API to resy
- An application on top of the API that can perform concurrent tasks such as repeating a reservation request at differing time intervals or scheduling a reservation request until a specified reservation drop date
- A command prompt interface to the application
- An HTTP server interface to the application
So far, items 1-3 are implemented, with future plans in the issues section labelled "enhancements"
- Install the go programming language, this can be done by searching "golang installation"
- clone this repository
- run
go buildin root directory of project
If you would like to test new features, the develop branch is a decently tested staging area for new
feautres, usually 3 features ahead of main.
On a successful start up, one should be prompted with the CLI welcome message:
Typing help yields:
I'll explain each command, but not in the order they appear:
searchtakes in one required input, the name of restuarant you want to search for, and one optional input, a number to limit the results by. The name of the restaurant is specified with the-nflag(or alternatively the--nameflag) and the limit is specified with the-l(alternatively--limit) flag.
Here is an example use of a search using a name of carbone and limit of 5:
What if the restaurant name has spaces? Just wrap it in square brackets. In this next example, we'll search for "double chicken please":
The purpose of searching is to obtain the VenueID. This number is a unique identifier that resy uses to find the restaurant that you want to reserve at, since multiple restaurants can have the same name.
logintakes in two required inputs, the email(-eflag) and password(-pflag) associated with your resy login. It then checks to see if these inputs are a valid login to resy. This command is useful if you intend to use any other command that has an email and password, as these will be used as defaultslogoutclears the defaults set by a login if you want to erase your credentials from the systemratsis one of the two core function commands of the bot(the other beingrais). Its main use is to schedule a time to try to get a reservation at. For example, some restaurants will only release available seating for a given day six days before. So if I want to reserve an 11 PM on the 7th, I have to be one of the lucky few who press "reserve" fast enough on the 1st.ratswill automate this task for you.
Here is an example use:
I'll walk through what each flag does:
-vor--venue-idspecifies the unique identifier for which we want to make a reservation. We're using double chicken please's id from the search example.-resDor--reservation-dayspecifies the day that we want our reservation at in yyyy:mm:dd format. In this case, we're setting the day to be september 7th, 2023-resTor--reservation-timesspecifies the military style times we want to make our reservation at in hh:mm format and in order of priority. In this case, we only have one time, but we could list as many times as we want in that area, and if the first n fail, it will try the n+1th-psor--party-sizespecifies the party size, in this case 2 people-reqDor--request-datespecifies the date at which we want to make the request(basically the date we want to press the "reserve" button at). This should be supplied in military time, with format yyyy:mm:dd:hh:mm (year:month:day:hour:minute). In this case, we want to press "reserve" at midnight on september 1st, 2023.-tor--tableis an optional flag that allows the user to specify a priority list of table types. So an example input is-t outdoor dining. The priority of reservations in this case is all times in-resTwill be tried in priority order with the first table type specified, then another iteration of all reservation times with a second table type.
Other flags include a -e flag for email and -p for password, but if logged in this is not needed(actually if you are logged in but don't want to use the login credentials you used in the login command, specifying -e and -p flags here will override those credentials for this command)
The output of this command on success is an ID number. This can be used in later commands to see the status(whether it failed or succeeded) or to cancel the operation.
raisis one of the two core function commands of the bot(the other beingrats). Its main use is to try to make a reservation at a repeating interval.
The inputs are very similiar to rats:
-vor--venue-idspecifies the unique identifier for which we want to make a reservation.-resDor--reservation-dayspecifies the day that we want our reservation at in yyyy:mm:dd format.-resTor--reservation-timesspecifies the military style times we want to make our reservation at in hh:mm format and in order of priority.-psor--party-sizespecifies the party size, in this case 2 people-ior--intervalspecifies the interval to repeat on in hh:mm format. So, if we used all the same parameters for the previous example with-i 00:01, then this command would try to make an 11:30 PM reservation at double chicken please for september 7th, 2023, and the bot would perform this request every minute (00 for hour, 01 for minute)-tor--tableis an optional flag that allows the user to specify a priority list of table types. So an example input is-t outdoor dining. The priority of reservations in this case is all times in-resTwill be tried in priority order with the first table type specified, then another iteration of all reservation times with a second table type.
Here are the last remaining commands:
canceltakes in a list of ids using the-iflag and tries to cancel the operation associated with each id. In the rats example, the operation has id 0, so callingcancel -i 0will cancel the rats operationlisttakes in no input and outputs a list of each operation's id, its status(failed, succeeded, cancelled, etc.) and the result(error if failed, reservation time if succeeded)cleantakes in a list of ids using the-iflag and will remove the operation information from the system(i.e. it will no longer be displayed from the list command). Operations can only be cleaned once they are no longer in progress.exit/quitleaves the prompthelpoutputs helpful information about each command
I am open and happy to accept contributions from anyone who wants to offer them. To get started on this, read the Contribution Etiquette post in the issue section of this project, which should be pinned. Another document which might be helpful in getting adjusted to the project is the Architecture Overview issue post, which provides an overhead view to what each part of the codebase does. Generally, any helpful information can be found in the issue section labelled with information. I'm avaialble at [email protected]; feel free to send any questions to that address.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent