resy cli
v0.6.0
^ Um usuário feliz resy-cli recebendo exatamente a reserva que ele queria
Isenção de responsabilidade: Este documento tem como alvo um público não técnico. Para uma versão mais técnica deste ReadMe, consulte a leitura.md.
Sobre
Pré -requisitos
Instalação
Configuração de autenticação
Agendar uma reserva
Reserva imediatamente
Solução de problemas
Perguntas frequentes
resy-cli é um programa para agendar uma reserva de reserva de resy para executar exatamente na hora certa no futuro.
Você pode estar perguntando: por que você faria isso? Na verdade, essa é uma ótima pergunta, pois esse projeto é totalmente inútil em mercados de baixa demanda, onde é melhor reservar sua reserva no site da Resy. No entanto, em mercados de alta demanda, como Nova York, os slots de reserva nos principais restaurantes são arrebatados em questão de segundos.
Depois de muitos casos de perder para as pessoas que poderiam clicar mais rápido que eu (ou outros programas?), Decidi que bastava. Embora esse projeto existisse inicialmente como um script de nó simples, eu queria fazer algo que fosse facilmente distribuível e utilizável por amigos e familiares. Alguns fins de semana depois, resy-cli nasceu.
resy-cli é uma interface da linha de comando e resultante requer alguma familiaridade com um emulador de terminal.
Se você estiver usando um computador Mac, há muitos recursos on -line para ajudar você a começar com o emulador de terminal padrão do MacOS (terminal). Isso deve fornecer uma boa base para configurar resy-cli no seu computador.
resy-cli usa o Homebrew Package Manager para distribuição em sistemas operacionais MacOS e Linux. Siga as instruções de instalação de sua página inicial para instalar.
at permissões Sob o capô, resy-cli usa outra interface de linha de comando chamada at agendar reservas para reservar no futuro.
Embora seja desnecessário entender como at funciona para usar resy-cli , é necessário seguir alguma configuração para ativar esse programa em sua máquina. As seguintes instruções são para MacOS ( at chegam pré-instalados). Se você estiver usando um sistema operacional diferente, essas etapas variam (e você pode precisar instalar at separadamente).
Execute o seguinte comando do seu emulador de terminal (isso solicitará as credenciais do usuário do seu computador):
sudo launchctl load -w /System/Library/LaunchDaemons/com.apple.atrun.plist
Navegue para System Preferences > Security & Privacy > Privacy
Desbloquear para editar configurações
Adicione uma nova entrada para "acesso completo ao disco"
Pressione Cmd+Shift+G na caixa de diálogo Seleção de arquivo para selecionar um caminho personalizado
Adicionar /usr/libexec/atrun à lista de comandos/aplicativos com "acesso completo ao disco"
Para instalar resy-cli , execute o seguinte comando do seu emulador de terminal:
brew install lgrees/lgrees/resy
Se a instalação tiver sido bem -sucedida, você deverá ver uma mensagem de sucesso no seu terminal.
Você pode verificar se a instalação foi bem -sucedida executando o seguinte comando:
resy -v
Se o comando for bem-sucedido, você verá a saída como o seguinte indicando a versão atual do resy-cli :
resy version 0.1.0
Para ver todos os comandos disponíveis para você, execute:
resy
Para reservar reservas em seu nome, resy-cli precisa saber sobre as credenciais da sua conta Resy. Para adicioná -las, execute:
resy setup
Você será solicitado a adicionar uma chave da API e um token de autenticação. Siga estas etapas para encontrar esta informação:
Abra um navegador da web
Ferramentas de desenvolvedor aberto (no Chrome: Chrome > View > Developer > Developer Tools )
Navegue para reside e efetuar login
Abra a guia "Rede" com ferramentas de desenvolvedor
Procure solicitações para o domínio: api.resy.com
Veja os cabeçalhos de solicitação
Neste ponto, você deve ver algo que se parece com o seguinte: 
Os valores ofuscados associados às chaves destacados em vermelho são o que você está procurando.
Para verificar se essa configuração foi bem -sucedida, execute:
resy ping
Se esse comando falhar, provavelmente significa que as credenciais que você forneceu estão incorretas. Repita a configuração de autenticação novamente para entrar novamente em suas credenciais.
Quando este comando for bem -sucedido, você está pronto para começar a reservar!
NOTA: A resy expirará periodicamente suas credenciais. É uma boa prática executar resy ping antes de reservar para garantir que resy-cli possa se conectar à sua conta.
Correr:
resy schedule
Agora siga os avisos para agendar sua reserva.
Embora o agendamento de uma reserva seja a principal intenção de resy-cli , às vezes você pode fazer reservar imediatamente usando a CLI (por exemplo, ao testar). resy book é um comando interno que o resy schedule usa sob o capô que reserva imediatamente uma reserva (análoga para clicar na interface do usuário da resy). Este comando pode ser usado da seguinte maneira:
resy book --partySize=2 --reservationDate=2023-02-11 --reservationTimes=18:15:00 --venueId=123 --reservationTypes=""
resy-cli produz um arquivo de log para todas as tentativas de reserva (incluindo corridas secas). Para visualizar logs, execute:
resy log view
A visualização de arquivos de log ajudará a deduzir o que deu errado se resy-cli não fizer a reserva desejada. Na maioria das vezes, isso se deve ao seu computador não estar acordado no momento da reserva, ou o restaurante que não libera nenhum slots que corresponda aos seus critérios.
Para remover todos os arquivos de log, execute:
resy log clear
P: Como minhas credenciais de resy são armazenadas?
R: As credenciais são gravadas no disco em sua máquina local e nunca são compartilhadas (fora de fazer solicitações para reside).
P: E quanto aos fusos horários?
R: resy-cli trata o tempo de reserva que você insere como os tempos do sistema.
Como exemplo, se você deseja reservar às 17:00 e seu computador está pronto para usar o fuso horário oriental, você vai tentar reservar às 17:00 Eastern.
Os tempos de reserva estão localizados na localização do restaurante.
P: E se meu computador estiver desligado / adormecido no momento em que eu quero reservar uma reserva?
R: Reservas de livros resy-cli usando sua máquina local. Se a máquina estiver desligada / adormecida, a reserva não será concluída.
Para contornar isso, você pode agendar seu computador para acordar do sono no momento da reserva. No Mac, usei a pmset CLI para realizar isso com sucesso.
P: Os serviços de reserva estão bem com isso?
R: Cabe aos usuários seguir os (Termos de Serviço) estabelecidos pela Resy. resy-cli é apenas uma ferramenta para automatizar suas interações com resy (sem raspagem na web ou qualquer coisa do tipo).
P: O que acontece quando todos estão usando programas como este? Isso não deixará de ser eficaz?
A: Sim.
P: Acho que encontrei um bug, como posso relatar?
R: Se você tiver uma conta do GitHub, fique à vontade para enviar um problema. Caso contrário, fique à vontade para me enviar uma mensagem.
P: Este programa mudou literalmente minha vida, como posso agradecer ao autor?
A: Considere levá -lo para jantar?
