Um guia do desenvolvedor para usar o Glamorous Toolkit no protocolo AT

Neste post exploraremos o protocolo AT usando Glamorous Toolkit (GT), um desenvolvimento moldável ferramenta ambiental. O protocolo AT fica abaixo do concorrente do Twitter, Bluesky. A última vez que analisamos GT, fomos brevemente apresentados ao desenvolvimento moldável — uma maneira de entender melhor seus sistemas criando ferramentas personalizadas que podem gerar visualizações interessantes sobre esse sistema. (Eu também insultei um pouco os usuários do Smalltalk, então talvez este post seja uma espécie de pedido de desculpas).

O kit de ferramentas Glamorous foi projetado para explorar APIs, como AT, e pode ajudar a explorar um espaço problemático usando muitos pequenos scripts (ou ferramentas moldáveis), possivelmente feitos de outras visualizações ou chamadas.

Há mais a dizer sobre as possibilidades do desenvolvimento moldável, mas hoje quero focar os aspectos práticos de usar GT para explorar o protocolo AT. Usaremos uma estrutura pré-construída escrita com GT para fazer isso.

Vamos começar com uma nova instalação do kit de ferramentas. Começando na página de download do GT, optei pela instalação do Intel Mac. Como funciona efetivamente com uma imagem, você precisará executá-lo no local.

Quando aberto, você terá acesso imediato aos documentos na guia aberta:

Para que possamos acompanhar o exemplo trabalhado, abra “Estudos de caso de Desenvolvimento Moldável” e clique em “Trabalhando com Protocolo AT”. Isso nos dá uma nova janela de guia no livro.

A primeira coisa que precisamos fazer é instalar o Gt4AtProto. Este é o framework, escrito em GT, que nos ajudará a trabalhar com Bluesky e o protocolo AT. Mas podemos fazer isso diretamente do trecho na página à nossa frente. O livro é feito de texto e trechos executáveis ​​(semelhante a um Jupyter Notebook), então a referência ao carregador de repositório (chamado “Metacello”) está pronta para uso:

A linguagem aqui é chamada Faro, que podemos considerar uma variante ou dialeto do Smalltalk. Mas não precisamos nos preocupar muito com isso.

Podemos executar o trecho com aquela pequena seta ➤ canto inferior esquerdo. (Sempre que quiser parar, basta fechar a janela e você terá a opção de salvar e sair. Você reiniciará de onde parou.)

Execute o trecho e espere. Você saberá quando a estrutura foi carregada do repositório porque o trecho retorna um círculo cinza um tanto sutil no final da classe quando qualquer execução é concluída:

Agora, se você voltar ao principal “gt” guia, o conteúdo da visualização da guia será alterado:

Claramente, você poderia fazer login no Bluseky aqui – mas faremos isso a partir de um trecho diferente.

De volta à guia “Trabalhando com protocolo AT”: uma vez carregado, clique em “Sobre o Glamorous Toolkit para protocolo AT”, que leva à próxima página do livro. Clique em “Trabalhar com a API através do cliente gerado” e estaremos prontos para começar.

Nosso primeiro trabalho é fazer login no Bluesky com um senha do aplicativo. Supondo que você tenha uma conta Bluesky, vá para a página de configurações e crie uma nova senha de aplicativo.Eles foram projetados para permitir o acesso ao Bluesky para um único aplicativo. Esse nome exclusivo apenas ajuda você a se lembrar dele:

OK, se você simplesmente copiar a senha para a área de transferência, podemos trabalhar com isso – embora você também deva anotá-la para garantir.

Se você voltar ao GT, deverá ver o snippet abaixo na página “Trabalhando com a API por meio do cliente gerado”:

Você precisará substituir as duas primeiras variáveis ​​pelas suas credenciais, substituindo as de Tudor lidar. O servidor de domínior provavelmente está correto (esse é o da instância principal do Bluesky). Certifique-se de verificar na sua página de perfil qual é o seu nome de domínio completo para o identificador – o meu é “eastmad.bsky.social”. Como isso implica, a senha será sugada da área de transferência.

Se você avaliar isso, você pode usar aquele último botão “valores de variáveis” para verificar se tudo funcionou:

O próximo trecho abaixo, aquele que menciona o GtApClient, fará seu login. Então Avalie isso, e Inspecionar isto:

Se você receber um erro, verifique suas credenciais e certifique-se de que a senha do aplicativo esteja na área de transferência. Ou apenas faça uma variável como essa lidar e pdsUrul.

O conjunto de dicionários é esperançoso, mas não muito interessante. O próximo trecho se aprofunda um pouco mais, então vamos inspecionar o resultado disso. Veremos como essa visão é construída mais tarde:

Temos uma lista de todas as consultas que podemos fazer, o que significa que podemos começar a brincar com o protocolo AT nesta conta.

Agora vamos sair brevemente da página do livro e criar nosso próprio trecho com uma dessas consultas. Você pode criar seu próprio trecho usando o símbolo “+” na parte inferior de qualquer trecho. Experimente o conteúdo abaixo:

Isso nos dá uma bela visualização padrão de “cartão postal”:

Você pode então brincar com as diferentes visualizações (guias dentro da página), como Seguidores e Seguindo. Você pode criar uma postagem e também clicar em um tópico.

Escrevendo ferramentas em torno do seu alvo

Esta postagem é sobre como deixá-lo confortável com o kit de ferramentas, mas o objetivo do kit de ferramentas é escrever ferramentas de acordo com seu objetivo. Então, vamos dar uma olhada no que é feito uma consulta.

Volte para a lista de consultas – dentro de um painel de guias, você pode rolar para a esquerda e para a direita entre as páginas do documento. Podemos então ver o que compõe o appBskyActorGetProfileActor consulta, aquela que acabamos de usar:

Portanto, esta é uma chamada XRPC. Podemos ver que ele interage com um método framework, com uma consulta específica ao Bluesky, retirando “actor” do parâmetro.

appBskyActorGetProfileActor: actor "" 
<xrpcQuery> 
^ AppBskyActorDefsProfileViewDetailed 
  fromRequest: (self 
    queryOn: 'app.bsky.actor.getProfile' 
    parameters: {'actor' -> actor} asDictionary)

Meu conhecimento sobre Smalltalk é mínimo, mas a divisa (chapéu) é o comando de retorno, então isso retorna uma visualização construída internamente com base na consulta XRPC obter perfil baseado no ator.

Apenas para confirmar a que isso se refere, vamos dar uma olhada rápida na documentação do Bluseky para ver o que esta chamada faz:

De volta ao GT. Para nos lembrar que podemos ser bastante flexíveis com a exploração porque cada visualização é programada dentro de um inspetor, observamos que clicando com a tecla Alt pressionada em uma visualização você pode obter o código por trás dela. Portanto, clicando com a tecla Alt pressionada na guia de visualização “Consultas”, vemos o seguinte:

Podemos editar isso. Por exemplo, você pode ver o título da visão é escrita como parte da visão, assim como o coluna carne. Também podemos ver o método de classificação. Mesmo sem muito conhecimento de Smalltalk, isso implica que poderíamos simplesmente mudar a visão reverter a lista trocando o “:a” e “:b” dentro do bloco de classificação:

Agora, o protocolo AT usa o que chama de “léxico” para corresponder a um sistema de esquema para qualquer chamada. G4Atproto usa isso para gerar a API, mas isso será para uma exploração mais aprofundada em outro momento.

O que conseguimos

Então, em resumo, abrimos o Glamorous Toolkit, instalamos a leitura do protocolo AT gt4atproto, que atua como um ambiente dedicado escrito na parte superior do kit de ferramentas. Nós nos conectamos ao Bluseky por meio de uma senha de aplicativo apenas usando trechos. E vimos como as ferramentas são feitas de scripts sobre XRPC que você pode modificar facilmente. Além disso, vimos como podemos editar uma visualização.

O kit de ferramentas Glamorous foi projetado para explorar APIs, como AT, e espero que isso lhe dê uma ideia de como ele pode ajudar a explorar um espaço de problema usando muitos scripts pequenos (ou ferramentas moldáveis), possivelmente feitos de outras visualizações ou chamadas. Observe como as ferramentas escritas mais próximas do ambiente de destino tornam a exploração muito mais fácil.

A postagem Um guia do desenvolvedor para usar o Glamorous Toolkit no protocolo AT apareceu pela primeira vez em The New Stack.