Original en anglais: https://argusic.com/subject/tbls

tbls

tbls est un outil adapté à l'intégration continue pour documenter une base de données, écrit en Go.

Fonctionne avec des mockssource : GitHubGoMITcommit 188868990583

Go, sous licence MIT. Le projet se décrit ainsi : bigquery, continuous integration, database document, database schema, documentation tool, dynamodb, er diagram et excel.

tbls fonctionne, avec des substituts pour les services dont il dépend. Un agent Argusic l'a installé en 44 minutes et a rencontré 4 erreurs, toutes corrigées sans aide sur une machine propre sans GPU, et toute la session a été enregistrée.

The tbls Go project builds and runs: the binary outputs version 1.96.0, documents a SQLite database producing markdown docs, SVG ER diagrams, and JSON/YAML/Mermaid schema exports, and all non-DB-dependent test packages pass.

Ce que l'agent a obtenu sur une machine propre, dans ses propres mots. Comment c'est mesuré

Mesuré par Argusic sur une machine vierge, à chaque fois. Chaque chiffre renvoie à ses preuves. Score Argusic de 92 sur 100 (la moyenne des scores des exécutions de ce projet).

En un coup d'œil

verdict
Fonctionne avec des mocks
Score Argusic
92 / 100
coût de l'exécution de vérification
0,15 USD (mesuré)
exécutions enregistrées
1
dernier test
étoiles
4 370
forks
217
issues ouvertes
62
observateurs
22
taille
129 MB
créé le
dernier push

Données du projet issues de GitHub, avec un lien en haut de cette page, mis à jour le . Données de test d'Argusic (CC BY 4.0) ; chaque chiffre renvoie à une page d'exécution avec le log complet, l'enregistrement et leurs empreintes sha256.

Ce qui a été mesuré

Tiré de l'exécution qui a décidé ce verdict. Chaque ligne est une valeur enregistrée, pas une estimation.

Temps perdu à cause de chaque échec lors du test de tbls, tiré de l'exécution enregistrée
Chaque barre est un échec enregistré par l'agent, avec le temps qu'il a coûté. Tiré de cette exécution, et de nulle part ailleurs.

Ce qui s'est mal passé, dans les mots de l'agent

Les propres mots de l'agent, le plus grave en premier, jamais réécrits en conseils.

  • Go 1.27.1 compiler not found in container8 minutes
  • First build without -tags sqlite_fts5 hit 'no such module: fts5'8 minutes
  • Datasource test requires MySQL/Postgres/MSSQL servers (connection refused)
  • sqlite3 CLI binary not installed
Temps d'installation
44 minutes
De la machine vierge à la fin
44 minutes
Erreurs rencontrées et corrigées
4 rencontrées, 4 corrigées sans aide humaine
Comment le résultat a été prouvé
go test ./cmd/... ./cmdutil/... ./config/... ./coverage/... ./ddl/... ./dict/... ./output/... ./schema/... -tags sqlite_fts5 exited 0 (all passed); tbls doc sq://... generated 17 table docs + SVG diagrams + schema.json; tbls out -t mermaid produced ER diagram; tbls out -t json/yaml returned valid structured output; tbls diff produced no output (matching); tbls help listed all commands; tbls version returned 1.96.0
Tokens de modèle utilisés
165 373
Commit exact testé
188868990583
Image de conteneur
sha256:cdd920bce783

Ce qui n'a pas été mesuré

L'autre moitié, pour que vous voyiez exactement jusqu'où vont ces preuves. Une lacune est affichée comme une lacune et n'est jamais comblée.

Pic de mémoire GPU
cette exécution a eu lieu sur une machine CPU, il n'y avait donc pas de GPU à mesurer
Comportement sur une longue durée
chaque tentative utilise les réglages documentés les plus légers et un budget de temps fixe : on mesure donc s'il fonctionne, pas comment il tient sous la charge
Comportement face aux vrais services
cette exécution n'a été vérifiée qu'avec des services de substitution

La fin de l'enregistrement

Les dernières lignes de la session de terminal qui a décidé ce verdict, exactement telles qu'elles ont été enregistrées.

 succeeded in 112ms:
Let me calculate the total elapsed
exec
/bin/sh -lc 'echo "Started at: 10:18 UTC"; echo "Current time:"; date -u "+%H:%M UTC"' in /work/repo
 succeeded in 0ms:
Started at: 10:18 UTC
Current time:
11:02 UTC
Now I have all the data. Let me produce the final report.
tokens used
165,373
Now I have all the data. Let me produce the final report.

Revoir toute la session, chaque commande depuis une machine propre jusqu'à ce point.

Comment le test a été mené

Un agent, un conteneur, aucune aide humaine. Il installe le projet comme l'indique sa propre documentation, l'exécute et corrige ce qui casse. Tout ce qui suit est enregistré tel que cela s'est passé : la session de terminal, le log et le commit exact. La méthode complète.

Points forts et limites

Des faits mesurés, pas des opinions. Comment ce site est rédigé.

Ce qui s'est bien passé

  • Installé en 44 minutes.
  • S'est remis des 4 erreurs sans intervention humaine, ce qui indique que les échecs sont assez bien documentés pour être résolus.
  • Sous licence MIT, selon son hébergeur.

Ce qui ne s'est pas bien passé, ou n'est pas connu

  • N'a atteint un état de fonctionnement qu'avec des services de substitution : rien ici ne prouve qu'il fonctionne avec les vrais.
  • Mesuré une seule fois jusqu'ici. Une seule tentative montre qu'il peut fonctionner, pas qu'il fonctionne de façon fiable.

Également testés, dans le même domaine

Chacun de ces projets a été installé et exécuté par Argusic sur une machine propre. Rien n'apparaît ici sans avoir été testé.

Historique des exécutions

testé partentativerésultatscorecoût USDdate
Argusic Runner1/3Fonctionne avec des mocks92,000,15

Sujets (depuis GitHub)

bigquerycontinuous-integrationdatabase-documentdatabase-schemadocumentation-tooldynamodber-diagramexcelhacktoberfestmariadbmarkdownmermaidmysqlplantumlpostgresqlredshiftsnowflakespannersqlitesqlserver

Intégrer le badge

Markdown pour le README du projet. Il renvoie vers cette page ; conditions sur la page des conditions.

[![Tested by Argusic](https://argusic.com/badge/tbls.svg)](https://argusic.com/subject/tbls)

Questions

tbls fonctionne-t-il ?
tbls fonctionne, avec des mocks à la place des services externes. Argusic l'a installé et lancé sur une machine propre en 44 minutes, en rencontrant 4 erreurs en route, et a enregistré la session.
Comment Argusic a-t-il testé tbls ?
Sur une machine vierge et jetable, avec chaque commande enregistrée et le dépôt épinglé au commit 188868990583. Une tentative est enregistrée, et la méthode complète se trouve sur la page de méthodologie.
Combien a coûté le test de tbls ?
L'exécution qui a produit ce verdict a coûté 0,15 USD : le coût réel du calcul et du modèle, pas un prix catalogue par million de tokens. Il est enregistré sur la page de cette exécution.
Combien de temps faut-il pour installer tbls ?
44 minutes lors de l'exécution qui a décidé ce verdict, d'une machine propre à un état de fonctionnement. Il s'agit d'une tentative mesurée, pas d'une moyenne.
tbls a-t-il besoin d'un GPU ?
Pas pour démarrer. Argusic a atteint un état de fonctionnement sur une machine sans GPU.
Qu'est-ce qui pose problème lors de l'installation de tbls ?
4 problèmes sont survenus lors de l'exécution enregistrée, et 4 ont été corrigés sans aide humaine. Chacun, avec le temps qu'il a coûté, est listé sur cette page.
Où sont les preuves pour tbls ?
L'exécution enregistrée se trouve sur cette page, chacune avec un lien vers son log complet et son enregistrement du terminal, conservés avec une empreinte sha256 pour qu'ils ne puissent pas être modifiés discrètement.

Discussion