Original em inglês: https://argusic.com/subject/unifi-api-client

UniFi-API-client

Uma classe cliente de API PHP para interagir com a API do UniFi Controller da Ubiquiti.

Executa com mocksfonte: GitHubPHPMITcommit ce7e6c84a058

PHP, licença MIT. O projeto se descreve como: api, api client, class, client, controller, curl, php e ubiquiti.

UniFi-API-client executa, com substitutos para os serviços de que depende. Em uma máquina limpa sem GPU, um agent da Argusic o instalou em 3 minutos e encontrou 2 erros, corrigindo todos sem ajuda, e a sessão inteira foi gravada.

Library installs via composer, autoloads, and the Client class authenticates (password and API key), lists sites, lists usergroups, and reads sysinfo against a mock controller returning valid JSON responses.

O que o agent conseguiu em uma máquina limpa, nas palavras dele. Como isto é medido

Medido pela Argusic em uma máquina nova, todas as vezes. Cada número tem link para as suas evidências. Pontuação Argusic 92 de 100 (a média das pontuações das execuções deste projeto).

Visão geral

veredito
Executa com mocks
Pontuação Argusic
92 / 100
custo da execução de verificação
US$ 0,12 (medido)
execuções registradas
1
último teste
estrelas
1.349
forks
239
issues abertas
8
observadores
63
tamanho
1 MB
criado em
último push

Dados do projeto de GitHub, com link no topo desta página, atualizado em . Dados de teste da Argusic (CC BY 4.0); cada número tem link para uma página de execução com o log completo, a gravação e os hashes sha256 deles.

O que foi medido

Da execução que decidiu este veredito. Cada linha é um valor registrado, não uma estimativa.

Tempo perdido em cada falha durante o teste de UniFi-API-client, extraído da execução registrada
Cada barra é uma falha que o agent registrou, com o tempo que ela custou. Extraído desta execução, e de nenhum outro lugar.

O que deu errado, nas palavras do agent

As palavras do próprio agent, das piores para as menores, nunca reescritas como conselho.

  • Static PHP's curl could not connect to localhost (musl libc issue)5 minutos
  • PHP not pre-installed in container (no root for apt-get)2 minutos
Tempo de instalação
3 minutos
Da máquina limpa até o fim
25 minutos
Erros encontrados e corrigidos
2 encontrados, 2 corrigidos sem ajuda humana
Como o resultado foi comprovado
/tmp/php /tmp/test_integration.php: login success, list_sites=1, list_usergroups=1, stat_sysinfo=1. /tmp/php /tmp/test_api_key.php: API key auth login success, list_sites=1.
Tokens de modelo usados
478.834
Commit exato testado
ce7e6c84a058
Imagem do container
sha256:cdd920bce783

O que não foi medido

A outra metade, para você ver exatamente até onde estas evidências vão. Uma lacuna é mostrada como lacuna e nunca é preenchida.

Pico de memória da GPU
esta execução foi em uma máquina com CPU, então não havia GPU para medir
Comportamento em uma execução longa
cada tentativa usa as menores configurações documentadas e um orçamento de tempo fixo, então isto mede se ele executa, não como ele se comporta sob carga
Comportamento com serviços reais
esta execução foi verificada apenas com serviços substitutos

O fim da gravação

As últimas linhas da sessão de terminal que decidiu este veredito, exatamente como foram gravadas.

- The static PHP's embedded curl couldn't connect to localhost (musl-libc network sandboxing). Work…
- Built a Python mock UniFi controller supporting both username/password and API key auth, handling…
**Verification**: Both authentication methods tested successfully against the mock. Login, `list_si…
tokens used
478,834
Here's a summary of what was accomplished:
**Install**: composer installed the library with no errors. The library has zero runtime dependenci…
**Issues encountered**:
- PHP was not pre-installed in the container. Installed via static binary (php 8.0.30) and a glibc-…
- The static PHP's embedded curl couldn't connect to localhost (musl-libc network sandboxing). Work…
- Built a Python mock UniFi controller supporting both username/password and API key auth, handling…
**Verification**: Both authentication methods tested successfully against the mock. Login, `list_si…

Reproduzir a sessão inteira, cada comando desde a máquina limpa até este ponto.

Como foi testado

Um agent, um container, nenhuma ajuda humana. Ele instala o projeto do jeito que a própria documentação do projeto manda, executa o projeto e corrige o que quebra. Tudo abaixo é registrado como aconteceu: a sessão de terminal, o log e o commit exato. A metodologia completa.

Pontos fortes e limites

Fatos medidos, não opiniões. Como este conteúdo é escrito.

O que deu certo

  • Instalado em 3 minutos, mais rápido que a mediana dos 60 projetos comparáveis que a Argusic mediu.
  • Recuperou-se de todos os 2 erros sem que uma pessoa interviesse, o que indica que as falhas estão documentadas o suficiente para serem resolvidas.
  • Licença MIT, segundo a plataforma onde o projeto está hospedado.

O que não deu certo, ou não se sabe

  • Só chegou a um estado de execução com serviços substitutos, então nada aqui prova que ele funciona com os serviços reais.
  • Medido uma vez até agora. Uma única tentativa mostra que ele pode executar, não que executa de forma confiável.

Dos 61 projetos de api que a Argusic instalou e cronometrou, UniFi-API-client foi o 24º mais rápido a chegar a um estado de execução, e 35 de 61 chegaram a esse estado.

Também testados, na mesma área

Cada um destes foi instalado e executado pela Argusic em uma máquina limpa. Nada aparece aqui sem ter sido testado.

Histórico de execuções

testado portentativaresultadopontuaçãocusto USDquando
Argusic Runner1/3Executa com mocks92,000,12

Tópicos (de GitHub)

apiapi-clientclassclientcontrollercurlphpubiquitiubntunifi

Incorporar o selo

Markdown para o README do projeto. Ele tem link de volta para esta página; os termos estão na página de termos.

[![Tested by Argusic](https://argusic.com/badge/UniFi-API-client.svg)](https://argusic.com/subject/unifi-api-client)

Perguntas

UniFi-API-client executa?
UniFi-API-client executa, com mocks no lugar de serviços externos. A Argusic o instalou e iniciou em uma máquina limpa em 3 minutos, encontrando 2 erros no caminho, e gravou a sessão.
Como a Argusic testou UniFi-API-client?
Em uma máquina nova e descartável, com cada comando gravado e o repositório fixado no commit ce7e6c84a058. Há uma tentativa registrada, e a metodologia completa está na página da metodologia.
Quanto custou testar UniFi-API-client?
A execução que produziu este veredito custou US$ 0,12: custo real de computação e de modelo, não um preço de tabela por milhão de tokens. Esse valor está registrado na página da execução.
Quanto tempo leva para instalar UniFi-API-client?
3 minutos na execução que decidiu este veredito, de uma máquina limpa até um estado de execução. É uma tentativa medida, não uma média.
UniFi-API-client precisa de GPU?
Não para iniciar. A Argusic chegou a um estado de execução em uma máquina sem GPU.
O que dá errado ao instalar UniFi-API-client?
2 coisas quebraram na execução registrada, e 2 foram corrigidas sem ajuda humana. Cada uma, com o tempo que custou, está listada nesta página.
Como UniFi-API-client se compara às alternativas?
Dos 61 projetos de api que a Argusic instalou e cronometrou, UniFi-API-client foi o 24º mais rápido a chegar a um estado de execução, e 35 de 61 chegaram a esse estado.
Onde estão as evidências de UniFi-API-client?
A execução registrada está nesta página, cada uma com link para o seu log completo e a sua gravação do terminal, guardados com uma impressão digital sha256 para que não possam ser alterados discretamente.

Discussion