ElementoValor
NombreTRANSFORMED-BY (BIND del documento de especificación TRANSFORMED-BY)
TAG ID0x1D4L
Codec ID0x00001D40
Documento de especificación0x00000000/codecs/0x00001D40/ (destino de DECLARE 1D40)
Sección14 1110 (Meta), desplazamiento C dentro de la sección = 20
KindMeta · clase: linaje
TAG WORD0001 1101 0100 LLLL (000K KKKC CCCC LLLL)
Descripción del índiceMétodo de conversión. Herramienta, reglas y versión
Lado Hugometa/lineage/transformed-by.md

Campos (documento de especificación)

El orden de los FIELD dentro del documento es el orden de los campos del Payload (documento de especificación de Codec).

OrdenCampo (BIND)FIELDAnchoFormato receptor (CODEC)ENUM
1tool#2registrocualquier registro (excepto marcador de posición)
2version#3registro07C0 SHA-256-DIGEST, 07D0 SHA1-DIGEST

Indica el método con que se convirtió a este documento desde otra representación (por ejemplo, un conversor de Wikidata o un codificador de lenguaje natural). Tool es con qué se convirtió; Version es con qué fuente de esa herramienta. Hacen falta ambos para poder regenerar el mismo documento a partir de la misma entrada.

Layout

TAG WORD          0001 1101 0100 LLLL      Codec 0x1D4L
[TAG de extensión de Length]
Tool              1 registro Reference (herramienta o reglas de conversión)
Version           1 registro Value (SHA-256-DIGEST o SHA1-DIGEST)
  • Codec: Meta 0x1D4L, clase de linaje
  • Payload: Reference incorporado (herramienta) + Value incorporado (resumen de la versión de la fuente)
  • Cantidad: varios posibles (uno por herramienta)

Interpretación y validez

  • Tool es exactamente un registro Reference completo. Sirve cualquier Reference que señale la herramienta.
    • Herramienta de un documento de herramientas de geul.org: EXTERNAL-ISSUER (0x00000000, ID de documento 0x0001xxxx xxxxxxxx, su LOCAL). Un documento por herramienta (documento de definición de términos de Issuer).
    • Si el Codec es un documento GEUL, se señala ese documento de Codec con CODEC-POINTER.
  • Version es exactamente un registro Value completo y es el ID de objeto de control de versiones de la fuente de Tool. En git, es el ID completo del objeto commit.
    • Si el formato de objetos del repositorio git es SHA-256, SHA-256-DIGEST (0x07CL, 16 WORD); si es SHA-1, SHA1-DIGEST (0x07DL, 10 WORD). El formato del repositorio se comprueba con git rev-parse --show-object-format.
    • No se usan IDs abreviados (como 2bd496f). El Value de resumen no admite valores truncados.
    • No se escribe como texto hexadecimal (UTF8-TEXT). El mismo valor ocupa 22 WORD en SHA-1 (11 en binario) y 34 WORD en SHA-256 (18 en binario).
  • Version es obligatorio. Un registro de herramienta cuya versión de fuente se desconoce no sirve de base para la reproducción. Si la herramienta está fuera del control de versiones, se usa el SHA-256 del entregable (SHA-256-DIGEST).
  • Version señala la fuente confirmada (commit). En un documento creado con un árbol de trabajo con cambios sin confirmar no se usa ese ID de commit (se recomienda que la herramienta se niegue a ejecutarse).
  • Si la herramienta depende de código fuera del repositorio (por ejemplo, una biblioteca local señalada con replace de Go), ese código también se anota aparte con TRANSFORMED-BY. El ID de commit de la herramienta por sí solo no determina ese código.
  • Una herramienta que solo traslada la fuente sin pérdida (por ejemplo, una que carga un volcado tal cual en una base de datos) no determina el contenido del documento, así que no se anota. Una carga con pérdida cambia el documento, así que se anota como herramienta.
  • El documento de especificación de geul.org (0x1D40) se escribe con dos campos de registro: Tool (ancho 0, cualquier Reference, por lo que sin CODEC) y Version (ancho 0, CODEC 07C0 y 07D0).

Longitud

total = 1 + N_len + N_tool + N_version WORD
  • El cursor tras leer todos los registros debe coincidir exactamente con el final del Meta.
  • Si Tool es EXTERNAL-ISSUER-2WORD (8 WORD) y Version es SHA1-DIGEST (11 WORD), el total es 1 + 1 + 8 + 11 = 21 WORD y se usa la longitud extendida. Con SHA-256-DIGEST (18 WORD) son 28 WORD.

Ejemplo

Ejemplo no normativo. La herramienta es el LOCAL 2 del documento de herramientas de geul.org 0x0001000000000001 (02F7 0000 0000 0001 0000 0000 0001 0002) y la fuente es el commit ddc0719974a32aaa7b422ee84221a9721085ce4c (SHA-1).

1D4E 0015
02F7 0000 0000 0001 0000 0000 0001 0002
07DA DDC0 7199 74A3 2AAA 7B42 2EE8 4221 A972 1085 CE4C

Problemas abiertos

  • Si la versión de GENERATED-BY también debe cambiarse de la misma manera (resumen obligatorio u otro formato). La versión de un modelo no es un ID de commit.

Páginas relacionadas

Texto original del documento de especificación

Es el documento de especificación 0x00000000/codecs/0x00001D40/latest.geul leído con geul show (hexadecimal en mayúsculas).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001D4000000000
BODY
#1 DECLARE 0x1D40
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "TRANSFORMED-BY"
#5 BIND #2 "tool"
#6 BIND #3 "version"
#7 CODEC #3 0x07C0
#8 CODEC #3 0x07D0